@intlayer/engine 9.5.9 → 9.5.11

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/backend/index.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizePath, logger, v, x } from '@intlayer/config/logger';\nimport {\n  exists,\n  readFileFromRoot,\n  writeFileToRoot,\n} from '../../utils/fileSystem';\nimport type { FrameworkAdapter } from '../types';\nimport {\n  type BackendTransformResult,\n  registerElysiaPlugin,\n  registerExpressMiddleware,\n  registerFastifyPlugin,\n  registerHonoMiddleware,\n  registerNestJsMiddleware,\n} from './transforms';\n\n/** Script extensions probed for a server entry file. */\nconst ENTRY_EXTENSIONS = ['ts', 'mts', 'js', 'mjs', 'cjs'] as const;\n\n/** Conventional server entry file names, most likely first. */\nconst DEFAULT_ENTRY_BASE_NAMES = [\n  'src/index',\n  'src/server',\n  'src/app',\n  'src/main',\n  'index',\n  'server',\n  'app',\n  'main',\n] as const;\n\n/**\n * Lists the candidate server entry files: the `package.json` `main` field when\n * it points at source (not a build output), then the conventional names.\n */\nconst getEntryCandidates = async (\n  rootDir: string,\n  entryBaseNames: readonly string[]\n): Promise<string[]> => {\n  const candidates: string[] = [];\n\n  try {\n    const { main } = JSON.parse(\n      await readFileFromRoot(rootDir, 'package.json')\n    );\n    const isSourceEntry =\n      typeof main === 'string' && !/^(\\.\\/)?(dist|build|out)\\//.test(main);\n    if (isSourceEntry) candidates.push(main.replace(/^\\.\\//, ''));\n  } catch {\n    // No readable package.json — rely on the conventional names.\n  }\n\n  for (const baseName of entryBaseNames) {\n    for (const extension of ENTRY_EXTENSIONS) {\n      candidates.push(`${baseName}.${extension}`);\n    }\n  }\n\n  return [...new Set(candidates)];\n};\n\n/** A server framework whose Intlayer middleware can be registered by init. */\ntype BackendIntegration = {\n  /** Human-readable framework name, used in logs. */\n  name: string;\n  /** Returns true when the project uses this framework. */\n  detect: (allDeps: Record<string, string>) => boolean;\n  /** Entry file base names to probe, in order. */\n  entryBaseNames: readonly string[];\n  /** Registers the middleware in an entry file's source. */\n  transform: (code: string) => BackendTransformResult;\n  /** How the registration reads, shown in logs and manual-setup guidance. */\n  registrationHint: string;\n  /** Guide for a manual setup. */\n  documentationUrl: string;\n};\n\n/**\n * Registers the middleware in the first candidate entry file the transform\n * recognizes. Files the transform cannot confidently edit are left untouched;\n * when none matches, guidance is logged instead.\n */\nconst registerBackendMiddleware = async (\n  rootDir: string,\n  integration: BackendIntegration\n): Promise<void> => {\n  logger(\n    colorize(`Setting up ${integration.name} integration...`, ANSIColors.CYAN)\n  );\n\n  const candidates = await getEntryCandidates(\n    rootDir,\n    integration.entryBaseNames\n  );\n\n  for (const candidate of candidates) {\n    if (!(await exists(rootDir, candidate))) continue;\n\n    const code = await readFileFromRoot(rootDir, candidate);\n\n    let result: BackendTransformResult;\n    try {\n      result = integration.transform(code);\n    } catch {\n      // Unparsable file — try the next candidate.\n      continue;\n    }\n\n    if (result.status === 'already') {\n      logger(\n        `${v} ${colorizePath(candidate)} already registers the Intlayer middleware`\n      );\n      return;\n    }\n\n    if (result.status === 'registered') {\n      await writeFileToRoot(rootDir, candidate, result.code);\n      logger(\n        `${v} Registered ${colorize(integration.registrationHint, ANSIColors.MAGENTA)} in ${colorizePath(candidate)}`\n      );\n      return;\n    }\n  }\n\n  logger(\n    `${x} Could not find where your ${integration.name} app is created — add ${colorize(integration.registrationHint, ANSIColors.MAGENTA)} manually: ${colorizePath(integration.documentationUrl)}`,\n    { level: 'warn' }\n  );\n};\n\n/** Wraps a backend integration into a framework adapter. */\nconst createBackendAdapter = (\n  integration: BackendIntegration\n): FrameworkAdapter => ({\n  name: integration.name,\n  detect: ({ allDeps }) => integration.detect(allDeps),\n  setup: ({ rootDir }) => registerBackendMiddleware(rootDir, integration),\n});\n\n/**\n * NestJS on the Express platform. Checked before Express: a Nest app is\n * created by `NestFactory`, not `express()`. Nest on Fastify is left to the\n * guide (its adapter is registered through the Fastify instance).\n */\nexport const nestJsAdapter = createBackendAdapter({\n  name: 'NestJS',\n  detect: (allDeps) =>\n    Boolean(allDeps['@nestjs/core']) && !allDeps['@nestjs/platform-fastify'],\n  entryBaseNames: ['src/main', 'main'],\n  transform: registerNestJsMiddleware,\n  registrationHint: 'app.use(intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/nest.md',\n});\n\nexport const expressAdapter = createBackendAdapter({\n  name: 'Express',\n  detect: (allDeps) => Boolean(allDeps.express),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerExpressMiddleware,\n  registrationHint: 'app.use(intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/express.md',\n});\n\nexport const fastifyAdapter = createBackendAdapter({\n  name: 'Fastify',\n  detect: (allDeps) => Boolean(allDeps.fastify),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerFastifyPlugin,\n  registrationHint: 'fastify.register(intlayer)',\n  documentationUrl: 'https://intlayer.org/doc/environment/fastify.md',\n});\n\nexport const honoAdapter = createBackendAdapter({\n  name: 'Hono',\n  detect: (allDeps) => Boolean(allDeps.hono),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerHonoMiddleware,\n  registrationHint: 'app.use(\"*\", intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/hono.md',\n});\n\nexport const elysiaAdapter = createBackendAdapter({\n  name: 'Elysia',\n  detect: (allDeps) => Boolean(allDeps.elysia),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerElysiaPlugin,\n  registrationHint: 'new Elysia().use(intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/elysia.md',\n});\n\n/** Backend adapters, in detection order. */\nexport const backendAdapters: FrameworkAdapter[] = [\n  nestJsAdapter,\n  expressAdapter,\n  fastifyAdapter,\n  honoAdapter,\n  elysiaAdapter,\n];\n"],"mappings":";;;;;;;AAkBA,MAAM,mBAAmB;CAAC;CAAM;CAAO;CAAM;CAAO;AAAK;;AAGzD,MAAM,2BAA2B;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;AAMA,MAAM,qBAAqB,OACzB,SACA,mBACsB;CACtB,MAAM,aAAuB,CAAC;CAE9B,IAAI;EACF,MAAM,EAAE,SAAS,KAAK,MACpB,MAAM,iBAAiB,SAAS,cAAc,CAChD;EAGA,IADE,OAAO,SAAS,YAAY,CAAC,6BAA6B,KAAK,IAAI,GAClD,WAAW,KAAK,KAAK,QAAQ,SAAS,EAAE,CAAC;CAC9D,QAAQ,CAER;CAEA,KAAK,MAAM,YAAY,gBACrB,KAAK,MAAM,aAAa,kBACtB,WAAW,KAAK,GAAG,SAAS,GAAG,WAAW;CAI9C,OAAO,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC;AAChC;;;;;;AAuBA,MAAM,4BAA4B,OAChC,SACA,gBACkB;CAClB,OACE,SAAS,cAAc,YAAY,KAAK,kBAAkB,WAAW,IAAI,CAC3E;CAEA,MAAM,aAAa,MAAM,mBACvB,SACA,YAAY,cACd;CAEA,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,CAAE,MAAM,OAAO,SAAS,SAAS,GAAI;EAEzC,MAAM,OAAO,MAAM,iBAAiB,SAAS,SAAS;EAEtD,IAAI;EACJ,IAAI;GACF,SAAS,YAAY,UAAU,IAAI;EACrC,QAAQ;GAEN;EACF;EAEA,IAAI,OAAO,WAAW,WAAW;GAC/B,OACE,GAAG,EAAE,GAAG,aAAa,SAAS,EAAE,2CAClC;GACA;EACF;EAEA,IAAI,OAAO,WAAW,cAAc;GAClC,MAAM,gBAAgB,SAAS,WAAW,OAAO,IAAI;GACrD,OACE,GAAG,EAAE,cAAc,SAAS,YAAY,kBAAkB,WAAW,OAAO,EAAE,MAAM,aAAa,SAAS,GAC5G;GACA;EACF;CACF;CAEA,OACE,GAAG,EAAE,6BAA6B,YAAY,KAAK,wBAAwB,SAAS,YAAY,kBAAkB,WAAW,OAAO,EAAE,aAAa,aAAa,YAAY,gBAAgB,KAC5L,EAAE,OAAO,OAAO,CAClB;AACF;;AAGA,MAAM,wBACJ,iBACsB;CACtB,MAAM,YAAY;CAClB,SAAS,EAAE,cAAc,YAAY,OAAO,OAAO;CACnD,QAAQ,EAAE,cAAc,0BAA0B,SAAS,WAAW;AACxE;;;;;;AAOA,MAAa,gBAAgB,qBAAqB;CAChD,MAAM;CACN,SAAS,YACP,QAAQ,QAAQ,eAAe,KAAK,CAAC,QAAQ;CAC/C,gBAAgB,CAAC,YAAY,MAAM;CACnC,WAAW;CACX,kBAAkB;CAClB,kBAAkB;AACpB,CAAC;AAED,MAAa,iBAAiB,qBAAqB;CACjD,MAAM;CACN,SAAS,YAAY,QAAQ,QAAQ,OAAO;CAC5C,gBAAgB;CAChB,WAAW;CACX,kBAAkB;CAClB,kBAAkB;AACpB,CAAC;AAED,MAAa,iBAAiB,qBAAqB;CACjD,MAAM;CACN,SAAS,YAAY,QAAQ,QAAQ,OAAO;CAC5C,gBAAgB;CAChB,WAAW;CACX,kBAAkB;CAClB,kBAAkB;AACpB,CAAC;AAED,MAAa,cAAc,qBAAqB;CAC9C,MAAM;CACN,SAAS,YAAY,QAAQ,QAAQ,IAAI;CACzC,gBAAgB;CAChB,WAAW;CACX,kBAAkB;CAClB,kBAAkB;AACpB,CAAC;AAED,MAAa,gBAAgB,qBAAqB;CAChD,MAAM;CACN,SAAS,YAAY,QAAQ,QAAQ,MAAM;CAC3C,gBAAgB;CAChB,WAAW;CACX,kBAAkB;CAClB,kBAAkB;AACpB,CAAC;;AAGD,MAAa,kBAAsC;CACjD;CACA;CACA;CACA;CACA;AACF"}

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

@@ -0,0 +1,216 @@
+import { babelTsParser } from "../../../utils/babelParser.mjs";
+import { ensureNamedImport, isModuleScopeBinding } from "../../utils/astImports.mjs";
+import * as recast from "recast";
+
+//#region src/init/frameworkSetup/backend/transforms.ts
+const { namedTypes: n } = recast.types;
+/** Local name the injected middleware / plugin factory is bound to. */
+const MIDDLEWARE_IDENTIFIER = "intlayer";
+/** babel-ts parser handles TypeScript *and* plain JavaScript. */
+const parseCode = (code) => recast.parse(code, { parser: babelTsParser });
+/** Parses a single statement. */
+const parseStatement = (code) => parseCode(code).program.body[0];
+/** Whether `node` is a `require("<source>")` call. */
+const isRequireOf = (node, source) => node?.type === "CallExpression" && node.callee?.type === "Identifier" && node.callee.name === "require" && node.arguments[0]?.value === source;
+/**
+* Resolves the local names a factory is bound to at module scope, from ESM
+* imports (`import express from "express"`, `import { Hono } from "hono"`) or
+* CommonJS requires (`const express = require("express")`,
+* `const { Hono } = require("hono")`).
+*/
+const findFactoryLocalNames = (ast, factory) => {
+	const localNames = [];
+	const acceptsNamed = (name) => factory.named?.includes(name) ?? false;
+	for (const statement of ast.program.body) {
+		if (statement.type === "ImportDeclaration" && statement.source.value === factory.source) for (const specifier of statement.specifiers) {
+			const isAcceptedDefault = specifier.type === "ImportDefaultSpecifier" && factory.default;
+			const isAcceptedNamed = specifier.type === "ImportSpecifier" && acceptsNamed(specifier.imported.name);
+			if (isAcceptedDefault || isAcceptedNamed) localNames.push(specifier.local.name);
+		}
+		if (statement.type !== "VariableDeclaration") continue;
+		for (const declarator of statement.declarations) {
+			if (!isRequireOf(declarator.init, factory.source)) continue;
+			if (declarator.id.type === "Identifier" && factory.default) localNames.push(declarator.id.name);
+			if (declarator.id.type === "ObjectPattern") {
+				for (const property of declarator.id.properties) if (property.key?.type === "Identifier" && property.value?.type === "Identifier" && acceptsNamed(property.key.name)) localNames.push(property.value.name);
+			}
+		}
+	}
+	return localNames;
+};
+/** Whether the module uses CommonJS (`require`) rather than ESM imports. */
+const isCommonJsModule = (ast) => !ast.program.body.some((statement) => statement.type === "ImportDeclaration" || statement.type === "ExportNamedDeclaration" || statement.type === "ExportDefaultDeclaration") && ast.program.body.some((statement) => statement.type === "VariableDeclaration" && statement.declarations.some((declarator) => declarator.init?.type === "CallExpression" && declarator.init.callee?.name === "require"));
+/**
+* Binds `intlayer` from `source`: an ESM named import, or — in a CommonJS
+* module — `const { intlayer } = require("<source>");` placed after the last
+* top-level `require`.
+*/
+const ensureMiddlewareBinding = (ast, source) => {
+	if (!isCommonJsModule(ast)) {
+		ensureNamedImport(ast, MIDDLEWARE_IDENTIFIER, source);
+		return;
+	}
+	const body = ast.program.body;
+	let insertIndex = 0;
+	body.forEach((statement, index) => {
+		if (statement.type === "VariableDeclaration" && statement.declarations.some((declarator) => declarator.init?.callee?.name === "require")) insertIndex = index + 1;
+	});
+	body.splice(insertIndex, 0, parseStatement(`const { ${MIDDLEWARE_IDENTIFIER} } = require("${source}");`));
+};
+/**
+* Finds the first `const <app> = <init>` whose initializer matches, returning
+* the app identifier and the statement path to insert after. `export const`
+* declarations resolve to the export statement.
+*/
+const findAppDeclaration = (ast, matchesInit) => {
+	let found = null;
+	recast.visit(ast, { visitVariableDeclarator(path) {
+		const { id, init } = path.node;
+		if (!found && id.type === "Identifier" && init && matchesInit(init)) {
+			let statementPath = path.parent;
+			if (statementPath.parent?.node.type === "ExportNamedDeclaration") statementPath = statementPath.parent;
+			found = {
+				appName: id.name,
+				statementPath
+			};
+			return false;
+		}
+		this.traverse(path);
+	} });
+	return found;
+};
+/** Whether `node` calls one of `calleeNames` directly (`express()`, `new Hono()`). */
+const isFactoryCall = (node, calleeNames, type) => node?.type === type && node.callee?.type === "Identifier" && calleeNames.includes(node.callee.name);
+/**
+* Shared flow of the "declare the app, then register the middleware on the
+* next line" frameworks (Express, Fastify, Hono, NestJS).
+*/
+const registerAfterAppDeclaration = (code, { middlewareSource, findDeclaration, buildRegistration }) => {
+	if (code.includes(middlewareSource)) return {
+		code,
+		status: "already"
+	};
+	const ast = parseCode(code);
+	if (isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) return {
+		code,
+		status: "skipped"
+	};
+	const declaration = findDeclaration(ast);
+	if (!declaration) return {
+		code,
+		status: "skipped"
+	};
+	declaration.statementPath.insertAfter(parseStatement(buildRegistration(declaration.appName)));
+	ensureMiddlewareBinding(ast, middlewareSource);
+	return {
+		code: recast.print(ast).code,
+		status: "registered"
+	};
+};
+/**
+* Registers `express-intlayer` right after `const app = express()`:
+* `app.use(intlayer());`.
+*/
+const registerExpressMiddleware = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "express-intlayer",
+	findDeclaration: (ast) => {
+		const factoryNames = findFactoryLocalNames(ast, {
+			source: "express",
+			default: true
+		});
+		return findAppDeclaration(ast, (init) => isFactoryCall(init, factoryNames, "CallExpression"));
+	},
+	buildRegistration: (appName) => `${appName}.use(intlayer());`
+});
+/**
+* Registers `fastify-intlayer` right after `const app = Fastify()`:
+* `app.register(intlayer);`. Not awaited, so it also works in CommonJS and
+* non-async scopes — Fastify queues plugins until `ready`/`listen`.
+*/
+const registerFastifyPlugin = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "fastify-intlayer",
+	findDeclaration: (ast) => {
+		const factoryNames = findFactoryLocalNames(ast, {
+			source: "fastify",
+			default: true,
+			named: ["fastify", "Fastify"]
+		});
+		return findAppDeclaration(ast, (init) => isFactoryCall(init, factoryNames, "CallExpression"));
+	},
+	buildRegistration: (appName) => `${appName}.register(intlayer);`
+});
+/**
+* Registers `hono-intlayer` right after `const app = new Hono()`:
+* `app.use("*", intlayer());`. A chained declaration
+* (`new Hono().get(…)`) is skipped: its routes would be registered before the
+* middleware, which Hono runs in registration order.
+*/
+const registerHonoMiddleware = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "hono-intlayer",
+	findDeclaration: (ast) => {
+		const factoryNames = findFactoryLocalNames(ast, {
+			source: "hono",
+			named: ["Hono"]
+		});
+		return findAppDeclaration(ast, (init) => isFactoryCall(init, factoryNames, "NewExpression"));
+	},
+	buildRegistration: (appName) => `${appName}.use("*", intlayer());`
+});
+/**
+* Registers `express-intlayer` on a NestJS (Express platform) app right after
+* `const app = await NestFactory.create(…)`: `app.use(intlayer());`.
+*/
+const registerNestJsMiddleware = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "express-intlayer",
+	findDeclaration: (ast) => findAppDeclaration(ast, (init) => {
+		const call = init.type === "AwaitExpression" ? init.argument : init;
+		return n.CallExpression.check(call) && n.MemberExpression.check(call.callee) && call.callee.object.name === "NestFactory" && call.callee.property.name === "create";
+	}),
+	buildRegistration: (appName) => `${appName}.use(intlayer());`
+});
+/**
+* Registers `elysia-intlayer` directly on the app constructor:
+* `new Elysia()` → `new Elysia().use(intlayer())`. Works for chained
+* declarations too, and keeps the plugin ahead of every route.
+*/
+const registerElysiaPlugin = (code) => {
+	const middlewareSource = "elysia-intlayer";
+	if (code.includes(middlewareSource)) return {
+		code,
+		status: "already"
+	};
+	const ast = parseCode(code);
+	if (isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) return {
+		code,
+		status: "skipped"
+	};
+	const factoryNames = findFactoryLocalNames(ast, {
+		source: "elysia",
+		named: ["Elysia"]
+	});
+	let registered = false;
+	recast.visit(ast, { visitNewExpression(path) {
+		if (registered) return false;
+		if (isFactoryCall(path.node, factoryNames, "NewExpression")) {
+			const withPlugin = parseStatement("__app__.use(intlayer());").expression;
+			withPlugin.callee.object = path.node;
+			path.replace(withPlugin);
+			registered = true;
+			return false;
+		}
+		this.traverse(path);
+	} });
+	if (!registered) return {
+		code,
+		status: "skipped"
+	};
+	ensureMiddlewareBinding(ast, middlewareSource);
+	return {
+		code: recast.print(ast).code,
+		status: "registered"
+	};
+};
+
+//#endregion
+export { registerElysiaPlugin, registerExpressMiddleware, registerFastifyPlugin, registerHonoMiddleware, registerNestJsMiddleware };
+//# sourceMappingURL=transforms.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/backend/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/babelParser';\nimport {\n  ensureNamedImport,\n  isModuleScopeBinding,\n} from '../../utils/astImports';\n\nconst { namedTypes: n } = recast.types;\n\n/** Local name the injected middleware / plugin factory is bound to. */\nconst MIDDLEWARE_IDENTIFIER = 'intlayer';\n\n/** babel-ts parser handles TypeScript *and* plain JavaScript. */\nconst parseCode = (code: string): any =>\n  recast.parse(code, { parser: babelTsParser });\n\n/** Parses a single statement. */\nconst parseStatement = (code: string): any => parseCode(code).program.body[0];\n\n/** Result of a backend transform. `code` is unchanged for any non-`registered` status. */\nexport type BackendTransformResult = {\n  code: string;\n  status: 'registered' | 'already' | 'skipped';\n};\n\n/** How a server framework exposes its app factory. */\ntype FactoryImport = {\n  /** Module the factory is imported from, e.g. `express`. */\n  source: string;\n  /** Accepted forms: the default export, and/or these named exports. */\n  default?: boolean;\n  named?: string[];\n};\n\n/** Whether `node` is a `require(\"<source>\")` call. */\nconst isRequireOf = (node: any, source: string): boolean =>\n  node?.type === 'CallExpression' &&\n  node.callee?.type === 'Identifier' &&\n  node.callee.name === 'require' &&\n  node.arguments[0]?.value === source;\n\n/**\n * Resolves the local names a factory is bound to at module scope, from ESM\n * imports (`import express from \"express\"`, `import { Hono } from \"hono\"`) or\n * CommonJS requires (`const express = require(\"express\")`,\n * `const { Hono } = require(\"hono\")`).\n */\nconst findFactoryLocalNames = (ast: any, factory: FactoryImport): string[] => {\n  const localNames: string[] = [];\n  const acceptsNamed = (name: string): boolean =>\n    factory.named?.includes(name) ?? false;\n\n  for (const statement of ast.program.body) {\n    if (\n      statement.type === 'ImportDeclaration' &&\n      statement.source.value === factory.source\n    ) {\n      for (const specifier of statement.specifiers) {\n        const isAcceptedDefault =\n          specifier.type === 'ImportDefaultSpecifier' && factory.default;\n        const isAcceptedNamed =\n          specifier.type === 'ImportSpecifier' &&\n          acceptsNamed(specifier.imported.name);\n        if (isAcceptedDefault || isAcceptedNamed) {\n          localNames.push(specifier.local.name);\n        }\n      }\n    }\n\n    if (statement.type !== 'VariableDeclaration') continue;\n\n    for (const declarator of statement.declarations) {\n      if (!isRequireOf(declarator.init, factory.source)) continue;\n\n      if (declarator.id.type === 'Identifier' && factory.default) {\n        localNames.push(declarator.id.name);\n      }\n      if (declarator.id.type === 'ObjectPattern') {\n        for (const property of declarator.id.properties) {\n          if (\n            property.key?.type === 'Identifier' &&\n            property.value?.type === 'Identifier' &&\n            acceptsNamed(property.key.name)\n          ) {\n            localNames.push(property.value.name);\n          }\n        }\n      }\n    }\n  }\n\n  return localNames;\n};\n\n/** Whether the module uses CommonJS (`require`) rather than ESM imports. */\nconst isCommonJsModule = (ast: any): boolean =>\n  !ast.program.body.some(\n    (statement: any) =>\n      statement.type === 'ImportDeclaration' ||\n      statement.type === 'ExportNamedDeclaration' ||\n      statement.type === 'ExportDefaultDeclaration'\n  ) &&\n  ast.program.body.some(\n    (statement: any) =>\n      statement.type === 'VariableDeclaration' &&\n      statement.declarations.some(\n        (declarator: any) =>\n          declarator.init?.type === 'CallExpression' &&\n          declarator.init.callee?.name === 'require'\n      )\n  );\n\n/**\n * Binds `intlayer` from `source`: an ESM named import, or — in a CommonJS\n * module — `const { intlayer } = require(\"<source>\");` placed after the last\n * top-level `require`.\n */\nconst ensureMiddlewareBinding = (ast: any, source: string): void => {\n  if (!isCommonJsModule(ast)) {\n    ensureNamedImport(ast, MIDDLEWARE_IDENTIFIER, source);\n    return;\n  }\n\n  const body = ast.program.body;\n  let insertIndex = 0;\n  body.forEach((statement: any, index: number) => {\n    const isRequireDeclaration =\n      statement.type === 'VariableDeclaration' &&\n      statement.declarations.some(\n        (declarator: any) => declarator.init?.callee?.name === 'require'\n      );\n    if (isRequireDeclaration) insertIndex = index + 1;\n  });\n\n  body.splice(\n    insertIndex,\n    0,\n    parseStatement(`const { ${MIDDLEWARE_IDENTIFIER} } = require(\"${source}\");`)\n  );\n};\n\n/**\n * Finds the first `const <app> = <init>` whose initializer matches, returning\n * the app identifier and the statement path to insert after. `export const`\n * declarations resolve to the export statement.\n */\nconst findAppDeclaration = (\n  ast: any,\n  matchesInit: (init: any) => boolean\n): { appName: string; statementPath: any } | null => {\n  let found: { appName: string; statementPath: any } | null = null;\n\n  recast.visit(ast, {\n    visitVariableDeclarator(path) {\n      const { id, init } = path.node as any;\n      if (!found && id.type === 'Identifier' && init && matchesInit(init)) {\n        let statementPath = path.parent;\n        if (statementPath.parent?.node.type === 'ExportNamedDeclaration') {\n          statementPath = statementPath.parent;\n        }\n        found = { appName: id.name, statementPath };\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  return found;\n};\n\n/** Whether `node` calls one of `calleeNames` directly (`express()`, `new Hono()`). */\nconst isFactoryCall = (\n  node: any,\n  calleeNames: string[],\n  type: 'CallExpression' | 'NewExpression'\n): boolean =>\n  node?.type === type &&\n  node.callee?.type === 'Identifier' &&\n  calleeNames.includes(node.callee.name);\n\n/**\n * Shared flow of the \"declare the app, then register the middleware on the\n * next line\" frameworks (Express, Fastify, Hono, NestJS).\n */\nconst registerAfterAppDeclaration = (\n  code: string,\n  {\n    middlewareSource,\n    findDeclaration,\n    buildRegistration,\n  }: {\n    middlewareSource: string;\n    findDeclaration: (ast: any) => ReturnType<typeof findAppDeclaration>;\n    buildRegistration: (appName: string) => string;\n  }\n): BackendTransformResult => {\n  if (code.includes(middlewareSource)) return { code, status: 'already' };\n\n  const ast = parseCode(code);\n  if (isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) {\n    return { code, status: 'skipped' };\n  }\n\n  const declaration = findDeclaration(ast);\n  if (!declaration) return { code, status: 'skipped' };\n\n  declaration.statementPath.insertAfter(\n    parseStatement(buildRegistration(declaration.appName))\n  );\n  ensureMiddlewareBinding(ast, middlewareSource);\n\n  return { code: recast.print(ast).code, status: 'registered' };\n};\n\n/**\n * Registers `express-intlayer` right after `const app = express()`:\n * `app.use(intlayer());`.\n */\nexport const registerExpressMiddleware = (\n  code: string\n): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'express-intlayer',\n    findDeclaration: (ast) => {\n      const factoryNames = findFactoryLocalNames(ast, {\n        source: 'express',\n        default: true,\n      });\n      return findAppDeclaration(ast, (init) =>\n        isFactoryCall(init, factoryNames, 'CallExpression')\n      );\n    },\n    buildRegistration: (appName) => `${appName}.use(intlayer());`,\n  });\n\n/**\n * Registers `fastify-intlayer` right after `const app = Fastify()`:\n * `app.register(intlayer);`. Not awaited, so it also works in CommonJS and\n * non-async scopes — Fastify queues plugins until `ready`/`listen`.\n */\nexport const registerFastifyPlugin = (code: string): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'fastify-intlayer',\n    findDeclaration: (ast) => {\n      const factoryNames = findFactoryLocalNames(ast, {\n        source: 'fastify',\n        default: true,\n        named: ['fastify', 'Fastify'],\n      });\n      return findAppDeclaration(ast, (init) =>\n        isFactoryCall(init, factoryNames, 'CallExpression')\n      );\n    },\n    buildRegistration: (appName) => `${appName}.register(intlayer);`,\n  });\n\n/**\n * Registers `hono-intlayer` right after `const app = new Hono()`:\n * `app.use(\"*\", intlayer());`. A chained declaration\n * (`new Hono().get(…)`) is skipped: its routes would be registered before the\n * middleware, which Hono runs in registration order.\n */\nexport const registerHonoMiddleware = (code: string): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'hono-intlayer',\n    findDeclaration: (ast) => {\n      const factoryNames = findFactoryLocalNames(ast, {\n        source: 'hono',\n        named: ['Hono'],\n      });\n      return findAppDeclaration(ast, (init) =>\n        isFactoryCall(init, factoryNames, 'NewExpression')\n      );\n    },\n    buildRegistration: (appName) => `${appName}.use(\"*\", intlayer());`,\n  });\n\n/**\n * Registers `express-intlayer` on a NestJS (Express platform) app right after\n * `const app = await NestFactory.create(…)`: `app.use(intlayer());`.\n */\nexport const registerNestJsMiddleware = (\n  code: string\n): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'express-intlayer',\n    findDeclaration: (ast) =>\n      findAppDeclaration(ast, (init) => {\n        const call = init.type === 'AwaitExpression' ? init.argument : init;\n        return (\n          n.CallExpression.check(call) &&\n          n.MemberExpression.check(call.callee) &&\n          (call.callee.object as any).name === 'NestFactory' &&\n          (call.callee.property as any).name === 'create'\n        );\n      }),\n    buildRegistration: (appName) => `${appName}.use(intlayer());`,\n  });\n\n/**\n * Registers `elysia-intlayer` directly on the app constructor:\n * `new Elysia()` → `new Elysia().use(intlayer())`. Works for chained\n * declarations too, and keeps the plugin ahead of every route.\n */\nexport const registerElysiaPlugin = (code: string): BackendTransformResult => {\n  const middlewareSource = 'elysia-intlayer';\n  if (code.includes(middlewareSource)) return { code, status: 'already' };\n\n  const ast = parseCode(code);\n  if (isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) {\n    return { code, status: 'skipped' };\n  }\n\n  const factoryNames = findFactoryLocalNames(ast, {\n    source: 'elysia',\n    named: ['Elysia'],\n  });\n\n  let registered = false;\n  recast.visit(ast, {\n    visitNewExpression(path) {\n      if (registered) return false;\n      if (isFactoryCall(path.node, factoryNames, 'NewExpression')) {\n        const withPlugin = parseStatement(\n          '__app__.use(intlayer());'\n        ).expression;\n        withPlugin.callee.object = path.node;\n        path.replace(withPlugin);\n        registered = true;\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (!registered) return { code, status: 'skipped' };\n\n  ensureMiddlewareBinding(ast, middlewareSource);\n\n  return { code: recast.print(ast).code, status: 'registered' };\n};\n"],"mappings":"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"}

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

@@ -1,13 +1,19 @@
+import { backendAdapters } from "./backend/index.mjs";
 import { nextAppRouterAdapter } from "./nextAppRouter/index.mjs";
 import { tanStackStartAdapter } from "./tanstackStart/index.mjs";
 
 //#region src/init/frameworkSetup/index.ts
 /**
 * Registered framework adapters, tried in order. The first one whose `detect`
-* returns true handles the project. Add new adapters (Nuxt, Vite + React, …)
-* here as they are implemented.
+* returns true handles the project. Frontend adapters come first, so an app
+* with its own server keeps its frontend scaffolding. Add new adapters (Nuxt,
+* Vite + React, …) here as they are implemented.
 */
-const adapters = [nextAppRouterAdapter, tanStackStartAdapter];
+const adapters = [
+	nextAppRouterAdapter,
+	tanStackStartAdapter,
+	...backendAdapters
+];
 /**
 * Runs framework-specific scaffolding (middleware/proxy, providers in
 * layout/page, example content) for the first adapter that matches the project.

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/init/frameworkSetup/index.ts"],"sourcesContent":["import { nextAppRouterAdapter } from './nextAppRouter';\nimport { tanStackStartAdapter } from './tanstackStart';\nimport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\nexport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\n/**\n * Registered framework adapters, tried in order. The first one whose `detect`\n * returns true handles the project. Add new adapters (Nuxt, Vite + React, …)\n * here as they are implemented.\n */\nconst adapters: FrameworkAdapter[] = [\n  nextAppRouterAdapter,\n  tanStackStartAdapter,\n];\n\n/**\n * Runs framework-specific scaffolding (middleware/proxy, providers in\n * layout/page, example content) for the first adapter that matches the project.\n * No-ops when no adapter recognizes the project. Each adapter is idempotent and\n * non-destructive, so this is safe to run on existing applications.\n */\nexport const setupFramework = async (\n  context: FrameworkSetupContext\n): Promise<void> => {\n  for (const adapter of adapters) {\n    if (await adapter.detect(context)) {\n      await adapter.setup(context);\n      return;\n    }\n  }\n};\n"],"mappings":";;;;;;;;;AAWA,MAAM,WAA+B,CACnC,sBACA,oBACF;;;;;;;AAQA,MAAa,iBAAiB,OAC5B,YACkB;CAClB,KAAK,MAAM,WAAW,UACpB,IAAI,MAAM,QAAQ,OAAO,OAAO,GAAG;EACjC,MAAM,QAAQ,MAAM,OAAO;EAC3B;CACF;AAEJ"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/init/frameworkSetup/index.ts"],"sourcesContent":["import { backendAdapters } from './backend';\nimport { nextAppRouterAdapter } from './nextAppRouter';\nimport { tanStackStartAdapter } from './tanstackStart';\nimport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\nexport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\n/**\n * Registered framework adapters, tried in order. The first one whose `detect`\n * returns true handles the project. Frontend adapters come first, so an app\n * with its own server keeps its frontend scaffolding. Add new adapters (Nuxt,\n * Vite + React, …) here as they are implemented.\n */\nconst adapters: FrameworkAdapter[] = [\n  nextAppRouterAdapter,\n  tanStackStartAdapter,\n  ...backendAdapters,\n];\n\n/**\n * Runs framework-specific scaffolding (middleware/proxy, providers in\n * layout/page, example content) for the first adapter that matches the project.\n * No-ops when no adapter recognizes the project. Each adapter is idempotent and\n * non-destructive, so this is safe to run on existing applications.\n */\nexport const setupFramework = async (\n  context: FrameworkSetupContext\n): Promise<void> => {\n  for (const adapter of adapters) {\n    if (await adapter.detect(context)) {\n      await adapter.setup(context);\n      return;\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;AAaA,MAAM,WAA+B;CACnC;CACA;CACA,GAAG;AACL;;;;;;;AAQA,MAAa,iBAAiB,OAC5B,YACkB;CAClB,KAAK,MAAM,WAAW,UACpB,IAAI,MAAM,QAAQ,OAAO,OAAO,GAAG;EACjC,MAAM,QAAQ,MAAM,OAAO;EAC3B;CACF;AAEJ"}

package/dist/esm/init/frameworkSetup/localeRouting.mjs

@@ -0,0 +1,12 @@
+//#region src/init/frameworkSetup/localeRouting.ts
+/**
+* Whether the locale is carried by a URL path segment (`/fr/about`), which the
+* framework router must declare (`[locale]`, `{-$locale}`, `$locale`…). Only the
+* prefix routing modes do, and only while the proxy is enabled: `no-prefix` and
+* `search-params` resolve the locale from storage/headers/query instead.
+*/
+const usesLocalePathSegment = ({ routingMode, enableProxy }) => enableProxy && (routingMode === "prefix-all" || routingMode === "prefix-no-default");
+
+//#endregion
+export { usesLocalePathSegment };
+//# sourceMappingURL=localeRouting.mjs.map

package/dist/esm/init/frameworkSetup/localeRouting.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeRouting.mjs","names":[],"sources":["../../../../src/init/frameworkSetup/localeRouting.ts"],"sourcesContent":["import type { FrameworkSetupContext } from './types';\n\n/**\n * Whether the locale is carried by a URL path segment (`/fr/about`), which the\n * framework router must declare (`[locale]`, `{-$locale}`, `$locale`…). Only the\n * prefix routing modes do, and only while the proxy is enabled: `no-prefix` and\n * `search-params` resolve the locale from storage/headers/query instead.\n */\nexport const usesLocalePathSegment = ({\n  routingMode,\n  enableProxy,\n}: Pick<FrameworkSetupContext, 'routingMode' | 'enableProxy'>): boolean =>\n  enableProxy &&\n  (routingMode === 'prefix-all' || routingMode === 'prefix-no-default');\n"],"mappings":";;;;;;;AAQA,MAAa,yBAAyB,EACpC,aACA,kBAEA,gBACC,gBAAgB,gBAAgB,gBAAgB"}

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

@@ -1,12 +1,14 @@
 import { ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "../../utils/fileSystem.mjs";
+import { usesLocalePathSegment } from "../localeRouting.mjs";
 import { isVersionAtLeast } from "../../utils/version.mjs";
 import { detectNextAppDir, findAppFile } from "./detect.mjs";
-import { restructureAppIntoLocale } from "./restructure.mjs";
-import { 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 } from "./templates.mjs";
+import { isLocaleSegment, restructureAppIntoLocale } from "./restructure.mjs";
+import { 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, UNPREFIXED_PAGE_TEMPLATE, UNPREFIXED_ROOT_LAYOUT_TEMPLATE_JS, UNPREFIXED_ROOT_LAYOUT_TEMPLATE_TS } from "./templates.mjs";
 import { wrapLayoutWithProvider } from "./transforms.mjs";
 import { join } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colorize, colorizePath, logger, v, x } from "@intlayer/config/logger";
+import { readdir } from "node:fs/promises";
 
 //#region src/init/frameworkSetup/nextAppRouter/index.ts
 /**
@@ -61,11 +63,29 @@ const createIfMissing = async (rootDir, filePath, content, description) => {
 	return true;
 };
 /**
-* Next.js App Router adapter. Scaffolds the locale proxy/middleware, restructures
-* the app into a `[locale]` segment, and wraps the layout with the unified
-* Intlayer provider — all idempotently and without overwriting recognizable
-* user code. Pages are never wrapped: `IntlayerProvider` in the locale layout
-* covers them.
+* Wires an app whose URLs carry no locale segment (`no-prefix`,
+* `search-params`, or no proxy): routes stay at the app root and the root
+* layout provides the locale resolved by `getLocale()`. An app already nested
+* under a locale segment is left untouched, with guidance.
+*/
+const setupUnprefixedApp = async (rootDir, appDir, useTypeScript) => {
+	const scriptExtension = useTypeScript ? "tsx" : "jsx";
+	const existingLocaleSegment = (await readdir(join(rootDir, appDir))).find(isLocaleSegment);
+	if (existingLocaleSegment) {
+		logger(`${x} Routes live under ${colorizePath(join(appDir, existingLocaleSegment))} but the chosen routing has no locale in the URL — move them back to ${colorizePath(appDir)} manually.`, { level: "warn" });
+		return;
+	}
+	const existingLayout = await findAppFile(rootDir, appDir, "layout");
+	if (existingLayout) await transformExistingFile(rootDir, existingLayout, (code) => wrapLayoutWithProvider(code, { exportStaticParams: false }));
+	else await createIfMissing(rootDir, join(appDir, `layout.${scriptExtension}`), useTypeScript ? UNPREFIXED_ROOT_LAYOUT_TEMPLATE_TS : UNPREFIXED_ROOT_LAYOUT_TEMPLATE_JS, "root layout");
+	if (!await findAppFile(rootDir, appDir, "page")) await createIfMissing(rootDir, join(appDir, `page.${scriptExtension}`), UNPREFIXED_PAGE_TEMPLATE, "page");
+};
+/**
+* Next.js App Router adapter. Scaffolds the locale proxy/middleware (when the
+* proxy is enabled), restructures the app into a `[locale]` segment (prefix
+* routing modes only), and wraps the layout with the unified Intlayer provider
+* — all idempotently and without overwriting recognizable user code. Pages are
+* never wrapped: `IntlayerProvider` in the layout covers them.
 */
 const nextAppRouterAdapter = {
 	name: "Next.js App Router",
@@ -73,14 +93,21 @@ const nextAppRouterAdapter = {
 		if (!allDeps.next) return false;
 		return await detectNextAppDir(rootDir) !== null;
 	},
-	setup: async ({ rootDir, allDeps, useTypeScript }) => {
+	setup: async ({ rootDir, allDeps, useTypeScript, routingMode, enableProxy }) => {
 		const appDirInfo = await detectNextAppDir(rootDir);
 		if (!appDirInfo) return;
 		const { appDir, srcDir } = appDirInfo;
 		const isNext16 = isVersionAtLeast(allDeps.next, 16);
 		const scriptExtension = useTypeScript ? "tsx" : "jsx";
 		logger(colorize("Setting up Next.js App Router integration...", ANSIColors.CYAN));
-		await ensureProxyOrMiddleware(rootDir, srcDir, isNext16);
+		if (enableProxy) await ensureProxyOrMiddleware(rootDir, srcDir, isNext16);
+		if (!usesLocalePathSegment({
+			routingMode,
+			enableProxy
+		})) {
+			await setupUnprefixedApp(rootDir, appDir, useTypeScript);
+			return;
+		}
 		const restructureResult = await restructureAppIntoLocale(rootDir, appDir);
 		if (restructureResult.status === "moved") logger(`${v} Restructured app routes under ${colorizePath(join(appDir, "[locale]"))}: ${restructureResult.movedEntries.map((entry) => colorize(entry, ANSIColors.MAGENTA)).join(", ")}`);
 		else if (restructureResult.status === "already-structured") logger(`${v} ${colorizePath(join(appDir, restructureResult.localeSegment))} already exists, skipping restructure`);

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/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 type { FrameworkAdapter, FrameworkSetupContext } from '../types';\nimport { detectNextAppDir, findAppFile, isVersionAtLeast } from './detect';\nimport { restructureAppIntoLocale } from './restructure';\nimport {\n  LOCALE_LAYOUT_TEMPLATE_JS,\n  LOCALE_LAYOUT_TEMPLATE_TS,\n  LOCALE_PAGE_TEMPLATE_JS,\n  LOCALE_PAGE_TEMPLATE_TS,\n  MIDDLEWARE_TEMPLATE,\n  PROXY_TEMPLATE,\n  ROOT_LAYOUT_TEMPLATE_JS,\n  ROOT_LAYOUT_TEMPLATE_TS,\n} from './templates';\nimport { type TransformResult, wrapLayoutWithProvider } from './transforms';\n\n/**\n * Creates the locale-detection proxy (Next >= 16) or middleware (Next < 16),\n * but only when neither already exists, so a user's custom file is never\n * touched. Placed next to the app directory's parent (`src/` when present).\n */\nconst ensureProxyOrMiddleware = async (\n  rootDir: string,\n  srcDir: string,\n  isNext16: boolean\n): Promise<void> => {\n  const baseDir = srcDir || '.';\n  const proxyCandidates = [\n    'proxy.ts',\n    'proxy.js',\n    'middleware.ts',\n    'middleware.js',\n  ];\n\n  for (const candidate of proxyCandidates) {\n    if (await exists(rootDir, join(baseDir, candidate))) {\n      logger(\n        `${v} ${colorizePath(join(baseDir, candidate))} already exists, leaving it untouched`\n      );\n      return;\n    }\n  }\n\n  const fileName = isNext16 ? 'proxy.ts' : 'middleware.ts';\n  const content = isNext16 ? PROXY_TEMPLATE : MIDDLEWARE_TEMPLATE;\n  const targetPath = join(baseDir, fileName);\n\n  if (srcDir) await ensureDirectory(rootDir, srcDir);\n  await writeFileToRoot(rootDir, targetPath, content);\n  logger(`${v} Created ${colorizePath(targetPath)} for locale detection`);\n};\n\n/** Logs the outcome of a layout 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-client':\n      logger(\n        `${x} ${colorizePath(filePath)} is a client component — add the Intlayer provider manually.`,\n        { level: 'warn' }\n      );\n      break;\n    case 'skipped':\n      logger(\n        `${x} Could not safely add the Intlayer provider to ${colorizePath(filePath)} — please wire it 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 * Next.js App Router adapter. Scaffolds the locale proxy/middleware, restructures\n * the app into a `[locale]` segment, and wraps the layout with the unified\n * Intlayer provider — all idempotently and without overwriting recognizable\n * user code. Pages are never wrapped: `IntlayerProvider` in the locale layout\n * covers them.\n */\nexport const nextAppRouterAdapter: FrameworkAdapter = {\n  name: 'Next.js App Router',\n\n  detect: async ({ rootDir, allDeps }) => {\n    if (!allDeps.next) return false;\n    return (await detectNextAppDir(rootDir)) !== null;\n  },\n\n  setup: async ({ rootDir, allDeps, useTypeScript }: FrameworkSetupContext) => {\n    const appDirInfo = await detectNextAppDir(rootDir);\n    if (!appDirInfo) return;\n\n    const { appDir, srcDir } = appDirInfo;\n    const isNext16 = isVersionAtLeast(allDeps.next, 16);\n    const scriptExtension = useTypeScript ? 'tsx' : 'jsx';\n\n    logger(\n      colorize('Setting up Next.js App Router integration...', ANSIColors.CYAN)\n    );\n\n    // 1. Locale detection proxy / middleware (create only when absent).\n    await ensureProxyOrMiddleware(rootDir, srcDir, isNext16);\n\n    // 2. Move routable files under a `[locale]` segment (idempotent).\n    const restructureResult = await restructureAppIntoLocale(rootDir, appDir);\n    if (restructureResult.status === 'moved') {\n      logger(\n        `${v} Restructured app routes under ${colorizePath(join(appDir, '[locale]'))}: ${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(appDir, restructureResult.localeSegment))} already exists, skipping restructure`\n      );\n    }\n\n    // When the app already uses a different locale-prefix scheme (e.g. an\n    // `[...locale]` / `[[...locale]]` catch-all), respect the user's routing:\n    // don't scaffold a second, conflicting `[locale]` segment.\n    if (\n      restructureResult.status === 'already-structured' &&\n      restructureResult.localeSegment !== '[locale]'\n    ) {\n      logger(\n        `${v} Detected existing locale routing (${colorize(restructureResult.localeSegment, ANSIColors.MAGENTA)}), skipping locale layout/page scaffold`\n      );\n      return;\n    }\n\n    const localeDir = join(appDir, '[locale]');\n    await ensureDirectory(rootDir, localeDir);\n\n    // 3. Minimal pass-through root layout (the `[locale]` layout owns `<html>`).\n    await createIfMissing(\n      rootDir,\n      join(appDir, `layout.${scriptExtension}`),\n      useTypeScript ? ROOT_LAYOUT_TEMPLATE_TS : ROOT_LAYOUT_TEMPLATE_JS,\n      'root layout'\n    );\n\n    // 4. Locale layout — transform an existing one, else scaffold from template.\n    const existingLayout = await findAppFile(rootDir, localeDir, 'layout');\n    if (existingLayout) {\n      await transformExistingFile(\n        rootDir,\n        existingLayout,\n        wrapLayoutWithProvider\n      );\n    } else {\n      await createIfMissing(\n        rootDir,\n        join(localeDir, `layout.${scriptExtension}`),\n        useTypeScript ? LOCALE_LAYOUT_TEMPLATE_TS : LOCALE_LAYOUT_TEMPLATE_JS,\n        'locale layout'\n      );\n    }\n\n    // 5. Locale page — only scaffolded when absent. An existing page needs no\n    // transform: the locale layout's `IntlayerProvider` already covers it.\n    const existingPage = await findAppFile(rootDir, localeDir, 'page');\n    if (!existingPage) {\n      await createIfMissing(\n        rootDir,\n        join(localeDir, `page.${scriptExtension}`),\n        useTypeScript ? LOCALE_PAGE_TEMPLATE_TS : LOCALE_PAGE_TEMPLATE_JS,\n        'locale page'\n      );\n    }\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/index.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises';\nimport { 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 { usesLocalePathSegment } from '../localeRouting';\nimport type { FrameworkAdapter, FrameworkSetupContext } from '../types';\nimport { detectNextAppDir, findAppFile, isVersionAtLeast } from './detect';\nimport { isLocaleSegment, restructureAppIntoLocale } from './restructure';\nimport {\n  LOCALE_LAYOUT_TEMPLATE_JS,\n  LOCALE_LAYOUT_TEMPLATE_TS,\n  LOCALE_PAGE_TEMPLATE_JS,\n  LOCALE_PAGE_TEMPLATE_TS,\n  MIDDLEWARE_TEMPLATE,\n  PROXY_TEMPLATE,\n  ROOT_LAYOUT_TEMPLATE_JS,\n  ROOT_LAYOUT_TEMPLATE_TS,\n  UNPREFIXED_PAGE_TEMPLATE,\n  UNPREFIXED_ROOT_LAYOUT_TEMPLATE_JS,\n  UNPREFIXED_ROOT_LAYOUT_TEMPLATE_TS,\n} from './templates';\nimport { type TransformResult, wrapLayoutWithProvider } from './transforms';\n\n/**\n * Creates the locale-detection proxy (Next >= 16) or middleware (Next < 16),\n * but only when neither already exists, so a user's custom file is never\n * touched. Placed next to the app directory's parent (`src/` when present).\n */\nconst ensureProxyOrMiddleware = async (\n  rootDir: string,\n  srcDir: string,\n  isNext16: boolean\n): Promise<void> => {\n  const baseDir = srcDir || '.';\n  const proxyCandidates = [\n    'proxy.ts',\n    'proxy.js',\n    'middleware.ts',\n    'middleware.js',\n  ];\n\n  for (const candidate of proxyCandidates) {\n    if (await exists(rootDir, join(baseDir, candidate))) {\n      logger(\n        `${v} ${colorizePath(join(baseDir, candidate))} already exists, leaving it untouched`\n      );\n      return;\n    }\n  }\n\n  const fileName = isNext16 ? 'proxy.ts' : 'middleware.ts';\n  const content = isNext16 ? PROXY_TEMPLATE : MIDDLEWARE_TEMPLATE;\n  const targetPath = join(baseDir, fileName);\n\n  if (srcDir) await ensureDirectory(rootDir, srcDir);\n  await writeFileToRoot(rootDir, targetPath, content);\n  logger(`${v} Created ${colorizePath(targetPath)} for locale detection`);\n};\n\n/** Logs the outcome of a layout 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-client':\n      logger(\n        `${x} ${colorizePath(filePath)} is a client component — add the Intlayer provider manually.`,\n        { level: 'warn' }\n      );\n      break;\n    case 'skipped':\n      logger(\n        `${x} Could not safely add the Intlayer provider to ${colorizePath(filePath)} — please wire it 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 * Wires an app whose URLs carry no locale segment (`no-prefix`,\n * `search-params`, or no proxy): routes stay at the app root and the root\n * layout provides the locale resolved by `getLocale()`. An app already nested\n * under a locale segment is left untouched, with guidance.\n */\nconst setupUnprefixedApp = async (\n  rootDir: string,\n  appDir: string,\n  useTypeScript: boolean\n): Promise<void> => {\n  const scriptExtension = useTypeScript ? 'tsx' : 'jsx';\n\n  const entries = await readdir(join(rootDir, appDir));\n  const existingLocaleSegment = entries.find(isLocaleSegment);\n  if (existingLocaleSegment) {\n    logger(\n      `${x} Routes live under ${colorizePath(join(appDir, existingLocaleSegment))} but the chosen routing has no locale in the URL — move them back to ${colorizePath(appDir)} manually.`,\n      { level: 'warn' }\n    );\n    return;\n  }\n\n  const existingLayout = await findAppFile(rootDir, appDir, 'layout');\n  if (existingLayout) {\n    await transformExistingFile(rootDir, existingLayout, (code) =>\n      wrapLayoutWithProvider(code, { exportStaticParams: false })\n    );\n  } else {\n    await createIfMissing(\n      rootDir,\n      join(appDir, `layout.${scriptExtension}`),\n      useTypeScript\n        ? UNPREFIXED_ROOT_LAYOUT_TEMPLATE_TS\n        : UNPREFIXED_ROOT_LAYOUT_TEMPLATE_JS,\n      'root layout'\n    );\n  }\n\n  if (!(await findAppFile(rootDir, appDir, 'page'))) {\n    await createIfMissing(\n      rootDir,\n      join(appDir, `page.${scriptExtension}`),\n      UNPREFIXED_PAGE_TEMPLATE,\n      'page'\n    );\n  }\n};\n\n/**\n * Next.js App Router adapter. Scaffolds the locale proxy/middleware (when the\n * proxy is enabled), restructures the app into a `[locale]` segment (prefix\n * routing modes only), and wraps the layout with the unified Intlayer provider\n * — all idempotently and without overwriting recognizable user code. Pages are\n * never wrapped: `IntlayerProvider` in the layout covers them.\n */\nexport const nextAppRouterAdapter: FrameworkAdapter = {\n  name: 'Next.js App Router',\n\n  detect: async ({ rootDir, allDeps }) => {\n    if (!allDeps.next) return false;\n    return (await detectNextAppDir(rootDir)) !== null;\n  },\n\n  setup: async ({\n    rootDir,\n    allDeps,\n    useTypeScript,\n    routingMode,\n    enableProxy,\n  }: FrameworkSetupContext) => {\n    const appDirInfo = await detectNextAppDir(rootDir);\n    if (!appDirInfo) return;\n\n    const { appDir, srcDir } = appDirInfo;\n    const isNext16 = isVersionAtLeast(allDeps.next, 16);\n    const scriptExtension = useTypeScript ? 'tsx' : 'jsx';\n\n    logger(\n      colorize('Setting up Next.js App Router integration...', ANSIColors.CYAN)\n    );\n\n    // 1. Locale detection proxy / middleware (create only when absent).\n    if (enableProxy) {\n      await ensureProxyOrMiddleware(rootDir, srcDir, isNext16);\n    }\n\n    // Without a locale path segment, routes stay where they are.\n    if (!usesLocalePathSegment({ routingMode, enableProxy })) {\n      await setupUnprefixedApp(rootDir, appDir, useTypeScript);\n      return;\n    }\n\n    // 2. Move routable files under a `[locale]` segment (idempotent).\n    const restructureResult = await restructureAppIntoLocale(rootDir, appDir);\n    if (restructureResult.status === 'moved') {\n      logger(\n        `${v} Restructured app routes under ${colorizePath(join(appDir, '[locale]'))}: ${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(appDir, restructureResult.localeSegment))} already exists, skipping restructure`\n      );\n    }\n\n    // When the app already uses a different locale-prefix scheme (e.g. an\n    // `[...locale]` / `[[...locale]]` catch-all), respect the user's routing:\n    // don't scaffold a second, conflicting `[locale]` segment.\n    if (\n      restructureResult.status === 'already-structured' &&\n      restructureResult.localeSegment !== '[locale]'\n    ) {\n      logger(\n        `${v} Detected existing locale routing (${colorize(restructureResult.localeSegment, ANSIColors.MAGENTA)}), skipping locale layout/page scaffold`\n      );\n      return;\n    }\n\n    const localeDir = join(appDir, '[locale]');\n    await ensureDirectory(rootDir, localeDir);\n\n    // 3. Minimal pass-through root layout (the `[locale]` layout owns `<html>`).\n    await createIfMissing(\n      rootDir,\n      join(appDir, `layout.${scriptExtension}`),\n      useTypeScript ? ROOT_LAYOUT_TEMPLATE_TS : ROOT_LAYOUT_TEMPLATE_JS,\n      'root layout'\n    );\n\n    // 4. Locale layout — transform an existing one, else scaffold from template.\n    const existingLayout = await findAppFile(rootDir, localeDir, 'layout');\n    if (existingLayout) {\n      await transformExistingFile(\n        rootDir,\n        existingLayout,\n        wrapLayoutWithProvider\n      );\n    } else {\n      await createIfMissing(\n        rootDir,\n        join(localeDir, `layout.${scriptExtension}`),\n        useTypeScript ? LOCALE_LAYOUT_TEMPLATE_TS : LOCALE_LAYOUT_TEMPLATE_JS,\n        'locale layout'\n      );\n    }\n\n    // 5. Locale page — only scaffolded when absent. An existing page needs no\n    // transform: the locale layout's `IntlayerProvider` already covers it.\n    const existingPage = await findAppFile(rootDir, localeDir, 'page');\n    if (!existingPage) {\n      await createIfMissing(\n        rootDir,\n        join(localeDir, `page.${scriptExtension}`),\n        useTypeScript ? LOCALE_PAGE_TEMPLATE_TS : LOCALE_PAGE_TEMPLATE_JS,\n        'locale page'\n      );\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkCA,MAAM,0BAA0B,OAC9B,SACA,QACA,aACkB;CAClB,MAAM,UAAU,UAAU;CAQ1B,KAAK,MAAM,aAAa;EANtB;EACA;EACA;EACA;CAGoC,GACpC,IAAI,MAAM,OAAO,SAAS,KAAK,SAAS,SAAS,CAAC,GAAG;EACnD,OACE,GAAG,EAAE,GAAG,aAAa,KAAK,SAAS,SAAS,CAAC,EAAE,sCACjD;EACA;CACF;CAGF,MAAM,WAAW,WAAW,aAAa;CACzC,MAAM,UAAU,WAAW,iBAAiB;CAC5C,MAAM,aAAa,KAAK,SAAS,QAAQ;CAEzC,IAAI,QAAQ,MAAM,gBAAgB,SAAS,MAAM;CACjD,MAAM,gBAAgB,SAAS,YAAY,OAAO;CAClD,OAAO,GAAG,EAAE,WAAW,aAAa,UAAU,EAAE,sBAAsB;AACxE;;AAGA,MAAM,uBACJ,UACA,WACS;CACT,QAAQ,OAAO,QAAf;EACE,KAAK;GACH,OAAO,GAAG,EAAE,8BAA8B,aAAa,QAAQ,GAAG;GAClE;EACF,KAAK;GACH,OACE,GAAG,EAAE,GAAG,aAAa,QAAQ,EAAE,qCACjC;GACA;EACF,KAAK;GACH,OACE,GAAG,EAAE,GAAG,aAAa,QAAQ,EAAE,+DAC/B,EAAE,OAAO,OAAO,CAClB;GACA;EACF,KAAK,WACH,OACE,GAAG,EAAE,iDAAiD,aAAa,QAAQ,EAAE,8BAC7E,EAAE,OAAO,OAAO,CAClB;CAEJ;AACF;;AAGA,MAAM,wBAAwB,OAC5B,SACA,UACA,cACkB;CAElB,MAAM,SAAS,UAAU,MADN,iBAAiB,SAAS,QAAQ,CACxB;CAC7B,IAAI,OAAO,WAAW,WACpB,MAAM,gBAAgB,SAAS,UAAU,OAAO,IAAI;CAEtD,oBAAoB,UAAU,MAAM;AACtC;;AAGA,MAAM,kBAAkB,OACtB,SACA,UACA,SACA,gBACqB;CACrB,IAAI,MAAM,OAAO,SAAS,QAAQ,GAAG,OAAO;CAC5C,MAAM,gBAAgB,SAAS,UAAU,OAAO;CAChD,OAAO,GAAG,EAAE,WAAW,YAAY,GAAG,aAAa,QAAQ,GAAG;CAC9D,OAAO;AACT;;;;;;;AAQA,MAAM,qBAAqB,OACzB,SACA,QACA,kBACkB;CAClB,MAAM,kBAAkB,gBAAgB,QAAQ;CAGhD,MAAM,yBAAwB,MADR,QAAQ,KAAK,SAAS,MAAM,CAAC,EACd,CAAC,KAAK,eAAe;CAC1D,IAAI,uBAAuB;EACzB,OACE,GAAG,EAAE,qBAAqB,aAAa,KAAK,QAAQ,qBAAqB,CAAC,EAAE,uEAAuE,aAAa,MAAM,EAAE,aACxK,EAAE,OAAO,OAAO,CAClB;EACA;CACF;CAEA,MAAM,iBAAiB,MAAM,YAAY,SAAS,QAAQ,QAAQ;CAClE,IAAI,gBACF,MAAM,sBAAsB,SAAS,iBAAiB,SACpD,uBAAuB,MAAM,EAAE,oBAAoB,MAAM,CAAC,CAC5D;MAEA,MAAM,gBACJ,SACA,KAAK,QAAQ,UAAU,iBAAiB,GACxC,gBACI,qCACA,oCACJ,aACF;CAGF,IAAI,CAAE,MAAM,YAAY,SAAS,QAAQ,MAAM,GAC7C,MAAM,gBACJ,SACA,KAAK,QAAQ,QAAQ,iBAAiB,GACtC,0BACA,MACF;AAEJ;;;;;;;;AASA,MAAa,uBAAyC;CACpD,MAAM;CAEN,QAAQ,OAAO,EAAE,SAAS,cAAc;EACtC,IAAI,CAAC,QAAQ,MAAM,OAAO;EAC1B,OAAQ,MAAM,iBAAiB,OAAO,MAAO;CAC/C;CAEA,OAAO,OAAO,EACZ,SACA,SACA,eACA,aACA,kBAC2B;EAC3B,MAAM,aAAa,MAAM,iBAAiB,OAAO;EACjD,IAAI,CAAC,YAAY;EAEjB,MAAM,EAAE,QAAQ,WAAW;EAC3B,MAAM,WAAW,iBAAiB,QAAQ,MAAM,EAAE;EAClD,MAAM,kBAAkB,gBAAgB,QAAQ;EAEhD,OACE,SAAS,gDAAgD,WAAW,IAAI,CAC1E;EAGA,IAAI,aACF,MAAM,wBAAwB,SAAS,QAAQ,QAAQ;EAIzD,IAAI,CAAC,sBAAsB;GAAE;GAAa;EAAY,CAAC,GAAG;GACxD,MAAM,mBAAmB,SAAS,QAAQ,aAAa;GACvD;EACF;EAGA,MAAM,oBAAoB,MAAM,yBAAyB,SAAS,MAAM;EACxE,IAAI,kBAAkB,WAAW,SAC/B,OACE,GAAG,EAAE,iCAAiC,aAAa,KAAK,QAAQ,UAAU,CAAC,EAAE,IAAI,kBAAkB,aAChG,KAAK,UAAU,SAAS,OAAO,WAAW,OAAO,CAAC,CAAC,CACnD,KAAK,IAAI,GACd;OACK,IAAI,kBAAkB,WAAW,sBACtC,OACE,GAAG,EAAE,GAAG,aAAa,KAAK,QAAQ,kBAAkB,aAAa,CAAC,EAAE,sCACtE;EAMF,IACE,kBAAkB,WAAW,wBAC7B,kBAAkB,kBAAkB,YACpC;GACA,OACE,GAAG,EAAE,qCAAqC,SAAS,kBAAkB,eAAe,WAAW,OAAO,EAAE,wCAC1G;GACA;EACF;EAEA,MAAM,YAAY,KAAK,QAAQ,UAAU;EACzC,MAAM,gBAAgB,SAAS,SAAS;EAGxC,MAAM,gBACJ,SACA,KAAK,QAAQ,UAAU,iBAAiB,GACxC,gBAAgB,0BAA0B,yBAC1C,aACF;EAGA,MAAM,iBAAiB,MAAM,YAAY,SAAS,WAAW,QAAQ;EACrE,IAAI,gBACF,MAAM,sBACJ,SACA,gBACA,sBACF;OAEA,MAAM,gBACJ,SACA,KAAK,WAAW,UAAU,iBAAiB,GAC3C,gBAAgB,4BAA4B,2BAC5C,eACF;EAMF,IAAI,CAAC,MADsB,YAAY,SAAS,WAAW,MAAM,GAE/D,MAAM,gBACJ,SACA,KAAK,WAAW,QAAQ,iBAAiB,GACzC,gBAAgB,0BAA0B,yBAC1C,aACF;CAEJ;AACF"}

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

@@ -107,9 +107,62 @@ const LOCALE_PAGE_TEMPLATE_JS = `const Page = async ({ params }) => {
   );
 };
 
+export default Page;
+`;
+/**
+* Root layout (`app/layout.tsx`) for routing modes without a locale path
+* segment (`no-prefix`, `search-params`, or no proxy at all). Owns `<html>` and
+* resolves the locale from the request (cookie / header) via `getLocale()`.
+*/
+const UNPREFIXED_ROOT_LAYOUT_TEMPLATE_TS = `import type { PropsWithChildren } from "react";
+import { getHTMLTextDir } from "intlayer";
+import { getLocale, IntlayerProvider } from "next-intlayer/server";
+
+const RootLayout = async ({ children }: PropsWithChildren) => {
+  const locale = await getLocale();
+
+  return (
+    <html lang={locale} dir={getHTMLTextDir(locale)}>
+      <body>
+        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>
+      </body>
+    </html>
+  );
+};
+
+export default RootLayout;
+`;
+const UNPREFIXED_ROOT_LAYOUT_TEMPLATE_JS = `import { getHTMLTextDir } from "intlayer";
+import { getLocale, IntlayerProvider } from "next-intlayer/server";
+
+const RootLayout = async ({ children }) => {
+  const locale = await getLocale();
+
+  return (
+    <html lang={locale} dir={getHTMLTextDir(locale)}>
+      <body>
+        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>
+      </body>
+    </html>
+  );
+};
+
+export default RootLayout;
+`;
+/**
+* Home page (`app/page.tsx`) for routing modes without a locale path segment.
+* Identical for TypeScript and JavaScript projects.
+*/
+const UNPREFIXED_PAGE_TEMPLATE = `const Page = () => (
+  <main>
+    <h1>Hello</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 };
+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, UNPREFIXED_PAGE_TEMPLATE, UNPREFIXED_ROOT_LAYOUT_TEMPLATE_JS, UNPREFIXED_ROOT_LAYOUT_TEMPLATE_TS };
 //# sourceMappingURL=templates.mjs.map

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

@@ -1 +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/**\n * Locale layout (`app/[locale]/layout.tsx`) providing `<html>` + the unified\n * provider. `IntlayerProvider` seeds both the server context (read by server\n * hooks and by any page below, without per-page wrapping) and the client\n * provider in one mount.\n */\nexport const LOCALE_LAYOUT_TEMPLATE_TS = `import { type NextLayoutIntlayer } from \"next-intlayer\";\nimport { IntlayerProvider } from \"next-intlayer/server\";\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        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n      </body>\n    </html>\n  );\n};\n\nexport default LocaleLayout;\n`;\n\nexport const LOCALE_LAYOUT_TEMPLATE_JS = `import { IntlayerProvider } from \"next-intlayer/server\";\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        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\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;;;;;;;;;;AAWvC,MAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;AAqBzC,MAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;AAyBzC,MAAa,0BAA0B;;;;;;;;;;;;;;;AAgBvC,MAAa,0BAA0B"}
+{"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/**\n * Locale layout (`app/[locale]/layout.tsx`) providing `<html>` + the unified\n * provider. `IntlayerProvider` seeds both the server context (read by server\n * hooks and by any page below, without per-page wrapping) and the client\n * provider in one mount.\n */\nexport const LOCALE_LAYOUT_TEMPLATE_TS = `import { type NextLayoutIntlayer } from \"next-intlayer\";\nimport { IntlayerProvider } from \"next-intlayer/server\";\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        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n      </body>\n    </html>\n  );\n};\n\nexport default LocaleLayout;\n`;\n\nexport const LOCALE_LAYOUT_TEMPLATE_JS = `import { IntlayerProvider } from \"next-intlayer/server\";\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        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\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\n/**\n * Root layout (`app/layout.tsx`) for routing modes without a locale path\n * segment (`no-prefix`, `search-params`, or no proxy at all). Owns `<html>` and\n * resolves the locale from the request (cookie / header) via `getLocale()`.\n */\nexport const UNPREFIXED_ROOT_LAYOUT_TEMPLATE_TS = `import type { PropsWithChildren } from \"react\";\nimport { getHTMLTextDir } from \"intlayer\";\nimport { getLocale, IntlayerProvider } from \"next-intlayer/server\";\n\nconst RootLayout = async ({ children }: PropsWithChildren) => {\n  const locale = await getLocale();\n\n  return (\n    <html lang={locale} dir={getHTMLTextDir(locale)}>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n      </body>\n    </html>\n  );\n};\n\nexport default RootLayout;\n`;\n\nexport const UNPREFIXED_ROOT_LAYOUT_TEMPLATE_JS = `import { getHTMLTextDir } from \"intlayer\";\nimport { getLocale, IntlayerProvider } from \"next-intlayer/server\";\n\nconst RootLayout = async ({ children }) => {\n  const locale = await getLocale();\n\n  return (\n    <html lang={locale} dir={getHTMLTextDir(locale)}>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n      </body>\n    </html>\n  );\n};\n\nexport default RootLayout;\n`;\n\n/**\n * Home page (`app/page.tsx`) for routing modes without a locale path segment.\n * Identical for TypeScript and JavaScript projects.\n */\nexport const UNPREFIXED_PAGE_TEMPLATE = `const Page = () => (\n  <main>\n    <h1>Hello</h1>\n    <p>Get started by editing this page.</p>\n  </main>\n);\n\nexport default Page;\n`;\n"],"mappings":";;;;;;;AAOA,MAAa,iBAAiB;;;;;;;;AAS9B,MAAa,sBAAsB;;;;;;;;AASnC,MAAa,0BAA0B;;;;;;AAOvC,MAAa,0BAA0B;;;;;;;;;;AAWvC,MAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;AAqBzC,MAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;AAyBzC,MAAa,0BAA0B;;;;;;;;;;;;;;;AAgBvC,MAAa,0BAA0B;;;;;;;;;;;;;;;;;;AAmBvC,MAAa,qCAAqC;;;;;;;;;;;;;;;;;;AAmBlD,MAAa,qCAAqC;;;;;;;;;;;;;;;;;;;;;AAsBlD,MAAa,2BAA2B"}

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

@@ -71,7 +71,10 @@ const setHtmlLang = (ast) => {
 			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));
+			else {
+				node.attributes = node.attributes ?? [];
+				node.attributes.push(b.jsxAttribute(b.jsxIdentifier("lang"), localeExpression));
+			}
 			return false;
 		}
 		this.traverse(path);
@@ -88,7 +91,7 @@ const setHtmlLang = (ast) => {
 * pages below the locale layout read locale/variant from it without wrapping
 * themselves individually (see the removed `wrapPageWithProvider`).
 */
-const wrapLayoutWithProvider = (code) => {
+const wrapLayoutWithProvider = (code, { exportStaticParams = true } = {}) => {
 	const ast = parseTsx(code);
 	if (isClientComponent(ast)) return {
 		code,
@@ -120,7 +123,7 @@ const wrapLayoutWithProvider = (code) => {
 	};
 	ensureNamedImport(ast, "IntlayerProvider", "next-intlayer/server");
 	ensureNamedImport(ast, "getLocale", "next-intlayer/server");
-	ensureExportFrom(ast, "generateStaticParams", "next-intlayer");
+	if (exportStaticParams) ensureExportFrom(ast, "generateStaticParams", "next-intlayer");
 	ensureAwaitedLocale(funcNode);
 	setHtmlLang(ast);
 	return {