@intlayer/engine 9.0.0-canary.12

package/dist/esm/init/utils/configManipulation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManipulation.mjs","names":[],"sources":["../../../../src/init/utils/configManipulation.ts"],"sourcesContent":["import type { RoutingConfig } from '@intlayer/types/config';\nimport * as recast from 'recast';\nimport { isModuleScopeBinding } from './astImports';\nimport type {\n  CompatSyncConfig,\n  CompatVitePluginConfig,\n} from './packageManager';\n\nconst { builders: b, namedTypes: n } = recast.types;\n\n/** The locale routing strategies supported by the Intlayer configuration. */\nexport type RoutingMode = RoutingConfig['mode'];\n\n/** Narrows an arbitrary recast node to an object expression. */\nconst isObjectExpression = (node: any): boolean =>\n  Boolean(node) &&\n  (node.type === 'ObjectExpression' || n.ObjectExpression.check(node));\n\n/**\n * Finds a property by key name on an object expression, creating it with the\n * provided default value node when it is absent. Returns the property node so\n * callers can read or mutate its value while preserving any attached comments.\n */\nconst ensureObjectProperty = (\n  objExpr: any,\n  key: string,\n  defaultValueNode: any\n): any => {\n  let property = (objExpr.properties as any[]).find((prop: any) => {\n    if (!prop?.key) return false;\n    return (prop.key.name ?? prop.key.value) === key;\n  });\n\n  if (!property) {\n    property = b.property('init', b.identifier(key), defaultValueNode);\n    (objExpr.properties as any[]).push(property);\n  }\n\n  return property;\n};\n\n/**\n * Sets (or replaces) a property's value on an object expression. When the\n * property already exists only its value node is swapped, which keeps the\n * leading documentation comment in place.\n */\nconst setObjectPropertyValue = (\n  objExpr: any,\n  key: string,\n  valueNode: any\n): void => {\n  const property = (objExpr.properties as any[]).find((prop: any) => {\n    if (!prop?.key) return false;\n    return (prop.key.name ?? prop.key.value) === key;\n  });\n\n  if (property) {\n    property.value = valueNode;\n    return;\n  }\n\n  (objExpr.properties as any[]).push(\n    b.property('init', b.identifier(key), valueNode)\n  );\n};\n\n/**\n * Adds a `process.env.<envVar>` reference property to an object expression when\n * the property is not already present. Existing values are left untouched.\n */\nconst addEnvReferenceProperty = (\n  objExpr: any,\n  key: string,\n  envVar: string\n): void => {\n  const hasProperty = (objExpr.properties as any[]).some((prop: any) => {\n    if (!prop?.key) return false;\n    return (prop.key.name ?? prop.key.value) === key;\n  });\n\n  if (hasProperty) return;\n\n  (objExpr.properties as any[]).push(\n    b.property(\n      'init',\n      b.identifier(key),\n      b.memberExpression(\n        b.memberExpression(b.identifier('process'), b.identifier('env')),\n        b.identifier(envVar)\n      )\n    )\n  );\n};\n\n/**\n * Sets `routing.mode` in an Intlayer configuration file to the requested\n * strategy. Idempotent: re-running with the same mode produces identical\n * output. Supports `.ts`, `.mjs`, `.js` and `.cjs` configs; JSON configs are\n * handled with a scoped string replacement since they cannot be parsed by the\n * TypeScript recast parser.\n */\nexport const setIntlayerConfigRoutingMode = (\n  content: string,\n  extension: string,\n  mode: RoutingMode\n): string => {\n  if (extension === 'json') {\n    return content.replace(\n      /(\"mode\"\\s*:\\s*)\"(?:prefix-no-default|prefix-all|no-prefix|search-params)\"/,\n      `$1\"${mode}\"`\n    );\n  }\n\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  genericRecastVisit(ast, (objExpr) => {\n    if (!isObjectExpression(objExpr)) return;\n\n    const routingProperty = ensureObjectProperty(\n      objExpr,\n      'routing',\n      b.objectExpression([])\n    );\n\n    if (!isObjectExpression(routingProperty.value)) return;\n\n    setObjectPropertyValue(\n      routingProperty.value,\n      'mode',\n      b.stringLiteral(mode)\n    );\n  });\n\n  return recast.print(ast).code;\n};\n\n/**\n * Enables the Intlayer visual editor in a configuration file: sets\n * `editor.enabled` to `true` and wires `clientId` / `clientSecret` to the\n * `INTLAYER_CLIENT_ID` / `INTLAYER_CLIENT_SECRET` environment variables.\n * Idempotent and non-destructive — existing `clientId` / `clientSecret` values\n * are preserved. Only `.ts`, `.mjs`, `.js` and `.cjs` configs are supported\n * (JSON cannot reference `process.env`).\n */\nexport const enableIntlayerEditorConfig = (content: string): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  genericRecastVisit(ast, (objExpr) => {\n    if (!isObjectExpression(objExpr)) return;\n\n    const editorProperty = ensureObjectProperty(\n      objExpr,\n      'editor',\n      b.objectExpression([])\n    );\n\n    if (!isObjectExpression(editorProperty.value)) return;\n\n    const editorObject = editorProperty.value;\n\n    setObjectPropertyValue(editorObject, 'enabled', b.booleanLiteral(true));\n    addEnvReferenceProperty(editorObject, 'clientId', 'INTLAYER_CLIENT_ID');\n    addEnvReferenceProperty(\n      editorObject,\n      'clientSecret',\n      'INTLAYER_CLIENT_SECRET'\n    );\n  });\n\n  return recast.print(ast).code;\n};\n\nconst injectImport = (\n  ast: any,\n  isCJS: boolean,\n  importName: string,\n  source: string\n) => {\n  // Never redeclare an identifier already bound at module scope (e.g. imported\n  // from another source or declared locally) — that would be a parse error.\n  if (!isCJS && isModuleScopeBinding(ast, importName)) return;\n\n  const body = ast.program.body;\n  const hasImport = body.some((stmt: any) => {\n    if (isCJS) {\n      return (\n        n.VariableDeclaration.check(stmt) &&\n        stmt.declarations.some(\n          (decl: any) =>\n            n.VariableDeclarator.check(decl) &&\n            n.CallExpression.check(decl.init) &&\n            n.Identifier.check(decl.init.callee) &&\n            decl.init.callee.name === 'require' &&\n            n.StringLiteral.check(decl.init.arguments[0]) &&\n            decl.init.arguments[0].value === source\n        )\n      );\n    }\n    return (\n      n.ImportDeclaration.check(stmt) &&\n      (stmt.source.value === source ||\n        stmt.specifiers?.some(\n          (spec: any) =>\n            (n.ImportSpecifier.check(spec) &&\n              spec.imported.name === importName) ||\n            (n.ImportDefaultSpecifier.check(spec) &&\n              spec.local?.name === importName)\n        ))\n    );\n  });\n\n  if (hasImport) return;\n\n  const declaration = isCJS\n    ? b.variableDeclaration('const', [\n        b.variableDeclarator(\n          b.identifier(`{ ${importName} }`),\n          b.callExpression(b.identifier('require'), [b.stringLiteral(source)])\n        ),\n      ])\n    : b.importDeclaration(\n        [b.importSpecifier(b.identifier(importName))],\n        b.stringLiteral(source)\n      );\n\n  ast.program.body.unshift(declaration);\n};\n\nconst updatePluginArray = (\n  objExpr: any,\n  propertyName: string,\n  pluginName: string\n) => {\n  if (\n    !objExpr ||\n    (objExpr.type !== 'ObjectExpression' && !n.ObjectExpression.check(objExpr))\n  )\n    return;\n\n  let prop = objExpr.properties.find((p: any) => {\n    if (!p?.key) return false;\n    const keyName = p.key.name || p.key.value;\n    return keyName === propertyName;\n  }) as any;\n\n  if (!prop) {\n    prop = b.property(\n      'init',\n      b.identifier(propertyName),\n      b.arrayExpression([])\n    );\n    objExpr.properties.push(prop);\n  }\n\n  const arrayValue = prop.value;\n\n  if (\n    arrayValue &&\n    (arrayValue.type === 'ArrayExpression' ||\n      n.ArrayExpression.check(arrayValue))\n  ) {\n    const hasPlugin = arrayValue.elements.some((el: any) => {\n      const callee = el?.callee;\n      if (!callee) return false;\n      const name = callee.name || callee.id?.name;\n      return name === pluginName || name === 'il';\n    });\n\n    if (!hasPlugin) {\n      arrayValue.elements.push(b.callExpression(b.identifier(pluginName), []));\n    }\n  }\n};\n\nconst genericRecastVisit = (\n  ast: any,\n  updateConfigObject: (obj: any) => void,\n  callNames: string[] = ['defineConfig']\n) => {\n  /**\n   * Resolves an identifier reference (e.g. `export default config` /\n   * `module.exports = config`) back to the object expression it was declared\n   * with, then runs the updater on it.\n   */\n  const resolveIdentifierConfig = (name: string) => {\n    ast.program.body.forEach((stmt: any) => {\n      if (n.VariableDeclaration.check(stmt)) {\n        stmt.declarations.forEach((vdecl: any) => {\n          if (\n            n.VariableDeclarator.check(vdecl) &&\n            n.Identifier.check(vdecl.id) &&\n            vdecl.id.name === name &&\n            n.ObjectExpression.check(vdecl.init)\n          ) {\n            updateConfigObject(vdecl.init);\n          }\n        });\n      }\n    });\n  };\n\n  recast.visit(ast, {\n    visitExportDefaultDeclaration(path) {\n      const decl = path.node.declaration;\n\n      if (n.ObjectExpression.check(decl)) {\n        updateConfigObject(decl);\n      } else if (\n        n.CallExpression.check(decl) &&\n        n.Identifier.check(decl.callee) &&\n        callNames.includes(decl.callee.name)\n      ) {\n        if (n.ObjectExpression.check(decl.arguments[0])) {\n          updateConfigObject(decl.arguments[0]);\n        }\n      } else if (n.Identifier.check(decl)) {\n        resolveIdentifierConfig(decl.name);\n      }\n      return false;\n    },\n    visitAssignmentExpression(path) {\n      const { left, right } = path.node;\n\n      if (\n        n.MemberExpression.check(left) &&\n        recast.print(left).code === 'module.exports'\n      ) {\n        if (n.ObjectExpression.check(right)) {\n          updateConfigObject(right);\n        } else if (\n          n.CallExpression.check(right) &&\n          n.Identifier.check(right.callee) &&\n          callNames.includes(right.callee.name)\n        ) {\n          if (n.ObjectExpression.check(right.arguments[0])) {\n            updateConfigObject(right.arguments[0]);\n          }\n        } else if (n.Identifier.check(right)) {\n          resolveIdentifierConfig(right.name);\n        }\n      }\n      return false;\n    },\n  });\n};\n\nexport const updateViteConfig = (\n  content: string,\n  extension: string\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile =\n    extension === 'cjs' ||\n    (content.includes('module.exports') && !content.includes('import '));\n\n  injectImport(ast, isCJSFile, 'intlayer', 'vite-intlayer');\n\n  genericRecastVisit(ast, (obj) =>\n    updatePluginArray(obj, 'plugins', 'intlayer')\n  );\n\n  return recast.print(ast).code;\n};\n\nexport const updateAstroConfig = (\n  content: string,\n  extension: string\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile =\n    extension === 'cjs' ||\n    (content.includes('module.exports') && !content.includes('import '));\n\n  injectImport(ast, isCJSFile, 'intlayer', 'astro-intlayer');\n\n  genericRecastVisit(ast, (obj) =>\n    updatePluginArray(obj, 'integrations', 'intlayer')\n  );\n\n  return recast.print(ast).code;\n};\n\nexport const updateNextConfig = (\n  content: string,\n  extension: string\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile = extension === 'cjs' || content.includes('module.exports');\n\n  injectImport(ast, isCJSFile, 'withIntlayer', 'next-intlayer/server');\n\n  recast.visit(ast, {\n    visitExportDefaultDeclaration(path) {\n      const declaration = path.node.declaration;\n      if (\n        n.Expression.check(declaration) &&\n        !(\n          n.CallExpression.check(declaration) &&\n          n.Identifier.check(declaration.callee) &&\n          declaration.callee.name === 'withIntlayer'\n        )\n      ) {\n        path\n          .get('declaration')\n          .replace(\n            b.callExpression(b.identifier('withIntlayer'), [declaration as any])\n          );\n      }\n      return false;\n    },\n    visitAssignmentExpression(path) {\n      const { left, right } = path.node;\n\n      if (\n        n.MemberExpression.check(left) &&\n        recast.print(left).code === 'module.exports' &&\n        !(\n          n.CallExpression.check(right) &&\n          n.Identifier.check(right.callee) &&\n          right.callee.name === 'withIntlayer'\n        )\n      ) {\n        path\n          .get('right')\n          .replace(b.callExpression(b.identifier('withIntlayer'), [right]));\n      }\n      return false;\n    },\n  });\n\n  return recast.print(ast).code;\n};\n\n/**\n * Returns true when the expression looks like an Immediately Invoked Function\n * Expression (e.g. `(async () => { ... })()`). Such custom async exports cannot\n * be safely wrapped with the synchronous Metro helper, so they are skipped.\n */\nconst isImmediatelyInvokedFunction = (node: any): boolean =>\n  n.CallExpression.check(node) &&\n  (n.ArrowFunctionExpression.check(node.callee) ||\n    n.FunctionExpression.check(node.callee));\n\n/**\n * Wraps a React Native Metro config's exported value with\n * `configMetroIntlayerSync` from `react-native-intlayer/metro`, injecting the\n * import. The synchronous helper is used because it wraps a plain config object\n * and needs no IIFE, making it safe to inject into existing configs without\n * restructuring them.\n *\n * Non-destructive: returns the content unchanged when the export is already\n * wrapped, when the Intlayer Metro plugin is already present, or when the export\n * is a custom async IIFE that cannot be wrapped synchronously. Callers should\n * compare the result with the input to detect the skipped case.\n */\nexport const updateMetroConfig = (\n  content: string,\n  extension: string\n): string => {\n  if (content.includes('react-native-intlayer')) {\n    return content;\n  }\n\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile =\n    extension === 'cjs' ||\n    (content.includes('module.exports') && !content.includes('import '));\n\n  const wrapperName = 'configMetroIntlayerSync';\n\n  const isWrappable = (node: any): boolean =>\n    n.Expression.check(node) &&\n    !isImmediatelyInvokedFunction(node) &&\n    !(\n      n.CallExpression.check(node) &&\n      n.Identifier.check(node.callee) &&\n      node.callee.name === wrapperName\n    );\n\n  let wrapped = false;\n\n  recast.visit(ast, {\n    visitExportDefaultDeclaration(path) {\n      const declaration = path.node.declaration;\n      if (isWrappable(declaration)) {\n        path\n          .get('declaration')\n          .replace(\n            b.callExpression(b.identifier(wrapperName), [declaration as any])\n          );\n        wrapped = true;\n      }\n      return false;\n    },\n    visitAssignmentExpression(path) {\n      const { left, right } = path.node;\n\n      if (\n        n.MemberExpression.check(left) &&\n        recast.print(left).code === 'module.exports' &&\n        isWrappable(right)\n      ) {\n        path\n          .get('right')\n          .replace(b.callExpression(b.identifier(wrapperName), [right]));\n        wrapped = true;\n      }\n      return false;\n    },\n  });\n\n  // Only inject the import when an export was actually wrapped, so an\n  // un-wrappable config is left completely untouched.\n  if (!wrapped) {\n    return content;\n  }\n\n  injectImport(ast, isCJSFile, wrapperName, 'react-native-intlayer/metro');\n\n  return recast.print(ast).code;\n};\n\n/**\n * Builds the contents of a fresh `metro.config.js` wired with the Intlayer\n * Metro plugin. Uses the async `configMetroIntlayer` helper (which can build\n * dictionaries on server start) and picks the default-config source based on\n * whether the project is an Expo app.\n */\nexport const getMetroConfigTemplate = (isExpo: boolean): string => {\n  const defaultConfigSource = isExpo\n    ? 'expo/metro-config'\n    : '@react-native/metro-config';\n\n  return `const { getDefaultConfig } = require(\"${defaultConfigSource}\");\nconst { configMetroIntlayer } = require(\"react-native-intlayer/metro\");\n\nmodule.exports = (async () => {\n  const defaultConfig = getDefaultConfig(__dirname);\n\n  return await configMetroIntlayer(defaultConfig);\n})();\n`;\n};\n\nexport const updateNuxtConfig = (content: string): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const updateConfigObject = (objExpr: any) => {\n    if (\n      !objExpr ||\n      (objExpr.type !== 'ObjectExpression' &&\n        !n.ObjectExpression.check(objExpr))\n    )\n      return;\n\n    let modulesProp = objExpr.properties.find((p: any) => {\n      if (!p?.key) return false;\n      const keyName = p.key.name || p.key.value;\n      return keyName === 'modules';\n    }) as any;\n\n    if (!modulesProp) {\n      modulesProp = b.property(\n        'init',\n        b.identifier('modules'),\n        b.arrayExpression([])\n      );\n      objExpr.properties.push(modulesProp);\n    }\n\n    const modulesValue = modulesProp.value;\n\n    if (\n      modulesValue &&\n      (modulesValue.type === 'ArrayExpression' ||\n        n.ArrayExpression.check(modulesValue))\n    ) {\n      const hasModule = modulesValue.elements.some((el: any) => {\n        if (\n          n.StringLiteral.check(el) ||\n          el.type === 'StringLiteral' ||\n          el.type === 'Literal'\n        ) {\n          return (el.value || el.extra?.rawValue) === 'nuxt-intlayer';\n        }\n        return false;\n      });\n\n      if (!hasModule) {\n        modulesValue.elements.push(b.stringLiteral('nuxt-intlayer'));\n      }\n    }\n  };\n\n  genericRecastVisit(ast, updateConfigObject, ['defineNuxtConfig']);\n\n  return recast.print(ast).code;\n};\n\n/**\n * Updates a Vite config for vue-i18n compat: injects `vueI18nVitePlugin` from\n * `@intlayer/vue-i18n/plugin` into the plugins array.\n */\nexport const updateViteConfigForVueI18n = (\n  content: string,\n  extension: string\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile =\n    extension === 'cjs' ||\n    (content.includes('module.exports') && !content.includes('import '));\n\n  injectImport(\n    ast,\n    isCJSFile,\n    'vueI18nVitePlugin',\n    '@intlayer/vue-i18n/plugin'\n  );\n\n  genericRecastVisit(ast, (obj) =>\n    updatePluginArray(obj, 'plugins', 'vueI18nVitePlugin')\n  );\n\n  return recast.print(ast).code;\n};\n\n/**\n * Generic vite config updater for any compat plugin that uses alias injection.\n * Injects the named import from `pluginPackageSource` and appends the plugin\n * call to the `plugins` array.\n */\nexport const updateViteConfigForCompatPlugin = (\n  content: string,\n  extension: string,\n  pluginConfig: CompatVitePluginConfig\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile =\n    extension === 'cjs' ||\n    (content.includes('module.exports') && !content.includes('import '));\n\n  injectImport(\n    ast,\n    isCJSFile,\n    pluginConfig.pluginFunctionName,\n    pluginConfig.pluginPackageSource\n  );\n\n  genericRecastVisit(ast, (obj) =>\n    updatePluginArray(obj, 'plugins', pluginConfig.pluginFunctionName)\n  );\n\n  return recast.print(ast).code;\n};\n\n/**\n * Rewrites the module source of an existing named import in a vite config,\n * keeping the imported binding and its call site untouched. Used when a compat\n * plugin is a drop-in replacement for an i18n library's own vite plugin — e.g.\n * lingui: `import { lingui } from \"@lingui/vite-plugin\"` becomes\n * `import { lingui } from \"@intlayer/lingui/plugin\"`, leaving `lingui()` in the\n * `plugins` array as-is. Returns the content unchanged when no matching import\n * is found.\n */\nexport const replaceViteConfigPluginImportSource = (\n  content: string,\n  importName: string,\n  fromPackageSource: string,\n  toPackageSource: string\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  let changed = false;\n\n  recast.visit(ast, {\n    visitImportDeclaration(path) {\n      const { source, specifiers } = path.node;\n      const importsBinding = (specifiers ?? []).some(\n        (specifier) =>\n          n.ImportSpecifier.check(specifier) &&\n          specifier.imported.name === importName\n      );\n\n      if (\n        n.StringLiteral.check(source) &&\n        source.value === fromPackageSource &&\n        importsBinding\n      ) {\n        source.value = toPackageSource;\n        changed = true;\n      }\n\n      return false;\n    },\n  });\n\n  if (!changed) return content;\n  return recast.print(ast).code;\n};\n\n/**\n * Generic Next.js config wrapper for compat plugins. Injects the import and\n * wraps the default export / `module.exports` with a HOC call.\n */\nconst wrapNextConfigWithHoc = (\n  content: string,\n  extension: string,\n  hocFunctionName: string,\n  pluginPackageSource: string\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile = extension === 'cjs' || content.includes('module.exports');\n\n  injectImport(ast, isCJSFile, hocFunctionName, pluginPackageSource);\n\n  recast.visit(ast, {\n    visitExportDefaultDeclaration(path) {\n      const declaration = path.node.declaration;\n      if (\n        n.Expression.check(declaration) &&\n        !(\n          n.CallExpression.check(declaration) &&\n          n.Identifier.check(declaration.callee) &&\n          declaration.callee.name === hocFunctionName\n        )\n      ) {\n        path\n          .get('declaration')\n          .replace(\n            b.callExpression(b.identifier(hocFunctionName), [\n              declaration as any,\n            ])\n          );\n      }\n      return false;\n    },\n    visitAssignmentExpression(path) {\n      const { left, right } = path.node;\n\n      if (\n        n.MemberExpression.check(left) &&\n        recast.print(left).code === 'module.exports' &&\n        !(\n          n.CallExpression.check(right) &&\n          n.Identifier.check(right.callee) &&\n          right.callee.name === hocFunctionName\n        )\n      ) {\n        path\n          .get('right')\n          .replace(b.callExpression(b.identifier(hocFunctionName), [right]));\n      }\n      return false;\n    },\n  });\n\n  return recast.print(ast).code;\n};\n\n/**\n * Updates a Next.js config for next-translate compat: wraps the default export\n * with `withNextTranslate` from `@intlayer/next-translate/plugin`.\n */\nexport const updateNextConfigForNextTranslate = (\n  content: string,\n  extension: string\n): string =>\n  wrapNextConfigWithHoc(\n    content,\n    extension,\n    'withNextTranslate',\n    '@intlayer/next-translate/plugin'\n  );\n\n/**\n * Updates a Nuxt config for nuxtjs-i18n compat: adds `@intlayer/nuxtjs-i18n`\n * to the `modules` array.\n */\nexport const updateNuxtConfigForNuxtjsI18n = (content: string): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const updateConfigObject = (objExpr: any) => {\n    if (\n      !objExpr ||\n      (objExpr.type !== 'ObjectExpression' &&\n        !n.ObjectExpression.check(objExpr))\n    )\n      return;\n\n    let modulesProp = (objExpr.properties as any[]).find((p: any) => {\n      if (!p?.key) return false;\n      const keyName = p.key.name || p.key.value;\n      return keyName === 'modules';\n    }) as any;\n\n    if (!modulesProp) {\n      modulesProp = b.property(\n        'init',\n        b.identifier('modules'),\n        b.arrayExpression([])\n      );\n      (objExpr.properties as any[]).push(modulesProp);\n    }\n\n    const modulesValue = modulesProp.value;\n\n    if (\n      modulesValue &&\n      (modulesValue.type === 'ArrayExpression' ||\n        n.ArrayExpression.check(modulesValue))\n    ) {\n      const hasModule = (modulesValue.elements as any[]).some((el: any) => {\n        if (\n          n.StringLiteral.check(el) ||\n          el.type === 'StringLiteral' ||\n          el.type === 'Literal'\n        ) {\n          return (el.value ?? el.extra?.rawValue) === '@intlayer/nuxtjs-i18n';\n        }\n        return false;\n      });\n\n      if (!hasModule) {\n        (modulesValue.elements as any[]).push(\n          b.stringLiteral('@intlayer/nuxtjs-i18n')\n        );\n      }\n    }\n  };\n\n  genericRecastVisit(ast, updateConfigObject, ['defineNuxtConfig']);\n\n  return recast.print(ast).code;\n};\n\n/**\n * Updates a Next.js config for next-i18next compat: wraps the default export\n * with `withI18next` from `@intlayer/next-i18next/plugin`.\n */\nexport const updateNextConfigForNextI18next = (\n  content: string,\n  extension: string\n): string =>\n  wrapNextConfigWithHoc(\n    content,\n    extension,\n    'withI18next',\n    '@intlayer/next-i18next/plugin'\n  );\n\n/**\n * Updates a Next.js config for next-intl compat: replaces any existing\n * `next-intl/plugin` import source with `@intlayer/next-intl/plugin`, or\n * injects `createNextIntlPlugin` with a factory-call wrapper when no such\n * import is present.\n */\nexport const updateNextConfigForNextIntl = (\n  content: string,\n  extension: string\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile = extension === 'cjs' || content.includes('module.exports');\n  let replacedExistingSource = false;\n\n  // Replace 'next-intl/plugin' import source with the compat package.\n  recast.visit(ast, {\n    visitImportDeclaration(path) {\n      if (path.node.source.value === 'next-intl/plugin') {\n        path.node.source = b.stringLiteral('@intlayer/next-intl/plugin');\n        replacedExistingSource = true;\n      }\n      return false;\n    },\n  });\n\n  if (replacedExistingSource) {\n    return recast.print(ast).code;\n  }\n\n  // No existing next-intl/plugin import: check whether createNextIntlPlugin is\n  // already present from any source before injecting the full factory pattern.\n  const hasCreatePlugin = (ast.program.body as any[]).some((stmt: any) => {\n    if (!n.ImportDeclaration.check(stmt)) return false;\n    return (stmt.specifiers ?? []).some(\n      (spec: any) =>\n        (n.ImportSpecifier.check(spec) &&\n          spec.imported.name === 'createNextIntlPlugin') ||\n        (n.ImportDefaultSpecifier.check(spec) &&\n          spec.local?.name === 'createNextIntlPlugin')\n    );\n  });\n\n  if (hasCreatePlugin) {\n    return recast.print(ast).code;\n  }\n\n  // Inject the import.\n  injectImport(\n    ast,\n    isCJSFile,\n    'createNextIntlPlugin',\n    '@intlayer/next-intl/plugin'\n  );\n\n  // Insert a factory-call variable declaration after the last import.\n  const lastImportIndex = (ast.program.body as any[]).reduce(\n    (lastIndex: number, stmt: any, index: number) => {\n      if (n.ImportDeclaration.check(stmt)) return index;\n      return lastIndex;\n    },\n    -1\n  );\n\n  const factoryCallDeclaration = b.variableDeclaration('const', [\n    b.variableDeclarator(\n      b.identifier('_withNextIntlayer'),\n      b.callExpression(b.identifier('createNextIntlPlugin'), [])\n    ),\n  ]);\n\n  (ast.program.body as any[]).splice(\n    lastImportIndex + 1,\n    0,\n    factoryCallDeclaration\n  );\n\n  // Wrap the default export with _withNextIntlayer(...).\n  recast.visit(ast, {\n    visitExportDefaultDeclaration(path) {\n      const declaration = path.node.declaration;\n      if (\n        n.Expression.check(declaration) &&\n        !(\n          n.CallExpression.check(declaration) &&\n          n.Identifier.check(declaration.callee) &&\n          declaration.callee.name === '_withNextIntlayer'\n        )\n      ) {\n        path\n          .get('declaration')\n          .replace(\n            b.callExpression(b.identifier('_withNextIntlayer'), [\n              declaration as any,\n            ])\n          );\n      }\n      return false;\n    },\n    visitAssignmentExpression(path) {\n      const { left, right } = path.node;\n\n      if (\n        n.MemberExpression.check(left) &&\n        recast.print(left).code === 'module.exports' &&\n        !(\n          n.CallExpression.check(right) &&\n          n.Identifier.check(right.callee) &&\n          right.callee.name === '_withNextIntlayer'\n        )\n      ) {\n        path\n          .get('right')\n          .replace(\n            b.callExpression(b.identifier('_withNextIntlayer'), [right])\n          );\n      }\n      return false;\n    },\n  });\n\n  return recast.print(ast).code;\n};\n\n/** The sync plugin used to ingest a compat library's catalogs. */\ntype SyncPluginInfo = {\n  /** Called function name, e.g. `'syncJSON'`. */\n  functionName: string;\n  /** Package the function is imported from. */\n  packageSource: string;\n};\n\n/** Resolves the sync plugin (function + package) for a compat sync config. */\nconst getSyncPluginInfo = (syncConfig: CompatSyncConfig): SyncPluginInfo =>\n  syncConfig.plugin === 'po'\n    ? { functionName: 'syncPO', packageSource: '@intlayer/sync-po-plugin' }\n    : { functionName: 'syncJSON', packageSource: '@intlayer/sync-json-plugin' };\n\n/**\n * Parses a `syncJSON({ ... })` / `syncPO({ ... })` call expression from a source\n * snippet so it can be injected into a config AST without manually constructing\n * template-literal nodes via builders.\n *\n * The destructuring parameters adapt to whether the source template uses the\n * `key` placeholder (nested pattern) or only `locale` (flat pattern).\n */\nconst buildSyncCallNode = (syncConfig: CompatSyncConfig): any => {\n  const { functionName } = getSyncPluginInfo(syncConfig);\n  const usesKey = syncConfig.sourceTemplate.includes('${key}');\n  const paramDestructuring = !usesKey\n    ? '{ locale }'\n    : // `icu` (and PO, which is ICU-dialect) reads `{ key, locale }`; the\n      // i18next/vue-i18n JSON dialects keep their established `{ locale, key }`.\n      syncConfig.format === 'icu' || syncConfig.plugin === 'po'\n      ? '{ key, locale }'\n      : '{ locale, key }';\n\n  // `syncPO` always serializes gettext, so it takes no `format`. `syncJSON`\n  // needs the JSON dialect.\n  const formatProperty =\n    syncConfig.plugin === 'po' ? '' : `format: '${syncConfig.format}', `;\n\n  // `splitKeys` is written explicitly only when forced on (next-intl / use-intl\n  // single-file namespace model). When omitted, syncJSON auto-detects it from\n  // the presence of a `${key}` segment in the source.\n  const splitKeysProperty = syncConfig.splitKeys ? ', splitKeys: true' : '';\n\n  // The sourceTemplate contains ${locale} / ${key} as literal characters;\n  // they become proper template expressions once the snippet is parsed by recast.\n  const snippet = `${functionName}({ ${formatProperty}source: (${paramDestructuring}) => \\`${syncConfig.sourceTemplate}\\`${splitKeysProperty} })`;\n  const snippetAst = recast.parse(snippet, {\n    parser: require('recast/parsers/typescript'),\n  });\n  return (snippetAst.program.body[0] as any).expression;\n};\n\n/**\n * Injects or ensures `dictionary: { format: '<value>' }` exists in an object\n * expression.  Leaves any pre-existing `dictionary` properties untouched —\n * only the `format` sub-property is added when absent.\n */\nconst injectDictionaryFormat = (objExpr: any, format: string): void => {\n  if (\n    !objExpr ||\n    (objExpr.type !== 'ObjectExpression' && !n.ObjectExpression.check(objExpr))\n  )\n    return;\n\n  let dictionaryProp = (objExpr.properties as any[]).find((prop: any) => {\n    if (!prop?.key) return false;\n    return (prop.key.name ?? prop.key.value) === 'dictionary';\n  });\n\n  if (!dictionaryProp) {\n    dictionaryProp = b.property(\n      'init',\n      b.identifier('dictionary'),\n      b.objectExpression([])\n    );\n    (objExpr.properties as any[]).push(dictionaryProp);\n  }\n\n  const dictionaryObj = dictionaryProp.value;\n  if (\n    !dictionaryObj ||\n    (dictionaryObj.type !== 'ObjectExpression' &&\n      !n.ObjectExpression.check(dictionaryObj))\n  )\n    return;\n\n  const hasFormat = (dictionaryObj.properties as any[]).some((prop: any) => {\n    if (!prop?.key) return false;\n    return (prop.key.name ?? prop.key.value) === 'format';\n  });\n\n  if (!hasFormat) {\n    (dictionaryObj.properties as any[]).push(\n      b.property('init', b.identifier('format'), b.stringLiteral(format))\n    );\n  }\n};\n\n/**\n * Injects the sync plugin import (`syncJSON` / `syncPO`) and a configured\n * `syncJSON(...)` / `syncPO(...)` call into the plugins array of an intlayer\n * config file. Idempotent: skips when the plugin call is already present.\n */\nexport const updateIntlayerConfigWithSyncPlugin = (\n  content: string,\n  extension: string,\n  syncConfig: CompatSyncConfig\n): string => {\n  const ast = recast.parse(content, {\n    parser: require('recast/parsers/typescript'),\n  });\n\n  const isCJSFile = extension === 'cjs' || content.includes('module.exports');\n\n  const { functionName, packageSource } = getSyncPluginInfo(syncConfig);\n\n  injectImport(ast, isCJSFile, functionName, packageSource);\n\n  const callNode = buildSyncCallNode(syncConfig);\n\n  // PO catalogs are serialized as gettext; JSON catalogs carry the dialect.\n  const dictionaryFormat =\n    syncConfig.plugin === 'po' ? 'po' : syncConfig.format;\n\n  genericRecastVisit(ast, (objExpr) => {\n    if (\n      !objExpr ||\n      (objExpr.type !== 'ObjectExpression' &&\n        !n.ObjectExpression.check(objExpr))\n    )\n      return;\n\n    // Inject dictionary.format alongside the plugin so intlayer knows how to\n    // interpret dictionary content at runtime.\n    injectDictionaryFormat(objExpr, dictionaryFormat);\n\n    let pluginsProp = (objExpr.properties as any[]).find((prop: any) => {\n      if (!prop?.key) return false;\n      const keyName = prop.key.name ?? prop.key.value;\n      return keyName === 'plugins';\n    });\n\n    if (!pluginsProp) {\n      pluginsProp = b.property(\n        'init',\n        b.identifier('plugins'),\n        b.arrayExpression([])\n      );\n      (objExpr.properties as any[]).push(pluginsProp);\n    }\n\n    const arrayValue = pluginsProp.value;\n\n    if (\n      arrayValue &&\n      (arrayValue.type === 'ArrayExpression' ||\n        n.ArrayExpression.check(arrayValue))\n    ) {\n      const hasSyncPlugin = (arrayValue.elements as any[]).some(\n        (element: any) => {\n          const callee = element?.callee;\n          if (!callee) return false;\n          const name: string = callee.name ?? callee.id?.name;\n          return name === functionName;\n        }\n      );\n\n      if (!hasSyncPlugin) {\n        (arrayValue.elements as any[]).push(callNode);\n      }\n    }\n  });\n\n  return recast.print(ast).code;\n};\n"],"mappings":"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"}

package/dist/esm/init/utils/fileSystem.mjs

@@ -0,0 +1,222 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import fg from "fast-glob";
+import { EXCLUDED_PATHS } from "@intlayer/config/defaultValues";
+import { ALL_LOCALES } from "@intlayer/types/allLocales";
+
+//#region src/init/utils/fileSystem.ts
+/**
+* Helper to check if a file exists
+*/
+const exists = async (rootDir, filePath) => {
+	try {
+		await access(join(rootDir, filePath));
+		return true;
+	} catch {
+		return false;
+	}
+};
+/**
+* Helper to read a file
+*/
+const readFileFromRoot = async (rootDir, filePath) => await readFile(join(rootDir, filePath), "utf8");
+/**
+* Helper to write a file
+*/
+const writeFileToRoot = async (rootDir, filePath, content) => await writeFile(join(rootDir, filePath), content, "utf8");
+/**
+* Helper to ensure a directory exists
+*/
+const ensureDirectory = async (rootDir, dirPath) => {
+	try {
+		await mkdir(join(rootDir, dirPath), { recursive: true });
+	} catch {}
+};
+/**
+* Set of all known locale string values from the intlayer Locales registry
+* (e.g. `'en'`, `'fr'`, `'zh-TW'`).  Keyed by the exact locale string so
+* `.has()` lookups are O(1) and common short directory names (`src`, `lib`,
+* `app`, …) are not mistaken for locales.
+*/
+const ALL_LOCALE_VALUES = new Set(Object.values(ALL_LOCALES));
+/**
+* Returns true when `segment` matches a known BCP-47 locale identifier, e.g.
+* `en`, `fr`, `zh-TW`, `pt-BR`, `en-US`.
+*/
+const isLocaleSegment = (segment) => ALL_LOCALE_VALUES.has(segment);
+/** JSON filenames that are never locale translation files. */
+const KNOWN_CONFIG_FILENAMES = new Set([
+	"package.json",
+	"tsconfig.json",
+	"jsconfig.json",
+	"biome.json",
+	"turbo.json",
+	"lerna.json",
+	"vercel.json",
+	"netlify.json",
+	"babel.config.json",
+	"jest.config.json",
+	"vitest.config.json",
+	".eslintrc.json",
+	".prettierrc.json"
+]);
+/**
+* Scans the project for JSON files and determines whether locale files are
+* organised as `{base}/{locale}/{key}.json` (nested) or `{base}/{locale}.json`
+* (flat).  Returns the most likely source template, or `null` when no locale
+* JSON files are found.
+*
+* The returned `template` contains `${locale}` and `${key}` as **literal**
+* placeholder strings so it can be embedded inside a JS template literal.
+*/
+const detectJsonLocalePattern = async (rootDir) => {
+	const files = await fg("**/*.json", {
+		cwd: rootDir,
+		ignore: EXCLUDED_PATHS,
+		absolute: false,
+		onlyFiles: true
+	});
+	const nestedBasePaths = [];
+	const flatBasePaths = [];
+	const nestedLocales = /* @__PURE__ */ new Set();
+	const flatLocales = /* @__PURE__ */ new Set();
+	for (const file of files) {
+		const parts = file.split("/");
+		const filename = parts[parts.length - 1] ?? "";
+		if (KNOWN_CONFIG_FILENAMES.has(filename)) continue;
+		if (parts.length >= 3) {
+			const localeDir = parts[parts.length - 2] ?? "";
+			if (isLocaleSegment(localeDir)) {
+				nestedBasePaths.push(parts.slice(0, -2).join("/") || ".");
+				nestedLocales.add(localeDir);
+			}
+		}
+		if (parts.length >= 2) {
+			const baseName = filename.slice(0, -5);
+			if (isLocaleSegment(baseName)) {
+				flatBasePaths.push(parts.slice(0, -1).join("/") || ".");
+				flatLocales.add(baseName);
+			}
+		}
+	}
+	if (nestedBasePaths.length === 0 && flatBasePaths.length === 0) return null;
+	/**
+	* Returns the path prefix that appears most frequently among the matches,
+	* formatted as a relative path suitable for a source template.
+	*/
+	const mostFrequentPrefix = (paths) => {
+		const counts = paths.reduce((accumulator, path) => {
+			accumulator[path] = (accumulator[path] ?? 0) + 1;
+			return accumulator;
+		}, {});
+		const basePath = Object.entries(counts).sort(([, a], [, b]) => b - a)[0]?.[0] ?? ".";
+		return basePath === "." ? "." : `./${basePath}`;
+	};
+	if (nestedBasePaths.length >= flatBasePaths.length) return {
+		type: "nested",
+		template: `${mostFrequentPrefix(nestedBasePaths)}/\${locale}/\${key}.json`,
+		locales: Array.from(nestedLocales)
+	};
+	return {
+		type: "flat",
+		template: `${mostFrequentPrefix(flatBasePaths)}/\${locale}.json`,
+		locales: Array.from(flatLocales)
+	};
+};
+/**
+* Scans the project for lingui catalog files (`{base}/{locale}/messages.po` or
+* `…/messages.json`, lingui's default layout) and derives the `syncPO` /
+* `syncJSON` `source` template.
+*
+* `.po` is preferred when present (lingui's default format). Returns `null`
+* when no lingui catalog is found, in which case the caller falls back to the
+* generic JSON detection.
+*
+* @param rootDir - Project root directory.
+*/
+const detectLinguiCatalogPattern = async (rootDir) => {
+	const files = await fg(["**/messages.po", "**/messages.json"], {
+		cwd: rootDir,
+		ignore: EXCLUDED_PATHS,
+		absolute: false,
+		onlyFiles: true
+	});
+	const basePathsByFormat = {
+		po: [],
+		json: []
+	};
+	const localesByFormat = {
+		po: /* @__PURE__ */ new Set(),
+		json: /* @__PURE__ */ new Set()
+	};
+	for (const file of files) {
+		const parts = file.split("/");
+		if (parts.length < 2) continue;
+		const localeDir = parts[parts.length - 2] ?? "";
+		if (!isLocaleSegment(localeDir)) continue;
+		const extension = file.endsWith(".po") ? "po" : "json";
+		basePathsByFormat[extension].push(parts.slice(0, -2).join("/") || ".");
+		localesByFormat[extension].add(localeDir);
+	}
+	const format = basePathsByFormat.po.length > 0 ? "po" : "json";
+	const basePaths = basePathsByFormat[format];
+	if (basePaths.length === 0) return null;
+	const counts = basePaths.reduce((accumulator, path) => {
+		accumulator[path] = (accumulator[path] ?? 0) + 1;
+		return accumulator;
+	}, {});
+	const topBasePath = Object.entries(counts).sort(([, a], [, b]) => b - a)[0]?.[0] ?? ".";
+	return {
+		format,
+		template: `${topBasePath === "." ? "." : `./${topBasePath}`}/\${locale}/\${key}.${format}`,
+		locales: Array.from(localesByFormat[format])
+	};
+};
+/** Common locations of the `next-intl` request config, relative to the root. */
+const NEXT_INTL_REQUEST_FILES = [
+	"i18n/request.ts",
+	"i18n/request.tsx",
+	"i18n/request.js",
+	"i18n/request.mjs",
+	"src/i18n/request.ts",
+	"src/i18n/request.tsx",
+	"src/i18n/request.js",
+	"src/i18n/request.mjs",
+	"app/i18n/request.ts",
+	"src/app/i18n/request.ts"
+];
+/**
+* Derives the messages source template from a `next-intl` `i18n/request.ts`
+* file, which is the authoritative location of the messages path in a next-intl
+* project (e.g. `messages: (await import(\`../messages/${locale}.json\`)).default`).
+*
+* Reading it removes the ambiguity of globbing the file system and yields the
+* exact `source` template for `syncJSON`. When the resulting template has no
+* `${key}` segment (the common single-file-per-locale layout, where top-level
+* keys are namespaces), `syncJSON` `splitKeys` auto-detection turns each
+* top-level key into its own dictionary.
+*
+* Returns `null` when no request file is found, the messages import cannot be
+* parsed, or the path is not project-root-relative (e.g. uses a TS path alias).
+*
+* @param rootDir - Project root directory.
+*/
+const detectNextIntlMessagesPattern = async (rootDir) => {
+	for (const requestFile of NEXT_INTL_REQUEST_FILES) {
+		if (!await exists(rootDir, requestFile)) continue;
+		const importPath = (await readFileFromRoot(rootDir, requestFile)).match(/import\(\s*`([^`]*\$\{\s*locale\s*\}[^`]*\.json)`/)?.[1];
+		if (!importPath) continue;
+		if (!importPath.startsWith(".")) continue;
+		const relativeTemplate = relative(rootDir, resolve(dirname(resolve(rootDir, requestFile)), importPath)).split(sep).join("/");
+		const template = relativeTemplate.startsWith(".") ? relativeTemplate : `./${relativeTemplate}`;
+		return {
+			type: template.includes("${key}") || template.includes("${namespace}") ? "nested" : "flat",
+			template
+		};
+	}
+	return null;
+};
+
+//#endregion
+export { detectJsonLocalePattern, detectLinguiCatalogPattern, detectNextIntlMessagesPattern, ensureDirectory, exists, readFileFromRoot, writeFileToRoot };
+//# sourceMappingURL=fileSystem.mjs.map

package/dist/esm/init/utils/fileSystem.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystem.mjs","names":[],"sources":["../../../../src/init/utils/fileSystem.ts"],"sourcesContent":["import { access, mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, join, relative, resolve, sep } from 'node:path';\nimport { EXCLUDED_PATHS } from '@intlayer/config/defaultValues';\nimport { ALL_LOCALES } from '@intlayer/types/allLocales';\nimport fg from 'fast-glob';\n\n/**\n * Helper to check if a file exists\n */\nexport const exists = async (rootDir: string, filePath: string) => {\n  try {\n    await access(join(rootDir, filePath));\n    return true;\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Helper to read a file\n */\nexport const readFileFromRoot = async (rootDir: string, filePath: string) =>\n  await readFile(join(rootDir, filePath), 'utf8');\n\n/**\n * Helper to write a file\n */\nexport const writeFileToRoot = async (\n  rootDir: string,\n  filePath: string,\n  content: string\n) => await writeFile(join(rootDir, filePath), content, 'utf8');\n\n/**\n * Helper to ensure a directory exists\n */\nexport const ensureDirectory = async (rootDir: string, dirPath: string) => {\n  try {\n    await mkdir(join(rootDir, dirPath), { recursive: true });\n  } catch {\n    // Directory already exists or could not be created\n  }\n};\n\n/**\n * Pattern type for locale JSON file organisation.\n * - 'nested': files are at `{base}/{locale}/{key}.json`\n * - 'flat':   files are at `{base}/{locale}.json`\n */\nexport type JsonLocalePatternType = 'nested' | 'flat';\n\n/**\n * Detected locale JSON file pattern and the corresponding source template.\n * `template` uses `${locale}` and `${key}` as literal placeholders (not JS\n * expressions) so it can be embedded directly in a template-literal string.\n */\nexport type JsonLocalePattern = {\n  type: JsonLocalePatternType;\n  /**\n   * Source path template for syncJSON `source` option.\n   * Example nested: `./locales/${locale}/${key}.json`\n   * Example flat:   `./locales/${locale}.json`\n   */\n  template: string;\n  /**\n   * Detected locales in the directory.\n   */\n  locales: string[];\n};\n\n/**\n * Set of all known locale string values from the intlayer Locales registry\n * (e.g. `'en'`, `'fr'`, `'zh-TW'`).  Keyed by the exact locale string so\n * `.has()` lookups are O(1) and common short directory names (`src`, `lib`,\n * `app`, …) are not mistaken for locales.\n */\nconst ALL_LOCALE_VALUES = new Set<string>(Object.values(ALL_LOCALES));\n\n/**\n * Returns true when `segment` matches a known BCP-47 locale identifier, e.g.\n * `en`, `fr`, `zh-TW`, `pt-BR`, `en-US`.\n */\nconst isLocaleSegment = (segment: string): boolean =>\n  ALL_LOCALE_VALUES.has(segment);\n\n/** JSON filenames that are never locale translation files. */\nconst KNOWN_CONFIG_FILENAMES = new Set([\n  'package.json',\n  'tsconfig.json',\n  'jsconfig.json',\n  'biome.json',\n  'turbo.json',\n  'lerna.json',\n  'vercel.json',\n  'netlify.json',\n  'babel.config.json',\n  'jest.config.json',\n  'vitest.config.json',\n  '.eslintrc.json',\n  '.prettierrc.json',\n]);\n\n/**\n * Scans the project for JSON files and determines whether locale files are\n * organised as `{base}/{locale}/{key}.json` (nested) or `{base}/{locale}.json`\n * (flat).  Returns the most likely source template, or `null` when no locale\n * JSON files are found.\n *\n * The returned `template` contains `${locale}` and `${key}` as **literal**\n * placeholder strings so it can be embedded inside a JS template literal.\n */\nexport const detectJsonLocalePattern = async (\n  rootDir: string\n): Promise<JsonLocalePattern | null> => {\n  const files = await fg('**/*.json', {\n    cwd: rootDir,\n    ignore: EXCLUDED_PATHS,\n    absolute: false,\n    onlyFiles: true,\n  });\n\n  const nestedBasePaths: string[] = [];\n  const flatBasePaths: string[] = [];\n  const nestedLocales = new Set<string>();\n  const flatLocales = new Set<string>();\n\n  for (const file of files) {\n    const parts = file.split('/');\n    const filename = parts[parts.length - 1] ?? '';\n\n    if (KNOWN_CONFIG_FILENAMES.has(filename)) continue;\n\n    // Nested: …/{locale}/{key}.json — parent directory is a locale code\n    if (parts.length >= 3) {\n      const localeDir = parts[parts.length - 2] ?? '';\n      if (isLocaleSegment(localeDir)) {\n        nestedBasePaths.push(parts.slice(0, -2).join('/') || '.');\n        nestedLocales.add(localeDir);\n      }\n    }\n\n    // Flat: …/{locale}.json — filename (without extension) is a locale code\n    if (parts.length >= 2) {\n      const baseName = filename.slice(0, -5); // strip \".json\"\n      if (isLocaleSegment(baseName)) {\n        flatBasePaths.push(parts.slice(0, -1).join('/') || '.');\n        flatLocales.add(baseName);\n      }\n    }\n  }\n\n  if (nestedBasePaths.length === 0 && flatBasePaths.length === 0) {\n    return null;\n  }\n\n  /**\n   * Returns the path prefix that appears most frequently among the matches,\n   * formatted as a relative path suitable for a source template.\n   */\n  const mostFrequentPrefix = (paths: string[]): string => {\n    const counts = paths.reduce<Record<string, number>>((accumulator, path) => {\n      accumulator[path] = (accumulator[path] ?? 0) + 1;\n      return accumulator;\n    }, {});\n    const topEntry = Object.entries(counts).sort(([, a], [, b]) => b - a)[0];\n    const basePath = topEntry?.[0] ?? '.';\n    return basePath === '.' ? '.' : `./${basePath}`;\n  };\n\n  if (nestedBasePaths.length >= flatBasePaths.length) {\n    const prefix = mostFrequentPrefix(nestedBasePaths);\n    return {\n      type: 'nested',\n      // Literal ${locale} and ${key} — not evaluated here, used in template literals\n      template: `${prefix}/\\${locale}/\\${key}.json`,\n      locales: Array.from(nestedLocales),\n    };\n  }\n\n  const prefix = mostFrequentPrefix(flatBasePaths);\n  return {\n    type: 'flat',\n    template: `${prefix}/\\${locale}.json`,\n    locales: Array.from(flatLocales),\n  };\n};\n\n/**\n * Detected lingui catalog pattern. lingui stores one catalog file per locale\n * (default name `messages`), as `.po` (its default) or `.json`.\n */\nexport type LinguiCatalogPattern = {\n  /** Which sync plugin should ingest the catalogs. */\n  format: 'po' | 'json';\n  /**\n   * Source path template, with `${locale}` and `${key}` as literal\n   * placeholders. The catalog filename (`messages`) is captured by `${key}` so\n   * the produced intlayer dictionary key is `messages` — matching the fixed\n   * `messages` namespace the lingui compat runtime reads from.\n   * Example: `./src/locales/${locale}/${key}.po`.\n   */\n  template: string;\n  /** Detected locales. */\n  locales: string[];\n};\n\n/**\n * Scans the project for lingui catalog files (`{base}/{locale}/messages.po` or\n * `…/messages.json`, lingui's default layout) and derives the `syncPO` /\n * `syncJSON` `source` template.\n *\n * `.po` is preferred when present (lingui's default format). Returns `null`\n * when no lingui catalog is found, in which case the caller falls back to the\n * generic JSON detection.\n *\n * @param rootDir - Project root directory.\n */\nexport const detectLinguiCatalogPattern = async (\n  rootDir: string\n): Promise<LinguiCatalogPattern | null> => {\n  // lingui's default catalog name is `messages`; match that basename for both\n  // formats so the captured `${key}` is `messages`.\n  const files = await fg(['**/messages.po', '**/messages.json'], {\n    cwd: rootDir,\n    ignore: EXCLUDED_PATHS,\n    absolute: false,\n    onlyFiles: true,\n  });\n\n  const basePathsByFormat: Record<'po' | 'json', string[]> = {\n    po: [],\n    json: [],\n  };\n  const localesByFormat: Record<'po' | 'json', Set<string>> = {\n    po: new Set(),\n    json: new Set(),\n  };\n\n  for (const file of files) {\n    const parts = file.split('/');\n    // Nested layout: …/{locale}/messages.{po,json} — parent dir is the locale.\n    if (parts.length < 2) continue;\n\n    const localeDir = parts[parts.length - 2] ?? '';\n    if (!isLocaleSegment(localeDir)) continue;\n\n    const extension = (file.endsWith('.po') ? 'po' : 'json') as 'po' | 'json';\n    basePathsByFormat[extension].push(parts.slice(0, -2).join('/') || '.');\n    localesByFormat[extension].add(localeDir);\n  }\n\n  // Prefer `.po` (lingui's default) when catalogs of both formats coexist.\n  const format: 'po' | 'json' = basePathsByFormat.po.length > 0 ? 'po' : 'json';\n\n  const basePaths = basePathsByFormat[format];\n  if (basePaths.length === 0) return null;\n\n  const counts = basePaths.reduce<Record<string, number>>(\n    (accumulator, path) => {\n      accumulator[path] = (accumulator[path] ?? 0) + 1;\n      return accumulator;\n    },\n    {}\n  );\n  const topBasePath =\n    Object.entries(counts).sort(([, a], [, b]) => b - a)[0]?.[0] ?? '.';\n  const prefix = topBasePath === '.' ? '.' : `./${topBasePath}`;\n\n  return {\n    format,\n    template: `${prefix}/\\${locale}/\\${key}.${format}`,\n    locales: Array.from(localesByFormat[format]),\n  };\n};\n\n/**\n * The messages source template derived from a `next-intl` `i18n/request.ts`\n * file, ready to be used as a `syncJSON` `source` builder.\n */\nexport type NextIntlMessagesPattern = {\n  /** `'flat'` (one file per locale) or `'nested'` (per-namespace files). */\n  type: JsonLocalePatternType;\n  /**\n   * Source path template relative to the project root, with `${locale}` (and\n   * `${key}` when nested) as literal placeholders, e.g. `./messages/${locale}.json`.\n   */\n  template: string;\n};\n\n/** Common locations of the `next-intl` request config, relative to the root. */\nconst NEXT_INTL_REQUEST_FILES = [\n  'i18n/request.ts',\n  'i18n/request.tsx',\n  'i18n/request.js',\n  'i18n/request.mjs',\n  'src/i18n/request.ts',\n  'src/i18n/request.tsx',\n  'src/i18n/request.js',\n  'src/i18n/request.mjs',\n  'app/i18n/request.ts',\n  'src/app/i18n/request.ts',\n];\n\n/**\n * Derives the messages source template from a `next-intl` `i18n/request.ts`\n * file, which is the authoritative location of the messages path in a next-intl\n * project (e.g. `messages: (await import(\\`../messages/${locale}.json\\`)).default`).\n *\n * Reading it removes the ambiguity of globbing the file system and yields the\n * exact `source` template for `syncJSON`. When the resulting template has no\n * `${key}` segment (the common single-file-per-locale layout, where top-level\n * keys are namespaces), `syncJSON` `splitKeys` auto-detection turns each\n * top-level key into its own dictionary.\n *\n * Returns `null` when no request file is found, the messages import cannot be\n * parsed, or the path is not project-root-relative (e.g. uses a TS path alias).\n *\n * @param rootDir - Project root directory.\n */\nexport const detectNextIntlMessagesPattern = async (\n  rootDir: string\n): Promise<NextIntlMessagesPattern | null> => {\n  for (const requestFile of NEXT_INTL_REQUEST_FILES) {\n    if (!(await exists(rootDir, requestFile))) continue;\n\n    const content = await readFileFromRoot(rootDir, requestFile);\n\n    // Capture the template-literal path of the messages dynamic import, e.g.\n    // import(`../messages/${locale}.json`) → `../messages/${locale}.json`.\n    const importMatch = content.match(\n      /import\\(\\s*`([^`]*\\$\\{\\s*locale\\s*\\}[^`]*\\.json)`/\n    );\n\n    const importPath = importMatch?.[1];\n    if (!importPath) continue;\n\n    // Only relative imports can be resolved against the file system; path\n    // aliases (e.g. `@/messages/...`) are skipped in favour of glob detection.\n    if (!importPath.startsWith('.')) continue;\n\n    // Resolve the import (relative to the request file) back to a\n    // project-root-relative template. The `${locale}` / `${key}` placeholders\n    // are kept literal — path utilities treat them as ordinary segments.\n    const requestDir = dirname(resolve(rootDir, requestFile));\n    const absoluteTemplate = resolve(requestDir, importPath);\n    const relativeTemplate = relative(rootDir, absoluteTemplate)\n      .split(sep)\n      .join('/');\n\n    const template = relativeTemplate.startsWith('.')\n      ? relativeTemplate\n      : `./${relativeTemplate}`;\n\n    const type: JsonLocalePatternType =\n      template.includes('${key}') || template.includes('${namespace}')\n        ? 'nested'\n        : 'flat';\n\n    return { type, template };\n  }\n\n  return null;\n};\n"],"mappings":"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"}

package/dist/esm/init/utils/githubActions.mjs

@@ -0,0 +1,155 @@
+//#region src/init/utils/githubActions.ts
+/**
+* Returns the package-manager-specific steps and commands used to build the
+* GitHub Actions workflows. Each package manager needs a slightly different
+* setup action and a different way to run the local `intlayer` binary.
+*/
+const getPackageManagerCIConfig = (packageManager) => {
+	const setupNodeStep = (cache) => `      - name: 🟢 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20${cache ? `\n          cache: ${cache}` : ""}`;
+	switch (packageManager) {
+		case "bun": return {
+			setupSteps: `      - name: 🥟 Setup Bun
+        uses: oven-sh/setup-bun@v2`,
+			installCommand: "bun install --frozen-lockfile",
+			execCommand: "bunx intlayer"
+		};
+		case "pnpm": return {
+			setupSteps: `      - name: 📦 Setup pnpm
+        uses: pnpm/action-setup@v4
+${setupNodeStep("pnpm")}`,
+			installCommand: "pnpm install --frozen-lockfile",
+			execCommand: "pnpm exec intlayer"
+		};
+		case "yarn": return {
+			setupSteps: setupNodeStep("yarn"),
+			installCommand: "yarn install --frozen-lockfile",
+			execCommand: "yarn intlayer"
+		};
+		case "npm": return {
+			setupSteps: setupNodeStep("npm"),
+			installCommand: "npm ci",
+			execCommand: "npx intlayer"
+		};
+	}
+};
+/**
+* Builds the `intlayer fill` workflow. Runs on pull requests, regenerates the
+* missing translations for the changed dictionaries (`--git-diff`) using AI,
+* then commits the result back to the PR branch.
+*
+* AI access is required for `fill`. The workflow exposes both options:
+* - a provider API key (`AI_API_KEY` secret), forwarded via CLI flags, or
+* - Intlayer CMS access keys (`INTLAYER_CLIENT_ID` / `INTLAYER_CLIENT_SECRET`).
+*/
+const generateFillWorkflow = (packageManager) => {
+	const { setupSteps, installCommand, execCommand } = getPackageManagerCIConfig(packageManager);
+	return `name: Intlayer Fill
+# Auto-fill missing translations on every pull request.
+on:
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: intlayer-fill-\${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  fill:
+    runs-on: ubuntu-latest
+    env:
+      # AI access is required to generate translations.
+      # Add the secret in: Settings → Secrets and variables → Actions.
+      #
+      # Option 1 — Use your own AI provider key (forwarded below via CLI flags):
+      AI_PROVIDER: openai
+      AI_MODEL: gpt-5-mini
+      AI_API_KEY: \${{ secrets.AI_API_KEY }}
+      #
+      # Option 2 — Use Intlayer CMS access keys instead of your own AI key.
+      # Wire them in your intlayer.config and uncomment the lines below:
+      # INTLAYER_CLIENT_ID: \${{ secrets.INTLAYER_CLIENT_ID }}
+      # INTLAYER_CLIENT_SECRET: \${{ secrets.INTLAYER_CLIENT_SECRET }}
+    steps:
+      - name: ⬇️ Checkout repository
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: true # Keep credentials to push back to the PR
+          fetch-depth: 0 # Full history so --git-diff can compare refs
+${setupSteps}
+      - name: 📦 Install dependencies
+        run: ${installCommand}
+      - name: ⚙️ Build dictionaries
+        run: ${execCommand} build
+      - name: 🤖 Fill missing translations
+        run: ${execCommand} fill --git-diff --mode complete --provider $AI_PROVIDER --model $AI_MODEL --api-key $AI_API_KEY
+      - name: 📤 Commit and push changes
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          if [ -n "$(git status --porcelain)" ]; then
+            git add .
+            git commit -m "chore(intlayer): fill missing translations [skip ci]"
+            git push origin HEAD:\${{ github.head_ref }}
+          else
+            echo "No missing translations to fill."
+          fi
+`;
+};
+/**
+* Builds the `intlayer test` workflow. Runs on pull requests and fails the
+* check when required locales are missing translations. No AI access needed.
+*/
+const generateTestWorkflow = (packageManager) => {
+	const { setupSteps, installCommand, execCommand } = getPackageManagerCIConfig(packageManager);
+	return `name: Intlayer Test
+# Fail the pull request when required locales are missing translations.
+on:
+  pull_request:
+    branches:
+      - main
+
+concurrency:
+  group: intlayer-test-\${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: ⬇️ Checkout repository
+        uses: actions/checkout@v4
+${setupSteps}
+      - name: 📦 Install dependencies
+        run: ${installCommand}
+      - name: ⚙️ Build dictionaries
+        run: ${execCommand} build
+      - name: 🧪 Test for missing translations
+        run: ${execCommand} test
+`;
+};
+/** Workflow file path constants, relative to the project root. */
+const GITHUB_FILL_WORKFLOW_PATH = ".github/workflows/intlayer-fill.yml";
+const GITHUB_TEST_WORKFLOW_PATH = ".github/workflows/intlayer-test.yml";
+/**
+* Returns the two Intlayer GitHub Actions workflows (`fill` and `test`),
+* generated with commands matching the detected package manager.
+*/
+const getGithubWorkflows = (packageManager) => [{
+	filePath: GITHUB_FILL_WORKFLOW_PATH,
+	content: generateFillWorkflow(packageManager)
+}, {
+	filePath: GITHUB_TEST_WORKFLOW_PATH,
+	content: generateTestWorkflow(packageManager)
+}];
+
+//#endregion
+export { GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, getGithubWorkflows };
+//# sourceMappingURL=githubActions.mjs.map

package/dist/esm/init/utils/githubActions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"githubActions.mjs","names":[],"sources":["../../../../src/init/utils/githubActions.ts"],"sourcesContent":["import type { PackageManager } from './packageManager';\n\n/** A GitHub Actions workflow file to be written to the project. */\nexport type GithubWorkflowFile = {\n  /** Path relative to the project root, e.g. `.github/workflows/intlayer-fill.yml`. */\n  filePath: string;\n  /** Full YAML content of the workflow file. */\n  content: string;\n};\n\n/**\n * Package-manager-specific snippets used to assemble the CI workflows.\n * - `setupSteps`: YAML steps (already indented for the `steps:` list) that\n *   install the package manager and Node.js, including dependency caching.\n * - `installCommand`: command that installs the project dependencies.\n * - `execCommand`: prefix used to run the locally installed `intlayer` binary.\n */\ntype PackageManagerCIConfig = {\n  setupSteps: string;\n  installCommand: string;\n  execCommand: string;\n};\n\n/**\n * Returns the package-manager-specific steps and commands used to build the\n * GitHub Actions workflows. Each package manager needs a slightly different\n * setup action and a different way to run the local `intlayer` binary.\n */\nconst getPackageManagerCIConfig = (\n  packageManager: PackageManager\n): PackageManagerCIConfig => {\n  const setupNodeStep = (\n    cache: PackageManager | undefined\n  ): string => `      - name: 🟢 Setup Node.js\n        uses: actions/setup-node@v4\n        with:\n          node-version: 20${cache ? `\\n          cache: ${cache}` : ''}`;\n\n  switch (packageManager) {\n    case 'bun':\n      return {\n        setupSteps: `      - name: 🥟 Setup Bun\n        uses: oven-sh/setup-bun@v2`,\n        installCommand: 'bun install --frozen-lockfile',\n        execCommand: 'bunx intlayer',\n      };\n    case 'pnpm':\n      return {\n        setupSteps: `      - name: 📦 Setup pnpm\n        uses: pnpm/action-setup@v4\n${setupNodeStep('pnpm')}`,\n        installCommand: 'pnpm install --frozen-lockfile',\n        execCommand: 'pnpm exec intlayer',\n      };\n    case 'yarn':\n      return {\n        setupSteps: setupNodeStep('yarn'),\n        installCommand: 'yarn install --frozen-lockfile',\n        execCommand: 'yarn intlayer',\n      };\n    case 'npm':\n      return {\n        setupSteps: setupNodeStep('npm'),\n        installCommand: 'npm ci',\n        execCommand: 'npx intlayer',\n      };\n  }\n};\n\n/**\n * Builds the `intlayer fill` workflow. Runs on pull requests, regenerates the\n * missing translations for the changed dictionaries (`--git-diff`) using AI,\n * then commits the result back to the PR branch.\n *\n * AI access is required for `fill`. The workflow exposes both options:\n * - a provider API key (`AI_API_KEY` secret), forwarded via CLI flags, or\n * - Intlayer CMS access keys (`INTLAYER_CLIENT_ID` / `INTLAYER_CLIENT_SECRET`).\n */\nconst generateFillWorkflow = (packageManager: PackageManager): string => {\n  const { setupSteps, installCommand, execCommand } =\n    getPackageManagerCIConfig(packageManager);\n\n  return `name: Intlayer Fill\n# Auto-fill missing translations on every pull request.\non:\n  pull_request:\n    branches:\n      - main\n\npermissions:\n  contents: write\n  pull-requests: write\n\nconcurrency:\n  group: intlayer-fill-\\${{ github.ref }}\n  cancel-in-progress: true\n\njobs:\n  fill:\n    runs-on: ubuntu-latest\n    env:\n      # AI access is required to generate translations.\n      # Add the secret in: Settings → Secrets and variables → Actions.\n      #\n      # Option 1 — Use your own AI provider key (forwarded below via CLI flags):\n      AI_PROVIDER: openai\n      AI_MODEL: gpt-5-mini\n      AI_API_KEY: \\${{ secrets.AI_API_KEY }}\n      #\n      # Option 2 — Use Intlayer CMS access keys instead of your own AI key.\n      # Wire them in your intlayer.config and uncomment the lines below:\n      # INTLAYER_CLIENT_ID: \\${{ secrets.INTLAYER_CLIENT_ID }}\n      # INTLAYER_CLIENT_SECRET: \\${{ secrets.INTLAYER_CLIENT_SECRET }}\n    steps:\n      - name: ⬇️ Checkout repository\n        uses: actions/checkout@v4\n        with:\n          persist-credentials: true # Keep credentials to push back to the PR\n          fetch-depth: 0 # Full history so --git-diff can compare refs\n${setupSteps}\n      - name: 📦 Install dependencies\n        run: ${installCommand}\n      - name: ⚙️ Build dictionaries\n        run: ${execCommand} build\n      - name: 🤖 Fill missing translations\n        run: ${execCommand} fill --git-diff --mode complete --provider $AI_PROVIDER --model $AI_MODEL --api-key $AI_API_KEY\n      - name: 📤 Commit and push changes\n        run: |\n          git config --local user.email \"github-actions[bot]@users.noreply.github.com\"\n          git config --local user.name \"github-actions[bot]\"\n          if [ -n \"$(git status --porcelain)\" ]; then\n            git add .\n            git commit -m \"chore(intlayer): fill missing translations [skip ci]\"\n            git push origin HEAD:\\${{ github.head_ref }}\n          else\n            echo \"No missing translations to fill.\"\n          fi\n`;\n};\n\n/**\n * Builds the `intlayer test` workflow. Runs on pull requests and fails the\n * check when required locales are missing translations. No AI access needed.\n */\nconst generateTestWorkflow = (packageManager: PackageManager): string => {\n  const { setupSteps, installCommand, execCommand } =\n    getPackageManagerCIConfig(packageManager);\n\n  return `name: Intlayer Test\n# Fail the pull request when required locales are missing translations.\non:\n  pull_request:\n    branches:\n      - main\n\nconcurrency:\n  group: intlayer-test-\\${{ github.ref }}\n  cancel-in-progress: true\n\njobs:\n  test:\n    runs-on: ubuntu-latest\n    steps:\n      - name: ⬇️ Checkout repository\n        uses: actions/checkout@v4\n${setupSteps}\n      - name: 📦 Install dependencies\n        run: ${installCommand}\n      - name: ⚙️ Build dictionaries\n        run: ${execCommand} build\n      - name: 🧪 Test for missing translations\n        run: ${execCommand} test\n`;\n};\n\n/** Workflow file path constants, relative to the project root. */\nexport const GITHUB_FILL_WORKFLOW_PATH = '.github/workflows/intlayer-fill.yml';\nexport const GITHUB_TEST_WORKFLOW_PATH = '.github/workflows/intlayer-test.yml';\n\n/**\n * Returns the two Intlayer GitHub Actions workflows (`fill` and `test`),\n * generated with commands matching the detected package manager.\n */\nexport const getGithubWorkflows = (\n  packageManager: PackageManager\n): GithubWorkflowFile[] => [\n  {\n    filePath: GITHUB_FILL_WORKFLOW_PATH,\n    content: generateFillWorkflow(packageManager),\n  },\n  {\n    filePath: GITHUB_TEST_WORKFLOW_PATH,\n    content: generateTestWorkflow(packageManager),\n  },\n];\n"],"mappings":";;;;;;AA4BA,MAAM,6BACJ,mBAC2B;CAC3B,MAAM,iBACJ,UACW;;;4BAGa,QAAQ,sBAAsB,UAAU;AAElE,SAAQ,gBAAR;EACE,KAAK,MACH,QAAO;GACL,YAAY;;GAEZ,gBAAgB;GAChB,aAAa;GACd;EACH,KAAK,OACH,QAAO;GACL,YAAY;;EAElB,cAAc,OAAO;GACf,gBAAgB;GAChB,aAAa;GACd;EACH,KAAK,OACH,QAAO;GACL,YAAY,cAAc,OAAO;GACjC,gBAAgB;GAChB,aAAa;GACd;EACH,KAAK,MACH,QAAO;GACL,YAAY,cAAc,MAAM;GAChC,gBAAgB;GAChB,aAAa;GACd;;;;;;;;;;;;AAaP,MAAM,wBAAwB,mBAA2C;CACvE,MAAM,EAAE,YAAY,gBAAgB,gBAClC,0BAA0B,eAAe;AAE3C,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCP,WAAW;;eAEE,eAAe;;eAEf,YAAY;;eAEZ,YAAY;;;;;;;;;;;;;;;;;;AAmB3B,MAAM,wBAAwB,mBAA2C;CACvE,MAAM,EAAE,YAAY,gBAAgB,gBAClC,0BAA0B,eAAe;AAE3C,QAAO;;;;;;;;;;;;;;;;;EAiBP,WAAW;;eAEE,eAAe;;eAEf,YAAY;;eAEZ,YAAY;;;;AAK3B,MAAa,4BAA4B;AACzC,MAAa,4BAA4B;;;;;AAMzC,MAAa,sBACX,mBACyB,CACzB;CACE,UAAU;CACV,SAAS,qBAAqB,eAAe;CAC9C,EACD;CACE,UAAU;CACV,SAAS,qBAAqB,eAAe;CAC9C,CACF"}

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

@@ -0,0 +1,10 @@
+import { ensureNamedImport, firstInsertIndex, isModuleScopeBinding } from "./astImports.mjs";
+import { enableIntlayerEditorConfig, getMetroConfigTemplate, replaceViteConfigPluginImportSource, setIntlayerConfigRoutingMode, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n } from "./configManipulation.mjs";
+import { detectJsonLocalePattern, detectLinguiCatalogPattern, detectNextIntlMessagesPattern, ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "./fileSystem.mjs";
+import { GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, getGithubWorkflows } from "./githubActions.mjs";
+import { parseJSONWithComments } from "./jsonParser.mjs";
+import { detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages } from "./packageManager.mjs";
+import { NEXT_INTLAYER_BABEL_CONFIG_CONTENT, setupNextCompilerBabelConfig } from "./nextCompilerBabel.mjs";
+import { findTsConfigFiles } from "./tsConfig.mjs";
+
+export { GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, detectJsonLocalePattern, detectLinguiCatalogPattern, detectMissingIntlayerPackages, detectNextIntlMessagesPattern, detectOutdatedIntlayerPackages, detectPackageManager, enableIntlayerEditorConfig, ensureDirectory, ensureNamedImport, exists, findTsConfigFiles, firstInsertIndex, getGithubWorkflows, getInstalledPackageVersion, getMetroConfigTemplate, installPackages, isIntlayerPackageName, isModuleScopeBinding, normalizeVersion, parseJSONWithComments, readFileFromRoot, replaceViteConfigPluginImportSource, setIntlayerConfigRoutingMode, setupNextCompilerBabelConfig, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n, upgradePackages, writeFileToRoot };

package/dist/esm/init/utils/jsonParser.mjs

@@ -0,0 +1,41 @@
+//#region src/init/utils/jsonParser.ts
+/**
+* Helper to parse JSON that may contain comments (tsconfig allows comments)
+*/
+const parseJSONWithComments = (jsonString) => {
+	try {
+		return JSON.parse(jsonString);
+	} catch {}
+	const cleanedLines = jsonString.split("\n").map((line) => {
+		let inString = false;
+		let result = "";
+		for (let i = 0; i < line.length; i++) {
+			const char = line[i];
+			const nextChar = line[i + 1];
+			if (char === "\"" && (i === 0 || line[i - 1] !== "\\")) {
+				inString = !inString;
+				result += char;
+				continue;
+			}
+			if (inString) {
+				result += char;
+				continue;
+			}
+			if (char === "/" && nextChar === "/") break;
+			if (char === "/" && nextChar === "*") {
+				const endIndex = line.indexOf("*/", i + 2);
+				if (endIndex !== -1) {
+					i = endIndex + 1;
+					continue;
+				}
+			}
+			result += char;
+		}
+		return result;
+	});
+	return JSON.parse(cleanedLines.join("\n"));
+};
+
+//#endregion
+export { parseJSONWithComments };
+//# sourceMappingURL=jsonParser.mjs.map

package/dist/esm/init/utils/jsonParser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonParser.mjs","names":[],"sources":["../../../../src/init/utils/jsonParser.ts"],"sourcesContent":["/**\n * Helper to parse JSON that may contain comments (tsconfig allows comments)\n */\nexport const parseJSONWithComments = (jsonString: string) => {\n  // First, try parsing as-is (most tsconfig files don't have comments)\n  try {\n    return JSON.parse(jsonString);\n  } catch {\n    // If that fails, try stripping comments\n    // Note: This simple approach removes comments line by line to avoid\n    // matching glob patterns like /* and */ that appear in paths\n  }\n\n  // Process line by line to safely remove comments\n  const lines = jsonString.split('\\n');\n  const cleanedLines = lines.map((line) => {\n    // Track if we're inside a string\n    let inString = false;\n    let result = '';\n\n    for (let i = 0; i < line.length; i++) {\n      const char = line[i];\n      const nextChar = line[i + 1];\n\n      // Handle string boundaries (accounting for escaped quotes)\n      if (char === '\"' && (i === 0 || line[i - 1] !== '\\\\')) {\n        inString = !inString;\n        result += char;\n        continue;\n      }\n\n      // If we're inside a string, keep the character\n      if (inString) {\n        result += char;\n        continue;\n      }\n\n      // Check for single-line comment outside of strings\n      if (char === '/' && nextChar === '/') {\n        // Rest of line is a comment, stop here\n        break;\n      }\n\n      // Check for multi-line comment start (/* ... */)\n      // For simplicity, we only handle single-line /* */ comments here\n      if (char === '/' && nextChar === '*') {\n        const endIndex = line.indexOf('*/', i + 2);\n        if (endIndex !== -1) {\n          // Skip the comment\n          i = endIndex + 1;\n          continue;\n        }\n      }\n\n      result += char;\n    }\n\n    return result;\n  });\n\n  return JSON.parse(cleanedLines.join('\\n'));\n};\n"],"mappings":";;;;AAGA,MAAa,yBAAyB,eAAuB;AAE3D,KAAI;AACF,SAAO,KAAK,MAAM,WAAW;SACvB;CAQR,MAAM,eADQ,WAAW,MAAM,KACL,CAAC,KAAK,SAAS;EAEvC,IAAI,WAAW;EACf,IAAI,SAAS;AAEb,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;GACpC,MAAM,OAAO,KAAK;GAClB,MAAM,WAAW,KAAK,IAAI;AAG1B,OAAI,SAAS,SAAQ,MAAM,KAAK,KAAK,IAAI,OAAO,OAAO;AACrD,eAAW,CAAC;AACZ,cAAU;AACV;;AAIF,OAAI,UAAU;AACZ,cAAU;AACV;;AAIF,OAAI,SAAS,OAAO,aAAa,IAE/B;AAKF,OAAI,SAAS,OAAO,aAAa,KAAK;IACpC,MAAM,WAAW,KAAK,QAAQ,MAAM,IAAI,EAAE;AAC1C,QAAI,aAAa,IAAI;AAEnB,SAAI,WAAW;AACf;;;AAIJ,aAAU;;AAGZ,SAAO;GACP;AAEF,QAAO,KAAK,MAAM,aAAa,KAAK,KAAK,CAAC"}