@intlayer/engine 9.0.0-canary.12

package/dist/esm/init/frameworkSetup/nextAppRouter/templates.mjs

@@ -0,0 +1,113 @@
+//#region src/init/frameworkSetup/nextAppRouter/templates.ts
+/**
+* File templates for a fresh Next.js App Router integration. These are only
+* written when the target file does not exist (or, for the locale layout/page,
+* when the app is effectively empty) — they never overwrite user code.
+*/
+/** Next.js >= 16 locale-detection proxy (`src/proxy.ts`). */
+const PROXY_TEMPLATE = `export { intlayerProxy as proxy } from "next-intlayer/proxy";
+
+export const config = {
+  matcher:
+    "/((?!api|static|assets|robots|sitemap|sw|service-worker|manifest|.*\\\\..*|_next).*)",
+};
+`;
+/** Next.js < 16 locale-detection middleware (`src/middleware.ts`). */
+const MIDDLEWARE_TEMPLATE = `export { intlayerMiddleware as middleware } from "next-intlayer/middleware";
+
+export const config = {
+  matcher:
+    "/((?!api|static|assets|robots|sitemap|sw|service-worker|manifest|.*\\\\..*|_next).*)",
+};
+`;
+/** Minimal pass-through root layout (`app/layout.tsx`), lets `[locale]/layout` own `<html>`. */
+const ROOT_LAYOUT_TEMPLATE_TS = `import type { PropsWithChildren, FC } from "react";
+
+const RootLayout: FC<PropsWithChildren> = ({ children }) => <>{children}</>;
+
+export default RootLayout;
+`;
+const ROOT_LAYOUT_TEMPLATE_JS = `const RootLayout = ({ children }) => <>{children}</>;
+
+export default RootLayout;
+`;
+/** Locale layout (`app/[locale]/layout.tsx`) providing `<html>` + client provider. */
+const LOCALE_LAYOUT_TEMPLATE_TS = `import { type NextLayoutIntlayer, IntlayerClientProvider } from "next-intlayer";
+import { getHTMLTextDir } from "intlayer";
+
+export { generateStaticParams } from "next-intlayer";
+
+const LocaleLayout: NextLayoutIntlayer = async ({ children, params }) => {
+  const { locale } = await params;
+
+  return (
+    <html lang={locale} dir={getHTMLTextDir(locale)}>
+      <body>
+        <IntlayerClientProvider locale={locale}>
+          {children}
+        </IntlayerClientProvider>
+      </body>
+    </html>
+  );
+};
+
+export default LocaleLayout;
+`;
+const LOCALE_LAYOUT_TEMPLATE_JS = `import { IntlayerClientProvider } from "next-intlayer";
+import { getHTMLTextDir } from "intlayer";
+
+export { generateStaticParams } from "next-intlayer";
+
+const LocaleLayout = async ({ children, params }) => {
+  const { locale } = await params;
+
+  return (
+    <html lang={locale} dir={getHTMLTextDir(locale)}>
+      <body>
+        <IntlayerClientProvider locale={locale}>
+          {children}
+        </IntlayerClientProvider>
+      </body>
+    </html>
+  );
+};
+
+export default LocaleLayout;
+`;
+/**
+* Locale home page (`app/[locale]/page.tsx`). Self-contained starter that does
+* not depend on an example content declaration — add Intlayer content (a
+* `*.content.ts` file consumed via `useIntlayer`) as the next step.
+*/
+const LOCALE_PAGE_TEMPLATE_TS = `import { type NextPageIntlayer } from "next-intlayer";
+
+const Page: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  return (
+    <main>
+      <h1>{locale}</h1>
+      <p>Get started by editing this page.</p>
+    </main>
+  );
+};
+
+export default Page;
+`;
+const LOCALE_PAGE_TEMPLATE_JS = `const Page = async ({ params }) => {
+  const { locale } = await params;
+
+  return (
+    <main>
+      <h1>{locale}</h1>
+      <p>Get started by editing this page.</p>
+    </main>
+  );
+};
+
+export default Page;
+`;
+
+//#endregion
+export { LOCALE_LAYOUT_TEMPLATE_JS, LOCALE_LAYOUT_TEMPLATE_TS, LOCALE_PAGE_TEMPLATE_JS, LOCALE_PAGE_TEMPLATE_TS, MIDDLEWARE_TEMPLATE, PROXY_TEMPLATE, ROOT_LAYOUT_TEMPLATE_JS, ROOT_LAYOUT_TEMPLATE_TS };
+//# sourceMappingURL=templates.mjs.map

package/dist/esm/init/frameworkSetup/nextAppRouter/templates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/templates.ts"],"sourcesContent":["/**\n * File templates for a fresh Next.js App Router integration. These are only\n * written when the target file does not exist (or, for the locale layout/page,\n * when the app is effectively empty) — they never overwrite user code.\n */\n\n/** Next.js >= 16 locale-detection proxy (`src/proxy.ts`). */\nexport const PROXY_TEMPLATE = `export { intlayerProxy as proxy } from \"next-intlayer/proxy\";\n\nexport const config = {\n  matcher:\n    \"/((?!api|static|assets|robots|sitemap|sw|service-worker|manifest|.*\\\\\\\\..*|_next).*)\",\n};\n`;\n\n/** Next.js < 16 locale-detection middleware (`src/middleware.ts`). */\nexport const MIDDLEWARE_TEMPLATE = `export { intlayerMiddleware as middleware } from \"next-intlayer/middleware\";\n\nexport const config = {\n  matcher:\n    \"/((?!api|static|assets|robots|sitemap|sw|service-worker|manifest|.*\\\\\\\\..*|_next).*)\",\n};\n`;\n\n/** Minimal pass-through root layout (`app/layout.tsx`), lets `[locale]/layout` own `<html>`. */\nexport const ROOT_LAYOUT_TEMPLATE_TS = `import type { PropsWithChildren, FC } from \"react\";\n\nconst RootLayout: FC<PropsWithChildren> = ({ children }) => <>{children}</>;\n\nexport default RootLayout;\n`;\n\nexport const ROOT_LAYOUT_TEMPLATE_JS = `const RootLayout = ({ children }) => <>{children}</>;\n\nexport default RootLayout;\n`;\n\n/** Locale layout (`app/[locale]/layout.tsx`) providing `<html>` + client provider. */\nexport const LOCALE_LAYOUT_TEMPLATE_TS = `import { type NextLayoutIntlayer, IntlayerClientProvider } from \"next-intlayer\";\nimport { getHTMLTextDir } from \"intlayer\";\n\nexport { generateStaticParams } from \"next-intlayer\";\n\nconst LocaleLayout: NextLayoutIntlayer = async ({ children, params }) => {\n  const { locale } = await params;\n\n  return (\n    <html lang={locale} dir={getHTMLTextDir(locale)}>\n      <body>\n        <IntlayerClientProvider locale={locale}>\n          {children}\n        </IntlayerClientProvider>\n      </body>\n    </html>\n  );\n};\n\nexport default LocaleLayout;\n`;\n\nexport const LOCALE_LAYOUT_TEMPLATE_JS = `import { IntlayerClientProvider } from \"next-intlayer\";\nimport { getHTMLTextDir } from \"intlayer\";\n\nexport { generateStaticParams } from \"next-intlayer\";\n\nconst LocaleLayout = async ({ children, params }) => {\n  const { locale } = await params;\n\n  return (\n    <html lang={locale} dir={getHTMLTextDir(locale)}>\n      <body>\n        <IntlayerClientProvider locale={locale}>\n          {children}\n        </IntlayerClientProvider>\n      </body>\n    </html>\n  );\n};\n\nexport default LocaleLayout;\n`;\n\n/**\n * Locale home page (`app/[locale]/page.tsx`). Self-contained starter that does\n * not depend on an example content declaration — add Intlayer content (a\n * `*.content.ts` file consumed via `useIntlayer`) as the next step.\n */\nexport const LOCALE_PAGE_TEMPLATE_TS = `import { type NextPageIntlayer } from \"next-intlayer\";\n\nconst Page: NextPageIntlayer = async ({ params }) => {\n  const { locale } = await params;\n\n  return (\n    <main>\n      <h1>{locale}</h1>\n      <p>Get started by editing this page.</p>\n    </main>\n  );\n};\n\nexport default Page;\n`;\n\nexport const LOCALE_PAGE_TEMPLATE_JS = `const Page = async ({ params }) => {\n  const { locale } = await params;\n\n  return (\n    <main>\n      <h1>{locale}</h1>\n      <p>Get started by editing this page.</p>\n    </main>\n  );\n};\n\nexport default Page;\n`;\n"],"mappings":";;;;;;;AAOA,MAAa,iBAAiB;;;;;;;;AAS9B,MAAa,sBAAsB;;;;;;;;AASnC,MAAa,0BAA0B;;;;;;AAOvC,MAAa,0BAA0B;;;;;AAMvC,MAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;;AAsBzC,MAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BzC,MAAa,0BAA0B;;;;;;;;;;;;;;;AAgBvC,MAAa,0BAA0B"}

package/dist/esm/init/frameworkSetup/nextAppRouter/transforms.mjs

@@ -0,0 +1,193 @@
+import { __require } from "../../../_virtual/_rolldown/runtime.mjs";
+import { ensureNamedImport, firstInsertIndex } from "../../utils/astImports.mjs";
+import * as recast from "recast";
+
+//#region src/init/frameworkSetup/nextAppRouter/transforms.ts
+const { builders: b } = recast.types;
+/** babel-ts parser handles TypeScript *and* JSX (the `typescript` parser does not). */
+const parseTsx = (code) => recast.parse(code, { parser: __require("recast/parsers/babel-ts") });
+/** Detects a top-level `'use client'` directive (client components can't be async server providers). */
+const isClientComponent = (ast) => {
+	if ((ast.program.directives ?? []).some((directive) => directive.value?.value === "use client")) return true;
+	return ast.program.body.some((stmt) => stmt.type === "ExpressionStatement" && stmt.expression?.type === "StringLiteral" && stmt.expression.value === "use client");
+};
+/** Finds the function node behind `export default`, following an identifier reference if needed. */
+const findDefaultExportFunction = (ast) => {
+	const body = ast.program.body;
+	const asFunction = (node) => node && (node.type === "ArrowFunctionExpression" || node.type === "FunctionExpression" || node.type === "FunctionDeclaration") ? node : null;
+	for (const stmt of body) {
+		if (stmt.type !== "ExportDefaultDeclaration") continue;
+		const direct = asFunction(stmt.declaration);
+		if (direct) return direct;
+		if (stmt.declaration?.type === "Identifier") {
+			const name = stmt.declaration.name;
+			for (const candidate of body) {
+				if (candidate.type === "VariableDeclaration") {
+					for (const declarator of candidate.declarations) if (declarator.id?.type === "Identifier" && declarator.id.name === name) {
+						const fn = asFunction(declarator.init);
+						if (fn) return fn;
+					}
+				}
+				if (candidate.type === "FunctionDeclaration" && candidate.id?.name === name) return candidate;
+			}
+		}
+	}
+	return null;
+};
+/** Ensures `export { exportedName } from source`, skipping when already declared/re-exported. */
+const ensureExportFrom = (ast, exportedName, source) => {
+	if (ast.program.body.some((stmt) => {
+		if (stmt.type === "ExportNamedDeclaration" && stmt.source?.value === source) return stmt.specifiers.some((spec) => spec.exported?.name === exportedName);
+		if (stmt.type === "ExportNamedDeclaration" && stmt.declaration) {
+			const decl = stmt.declaration;
+			if (decl.type === "FunctionDeclaration" && decl.id?.name === exportedName) return true;
+			if (decl.type === "VariableDeclaration") return decl.declarations.some((d) => d.id?.type === "Identifier" && d.id.name === exportedName);
+		}
+		return false;
+	})) return;
+	const exportNode = parseTsx(`export { ${exportedName} } from "${source}";`).program.body[0];
+	ast.program.body.splice(firstInsertIndex(ast), 0, exportNode);
+};
+/** Makes the function async and inserts `const locale = await getLocale();` once, at the top of its body. */
+const ensureAwaitedLocale = (funcNode) => {
+	funcNode.async = true;
+	if (funcNode.body.type !== "BlockStatement") funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);
+	if (!funcNode.body.body.some((stmt) => stmt.type === "VariableDeclaration" && stmt.declarations.some((d) => d.id?.type === "Identifier" && d.id.name === "locale" || d.id?.type === "ObjectPattern" && d.id.properties?.some((prop) => prop.value?.type === "Identifier" && prop.value?.name === "locale")))) {
+		const localeStatement = parseTsx("const locale = await getLocale();").program.body[0];
+		funcNode.body.body.unshift(localeStatement);
+	}
+};
+/** Builds `<providerName locale={locale}>{child}</providerName>` around an existing JSX child node. */
+const buildProviderElement = (providerName, childNode) => {
+	const providerElement = parseTsx(`const __wrap = <${providerName} locale={locale}>{__child__}</${providerName}>;`).program.body[0].declarations[0].init;
+	providerElement.children = [childNode];
+	return providerElement;
+};
+/** Sets `lang={locale}` on the first `<html>` element, if present. */
+const setHtmlLang = (ast) => {
+	recast.visit(ast, { visitJSXOpeningElement(path) {
+		const node = path.node;
+		if (node.name?.type === "JSXIdentifier" && node.name.name === "html") {
+			const langAttr = node.attributes?.find((attr) => attr.type === "JSXAttribute" && attr.name?.name === "lang");
+			const localeExpression = b.jsxExpressionContainer(b.identifier("locale"));
+			if (langAttr) langAttr.value = localeExpression;
+			else node.attributes.push(b.jsxAttribute(b.jsxIdentifier("lang"), localeExpression));
+			return false;
+		}
+		this.traverse(path);
+	} });
+};
+/**
+* Wraps the `{children}` of a Next.js App Router **layout** with
+* `IntlayerClientProvider`, deriving the locale via `getLocale()`. Safe and
+* idempotent: bails (returns the original code) for client components, when no
+* `{children}` placeholder is found, or when there is no default export.
+*/
+const wrapLayoutWithProvider = (code) => {
+	const ast = parseTsx(code);
+	if (isClientComponent(ast)) return {
+		code,
+		status: "skipped-client"
+	};
+	if (code.includes("IntlayerClientProvider")) return {
+		code,
+		status: "already"
+	};
+	const funcNode = findDefaultExportFunction(ast);
+	if (!funcNode) return {
+		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") {
+			path.replace(buildProviderElement("IntlayerClientProvider", path.node));
+			wrapped = true;
+			return false;
+		}
+		this.traverse(path);
+	} });
+	if (!wrapped) return {
+		code,
+		status: "skipped"
+	};
+	ensureNamedImport(ast, "IntlayerClientProvider", "next-intlayer");
+	ensureNamedImport(ast, "getLocale", "next-intlayer/server");
+	ensureExportFrom(ast, "generateStaticParams", "next-intlayer");
+	ensureAwaitedLocale(funcNode);
+	setHtmlLang(ast);
+	return {
+		code: recast.print(ast).code,
+		status: "wrapped"
+	};
+};
+/** Returns the single top-level JSX return of a function, or the JSX of an expression-bodied arrow. */
+const findSingleJsxReturn = (funcNode) => {
+	if (funcNode.type === "ArrowFunctionExpression" && funcNode.body.type !== "BlockStatement") return (funcNode.body.type === "JSXElement" || funcNode.body.type === "JSXFragment" ? funcNode.body : null) ? {
+		kind: "arrow",
+		node: funcNode
+	} : null;
+	if (funcNode.body.type !== "BlockStatement") return null;
+	const jsxReturns = [];
+	let functionDepth = 0;
+	recast.visit(funcNode, {
+		visitFunction(path) {
+			functionDepth++;
+			if (functionDepth === 1) this.traverse(path);
+			functionDepth--;
+			return false;
+		},
+		visitReturnStatement(path) {
+			const argument = path.node.argument;
+			if (argument?.type === "JSXElement" || argument?.type === "JSXFragment") jsxReturns.push(path.node);
+			this.traverse(path);
+		}
+	});
+	if (jsxReturns.length !== 1) return null;
+	return {
+		kind: "return",
+		node: jsxReturns[0]
+	};
+};
+/**
+* Wraps the returned JSX of a Next.js App Router **page** with
+* `IntlayerServerProvider`, deriving the locale via `getLocale()`. Safe and
+* idempotent: bails for client components, when the page has no single
+* top-level JSX return, or when there is no default export.
+*/
+const wrapPageWithProvider = (code) => {
+	const ast = parseTsx(code);
+	if (isClientComponent(ast)) return {
+		code,
+		status: "skipped-client"
+	};
+	if (code.includes("IntlayerServerProvider")) return {
+		code,
+		status: "already"
+	};
+	const funcNode = findDefaultExportFunction(ast);
+	if (!funcNode) return {
+		code,
+		status: "skipped"
+	};
+	const jsxReturn = findSingleJsxReturn(funcNode);
+	if (!jsxReturn) return {
+		code,
+		status: "skipped"
+	};
+	if (jsxReturn.kind === "return") jsxReturn.node.argument = buildProviderElement("IntlayerServerProvider", jsxReturn.node.argument);
+	else jsxReturn.node.body = buildProviderElement("IntlayerServerProvider", jsxReturn.node.body);
+	ensureNamedImport(ast, "IntlayerServerProvider", "next-intlayer/server");
+	ensureNamedImport(ast, "getLocale", "next-intlayer/server");
+	ensureAwaitedLocale(funcNode);
+	return {
+		code: recast.print(ast).code,
+		status: "wrapped"
+	};
+};
+
+//#endregion
+export { wrapLayoutWithProvider, wrapPageWithProvider };
+//# sourceMappingURL=transforms.mjs.map

package/dist/esm/init/frameworkSetup/nextAppRouter/transforms.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { ensureNamedImport, firstInsertIndex } from '../../utils/astImports';\n\nconst { builders: b } = recast.types;\n\n/** babel-ts parser handles TypeScript *and* JSX (the `typescript` parser does not). */\nconst parseTsx = (code: string): any =>\n  recast.parse(code, { parser: require('recast/parsers/babel-ts') });\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-client' | 'skipped';\n};\n\n/** Detects a top-level `'use client'` directive (client components can't be async server providers). */\nconst isClientComponent = (ast: any): boolean => {\n  const directives = ast.program.directives ?? [];\n  if (\n    directives.some((directive: any) => directive.value?.value === 'use client')\n  ) {\n    return true;\n  }\n  return ast.program.body.some(\n    (stmt: any) =>\n      stmt.type === 'ExpressionStatement' &&\n      stmt.expression?.type === 'StringLiteral' &&\n      stmt.expression.value === 'use client'\n  );\n};\n\n/** Finds the function node behind `export default`, following an identifier reference if needed. */\nconst findDefaultExportFunction = (ast: any): any => {\n  const body = ast.program.body;\n\n  const asFunction = (node: any): any =>\n    node &&\n    (node.type === 'ArrowFunctionExpression' ||\n      node.type === 'FunctionExpression' ||\n      node.type === 'FunctionDeclaration')\n      ? node\n      : null;\n\n  for (const stmt of body) {\n    if (stmt.type !== 'ExportDefaultDeclaration') continue;\n\n    const direct = asFunction(stmt.declaration);\n    if (direct) return direct;\n\n    if (stmt.declaration?.type === 'Identifier') {\n      const name = stmt.declaration.name;\n      for (const candidate of body) {\n        if (candidate.type === 'VariableDeclaration') {\n          for (const declarator of candidate.declarations) {\n            if (\n              declarator.id?.type === 'Identifier' &&\n              declarator.id.name === name\n            ) {\n              const fn = asFunction(declarator.init);\n              if (fn) return fn;\n            }\n          }\n        }\n        if (\n          candidate.type === 'FunctionDeclaration' &&\n          candidate.id?.name === name\n        ) {\n          return candidate;\n        }\n      }\n    }\n  }\n\n  return null;\n};\n\n/** Ensures `export { exportedName } from source`, skipping when already declared/re-exported. */\nconst ensureExportFrom = (\n  ast: any,\n  exportedName: string,\n  source: string\n): void => {\n  const body = ast.program.body;\n\n  const alreadyPresent = body.some((stmt: any) => {\n    if (\n      stmt.type === 'ExportNamedDeclaration' &&\n      stmt.source?.value === source\n    ) {\n      return stmt.specifiers.some(\n        (spec: any) => spec.exported?.name === exportedName\n      );\n    }\n    // Locally declared `export const/function generateStaticParams`\n    if (stmt.type === 'ExportNamedDeclaration' && stmt.declaration) {\n      const decl = stmt.declaration;\n      if (decl.type === 'FunctionDeclaration' && decl.id?.name === exportedName)\n        return true;\n      if (decl.type === 'VariableDeclaration') {\n        return decl.declarations.some(\n          (d: any) => d.id?.type === 'Identifier' && d.id.name === exportedName\n        );\n      }\n    }\n    return false;\n  });\n\n  if (alreadyPresent) return;\n\n  const exportNode = parseTsx(`export { ${exportedName} } from \"${source}\";`)\n    .program.body[0];\n  ast.program.body.splice(firstInsertIndex(ast), 0, exportNode);\n};\n\n/** Makes the function async and inserts `const locale = await getLocale();` once, at the top of its body. */\nconst ensureAwaitedLocale = (funcNode: any): void => {\n  funcNode.async = true;\n\n  if (funcNode.body.type !== 'BlockStatement') {\n    funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);\n  }\n\n  const hasLocale = funcNode.body.body.some(\n    (stmt: any) =>\n      stmt.type === 'VariableDeclaration' &&\n      stmt.declarations.some(\n        (d: any) =>\n          // const locale = ...\n          (d.id?.type === 'Identifier' && d.id.name === 'locale') ||\n          // const { locale } = ... or const { locale: locale } = ...\n          (d.id?.type === 'ObjectPattern' &&\n            d.id.properties?.some(\n              (prop: any) =>\n                prop.value?.type === 'Identifier' &&\n                prop.value?.name === 'locale'\n            ))\n      )\n  );\n\n  if (!hasLocale) {\n    const localeStatement = parseTsx('const locale = await getLocale();')\n      .program.body[0];\n    funcNode.body.body.unshift(localeStatement);\n  }\n};\n\n/** Builds `<providerName locale={locale}>{child}</providerName>` around an existing JSX child node. */\nconst buildProviderElement = (providerName: string, childNode: any): any => {\n  const template = parseTsx(\n    `const __wrap = <${providerName} locale={locale}>{__child__}</${providerName}>;`\n  );\n  const providerElement = template.program.body[0].declarations[0].init;\n  providerElement.children = [childNode];\n  return providerElement;\n};\n\n/** Sets `lang={locale}` on the first `<html>` element, if present. */\nconst setHtmlLang = (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        const langAttr = node.attributes?.find(\n          (attr: any) =>\n            attr.type === 'JSXAttribute' && attr.name?.name === 'lang'\n        ) as any;\n        const localeExpression = b.jsxExpressionContainer(\n          b.identifier('locale')\n        );\n        if (langAttr) {\n          langAttr.value = localeExpression;\n        } else {\n          node.attributes.push(\n            b.jsxAttribute(b.jsxIdentifier('lang'), localeExpression)\n          );\n        }\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n};\n\n/**\n * Wraps the `{children}` of a Next.js App Router **layout** with\n * `IntlayerClientProvider`, deriving the locale via `getLocale()`. Safe and\n * idempotent: bails (returns the original code) for client components, when no\n * `{children}` placeholder is found, or when there is no default export.\n */\nexport const wrapLayoutWithProvider = (code: string): TransformResult => {\n  const ast = parseTsx(code);\n\n  if (isClientComponent(ast)) return { code, status: 'skipped-client' };\n  if (code.includes('IntlayerClientProvider'))\n    return { code, status: 'already' };\n\n  const funcNode = findDefaultExportFunction(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        path.replace(buildProviderElement('IntlayerClientProvider', path.node));\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, 'IntlayerClientProvider', 'next-intlayer');\n  ensureNamedImport(ast, 'getLocale', 'next-intlayer/server');\n  ensureExportFrom(ast, 'generateStaticParams', 'next-intlayer');\n  ensureAwaitedLocale(funcNode);\n  setHtmlLang(ast);\n\n  return { code: recast.print(ast).code, status: 'wrapped' };\n};\n\n/** Returns the single top-level JSX return of a function, or the JSX of an expression-bodied arrow. */\nconst findSingleJsxReturn = (\n  funcNode: any\n): { kind: 'return'; node: any } | { kind: 'arrow'; node: any } | null => {\n  if (\n    funcNode.type === 'ArrowFunctionExpression' &&\n    funcNode.body.type !== 'BlockStatement'\n  ) {\n    const body =\n      funcNode.body.type === 'JSXElement' ||\n      funcNode.body.type === 'JSXFragment'\n        ? funcNode.body\n        : null;\n    return body ? { kind: 'arrow', node: funcNode } : null;\n  }\n\n  if (funcNode.body.type !== 'BlockStatement') return null;\n\n  // Collect every JSX-returning `return` inside this function, but do not\n  // descend into nested function scopes (e.g. an inner component defined in the\n  // same file). More than one top-level JSX return is ambiguous — bail.\n  const jsxReturns: any[] = [];\n  let functionDepth = 0;\n  recast.visit(funcNode, {\n    visitFunction(path) {\n      functionDepth++;\n      if (functionDepth === 1) {\n        this.traverse(path);\n      }\n      functionDepth--;\n      return false;\n    },\n    visitReturnStatement(path) {\n      const argument = path.node.argument;\n      if (argument?.type === 'JSXElement' || argument?.type === 'JSXFragment') {\n        jsxReturns.push(path.node);\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (jsxReturns.length !== 1) return null;\n  return { kind: 'return', node: jsxReturns[0] };\n};\n\n/**\n * Wraps the returned JSX of a Next.js App Router **page** with\n * `IntlayerServerProvider`, deriving the locale via `getLocale()`. Safe and\n * idempotent: bails for client components, when the page has no single\n * top-level JSX return, or when there is no default export.\n */\nexport const wrapPageWithProvider = (code: string): TransformResult => {\n  const ast = parseTsx(code);\n\n  if (isClientComponent(ast)) return { code, status: 'skipped-client' };\n  if (code.includes('IntlayerServerProvider'))\n    return { code, status: 'already' };\n\n  const funcNode = findDefaultExportFunction(ast);\n  if (!funcNode) return { code, status: 'skipped' };\n\n  const jsxReturn = findSingleJsxReturn(funcNode);\n  if (!jsxReturn) return { code, status: 'skipped' };\n\n  if (jsxReturn.kind === 'return') {\n    jsxReturn.node.argument = buildProviderElement(\n      'IntlayerServerProvider',\n      jsxReturn.node.argument\n    );\n  } else {\n    jsxReturn.node.body = buildProviderElement(\n      'IntlayerServerProvider',\n      jsxReturn.node.body\n    );\n  }\n\n  ensureNamedImport(ast, 'IntlayerServerProvider', 'next-intlayer/server');\n  ensureNamedImport(ast, 'getLocale', 'next-intlayer/server');\n  ensureAwaitedLocale(funcNode);\n\n  return { code: recast.print(ast).code, status: 'wrapped' };\n};\n"],"mappings":"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"}

package/dist/esm/init/frameworkSetup/tanstackStart/detect.mjs

@@ -0,0 +1,28 @@
+import { exists } from "../../utils/fileSystem.mjs";
+import { join } from "node:path";
+
+//#region src/init/frameworkSetup/tanstackStart/detect.ts
+/**
+* Detects the TanStack Router routes directory, preferring `src/routes` over
+* `routes`. Returns `null` when neither exists.
+*/
+const detectTanStackRoutesDir = async (rootDir) => {
+	if (await exists(rootDir, join("src", "routes"))) return {
+		routesDir: join("src", "routes"),
+		srcDir: "src"
+	};
+	if (await exists(rootDir, "routes")) return {
+		routesDir: "routes",
+		srcDir: ""
+	};
+	return null;
+};
+/**
+* Returns true when the project depends on TanStack Start (`@tanstack/react-start`)
+* or, failing that, on `@tanstack/react-router` (file-based routing).
+*/
+const hasTanStackStartDeps = (allDeps) => Boolean(allDeps["@tanstack/react-start"] || allDeps["@tanstack/react-router"]);
+
+//#endregion
+export { detectTanStackRoutesDir, hasTanStackStartDeps };
+//# sourceMappingURL=detect.mjs.map

package/dist/esm/init/frameworkSetup/tanstackStart/detect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/detect.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { exists } from '../../utils/fileSystem';\n\n/** Location of the TanStack Router file-based routes directory. */\nexport type TanStackRoutesInfo = {\n  /** Routes directory relative to the root, e.g. `src/routes` or `routes`. */\n  routesDir: string;\n  /** `src` when the project uses a `src/` directory, otherwise `''`. */\n  srcDir: string;\n};\n\n/**\n * Detects the TanStack Router routes directory, preferring `src/routes` over\n * `routes`. Returns `null` when neither exists.\n */\nexport const detectTanStackRoutesDir = async (\n  rootDir: string\n): Promise<TanStackRoutesInfo | null> => {\n  if (await exists(rootDir, join('src', 'routes'))) {\n    return { routesDir: join('src', 'routes'), srcDir: 'src' };\n  }\n  if (await exists(rootDir, 'routes')) {\n    return { routesDir: 'routes', srcDir: '' };\n  }\n  return null;\n};\n\n/**\n * Returns true when the project depends on TanStack Start (`@tanstack/react-start`)\n * or, failing that, on `@tanstack/react-router` (file-based routing).\n */\nexport const hasTanStackStartDeps = (\n  allDeps: Record<string, string>\n): boolean =>\n  Boolean(\n    allDeps['@tanstack/react-start'] || allDeps['@tanstack/react-router']\n  );\n"],"mappings":";;;;;;;;AAeA,MAAa,0BAA0B,OACrC,YACuC;AACvC,KAAI,MAAM,OAAO,SAAS,KAAK,OAAO,SAAS,CAAC,CAC9C,QAAO;EAAE,WAAW,KAAK,OAAO,SAAS;EAAE,QAAQ;EAAO;AAE5D,KAAI,MAAM,OAAO,SAAS,SAAS,CACjC,QAAO;EAAE,WAAW;EAAU,QAAQ;EAAI;AAE5C,QAAO;;;;;;AAOT,MAAa,wBACX,YAEA,QACE,QAAQ,4BAA4B,QAAQ,0BAC7C"}

package/dist/esm/init/frameworkSetup/tanstackStart/index.mjs

@@ -0,0 +1,73 @@
+import { ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "../../utils/fileSystem.mjs";
+import { findAppFile } from "../nextAppRouter/detect.mjs";
+import { detectTanStackRoutesDir, hasTanStackStartDeps } from "./detect.mjs";
+import { getLocaleSegment, restructureRoutesIntoLocale } from "./restructure.mjs";
+import { ROOT_TEMPLATE_JS, ROOT_TEMPLATE_TS, buildLocaleRouteTemplate } from "./templates.mjs";
+import { wrapRootWithProvider } from "./transforms.mjs";
+import { join } from "node:path";
+import { colorize, colorizePath, logger, v, x } from "@intlayer/config/logger";
+import * as ANSIColors from "@intlayer/config/colors";
+
+//#region src/init/frameworkSetup/tanstackStart/index.ts
+/** Logs the outcome of the root-document provider-wrap transform. */
+const logTransformOutcome = (filePath, result) => {
+	switch (result.status) {
+		case "wrapped":
+			logger(`${v} Added Intlayer provider to ${colorizePath(filePath)}`);
+			break;
+		case "already":
+			logger(`${v} ${colorizePath(filePath)} already wraps the Intlayer provider`);
+			break;
+		case "skipped":
+			logger(`${x} Could not safely add the Intlayer provider to ${colorizePath(filePath)} — please wrap the document's {children} with <IntlayerProvider locale={locale}> manually.`, { level: "warn" });
+			break;
+	}
+};
+/** Transforms an existing file in place, writing it back only when changed. */
+const transformExistingFile = async (rootDir, filePath, transform) => {
+	const result = transform(await readFileFromRoot(rootDir, filePath));
+	if (result.status === "wrapped") await writeFileToRoot(rootDir, filePath, result.code);
+	logTransformOutcome(filePath, result);
+};
+/** Creates a file from a template only when it does not already exist. */
+const createIfMissing = async (rootDir, filePath, content, description) => {
+	if (await exists(rootDir, filePath)) return false;
+	await writeFileToRoot(rootDir, filePath, content);
+	logger(`${v} Created ${description} ${colorizePath(filePath)}`);
+	return true;
+};
+/**
+* TanStack Start adapter. Restructures the file-based routes under a `{-$locale}`
+* segment, scaffolds the locale segment route, and wraps the root document with
+* the Intlayer provider — all idempotently and without overwriting user code it
+* cannot confidently transform.
+*/
+const tanStackStartAdapter = {
+	name: "TanStack Start",
+	detect: async ({ rootDir, allDeps }) => {
+		if (!hasTanStackStartDeps(allDeps)) return false;
+		return await detectTanStackRoutesDir(rootDir) !== null;
+	},
+	setup: async ({ rootDir, useTypeScript, routingMode }) => {
+		const routesInfo = await detectTanStackRoutesDir(rootDir);
+		if (!routesInfo) return;
+		const { routesDir } = routesInfo;
+		const scriptExtension = useTypeScript ? "tsx" : "jsx";
+		const targetLocaleSegment = getLocaleSegment(routingMode);
+		logger(colorize("Setting up TanStack Start integration...", ANSIColors.CYAN));
+		const restructureResult = await restructureRoutesIntoLocale(rootDir, routesDir, targetLocaleSegment);
+		if (restructureResult.status === "moved") logger(`${v} Restructured routes under ${colorizePath(join(routesDir, targetLocaleSegment))}: ${restructureResult.movedEntries.map((entry) => colorize(entry, ANSIColors.MAGENTA)).join(", ")}`);
+		else if (restructureResult.status === "already-structured") logger(`${v} ${colorizePath(join(routesDir, restructureResult.localeSegment))} already exists, skipping restructure`);
+		const activeLocaleSegment = restructureResult.status === "already-structured" ? restructureResult.localeSegment : targetLocaleSegment;
+		const localeDir = join(routesDir, activeLocaleSegment);
+		await ensureDirectory(rootDir, localeDir);
+		await createIfMissing(rootDir, join(localeDir, `route.${scriptExtension}`), buildLocaleRouteTemplate(activeLocaleSegment), "locale route");
+		const existingRoot = await findAppFile(rootDir, routesDir, "__root");
+		if (existingRoot) await transformExistingFile(rootDir, existingRoot, wrapRootWithProvider);
+		else await createIfMissing(rootDir, join(routesDir, `__root.${scriptExtension}`), useTypeScript ? ROOT_TEMPLATE_TS : ROOT_TEMPLATE_JS, "root document");
+	}
+};
+
+//#endregion
+export { tanStackStartAdapter };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/init/frameworkSetup/tanstackStart/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/index.ts"],"sourcesContent":["import { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizePath, logger, v, x } from '@intlayer/config/logger';\nimport {\n  ensureDirectory,\n  exists,\n  readFileFromRoot,\n  writeFileToRoot,\n} from '../../utils/fileSystem';\nimport { findAppFile } from '../nextAppRouter/detect';\nimport type { FrameworkAdapter, FrameworkSetupContext } from '../types';\nimport { detectTanStackRoutesDir, hasTanStackStartDeps } from './detect';\nimport { getLocaleSegment, restructureRoutesIntoLocale } from './restructure';\nimport {\n  buildLocaleRouteTemplate,\n  ROOT_TEMPLATE_JS,\n  ROOT_TEMPLATE_TS,\n} from './templates';\nimport { type TransformResult, wrapRootWithProvider } from './transforms';\n\n/** Logs the outcome of the root-document provider-wrap transform. */\nconst logTransformOutcome = (\n  filePath: string,\n  result: TransformResult\n): void => {\n  switch (result.status) {\n    case 'wrapped':\n      logger(`${v} Added Intlayer provider to ${colorizePath(filePath)}`);\n      break;\n    case 'already':\n      logger(\n        `${v} ${colorizePath(filePath)} already wraps the Intlayer provider`\n      );\n      break;\n    case 'skipped':\n      logger(\n        `${x} Could not safely add the Intlayer provider to ${colorizePath(filePath)} — please wrap the document's {children} with <IntlayerProvider locale={locale}> manually.`,\n        { level: 'warn' }\n      );\n      break;\n  }\n};\n\n/** Transforms an existing file in place, writing it back only when changed. */\nconst transformExistingFile = async (\n  rootDir: string,\n  filePath: string,\n  transform: (code: string) => TransformResult\n): Promise<void> => {\n  const code = await readFileFromRoot(rootDir, filePath);\n  const result = transform(code);\n  if (result.status === 'wrapped') {\n    await writeFileToRoot(rootDir, filePath, result.code);\n  }\n  logTransformOutcome(filePath, result);\n};\n\n/** Creates a file from a template only when it does not already exist. */\nconst createIfMissing = async (\n  rootDir: string,\n  filePath: string,\n  content: string,\n  description: string\n): Promise<boolean> => {\n  if (await exists(rootDir, filePath)) return false;\n  await writeFileToRoot(rootDir, filePath, content);\n  logger(`${v} Created ${description} ${colorizePath(filePath)}`);\n  return true;\n};\n\n/**\n * TanStack Start adapter. Restructures the file-based routes under a `{-$locale}`\n * segment, scaffolds the locale segment route, and wraps the root document with\n * the Intlayer provider — all idempotently and without overwriting user code it\n * cannot confidently transform.\n */\nexport const tanStackStartAdapter: FrameworkAdapter = {\n  name: 'TanStack Start',\n\n  detect: async ({ rootDir, allDeps }) => {\n    if (!hasTanStackStartDeps(allDeps)) return false;\n    return (await detectTanStackRoutesDir(rootDir)) !== null;\n  },\n\n  setup: async ({\n    rootDir,\n    useTypeScript,\n    routingMode,\n  }: FrameworkSetupContext) => {\n    const routesInfo = await detectTanStackRoutesDir(rootDir);\n    if (!routesInfo) return;\n\n    const { routesDir } = routesInfo;\n    const scriptExtension = useTypeScript ? 'tsx' : 'jsx';\n\n    // `prefix-all` needs the required `$locale` segment; every other mode uses\n    // the optional `{-$locale}` segment so the default locale stays prefix-free.\n    const targetLocaleSegment = getLocaleSegment(routingMode);\n\n    logger(\n      colorize('Setting up TanStack Start integration...', ANSIColors.CYAN)\n    );\n\n    // 1. Move routable route entries under the locale segment (idempotent).\n    const restructureResult = await restructureRoutesIntoLocale(\n      rootDir,\n      routesDir,\n      targetLocaleSegment\n    );\n    if (restructureResult.status === 'moved') {\n      logger(\n        `${v} Restructured routes under ${colorizePath(join(routesDir, targetLocaleSegment))}: ${restructureResult.movedEntries\n          .map((entry) => colorize(entry, ANSIColors.MAGENTA))\n          .join(', ')}`\n      );\n    } else if (restructureResult.status === 'already-structured') {\n      logger(\n        `${v} ${colorizePath(join(routesDir, restructureResult.localeSegment))} already exists, skipping restructure`\n      );\n    }\n\n    // Scaffold the locale route for the segment actually in use: a pre-existing\n    // segment (e.g. a prefix-all `$locale` the user already set up) wins over the\n    // target, so we never create a second, conflicting locale segment.\n    const activeLocaleSegment =\n      restructureResult.status === 'already-structured'\n        ? restructureResult.localeSegment\n        : targetLocaleSegment;\n\n    const localeDir = join(routesDir, activeLocaleSegment);\n    await ensureDirectory(rootDir, localeDir);\n\n    // 2. Locale segment route (`<segment>/route.tsx`) — create when absent.\n    await createIfMissing(\n      rootDir,\n      join(localeDir, `route.${scriptExtension}`),\n      buildLocaleRouteTemplate(activeLocaleSegment),\n      'locale route'\n    );\n\n    // 3. Root document — transform an existing `__root`, else scaffold one.\n    const existingRoot = await findAppFile(rootDir, routesDir, '__root');\n    if (existingRoot) {\n      await transformExistingFile(rootDir, existingRoot, wrapRootWithProvider);\n    } else {\n      await createIfMissing(\n        rootDir,\n        join(routesDir, `__root.${scriptExtension}`),\n        useTypeScript ? ROOT_TEMPLATE_TS : ROOT_TEMPLATE_JS,\n        'root document'\n      );\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAM,uBACJ,UACA,WACS;AACT,SAAQ,OAAO,QAAf;EACE,KAAK;AACH,UAAO,GAAG,EAAE,8BAA8B,aAAa,SAAS,GAAG;AACnE;EACF,KAAK;AACH,UACE,GAAG,EAAE,GAAG,aAAa,SAAS,CAAC,sCAChC;AACD;EACF,KAAK;AACH,UACE,GAAG,EAAE,iDAAiD,aAAa,SAAS,CAAC,6FAC7E,EAAE,OAAO,QAAQ,CAClB;AACD;;;;AAKN,MAAM,wBAAwB,OAC5B,SACA,UACA,cACkB;CAElB,MAAM,SAAS,UAAU,MADN,iBAAiB,SAAS,SAAS,CACxB;AAC9B,KAAI,OAAO,WAAW,UACpB,OAAM,gBAAgB,SAAS,UAAU,OAAO,KAAK;AAEvD,qBAAoB,UAAU,OAAO;;;AAIvC,MAAM,kBAAkB,OACtB,SACA,UACA,SACA,gBACqB;AACrB,KAAI,MAAM,OAAO,SAAS,SAAS,CAAE,QAAO;AAC5C,OAAM,gBAAgB,SAAS,UAAU,QAAQ;AACjD,QAAO,GAAG,EAAE,WAAW,YAAY,GAAG,aAAa,SAAS,GAAG;AAC/D,QAAO;;;;;;;;AAST,MAAa,uBAAyC;CACpD,MAAM;CAEN,QAAQ,OAAO,EAAE,SAAS,cAAc;AACtC,MAAI,CAAC,qBAAqB,QAAQ,CAAE,QAAO;AAC3C,SAAQ,MAAM,wBAAwB,QAAQ,KAAM;;CAGtD,OAAO,OAAO,EACZ,SACA,eACA,kBAC2B;EAC3B,MAAM,aAAa,MAAM,wBAAwB,QAAQ;AACzD,MAAI,CAAC,WAAY;EAEjB,MAAM,EAAE,cAAc;EACtB,MAAM,kBAAkB,gBAAgB,QAAQ;EAIhD,MAAM,sBAAsB,iBAAiB,YAAY;AAEzD,SACE,SAAS,4CAA4C,WAAW,KAAK,CACtE;EAGD,MAAM,oBAAoB,MAAM,4BAC9B,SACA,WACA,oBACD;AACD,MAAI,kBAAkB,WAAW,QAC/B,QACE,GAAG,EAAE,6BAA6B,aAAa,KAAK,WAAW,oBAAoB,CAAC,CAAC,IAAI,kBAAkB,aACxG,KAAK,UAAU,SAAS,OAAO,WAAW,QAAQ,CAAC,CACnD,KAAK,KAAK,GACd;WACQ,kBAAkB,WAAW,qBACtC,QACE,GAAG,EAAE,GAAG,aAAa,KAAK,WAAW,kBAAkB,cAAc,CAAC,CAAC,uCACxE;EAMH,MAAM,sBACJ,kBAAkB,WAAW,uBACzB,kBAAkB,gBAClB;EAEN,MAAM,YAAY,KAAK,WAAW,oBAAoB;AACtD,QAAM,gBAAgB,SAAS,UAAU;AAGzC,QAAM,gBACJ,SACA,KAAK,WAAW,SAAS,kBAAkB,EAC3C,yBAAyB,oBAAoB,EAC7C,eACD;EAGD,MAAM,eAAe,MAAM,YAAY,SAAS,WAAW,SAAS;AACpE,MAAI,aACF,OAAM,sBAAsB,SAAS,cAAc,qBAAqB;MAExE,OAAM,gBACJ,SACA,KAAK,WAAW,UAAU,kBAAkB,EAC5C,gBAAgB,mBAAmB,kBACnC,gBACD;;CAGN"}

package/dist/esm/init/frameworkSetup/tanstackStart/restructure.mjs

@@ -0,0 +1,108 @@
+import { rewriteRelativeImports } from "../nextAppRouter/restructure.mjs";
+import { mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import fg from "fast-glob";
+
+//#region src/init/frameworkSetup/tanstackStart/restructure.ts
+/** Source file extensions whose relative imports must be rewritten after a move. */
+const SCRIPT_GLOB = "**/*.{ts,tsx,js,jsx,mjs,cjs}";
+/**
+* The optional TanStack Router locale segment directory (`{-$locale}` param),
+* used by every routing mode except `prefix-all` so the default locale stays
+* prefix-free.
+*/
+const LOCALE_SEGMENT = "{-$locale}";
+/**
+* The required TanStack Router locale segment directory (`$locale` param), used
+* by `prefix-all` routing where every URL — including the default locale — is
+* prefixed.
+*/
+const PREFIX_ALL_LOCALE_SEGMENT = "$locale";
+/**
+* Picks the locale segment directory for the project's routing mode. `prefix-all`
+* requires the mandatory `$locale` param so the default locale is also prefixed;
+* all other modes use the optional `{-$locale}` param so the default locale stays
+* prefix-free.
+*/
+const getLocaleSegment = (routingMode) => routingMode === "prefix-all" ? PREFIX_ALL_LOCALE_SEGMENT : LOCALE_SEGMENT;
+/**
+* Detects whether a top-level route entry is already a locale segment, in any of
+* the TanStack Router param forms:
+* - `{-$locale}` — optional param (prefix every locale except the default),
+* - `$locale` / `{$locale}` — required param (prefix **all** locales).
+*
+* Used to skip the restructure when the project is already locale-aware, so an
+* existing prefix-all `$locale` directory is never nested under a freshly created
+* `{-$locale}` (which would produce `{-$locale}/$locale`).
+*/
+const isLocaleSegment = (entryName) => /^(\{-?\$locale\}|\$locale)$/.test(entryName);
+/** Strips a known script extension from a file name, e.g. `index.tsx` -> `index`. */
+const stripScriptExtension = (fileName) => fileName.replace(/\.(tsx|ts|jsx|js|mjs|cjs)$/, "");
+/**
+* Routes-directory entries that must stay at the root and never be moved under
+* `{-$locale}`:
+* - `__root` (the root route document),
+* - `routeTree.gen` (generated route tree),
+* - `api` (server / API routes — these are not locale-prefixed),
+* - TanStack-ignored entries prefixed with `-` (e.g. `-components`, `-utils`),
+* - stylesheets.
+*
+* Everything else (route files and nested route folders) is moved so it becomes
+* locale-aware.
+*/
+const shouldKeepRouteAtRoot = (entryName) => {
+	if (entryName.startsWith("-")) return true;
+	if (entryName.toLowerCase().endsWith(".css")) return true;
+	const base = stripScriptExtension(entryName);
+	return new Set([
+		"__root",
+		"routeTree.gen",
+		"api"
+	]).has(base);
+};
+/**
+* Moves the routable entries of `routesDir` under a new `localeSegment` directory
+* (the optional `{-$locale}` by default, or the required `$locale` for
+* `prefix-all`) and rewrites relative imports in the moved files. Idempotent: a
+* no-op when the routes are already locale-aware in any prefix mode (see
+* {@link isLocaleSegment}), which is reported via `localeSegment`. Root-only
+* files (see {@link shouldKeepRouteAtRoot}) are left in place.
+*/
+const restructureRoutesIntoLocale = async (rootDir, routesDir, localeSegment = LOCALE_SEGMENT) => {
+	const routesDirAbs = join(rootDir, routesDir);
+	const localeDirAbs = join(routesDirAbs, localeSegment);
+	const entries = await readdir(routesDirAbs, { withFileTypes: true });
+	const existingLocaleSegment = entries.find((entry) => isLocaleSegment(entry.name));
+	if (existingLocaleSegment) return {
+		status: "already-structured",
+		localeSegment: existingLocaleSegment.name
+	};
+	const movedTopLevelNames = entries.map((entry) => entry.name).filter((name) => !shouldKeepRouteAtRoot(name));
+	if (movedTopLevelNames.length === 0) return { status: "nothing-to-move" };
+	await mkdir(localeDirAbs, { recursive: true });
+	for (const name of movedTopLevelNames) await rename(join(routesDirAbs, name), join(localeDirAbs, name));
+	const movedFiles = await fg(SCRIPT_GLOB, {
+		cwd: localeDirAbs,
+		absolute: true,
+		onlyFiles: true
+	});
+	const rewriteContext = {
+		appDirAbs: routesDirAbs,
+		localeDirAbs,
+		movedTopLevelNames
+	};
+	for (const newAbs of movedFiles) {
+		const oldAbs = join(routesDirAbs, relative(localeDirAbs, newAbs));
+		const code = await readFile(newAbs, "utf8");
+		const rewritten = rewriteRelativeImports(code, oldAbs, newAbs, rewriteContext);
+		if (rewritten !== code) await writeFile(newAbs, rewritten, "utf8");
+	}
+	return {
+		status: "moved",
+		movedEntries: movedTopLevelNames
+	};
+};
+
+//#endregion
+export { LOCALE_SEGMENT, PREFIX_ALL_LOCALE_SEGMENT, getLocaleSegment, isLocaleSegment, restructureRoutesIntoLocale, shouldKeepRouteAtRoot };
+//# sourceMappingURL=restructure.mjs.map

package/dist/esm/init/frameworkSetup/tanstackStart/restructure.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"restructure.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/restructure.ts"],"sourcesContent":["import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport fg from 'fast-glob';\nimport type { RoutingMode } from '../../utils/configManipulation';\nimport { rewriteRelativeImports } from '../nextAppRouter/restructure';\n\n/** Source file extensions whose relative imports must be rewritten after a move. */\nconst SCRIPT_GLOB = '**/*.{ts,tsx,js,jsx,mjs,cjs}';\n\n/**\n * The optional TanStack Router locale segment directory (`{-$locale}` param),\n * used by every routing mode except `prefix-all` so the default locale stays\n * prefix-free.\n */\nexport const LOCALE_SEGMENT = '{-$locale}';\n\n/**\n * The required TanStack Router locale segment directory (`$locale` param), used\n * by `prefix-all` routing where every URL — including the default locale — is\n * prefixed.\n */\nexport const PREFIX_ALL_LOCALE_SEGMENT = '$locale';\n\n/**\n * Picks the locale segment directory for the project's routing mode. `prefix-all`\n * requires the mandatory `$locale` param so the default locale is also prefixed;\n * all other modes use the optional `{-$locale}` param so the default locale stays\n * prefix-free.\n */\nexport const getLocaleSegment = (routingMode: RoutingMode): string =>\n  routingMode === 'prefix-all' ? PREFIX_ALL_LOCALE_SEGMENT : LOCALE_SEGMENT;\n\n/**\n * Detects whether a top-level route entry is already a locale segment, in any of\n * the TanStack Router param forms:\n * - `{-$locale}` — optional param (prefix every locale except the default),\n * - `$locale` / `{$locale}` — required param (prefix **all** locales).\n *\n * Used to skip the restructure when the project is already locale-aware, so an\n * existing prefix-all `$locale` directory is never nested under a freshly created\n * `{-$locale}` (which would produce `{-$locale}/$locale`).\n */\nexport const isLocaleSegment = (entryName: string): boolean =>\n  /^(\\{-?\\$locale\\}|\\$locale)$/.test(entryName);\n\n/** Strips a known script extension from a file name, e.g. `index.tsx` -> `index`. */\nconst stripScriptExtension = (fileName: string): string =>\n  fileName.replace(/\\.(tsx|ts|jsx|js|mjs|cjs)$/, '');\n\n/**\n * Routes-directory entries that must stay at the root and never be moved under\n * `{-$locale}`:\n * - `__root` (the root route document),\n * - `routeTree.gen` (generated route tree),\n * - `api` (server / API routes — these are not locale-prefixed),\n * - TanStack-ignored entries prefixed with `-` (e.g. `-components`, `-utils`),\n * - stylesheets.\n *\n * Everything else (route files and nested route folders) is moved so it becomes\n * locale-aware.\n */\nexport const shouldKeepRouteAtRoot = (entryName: string): boolean => {\n  if (entryName.startsWith('-')) return true;\n  if (entryName.toLowerCase().endsWith('.css')) return true;\n\n  const base = stripScriptExtension(entryName);\n  const keepExactBases = new Set(['__root', 'routeTree.gen', 'api']);\n  return keepExactBases.has(base);\n};\n\n/** Outcome of an attempted `{-$locale}` restructure. */\nexport type RestructureResult =\n  | { status: 'already-structured'; localeSegment: string }\n  | { status: 'nothing-to-move' }\n  | { status: 'moved'; movedEntries: string[] };\n\n/**\n * Moves the routable entries of `routesDir` under a new `localeSegment` directory\n * (the optional `{-$locale}` by default, or the required `$locale` for\n * `prefix-all`) and rewrites relative imports in the moved files. Idempotent: a\n * no-op when the routes are already locale-aware in any prefix mode (see\n * {@link isLocaleSegment}), which is reported via `localeSegment`. Root-only\n * files (see {@link shouldKeepRouteAtRoot}) are left in place.\n */\nexport const restructureRoutesIntoLocale = async (\n  rootDir: string,\n  routesDir: string,\n  localeSegment: string = LOCALE_SEGMENT\n): Promise<RestructureResult> => {\n  const routesDirAbs = join(rootDir, routesDir);\n  const localeDirAbs = join(routesDirAbs, localeSegment);\n\n  const entries = await readdir(routesDirAbs, { withFileTypes: true });\n\n  // Skip when the routes are already locale-aware in any prefix mode — a fresh\n  // `{-$locale}`, or an existing `$locale` / `{$locale}` (prefix-all) segment.\n  const existingLocaleSegment = entries.find((entry) =>\n    isLocaleSegment(entry.name)\n  );\n  if (existingLocaleSegment) {\n    return {\n      status: 'already-structured',\n      localeSegment: existingLocaleSegment.name,\n    };\n  }\n\n  const movedTopLevelNames = entries\n    .map((entry) => entry.name)\n    .filter((name) => !shouldKeepRouteAtRoot(name));\n\n  if (movedTopLevelNames.length === 0) {\n    return { status: 'nothing-to-move' };\n  }\n\n  await mkdir(localeDirAbs, { recursive: true });\n\n  for (const name of movedTopLevelNames) {\n    await rename(join(routesDirAbs, name), join(localeDirAbs, name));\n  }\n\n  const movedFiles = await fg(SCRIPT_GLOB, {\n    cwd: localeDirAbs,\n    absolute: true,\n    onlyFiles: true,\n  });\n\n  const rewriteContext = {\n    appDirAbs: routesDirAbs,\n    localeDirAbs,\n    movedTopLevelNames,\n  };\n\n  for (const newAbs of movedFiles) {\n    const relFromLocale = relative(localeDirAbs, newAbs);\n    const oldAbs = join(routesDirAbs, relFromLocale);\n    const code = await readFile(newAbs, 'utf8');\n    const rewritten = rewriteRelativeImports(\n      code,\n      oldAbs,\n      newAbs,\n      rewriteContext\n    );\n    if (rewritten !== code) {\n      await writeFile(newAbs, rewritten, 'utf8');\n    }\n  }\n\n  return { status: 'moved', movedEntries: movedTopLevelNames };\n};\n"],"mappings":";;;;;;;AAOA,MAAM,cAAc;;;;;;AAOpB,MAAa,iBAAiB;;;;;;AAO9B,MAAa,4BAA4B;;;;;;;AAQzC,MAAa,oBAAoB,gBAC/B,gBAAgB,eAAe,4BAA4B;;;;;;;;;;;AAY7D,MAAa,mBAAmB,cAC9B,8BAA8B,KAAK,UAAU;;AAG/C,MAAM,wBAAwB,aAC5B,SAAS,QAAQ,8BAA8B,GAAG;;;;;;;;;;;;;AAcpD,MAAa,yBAAyB,cAA+B;AACnE,KAAI,UAAU,WAAW,IAAI,CAAE,QAAO;AACtC,KAAI,UAAU,aAAa,CAAC,SAAS,OAAO,CAAE,QAAO;CAErD,MAAM,OAAO,qBAAqB,UAAU;AAE5C,QAAO,IADoB,IAAI;EAAC;EAAU;EAAiB;EAAM,CAC5C,CAAC,IAAI,KAAK;;;;;;;;;;AAiBjC,MAAa,8BAA8B,OACzC,SACA,WACA,gBAAwB,mBACO;CAC/B,MAAM,eAAe,KAAK,SAAS,UAAU;CAC7C,MAAM,eAAe,KAAK,cAAc,cAAc;CAEtD,MAAM,UAAU,MAAM,QAAQ,cAAc,EAAE,eAAe,MAAM,CAAC;CAIpE,MAAM,wBAAwB,QAAQ,MAAM,UAC1C,gBAAgB,MAAM,KAAK,CAC5B;AACD,KAAI,sBACF,QAAO;EACL,QAAQ;EACR,eAAe,sBAAsB;EACtC;CAGH,MAAM,qBAAqB,QACxB,KAAK,UAAU,MAAM,KAAK,CAC1B,QAAQ,SAAS,CAAC,sBAAsB,KAAK,CAAC;AAEjD,KAAI,mBAAmB,WAAW,EAChC,QAAO,EAAE,QAAQ,mBAAmB;AAGtC,OAAM,MAAM,cAAc,EAAE,WAAW,MAAM,CAAC;AAE9C,MAAK,MAAM,QAAQ,mBACjB,OAAM,OAAO,KAAK,cAAc,KAAK,EAAE,KAAK,cAAc,KAAK,CAAC;CAGlE,MAAM,aAAa,MAAM,GAAG,aAAa;EACvC,KAAK;EACL,UAAU;EACV,WAAW;EACZ,CAAC;CAEF,MAAM,iBAAiB;EACrB,WAAW;EACX;EACA;EACD;AAED,MAAK,MAAM,UAAU,YAAY;EAE/B,MAAM,SAAS,KAAK,cADE,SAAS,cAAc,OACE,CAAC;EAChD,MAAM,OAAO,MAAM,SAAS,QAAQ,OAAO;EAC3C,MAAM,YAAY,uBAChB,MACA,QACA,QACA,eACD;AACD,MAAI,cAAc,KAChB,OAAM,UAAU,QAAQ,WAAW,OAAO;;AAI9C,QAAO;EAAE,QAAQ;EAAS,cAAc;EAAoB"}