@intlayer/engine 9.3.0 → 9.3.2

package/dist/cjs/init/frameworkSetup/nextAppRouter/restructure.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"restructure.cjs","names":["sep","babelTsParser"],"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/babelParser';\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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"}
+{"version":3,"file":"restructure.cjs","names":["relative","isAbsolute","sep","join","babelTsParser","resolve","dirname","readdir","mkdir","rename","fg","readFile","writeFile"],"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/babelParser';\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/cjs/init/frameworkSetup/nextAppRouter/templates.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
 //#region src/init/frameworkSetup/nextAppRouter/templates.ts
 /**
 * File templates for a fresh Next.js App Router integration. These are only

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"detect.cjs","names":["exists"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/detect.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { exists } from '../../utils/fileSystem';\n\n/** Location of the TanStack Router file-based routes directory. */\nexport type TanStackRoutesInfo = {\n  /** Routes directory relative to the root, e.g. `src/routes` or `routes`. */\n  routesDir: string;\n  /** `src` when the project uses a `src/` directory, otherwise `''`. */\n  srcDir: string;\n};\n\n/**\n * Detects the TanStack Router routes directory, preferring `src/routes` over\n * `routes`. Returns `null` when neither exists.\n */\nexport const detectTanStackRoutesDir = async (\n  rootDir: string\n): Promise<TanStackRoutesInfo | null> => {\n  if (await exists(rootDir, join('src', 'routes'))) {\n    return { routesDir: join('src', 'routes'), srcDir: 'src' };\n  }\n  if (await exists(rootDir, 'routes')) {\n    return { routesDir: 'routes', srcDir: '' };\n  }\n  return null;\n};\n\n/**\n * Returns true when the project depends on TanStack Start (`@tanstack/react-start`)\n * or, failing that, on `@tanstack/react-router` (file-based routing).\n */\nexport const hasTanStackStartDeps = (\n  allDeps: Record<string, string>\n): boolean =>\n  Boolean(\n    allDeps['@tanstack/react-start'] || allDeps['@tanstack/react-router']\n  );\n"],"mappings":";;;;;;;;;AAeA,MAAa,0BAA0B,OACrC,YACuC;CACvC,IAAI,MAAMA,qCAAO,6BAAc,OAAO,QAAQ,CAAC,GAC7C,OAAO;EAAE,+BAAgB,OAAO,QAAQ;EAAG,QAAQ;CAAM;CAE3D,IAAI,MAAMA,qCAAO,SAAS,QAAQ,GAChC,OAAO;EAAE,WAAW;EAAU,QAAQ;CAAG;CAE3C,OAAO;AACT;;;;;AAMA,MAAa,wBACX,YAEA,QACE,QAAQ,4BAA4B,QAAQ,yBAC9C"}
+{"version":3,"file":"detect.cjs","names":["exists","join"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/detect.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { exists } from '../../utils/fileSystem';\n\n/** Location of the TanStack Router file-based routes directory. */\nexport type TanStackRoutesInfo = {\n  /** Routes directory relative to the root, e.g. `src/routes` or `routes`. */\n  routesDir: string;\n  /** `src` when the project uses a `src/` directory, otherwise `''`. */\n  srcDir: string;\n};\n\n/**\n * Detects the TanStack Router routes directory, preferring `src/routes` over\n * `routes`. Returns `null` when neither exists.\n */\nexport const detectTanStackRoutesDir = async (\n  rootDir: string\n): Promise<TanStackRoutesInfo | null> => {\n  if (await exists(rootDir, join('src', 'routes'))) {\n    return { routesDir: join('src', 'routes'), srcDir: 'src' };\n  }\n  if (await exists(rootDir, 'routes')) {\n    return { routesDir: 'routes', srcDir: '' };\n  }\n  return null;\n};\n\n/**\n * Returns true when the project depends on TanStack Start (`@tanstack/react-start`)\n * or, failing that, on `@tanstack/react-router` (file-based routing).\n */\nexport const hasTanStackStartDeps = (\n  allDeps: Record<string, string>\n): boolean =>\n  Boolean(\n    allDeps['@tanstack/react-start'] || allDeps['@tanstack/react-router']\n  );\n"],"mappings":";;;;;;;;;AAeA,MAAa,0BAA0B,OACrC,YACuC;CACvC,IAAI,MAAMA,qCAAO,aAASC,gBAAK,OAAO,QAAQ,CAAC,GAC7C,OAAO;EAAE,eAAWA,gBAAK,OAAO,QAAQ;EAAG,QAAQ;CAAM;CAE3D,IAAI,MAAMD,qCAAO,SAAS,QAAQ,GAChC,OAAO;EAAE,WAAW;EAAU,QAAQ;CAAG;CAE3C,OAAO;AACT;;;;;AAMA,MAAa,wBACX,YAEA,QACE,QAAQ,4BAA4B,QAAQ,yBAC9C"}

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

@@ -21,9 +21,7 @@ const logTransformOutcome = (filePath, result) => {
 		case "already":
 			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(filePath)} already wraps the Intlayer provider`);
 			break;
-		case "skipped":
-			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not safely add the Intlayer provider to ${(0, _intlayer_config_logger.colorizePath)(filePath)} — please wrap the document's {children} with <IntlayerProvider locale={locale}> manually.`, { level: "warn" });
-			break;
+		case "skipped": (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not safely add the Intlayer provider to ${(0, _intlayer_config_logger.colorizePath)(filePath)} — please wrap the document's {children} with <IntlayerProvider locale={locale}> manually.`, { level: "warn" });
 	}
 };
 /** Transforms an existing file in place, writing it back only when changed. */
@@ -66,8 +64,8 @@ const tanStackStartAdapter = {
 		await require_init_utils_fileSystem.ensureDirectory(rootDir, localeDir);
 		await createIfMissing(rootDir, (0, node_path.join)(localeDir, `route.${scriptExtension}`), require_init_frameworkSetup_tanstackStart_templates.buildLocaleRouteTemplate(activeLocaleSegment), "locale route");
 		const existingRoot = await require_init_frameworkSetup_nextAppRouter_detect.findAppFile(rootDir, routesDir, "__root");
-		if (existingRoot) await transformExistingFile(rootDir, existingRoot, require_init_frameworkSetup_tanstackStart_transforms.wrapRootWithProvider);
-		else await createIfMissing(rootDir, (0, node_path.join)(routesDir, `__root.${scriptExtension}`), useTypeScript ? require_init_frameworkSetup_tanstackStart_templates.ROOT_TEMPLATE_TS : require_init_frameworkSetup_tanstackStart_templates.ROOT_TEMPLATE_JS, "root document");
+		if (existingRoot) await transformExistingFile(rootDir, existingRoot, (code) => require_init_frameworkSetup_tanstackStart_transforms.wrapRootWithProvider(code, activeLocaleSegment));
+		else await createIfMissing(rootDir, (0, node_path.join)(routesDir, `__root.${scriptExtension}`), useTypeScript ? require_init_frameworkSetup_tanstackStart_templates.buildRootTemplateTs(activeLocaleSegment) : require_init_frameworkSetup_tanstackStart_templates.buildRootTemplateJs(activeLocaleSegment), "root document");
 	}
 };
 

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["v","x","readFileFromRoot","writeFileToRoot","exists","hasTanStackStartDeps","detectTanStackRoutesDir","getLocaleSegment","ANSIColors","restructureRoutesIntoLocale","ensureDirectory","buildLocaleRouteTemplate","findAppFile","wrapRootWithProvider","ROOT_TEMPLATE_TS","ROOT_TEMPLATE_JS"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/index.ts"],"sourcesContent":["import { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizePath, logger, v, x } from '@intlayer/config/logger';\nimport {\n  ensureDirectory,\n  exists,\n  readFileFromRoot,\n  writeFileToRoot,\n} from '../../utils/fileSystem';\nimport { findAppFile } from '../nextAppRouter/detect';\nimport type { FrameworkAdapter, FrameworkSetupContext } from '../types';\nimport { detectTanStackRoutesDir, hasTanStackStartDeps } from './detect';\nimport { getLocaleSegment, restructureRoutesIntoLocale } from './restructure';\nimport {\n  buildLocaleRouteTemplate,\n  ROOT_TEMPLATE_JS,\n  ROOT_TEMPLATE_TS,\n} from './templates';\nimport { type TransformResult, wrapRootWithProvider } from './transforms';\n\n/** Logs the outcome of the root-document provider-wrap transform. */\nconst logTransformOutcome = (\n  filePath: string,\n  result: TransformResult\n): void => {\n  switch (result.status) {\n    case 'wrapped':\n      logger(`${v} Added Intlayer provider to ${colorizePath(filePath)}`);\n      break;\n    case 'already':\n      logger(\n        `${v} ${colorizePath(filePath)} already wraps the Intlayer provider`\n      );\n      break;\n    case 'skipped':\n      logger(\n        `${x} Could not safely add the Intlayer provider to ${colorizePath(filePath)} — please wrap the document's {children} with <IntlayerProvider locale={locale}> manually.`,\n        { level: 'warn' }\n      );\n      break;\n  }\n};\n\n/** Transforms an existing file in place, writing it back only when changed. */\nconst transformExistingFile = async (\n  rootDir: string,\n  filePath: string,\n  transform: (code: string) => TransformResult\n): Promise<void> => {\n  const code = await readFileFromRoot(rootDir, filePath);\n  const result = transform(code);\n  if (result.status === 'wrapped') {\n    await writeFileToRoot(rootDir, filePath, result.code);\n  }\n  logTransformOutcome(filePath, result);\n};\n\n/** Creates a file from a template only when it does not already exist. */\nconst createIfMissing = async (\n  rootDir: string,\n  filePath: string,\n  content: string,\n  description: string\n): Promise<boolean> => {\n  if (await exists(rootDir, filePath)) return false;\n  await writeFileToRoot(rootDir, filePath, content);\n  logger(`${v} Created ${description} ${colorizePath(filePath)}`);\n  return true;\n};\n\n/**\n * TanStack Start adapter. Restructures the file-based routes under a `{-$locale}`\n * segment, scaffolds the locale segment route, and wraps the root document with\n * the Intlayer provider — all idempotently and without overwriting user code it\n * cannot confidently transform.\n */\nexport const tanStackStartAdapter: FrameworkAdapter = {\n  name: 'TanStack Start',\n\n  detect: async ({ rootDir, allDeps }) => {\n    if (!hasTanStackStartDeps(allDeps)) return false;\n    return (await detectTanStackRoutesDir(rootDir)) !== null;\n  },\n\n  setup: async ({\n    rootDir,\n    useTypeScript,\n    routingMode,\n  }: FrameworkSetupContext) => {\n    const routesInfo = await detectTanStackRoutesDir(rootDir);\n    if (!routesInfo) return;\n\n    const { routesDir } = routesInfo;\n    const scriptExtension = useTypeScript ? 'tsx' : 'jsx';\n\n    // `prefix-all` needs the required `$locale` segment; every other mode uses\n    // the optional `{-$locale}` segment so the default locale stays prefix-free.\n    const targetLocaleSegment = getLocaleSegment(routingMode);\n\n    logger(\n      colorize('Setting up TanStack Start integration...', ANSIColors.CYAN)\n    );\n\n    // 1. Move routable route entries under the locale segment (idempotent).\n    const restructureResult = await restructureRoutesIntoLocale(\n      rootDir,\n      routesDir,\n      targetLocaleSegment\n    );\n    if (restructureResult.status === 'moved') {\n      logger(\n        `${v} Restructured routes under ${colorizePath(join(routesDir, targetLocaleSegment))}: ${restructureResult.movedEntries\n          .map((entry) => colorize(entry, ANSIColors.MAGENTA))\n          .join(', ')}`\n      );\n    } else if (restructureResult.status === 'already-structured') {\n      logger(\n        `${v} ${colorizePath(join(routesDir, restructureResult.localeSegment))} already exists, skipping restructure`\n      );\n    }\n\n    // Scaffold the locale route for the segment actually in use: a pre-existing\n    // segment (e.g. a prefix-all `$locale` the user already set up) wins over the\n    // target, so we never create a second, conflicting locale segment.\n    const activeLocaleSegment =\n      restructureResult.status === 'already-structured'\n        ? restructureResult.localeSegment\n        : targetLocaleSegment;\n\n    const localeDir = join(routesDir, activeLocaleSegment);\n    await ensureDirectory(rootDir, localeDir);\n\n    // 2. Locale segment route (`<segment>/route.tsx`) — create when absent.\n    await createIfMissing(\n      rootDir,\n      join(localeDir, `route.${scriptExtension}`),\n      buildLocaleRouteTemplate(activeLocaleSegment),\n      'locale route'\n    );\n\n    // 3. Root document — transform an existing `__root`, else scaffold one.\n    const existingRoot = await findAppFile(rootDir, routesDir, '__root');\n    if (existingRoot) {\n      await transformExistingFile(rootDir, existingRoot, wrapRootWithProvider);\n    } else {\n      await createIfMissing(\n        rootDir,\n        join(routesDir, `__root.${scriptExtension}`),\n        useTypeScript ? ROOT_TEMPLATE_TS : ROOT_TEMPLATE_JS,\n        'root document'\n      );\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAM,uBACJ,UACA,WACS;CACT,QAAQ,OAAO,QAAf;EACE,KAAK;GACH,oCAAO,GAAGA,0BAAE,wEAA2C,QAAQ,GAAG;GAClE;EACF,KAAK;GACH,oCACE,GAAGA,0BAAE,6CAAgB,QAAQ,EAAE,qCACjC;GACA;EACF,KAAK;GACH,oCACE,GAAGC,0BAAE,2FAA8D,QAAQ,EAAE,6FAC7E,EAAE,OAAO,OAAO,CAClB;GACA;CACJ;AACF;;AAGA,MAAM,wBAAwB,OAC5B,SACA,UACA,cACkB;CAElB,MAAM,SAAS,UAAU,MADNC,+CAAiB,SAAS,QAAQ,CACxB;CAC7B,IAAI,OAAO,WAAW,WACpB,MAAMC,8CAAgB,SAAS,UAAU,OAAO,IAAI;CAEtD,oBAAoB,UAAU,MAAM;AACtC;;AAGA,MAAM,kBAAkB,OACtB,SACA,UACA,SACA,gBACqB;CACrB,IAAI,MAAMC,qCAAO,SAAS,QAAQ,GAAG,OAAO;CAC5C,MAAMD,8CAAgB,SAAS,UAAU,OAAO;CAChD,oCAAO,GAAGH,0BAAE,WAAW,YAAY,6CAAgB,QAAQ,GAAG;CAC9D,OAAO;AACT;;;;;;;AAQA,MAAa,uBAAyC;CACpD,MAAM;CAEN,QAAQ,OAAO,EAAE,SAAS,cAAc;EACtC,IAAI,CAACK,sEAAqB,OAAO,GAAG,OAAO;EAC3C,OAAQ,MAAMC,yEAAwB,OAAO,MAAO;CACtD;CAEA,OAAO,OAAO,EACZ,SACA,eACA,kBAC2B;EAC3B,MAAM,aAAa,MAAMA,yEAAwB,OAAO;EACxD,IAAI,CAAC,YAAY;EAEjB,MAAM,EAAE,cAAc;EACtB,MAAM,kBAAkB,gBAAgB,QAAQ;EAIhD,MAAM,sBAAsBC,uEAAiB,WAAW;EAExD,0EACW,4CAA4CC,wBAAW,IAAI,CACtE;EAGA,MAAM,oBAAoB,MAAMC,kFAC9B,SACA,WACA,mBACF;EACA,IAAI,kBAAkB,WAAW,SAC/B,oCACE,GAAGT,0BAAE,2FAA+C,WAAW,mBAAmB,CAAC,EAAE,IAAI,kBAAkB,aACxG,KAAK,gDAAmB,OAAOQ,wBAAW,OAAO,CAAC,CAAC,CACnD,KAAK,IAAI,GACd;OACK,IAAI,kBAAkB,WAAW,sBACtC,oCACE,GAAGR,0BAAE,iEAAqB,WAAW,kBAAkB,aAAa,CAAC,EAAE,sCACzE;EAMF,MAAM,sBACJ,kBAAkB,WAAW,uBACzB,kBAAkB,gBAClB;EAEN,MAAM,gCAAiB,WAAW,mBAAmB;EACrD,MAAMU,8CAAgB,SAAS,SAAS;EAGxC,MAAM,gBACJ,6BACK,WAAW,SAAS,iBAAiB,GAC1CC,6EAAyB,mBAAmB,GAC5C,cACF;EAGA,MAAM,eAAe,MAAMC,6DAAY,SAAS,WAAW,QAAQ;EACnE,IAAI,cACF,MAAM,sBAAsB,SAAS,cAAcC,yEAAoB;OAEvE,MAAM,gBACJ,6BACK,WAAW,UAAU,iBAAiB,GAC3C,gBAAgBC,uEAAmBC,sEACnC,eACF;CAEJ;AACF"}
+{"version":3,"file":"index.cjs","names":["v","colorizePath","x","readFileFromRoot","writeFileToRoot","exists","hasTanStackStartDeps","detectTanStackRoutesDir","getLocaleSegment","colorize","ANSIColors","restructureRoutesIntoLocale","join","ensureDirectory","buildLocaleRouteTemplate","findAppFile","wrapRootWithProvider","buildRootTemplateTs","buildRootTemplateJs"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/index.ts"],"sourcesContent":["import { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizePath, logger, v, x } from '@intlayer/config/logger';\nimport {\n  ensureDirectory,\n  exists,\n  readFileFromRoot,\n  writeFileToRoot,\n} from '../../utils/fileSystem';\nimport { findAppFile } from '../nextAppRouter/detect';\nimport type { FrameworkAdapter, FrameworkSetupContext } from '../types';\nimport { detectTanStackRoutesDir, hasTanStackStartDeps } from './detect';\nimport { getLocaleSegment, restructureRoutesIntoLocale } from './restructure';\nimport {\n  buildLocaleRouteTemplate,\n  buildRootTemplateJs,\n  buildRootTemplateTs,\n} from './templates';\nimport { type TransformResult, wrapRootWithProvider } from './transforms';\n\n/** Logs the outcome of the root-document provider-wrap transform. */\nconst logTransformOutcome = (\n  filePath: string,\n  result: TransformResult\n): void => {\n  switch (result.status) {\n    case 'wrapped':\n      logger(`${v} Added Intlayer provider to ${colorizePath(filePath)}`);\n      break;\n    case 'already':\n      logger(\n        `${v} ${colorizePath(filePath)} already wraps the Intlayer provider`\n      );\n      break;\n    case 'skipped':\n      logger(\n        `${x} Could not safely add the Intlayer provider to ${colorizePath(filePath)} — please wrap the document's {children} with <IntlayerProvider locale={locale}> manually.`,\n        { level: 'warn' }\n      );\n      break;\n  }\n};\n\n/** Transforms an existing file in place, writing it back only when changed. */\nconst transformExistingFile = async (\n  rootDir: string,\n  filePath: string,\n  transform: (code: string) => TransformResult\n): Promise<void> => {\n  const code = await readFileFromRoot(rootDir, filePath);\n  const result = transform(code);\n  if (result.status === 'wrapped') {\n    await writeFileToRoot(rootDir, filePath, result.code);\n  }\n  logTransformOutcome(filePath, result);\n};\n\n/** Creates a file from a template only when it does not already exist. */\nconst createIfMissing = async (\n  rootDir: string,\n  filePath: string,\n  content: string,\n  description: string\n): Promise<boolean> => {\n  if (await exists(rootDir, filePath)) return false;\n  await writeFileToRoot(rootDir, filePath, content);\n  logger(`${v} Created ${description} ${colorizePath(filePath)}`);\n  return true;\n};\n\n/**\n * TanStack Start adapter. Restructures the file-based routes under a `{-$locale}`\n * segment, scaffolds the locale segment route, and wraps the root document with\n * the Intlayer provider — all idempotently and without overwriting user code it\n * cannot confidently transform.\n */\nexport const tanStackStartAdapter: FrameworkAdapter = {\n  name: 'TanStack Start',\n\n  detect: async ({ rootDir, allDeps }) => {\n    if (!hasTanStackStartDeps(allDeps)) return false;\n    return (await detectTanStackRoutesDir(rootDir)) !== null;\n  },\n\n  setup: async ({\n    rootDir,\n    useTypeScript,\n    routingMode,\n  }: FrameworkSetupContext) => {\n    const routesInfo = await detectTanStackRoutesDir(rootDir);\n    if (!routesInfo) return;\n\n    const { routesDir } = routesInfo;\n    const scriptExtension = useTypeScript ? 'tsx' : 'jsx';\n\n    // `prefix-all` needs the required `$locale` segment; every other mode uses\n    // the optional `{-$locale}` segment so the default locale stays prefix-free.\n    const targetLocaleSegment = getLocaleSegment(routingMode);\n\n    logger(\n      colorize('Setting up TanStack Start integration...', ANSIColors.CYAN)\n    );\n\n    // 1. Move routable route entries under the locale segment (idempotent).\n    const restructureResult = await restructureRoutesIntoLocale(\n      rootDir,\n      routesDir,\n      targetLocaleSegment\n    );\n    if (restructureResult.status === 'moved') {\n      logger(\n        `${v} Restructured routes under ${colorizePath(join(routesDir, targetLocaleSegment))}: ${restructureResult.movedEntries\n          .map((entry) => colorize(entry, ANSIColors.MAGENTA))\n          .join(', ')}`\n      );\n    } else if (restructureResult.status === 'already-structured') {\n      logger(\n        `${v} ${colorizePath(join(routesDir, restructureResult.localeSegment))} already exists, skipping restructure`\n      );\n    }\n\n    // Scaffold the locale route for the segment actually in use: a pre-existing\n    // segment (e.g. a prefix-all `$locale` the user already set up) wins over the\n    // target, so we never create a second, conflicting locale segment.\n    const activeLocaleSegment =\n      restructureResult.status === 'already-structured'\n        ? restructureResult.localeSegment\n        : targetLocaleSegment;\n\n    const localeDir = join(routesDir, activeLocaleSegment);\n    await ensureDirectory(rootDir, localeDir);\n\n    // 2. Locale segment route (`<segment>/route.tsx`) — create when absent.\n    await createIfMissing(\n      rootDir,\n      join(localeDir, `route.${scriptExtension}`),\n      buildLocaleRouteTemplate(activeLocaleSegment),\n      'locale route'\n    );\n\n    // 3. Root document — transform an existing `__root`, else scaffold one.\n    const existingRoot = await findAppFile(rootDir, routesDir, '__root');\n    if (existingRoot) {\n      await transformExistingFile(rootDir, existingRoot, (code) =>\n        wrapRootWithProvider(code, activeLocaleSegment)\n      );\n    } else {\n      await createIfMissing(\n        rootDir,\n        join(routesDir, `__root.${scriptExtension}`),\n        useTypeScript\n          ? buildRootTemplateTs(activeLocaleSegment)\n          : buildRootTemplateJs(activeLocaleSegment),\n        'root document'\n      );\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAM,uBACJ,UACA,WACS;CACT,QAAQ,OAAO,QAAf;EACE,KAAK;GACH,oCAAO,GAAGA,0BAAE,kCAA8BC,sCAAa,QAAQ,GAAG;GAClE;EACF,KAAK;GACH,oCACE,GAAGD,0BAAE,OAAGC,sCAAa,QAAQ,EAAE,qCACjC;GACA;EACF,KAAK,WACH,oCACE,GAAGC,0BAAE,qDAAiDD,sCAAa,QAAQ,EAAE,6FAC7E,EAAE,OAAO,OAAO,CAClB;CAEJ;AACF;;AAGA,MAAM,wBAAwB,OAC5B,SACA,UACA,cACkB;CAElB,MAAM,SAAS,UAAU,MADNE,+CAAiB,SAAS,QAAQ,CACxB;CAC7B,IAAI,OAAO,WAAW,WACpB,MAAMC,8CAAgB,SAAS,UAAU,OAAO,IAAI;CAEtD,oBAAoB,UAAU,MAAM;AACtC;;AAGA,MAAM,kBAAkB,OACtB,SACA,UACA,SACA,gBACqB;CACrB,IAAI,MAAMC,qCAAO,SAAS,QAAQ,GAAG,OAAO;CAC5C,MAAMD,8CAAgB,SAAS,UAAU,OAAO;CAChD,oCAAO,GAAGJ,0BAAE,WAAW,YAAY,OAAGC,sCAAa,QAAQ,GAAG;CAC9D,OAAO;AACT;;;;;;;AAQA,MAAa,uBAAyC;CACpD,MAAM;CAEN,QAAQ,OAAO,EAAE,SAAS,cAAc;EACtC,IAAI,CAACK,sEAAqB,OAAO,GAAG,OAAO;EAC3C,OAAQ,MAAMC,yEAAwB,OAAO,MAAO;CACtD;CAEA,OAAO,OAAO,EACZ,SACA,eACA,kBAC2B;EAC3B,MAAM,aAAa,MAAMA,yEAAwB,OAAO;EACxD,IAAI,CAAC,YAAY;EAEjB,MAAM,EAAE,cAAc;EACtB,MAAM,kBAAkB,gBAAgB,QAAQ;EAIhD,MAAM,sBAAsBC,uEAAiB,WAAW;EAExD,wCACEC,kCAAS,4CAA4CC,wBAAW,IAAI,CACtE;EAGA,MAAM,oBAAoB,MAAMC,kFAC9B,SACA,WACA,mBACF;EACA,IAAI,kBAAkB,WAAW,SAC/B,oCACE,GAAGX,0BAAE,iCAA6BC,0CAAaW,gBAAK,WAAW,mBAAmB,CAAC,EAAE,IAAI,kBAAkB,aACxG,KAAK,cAAUH,kCAAS,OAAOC,wBAAW,OAAO,CAAC,CAAC,CACnD,KAAK,IAAI,GACd;OACK,IAAI,kBAAkB,WAAW,sBACtC,oCACE,GAAGV,0BAAE,OAAGC,0CAAaW,gBAAK,WAAW,kBAAkB,aAAa,CAAC,EAAE,sCACzE;EAMF,MAAM,sBACJ,kBAAkB,WAAW,uBACzB,kBAAkB,gBAClB;EAEN,MAAM,gBAAYA,gBAAK,WAAW,mBAAmB;EACrD,MAAMC,8CAAgB,SAAS,SAAS;EAGxC,MAAM,gBACJ,aACAD,gBAAK,WAAW,SAAS,iBAAiB,GAC1CE,6EAAyB,mBAAmB,GAC5C,cACF;EAGA,MAAM,eAAe,MAAMC,6DAAY,SAAS,WAAW,QAAQ;EACnE,IAAI,cACF,MAAM,sBAAsB,SAAS,eAAe,SAClDC,0EAAqB,MAAM,mBAAmB,CAChD;OAEA,MAAM,gBACJ,aACAJ,gBAAK,WAAW,UAAU,iBAAiB,GAC3C,gBACIK,wEAAoB,mBAAmB,IACvCC,wEAAoB,mBAAmB,GAC3C,eACF;CAEJ;AACF"}

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

@@ -95,7 +95,8 @@ const restructureRoutesIntoLocale = async (rootDir, routesDir, localeSegment = L
 		movedTopLevelNames
 	};
 	for (const newAbs of movedFiles) {
-		const oldAbs = (0, node_path.join)(routesDirAbs, (0, node_path.relative)(localeDirAbs, newAbs));
+		const relFromLocale = (0, node_path.relative)(localeDirAbs, newAbs);
+		const oldAbs = (0, node_path.join)(routesDirAbs, relFromLocale);
 		const code = await (0, node_fs_promises.readFile)(newAbs, "utf8");
 		const rewritten = require_init_frameworkSetup_nextAppRouter_restructure.rewriteRelativeImports(code, oldAbs, newAbs, rewriteContext);
 		if (rewritten !== code) await (0, node_fs_promises.writeFile)(newAbs, rewritten, "utf8");

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

@@ -1 +1 @@
-{"version":3,"file":"restructure.cjs","names":["rewriteRelativeImports"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/restructure.ts"],"sourcesContent":["import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport fg from 'fast-glob';\nimport type { RoutingMode } from '../../utils/configManipulation';\nimport { rewriteRelativeImports } from '../nextAppRouter/restructure';\n\n/** Source file extensions whose relative imports must be rewritten after a move. */\nconst SCRIPT_GLOB = '**/*.{ts,tsx,js,jsx,mjs,cjs}';\n\n/**\n * The optional TanStack Router locale segment directory (`{-$locale}` param),\n * used by every routing mode except `prefix-all` so the default locale stays\n * prefix-free.\n */\nexport const LOCALE_SEGMENT = '{-$locale}';\n\n/**\n * The required TanStack Router locale segment directory (`$locale` param), used\n * by `prefix-all` routing where every URL — including the default locale — is\n * prefixed.\n */\nexport const PREFIX_ALL_LOCALE_SEGMENT = '$locale';\n\n/**\n * Picks the locale segment directory for the project's routing mode. `prefix-all`\n * requires the mandatory `$locale` param so the default locale is also prefixed;\n * all other modes use the optional `{-$locale}` param so the default locale stays\n * prefix-free.\n */\nexport const getLocaleSegment = (routingMode: RoutingMode): string =>\n  routingMode === 'prefix-all' ? PREFIX_ALL_LOCALE_SEGMENT : LOCALE_SEGMENT;\n\n/**\n * Detects whether a top-level route entry is already a locale segment, in any of\n * the TanStack Router param forms:\n * - `{-$locale}` — optional param (prefix every locale except the default),\n * - `$locale` / `{$locale}` — required param (prefix **all** locales).\n *\n * Used to skip the restructure when the project is already locale-aware, so an\n * existing prefix-all `$locale` directory is never nested under a freshly created\n * `{-$locale}` (which would produce `{-$locale}/$locale`).\n */\nexport const isLocaleSegment = (entryName: string): boolean =>\n  /^(\\{-?\\$locale\\}|\\$locale)$/.test(entryName);\n\n/** Strips a known script extension from a file name, e.g. `index.tsx` -> `index`. */\nconst stripScriptExtension = (fileName: string): string =>\n  fileName.replace(/\\.(tsx|ts|jsx|js|mjs|cjs)$/, '');\n\n/**\n * Routes-directory entries that must stay at the root and never be moved under\n * `{-$locale}`:\n * - `__root` (the root route document),\n * - `routeTree.gen` (generated route tree),\n * - `api` (server / API routes — these are not locale-prefixed),\n * - TanStack-ignored entries prefixed with `-` (e.g. `-components`, `-utils`),\n * - stylesheets.\n *\n * Everything else (route files and nested route folders) is moved so it becomes\n * locale-aware.\n */\nexport const shouldKeepRouteAtRoot = (entryName: string): boolean => {\n  if (entryName.startsWith('-')) return true;\n  if (entryName.toLowerCase().endsWith('.css')) return true;\n\n  const base = stripScriptExtension(entryName);\n  const keepExactBases = new Set(['__root', 'routeTree.gen', 'api']);\n  return keepExactBases.has(base);\n};\n\n/** Outcome of an attempted `{-$locale}` restructure. */\nexport type RestructureResult =\n  | { status: 'already-structured'; localeSegment: string }\n  | { status: 'nothing-to-move' }\n  | { status: 'moved'; movedEntries: string[] };\n\n/**\n * Moves the routable entries of `routesDir` under a new `localeSegment` directory\n * (the optional `{-$locale}` by default, or the required `$locale` for\n * `prefix-all`) and rewrites relative imports in the moved files. Idempotent: a\n * no-op when the routes are already locale-aware in any prefix mode (see\n * {@link isLocaleSegment}), which is reported via `localeSegment`. Root-only\n * files (see {@link shouldKeepRouteAtRoot}) are left in place.\n */\nexport const restructureRoutesIntoLocale = async (\n  rootDir: string,\n  routesDir: string,\n  localeSegment: string = LOCALE_SEGMENT\n): Promise<RestructureResult> => {\n  const routesDirAbs = join(rootDir, routesDir);\n  const localeDirAbs = join(routesDirAbs, localeSegment);\n\n  const entries = await readdir(routesDirAbs, { withFileTypes: true });\n\n  // Skip when the routes are already locale-aware in any prefix mode — a fresh\n  // `{-$locale}`, or an existing `$locale` / `{$locale}` (prefix-all) segment.\n  const existingLocaleSegment = entries.find((entry) =>\n    isLocaleSegment(entry.name)\n  );\n  if (existingLocaleSegment) {\n    return {\n      status: 'already-structured',\n      localeSegment: existingLocaleSegment.name,\n    };\n  }\n\n  const movedTopLevelNames = entries\n    .map((entry) => entry.name)\n    .filter((name) => !shouldKeepRouteAtRoot(name));\n\n  if (movedTopLevelNames.length === 0) {\n    return { status: 'nothing-to-move' };\n  }\n\n  await mkdir(localeDirAbs, { recursive: true });\n\n  for (const name of movedTopLevelNames) {\n    await rename(join(routesDirAbs, name), join(localeDirAbs, name));\n  }\n\n  const movedFiles = await fg(SCRIPT_GLOB, {\n    cwd: localeDirAbs,\n    absolute: true,\n    onlyFiles: true,\n  });\n\n  const rewriteContext = {\n    appDirAbs: routesDirAbs,\n    localeDirAbs,\n    movedTopLevelNames,\n  };\n\n  for (const newAbs of movedFiles) {\n    const relFromLocale = relative(localeDirAbs, newAbs);\n    const oldAbs = join(routesDirAbs, relFromLocale);\n    const code = await readFile(newAbs, 'utf8');\n    const rewritten = rewriteRelativeImports(\n      code,\n      oldAbs,\n      newAbs,\n      rewriteContext\n    );\n    if (rewritten !== code) {\n      await writeFile(newAbs, rewritten, 'utf8');\n    }\n  }\n\n  return { status: 'moved', movedEntries: movedTopLevelNames };\n};\n"],"mappings":";;;;;;;;;;AAOA,MAAM,cAAc;;;;;;AAOpB,MAAa,iBAAiB;;;;;;AAO9B,MAAa,4BAA4B;;;;;;;AAQzC,MAAa,oBAAoB,gBAC/B,gBAAgB,eAAe,4BAA4B;;;;;;;;;;;AAY7D,MAAa,mBAAmB,cAC9B,8BAA8B,KAAK,SAAS;;AAG9C,MAAM,wBAAwB,aAC5B,SAAS,QAAQ,8BAA8B,EAAE;;;;;;;;;;;;;AAcnD,MAAa,yBAAyB,cAA+B;CACnE,IAAI,UAAU,WAAW,GAAG,GAAG,OAAO;CACtC,IAAI,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO;CAErD,MAAM,OAAO,qBAAqB,SAAS;CAE3C,wBAAO,IADoB,IAAI;EAAC;EAAU;EAAiB;CAAK,CAC5C,EAAC,CAAC,IAAI,IAAI;AAChC;;;;;;;;;AAgBA,MAAa,8BAA8B,OACzC,SACA,WACA,gBAAwB,mBACO;CAC/B,MAAM,mCAAoB,SAAS,SAAS;CAC5C,MAAM,mCAAoB,cAAc,aAAa;CAErD,MAAM,UAAU,oCAAc,cAAc,EAAE,eAAe,KAAK,CAAC;CAInE,MAAM,wBAAwB,QAAQ,MAAM,UAC1C,gBAAgB,MAAM,IAAI,CAC5B;CACA,IAAI,uBACF,OAAO;EACL,QAAQ;EACR,eAAe,sBAAsB;CACvC;CAGF,MAAM,qBAAqB,QACxB,KAAK,UAAU,MAAM,IAAI,CAAC,CAC1B,QAAQ,SAAS,CAAC,sBAAsB,IAAI,CAAC;CAEhD,IAAI,mBAAmB,WAAW,GAChC,OAAO,EAAE,QAAQ,kBAAkB;CAGrC,kCAAY,cAAc,EAAE,WAAW,KAAK,CAAC;CAE7C,KAAK,MAAM,QAAQ,oBACjB,uDAAkB,cAAc,IAAI,uBAAQ,cAAc,IAAI,CAAC;CAGjE,MAAM,aAAa,6BAAS,aAAa;EACvC,KAAK;EACL,UAAU;EACV,WAAW;CACb,CAAC;CAED,MAAM,iBAAiB;EACrB,WAAW;EACX;EACA;CACF;CAEA,KAAK,MAAM,UAAU,YAAY;EAE/B,MAAM,6BAAc,sCADW,cAAc,MACC,CAAC;EAC/C,MAAM,OAAO,qCAAe,QAAQ,MAAM;EAC1C,MAAM,YAAYA,6EAChB,MACA,QACA,QACA,cACF;EACA,IAAI,cAAc,MAChB,sCAAgB,QAAQ,WAAW,MAAM;CAE7C;CAEA,OAAO;EAAE,QAAQ;EAAS,cAAc;CAAmB;AAC7D"}
+{"version":3,"file":"restructure.cjs","names":["join","readdir","mkdir","rename","fg","relative","readFile","rewriteRelativeImports","writeFile"],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/restructure.ts"],"sourcesContent":["import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport fg from 'fast-glob';\nimport type { RoutingMode } from '../../utils/configManipulation';\nimport { rewriteRelativeImports } from '../nextAppRouter/restructure';\n\n/** Source file extensions whose relative imports must be rewritten after a move. */\nconst SCRIPT_GLOB = '**/*.{ts,tsx,js,jsx,mjs,cjs}';\n\n/**\n * The optional TanStack Router locale segment directory (`{-$locale}` param),\n * used by every routing mode except `prefix-all` so the default locale stays\n * prefix-free.\n */\nexport const LOCALE_SEGMENT = '{-$locale}';\n\n/**\n * The required TanStack Router locale segment directory (`$locale` param), used\n * by `prefix-all` routing where every URL — including the default locale — is\n * prefixed.\n */\nexport const PREFIX_ALL_LOCALE_SEGMENT = '$locale';\n\n/**\n * Picks the locale segment directory for the project's routing mode. `prefix-all`\n * requires the mandatory `$locale` param so the default locale is also prefixed;\n * all other modes use the optional `{-$locale}` param so the default locale stays\n * prefix-free.\n */\nexport const getLocaleSegment = (routingMode: RoutingMode): string =>\n  routingMode === 'prefix-all' ? PREFIX_ALL_LOCALE_SEGMENT : LOCALE_SEGMENT;\n\n/**\n * Detects whether a top-level route entry is already a locale segment, in any of\n * the TanStack Router param forms:\n * - `{-$locale}` — optional param (prefix every locale except the default),\n * - `$locale` / `{$locale}` — required param (prefix **all** locales).\n *\n * Used to skip the restructure when the project is already locale-aware, so an\n * existing prefix-all `$locale` directory is never nested under a freshly created\n * `{-$locale}` (which would produce `{-$locale}/$locale`).\n */\nexport const isLocaleSegment = (entryName: string): boolean =>\n  /^(\\{-?\\$locale\\}|\\$locale)$/.test(entryName);\n\n/** Strips a known script extension from a file name, e.g. `index.tsx` -> `index`. */\nconst stripScriptExtension = (fileName: string): string =>\n  fileName.replace(/\\.(tsx|ts|jsx|js|mjs|cjs)$/, '');\n\n/**\n * Routes-directory entries that must stay at the root and never be moved under\n * `{-$locale}`:\n * - `__root` (the root route document),\n * - `routeTree.gen` (generated route tree),\n * - `api` (server / API routes — these are not locale-prefixed),\n * - TanStack-ignored entries prefixed with `-` (e.g. `-components`, `-utils`),\n * - stylesheets.\n *\n * Everything else (route files and nested route folders) is moved so it becomes\n * locale-aware.\n */\nexport const shouldKeepRouteAtRoot = (entryName: string): boolean => {\n  if (entryName.startsWith('-')) return true;\n  if (entryName.toLowerCase().endsWith('.css')) return true;\n\n  const base = stripScriptExtension(entryName);\n  const keepExactBases = new Set(['__root', 'routeTree.gen', 'api']);\n  return keepExactBases.has(base);\n};\n\n/** Outcome of an attempted `{-$locale}` restructure. */\nexport type RestructureResult =\n  | { status: 'already-structured'; localeSegment: string }\n  | { status: 'nothing-to-move' }\n  | { status: 'moved'; movedEntries: string[] };\n\n/**\n * Moves the routable entries of `routesDir` under a new `localeSegment` directory\n * (the optional `{-$locale}` by default, or the required `$locale` for\n * `prefix-all`) and rewrites relative imports in the moved files. Idempotent: a\n * no-op when the routes are already locale-aware in any prefix mode (see\n * {@link isLocaleSegment}), which is reported via `localeSegment`. Root-only\n * files (see {@link shouldKeepRouteAtRoot}) are left in place.\n */\nexport const restructureRoutesIntoLocale = async (\n  rootDir: string,\n  routesDir: string,\n  localeSegment: string = LOCALE_SEGMENT\n): Promise<RestructureResult> => {\n  const routesDirAbs = join(rootDir, routesDir);\n  const localeDirAbs = join(routesDirAbs, localeSegment);\n\n  const entries = await readdir(routesDirAbs, { withFileTypes: true });\n\n  // Skip when the routes are already locale-aware in any prefix mode — a fresh\n  // `{-$locale}`, or an existing `$locale` / `{$locale}` (prefix-all) segment.\n  const existingLocaleSegment = entries.find((entry) =>\n    isLocaleSegment(entry.name)\n  );\n  if (existingLocaleSegment) {\n    return {\n      status: 'already-structured',\n      localeSegment: existingLocaleSegment.name,\n    };\n  }\n\n  const movedTopLevelNames = entries\n    .map((entry) => entry.name)\n    .filter((name) => !shouldKeepRouteAtRoot(name));\n\n  if (movedTopLevelNames.length === 0) {\n    return { status: 'nothing-to-move' };\n  }\n\n  await mkdir(localeDirAbs, { recursive: true });\n\n  for (const name of movedTopLevelNames) {\n    await rename(join(routesDirAbs, name), join(localeDirAbs, name));\n  }\n\n  const movedFiles = await fg(SCRIPT_GLOB, {\n    cwd: localeDirAbs,\n    absolute: true,\n    onlyFiles: true,\n  });\n\n  const rewriteContext = {\n    appDirAbs: routesDirAbs,\n    localeDirAbs,\n    movedTopLevelNames,\n  };\n\n  for (const newAbs of movedFiles) {\n    const relFromLocale = relative(localeDirAbs, newAbs);\n    const oldAbs = join(routesDirAbs, relFromLocale);\n    const code = await readFile(newAbs, 'utf8');\n    const rewritten = rewriteRelativeImports(\n      code,\n      oldAbs,\n      newAbs,\n      rewriteContext\n    );\n    if (rewritten !== code) {\n      await writeFile(newAbs, rewritten, 'utf8');\n    }\n  }\n\n  return { status: 'moved', movedEntries: movedTopLevelNames };\n};\n"],"mappings":";;;;;;;;;;AAOA,MAAM,cAAc;;;;;;AAOpB,MAAa,iBAAiB;;;;;;AAO9B,MAAa,4BAA4B;;;;;;;AAQzC,MAAa,oBAAoB,gBAC/B,gBAAgB,eAAe,4BAA4B;;;;;;;;;;;AAY7D,MAAa,mBAAmB,cAC9B,8BAA8B,KAAK,SAAS;;AAG9C,MAAM,wBAAwB,aAC5B,SAAS,QAAQ,8BAA8B,EAAE;;;;;;;;;;;;;AAcnD,MAAa,yBAAyB,cAA+B;CACnE,IAAI,UAAU,WAAW,GAAG,GAAG,OAAO;CACtC,IAAI,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO;CAErD,MAAM,OAAO,qBAAqB,SAAS;CAE3C,wBAAO,IADoB,IAAI;EAAC;EAAU;EAAiB;CAAK,CAC5C,EAAC,CAAC,IAAI,IAAI;AAChC;;;;;;;;;AAgBA,MAAa,8BAA8B,OACzC,SACA,WACA,gBAAwB,mBACO;CAC/B,MAAM,mBAAeA,gBAAK,SAAS,SAAS;CAC5C,MAAM,mBAAeA,gBAAK,cAAc,aAAa;CAErD,MAAM,UAAU,UAAMC,0BAAQ,cAAc,EAAE,eAAe,KAAK,CAAC;CAInE,MAAM,wBAAwB,QAAQ,MAAM,UAC1C,gBAAgB,MAAM,IAAI,CAC5B;CACA,IAAI,uBACF,OAAO;EACL,QAAQ;EACR,eAAe,sBAAsB;CACvC;CAGF,MAAM,qBAAqB,QACxB,KAAK,UAAU,MAAM,IAAI,CAAC,CAC1B,QAAQ,SAAS,CAAC,sBAAsB,IAAI,CAAC;CAEhD,IAAI,mBAAmB,WAAW,GAChC,OAAO,EAAE,QAAQ,kBAAkB;CAGrC,UAAMC,wBAAM,cAAc,EAAE,WAAW,KAAK,CAAC;CAE7C,KAAK,MAAM,QAAQ,oBACjB,UAAMC,6BAAOH,gBAAK,cAAc,IAAI,OAAGA,gBAAK,cAAc,IAAI,CAAC;CAGjE,MAAM,aAAa,UAAMI,mBAAG,aAAa;EACvC,KAAK;EACL,UAAU;EACV,WAAW;CACb,CAAC;CAED,MAAM,iBAAiB;EACrB,WAAW;EACX;EACA;CACF;CAEA,KAAK,MAAM,UAAU,YAAY;EAC/B,MAAM,oBAAgBC,oBAAS,cAAc,MAAM;EACnD,MAAM,aAASL,gBAAK,cAAc,aAAa;EAC/C,MAAM,OAAO,UAAMM,2BAAS,QAAQ,MAAM;EAC1C,MAAM,YAAYC,6EAChB,MACA,QACA,QACA,cACF;EACA,IAAI,cAAc,MAChB,UAAMC,4BAAU,QAAQ,WAAW,MAAM;CAE7C;CAEA,OAAO;EAAE,QAAQ;EAAS,cAAc;CAAmB;AAC7D"}

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

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

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

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

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

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

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

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