@intlayer/engine 9.5.9-canary.0 → 9.5.10

package/dist/cjs/init/frameworkSetup/tanstackStart/transforms.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_utils_babelParser = require('../../../utils/babelParser.cjs');
 const require_init_utils_astImports = require('../../utils/astImports.cjs');
+const require_init_frameworkSetup_tanstackStart_templates = require('./templates.cjs');
 let recast = require("recast");
 recast = require_runtime.__toESM(recast);
 
@@ -125,6 +126,97 @@ const setHtmlLangAndDir = (ast) => {
 	} });
 };
 /**
+* Wraps the first `{children}` expression inside `funcNode` with
+* `<IntlayerProvider locale={locale}>`. Returns whether a wrap happened.
+*/
+const wrapChildrenWithProvider = (funcNode) => {
+	let wrapped = false;
+	recast.visit(funcNode, { visitJSXExpressionContainer(path) {
+		if (wrapped) return false;
+		const expression = path.node.expression;
+		if (expression?.type === "Identifier" && expression.name === "children") {
+			const providerElement = parseTsx("const __wrap = <IntlayerProvider locale={locale}>{__child__}</IntlayerProvider>;").program.body[0].declarations[0].init;
+			providerElement.children = [path.node];
+			path.replace(providerElement);
+			wrapped = true;
+			return false;
+		}
+		this.traverse(path);
+	} });
+	return wrapped;
+};
+/** Whether `funcNode` already binds `locale` in its body or parameters. */
+const bindsLocale = (funcNode) => funcNode.body?.type === "BlockStatement" && funcNode.body.body.some((stmt) => stmt.type === "VariableDeclaration" && stmt.declarations.some((d) => patternBindsName(d.id, "locale"))) || (funcNode.params ?? []).some((param) => patternBindsName(param, "locale"));
+/**
+* Finds the options object of the root route declaration —
+* `createRootRoute({…})` or `createRootRouteWithContext<…>()({…})`. Returns
+* `null` when absent or not an object literal.
+*/
+const findRootRouteOptions = (ast) => {
+	let options = null;
+	recast.visit(ast, { visitCallExpression(path) {
+		const { callee, arguments: args } = path.node;
+		const isCreateRootRoute = callee.type === "Identifier" && callee.name === "createRootRoute";
+		const isCreateRootRouteWithContext = callee.type === "CallExpression" && callee.callee?.type === "Identifier" && callee.callee.name === "createRootRouteWithContext";
+		if ((isCreateRootRoute || isCreateRootRouteWithContext) && args[0]?.type === "ObjectExpression") {
+			options = args[0];
+			return false;
+		}
+		this.traverse(path);
+	} });
+	return options;
+};
+/** Module-scope identifier of the injected request-locale server function. */
+const REQUEST_LOCALE_FUNCTION_NAME = "getRequestLocale";
+/**
+* Wraps the `{children}` of a TanStack Start root document with
+* `IntlayerProvider` for routing modes without a locale path segment. The
+* locale is resolved per request by a server function exposed through the root
+* `loader`, and read with `Route.useLoaderData()`. Safe and idempotent: bails
+* when the provider is already present, when no `<html>` document or
+* `{children}` is found, or when the root route cannot safely take a loader
+* (no `Route` binding, no options object, or an existing `loader`).
+*
+* @param code Source of the project's `__root` document.
+*/
+const wrapRootWithRequestLocaleProvider = (code) => {
+	if (code.includes("IntlayerProvider")) return {
+		code,
+		status: "already"
+	};
+	const ast = parseTsx(code);
+	const funcNode = findHtmlDocumentFunction(ast);
+	const rootRouteOptions = findRootRouteOptions(ast);
+	const hasLoader = rootRouteOptions?.properties.some((property) => (property.key?.name ?? property.key?.value) === "loader");
+	if (!funcNode || !rootRouteOptions || hasLoader || !require_init_utils_astImports.isModuleScopeBinding(ast, "Route")) return {
+		code,
+		status: "skipped"
+	};
+	if (!wrapChildrenWithProvider(funcNode)) return {
+		code,
+		status: "skipped"
+	};
+	if (!bindsLocale(funcNode)) {
+		if (funcNode.body?.type !== "BlockStatement") funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);
+		funcNode.body.body.unshift(parseTsx("const locale = Route.useLoaderData();").program.body[0]);
+	}
+	rootRouteOptions.properties.unshift(b.property("init", b.identifier("loader"), b.arrowFunctionExpression([], b.callExpression(b.identifier(REQUEST_LOCALE_FUNCTION_NAME), []))));
+	const insertsServerFunction = !require_init_utils_astImports.isModuleScopeBinding(ast, REQUEST_LOCALE_FUNCTION_NAME);
+	if (insertsServerFunction) ast.program.body.splice(require_init_utils_astImports.firstInsertIndex(ast), 0, parseTsx(require_init_frameworkSetup_tanstackStart_templates.REQUEST_LOCALE_SERVER_FUNCTION).program.body[0]);
+	require_init_utils_astImports.ensureNamedImport(ast, "IntlayerProvider", "react-intlayer");
+	require_init_utils_astImports.ensureNamedImport(ast, "createServerFn", "@tanstack/react-start");
+	require_init_utils_astImports.ensureNamedImport(ast, "getRequestHeader", "@tanstack/react-start/server");
+	require_init_utils_astImports.ensureNamedImport(ast, "getCookie", "intlayer");
+	require_init_utils_astImports.ensureNamedImport(ast, "getLocale", "intlayer");
+	require_init_utils_astImports.ensureNamedImport(ast, "getHTMLTextDir", "intlayer");
+	setHtmlLangAndDir(ast);
+	const printedCode = recast.print(ast).code;
+	return {
+		code: insertsServerFunction ? printedCode.replace(new RegExp(`([^\\n])\\n(const ${REQUEST_LOCALE_FUNCTION_NAME} = )`), "$1\n\n$2") : printedCode,
+		status: "wrapped"
+	};
+};
+/**
 * Wraps the `{children}` of a TanStack Start root document with
 * `IntlayerProvider`, deriving the locale from the locale segment route params.
 * Safe and idempotent: bails (returns the original code) when the provider is
@@ -146,20 +238,7 @@ const wrapRootWithProvider = (code, localeSegment) => {
 		code,
 		status: "skipped"
 	};
-	let wrapped = false;
-	recast.visit(funcNode, { visitJSXExpressionContainer(path) {
-		if (wrapped) return false;
-		const expression = path.node.expression;
-		if (expression?.type === "Identifier" && expression.name === "children") {
-			const providerElement = parseTsx("const __wrap = <IntlayerProvider locale={locale}>{__child__}</IntlayerProvider>;").program.body[0].declarations[0].init;
-			providerElement.children = [path.node];
-			path.replace(providerElement);
-			wrapped = true;
-			return false;
-		}
-		this.traverse(path);
-	} });
-	if (!wrapped) return {
+	if (!wrapChildrenWithProvider(funcNode)) return {
 		code,
 		status: "skipped"
 	};
@@ -182,4 +261,5 @@ const wrapRootWithProvider = (code, localeSegment) => {
 
 //#endregion
 exports.wrapRootWithProvider = wrapRootWithProvider;
+exports.wrapRootWithRequestLocaleProvider = wrapRootWithRequestLocaleProvider;
 //# sourceMappingURL=transforms.cjs.map

package/dist/cjs/init/frameworkSetup/tanstackStart/transforms.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transforms.cjs","names":["babelTsParser","isModuleScopeBinding","firstInsertIndex"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/babelParser';\nimport {\n  ensureNamedImport,\n  firstInsertIndex,\n  isModuleScopeBinding,\n} from '../../utils/astImports';\n\nconst { builders: b, namedTypes: n } = recast.types;\n\n/** Module-scope identifier bound to the locale route's typed API. */\nconst LOCALE_ROUTE_API_VARIABLE = 'localeRoute';\n\n/** babel-ts parser handles TypeScript *and* JSX. */\nconst parseTsx = (code: string): any =>\n  recast.parse(code, { parser: babelTsParser });\n\n/** Result of a source transform. `code` is unchanged for any non-`wrapped` status. */\nexport type TransformResult = {\n  code: string;\n  status: 'wrapped' | 'already' | 'skipped';\n};\n\n/**\n * Finds the single function that returns the `<html>` document element. Returns\n * `null` when there is no such function, or more than one (ambiguous).\n */\nconst findHtmlDocumentFunction = (ast: any): any => {\n  const found = new Set<any>();\n\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type === 'JSXIdentifier' && node.name.name === 'html') {\n        // Walk up to the nearest enclosing function node.\n        let current = path.parentPath;\n        while (current) {\n          const value = current.value;\n          if (\n            value &&\n            (n.FunctionDeclaration.check(value) ||\n              n.FunctionExpression.check(value) ||\n              n.ArrowFunctionExpression.check(value))\n          ) {\n            found.add(value);\n            break;\n          }\n          current = current.parentPath;\n        }\n      }\n      this.traverse(path);\n    },\n  });\n\n  return found.size === 1 ? [...found][0] : null;\n};\n\n/**\n * Whether the binding pattern `node` introduces a variable named `name`.\n * Recurses through destructuring patterns so all of `const locale`,\n * `const { locale } = …`, `const { locale = fallback } = …`,\n * `const { foo: locale } = …`, `const [locale] = …` and `...locale` are\n * detected — not just a bare identifier.\n */\nconst patternBindsName = (node: any, name: string): boolean => {\n  if (!node) return false;\n  switch (node.type) {\n    case 'Identifier':\n      return node.name === name;\n    case 'AssignmentPattern':\n      // `locale = fallback`\n      return patternBindsName(node.left, name);\n    case 'RestElement':\n      // `...locale`\n      return patternBindsName(node.argument, name);\n    case 'ArrayPattern':\n      return node.elements.some((element: any) =>\n        patternBindsName(element, name)\n      );\n    case 'ObjectPattern':\n      return node.properties.some((property: any) =>\n        property.type === 'RestElement'\n          ? patternBindsName(property.argument, name)\n          : // The *value* is the binding target (`{ foo: locale }` binds `locale`).\n            patternBindsName(property.value, name)\n      );\n    default:\n      return false;\n  }\n};\n\n/**\n * Inserts `const { locale = defaultLocale } = localeRoute.useParams();` once, at\n * the top of the function body. The destructuring form binds only `locale`, so\n * it can never collide with a `params` variable the document already declares.\n * Expression-bodied arrow functions are first converted to a block so the\n * declaration has somewhere to live.\n *\n * No-ops when `locale` is already bound in the function — whether as a simple\n * identifier, through a destructuring pattern (e.g.\n * `const { locale = defaultLocale } = Route.useLoaderData()`), or as a function\n * parameter — so the injected declaration never collides with one the document\n * already provides (which would produce an\n * `Identifier 'locale' has already been declared` parse error).\n *\n * @returns `true` when the declaration was injected, `false` when the document\n * already binds `locale` itself. Callers use this to skip the imports and the\n * route API declaration the injected statement would have needed.\n */\nconst ensureLocaleFromParams = (funcNode: any): boolean => {\n  if (funcNode.body?.type !== 'BlockStatement') {\n    funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);\n  }\n\n  const declaredInBody = funcNode.body.body.some(\n    (stmt: any) =>\n      stmt.type === 'VariableDeclaration' &&\n      stmt.declarations.some((d: any) => patternBindsName(d.id, 'locale'))\n  );\n  const declaredInParams = (funcNode.params ?? []).some((param: any) =>\n    patternBindsName(param, 'locale')\n  );\n  if (declaredInBody || declaredInParams) return false;\n\n  const statement = parseTsx(\n    `const { locale = defaultLocale } = ${LOCALE_ROUTE_API_VARIABLE}.useParams();`\n  ).program.body[0];\n  funcNode.body.body.unshift(statement);\n  return true;\n};\n\n/**\n * Ensures the module-scope `const localeRoute = getRouteApi(\"/<segment>\");`\n * declaration the injected locale statement reads from, inserted right after the\n * import block.\n *\n * Referencing the locale route by id keeps the root document free of an import\n * of `<segment>/route` — importing a child route module from `__root` is\n * discouraged, since the generated route tree already imports the root.\n *\n * No-ops when `localeRoute` is already bound at module scope, reusing that\n * binding rather than redeclaring it (which would be a parse error).\n *\n * @returns `true` when the declaration was inserted, `false` when an existing\n * binding was reused.\n */\nconst ensureLocaleRouteApi = (ast: any, localeSegment: string): boolean => {\n  if (isModuleScopeBinding(ast, LOCALE_ROUTE_API_VARIABLE)) return false;\n\n  const declaration = parseTsx(\n    `const ${LOCALE_ROUTE_API_VARIABLE} = getRouteApi(\"/${localeSegment}\");`\n  ).program.body[0];\n  ast.program.body.splice(firstInsertIndex(ast), 0, declaration);\n  return true;\n};\n\n/**\n * Puts a blank line between the import block and the inserted route API\n * declaration — recast prints a spliced statement flush against the preceding\n * line, which reads as part of the imports.\n */\nconst separateRouteApiDeclaration = (printedCode: string): string =>\n  printedCode.replace(\n    new RegExp(\n      `([^\\\\n])\\\\n(const ${LOCALE_ROUTE_API_VARIABLE} = getRouteApi\\\\()`\n    ),\n    '$1\\n\\n$2'\n  );\n\n/** Sets `lang={locale}` and `dir={getHTMLTextDir(locale)}` on the first `<html>` element. */\nconst setHtmlLangAndDir = (ast: any): void => {\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type !== 'JSXIdentifier' || node.name.name !== 'html') {\n        this.traverse(path);\n        return;\n      }\n\n      const upsertAttribute = (name: string, value: any): void => {\n        const existing = node.attributes?.find(\n          (attr: any) =>\n            attr.type === 'JSXAttribute' && attr.name?.name === name\n        ) as any;\n        if (existing) {\n          existing.value = value;\n        } else {\n          node.attributes?.push(b.jsxAttribute(b.jsxIdentifier(name), value));\n        }\n      };\n\n      upsertAttribute('lang', b.jsxExpressionContainer(b.identifier('locale')));\n      upsertAttribute(\n        'dir',\n        b.jsxExpressionContainer(\n          b.callExpression(b.identifier('getHTMLTextDir'), [\n            b.identifier('locale'),\n          ])\n        )\n      );\n      return false;\n    },\n  });\n};\n\n/**\n * Wraps the `{children}` of a TanStack Start root document with\n * `IntlayerProvider`, deriving the locale from the locale segment route params.\n * Safe and idempotent: bails (returns the original code) when the provider is\n * already present, when no `<html>` document function is found, or when there is\n * no `{children}` placeholder to wrap.\n *\n * @param code Source of the project's `__root` document.\n * @param localeSegment Locale segment directory in use — `{-$locale}` for every\n * routing mode but `prefix-all`, which uses the required `$locale`.\n */\nexport const wrapRootWithProvider = (\n  code: string,\n  localeSegment: string\n): TransformResult => {\n  const ast = parseTsx(code);\n\n  if (code.includes('IntlayerProvider')) return { code, status: 'already' };\n\n  const funcNode = findHtmlDocumentFunction(ast);\n  if (!funcNode) return { code, status: 'skipped' };\n\n  let wrapped = false;\n  recast.visit(funcNode, {\n    visitJSXExpressionContainer(path) {\n      if (wrapped) return false;\n      const expression = path.node.expression;\n      if (expression?.type === 'Identifier' && expression.name === 'children') {\n        const template = parseTsx(\n          'const __wrap = <IntlayerProvider locale={locale}>{__child__}</IntlayerProvider>;'\n        );\n        const providerElement = template.program.body[0].declarations[0].init;\n        providerElement.children = [path.node];\n        path.replace(providerElement);\n        wrapped = true;\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (!wrapped) return { code, status: 'skipped' };\n\n  const injectedLocaleDeclaration = ensureLocaleFromParams(funcNode);\n\n  ensureNamedImport(ast, 'IntlayerProvider', 'react-intlayer');\n  // Only needed by the injected declaration: a document that already derives its\n  // own `locale` must not be given unused imports or a stray route API const.\n  let insertedRouteApi = false;\n  if (injectedLocaleDeclaration) {\n    ensureNamedImport(ast, 'getRouteApi', '@tanstack/react-router');\n    ensureNamedImport(ast, 'defaultLocale', 'intlayer');\n    insertedRouteApi = ensureLocaleRouteApi(ast, localeSegment);\n  }\n  ensureNamedImport(ast, 'getHTMLTextDir', 'intlayer');\n  setHtmlLangAndDir(ast);\n\n  const printedCode = recast.print(ast).code;\n\n  return {\n    code: insertedRouteApi\n      ? separateRouteApiDeclaration(printedCode)\n      : printedCode,\n    status: 'wrapped',\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"transforms.cjs","names":["babelTsParser","isModuleScopeBinding","firstInsertIndex","REQUEST_LOCALE_SERVER_FUNCTION"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/babelParser';\nimport {\n  ensureNamedImport,\n  firstInsertIndex,\n  isModuleScopeBinding,\n} from '../../utils/astImports';\nimport { REQUEST_LOCALE_SERVER_FUNCTION } from './templates';\n\nconst { builders: b, namedTypes: n } = recast.types;\n\n/** Module-scope identifier bound to the locale route's typed API. */\nconst LOCALE_ROUTE_API_VARIABLE = 'localeRoute';\n\n/** babel-ts parser handles TypeScript *and* JSX. */\nconst parseTsx = (code: string): any =>\n  recast.parse(code, { parser: babelTsParser });\n\n/** Result of a source transform. `code` is unchanged for any non-`wrapped` status. */\nexport type TransformResult = {\n  code: string;\n  status: 'wrapped' | 'already' | 'skipped';\n};\n\n/**\n * Finds the single function that returns the `<html>` document element. Returns\n * `null` when there is no such function, or more than one (ambiguous).\n */\nconst findHtmlDocumentFunction = (ast: any): any => {\n  const found = new Set<any>();\n\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type === 'JSXIdentifier' && node.name.name === 'html') {\n        // Walk up to the nearest enclosing function node.\n        let current = path.parentPath;\n        while (current) {\n          const value = current.value;\n          if (\n            value &&\n            (n.FunctionDeclaration.check(value) ||\n              n.FunctionExpression.check(value) ||\n              n.ArrowFunctionExpression.check(value))\n          ) {\n            found.add(value);\n            break;\n          }\n          current = current.parentPath;\n        }\n      }\n      this.traverse(path);\n    },\n  });\n\n  return found.size === 1 ? [...found][0] : null;\n};\n\n/**\n * Whether the binding pattern `node` introduces a variable named `name`.\n * Recurses through destructuring patterns so all of `const locale`,\n * `const { locale } = …`, `const { locale = fallback } = …`,\n * `const { foo: locale } = …`, `const [locale] = …` and `...locale` are\n * detected — not just a bare identifier.\n */\nconst patternBindsName = (node: any, name: string): boolean => {\n  if (!node) return false;\n  switch (node.type) {\n    case 'Identifier':\n      return node.name === name;\n    case 'AssignmentPattern':\n      // `locale = fallback`\n      return patternBindsName(node.left, name);\n    case 'RestElement':\n      // `...locale`\n      return patternBindsName(node.argument, name);\n    case 'ArrayPattern':\n      return node.elements.some((element: any) =>\n        patternBindsName(element, name)\n      );\n    case 'ObjectPattern':\n      return node.properties.some((property: any) =>\n        property.type === 'RestElement'\n          ? patternBindsName(property.argument, name)\n          : // The *value* is the binding target (`{ foo: locale }` binds `locale`).\n            patternBindsName(property.value, name)\n      );\n    default:\n      return false;\n  }\n};\n\n/**\n * Inserts `const { locale = defaultLocale } = localeRoute.useParams();` once, at\n * the top of the function body. The destructuring form binds only `locale`, so\n * it can never collide with a `params` variable the document already declares.\n * Expression-bodied arrow functions are first converted to a block so the\n * declaration has somewhere to live.\n *\n * No-ops when `locale` is already bound in the function — whether as a simple\n * identifier, through a destructuring pattern (e.g.\n * `const { locale = defaultLocale } = Route.useLoaderData()`), or as a function\n * parameter — so the injected declaration never collides with one the document\n * already provides (which would produce an\n * `Identifier 'locale' has already been declared` parse error).\n *\n * @returns `true` when the declaration was injected, `false` when the document\n * already binds `locale` itself. Callers use this to skip the imports and the\n * route API declaration the injected statement would have needed.\n */\nconst ensureLocaleFromParams = (funcNode: any): boolean => {\n  if (funcNode.body?.type !== 'BlockStatement') {\n    funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);\n  }\n\n  const declaredInBody = funcNode.body.body.some(\n    (stmt: any) =>\n      stmt.type === 'VariableDeclaration' &&\n      stmt.declarations.some((d: any) => patternBindsName(d.id, 'locale'))\n  );\n  const declaredInParams = (funcNode.params ?? []).some((param: any) =>\n    patternBindsName(param, 'locale')\n  );\n  if (declaredInBody || declaredInParams) return false;\n\n  const statement = parseTsx(\n    `const { locale = defaultLocale } = ${LOCALE_ROUTE_API_VARIABLE}.useParams();`\n  ).program.body[0];\n  funcNode.body.body.unshift(statement);\n  return true;\n};\n\n/**\n * Ensures the module-scope `const localeRoute = getRouteApi(\"/<segment>\");`\n * declaration the injected locale statement reads from, inserted right after the\n * import block.\n *\n * Referencing the locale route by id keeps the root document free of an import\n * of `<segment>/route` — importing a child route module from `__root` is\n * discouraged, since the generated route tree already imports the root.\n *\n * No-ops when `localeRoute` is already bound at module scope, reusing that\n * binding rather than redeclaring it (which would be a parse error).\n *\n * @returns `true` when the declaration was inserted, `false` when an existing\n * binding was reused.\n */\nconst ensureLocaleRouteApi = (ast: any, localeSegment: string): boolean => {\n  if (isModuleScopeBinding(ast, LOCALE_ROUTE_API_VARIABLE)) return false;\n\n  const declaration = parseTsx(\n    `const ${LOCALE_ROUTE_API_VARIABLE} = getRouteApi(\"/${localeSegment}\");`\n  ).program.body[0];\n  ast.program.body.splice(firstInsertIndex(ast), 0, declaration);\n  return true;\n};\n\n/**\n * Puts a blank line between the import block and the inserted route API\n * declaration — recast prints a spliced statement flush against the preceding\n * line, which reads as part of the imports.\n */\nconst separateRouteApiDeclaration = (printedCode: string): string =>\n  printedCode.replace(\n    new RegExp(\n      `([^\\\\n])\\\\n(const ${LOCALE_ROUTE_API_VARIABLE} = getRouteApi\\\\()`\n    ),\n    '$1\\n\\n$2'\n  );\n\n/** Sets `lang={locale}` and `dir={getHTMLTextDir(locale)}` on the first `<html>` element. */\nconst setHtmlLangAndDir = (ast: any): void => {\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type !== 'JSXIdentifier' || node.name.name !== 'html') {\n        this.traverse(path);\n        return;\n      }\n\n      const upsertAttribute = (name: string, value: any): void => {\n        const existing = node.attributes?.find(\n          (attr: any) =>\n            attr.type === 'JSXAttribute' && attr.name?.name === name\n        ) as any;\n        if (existing) {\n          existing.value = value;\n        } else {\n          node.attributes?.push(b.jsxAttribute(b.jsxIdentifier(name), value));\n        }\n      };\n\n      upsertAttribute('lang', b.jsxExpressionContainer(b.identifier('locale')));\n      upsertAttribute(\n        'dir',\n        b.jsxExpressionContainer(\n          b.callExpression(b.identifier('getHTMLTextDir'), [\n            b.identifier('locale'),\n          ])\n        )\n      );\n      return false;\n    },\n  });\n};\n\n/**\n * Wraps the first `{children}` expression inside `funcNode` with\n * `<IntlayerProvider locale={locale}>`. Returns whether a wrap happened.\n */\nconst wrapChildrenWithProvider = (funcNode: any): boolean => {\n  let wrapped = false;\n  recast.visit(funcNode, {\n    visitJSXExpressionContainer(path) {\n      if (wrapped) return false;\n      const expression = path.node.expression;\n      if (expression?.type === 'Identifier' && expression.name === 'children') {\n        const template = parseTsx(\n          'const __wrap = <IntlayerProvider locale={locale}>{__child__}</IntlayerProvider>;'\n        );\n        const providerElement = template.program.body[0].declarations[0].init;\n        providerElement.children = [path.node];\n        path.replace(providerElement);\n        wrapped = true;\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n  return wrapped;\n};\n\n/** Whether `funcNode` already binds `locale` in its body or parameters. */\nconst bindsLocale = (funcNode: any): boolean =>\n  (funcNode.body?.type === 'BlockStatement' &&\n    funcNode.body.body.some(\n      (stmt: any) =>\n        stmt.type === 'VariableDeclaration' &&\n        stmt.declarations.some((d: any) => patternBindsName(d.id, 'locale'))\n    )) ||\n  (funcNode.params ?? []).some((param: any) =>\n    patternBindsName(param, 'locale')\n  );\n\n/**\n * Finds the options object of the root route declaration —\n * `createRootRoute({…})` or `createRootRouteWithContext<…>()({…})`. Returns\n * `null` when absent or not an object literal.\n */\nconst findRootRouteOptions = (ast: any): any => {\n  let options: any = null;\n\n  recast.visit(ast, {\n    visitCallExpression(path) {\n      const { callee, arguments: args } = path.node as any;\n      const isCreateRootRoute =\n        callee.type === 'Identifier' && callee.name === 'createRootRoute';\n      const isCreateRootRouteWithContext =\n        callee.type === 'CallExpression' &&\n        callee.callee?.type === 'Identifier' &&\n        callee.callee.name === 'createRootRouteWithContext';\n\n      if (\n        (isCreateRootRoute || isCreateRootRouteWithContext) &&\n        args[0]?.type === 'ObjectExpression'\n      ) {\n        options = args[0];\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  return options;\n};\n\n/** Module-scope identifier of the injected request-locale server function. */\nconst REQUEST_LOCALE_FUNCTION_NAME = 'getRequestLocale';\n\n/**\n * Wraps the `{children}` of a TanStack Start root document with\n * `IntlayerProvider` for routing modes without a locale path segment. The\n * locale is resolved per request by a server function exposed through the root\n * `loader`, and read with `Route.useLoaderData()`. Safe and idempotent: bails\n * when the provider is already present, when no `<html>` document or\n * `{children}` is found, or when the root route cannot safely take a loader\n * (no `Route` binding, no options object, or an existing `loader`).\n *\n * @param code Source of the project's `__root` document.\n */\nexport const wrapRootWithRequestLocaleProvider = (\n  code: string\n): TransformResult => {\n  if (code.includes('IntlayerProvider')) return { code, status: 'already' };\n\n  const ast = parseTsx(code);\n\n  const funcNode = findHtmlDocumentFunction(ast);\n  const rootRouteOptions = findRootRouteOptions(ast);\n  const hasLoader = rootRouteOptions?.properties.some(\n    (property: any) => (property.key?.name ?? property.key?.value) === 'loader'\n  );\n  if (\n    !funcNode ||\n    !rootRouteOptions ||\n    hasLoader ||\n    !isModuleScopeBinding(ast, 'Route')\n  ) {\n    return { code, status: 'skipped' };\n  }\n\n  if (!wrapChildrenWithProvider(funcNode)) return { code, status: 'skipped' };\n\n  if (!bindsLocale(funcNode)) {\n    if (funcNode.body?.type !== 'BlockStatement') {\n      funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);\n    }\n    funcNode.body.body.unshift(\n      parseTsx('const locale = Route.useLoaderData();').program.body[0]\n    );\n  }\n\n  rootRouteOptions.properties.unshift(\n    b.property(\n      'init',\n      b.identifier('loader'),\n      b.arrowFunctionExpression(\n        [],\n        b.callExpression(b.identifier(REQUEST_LOCALE_FUNCTION_NAME), [])\n      )\n    )\n  );\n\n  const insertsServerFunction = !isModuleScopeBinding(\n    ast,\n    REQUEST_LOCALE_FUNCTION_NAME\n  );\n  if (insertsServerFunction) {\n    ast.program.body.splice(\n      firstInsertIndex(ast),\n      0,\n      parseTsx(REQUEST_LOCALE_SERVER_FUNCTION).program.body[0]\n    );\n  }\n\n  ensureNamedImport(ast, 'IntlayerProvider', 'react-intlayer');\n  ensureNamedImport(ast, 'createServerFn', '@tanstack/react-start');\n  ensureNamedImport(ast, 'getRequestHeader', '@tanstack/react-start/server');\n  ensureNamedImport(ast, 'getCookie', 'intlayer');\n  ensureNamedImport(ast, 'getLocale', 'intlayer');\n  ensureNamedImport(ast, 'getHTMLTextDir', 'intlayer');\n  setHtmlLangAndDir(ast);\n\n  const printedCode = recast.print(ast).code;\n\n  return {\n    // recast prints the spliced declaration flush against the imports.\n    code: insertsServerFunction\n      ? printedCode.replace(\n          new RegExp(`([^\\\\n])\\\\n(const ${REQUEST_LOCALE_FUNCTION_NAME} = )`),\n          '$1\\n\\n$2'\n        )\n      : printedCode,\n    status: 'wrapped',\n  };\n};\n\n/**\n * Wraps the `{children}` of a TanStack Start root document with\n * `IntlayerProvider`, deriving the locale from the locale segment route params.\n * Safe and idempotent: bails (returns the original code) when the provider is\n * already present, when no `<html>` document function is found, or when there is\n * no `{children}` placeholder to wrap.\n *\n * @param code Source of the project's `__root` document.\n * @param localeSegment Locale segment directory in use — `{-$locale}` for every\n * routing mode but `prefix-all`, which uses the required `$locale`.\n */\nexport const wrapRootWithProvider = (\n  code: string,\n  localeSegment: string\n): TransformResult => {\n  const ast = parseTsx(code);\n\n  if (code.includes('IntlayerProvider')) return { code, status: 'already' };\n\n  const funcNode = findHtmlDocumentFunction(ast);\n  if (!funcNode) return { code, status: 'skipped' };\n\n  if (!wrapChildrenWithProvider(funcNode)) return { code, status: 'skipped' };\n\n  const injectedLocaleDeclaration = ensureLocaleFromParams(funcNode);\n\n  ensureNamedImport(ast, 'IntlayerProvider', 'react-intlayer');\n  // Only needed by the injected declaration: a document that already derives its\n  // own `locale` must not be given unused imports or a stray route API const.\n  let insertedRouteApi = false;\n  if (injectedLocaleDeclaration) {\n    ensureNamedImport(ast, 'getRouteApi', '@tanstack/react-router');\n    ensureNamedImport(ast, 'defaultLocale', 'intlayer');\n    insertedRouteApi = ensureLocaleRouteApi(ast, localeSegment);\n  }\n  ensureNamedImport(ast, 'getHTMLTextDir', 'intlayer');\n  setHtmlLangAndDir(ast);\n\n  const printedCode = recast.print(ast).code;\n\n  return {\n    code: insertedRouteApi\n      ? separateRouteApiDeclaration(printedCode)\n      : printedCode,\n    status: 'wrapped',\n  };\n};\n"],"mappings":"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"}

package/dist/cjs/init/index.cjs

@@ -4,146 +4,27 @@ const require_init_utils_configManipulation = require('./utils/configManipulatio
 const require_init_utils_fileSystem = require('./utils/fileSystem.cjs');
 const require_init_cms = require('./cms.cjs');
 const require_initConfig_index = require('../initConfig/index.cjs');
+const require_init_documentationRouter = require('./documentationRouter.cjs');
 const require_init_frameworkSetup_index = require('./frameworkSetup/index.cjs');
 const require_init_utils_devScript = require('./utils/devScript.cjs');
 const require_init_utils_packageManager = require('./utils/packageManager.cjs');
 const require_init_utils_githubActions = require('./utils/githubActions.cjs');
 const require_init_utils_jsonParser = require('./utils/jsonParser.cjs');
+const require_init_utils_lintConfig = require('./utils/lintConfig.cjs');
 const require_init_utils_nextCompilerBabel = require('./utils/nextCompilerBabel.cjs');
 const require_init_utils_tsConfig = require('./utils/tsConfig.cjs');
+const require_init_utils_urlRoutingFramework = require('./utils/urlRoutingFramework.cjs');
 const require_init_upgradeIntlayerPackages = require('./upgradeIntlayerPackages.cjs');
 let node_path = require("node:path");
 let _intlayer_config_colors = require("@intlayer/config/colors");
 _intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_node = require("@intlayer/config/node");
+let _intlayer_config_defaultValues = require("@intlayer/config/defaultValues");
 let _intlayer_config_utils = require("@intlayer/config/utils");
 
 //#region src/init/index.ts
 /**
-* Documentation URL Constants
-*/
-const DocumentationRouter = {
-	NextJS: "https://intlayer.org/doc/environment/nextjs.md",
-	NextJS_15: "https://intlayer.org/doc/environment/nextjs/15.md",
-	NextJS_14: "https://intlayer.org/doc/environment/nextjs/14.md",
-	CRA: "https://intlayer.org/doc/environment/create-react-app.md",
-	Astro: "https://intlayer.org/doc/environment/astro.md",
-	ViteAndReact: "https://intlayer.org/doc/environment/vite-and-react.md",
-	ViteAndReact_ReactRouterV7: "https://intlayer.org/doc/environment/vite-and-react/react-router-v7.md",
-	ViteAndVue: "https://intlayer.org/doc/environment/vite-and-vue.md",
-	ViteAndSolid: "https://intlayer.org/doc/environment/vite-and-solid.md",
-	ViteAndSvelte: "https://intlayer.org/doc/environment/vite-and-svelte.md",
-	ViteAndPreact: "https://intlayer.org/doc/environment/vite-and-preact.md",
-	ViteAndLit: "https://intlayer.org/doc/environment/vite-and-lit.md",
-	ViteAndVanilla: "https://intlayer.org/doc/environment/vite-and-vanilla.md",
-	Vanilla: "https://intlayer.org/doc/environment/vanilla.md",
-	TanStackRouter: "https://intlayer.org/doc/environment/tanstack-start.md",
-	TanStackRouterAndSolid: "https://intlayer.org/doc/environment/tanstack-start/solid.md",
-	SolidStart: "https://intlayer.org/doc/environment/solid-start.md",
-	Analog: "https://intlayer.org/doc/environment/analog.md",
-	Remix: "https://intlayer.org/doc/environment/remix-3.md",
-	NuxtAndVue: "https://intlayer.org/doc/environment/nuxt-and-vue.md",
-	Angular: "https://intlayer.org/doc/environment/angular.md",
-	SvelteKit: "https://intlayer.org/doc/environment/sveltekit.md",
-	ReactNativeAndExpo: "https://intlayer.org/doc/environment/react-native-and-expo.md",
-	Lynx: "https://intlayer.org/doc/environment/lynx-and-react.md",
-	Express: "https://intlayer.org/doc/environment/express.md",
-	NestJS: "https://intlayer.org/doc/environment/nest.md",
-	Fastify: "https://intlayer.org/doc/environment/fastify.md",
-	Hono: "https://intlayer.org/doc/environment/hono.md",
-	AdonisJS: "https://intlayer.org/doc/environment/adonisjs.md",
-	Elysia: "https://intlayer.org/doc/environment/elysia.md",
-	Default: "https://intlayer.org/doc/get-started",
-	LSP: "https://intlayer.org/doc/lsp.md",
-	ESLint: "https://intlayer.org/doc/eslint.md",
-	NextIntl: "https://intlayer.org/blog/intlayer-with-next-intl.md",
-	ReactI18Next: "https://intlayer.org/blog/intlayer-with-react-i18next.md",
-	ReactIntl: "https://intlayer.org/blog/intlayer-with-react-intl.md",
-	NextI18Next: "https://intlayer.org/blog/intlayer-with-next-i18next.md",
-	VueI18n: "https://intlayer.org/blog/intlayer-with-vue-i18n.md"
-};
-/**
-* The Intlayer lint setup, as `intlayer init` writes it into `.oxlintrc.json`.
-*
-* Declared locally on purpose: `@intlayer/engine` is installed by every Intlayer
-* user, so it must not depend on a lint plugin to write a handful of strings
-* into a JSON file. oxlint resolves a plugin's *rules* but not its shipped
-* *configs*, so the preset cannot be referenced by name there either.
-*
-* Mirrors the `recommended` preset of `eslint-plugin-intlayer`; keep in sync
-* when a rule is enabled by default there.
-*/
-const LINT_PLUGIN_PACKAGE_NAME = "eslint-plugin-intlayer";
-/** Intlayer's generated output — never source, never worth linting. */
-const GENERATED_OUTPUT_GLOBS = ["**/.intlayer/**"];
-/** Rules of the `recommended` preset, prefixed by the plugin namespace. */
-const getRecommendedRules = () => ({
-	"intlayer/no-raw-text": "warn",
-	"intlayer/static-dictionary-key": "error",
-	"intlayer/no-dynamic-field-access": "error"
-});
-/**
-* Helper: Detects the environment and returns the doc URL
-*/
-const getDocumentationUrl = (packageJson) => {
-	const deps = {
-		...packageJson.dependencies,
-		...packageJson.devDependencies
-	};
-	/**
-	* Helper to check if a version string matches a specific major version
-	* Matches: "15", "^15.0.0", "~15.2", "15.0.0-beta"
-	*/
-	const isVersion = (versionString, major) => {
-		if (!versionString || typeof versionString !== "string") return false;
-		return new RegExp(`^[\\^~]?${major}(?:\\.|$)`).test(versionString);
-	};
-	if (deps["@lynx-js/react"] || deps["@lynx-js/core"]) return DocumentationRouter.Lynx;
-	if (deps["react-native"] || deps.expo) return DocumentationRouter.ReactNativeAndExpo;
-	if (deps.next) {
-		const version = deps.next;
-		if (isVersion(version, 14)) return DocumentationRouter.NextJS_14;
-		if (isVersion(version, 15)) return DocumentationRouter.NextJS_15;
-		return DocumentationRouter.NextJS;
-	}
-	if (deps.nuxt) return DocumentationRouter.NuxtAndVue;
-	if (deps.astro) return DocumentationRouter.Astro;
-	if (deps["@sveltejs/kit"]) return DocumentationRouter.SvelteKit;
-	if (deps["@analogjs/platform"]) return DocumentationRouter.Analog;
-	if (deps["@solidjs/start"]) return DocumentationRouter.SolidStart;
-	if (deps.remix || deps["remix-intlayer"]) return DocumentationRouter.Remix;
-	if (deps["@tanstack/react-router"]) return DocumentationRouter.TanStackRouter;
-	if (deps["@tanstack/solid-router"]) return DocumentationRouter.TanStackRouterAndSolid;
-	const reactRouterVersion = deps["react-router"];
-	if (typeof reactRouterVersion === "string" && (deps["@react-router/fs-routes"] || isVersion(reactRouterVersion, 7))) return DocumentationRouter.ViteAndReact_ReactRouterV7;
-	if (deps.vite) {
-		if (deps.vue) return DocumentationRouter.ViteAndVue;
-		if (deps["solid-js"]) return DocumentationRouter.ViteAndSolid;
-		if (deps.svelte) return DocumentationRouter.ViteAndSvelte;
-		if (deps.preact) return DocumentationRouter.ViteAndPreact;
-		if (deps.lit) return DocumentationRouter.ViteAndLit;
-		if (deps["vanilla-intlayer"]) return DocumentationRouter.ViteAndVanilla;
-		return DocumentationRouter.ViteAndReact;
-	}
-	if (deps["react-scripts"]) return DocumentationRouter.CRA;
-	if (deps["@angular/core"]) return DocumentationRouter.Angular;
-	if (deps.lit) return DocumentationRouter.ViteAndLit;
-	if (deps["vanilla-intlayer"]) return DocumentationRouter.Vanilla;
-	if (deps["@nestjs/core"]) return DocumentationRouter.NestJS;
-	if (deps["@adonisjs/core"]) return DocumentationRouter.AdonisJS;
-	if (deps.elysia) return DocumentationRouter.Elysia;
-	if (deps.hono) return DocumentationRouter.Hono;
-	if (deps.express) return DocumentationRouter.Express;
-	if (deps.fastify) return DocumentationRouter.Fastify;
-	if (deps["next-intl"]) return DocumentationRouter.NextIntl;
-	if (deps["react-i18next"] || deps.i18next) return DocumentationRouter.ReactI18Next;
-	if (deps["react-intl"]) return DocumentationRouter.ReactIntl;
-	if (deps["next-i18next"]) return DocumentationRouter.NextI18Next;
-	if (deps["vue-i18n"]) return DocumentationRouter.VueI18n;
-	return DocumentationRouter.Default;
-};
-/**
 * Resolves the default dev-server URL of the detected framework, used as the
 * `editor.applicationURL` of the generated configuration file. Frameworks that
 * embed Vite (Astro, SvelteKit, …) are checked before the bare Vite fallback so
@@ -177,7 +58,7 @@ const initIntlayer = async (rootDir, options) => {
 		(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not parse ${(0, _intlayer_config_logger.colorizePath)("package.json")}.`, { level: "error" });
 		process.exit(1);
 	}
-	const guideUrl = getDocumentationUrl(packageJson);
+	const guideUrl = require_init_documentationRouter.getDocumentationUrl(packageJson);
 	const allDeps = {
 		...packageJson.dependencies ?? {},
 		...packageJson.devDependencies ?? {}
@@ -193,11 +74,14 @@ const initIntlayer = async (rootDir, options) => {
 	const linguiPresent = Boolean(allDeps["@lingui/core"] || allDeps["@lingui/react"] || allDeps["@intlayer/lingui"]);
 	const linguiCatalog = linguiPresent ? await require_init_utils_fileSystem.detectLinguiCatalogPattern(rootDir) : null;
 	const linguiCatalogFormat = linguiCatalog?.format ?? (linguiPresent ? "po" : null);
-	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig } = require_init_utils_packageManager.detectMissingIntlayerPackages(allDeps, {
+	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig, pendingCompatAdapters } = require_init_utils_packageManager.detectMissingIntlayerPackages(allDeps, {
 		linguiCatalogFormat,
 		dependencies: packageJson.dependencies,
 		devDependencies: packageJson.devDependencies
 	});
+	/** Whether the compat adapter for a library is not released yet. */
+	const isCompatAdapterPending = (adapterPackage) => pendingCompatAdapters.includes(adapterPackage);
+	if (pendingCompatAdapters.length > 0) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} No released Intlayer adapter yet for ${pendingCompatAdapters.map((adapterPackage) => (0, _intlayer_config_logger.colorize)(adapterPackage, _intlayer_config_colors.MAGENTA)).join(", ")} — keeping your current i18n library and only syncing its catalogs with Intlayer.`, { level: "warn" });
 	const wantsJsonNamespaces = options?.contentStrategy === "json-namespaces" && !compatSyncConfig;
 	if (wantsJsonNamespaces && !allDeps["@intlayer/sync-json-plugin"] && !devPackagesToInstall.includes("@intlayer/sync-json-plugin")) devPackagesToInstall.push("@intlayer/sync-json-plugin");
 	if (!options?.noInstallPackages) {
@@ -223,7 +107,7 @@ const initIntlayer = async (rootDir, options) => {
 		await require_init_upgradeIntlayerPackages.upgradeIntlayerPackages(rootDir);
 	}
 	const gitignorePath = ".gitignore";
-	if (!options?.noGitignore && await require_init_utils_fileSystem.exists(rootDir, gitignorePath)) {
+	if (!options?.noGitignore && !options?.noFrameworkSetup && await require_init_utils_fileSystem.exists(rootDir, gitignorePath)) {
 		const gitignoreContent = await require_init_utils_fileSystem.readFileFromRoot(rootDir, gitignorePath);
 		if (!gitignoreContent.includes("intlayer")) {
 			const newContent = `${gitignoreContent}\n# Intlayer\n.intlayer\n`;
@@ -289,39 +173,25 @@ const initIntlayer = async (rootDir, options) => {
 	} catch {
 		(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not update ${(0, _intlayer_config_logger.colorizePath)(settingsJsonPath)}. You may need to add the LSP settings manually.`, { level: "warn" });
 	}
+	if (!options?.noEslint && require_init_utils_packageManager.hasLegacyEslint(allDeps)) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} ${(0, _intlayer_config_logger.colorize)(require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME, _intlayer_config_colors.MAGENTA)} needs ESLint ${9}+ (flat config) — skipped the Intlayer lint rules. Upgrade ESLint to enable them: ${(0, _intlayer_config_logger.colorizePath)(require_init_documentationRouter.DocumentationRouter.ESLint)}`, { level: "warn" });
 	if (!options?.noEslint && require_init_utils_packageManager.hasLintTooling(allDeps)) {
 		const oxlintConfigPath = ".oxlintrc.json";
-		if (await require_init_utils_fileSystem.exists(rootDir, oxlintConfigPath)) try {
-			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, oxlintConfigPath);
-			const oxlintConfig = require_init_utils_jsonParser.parseJSONWithComments(content);
-			oxlintConfig.jsPlugins ??= [];
-			oxlintConfig.rules ??= {};
-			oxlintConfig.ignorePatterns ??= [];
-			let oxlintUpdated = false;
-			for (const glob of GENERATED_OUTPUT_GLOBS) if (!oxlintConfig.ignorePatterns.includes(glob)) {
-				oxlintConfig.ignorePatterns.push(glob);
-				oxlintUpdated = true;
-			}
-			if (!oxlintConfig.jsPlugins.includes(LINT_PLUGIN_PACKAGE_NAME)) {
-				oxlintConfig.jsPlugins.push(LINT_PLUGIN_PACKAGE_NAME);
-				oxlintUpdated = true;
-			}
-			for (const [ruleName, severity] of Object.entries(getRecommendedRules())) if (!oxlintConfig.rules[ruleName]) {
-				oxlintConfig.rules[ruleName] = severity;
-				oxlintUpdated = true;
-			}
-			if (oxlintUpdated) {
+		const hasOxlintConfig = await require_init_utils_fileSystem.exists(rootDir, oxlintConfigPath);
+		const shouldCreateOxlintConfig = !hasOxlintConfig && Boolean(allDeps.oxlint) && !allDeps.eslint;
+		if (hasOxlintConfig || shouldCreateOxlintConfig) try {
+			const oxlintConfig = hasOxlintConfig ? require_init_utils_jsonParser.parseJSONWithComments(await require_init_utils_fileSystem.readFileFromRoot(rootDir, oxlintConfigPath)) : {};
+			if (require_init_utils_lintConfig.addIntlayerRulesToOxlintConfig(oxlintConfig)) {
 				await require_init_utils_fileSystem.writeFileToRoot(rootDir, oxlintConfigPath, JSON.stringify(oxlintConfig, null, 2));
-				(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Added the Intlayer lint rules to ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}`);
+				(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${hasOxlintConfig ? "Added the Intlayer lint rules to" : "Created"} ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}`);
 			} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)} already includes the Intlayer lint rules`);
 		} catch {
-			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not update ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}. You may need to add ${(0, _intlayer_config_logger.colorize)(LINT_PLUGIN_PACKAGE_NAME, _intlayer_config_colors.MAGENTA)} manually.`, { level: "warn" });
+			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not update ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}. You may need to add ${(0, _intlayer_config_logger.colorize)(require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME, _intlayer_config_colors.MAGENTA)} manually.`, { level: "warn" });
 		}
 		else (0, _intlayer_config_logger.logger)([
 			(0, _intlayer_config_logger.colorize)("Intlayer lint rules →", _intlayer_config_colors.MAGENTA),
-			(0, _intlayer_config_logger.colorize)(`Add ${LINT_PLUGIN_PACKAGE_NAME} to your ESLint flat config to catch hardcoded text and dynamic calls the compiler cannot optimize:`, _intlayer_config_colors.GREY_LIGHT),
-			(0, _intlayer_config_logger.colorize)(`  import intlayer from '${LINT_PLUGIN_PACKAGE_NAME}';\n  export default [...intlayer.configs.recommended];`, _intlayer_config_colors.GREY_LIGHT),
-			(0, _intlayer_config_logger.colorizePath)(DocumentationRouter.ESLint)
+			(0, _intlayer_config_logger.colorize)(`Add the ${require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME} preset to the array your ESLint flat config exports, to catch hardcoded text and dynamic calls the compiler cannot optimize:`, _intlayer_config_colors.GREY_LIGHT),
+			(0, _intlayer_config_logger.colorize)(`  import intlayer from '${require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME}';\n\n  export default [\n    // ...your existing config\n    ...intlayer.configs.recommended,\n  ];`, _intlayer_config_colors.GREY_LIGHT),
+			(0, _intlayer_config_logger.colorizePath)(require_init_documentationRouter.DocumentationRouter.ESLint)
 		]);
 	}
 	if (!options?.noFrameworkSetup) {
@@ -348,7 +218,7 @@ const initIntlayer = async (rootDir, options) => {
 		}
 		const format = hasTsConfig ? "intlayer.config.ts" : "intlayer.config.mjs";
 		const detectedPattern = await require_init_utils_fileSystem.detectJsonLocalePattern(rootDir);
-		await require_initConfig_index.initConfig(format, rootDir, {
+		const isConfigCreated = await require_initConfig_index.initConfig(format, rootDir, {
 			locales: detectedPattern?.locales,
 			applicationURL: getDefaultApplicationURL(allDeps)
 		});
@@ -383,7 +253,14 @@ const initIntlayer = async (rootDir, options) => {
 				break;
 			}
 		}
-		if (options?.routingMode) await require_init_cms.setRoutingModeInConfig(rootDir, options.routingMode);
+		const hasUrlRouting = require_init_utils_urlRoutingFramework.hasUrlRoutingFramework(allDeps);
+		const hasCompatI18nLibrary = require_init_utils_packageManager.detectCompatI18nLibraries(allDeps).length > 0;
+		const shouldApplyDefaultRouting = isConfigCreated && options?.routingMode === void 0 && !hasCompatI18nLibrary;
+		if (shouldApplyDefaultRouting && !hasUrlRouting) await require_init_cms.setRoutingStorageOnlyInConfig(rootDir);
+		const routingMode = options?.routingMode ?? (shouldApplyDefaultRouting && hasUrlRouting ? _intlayer_config_defaultValues.ROUTING_MODE : void 0);
+		const enableProxy = options?.enableProxy ?? (shouldApplyDefaultRouting && hasUrlRouting ? true : void 0);
+		if (routingMode) await require_init_cms.setRoutingModeInConfig(rootDir, routingMode);
+		if (enableProxy !== void 0) await require_init_cms.setEnableProxyInConfig(rootDir, enableProxy);
 		let hasAliasConfiguration = false;
 		for (const file of [
 			"vite.config.ts",
@@ -436,7 +313,8 @@ const initIntlayer = async (rootDir, options) => {
 					await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, updatedContent);
 					(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(file)} to include Intlayer next-intl compat plugin`);
 				} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/next-intl/plugin`);
-			} else if (allDeps["next-translate"] || allDeps["@intlayer/next-translate"]) {
+			} else if (isCompatAdapterPending("@intlayer/next-translate")) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Kept ${(0, _intlayer_config_logger.colorizePath)(file)} untouched (next-translate stays in charge)`);
+			else if (allDeps["next-translate"] || allDeps["@intlayer/next-translate"]) {
 				if (!content.includes("@intlayer/next-translate")) {
 					const updatedContent = require_init_utils_configManipulation.updateNextConfigForNextTranslate(content, extension);
 					await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, updatedContent);
@@ -476,7 +354,8 @@ const initIntlayer = async (rootDir, options) => {
 		for (const file of ["nuxt.config.js", "nuxt.config.ts"]) if (await require_init_utils_fileSystem.exists(rootDir, file)) {
 			hasAliasConfiguration = true;
 			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, file);
-			if (allDeps["@nuxtjs/i18n"]) {
+			if (isCompatAdapterPending("@intlayer/nuxtjs-i18n")) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Kept ${(0, _intlayer_config_logger.colorizePath)(file)} untouched (@nuxtjs/i18n stays in charge)`);
+			else if (allDeps["@nuxtjs/i18n"]) {
 				if (!content.includes("@intlayer/nuxtjs-i18n")) {
 					const updatedContent = require_init_utils_configManipulation.updateNuxtConfigForNuxtjsI18n(content);
 					await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, updatedContent);
@@ -511,7 +390,7 @@ const initIntlayer = async (rootDir, options) => {
 					if (updatedContent !== content) {
 						await require_init_utils_fileSystem.writeFileToRoot(rootDir, metroConfigFile, updatedContent);
 						(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(metroConfigFile)} to include the Intlayer Metro plugin`);
-					} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not automatically update ${(0, _intlayer_config_logger.colorizePath)(metroConfigFile)}. Wrap your exported config with ${(0, _intlayer_config_logger.colorize)("configMetroIntlayer", _intlayer_config_colors.MAGENTA)}: ${(0, _intlayer_config_logger.colorizePath)(DocumentationRouter.ReactNativeAndExpo)}`, { level: "warn" });
+					} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not automatically update ${(0, _intlayer_config_logger.colorizePath)(metroConfigFile)}. Wrap your exported config with ${(0, _intlayer_config_logger.colorize)("configMetroIntlayer", _intlayer_config_colors.MAGENTA)}: ${(0, _intlayer_config_logger.colorizePath)(require_init_documentationRouter.DocumentationRouter.ReactNativeAndExpo)}`, { level: "warn" });
 				}
 			} else {
 				const newMetroConfigFile = "metro.config.js";
@@ -610,27 +489,35 @@ const initIntlayer = async (rootDir, options) => {
 		const hasCompatLibrary = Boolean(compatSyncConfig || compatVitePluginConfig);
 		if (hasCompatLibrary) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Compat i18n library detected — keeping the app structure untouched (no route restructure, no provider injection)`);
 		if (!hasCompatLibrary) try {
-			const routingMode = options?.routingMode ?? (0, _intlayer_config_node.getConfiguration)({ baseDir: rootDir }).routing.mode;
+			const { routing } = (0, _intlayer_config_node.getConfiguration)({ baseDir: rootDir });
 			await require_init_frameworkSetup_index.setupFramework({
 				rootDir,
 				allDeps,
 				packageManager,
 				useTypeScript: hasTsConfig,
-				routingMode
+				routingMode: routingMode ?? routing.mode,
+				enableProxy: enableProxy ?? routing.enableProxy !== false
 			});
 		} catch {
 			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Framework-specific scaffolding failed. Your existing files were left untouched; follow the documentation to finish the setup.`, { level: "warn" });
 		}
 	}
+	if (!options?.skipFinalMessage) logInitSuccessMessage(guideUrl);
+	return { guideUrl };
+};
+const logInitSuccessMessage = (guideUrl) => {
 	(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorize)("Intlayer init setup complete.", _intlayer_config_colors.GREEN)}`);
 	(0, _intlayer_config_logger.logger)([
 		(0, _intlayer_config_logger.colorize)("Next →", _intlayer_config_colors.MAGENTA),
-		(0, _intlayer_config_logger.colorize)(`Follow the instructions in the documentation to complete the setup:`, _intlayer_config_colors.GREY_LIGHT),
+		(0, _intlayer_config_logger.colorize)("Follow the instructions in the documentation to complete the setup:", _intlayer_config_colors.GREY_LIGHT),
 		(0, _intlayer_config_logger.colorizePath)(guideUrl)
 	]);
 };
 
 //#endregion
+exports.DocumentationRouter = require_init_documentationRouter.DocumentationRouter;
 exports.getDefaultApplicationURL = getDefaultApplicationURL;
+exports.getDocumentationUrl = require_init_documentationRouter.getDocumentationUrl;
 exports.initIntlayer = initIntlayer;
+exports.logInitSuccessMessage = logInitSuccessMessage;
 //# sourceMappingURL=index.cjs.map