@intlayer/engine 9.0.0-canary.12 → 9.0.0-canary.14

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

@@ -1,4 +1,5 @@
 import { exists } from "../../utils/fileSystem.mjs";
+import { isVersionAtLeast } from "../../utils/version.mjs";
 import { join } from "node:path";
 
 //#region src/init/frameworkSetup/nextAppRouter/detect.ts
@@ -36,16 +37,6 @@ const findAppFile = async (rootDir, dir, baseName) => {
 	}
 	return null;
 };
-/**
-* Returns true when the dependency `version` range targets a major >= `major`.
-* Tolerant of leading range characters, e.g. `^16.0.0`, `~16`, `16.1.0`.
-*/
-const isVersionAtLeast = (version, major) => {
-	if (!version || typeof version !== "string") return false;
-	const match = version.match(/(\d+)/);
-	if (!match?.[1]) return false;
-	return parseInt(match[1], 10) >= major;
-};
 
 //#endregion
 export { detectNextAppDir, findAppFile, isVersionAtLeast };

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

@@ -1 +1 @@
-{"version":3,"file":"detect.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/detect.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { exists } from '../../utils/fileSystem';\n\n/** Script extensions probed when locating an App Router convention file. */\nconst SCRIPT_EXTENSIONS = ['tsx', 'jsx', 'ts', 'js'] as const;\n\n/** Location of the Next.js App Router directory within the project. */\nexport type NextAppDirInfo = {\n  /** App Router directory relative to the root, e.g. `src/app` or `app`. */\n  appDir: string;\n  /** `src` when the project uses a `src/` directory, otherwise `''`. */\n  srcDir: string;\n};\n\n/**\n * Detects the Next.js App Router directory, preferring `src/app` over `app`.\n * Returns `null` when neither exists (e.g. a Pages Router project).\n */\nexport const detectNextAppDir = async (\n  rootDir: string\n): Promise<NextAppDirInfo | null> => {\n  if (await exists(rootDir, join('src', 'app'))) {\n    return { appDir: join('src', 'app'), srcDir: 'src' };\n  }\n  if (await exists(rootDir, 'app')) {\n    return { appDir: 'app', srcDir: '' };\n  }\n  return null;\n};\n\n/**\n * Finds an existing App Router convention file (e.g. `layout`, `page`) within\n * `dir`, trying each known script extension. Returns the matching relative path\n * or `null`.\n */\nexport const findAppFile = async (\n  rootDir: string,\n  dir: string,\n  baseName: string\n): Promise<string | null> => {\n  for (const extension of SCRIPT_EXTENSIONS) {\n    const candidate = join(dir, `${baseName}.${extension}`);\n    if (await exists(rootDir, candidate)) {\n      return candidate;\n    }\n  }\n  return null;\n};\n\n/**\n * Returns true when the dependency `version` range targets a major >= `major`.\n * Tolerant of leading range characters, e.g. `^16.0.0`, `~16`, `16.1.0`.\n */\nexport const isVersionAtLeast = (\n  version: string | undefined,\n  major: number\n): boolean => {\n  if (!version || typeof version !== 'string') return false;\n  const match = version.match(/(\\d+)/);\n  if (!match?.[1]) return false;\n  return parseInt(match[1], 10) >= major;\n};\n"],"mappings":";;;;;AAIA,MAAM,oBAAoB;CAAC;CAAO;CAAO;CAAM;CAAK;;;;;AAcpD,MAAa,mBAAmB,OAC9B,YACmC;AACnC,KAAI,MAAM,OAAO,SAAS,KAAK,OAAO,MAAM,CAAC,CAC3C,QAAO;EAAE,QAAQ,KAAK,OAAO,MAAM;EAAE,QAAQ;EAAO;AAEtD,KAAI,MAAM,OAAO,SAAS,MAAM,CAC9B,QAAO;EAAE,QAAQ;EAAO,QAAQ;EAAI;AAEtC,QAAO;;;;;;;AAQT,MAAa,cAAc,OACzB,SACA,KACA,aAC2B;AAC3B,MAAK,MAAM,aAAa,mBAAmB;EACzC,MAAM,YAAY,KAAK,KAAK,GAAG,SAAS,GAAG,YAAY;AACvD,MAAI,MAAM,OAAO,SAAS,UAAU,CAClC,QAAO;;AAGX,QAAO;;;;;;AAOT,MAAa,oBACX,SACA,UACY;AACZ,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;CACpD,MAAM,QAAQ,QAAQ,MAAM,QAAQ;AACpC,KAAI,CAAC,QAAQ,GAAI,QAAO;AACxB,QAAO,SAAS,MAAM,IAAI,GAAG,IAAI"}
+{"version":3,"file":"detect.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/detect.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { exists } from '../../utils/fileSystem';\n\n/** Script extensions probed when locating an App Router convention file. */\nconst SCRIPT_EXTENSIONS = ['tsx', 'jsx', 'ts', 'js'] as const;\n\n/** Location of the Next.js App Router directory within the project. */\nexport type NextAppDirInfo = {\n  /** App Router directory relative to the root, e.g. `src/app` or `app`. */\n  appDir: string;\n  /** `src` when the project uses a `src/` directory, otherwise `''`. */\n  srcDir: string;\n};\n\n/**\n * Detects the Next.js App Router directory, preferring `src/app` over `app`.\n * Returns `null` when neither exists (e.g. a Pages Router project).\n */\nexport const detectNextAppDir = async (\n  rootDir: string\n): Promise<NextAppDirInfo | null> => {\n  if (await exists(rootDir, join('src', 'app'))) {\n    return { appDir: join('src', 'app'), srcDir: 'src' };\n  }\n  if (await exists(rootDir, 'app')) {\n    return { appDir: 'app', srcDir: '' };\n  }\n  return null;\n};\n\n/**\n * Finds an existing App Router convention file (e.g. `layout`, `page`) within\n * `dir`, trying each known script extension. Returns the matching relative path\n * or `null`.\n */\nexport const findAppFile = async (\n  rootDir: string,\n  dir: string,\n  baseName: string\n): Promise<string | null> => {\n  for (const extension of SCRIPT_EXTENSIONS) {\n    const candidate = join(dir, `${baseName}.${extension}`);\n    if (await exists(rootDir, candidate)) {\n      return candidate;\n    }\n  }\n  return null;\n};\n\nexport { isVersionAtLeast } from '../../utils/version';\n"],"mappings":";;;;;;AAIA,MAAM,oBAAoB;CAAC;CAAO;CAAO;CAAM;CAAK;;;;;AAcpD,MAAa,mBAAmB,OAC9B,YACmC;AACnC,KAAI,MAAM,OAAO,SAAS,KAAK,OAAO,MAAM,CAAC,CAC3C,QAAO;EAAE,QAAQ,KAAK,OAAO,MAAM;EAAE,QAAQ;EAAO;AAEtD,KAAI,MAAM,OAAO,SAAS,MAAM,CAC9B,QAAO;EAAE,QAAQ;EAAO,QAAQ;EAAI;AAEtC,QAAO;;;;;;;AAQT,MAAa,cAAc,OACzB,SACA,KACA,aAC2B;AAC3B,MAAK,MAAM,aAAa,mBAAmB;EACzC,MAAM,YAAY,KAAK,KAAK,GAAG,SAAS,GAAG,YAAY;AACvD,MAAI,MAAM,OAAO,SAAS,UAAU,CAClC,QAAO;;AAGX,QAAO"}

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

@@ -1,5 +1,6 @@
 import { ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "../../utils/fileSystem.mjs";
-import { detectNextAppDir, findAppFile, isVersionAtLeast } from "./detect.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 { wrapLayoutWithProvider, wrapPageWithProvider } from "./transforms.mjs";

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 {\n  type TransformResult,\n  wrapLayoutWithProvider,\n  wrapPageWithProvider,\n} 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/page 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/page with the Intlayer\n * providers — all idempotently and without overwriting recognizable user code.\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 — transform an existing one, else scaffold from template.\n    const existingPage = await findAppFile(rootDir, localeDir, 'page');\n    if (existingPage) {\n      await transformExistingFile(rootDir, existingPage, wrapPageWithProvider);\n    } else {\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 { 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 {\n  type TransformResult,\n  wrapLayoutWithProvider,\n  wrapPageWithProvider,\n} 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/page 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/page with the Intlayer\n * providers — all idempotently and without overwriting recognizable user code.\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 — transform an existing one, else scaffold from template.\n    const existingPage = await findAppFile(rootDir, localeDir, 'page');\n    if (existingPage) {\n      await transformExistingFile(rootDir, existingPage, wrapPageWithProvider);\n    } else {\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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"}

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

@@ -1,4 +1,4 @@
-import { __require } from "../../../_virtual/_rolldown/runtime.mjs";
+import { babelTsParser } from "../../../utils/recastBabelParser.mjs";
 import { mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import fg from "fast-glob";
@@ -72,7 +72,7 @@ const mapTargetPath = (oldTargetAbs, { appDirAbs, localeDirAbs, movedTopLevelNam
 * are left untouched. Returns the original code unchanged when nothing matched.
 */
 const rewriteRelativeImports = (code, oldAbs, newAbs, context) => {
-	const ast = recast.parse(code, { parser: __require("recast/parsers/babel-ts") });
+	const ast = recast.parse(code, { parser: babelTsParser });
 	let changed = false;
 	const rewriteSource = (sourceNode) => {
 		if (!sourceNode || !n.StringLiteral.check(sourceNode)) return;

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

@@ -1 +1 @@
-{"version":3,"file":"restructure.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/restructure.ts"],"sourcesContent":["import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';\nimport fg from 'fast-glob';\nimport * as recast from 'recast';\n\nconst { namedTypes: n } = recast.types;\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/** Strips a known script extension from a file name, e.g. `page.tsx` -> `page`. */\nconst stripScriptExtension = (fileName: string): string =>\n  fileName.replace(/\\.(tsx|ts|jsx|js|mjs|cjs)$/, '');\n\n/**\n * Detects whether a top-level App Router entry is already a locale segment, in\n * any of the Next.js dynamic-segment forms:\n * - `[locale]` — required segment (prefix every locale),\n * - `[...locale]` / `[[...locale]]` — catch-all / optional catch-all segments.\n *\n * Used to skip the restructure when the project is already locale-aware, so an\n * existing locale segment is never nested under a freshly created `[locale]`.\n */\nexport const isLocaleSegment = (entryName: string): boolean =>\n  /^\\[\\[?\\.{0,3}locale\\]\\]?$/.test(entryName);\n\n/**\n * Top-level App Router entries that must stay at the app root and never be\n * moved under `[locale]`:\n * - `api/` route handlers (not locale-prefixed),\n * - global stylesheets,\n * - metadata/asset file conventions (favicon, icon, sitemap, robots, manifest…),\n * - `global-error` and `not-found` boundaries (kept as root fallbacks).\n *\n * Everything else (`page`, `loading`, `error`, `template`, `default`, the root\n * `layout`, and nested route folders) is moved so it becomes locale-aware.\n */\nexport const shouldKeepAppEntryAtRoot = (entryName: string): boolean => {\n  if (entryName === 'api') return true;\n  if (entryName.toLowerCase().endsWith('.css')) return true;\n  if (entryName === 'favicon.ico') return true;\n\n  const base = stripScriptExtension(entryName);\n  const keepExactBases = new Set([\n    'not-found',\n    'global-error',\n    'sitemap',\n    'robots',\n    'manifest',\n  ]);\n  if (keepExactBases.has(base)) return true;\n\n  // Image metadata conventions: favicon, icon, apple-icon, opengraph-image,\n  // twitter-image — optionally suffixed (e.g. `icon1`, `opengraph-image-alt`).\n  const imageConventionPrefixes = [\n    'favicon',\n    'icon',\n    'apple-icon',\n    'opengraph-image',\n    'twitter-image',\n  ];\n  if (imageConventionPrefixes.some((prefix) => base.startsWith(prefix))) {\n    return true;\n  }\n\n  return false;\n};\n\ntype RewriteContext = {\n  appDirAbs: string;\n  localeDirAbs: string;\n  movedTopLevelNames: string[];\n};\n\n/**\n * Maps an import target's pre-move absolute path to its post-move absolute path.\n * Targets that live inside a moved top-level entry are relocated under\n * `[locale]`; targets that stayed at the app root or live outside the app\n * directory are returned unchanged.\n */\nconst mapTargetPath = (\n  oldTargetAbs: string,\n  { appDirAbs, localeDirAbs, movedTopLevelNames }: RewriteContext\n): string => {\n  const relFromApp = relative(appDirAbs, oldTargetAbs);\n\n  // Outside the app directory (e.g. `../components/...`) — never moved.\n  if (relFromApp.startsWith('..') || isAbsolute(relFromApp)) {\n    return oldTargetAbs;\n  }\n\n  const firstSegment = relFromApp.split(sep)[0] ?? '';\n  const isMoved = movedTopLevelNames.some(\n    (name) =>\n      name === firstSegment || stripScriptExtension(name) === firstSegment\n  );\n\n  if (!isMoved) return oldTargetAbs;\n\n  return join(localeDirAbs, relFromApp);\n};\n\n/**\n * Rewrites relative import/export/`import()`/`require()` specifiers in a file\n * that has moved from `oldAbs` to `newAbs`, so they keep resolving to the same\n * modules after the move. Non-relative specifiers (bare packages, `@/` aliases)\n * are left untouched. Returns the original code unchanged when nothing matched.\n */\nexport const rewriteRelativeImports = (\n  code: string,\n  oldAbs: string,\n  newAbs: string,\n  context: RewriteContext\n): string => {\n  // babel-ts handles TypeScript *and* JSX (App Router files are `.tsx`).\n  const ast = recast.parse(code, {\n    parser: require('recast/parsers/babel-ts'),\n  });\n\n  let changed = false;\n\n  const rewriteSource = (sourceNode: any): void => {\n    if (!sourceNode || !n.StringLiteral.check(sourceNode)) return;\n    const specifier = sourceNode.value;\n    if (typeof specifier !== 'string' || !specifier.startsWith('.')) return;\n\n    const oldTargetAbs = resolve(dirname(oldAbs), specifier);\n    const newTargetAbs = mapTargetPath(oldTargetAbs, context);\n\n    let newSpecifier = relative(dirname(newAbs), newTargetAbs)\n      .split(sep)\n      .join('/');\n    if (!newSpecifier.startsWith('.')) {\n      newSpecifier = `./${newSpecifier}`;\n    }\n\n    if (newSpecifier !== specifier) {\n      sourceNode.value = newSpecifier;\n      changed = true;\n    }\n  };\n\n  recast.visit(ast, {\n    visitImportDeclaration(path) {\n      rewriteSource(path.node.source);\n      return false;\n    },\n    visitExportAllDeclaration(path) {\n      rewriteSource(path.node.source);\n      return false;\n    },\n    visitExportNamedDeclaration(path) {\n      if (path.node.source) rewriteSource(path.node.source);\n      return false;\n    },\n    visitCallExpression(path) {\n      const { callee, arguments: args } = path.node;\n      const isDynamicImport = callee.type === 'Import';\n      const isRequire = n.Identifier.check(callee) && callee.name === 'require';\n      if ((isDynamicImport || isRequire) && args.length > 0) {\n        rewriteSource(args[0]);\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (!changed) return code;\n  return recast.print(ast).code;\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 App Router entries of `appDir` under a new `[locale]`\n * segment and rewrites relative imports in the moved files. Idempotent: it is a\n * no-op when the app is already locale-aware in any prefix mode (see\n * {@link isLocaleSegment}), which is reported via `localeSegment`. Root-only\n * files (see {@link shouldKeepAppEntryAtRoot}) are left in place.\n */\nexport const restructureAppIntoLocale = async (\n  rootDir: string,\n  appDir: string\n): Promise<RestructureResult> => {\n  const appDirAbs = join(rootDir, appDir);\n  const localeDirAbs = join(appDirAbs, '[locale]');\n\n  const entries = await readdir(appDirAbs, { withFileTypes: true });\n\n  // Skip when the app is already locale-aware in any prefix mode — a fresh\n  // `[locale]`, or an existing `[...locale]` / `[[...locale]]` catch-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) => !shouldKeepAppEntryAtRoot(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(appDirAbs, 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: RewriteContext = {\n    appDirAbs,\n    localeDirAbs,\n    movedTopLevelNames,\n  };\n\n  for (const newAbs of movedFiles) {\n    const relFromLocale = relative(localeDirAbs, newAbs);\n    const oldAbs = join(appDirAbs, 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":"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"}
+{"version":3,"file":"restructure.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/restructure.ts"],"sourcesContent":["import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';\nimport fg from 'fast-glob';\nimport * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/recastBabelParser';\n\nconst { namedTypes: n } = recast.types;\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/** Strips a known script extension from a file name, e.g. `page.tsx` -> `page`. */\nconst stripScriptExtension = (fileName: string): string =>\n  fileName.replace(/\\.(tsx|ts|jsx|js|mjs|cjs)$/, '');\n\n/**\n * Detects whether a top-level App Router entry is already a locale segment, in\n * any of the Next.js dynamic-segment forms:\n * - `[locale]` — required segment (prefix every locale),\n * - `[...locale]` / `[[...locale]]` — catch-all / optional catch-all segments.\n *\n * Used to skip the restructure when the project is already locale-aware, so an\n * existing locale segment is never nested under a freshly created `[locale]`.\n */\nexport const isLocaleSegment = (entryName: string): boolean =>\n  /^\\[\\[?\\.{0,3}locale\\]\\]?$/.test(entryName);\n\n/**\n * Top-level App Router entries that must stay at the app root and never be\n * moved under `[locale]`:\n * - `api/` route handlers (not locale-prefixed),\n * - global stylesheets,\n * - metadata/asset file conventions (favicon, icon, sitemap, robots, manifest…),\n * - `global-error` and `not-found` boundaries (kept as root fallbacks).\n *\n * Everything else (`page`, `loading`, `error`, `template`, `default`, the root\n * `layout`, and nested route folders) is moved so it becomes locale-aware.\n */\nexport const shouldKeepAppEntryAtRoot = (entryName: string): boolean => {\n  if (entryName === 'api') return true;\n  if (entryName.toLowerCase().endsWith('.css')) return true;\n  if (entryName === 'favicon.ico') return true;\n\n  const base = stripScriptExtension(entryName);\n  const keepExactBases = new Set([\n    'not-found',\n    'global-error',\n    'sitemap',\n    'robots',\n    'manifest',\n  ]);\n  if (keepExactBases.has(base)) return true;\n\n  // Image metadata conventions: favicon, icon, apple-icon, opengraph-image,\n  // twitter-image — optionally suffixed (e.g. `icon1`, `opengraph-image-alt`).\n  const imageConventionPrefixes = [\n    'favicon',\n    'icon',\n    'apple-icon',\n    'opengraph-image',\n    'twitter-image',\n  ];\n  if (imageConventionPrefixes.some((prefix) => base.startsWith(prefix))) {\n    return true;\n  }\n\n  return false;\n};\n\ntype RewriteContext = {\n  appDirAbs: string;\n  localeDirAbs: string;\n  movedTopLevelNames: string[];\n};\n\n/**\n * Maps an import target's pre-move absolute path to its post-move absolute path.\n * Targets that live inside a moved top-level entry are relocated under\n * `[locale]`; targets that stayed at the app root or live outside the app\n * directory are returned unchanged.\n */\nconst mapTargetPath = (\n  oldTargetAbs: string,\n  { appDirAbs, localeDirAbs, movedTopLevelNames }: RewriteContext\n): string => {\n  const relFromApp = relative(appDirAbs, oldTargetAbs);\n\n  // Outside the app directory (e.g. `../components/...`) — never moved.\n  if (relFromApp.startsWith('..') || isAbsolute(relFromApp)) {\n    return oldTargetAbs;\n  }\n\n  const firstSegment = relFromApp.split(sep)[0] ?? '';\n  const isMoved = movedTopLevelNames.some(\n    (name) =>\n      name === firstSegment || stripScriptExtension(name) === firstSegment\n  );\n\n  if (!isMoved) return oldTargetAbs;\n\n  return join(localeDirAbs, relFromApp);\n};\n\n/**\n * Rewrites relative import/export/`import()`/`require()` specifiers in a file\n * that has moved from `oldAbs` to `newAbs`, so they keep resolving to the same\n * modules after the move. Non-relative specifiers (bare packages, `@/` aliases)\n * are left untouched. Returns the original code unchanged when nothing matched.\n */\nexport const rewriteRelativeImports = (\n  code: string,\n  oldAbs: string,\n  newAbs: string,\n  context: RewriteContext\n): string => {\n  // babel-ts handles TypeScript *and* JSX (App Router files are `.tsx`).\n  const ast = recast.parse(code, { parser: babelTsParser });\n\n  let changed = false;\n\n  const rewriteSource = (sourceNode: any): void => {\n    if (!sourceNode || !n.StringLiteral.check(sourceNode)) return;\n    const specifier = sourceNode.value;\n    if (typeof specifier !== 'string' || !specifier.startsWith('.')) return;\n\n    const oldTargetAbs = resolve(dirname(oldAbs), specifier);\n    const newTargetAbs = mapTargetPath(oldTargetAbs, context);\n\n    let newSpecifier = relative(dirname(newAbs), newTargetAbs)\n      .split(sep)\n      .join('/');\n    if (!newSpecifier.startsWith('.')) {\n      newSpecifier = `./${newSpecifier}`;\n    }\n\n    if (newSpecifier !== specifier) {\n      sourceNode.value = newSpecifier;\n      changed = true;\n    }\n  };\n\n  recast.visit(ast, {\n    visitImportDeclaration(path) {\n      rewriteSource(path.node.source);\n      return false;\n    },\n    visitExportAllDeclaration(path) {\n      rewriteSource(path.node.source);\n      return false;\n    },\n    visitExportNamedDeclaration(path) {\n      if (path.node.source) rewriteSource(path.node.source);\n      return false;\n    },\n    visitCallExpression(path) {\n      const { callee, arguments: args } = path.node;\n      const isDynamicImport = callee.type === 'Import';\n      const isRequire = n.Identifier.check(callee) && callee.name === 'require';\n      if ((isDynamicImport || isRequire) && args.length > 0) {\n        rewriteSource(args[0]);\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (!changed) return code;\n  return recast.print(ast).code;\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 App Router entries of `appDir` under a new `[locale]`\n * segment and rewrites relative imports in the moved files. Idempotent: it is a\n * no-op when the app is already locale-aware in any prefix mode (see\n * {@link isLocaleSegment}), which is reported via `localeSegment`. Root-only\n * files (see {@link shouldKeepAppEntryAtRoot}) are left in place.\n */\nexport const restructureAppIntoLocale = async (\n  rootDir: string,\n  appDir: string\n): Promise<RestructureResult> => {\n  const appDirAbs = join(rootDir, appDir);\n  const localeDirAbs = join(appDirAbs, '[locale]');\n\n  const entries = await readdir(appDirAbs, { withFileTypes: true });\n\n  // Skip when the app is already locale-aware in any prefix mode — a fresh\n  // `[locale]`, or an existing `[...locale]` / `[[...locale]]` catch-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) => !shouldKeepAppEntryAtRoot(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(appDirAbs, 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: RewriteContext = {\n    appDirAbs,\n    localeDirAbs,\n    movedTopLevelNames,\n  };\n\n  for (const newAbs of movedFiles) {\n    const relFromLocale = relative(localeDirAbs, newAbs);\n    const oldAbs = join(appDirAbs, 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":"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"}

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

@@ -1,11 +1,11 @@
-import { __require } from "../../../_virtual/_rolldown/runtime.mjs";
+import { babelTsParser } from "../../../utils/recastBabelParser.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") });
+const parseTsx = (code) => recast.parse(code, { parser: babelTsParser });
 /** 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;

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

@@ -1 +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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"}
+{"version":3,"file":"transforms.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/nextAppRouter/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/recastBabelParser';\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: babelTsParser });\n\n/** Result of a source transform. `code` is unchanged for any non-`wrapped` status. */\nexport type TransformResult = {\n  code: string;\n  status: 'wrapped' | 'already' | 'skipped-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/transforms.mjs

@@ -1,11 +1,11 @@
-import { __require } from "../../../_virtual/_rolldown/runtime.mjs";
+import { babelTsParser } from "../../../utils/recastBabelParser.mjs";
 import { ensureNamedImport } from "../../utils/astImports.mjs";
 import * as recast from "recast";
 
 //#region src/init/frameworkSetup/tanstackStart/transforms.ts
 const { builders: b, namedTypes: n } = recast.types;
 /** babel-ts parser handles TypeScript *and* JSX. */
-const parseTsx = (code) => recast.parse(code, { parser: __require("recast/parsers/babel-ts") });
+const parseTsx = (code) => recast.parse(code, { parser: babelTsParser });
 /**
 * Finds the single function that returns the `<html>` document element. Returns
 * `null` when there is no such function, or more than one (ambiguous).

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

@@ -1 +1 @@
-{"version":3,"file":"transforms.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { ensureNamedImport } from '../../utils/astImports';\n\nconst { builders: b, namedTypes: n } = recast.types;\n\n/** babel-ts parser handles TypeScript *and* JSX. */\nconst parseTsx = (code: string): any =>\n  recast.parse(code, { parser: 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';\n};\n\n/**\n * Finds the single function that returns the `<html>` document element. Returns\n * `null` when there is no such function, or more than one (ambiguous).\n */\nconst findHtmlDocumentFunction = (ast: any): any => {\n  const found = new Set<any>();\n\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type === 'JSXIdentifier' && node.name.name === 'html') {\n        // Walk up to the nearest enclosing function node.\n        let current = path.parentPath;\n        while (current) {\n          const value = current.value;\n          if (\n            value &&\n            (n.FunctionDeclaration.check(value) ||\n              n.FunctionExpression.check(value) ||\n              n.ArrowFunctionExpression.check(value))\n          ) {\n            found.add(value);\n            break;\n          }\n          current = current.parentPath;\n        }\n      }\n      this.traverse(path);\n    },\n  });\n\n  return found.size === 1 ? [...found][0] : null;\n};\n\n/**\n * Whether the binding pattern `node` introduces a variable named `name`.\n * Recurses through destructuring patterns so all of `const locale`,\n * `const { locale } = …`, `const { locale = fallback } = …`,\n * `const { foo: locale } = …`, `const [locale] = …` and `...locale` are\n * detected — not just a bare identifier.\n */\nconst patternBindsName = (node: any, name: string): boolean => {\n  if (!node) return false;\n  switch (node.type) {\n    case 'Identifier':\n      return node.name === name;\n    case 'AssignmentPattern':\n      // `locale = fallback`\n      return patternBindsName(node.left, name);\n    case 'RestElement':\n      // `...locale`\n      return patternBindsName(node.argument, name);\n    case 'ArrayPattern':\n      return node.elements.some((element: any) =>\n        patternBindsName(element, name)\n      );\n    case 'ObjectPattern':\n      return node.properties.some((property: any) =>\n        property.type === 'RestElement'\n          ? patternBindsName(property.argument, name)\n          : // The *value* is the binding target (`{ foo: locale }` binds `locale`).\n            patternBindsName(property.value, name)\n      );\n    default:\n      return false;\n  }\n};\n\n/**\n * Inserts `const locale = …` once, at the top of the function body. A single\n * self-contained statement is used (rather than an intermediate `params` const)\n * so it can never collide with a `params` variable the document already\n * declares. Expression-bodied arrow functions are first converted to a block so\n * the declaration has somewhere to live.\n *\n * No-ops when `locale` is already bound in the function — whether as a simple\n * identifier, through a destructuring pattern (e.g.\n * `const { locale = defaultLocale } = useLoaderData()`), or as a function\n * parameter — so the injected declaration never collides with one the document\n * already provides (which would produce an\n * `Identifier 'locale' has already been declared` parse error).\n */\nconst ensureLocaleFromParams = (funcNode: any): void => {\n  if (funcNode.body?.type !== 'BlockStatement') {\n    funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);\n  }\n\n  const declaredInBody = funcNode.body.body.some(\n    (stmt: any) =>\n      stmt.type === 'VariableDeclaration' &&\n      stmt.declarations.some((d: any) => patternBindsName(d.id, 'locale'))\n  );\n  const declaredInParams = (funcNode.params ?? []).some((param: any) =>\n    patternBindsName(param, 'locale')\n  );\n  if (declaredInBody || declaredInParams) return;\n\n  const statement = parseTsx(\n    'const locale = useParams({ strict: false }).locale ?? defaultLocale;'\n  ).program.body[0];\n  funcNode.body.body.unshift(statement);\n};\n\n/** Sets `lang={locale}` and `dir={getHTMLTextDir(locale)}` on the first `<html>` element. */\nconst setHtmlLangAndDir = (ast: any): void => {\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type !== 'JSXIdentifier' || node.name.name !== 'html') {\n        this.traverse(path);\n        return;\n      }\n\n      const upsertAttribute = (name: string, value: any): void => {\n        const existing = node.attributes?.find(\n          (attr: any) =>\n            attr.type === 'JSXAttribute' && attr.name?.name === name\n        ) as any;\n        if (existing) {\n          existing.value = value;\n        } else {\n          node.attributes.push(b.jsxAttribute(b.jsxIdentifier(name), value));\n        }\n      };\n\n      upsertAttribute('lang', b.jsxExpressionContainer(b.identifier('locale')));\n      upsertAttribute(\n        'dir',\n        b.jsxExpressionContainer(\n          b.callExpression(b.identifier('getHTMLTextDir'), [\n            b.identifier('locale'),\n          ])\n        )\n      );\n      return false;\n    },\n  });\n};\n\n/**\n * Wraps the `{children}` of a TanStack Start root document with\n * `IntlayerProvider`, deriving the locale from the `{-$locale}` route param.\n * Safe and idempotent: bails (returns the original code) when the provider is\n * already present, when no `<html>` document function is found, or when there is\n * no `{children}` placeholder to wrap.\n */\nexport const wrapRootWithProvider = (code: string): TransformResult => {\n  const ast = parseTsx(code);\n\n  if (code.includes('IntlayerProvider')) return { code, status: 'already' };\n\n  const funcNode = findHtmlDocumentFunction(ast);\n  if (!funcNode) return { code, status: 'skipped' };\n\n  let wrapped = false;\n  recast.visit(funcNode, {\n    visitJSXExpressionContainer(path) {\n      if (wrapped) return false;\n      const expression = path.node.expression;\n      if (expression?.type === 'Identifier' && expression.name === 'children') {\n        const template = parseTsx(\n          'const __wrap = <IntlayerProvider locale={locale}>{__child__}</IntlayerProvider>;'\n        );\n        const providerElement = template.program.body[0].declarations[0].init;\n        providerElement.children = [path.node];\n        path.replace(providerElement);\n        wrapped = true;\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (!wrapped) return { code, status: 'skipped' };\n\n  ensureNamedImport(ast, 'IntlayerProvider', 'react-intlayer');\n  ensureNamedImport(ast, 'useParams', '@tanstack/react-router');\n  ensureNamedImport(ast, 'defaultLocale', 'intlayer');\n  ensureNamedImport(ast, 'getHTMLTextDir', 'intlayer');\n  ensureLocaleFromParams(funcNode);\n  setHtmlLangAndDir(ast);\n\n  return { code: recast.print(ast).code, status: 'wrapped' };\n};\n"],"mappings":"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"}
+{"version":3,"file":"transforms.mjs","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/recastBabelParser';\nimport { ensureNamedImport } from '../../utils/astImports';\n\nconst { builders: b, namedTypes: n } = recast.types;\n\n/** babel-ts parser handles TypeScript *and* JSX. */\nconst parseTsx = (code: string): any =>\n  recast.parse(code, { parser: babelTsParser });\n\n/** Result of a source transform. `code` is unchanged for any non-`wrapped` status. */\nexport type TransformResult = {\n  code: string;\n  status: 'wrapped' | 'already' | 'skipped';\n};\n\n/**\n * Finds the single function that returns the `<html>` document element. Returns\n * `null` when there is no such function, or more than one (ambiguous).\n */\nconst findHtmlDocumentFunction = (ast: any): any => {\n  const found = new Set<any>();\n\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type === 'JSXIdentifier' && node.name.name === 'html') {\n        // Walk up to the nearest enclosing function node.\n        let current = path.parentPath;\n        while (current) {\n          const value = current.value;\n          if (\n            value &&\n            (n.FunctionDeclaration.check(value) ||\n              n.FunctionExpression.check(value) ||\n              n.ArrowFunctionExpression.check(value))\n          ) {\n            found.add(value);\n            break;\n          }\n          current = current.parentPath;\n        }\n      }\n      this.traverse(path);\n    },\n  });\n\n  return found.size === 1 ? [...found][0] : null;\n};\n\n/**\n * Whether the binding pattern `node` introduces a variable named `name`.\n * Recurses through destructuring patterns so all of `const locale`,\n * `const { locale } = …`, `const { locale = fallback } = …`,\n * `const { foo: locale } = …`, `const [locale] = …` and `...locale` are\n * detected — not just a bare identifier.\n */\nconst patternBindsName = (node: any, name: string): boolean => {\n  if (!node) return false;\n  switch (node.type) {\n    case 'Identifier':\n      return node.name === name;\n    case 'AssignmentPattern':\n      // `locale = fallback`\n      return patternBindsName(node.left, name);\n    case 'RestElement':\n      // `...locale`\n      return patternBindsName(node.argument, name);\n    case 'ArrayPattern':\n      return node.elements.some((element: any) =>\n        patternBindsName(element, name)\n      );\n    case 'ObjectPattern':\n      return node.properties.some((property: any) =>\n        property.type === 'RestElement'\n          ? patternBindsName(property.argument, name)\n          : // The *value* is the binding target (`{ foo: locale }` binds `locale`).\n            patternBindsName(property.value, name)\n      );\n    default:\n      return false;\n  }\n};\n\n/**\n * Inserts `const locale = …` once, at the top of the function body. A single\n * self-contained statement is used (rather than an intermediate `params` const)\n * so it can never collide with a `params` variable the document already\n * declares. Expression-bodied arrow functions are first converted to a block so\n * the declaration has somewhere to live.\n *\n * No-ops when `locale` is already bound in the function — whether as a simple\n * identifier, through a destructuring pattern (e.g.\n * `const { locale = defaultLocale } = useLoaderData()`), or as a function\n * parameter — so the injected declaration never collides with one the document\n * already provides (which would produce an\n * `Identifier 'locale' has already been declared` parse error).\n */\nconst ensureLocaleFromParams = (funcNode: any): void => {\n  if (funcNode.body?.type !== 'BlockStatement') {\n    funcNode.body = b.blockStatement([b.returnStatement(funcNode.body)]);\n  }\n\n  const declaredInBody = funcNode.body.body.some(\n    (stmt: any) =>\n      stmt.type === 'VariableDeclaration' &&\n      stmt.declarations.some((d: any) => patternBindsName(d.id, 'locale'))\n  );\n  const declaredInParams = (funcNode.params ?? []).some((param: any) =>\n    patternBindsName(param, 'locale')\n  );\n  if (declaredInBody || declaredInParams) return;\n\n  const statement = parseTsx(\n    'const locale = useParams({ strict: false }).locale ?? defaultLocale;'\n  ).program.body[0];\n  funcNode.body.body.unshift(statement);\n};\n\n/** Sets `lang={locale}` and `dir={getHTMLTextDir(locale)}` on the first `<html>` element. */\nconst setHtmlLangAndDir = (ast: any): void => {\n  recast.visit(ast, {\n    visitJSXOpeningElement(path) {\n      const node = path.node;\n      if (node.name?.type !== 'JSXIdentifier' || node.name.name !== 'html') {\n        this.traverse(path);\n        return;\n      }\n\n      const upsertAttribute = (name: string, value: any): void => {\n        const existing = node.attributes?.find(\n          (attr: any) =>\n            attr.type === 'JSXAttribute' && attr.name?.name === name\n        ) as any;\n        if (existing) {\n          existing.value = value;\n        } else {\n          node.attributes.push(b.jsxAttribute(b.jsxIdentifier(name), value));\n        }\n      };\n\n      upsertAttribute('lang', b.jsxExpressionContainer(b.identifier('locale')));\n      upsertAttribute(\n        'dir',\n        b.jsxExpressionContainer(\n          b.callExpression(b.identifier('getHTMLTextDir'), [\n            b.identifier('locale'),\n          ])\n        )\n      );\n      return false;\n    },\n  });\n};\n\n/**\n * Wraps the `{children}` of a TanStack Start root document with\n * `IntlayerProvider`, deriving the locale from the `{-$locale}` route param.\n * Safe and idempotent: bails (returns the original code) when the provider is\n * already present, when no `<html>` document function is found, or when there is\n * no `{children}` placeholder to wrap.\n */\nexport const wrapRootWithProvider = (code: string): TransformResult => {\n  const ast = parseTsx(code);\n\n  if (code.includes('IntlayerProvider')) return { code, status: 'already' };\n\n  const funcNode = findHtmlDocumentFunction(ast);\n  if (!funcNode) return { code, status: 'skipped' };\n\n  let wrapped = false;\n  recast.visit(funcNode, {\n    visitJSXExpressionContainer(path) {\n      if (wrapped) return false;\n      const expression = path.node.expression;\n      if (expression?.type === 'Identifier' && expression.name === 'children') {\n        const template = parseTsx(\n          'const __wrap = <IntlayerProvider locale={locale}>{__child__}</IntlayerProvider>;'\n        );\n        const providerElement = template.program.body[0].declarations[0].init;\n        providerElement.children = [path.node];\n        path.replace(providerElement);\n        wrapped = true;\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (!wrapped) return { code, status: 'skipped' };\n\n  ensureNamedImport(ast, 'IntlayerProvider', 'react-intlayer');\n  ensureNamedImport(ast, 'useParams', '@tanstack/react-router');\n  ensureNamedImport(ast, 'defaultLocale', 'intlayer');\n  ensureNamedImport(ast, 'getHTMLTextDir', 'intlayer');\n  ensureLocaleFromParams(funcNode);\n  setHtmlLangAndDir(ast);\n\n  return { code: recast.print(ast).code, status: 'wrapped' };\n};\n"],"mappings":"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"}

package/dist/esm/init/index.mjs

@@ -1,7 +1,8 @@
 import { getMetroConfigTemplate, replaceViteConfigPluginImportSource, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin } from "./utils/configManipulation.mjs";
 import { detectJsonLocalePattern, detectLinguiCatalogPattern, detectNextIntlMessagesPattern, ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "./utils/fileSystem.mjs";
-import { setRoutingModeInConfig } from "./cms.mjs";
+import { setCompilerOutputInConfig, setRoutingModeInConfig } from "./cms.mjs";
 import { initConfig } from "../initConfig/index.mjs";
+import { isVersionAtLeast } from "./utils/version.mjs";
 import { setupFramework } from "./frameworkSetup/index.mjs";
 import { getGithubWorkflows } from "./utils/githubActions.mjs";
 import { parseJSONWithComments } from "./utils/jsonParser.mjs";
@@ -101,6 +102,22 @@ const getDocumentationUrl = (packageJson) => {
 	return DocumentationRouter.Default;
 };
 /**
+* Resolves the default dev-server URL of the detected framework, used as the
+* `editor.applicationURL` of the generated configuration file. Frameworks that
+* embed Vite (Astro, SvelteKit, …) are checked before the bare Vite fallback so
+* their own dev port wins.
+*/
+const getDefaultApplicationURL = (dependencies) => {
+	if (dependencies.next) return "http://localhost:3000";
+	if (dependencies.astro) return "http://localhost:4321";
+	if (dependencies["@angular/core"]) return "http://localhost:4200";
+	if (dependencies.nuxt) return "http://localhost:3000";
+	if (dependencies["@sveltejs/kit"]) return "http://localhost:5173";
+	if (dependencies["react-scripts"]) return "http://localhost:3000";
+	if (dependencies.vite) return "http://localhost:5173";
+	return "http://localhost:3000";
+};
+/**
 * MAIN LOGIC
 */
 const initIntlayer = async (rootDir, options) => {
@@ -132,6 +149,8 @@ const initIntlayer = async (rootDir, options) => {
 	const linguiCatalog = linguiPresent ? await detectLinguiCatalogPattern(rootDir) : null;
 	const hintLinguiJson = Boolean(options?.hintDependencies?.["__lingui_json__"]);
 	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig } = detectMissingIntlayerPackages(effectiveAllDeps, { linguiCatalogFormat: linguiCatalog?.format ?? (linguiPresent ? hintLinguiJson ? "json" : "po" : null) });
+	const wantsJsonNamespaces = options?.contentStrategy === "json-namespaces" && !compatSyncConfig;
+	if (wantsJsonNamespaces && !effectiveAllDeps["@intlayer/sync-json-plugin"] && !devPackagesToInstall.includes("@intlayer/sync-json-plugin")) devPackagesToInstall.push("@intlayer/sync-json-plugin");
 	if (!options?.noInstallPackages) {
 		const withVersion = (packages) => options?.upgradeToVersion ? packages.map((pkg) => `${pkg}@${options.upgradeToVersion}`) : packages;
 		if (packagesToInstall.length > 0) {
@@ -251,12 +270,20 @@ const initIntlayer = async (rootDir, options) => {
 	}
 	const format = hasTsConfig ? "intlayer.config.ts" : "intlayer.config.mjs";
 	const detectedPattern = await detectJsonLocalePattern(rootDir);
-	await initConfig(format, rootDir, detectedPattern?.locales);
-	if (compatSyncConfig) {
+	await initConfig(format, rootDir, {
+		locales: detectedPattern?.locales,
+		applicationURL: getDefaultApplicationURL(allDeps)
+	});
+	if (options?.contentStrategy === "centralized") await setCompilerOutputInConfig(rootDir, "/locales/{{locale}}/{{key}}.content.json");
+	const syncConfigToInject = compatSyncConfig ?? (wantsJsonNamespaces ? {
+		format: "i18next",
+		sourceTemplate: detectedPattern?.template ?? "./locales/${locale}/${key}.json"
+	} : void 0);
+	if (syncConfigToInject) {
 		const nextIntlMessagesPattern = allDeps["next-intl"] || allDeps["@intlayer/next-intl"] || allDeps["use-intl"] || allDeps["@intlayer/use-intl"] ? await detectNextIntlMessagesPattern(rootDir) : null;
 		const sourceTemplate = linguiCatalog?.template ?? nextIntlMessagesPattern?.template ?? detectedPattern?.template;
 		const resolvedSyncConfig = {
-			...compatSyncConfig,
+			...syncConfigToInject,
 			...sourceTemplate ? { sourceTemplate } : {}
 		};
 		const syncPluginPackage = resolvedSyncConfig.plugin === "po" ? "@intlayer/sync-po-plugin" : "@intlayer/sync-json-plugin";
@@ -395,12 +422,6 @@ const initIntlayer = async (rootDir, options) => {
 			logger(`${v} Created ${colorizePath(newMetroConfigFile)} with the Intlayer Metro plugin`);
 		}
 	}
-	const isVersionGreaterOrEqual = (versionString, major) => {
-		if (!versionString || typeof versionString !== "string") return false;
-		const match = versionString.match(/^[^\d]*(\d+)/);
-		if (!match?.[1]) return false;
-		return parseInt(match[1], 10) >= major;
-	};
 	const backendIntlayerPackages = [
 		"express-intlayer",
 		"fastify-intlayer",
@@ -409,7 +430,7 @@ const initIntlayer = async (rootDir, options) => {
 	];
 	const devScript = packageJson.scripts?.dev;
 	let newDevScript;
-	if ((isNextJsProject && allDeps.next && isVersionGreaterOrEqual(allDeps.next, 16) || backendIntlayerPackages.some((pkg) => allDeps[pkg])) && !devScript.includes("intlayer watch")) newDevScript = `intlayer watch --with '${devScript}'`;
+	if (devScript && (isNextJsProject && allDeps.next && isVersionAtLeast(allDeps.next, 16) || backendIntlayerPackages.some((pkg) => allDeps[pkg])) && !devScript.includes("intlayer watch")) newDevScript = `intlayer watch --with '${devScript}'`;
 	if (newDevScript) {
 		packageJson.scripts.dev = newDevScript;
 		await writeFileToRoot(rootDir, packageJsonPath, JSON.stringify(packageJson, null, 2));
@@ -487,7 +508,9 @@ const initIntlayer = async (rootDir, options) => {
 			}
 		}
 	}
-	if (!options?.noFrameworkSetup) try {
+	const hasCompatLibrary = Boolean(compatSyncConfig || compatVitePluginConfig);
+	if (!options?.noFrameworkSetup && hasCompatLibrary) logger(`${v} Compat i18n library detected — keeping the app structure untouched (no route restructure, no provider injection)`);
+	if (!options?.noFrameworkSetup && !hasCompatLibrary) try {
 		const routingMode = options?.routingMode ?? getConfiguration({ baseDir: rootDir }).routing.mode;
 		await setupFramework({
 			rootDir,
@@ -514,5 +537,5 @@ const initIntlayer = async (rootDir, options) => {
 };
 
 //#endregion
-export { initIntlayer };
+export { getDefaultApplicationURL, initIntlayer };
 //# sourceMappingURL=index.mjs.map