@intlayer/engine 9.2.0 → 9.3.1

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

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
 //#region src/init/frameworkSetup/tanstackStart/templates.ts
 /**
 * File templates for a fresh TanStack Start integration. These are only written
@@ -35,25 +34,30 @@ export const Route = createFileRoute("/${localeSegment}")({
 `;
 /**
 * Root route document (`routes/__root.tsx`) providing `<html>` + the Intlayer
-* provider, with the locale read from the `{-$locale}` route param.
+* provider, with the locale read from the locale segment route params.
+*
+* The route is reached through `getRouteApi(<route id>)` rather than by
+* importing `<segment>/route`, so the root never imports a child route module —
+* the recommended way to consume another route's typed hooks.
 */
-const ROOT_TEMPLATE_TS = `import {
+const buildRootTemplateTs = (localeSegment) => `import {
   createRootRoute,
+  getRouteApi,
   HeadContent,
   Scripts,
-  useParams,
 } from "@tanstack/react-router";
 import { defaultLocale, getHTMLTextDir } from "intlayer";
 import type { ReactNode } from "react";
 import { IntlayerProvider } from "react-intlayer";
 
+const localeRoute = getRouteApi("/${localeSegment}");
+
 export const Route = createRootRoute({
   shellComponent: RootDocument,
 });
 
 function RootDocument({ children }: { children: ReactNode }) {
-  const params = useParams({ strict: false });
-  const locale = params.locale ?? defaultLocale;
+  const { locale = defaultLocale } = localeRoute.useParams();
 
   return (
     <html dir={getHTMLTextDir(locale)} lang={locale}>
@@ -68,22 +72,24 @@ function RootDocument({ children }: { children: ReactNode }) {
   );
 }
 `;
-const ROOT_TEMPLATE_JS = `import {
+/** JavaScript counterpart of {@link buildRootTemplateTs}. */
+const buildRootTemplateJs = (localeSegment) => `import {
   createRootRoute,
+  getRouteApi,
   HeadContent,
   Scripts,
-  useParams,
 } from "@tanstack/react-router";
 import { defaultLocale, getHTMLTextDir } from "intlayer";
 import { IntlayerProvider } from "react-intlayer";
 
+const localeRoute = getRouteApi("/${localeSegment}");
+
 export const Route = createRootRoute({
   shellComponent: RootDocument,
 });
 
 function RootDocument({ children }) {
-  const params = useParams({ strict: false });
-  const locale = params.locale ?? defaultLocale;
+  const { locale = defaultLocale } = localeRoute.useParams();
 
   return (
     <html dir={getHTMLTextDir(locale)} lang={locale}>
@@ -100,7 +106,7 @@ function RootDocument({ children }) {
 `;
 
 //#endregion
-exports.ROOT_TEMPLATE_JS = ROOT_TEMPLATE_JS;
-exports.ROOT_TEMPLATE_TS = ROOT_TEMPLATE_TS;
 exports.buildLocaleRouteTemplate = buildLocaleRouteTemplate;
+exports.buildRootTemplateJs = buildRootTemplateJs;
+exports.buildRootTemplateTs = buildRootTemplateTs;
 //# sourceMappingURL=templates.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"templates.cjs","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/templates.ts"],"sourcesContent":["/**\n * File templates for a fresh TanStack Start integration. These are only written\n * when the target file does not exist — they never overwrite user code.\n */\n\n/**\n * Builds the locale segment route (`routes/<localeSegment>/route.tsx`) for the\n * given segment. The optional `{-$locale}` param makes the default locale\n * prefix-free, while the required `$locale` param (`prefix-all`) prefixes every\n * locale; in both cases `validatePrefix` redirects unknown prefixes to a valid\n * one. Identical for TypeScript and JavaScript projects.\n */\nexport const buildLocaleRouteTemplate = (\n  localeSegment: string\n): string => `import { createFileRoute, Outlet, redirect } from \"@tanstack/react-router\";\nimport { validatePrefix } from \"intlayer\";\n\nexport const Route = createFileRoute(\"/${localeSegment}\")({\n  beforeLoad: ({ params }) => {\n    // beforeLoad runs on both client and server, so resolve the locale from the\n    // route params rather than from request headers.\n    const { isValid, localePrefix } = validatePrefix(params.locale);\n\n    // A valid (or absent, i.e. default) locale prefix is fine as-is.\n    if (isValid) return;\n\n    // Otherwise redirect to the same route with a valid locale prefix.\n    throw redirect({\n      params: { locale: localePrefix },\n      to: \"/${localeSegment}\",\n    });\n  },\n  component: Outlet,\n});\n`;\n\n/**\n * Root route document (`routes/__root.tsx`) providing `<html>` + the Intlayer\n * provider, with the locale read from the `{-$locale}` route param.\n */\nexport const ROOT_TEMPLATE_TS = `import {\n  createRootRoute,\n  HeadContent,\n  Scripts,\n  useParams,\n} from \"@tanstack/react-router\";\nimport { defaultLocale, getHTMLTextDir } from \"intlayer\";\nimport type { ReactNode } from \"react\";\nimport { IntlayerProvider } from \"react-intlayer\";\n\nexport const Route = createRootRoute({\n  shellComponent: RootDocument,\n});\n\nfunction RootDocument({ children }: { children: ReactNode }) {\n  const params = useParams({ strict: false });\n  const locale = params.locale ?? defaultLocale;\n\n  return (\n    <html dir={getHTMLTextDir(locale)} lang={locale}>\n      <head>\n        <HeadContent />\n      </head>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n        <Scripts />\n      </body>\n    </html>\n  );\n}\n`;\n\nexport const ROOT_TEMPLATE_JS = `import {\n  createRootRoute,\n  HeadContent,\n  Scripts,\n  useParams,\n} from \"@tanstack/react-router\";\nimport { defaultLocale, getHTMLTextDir } from \"intlayer\";\nimport { IntlayerProvider } from \"react-intlayer\";\n\nexport const Route = createRootRoute({\n  shellComponent: RootDocument,\n});\n\nfunction RootDocument({ children }) {\n  const params = useParams({ strict: false });\n  const locale = params.locale ?? defaultLocale;\n\n  return (\n    <html dir={getHTMLTextDir(locale)} lang={locale}>\n      <head>\n        <HeadContent />\n      </head>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n        <Scripts />\n      </body>\n    </html>\n  );\n}\n`;\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAa,4BACX,kBACW;;;yCAG4B,cAAc;;;;;;;;;;;;cAYzC,cAAc;;;;;;;;;;AAW5B,MAAa,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgChC,MAAa,mBAAmB"}
+{"version":3,"file":"templates.cjs","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/templates.ts"],"sourcesContent":["/**\n * File templates for a fresh TanStack Start integration. These are only written\n * when the target file does not exist — they never overwrite user code.\n */\n\n/**\n * Builds the locale segment route (`routes/<localeSegment>/route.tsx`) for the\n * given segment. The optional `{-$locale}` param makes the default locale\n * prefix-free, while the required `$locale` param (`prefix-all`) prefixes every\n * locale; in both cases `validatePrefix` redirects unknown prefixes to a valid\n * one. Identical for TypeScript and JavaScript projects.\n */\nexport const buildLocaleRouteTemplate = (\n  localeSegment: string\n): string => `import { createFileRoute, Outlet, redirect } from \"@tanstack/react-router\";\nimport { validatePrefix } from \"intlayer\";\n\nexport const Route = createFileRoute(\"/${localeSegment}\")({\n  beforeLoad: ({ params }) => {\n    // beforeLoad runs on both client and server, so resolve the locale from the\n    // route params rather than from request headers.\n    const { isValid, localePrefix } = validatePrefix(params.locale);\n\n    // A valid (or absent, i.e. default) locale prefix is fine as-is.\n    if (isValid) return;\n\n    // Otherwise redirect to the same route with a valid locale prefix.\n    throw redirect({\n      params: { locale: localePrefix },\n      to: \"/${localeSegment}\",\n    });\n  },\n  component: Outlet,\n});\n`;\n\n/**\n * Root route document (`routes/__root.tsx`) providing `<html>` + the Intlayer\n * provider, with the locale read from the locale segment route params.\n *\n * The route is reached through `getRouteApi(<route id>)` rather than by\n * importing `<segment>/route`, so the root never imports a child route module —\n * the recommended way to consume another route's typed hooks.\n */\nexport const buildRootTemplateTs = (localeSegment: string): string => `import {\n  createRootRoute,\n  getRouteApi,\n  HeadContent,\n  Scripts,\n} from \"@tanstack/react-router\";\nimport { defaultLocale, getHTMLTextDir } from \"intlayer\";\nimport type { ReactNode } from \"react\";\nimport { IntlayerProvider } from \"react-intlayer\";\n\nconst localeRoute = getRouteApi(\"/${localeSegment}\");\n\nexport const Route = createRootRoute({\n  shellComponent: RootDocument,\n});\n\nfunction RootDocument({ children }: { children: ReactNode }) {\n  const { locale = defaultLocale } = localeRoute.useParams();\n\n  return (\n    <html dir={getHTMLTextDir(locale)} lang={locale}>\n      <head>\n        <HeadContent />\n      </head>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n        <Scripts />\n      </body>\n    </html>\n  );\n}\n`;\n\n/** JavaScript counterpart of {@link buildRootTemplateTs}. */\nexport const buildRootTemplateJs = (localeSegment: string): string => `import {\n  createRootRoute,\n  getRouteApi,\n  HeadContent,\n  Scripts,\n} from \"@tanstack/react-router\";\nimport { defaultLocale, getHTMLTextDir } from \"intlayer\";\nimport { IntlayerProvider } from \"react-intlayer\";\n\nconst localeRoute = getRouteApi(\"/${localeSegment}\");\n\nexport const Route = createRootRoute({\n  shellComponent: RootDocument,\n});\n\nfunction RootDocument({ children }) {\n  const { locale = defaultLocale } = localeRoute.useParams();\n\n  return (\n    <html dir={getHTMLTextDir(locale)} lang={locale}>\n      <head>\n        <HeadContent />\n      </head>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n        <Scripts />\n      </body>\n    </html>\n  );\n}\n`;\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAa,4BACX,kBACW;;;yCAG4B,cAAc;;;;;;;;;;;;cAYzC,cAAc;;;;;;;;;;;;;;AAe5B,MAAa,uBAAuB,kBAAkC;;;;;;;;;;oCAUlC,cAAc;;;;;;;;;;;;;;;;;;;;;;;AAwBlD,MAAa,uBAAuB,kBAAkC;;;;;;;;;oCASlC,cAAc"}

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

@@ -7,6 +7,8 @@ recast = require_runtime.__toESM(recast);
 
 //#region src/init/frameworkSetup/tanstackStart/transforms.ts
 const { builders: b, namedTypes: n } = recast.types;
+/** Module-scope identifier bound to the locale route's typed API. */
+const LOCALE_ROUTE_API_VARIABLE = "localeRoute";
 /** babel-ts parser handles TypeScript *and* JSX. */
 const parseTsx = (code) => recast.parse(code, { parser: require_utils_babelParser.babelTsParser });
 /**
@@ -51,27 +53,59 @@ const patternBindsName = (node, name) => {
 	}
 };
 /**
-* Inserts `const locale = …` once, at the top of the function body. A single
-* self-contained statement is used (rather than an intermediate `params` const)
-* so it can never collide with a `params` variable the document already
-* declares. Expression-bodied arrow functions are first converted to a block so
-* the declaration has somewhere to live.
+* Inserts `const { locale = defaultLocale } = localeRoute.useParams();` once, at
+* the top of the function body. The destructuring form binds only `locale`, so
+* it can never collide with a `params` variable the document already declares.
+* Expression-bodied arrow functions are first converted to a block so the
+* declaration has somewhere to live.
 *
 * No-ops when `locale` is already bound in the function — whether as a simple
 * identifier, through a destructuring pattern (e.g.
-* `const { locale = defaultLocale } = useLoaderData()`), or as a function
+* `const { locale = defaultLocale } = Route.useLoaderData()`), or as a function
 * parameter — so the injected declaration never collides with one the document
 * already provides (which would produce an
 * `Identifier 'locale' has already been declared` parse error).
+*
+* @returns `true` when the declaration was injected, `false` when the document
+* already binds `locale` itself. Callers use this to skip the imports and the
+* route API declaration the injected statement would have needed.
 */
 const ensureLocaleFromParams = (funcNode) => {
 	if (funcNode.body?.type !== "BlockStatement") funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);
 	const declaredInBody = funcNode.body.body.some((stmt) => stmt.type === "VariableDeclaration" && stmt.declarations.some((d) => patternBindsName(d.id, "locale")));
 	const declaredInParams = (funcNode.params ?? []).some((param) => patternBindsName(param, "locale"));
-	if (declaredInBody || declaredInParams) return;
-	const statement = parseTsx("const locale = useParams({ strict: false }).locale ?? defaultLocale;").program.body[0];
+	if (declaredInBody || declaredInParams) return false;
+	const statement = parseTsx(`const { locale = defaultLocale } = ${LOCALE_ROUTE_API_VARIABLE}.useParams();`).program.body[0];
 	funcNode.body.body.unshift(statement);
+	return true;
 };
+/**
+* Ensures the module-scope `const localeRoute = getRouteApi("/<segment>");`
+* declaration the injected locale statement reads from, inserted right after the
+* import block.
+*
+* Referencing the locale route by id keeps the root document free of an import
+* of `<segment>/route` — importing a child route module from `__root` is
+* discouraged, since the generated route tree already imports the root.
+*
+* No-ops when `localeRoute` is already bound at module scope, reusing that
+* binding rather than redeclaring it (which would be a parse error).
+*
+* @returns `true` when the declaration was inserted, `false` when an existing
+* binding was reused.
+*/
+const ensureLocaleRouteApi = (ast, localeSegment) => {
+	if (require_init_utils_astImports.isModuleScopeBinding(ast, LOCALE_ROUTE_API_VARIABLE)) return false;
+	const declaration = parseTsx(`const ${LOCALE_ROUTE_API_VARIABLE} = getRouteApi("/${localeSegment}");`).program.body[0];
+	ast.program.body.splice(require_init_utils_astImports.firstInsertIndex(ast), 0, declaration);
+	return true;
+};
+/**
+* Puts a blank line between the import block and the inserted route API
+* declaration — recast prints a spliced statement flush against the preceding
+* line, which reads as part of the imports.
+*/
+const separateRouteApiDeclaration = (printedCode) => printedCode.replace(new RegExp(`([^\\n])\\n(const ${LOCALE_ROUTE_API_VARIABLE} = getRouteApi\\()`), "$1\n\n$2");
 /** Sets `lang={locale}` and `dir={getHTMLTextDir(locale)}` on the first `<html>` element. */
 const setHtmlLangAndDir = (ast) => {
 	recast.visit(ast, { visitJSXOpeningElement(path) {
@@ -83,7 +117,7 @@ const setHtmlLangAndDir = (ast) => {
 		const upsertAttribute = (name, value) => {
 			const existing = node.attributes?.find((attr) => attr.type === "JSXAttribute" && attr.name?.name === name);
 			if (existing) existing.value = value;
-			else node.attributes.push(b.jsxAttribute(b.jsxIdentifier(name), value));
+			else node.attributes?.push(b.jsxAttribute(b.jsxIdentifier(name), value));
 		};
 		upsertAttribute("lang", b.jsxExpressionContainer(b.identifier("locale")));
 		upsertAttribute("dir", b.jsxExpressionContainer(b.callExpression(b.identifier("getHTMLTextDir"), [b.identifier("locale")])));
@@ -92,12 +126,16 @@ const setHtmlLangAndDir = (ast) => {
 };
 /**
 * Wraps the `{children}` of a TanStack Start root document with
-* `IntlayerProvider`, deriving the locale from the `{-$locale}` route param.
+* `IntlayerProvider`, deriving the locale from the locale segment route params.
 * Safe and idempotent: bails (returns the original code) when the provider is
 * already present, when no `<html>` document function is found, or when there is
 * no `{children}` placeholder to wrap.
+*
+* @param code Source of the project's `__root` document.
+* @param localeSegment Locale segment directory in use — `{-$locale}` for every
+* routing mode but `prefix-all`, which uses the required `$locale`.
 */
-const wrapRootWithProvider = (code) => {
+const wrapRootWithProvider = (code, localeSegment) => {
 	const ast = parseTsx(code);
 	if (code.includes("IntlayerProvider")) return {
 		code,
@@ -125,14 +163,19 @@ const wrapRootWithProvider = (code) => {
 		code,
 		status: "skipped"
 	};
+	const injectedLocaleDeclaration = ensureLocaleFromParams(funcNode);
 	require_init_utils_astImports.ensureNamedImport(ast, "IntlayerProvider", "react-intlayer");
-	require_init_utils_astImports.ensureNamedImport(ast, "useParams", "@tanstack/react-router");
-	require_init_utils_astImports.ensureNamedImport(ast, "defaultLocale", "intlayer");
+	let insertedRouteApi = false;
+	if (injectedLocaleDeclaration) {
+		require_init_utils_astImports.ensureNamedImport(ast, "getRouteApi", "@tanstack/react-router");
+		require_init_utils_astImports.ensureNamedImport(ast, "defaultLocale", "intlayer");
+		insertedRouteApi = ensureLocaleRouteApi(ast, localeSegment);
+	}
 	require_init_utils_astImports.ensureNamedImport(ast, "getHTMLTextDir", "intlayer");
-	ensureLocaleFromParams(funcNode);
 	setHtmlLangAndDir(ast);
+	const printedCode = recast.print(ast).code;
 	return {
-		code: recast.print(ast).code,
+		code: insertedRouteApi ? separateRouteApiDeclaration(printedCode) : printedCode,
 		status: "wrapped"
 	};
 };

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

@@ -1 +1 @@
-{"version":3,"file":"transforms.cjs","names":["babelTsParser"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/babelParser';\nimport { ensureNamedImport } from '../../utils/astImports';\n\nconst { builders: b, namedTypes: n } = recast.types;\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 = …` once, at the top of the function body. A single\n * self-contained statement is used (rather than an intermediate `params` const)\n * so it can never collide with a `params` variable the document already\n * declares. Expression-bodied arrow functions are first converted to a block so\n * the 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 } = 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 */\nconst ensureLocaleFromParams = (funcNode: any): void => {\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;\n\n  const statement = parseTsx(\n    'const locale = useParams({ strict: false }).locale ?? defaultLocale;'\n  ).program.body[0];\n  funcNode.body.body.unshift(statement);\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}` route param.\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 */\nexport const wrapRootWithProvider = (code: string): 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  ensureNamedImport(ast, 'IntlayerProvider', 'react-intlayer');\n  ensureNamedImport(ast, 'useParams', '@tanstack/react-router');\n  ensureNamedImport(ast, 'defaultLocale', 'intlayer');\n  ensureNamedImport(ast, 'getHTMLTextDir', 'intlayer');\n  ensureLocaleFromParams(funcNode);\n  setHtmlLangAndDir(ast);\n\n  return { code: recast.print(ast).code, status: 'wrapped' };\n};\n"],"mappings":"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"}
+{"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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"}

package/dist/cjs/init/index.cjs

@@ -35,14 +35,14 @@ const DocumentationRouter = {
 	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",
-	TanStackRouter: "https://intlayer.org/doc/environment/tanstack.md",
+	TanStackRouter: "https://intlayer.org/doc/environment/tanstack-start.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/nestjs.md",
+	NestJS: "https://intlayer.org/doc/environment/nest.md",
 	Fastify: "https://intlayer.org/doc/environment/fastify.md",
 	Default: "https://intlayer.org/doc/get-started",
 	LSP: "https://intlayer.org/doc/lsp.md",
@@ -151,7 +151,8 @@ const initIntlayer = async (rootDir, options) => {
 	const linguiPresent = Boolean(effectiveAllDeps["@lingui/core"] || effectiveAllDeps["@lingui/react"] || effectiveAllDeps["@intlayer/lingui"]);
 	const linguiCatalog = linguiPresent ? await require_init_utils_fileSystem.detectLinguiCatalogPattern(rootDir) : null;
 	const hintLinguiJson = Boolean(options?.hintDependencies?.["__lingui_json__"]);
-	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig } = require_init_utils_packageManager.detectMissingIntlayerPackages(effectiveAllDeps, { linguiCatalogFormat: linguiCatalog?.format ?? (linguiPresent ? hintLinguiJson ? "json" : "po" : null) });
+	const linguiCatalogFormat = linguiCatalog?.format ?? (linguiPresent ? hintLinguiJson ? "json" : "po" : null);
+	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig } = require_init_utils_packageManager.detectMissingIntlayerPackages(effectiveAllDeps, { linguiCatalogFormat });
 	const wantsJsonNamespaces = options?.contentStrategy === "json-namespaces" && !compatSyncConfig;
 	if (wantsJsonNamespaces && !effectiveAllDeps["@intlayer/sync-json-plugin"] && !devPackagesToInstall.includes("@intlayer/sync-json-plugin")) devPackagesToInstall.push("@intlayer/sync-json-plugin");
 	if (!options?.noInstallPackages) {
@@ -194,7 +195,8 @@ const initIntlayer = async (rootDir, options) => {
 	if (!options?.noGitignore && await require_init_utils_fileSystem.exists(rootDir, gitignorePath)) {
 		const gitignoreContent = await require_init_utils_fileSystem.readFileFromRoot(rootDir, gitignorePath);
 		if (!gitignoreContent.includes("intlayer")) {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, gitignorePath, `${gitignoreContent}\n# Intlayer\n.intlayer\n`);
+			const newContent = `${gitignoreContent}\n# Intlayer\n.intlayer\n`;
+			await require_init_utils_fileSystem.writeFileToRoot(rootDir, gitignorePath, newContent);
 			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Added ${(0, _intlayer_config_logger.colorizePath)(".intlayer")} to ${(0, _intlayer_config_logger.colorizePath)(gitignorePath)}`);
 		} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(gitignorePath)} already includes .intlayer`);
 	}
@@ -220,8 +222,10 @@ const initIntlayer = async (rootDir, options) => {
 	const extensionId = "intlayer.intlayer-vs-code-extension";
 	if (!options?.noVscodeExtension) try {
 		let extensionsConfig = { recommendations: [] };
-		if (await require_init_utils_fileSystem.exists(rootDir, extensionsJsonPath)) extensionsConfig = require_init_utils_jsonParser.parseJSONWithComments(await require_init_utils_fileSystem.readFileFromRoot(rootDir, extensionsJsonPath));
-		else await require_init_utils_fileSystem.ensureDirectory(rootDir, vscodeDir);
+		if (await require_init_utils_fileSystem.exists(rootDir, extensionsJsonPath)) {
+			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, extensionsJsonPath);
+			extensionsConfig = require_init_utils_jsonParser.parseJSONWithComments(content);
+		} else await require_init_utils_fileSystem.ensureDirectory(rootDir, vscodeDir);
 		if (!extensionsConfig.recommendations) extensionsConfig.recommendations = [];
 		if (!extensionsConfig.recommendations.includes(extensionId)) {
 			extensionsConfig.recommendations.push(extensionId);
@@ -234,8 +238,10 @@ const initIntlayer = async (rootDir, options) => {
 	const settingsJsonPath = (0, node_path.join)(vscodeDir, "settings.json");
 	if (!options?.noLsp) try {
 		let settingsConfig = {};
-		if (await require_init_utils_fileSystem.exists(rootDir, settingsJsonPath)) settingsConfig = require_init_utils_jsonParser.parseJSONWithComments(await require_init_utils_fileSystem.readFileFromRoot(rootDir, settingsJsonPath));
-		else await require_init_utils_fileSystem.ensureDirectory(rootDir, vscodeDir);
+		if (await require_init_utils_fileSystem.exists(rootDir, settingsJsonPath)) {
+			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, settingsJsonPath);
+			settingsConfig = require_init_utils_jsonParser.parseJSONWithComments(content);
+		} else await require_init_utils_fileSystem.ensureDirectory(rootDir, vscodeDir);
 		let settingsUpdated = false;
 		if (!settingsConfig["intlayer.languageServer.command"]) {
 			settingsConfig["intlayer.languageServer.command"] = "npx";
@@ -257,7 +263,8 @@ const initIntlayer = async (rootDir, options) => {
 	for (const fileName of tsConfigFiles) if (await require_init_utils_fileSystem.exists(rootDir, fileName)) {
 		hasTsConfig = true;
 		try {
-			const config = require_init_utils_jsonParser.parseJSONWithComments(await require_init_utils_fileSystem.readFileFromRoot(rootDir, fileName));
+			const fileContent = await require_init_utils_fileSystem.readFileFromRoot(rootDir, fileName);
+			const config = require_init_utils_jsonParser.parseJSONWithComments(fileContent);
 			const typeDefinition = "./.intlayer/**/*.ts";
 			let updated = false;
 			if (!config.include) {} else if (Array.isArray(config.include) && !config.include.some((pattern) => pattern.includes(".intlayer"))) {
@@ -301,7 +308,9 @@ const initIntlayer = async (rootDir, options) => {
 		]) if (await require_init_utils_fileSystem.exists(rootDir, configFile)) {
 			const configContent = await require_init_utils_fileSystem.readFileFromRoot(rootDir, configFile);
 			if (!configContent.includes(syncPluginPackage)) {
-				await require_init_utils_fileSystem.writeFileToRoot(rootDir, configFile, require_init_utils_configManipulation.updateIntlayerConfigWithSyncPlugin(configContent, configFile.split(".").pop(), resolvedSyncConfig));
+				const extension = configFile.split(".").pop();
+				const updatedConfigContent = require_init_utils_configManipulation.updateIntlayerConfigWithSyncPlugin(configContent, extension, resolvedSyncConfig);
+				await require_init_utils_fileSystem.writeFileToRoot(rootDir, configFile, updatedConfigContent);
 				(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(configFile)} with ${syncPluginName} compat plugin`);
 			} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(configFile)} already includes ${syncPluginName} plugin`);
 			break;
@@ -321,15 +330,18 @@ const initIntlayer = async (rootDir, options) => {
 			const { replacesVitePlugin } = compatVitePluginConfig;
 			if (content.includes(compatVitePluginConfig.pluginPackageSource)) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes ${compatVitePluginConfig.pluginPackageSource}`);
 			else if (replacesVitePlugin && content.includes(replacesVitePlugin.fromPackageSource)) {
-				await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.replaceViteConfigPluginImportSource(content, replacesVitePlugin.importName, replacesVitePlugin.fromPackageSource, compatVitePluginConfig.pluginPackageSource));
+				const updatedContent = require_init_utils_configManipulation.replaceViteConfigPluginImportSource(content, replacesVitePlugin.importName, replacesVitePlugin.fromPackageSource, compatVitePluginConfig.pluginPackageSource);
+				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 import ${replacesVitePlugin.importName} from ${compatVitePluginConfig.pluginPackageSource}`);
 			} else {
-				await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateViteConfigForCompatPlugin(content, extension, compatVitePluginConfig));
+				const updatedContent = require_init_utils_configManipulation.updateViteConfigForCompatPlugin(content, extension, compatVitePluginConfig);
+				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 ${compatVitePluginConfig.pluginFunctionName} compat plugin`);
 			}
 		} else if (require_init_utils_configManipulation.hasIntlayerVitePlugin(content)) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes an Intlayer plugin`);
 		else {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateViteConfig(content, extension));
+			const updatedContent = require_init_utils_configManipulation.updateViteConfig(content, extension);
+			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 plugin`);
 		}
 		break;
@@ -345,20 +357,27 @@ const initIntlayer = async (rootDir, options) => {
 		hasAliasConfiguration = true;
 		const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, file);
 		const extension = file.split(".").pop();
-		if (allDeps["next-i18next"]) if (!content.includes("@intlayer/next-i18next")) {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateNextConfigForNextI18next(content, extension));
-			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(file)} to include Intlayer next-i18next compat plugin`);
-		} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/next-i18next`);
-		else if (allDeps["next-intl"]) if (!content.includes("@intlayer/next-intl/plugin")) {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateNextConfigForNextIntl(content, extension));
-			(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"]) if (!content.includes("@intlayer/next-translate")) {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateNextConfigForNextTranslate(content, extension));
-			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(file)} to include Intlayer next-translate compat plugin`);
-		} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/next-translate`);
-		else if (!content.includes("next-intlayer")) {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateNextConfig(content, extension));
+		if (allDeps["next-i18next"]) {
+			if (!content.includes("@intlayer/next-i18next")) {
+				const updatedContent = require_init_utils_configManipulation.updateNextConfigForNextI18next(content, extension);
+				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-i18next compat plugin`);
+			} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/next-i18next`);
+		} else if (allDeps["next-intl"]) {
+			if (!content.includes("@intlayer/next-intl/plugin")) {
+				const updatedContent = require_init_utils_configManipulation.updateNextConfigForNextIntl(content, extension);
+				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"]) {
+			if (!content.includes("@intlayer/next-translate")) {
+				const updatedContent = require_init_utils_configManipulation.updateNextConfigForNextTranslate(content, extension);
+				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-translate compat plugin`);
+			} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/next-translate`);
+		} else if (!content.includes("next-intlayer")) {
+			const updatedContent = require_init_utils_configManipulation.updateNextConfig(content, extension);
+			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 plugin`);
 		}
 		break;
@@ -379,7 +398,9 @@ const initIntlayer = async (rootDir, options) => {
 		if (file.startsWith("astro.config.")) {
 			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, file);
 			if (!content.includes("astro-intlayer")) {
-				await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateAstroConfig(content, file.split(".").pop()));
+				const extension = file.split(".").pop();
+				const updatedContent = require_init_utils_configManipulation.updateAstroConfig(content, extension);
+				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 integration`);
 			}
 		}
@@ -388,12 +409,15 @@ 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 (!content.includes("@intlayer/nuxtjs-i18n")) {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateNuxtConfigForNuxtjsI18n(content));
-			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(file)} to include @intlayer/nuxtjs-i18n module`);
-		} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/nuxtjs-i18n`);
-		else if (!content.includes("nuxt-intlayer")) {
-			await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, require_init_utils_configManipulation.updateNuxtConfig(content));
+		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);
+				(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(file)} to include @intlayer/nuxtjs-i18n module`);
+			} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/nuxtjs-i18n`);
+		} else if (!content.includes("nuxt-intlayer")) {
+			const updatedContent = require_init_utils_configManipulation.updateNuxtConfig(content);
+			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 module`);
 		}
 		break;
@@ -415,7 +439,8 @@ const initIntlayer = async (rootDir, options) => {
 			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, metroConfigFile);
 			if (content.includes("react-native-intlayer")) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(metroConfigFile)} already includes the Intlayer Metro plugin`);
 			else {
-				const updatedContent = require_init_utils_configManipulation.updateMetroConfig(content, metroConfigFile.split(".").pop());
+				const extension = metroConfigFile.split(".").pop();
+				const updatedContent = require_init_utils_configManipulation.updateMetroConfig(content, extension);
 				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`);
@@ -459,11 +484,13 @@ const initIntlayer = async (rootDir, options) => {
 		...backendIntlayerPackages
 	].some((pkg) => allDeps[pkg])) hasAliasConfiguration = true;
 	if (!hasAliasConfiguration) {
-		const aliases = (0, _intlayer_config_utils.getAlias)({ configuration: (0, _intlayer_config_node.getConfiguration)({ baseDir: rootDir }) });
+		const configuration = (0, _intlayer_config_node.getConfiguration)({ baseDir: rootDir });
+		const aliases = (0, _intlayer_config_utils.getAlias)({ configuration });
 		if (hasTsConfig && tsConfigFiles.length > 0) {
 			const tsConfigPath = tsConfigFiles.find((file) => file === "tsconfig.json") || tsConfigFiles[0];
 			if (tsConfigPath) {
-				const config = require_init_utils_jsonParser.parseJSONWithComments(await require_init_utils_fileSystem.readFileFromRoot(rootDir, tsConfigPath));
+				const tsConfigContent = await require_init_utils_fileSystem.readFileFromRoot(rootDir, tsConfigPath);
+				const config = require_init_utils_jsonParser.parseJSONWithComments(tsConfigContent);
 				config.compilerOptions ??= {};
 				config.compilerOptions.paths ??= {};
 				let updated = false;
@@ -481,7 +508,8 @@ const initIntlayer = async (rootDir, options) => {
 		} else {
 			const jsConfigPath = "jsconfig.json";
 			if (await require_init_utils_fileSystem.exists(rootDir, jsConfigPath)) {
-				const config = require_init_utils_jsonParser.parseJSONWithComments(await require_init_utils_fileSystem.readFileFromRoot(rootDir, jsConfigPath));
+				const jsConfigContent = await require_init_utils_fileSystem.readFileFromRoot(rootDir, jsConfigPath);
+				const config = require_init_utils_jsonParser.parseJSONWithComments(jsConfigContent);
 				config.compilerOptions ??= {};
 				config.compilerOptions.paths ??= {};
 				let updated = false;