@intlayer/cli 9.5.9 → 9.5.11

package/dist/cjs/init.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"init.cjs","names":["resolve","existsSync","join","readFileSync","loadPrompts","detectCompatI18nLibraries","initIntlayer","initSkills","initMCP","initInfra","login","setupCmsCredentials"],"sources":["../../src/init.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\nimport {\n  detectCompatI18nLibraries,\n  type InitOptions,\n  initIntlayer,\n  type RoutingMode,\n  setupCmsCredentials,\n} from '@intlayer/engine/cli';\nimport { login } from './auth/login';\nimport { initInfra } from './initInfra';\nimport { initMCP } from './initMCP';\nimport { initSkills } from './initSkills';\nimport { loadPrompts } from './loadPrompts';\n\nexport const findProjectRoot = (startDir: string) => {\n  let currentDir = startDir;\n\n  while (currentDir !== resolve(currentDir, '..')) {\n    if (existsSync(join(currentDir, 'package.json'))) {\n      return currentDir;\n    }\n    currentDir = resolve(currentDir, '..');\n  }\n\n  // If no package.json is found, return the start directory.\n  // The initIntlayer function will handle the missing package.json error.\n  return startDir;\n};\n\n/** Individually selectable setup steps exposed by the interactive init flow. */\ntype InitStep =\n  | 'packages'\n  | 'githubActions'\n  | 'projectSetup'\n  | 'vscodeExtension'\n  | 'lsp'\n  | 'eslint'\n  | 'skills'\n  | 'mcp'\n  | 'infra'\n  | 'cms';\n\n/** A checkbox entry of the interactive init flow. */\ntype InitStepOption = {\n  value: InitStep;\n  label: string;\n  hint: string;\n};\n\n/**\n * Steps shown but not pre-selected. The infrastructure installer touches the\n * machine (downloads an app, pulls Docker images) rather than the project, so\n * it must be an explicit choice.\n */\nconst OPT_IN_INIT_STEPS: InitStep[] = ['infra'];\n\n/** Grouped checkbox entries of the interactive init flow, in display order. */\nconst INIT_STEP_GROUPS: Record<string, InitStepOption[]> = {\n  Codebase: [\n    {\n      value: 'packages',\n      label: 'Install & upgrade packages',\n      hint: 'install missing Intlayer dependencies and upgrade outdated ones',\n    },\n    {\n      value: 'projectSetup',\n      label: 'Project setup',\n      hint: 'intlayer config, tsconfig, bundler plugin, middleware/proxy and providers in layout/page',\n    },\n    {\n      value: 'githubActions',\n      label: 'CI/CD (GitHub Actions)',\n      hint: 'scaffold the fill and test workflows that run on every pull request (covers every project in a monorepo)',\n    },\n  ],\n  DevTools: [\n    {\n      value: 'vscodeExtension',\n      label: 'VS Code extension',\n      hint: 'recommend the Intlayer extension',\n    },\n    {\n      value: 'eslint',\n      label: 'Lint rules (ESLint / oxlint)',\n      hint: 'flag hardcoded text and dynamic calls the compiler cannot optimize',\n    },\n  ],\n  'Coding assistant': [\n    {\n      value: 'skills',\n      label: 'AI skills',\n      hint: 'install the Intlayer documentation as agent skills',\n    },\n    {\n      value: 'mcp',\n      label: 'MCP server',\n      hint: 'configure the Intlayer MCP server',\n    },\n    {\n      value: 'lsp',\n      label: 'Editor LSP',\n      hint: 'go-to-definition from keys to .content files',\n    },\n  ],\n  CMS: [\n    {\n      value: 'cms',\n      label: 'CMS',\n      hint: 'log in through your browser, then store the credentials in your .env',\n    },\n    {\n      value: 'infra',\n      label: 'Infrastructure (desktop app / self-hosting)',\n      hint: 'install the desktop app, or self-host with Docker (all-in-one or Compose)',\n    },\n  ],\n};\n\n/** Locale routing strategies offered by the interactive init flow. */\nconst ROUTING_MODE_OPTIONS: Array<{\n  value: RoutingMode;\n  label: string;\n  hint: string;\n}> = [\n  {\n    value: 'prefix-no-default',\n    label: 'Prefix all except the default locale',\n    hint: '/about, /fr/about (default)',\n  },\n  {\n    value: 'prefix-all',\n    label: 'Prefix all locales',\n    hint: '/en/about, /fr/about',\n  },\n  {\n    value: 'no-prefix',\n    label: 'No locale in the URL',\n    hint: '/about',\n  },\n  {\n    value: 'search-params',\n    label: 'Use a search parameter',\n    hint: '/about?locale=fr',\n  },\n];\n\n/** Reads the merged dependencies of the project at `root`. */\nconst getProjectDependencies = (root: string): Record<string, string> => {\n  try {\n    const packageJsonPath = join(root, 'package.json');\n    if (!existsSync(packageJsonPath)) return {};\n    const { dependencies = {}, devDependencies = {} } = JSON.parse(\n      readFileSync(packageJsonPath, 'utf-8')\n    );\n    return { ...dependencies, ...devDependencies };\n  } catch {\n    return {};\n  }\n};\n\n/**\n * Returns true when the project uses a URL-based router for which a locale\n * routing strategy is meaningful: Next.js, React Router, or TanStack Router.\n * Apps without URL routing (e.g. React Native / Expo) are excluded, since\n * `routing.mode` has no effect there.\n */\nconst hasUrlRouting = (root: string): boolean => {\n  const deps = getProjectDependencies(root);\n\n  // React Native / Expo apps have no URL routing — never ask for a strategy.\n  if (deps['react-native'] || deps.expo) return false;\n\n  return Boolean(\n    deps.next ||\n      deps['react-router'] ||\n      deps['react-router-dom'] ||\n      deps['@tanstack/react-router'] ||\n      deps['@tanstack/react-start']\n  );\n};\n\n/**\n * Runs `init` in interactive mode: prompts the user with a checkbox of setup\n * steps, then forwards the selection to {@link initIntlayer} (packages, GitHub\n * Actions, VS Code extension, LSP) and runs the dedicated skills/MCP installers\n * for the steps that own their own prompts. The `.gitignore` entry is not\n * offered as a checkbox — it is always added (unless `--no-gitignore` is set).\n */\nconst runInteractiveInit = async (\n  root: string,\n  baseOptions?: InitOptions\n): Promise<void> => {\n  const p = await loadPrompts();\n\n  p.intro('Initialize Intlayer');\n\n  const selected = await p.groupMultiselect<InitStep>({\n    message: 'Select what you want to set up:',\n    options: INIT_STEP_GROUPS,\n    initialValues: Object.values(INIT_STEP_GROUPS)\n      .flat()\n      .map((option) => option.value)\n      .filter((step) => !OPT_IN_INIT_STEPS.includes(step)),\n    required: false,\n  });\n\n  if (p.isCancel(selected)) {\n    p.cancel('Operation cancelled.');\n    return;\n  }\n\n  const steps = selected as InitStep[];\n\n  // Locale routing strategy → written to `routing.mode` in the config file.\n  // Only relevant for URL-based routers (Next.js, React Router, TanStack);\n  // skipped for apps without URL routing such as React Native / Expo.\n  let routingMode: RoutingMode | undefined;\n\n  if (steps.includes('projectSetup') && hasUrlRouting(root)) {\n    const selectedRoutingMode = await p.select<RoutingMode>({\n      message: 'Which locale routing strategy do you want?',\n      options: ROUTING_MODE_OPTIONS,\n      initialValue: 'prefix-no-default',\n    });\n\n    if (p.isCancel(selectedRoutingMode)) {\n      p.cancel('Operation cancelled.');\n      return;\n    }\n\n    routingMode = selectedRoutingMode;\n  }\n\n  // Compat i18n library detection — never asked, always derived from the\n  // installed packages. `detectMissingIntlayerPackages` reads the very same\n  // dependency map to schedule the compat adapter, the sync plugin and the\n  // catalog template, so a project without any of those packages is simply set\n  // up on Intlayer alone.\n  const detectedCompatLibraries = detectCompatI18nLibraries(\n    getProjectDependencies(root)\n  );\n  const hasCompatLib = detectedCompatLibraries.length > 0;\n\n  if (hasCompatLib) {\n    p.log.info(\n      `Detected existing i18n ${detectedCompatLibraries.length > 1 ? 'libraries' : 'library'}: ${detectedCompatLibraries.join(', ')} — the matching Intlayer compat adapter and catalog sync will be set up.`\n    );\n  }\n\n  const options: InitOptions = {\n    ...baseOptions,\n    routingMode,\n    noInstallPackages: !steps.includes('packages'),\n    // The `.gitignore` entry is never offered as a checkbox: in interactive\n    // mode we always add `.intlayer` to `.gitignore`, only honoring an explicit\n    // `--no-gitignore` flag from the command line.\n    noGitignore: baseOptions?.noGitignore,\n    // Respect explicit `--no-*` flags from the command line even when the\n    // corresponding step is selected in the checkbox.\n    noGithubActions:\n      baseOptions?.noGithubActions || !steps.includes('githubActions'),\n    noFrameworkSetup:\n      baseOptions?.noFrameworkSetup || !steps.includes('projectSetup'),\n    noVscodeExtension: !steps.includes('vscodeExtension'),\n    noLsp: !steps.includes('lsp'),\n    noEslint: !steps.includes('eslint'),\n  };\n\n  await initIntlayer(root, options);\n\n  // Skills ask for the platform after the skill selection; MCP reuses it.\n  const skillsPlatform = steps.includes('skills')\n    ? await initSkills(root)\n    : undefined;\n\n  if (steps.includes('mcp')) {\n    await initMCP(root, skillsPlatform);\n  }\n\n  // Delegated to the hosted install script, which owns its own menu.\n  if (steps.includes('infra')) {\n    await initInfra();\n  }\n\n  // CMS / visual editor runs last: the browser login persists the access-key\n  // credentials to `.env` and enables the editor in the config file. Kept last\n  // so the browser flow does not interrupt setup.\n  if (steps.includes('cms')) {\n    p.log.info('Opening your browser to log in to the Intlayer CMS...');\n    // `exitAfter: false` keeps the process alive so the flow can finish; the\n    // credentials are persisted to `.env` and the editor enabled in the config.\n    await login({\n      exitAfter: false,\n      onCredentials: (credentials) => setupCmsCredentials(root, credentials),\n    });\n  }\n\n  p.outro('Intlayer initialization complete');\n};\n\nexport const init = async (\n  projectRoot?: string,\n  options?: InitOptions,\n  interactive?: boolean\n) => {\n  const root = projectRoot\n    ? findProjectRoot(resolve(projectRoot))\n    : findProjectRoot(process.cwd());\n\n  if (interactive) {\n    await runInteractiveInit(root, options);\n    return;\n  }\n\n  await initIntlayer(root, options);\n};\n"],"mappings":"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"}
+{"version":3,"file":"init.cjs","names":["resolve","existsSync","join","hasLintTooling","readFileSync","loadPrompts","detectCompatI18nLibraries","hasUrlRoutingFramework","initIntlayer","initSkills","initMCP","initInfra","initChromeExtension","login","setupCmsCredentials"],"sources":["../../src/init.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\nimport {\n  detectCompatI18nLibraries,\n  hasLintTooling,\n  hasUrlRoutingFramework,\n  type InitOptions,\n  initIntlayer,\n  logInitSuccessMessage,\n  type RoutingMode,\n  setupCmsCredentials,\n} from '@intlayer/engine/cli';\nimport { login } from './auth/login';\nimport { initChromeExtension } from './initChromeExtension';\nimport { initInfra } from './initInfra';\nimport { initMCP } from './initMCP';\nimport { initSkills } from './initSkills';\nimport { loadPrompts } from './loadPrompts';\n\nexport const findProjectRoot = (startDir: string) => {\n  let currentDir = startDir;\n\n  while (currentDir !== resolve(currentDir, '..')) {\n    if (existsSync(join(currentDir, 'package.json'))) {\n      return currentDir;\n    }\n    currentDir = resolve(currentDir, '..');\n  }\n\n  // If no package.json is found, return the start directory.\n  // The initIntlayer function will handle the missing package.json error.\n  return startDir;\n};\n\n/** Individually selectable setup steps exposed by the interactive init flow. */\nexport type InitStep =\n  | 'packages'\n  | 'githubActions'\n  | 'projectSetup'\n  | 'vscodeExtension'\n  | 'lsp'\n  | 'eslint'\n  | 'skills'\n  | 'mcp'\n  | 'infra'\n  | 'cms'\n  | 'chromeExtension';\n\n/** A checkbox entry of the interactive init flow. */\nexport type InitStepOption = {\n  value: InitStep;\n  label: string;\n  hint: string;\n};\n\n/**\n * Steps shown but not pre-selected. The infrastructure installer touches the\n * machine (downloads an app, pulls Docker images) and browser extensions open external URLs\n * rather than modifying the project, so they must be an explicit choice.\n */\nexport const OPT_IN_INIT_STEPS: InitStep[] = ['infra', 'chromeExtension'];\n\n/** Grouped checkbox entries of the interactive init flow, in display order. */\nexport const INIT_STEP_GROUPS: Record<string, InitStepOption[]> = {\n  Codebase: [\n    {\n      value: 'packages',\n      label: 'Install & upgrade packages',\n      hint: 'install missing Intlayer dependencies and upgrade outdated ones',\n    },\n    {\n      value: 'projectSetup',\n      label: 'Project setup',\n      hint: 'intlayer config, tsconfig, bundler plugin, middleware/proxy and providers in layout/page',\n    },\n    {\n      value: 'githubActions',\n      label: 'CI/CD (GitHub Actions)',\n      hint: 'scaffold the fill and test workflows that run on every pull request (covers every project in a monorepo)',\n    },\n  ],\n  DevTools: [\n    {\n      value: 'vscodeExtension',\n      label: 'VS Code extension',\n      hint: 'recommend the Intlayer extension',\n    },\n    {\n      value: 'eslint',\n      label: 'Lint rules (ESLint / oxlint)',\n      hint: 'flag hardcoded text and dynamic calls the compiler cannot optimize',\n    },\n    {\n      value: 'chromeExtension',\n      label: 'Chrome extension',\n      hint: 'for audit, debug and analysis purpose',\n    },\n  ],\n  'Coding assistant': [\n    {\n      value: 'skills',\n      label: 'AI skills',\n      hint: 'install the Intlayer documentation as agent skills',\n    },\n    {\n      value: 'mcp',\n      label: 'MCP server',\n      hint: 'configure the Intlayer MCP server',\n    },\n    {\n      value: 'lsp',\n      label: 'Editor LSP',\n      hint: 'go-to-definition from keys to .content files',\n    },\n  ],\n  CMS: [\n    {\n      value: 'cms',\n      label: 'CMS',\n      hint: 'log in through your browser, then store the credentials in your .env',\n    },\n    {\n      value: 'infra',\n      label: 'Infrastructure (desktop app / self-hosting)',\n      hint: 'install the desktop app, or self-host with Docker (all-in-one or Compose)',\n    },\n  ],\n};\n\n/**\n * Locale routing choice: a `routing.mode` served through the locale proxy, or\n * `none` to leave routing to the app (`no-prefix` with the proxy disabled).\n */\nexport type LocaleRoutingChoice = RoutingMode | 'none';\n\n/** Locale routing strategies offered by the interactive init flow. */\nconst ROUTING_OPTIONS: Array<{\n  value: LocaleRoutingChoice;\n  label: string;\n  hint: string;\n}> = [\n  {\n    value: 'prefix-no-default',\n    label: 'Prefix all except the default locale',\n    hint: '/about, /fr/about (default)',\n  },\n  {\n    value: 'prefix-all',\n    label: 'Prefix all locales',\n    hint: '/en/about, /fr/about',\n  },\n  {\n    value: 'no-prefix',\n    label: 'No locale in the URL',\n    hint: '/about',\n  },\n  {\n    value: 'search-params',\n    label: 'Use a search parameter',\n    hint: '/about?locale=fr',\n  },\n  {\n    value: 'none',\n    label: 'No locale routing',\n    hint: 'no proxy, no locale route segment — handle the locale yourself',\n  },\n];\n\n/** Locale routing choices accepted by `--routing`. */\nexport const LOCALE_ROUTING_CHOICES = ROUTING_OPTIONS.map(\n  (option) => option.value\n);\n\n/** Validates a `--routing` value, throwing on an unknown choice. */\nexport const parseLocaleRoutingChoice = (\n  value: string\n): LocaleRoutingChoice => {\n  const choice = LOCALE_ROUTING_CHOICES.find((routing) => routing === value);\n\n  if (!choice) {\n    throw new Error(\n      `Invalid --routing value \"${value}\". Expected one of: ${LOCALE_ROUTING_CHOICES.join(', ')}.`\n    );\n  }\n\n  return choice;\n};\n\n/** Maps a routing choice to the init options it sets. */\nexport const getRoutingInitOptions = (\n  choice: LocaleRoutingChoice\n): Pick<InitOptions, 'routingMode' | 'enableProxy'> =>\n  choice === 'none'\n    ? { routingMode: 'no-prefix', enableProxy: false }\n    : { routingMode: choice, enableProxy: true };\n\n/** Known ESLint and oxlint configuration file names. */\nexport const ESLINT_CONFIG_FILES = [\n  'eslint.config.js',\n  'eslint.config.mjs',\n  'eslint.config.cjs',\n  'eslint.config.ts',\n  'eslint.config.mts',\n  'eslint.config.cts',\n  '.eslintrc.js',\n  '.eslintrc.cjs',\n  '.eslintrc.yaml',\n  '.eslintrc.yml',\n  '.eslintrc.json',\n  '.eslintrc',\n  '.oxlintrc.json',\n];\n\n/**\n * Checks whether ESLint or a compatible linter (oxlint) is installed or\n * configured in the project.\n */\nexport const isEslintInstalled = (\n  dependencies: Record<string, string>,\n  root?: string\n): boolean => {\n  if (hasLintTooling(dependencies)) return true;\n  if (dependencies.eslint || dependencies.oxlint) return true;\n\n  if (root) {\n    return ESLINT_CONFIG_FILES.some((file) => existsSync(join(root, file)));\n  }\n\n  return false;\n};\n\n/**\n * Computes the initial setup steps selected by default in the interactive prompt.\n * Steps like infrastructure and browser extension require opt-in, while\n * eslint is preselected only if installed on the project.\n */\nexport const getInitialInitSteps = (\n  dependencies: Record<string, string>,\n  root?: string\n): InitStep[] => {\n  const isEslintPresent = isEslintInstalled(dependencies, root);\n\n  return Object.values(INIT_STEP_GROUPS)\n    .flat()\n    .map((option) => option.value)\n    .filter((step) => {\n      if (OPT_IN_INIT_STEPS.includes(step)) return false;\n      if (step === 'eslint' && !isEslintPresent) return false;\n      return true;\n    });\n};\n\n/** Reads the merged dependencies of the project at `root`. */\nexport const getProjectDependencies = (\n  root: string\n): Record<string, string> => {\n  try {\n    const packageJsonPath = join(root, 'package.json');\n    if (!existsSync(packageJsonPath)) return {};\n    const { dependencies = {}, devDependencies = {} } = JSON.parse(\n      readFileSync(packageJsonPath, 'utf-8')\n    );\n    return { ...dependencies, ...devDependencies };\n  } catch {\n    return {};\n  }\n};\n\n/**\n * Runs `init` in interactive mode: prompts the user with a checkbox of setup\n * steps, then forwards the selection to {@link initIntlayer} (packages, GitHub\n * Actions, VS Code extension, LSP) and runs the dedicated skills/MCP installers\n * for the steps that own their own prompts. The `.gitignore` entry is not\n * offered as a checkbox — it is always added (unless `--no-gitignore` is set).\n */\nconst runInteractiveInit = async (\n  root: string,\n  baseOptions?: InitOptions\n): Promise<void> => {\n  const p = await loadPrompts();\n\n  p.intro('Initialize Intlayer');\n\n  const projectDependencies = getProjectDependencies(root);\n\n  const selected = await p.groupMultiselect<InitStep>({\n    message: 'Select what you want to set up:',\n    options: INIT_STEP_GROUPS,\n    initialValues: getInitialInitSteps(projectDependencies, root),\n    required: false,\n  });\n\n  if (p.isCancel(selected)) {\n    p.cancel('Operation cancelled.');\n    return;\n  }\n\n  const steps = selected as InitStep[];\n\n  // Compat i18n library detection — never asked, always derived from the\n  // installed packages. `detectMissingIntlayerPackages` reads the very same\n  // dependency map to schedule the compat adapter, the sync plugin and the\n  // catalog template, so a project without any of those packages is simply set\n  // up on Intlayer alone.\n  const detectedCompatLibraries =\n    detectCompatI18nLibraries(projectDependencies);\n  const hasCompatLib = detectedCompatLibraries.length > 0;\n\n  if (hasCompatLib) {\n    p.log.info(\n      `Detected existing i18n ${detectedCompatLibraries.length > 1 ? 'libraries' : 'library'}: ${detectedCompatLibraries.join(', ')} — the matching Intlayer compat adapter and catalog sync will be set up.`\n    );\n  }\n\n  // Locale routing → `routing.mode` + `routing.enableProxy` in the config, and\n  // the route segment the framework scaffolding creates. Only asked for web\n  // frontends; projects without URL routing (backend, React Native / Expo) keep\n  // only `routing.storage` in a freshly created config. Skipped for compat\n  // i18n libraries, which keep their own routing.\n  let routingOptions: Pick<InitOptions, 'routingMode' | 'enableProxy'> = {};\n\n  if (\n    steps.includes('projectSetup') &&\n    baseOptions?.routingMode === undefined &&\n    !hasCompatLib &&\n    hasUrlRoutingFramework(projectDependencies)\n  ) {\n    const selectedRouting = await p.select<LocaleRoutingChoice>({\n      message: 'How should the locale appear in your URLs?',\n      options: ROUTING_OPTIONS,\n      initialValue: 'prefix-no-default',\n    });\n\n    if (p.isCancel(selectedRouting)) {\n      p.cancel('Operation cancelled.');\n      return;\n    }\n\n    routingOptions = getRoutingInitOptions(selectedRouting);\n  }\n\n  const options: InitOptions = {\n    ...baseOptions,\n    ...routingOptions,\n    noInstallPackages: !steps.includes('packages'),\n    // The `.gitignore` entry is tied to project setup.\n    noGitignore: baseOptions?.noGitignore || !steps.includes('projectSetup'),\n    // Respect explicit `--no-*` flags from the command line even when the\n    // corresponding step is selected in the checkbox.\n    noGithubActions:\n      baseOptions?.noGithubActions || !steps.includes('githubActions'),\n    noFrameworkSetup:\n      baseOptions?.noFrameworkSetup || !steps.includes('projectSetup'),\n    noVscodeExtension: !steps.includes('vscodeExtension'),\n    noLsp: !steps.includes('lsp'),\n    noEslint: !steps.includes('eslint'),\n    skipFinalMessage: true,\n  };\n\n  const { guideUrl } = await initIntlayer(root, options);\n\n  // Skills ask for the platform after the skill selection; MCP reuses it.\n  const skillsPlatform = steps.includes('skills')\n    ? await initSkills(root)\n    : undefined;\n\n  if (steps.includes('mcp')) {\n    await initMCP(root, skillsPlatform);\n  }\n\n  // Delegated to the hosted install script, which owns its own menu.\n  if (steps.includes('infra')) {\n    await initInfra();\n  }\n\n  if (steps.includes('chromeExtension')) {\n    await initChromeExtension();\n  }\n\n  // CMS / visual editor runs last: the browser login persists the access-key\n  // credentials to `.env` and enables the editor in the config file. Kept last\n  // so the browser flow does not interrupt setup.\n  if (steps.includes('cms')) {\n    p.log.info('Opening your browser to log in to the Intlayer CMS...');\n    // `exitAfter: false` keeps the process alive so the flow can finish; the\n    // credentials are persisted to `.env` and the editor enabled in the config.\n    await login({\n      exitAfter: false,\n      onCredentials: (credentials) => setupCmsCredentials(root, credentials),\n    });\n  }\n\n  p.outro('Intlayer initialization complete');\n\n  if (guideUrl) {\n    logInitSuccessMessage(guideUrl);\n  }\n};\n\nexport const init = async (\n  projectRoot?: string,\n  options?: InitOptions,\n  interactive?: boolean\n) => {\n  const root = projectRoot\n    ? findProjectRoot(resolve(projectRoot))\n    : findProjectRoot(process.cwd());\n\n  if (interactive) {\n    await runInteractiveInit(root, options);\n    return;\n  }\n\n  await initIntlayer(root, options);\n};\n"],"mappings":"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"}

package/dist/cjs/initChromeExtension.cjs

@@ -0,0 +1,36 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils_openBrowser = require('./utils/openBrowser.cjs');
+const require_loadPrompts = require('./loadPrompts.cjs');
+
+//#region src/initChromeExtension.ts
+const CHROME_EXTENSION_URL = "https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc";
+const MOZILLA_EXTENSION_URL = "https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/";
+const BROWSER_EXTENSION_OPTIONS = [{
+	value: CHROME_EXTENSION_URL,
+	label: "Chrome",
+	hint: CHROME_EXTENSION_URL
+}, {
+	value: MOZILLA_EXTENSION_URL,
+	label: "Mozilla Firefox",
+	hint: MOZILLA_EXTENSION_URL
+}];
+const initChromeExtension = async () => {
+	const p = await require_loadPrompts.loadPrompts();
+	const selectedUrls = await p.multiselect({
+		message: "Select browser extension(s) to install:",
+		options: BROWSER_EXTENSION_OPTIONS,
+		required: false
+	});
+	if (p.isCancel(selectedUrls)) return;
+	if (Array.isArray(selectedUrls) && selectedUrls.length > 0) for (const url of selectedUrls) {
+		p.log.info(`Opening ${url} in your browser...`);
+		require_utils_openBrowser.openBrowser(url);
+	}
+};
+
+//#endregion
+exports.BROWSER_EXTENSION_OPTIONS = BROWSER_EXTENSION_OPTIONS;
+exports.CHROME_EXTENSION_URL = CHROME_EXTENSION_URL;
+exports.MOZILLA_EXTENSION_URL = MOZILLA_EXTENSION_URL;
+exports.initChromeExtension = initChromeExtension;
+//# sourceMappingURL=initChromeExtension.cjs.map

package/dist/cjs/initChromeExtension.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initChromeExtension.cjs","names":["loadPrompts"],"sources":["../../src/initChromeExtension.ts"],"sourcesContent":["import { loadPrompts } from './loadPrompts';\nimport { openBrowser } from './utils/openBrowser';\n\nexport const CHROME_EXTENSION_URL =\n  'https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc';\n\nexport const MOZILLA_EXTENSION_URL =\n  'https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/';\n\nexport const BROWSER_EXTENSION_OPTIONS = [\n  {\n    value: CHROME_EXTENSION_URL,\n    label: 'Chrome',\n    hint: CHROME_EXTENSION_URL,\n  },\n  {\n    value: MOZILLA_EXTENSION_URL,\n    label: 'Mozilla Firefox',\n    hint: MOZILLA_EXTENSION_URL,\n  },\n];\n\nexport const initChromeExtension = async () => {\n  const p = await loadPrompts();\n\n  const selectedUrls = await p.multiselect({\n    message: 'Select browser extension(s) to install:',\n    options: BROWSER_EXTENSION_OPTIONS,\n    required: false,\n  });\n\n  if (p.isCancel(selectedUrls)) {\n    return;\n  }\n\n  if (Array.isArray(selectedUrls) && selectedUrls.length > 0) {\n    for (const url of selectedUrls) {\n      p.log.info(`Opening ${url} in your browser...`);\n      openBrowser(url);\n    }\n  }\n};\n"],"mappings":";;;;;AAGA,MAAa,uBACX;AAEF,MAAa,wBACX;AAEF,MAAa,4BAA4B,CACvC;CACE,OAAO;CACP,OAAO;CACP,MAAM;AACR,GACA;CACE,OAAO;CACP,OAAO;CACP,MAAM;AACR,CACF;AAEA,MAAa,sBAAsB,YAAY;CAC7C,MAAM,IAAI,MAAMA,gCAAY;CAE5B,MAAM,eAAe,MAAM,EAAE,YAAY;EACvC,SAAS;EACT,SAAS;EACT,UAAU;CACZ,CAAC;CAED,IAAI,EAAE,SAAS,YAAY,GACzB;CAGF,IAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,SAAS,GACvD,KAAK,MAAM,OAAO,cAAc;EAC9B,EAAE,IAAI,KAAK,WAAW,IAAI,oBAAoB;EAC9C,sCAAY,GAAG;CACjB;AAEJ"}

package/dist/cjs/initInfra.cjs

@@ -75,7 +75,7 @@ const initInfra = async (options = {}) => {
 		if (!response.ok) throw new Error(`${response.status} ${response.statusText}`);
 		script = await response.text();
 	} catch (error) {
-		spinner.stop("Could not download the installer", 1);
+		spinner.stop("Could not download the installer");
 		p.log.error(`${error.message}\nRun it directly: ${process.platform === "win32" ? `irm ${scriptUrl} | iex` : `curl -fsSL ${scriptUrl} | sh`}`);
 		process.exitCode = 1;
 		return;

package/dist/cjs/initInfra.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"initInfra.cjs","names":["spawn","loadPrompts","mkdtemp","join","tmpdir","writeFile","rm"],"sources":["../../src/initInfra.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { loadPrompts } from './loadPrompts';\n\n/** Setup modes understood by the hosted installer. */\nexport const INFRA_MODES = ['desktop', 'docker', 'compose'] as const;\n\nexport type InfraMode = (typeof INFRA_MODES)[number];\n\n/**\n * The hosted installers are the single source of truth for the infrastructure\n * setup flow (desktop app, all-in-one container, Compose stack). The CLI runs\n * them rather than re-implementing the same steps in JavaScript.\n */\nexport const INSTALL_SCRIPT_URL = 'https://intlayer.org/install.sh';\nexport const INSTALL_SCRIPT_URL_WINDOWS = 'https://intlayer.org/install.ps1';\n\nexport type InitInfraOptions = {\n  /** Skip the interactive menu and run this mode directly. */\n  mode?: InfraMode;\n  /** Installer URL override (forks, staging). Defaults to the platform's script. */\n  scriptUrl?: string;\n};\n\n/** How to fetch and execute the installer on the current platform. */\ntype InstallerRunner = {\n  url: string;\n  fileName: string;\n  /** Builds the command and arguments that execute the downloaded script. */\n  command: (scriptPath: string, mode?: InfraMode) => [string, string[]];\n};\n\nconst POSIX_RUNNER: InstallerRunner = {\n  url: INSTALL_SCRIPT_URL,\n  fileName: 'install.sh',\n  command: (scriptPath, mode) => [\n    'sh',\n    [scriptPath, ...(mode ? ['--mode', mode] : [])],\n  ],\n};\n\nconst WINDOWS_RUNNER: InstallerRunner = {\n  url: INSTALL_SCRIPT_URL_WINDOWS,\n  fileName: 'install.ps1',\n  command: (scriptPath, mode) => [\n    'powershell',\n    [\n      '-NoProfile',\n      '-ExecutionPolicy',\n      'Bypass',\n      '-File',\n      scriptPath,\n      ...(mode ? ['-Mode', mode] : []),\n    ],\n  ],\n};\n\nconst getInstallerRunner = (): InstallerRunner =>\n  process.platform === 'win32' ? WINDOWS_RUNNER : POSIX_RUNNER;\n\n/**\n * Validates a user-provided mode against {@link INFRA_MODES}.\n *\n * @throws When the value is not a known mode.\n */\nexport const parseInfraMode = (value: string): InfraMode => {\n  if ((INFRA_MODES as readonly string[]).includes(value)) {\n    return value as InfraMode;\n  }\n\n  throw new Error(\n    `Unknown infra mode \"${value}\". Expected one of: ${INFRA_MODES.join(', ')}`\n  );\n};\n\n/**\n * Runs the installer with the terminal attached, so its own prompts and\n * progress bars reach the user unchanged.\n *\n * @returns The script's exit code.\n */\nconst runInstaller = (command: string, args: string[]): Promise<number> =>\n  new Promise((resolve, reject) => {\n    const child = spawn(command, args, { stdio: 'inherit' });\n\n    child.on('error', reject);\n    child.on('close', (code) => resolve(code ?? 1));\n  });\n\n/**\n * Downloads the hosted installer and runs it: desktop app, all-in-one Docker\n * container or Docker Compose stack, chosen interactively unless `mode` is set.\n *\n * Exposed as `intlayer init infra` and as a step of `intlayer init --interactive`.\n */\nexport const initInfra = async (\n  options: InitInfraOptions = {}\n): Promise<void> => {\n  const p = await loadPrompts();\n  const runner = getInstallerRunner();\n  const scriptUrl = options.scriptUrl ?? runner.url;\n\n  const spinner = p.spinner();\n  spinner.start(`Fetching ${scriptUrl}`);\n\n  let script: string;\n\n  try {\n    const response = await fetch(scriptUrl);\n\n    if (!response.ok) {\n      throw new Error(`${response.status} ${response.statusText}`);\n    }\n\n    script = await response.text();\n  } catch (error) {\n    spinner.stop('Could not download the installer', 1);\n    p.log.error(\n      `${(error as Error).message}\\nRun it directly: ${\n        process.platform === 'win32'\n          ? `irm ${scriptUrl} | iex`\n          : `curl -fsSL ${scriptUrl} | sh`\n      }`\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  spinner.stop('Installer downloaded');\n\n  const directory = await mkdtemp(join(tmpdir(), 'intlayer-install-'));\n  const scriptPath = join(directory, runner.fileName);\n\n  try {\n    await writeFile(scriptPath, script, { mode: 0o700 });\n\n    const [command, args] = runner.command(scriptPath, options.mode);\n    const exitCode = await runInstaller(command, args);\n\n    if (exitCode !== 0) {\n      process.exitCode = exitCode;\n    }\n  } finally {\n    await rm(directory, { recursive: true, force: true });\n  }\n};\n"],"mappings":";;;;;;;;;AAOA,MAAa,cAAc;CAAC;CAAW;CAAU;AAAS;;;;;;AAS1D,MAAa,qBAAqB;AAClC,MAAa,6BAA6B;AAiB1C,MAAM,eAAgC;CACpC,KAAK;CACL,UAAU;CACV,UAAU,YAAY,SAAS,CAC7B,MACA,CAAC,YAAY,GAAI,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAE,CAChD;AACF;AAEA,MAAM,iBAAkC;CACtC,KAAK;CACL,UAAU;CACV,UAAU,YAAY,SAAS,CAC7B,cACA;EACE;EACA;EACA;EACA;EACA;EACA,GAAI,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;CAChC,CACF;AACF;AAEA,MAAM,2BACJ,QAAQ,aAAa,UAAU,iBAAiB;;;;;;AAOlD,MAAa,kBAAkB,UAA6B;CAC1D,IAAK,YAAkC,SAAS,KAAK,GACnD,OAAO;CAGT,MAAM,IAAI,MACR,uBAAuB,MAAM,sBAAsB,YAAY,KAAK,IAAI,GAC1E;AACF;;;;;;;AAQA,MAAM,gBAAgB,SAAiB,SACrC,IAAI,SAAS,SAAS,WAAW;CAC/B,MAAM,YAAQA,0BAAM,SAAS,MAAM,EAAE,OAAO,UAAU,CAAC;CAEvD,MAAM,GAAG,SAAS,MAAM;CACxB,MAAM,GAAG,UAAU,SAAS,QAAQ,QAAQ,CAAC,CAAC;AAChD,CAAC;;;;;;;AAQH,MAAa,YAAY,OACvB,UAA4B,CAAC,MACX;CAClB,MAAM,IAAI,MAAMC,gCAAY;CAC5B,MAAM,SAAS,mBAAmB;CAClC,MAAM,YAAY,QAAQ,aAAa,OAAO;CAE9C,MAAM,UAAU,EAAE,QAAQ;CAC1B,QAAQ,MAAM,YAAY,WAAW;CAErC,IAAI;CAEJ,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,SAAS;EAEtC,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,GAAG,SAAS,OAAO,GAAG,SAAS,YAAY;EAG7D,SAAS,MAAM,SAAS,KAAK;CAC/B,SAAS,OAAO;EACd,QAAQ,KAAK,oCAAoC,CAAC;EAClD,EAAE,IAAI,MACJ,GAAI,MAAgB,QAAQ,qBAC1B,QAAQ,aAAa,UACjB,OAAO,UAAU,UACjB,cAAc,UAAU,QAEhC;EACA,QAAQ,WAAW;EACnB;CACF;CAEA,QAAQ,KAAK,sBAAsB;CAEnC,MAAM,YAAY,UAAMC,8BAAQC,oBAAKC,gBAAO,GAAG,mBAAmB,CAAC;CACnE,MAAM,iBAAaD,gBAAK,WAAW,OAAO,QAAQ;CAElD,IAAI;EACF,UAAME,4BAAU,YAAY,QAAQ,EAAE,MAAM,IAAM,CAAC;EAEnD,MAAM,CAAC,SAAS,QAAQ,OAAO,QAAQ,YAAY,QAAQ,IAAI;EAC/D,MAAM,WAAW,MAAM,aAAa,SAAS,IAAI;EAEjD,IAAI,aAAa,GACf,QAAQ,WAAW;CAEvB,UAAU;EACR,UAAMC,qBAAG,WAAW;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;CACtD;AACF"}
+{"version":3,"file":"initInfra.cjs","names":["spawn","loadPrompts","mkdtemp","join","tmpdir","writeFile","rm"],"sources":["../../src/initInfra.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { loadPrompts } from './loadPrompts';\n\n/** Setup modes understood by the hosted installer. */\nexport const INFRA_MODES = ['desktop', 'docker', 'compose'] as const;\n\nexport type InfraMode = (typeof INFRA_MODES)[number];\n\n/**\n * The hosted installers are the single source of truth for the infrastructure\n * setup flow (desktop app, all-in-one container, Compose stack). The CLI runs\n * them rather than re-implementing the same steps in JavaScript.\n */\nexport const INSTALL_SCRIPT_URL = 'https://intlayer.org/install.sh';\nexport const INSTALL_SCRIPT_URL_WINDOWS = 'https://intlayer.org/install.ps1';\n\nexport type InitInfraOptions = {\n  /** Skip the interactive menu and run this mode directly. */\n  mode?: InfraMode;\n  /** Installer URL override (forks, staging). Defaults to the platform's script. */\n  scriptUrl?: string;\n};\n\n/** How to fetch and execute the installer on the current platform. */\ntype InstallerRunner = {\n  url: string;\n  fileName: string;\n  /** Builds the command and arguments that execute the downloaded script. */\n  command: (scriptPath: string, mode?: InfraMode) => [string, string[]];\n};\n\nconst POSIX_RUNNER: InstallerRunner = {\n  url: INSTALL_SCRIPT_URL,\n  fileName: 'install.sh',\n  command: (scriptPath, mode) => [\n    'sh',\n    [scriptPath, ...(mode ? ['--mode', mode] : [])],\n  ],\n};\n\nconst WINDOWS_RUNNER: InstallerRunner = {\n  url: INSTALL_SCRIPT_URL_WINDOWS,\n  fileName: 'install.ps1',\n  command: (scriptPath, mode) => [\n    'powershell',\n    [\n      '-NoProfile',\n      '-ExecutionPolicy',\n      'Bypass',\n      '-File',\n      scriptPath,\n      ...(mode ? ['-Mode', mode] : []),\n    ],\n  ],\n};\n\nconst getInstallerRunner = (): InstallerRunner =>\n  process.platform === 'win32' ? WINDOWS_RUNNER : POSIX_RUNNER;\n\n/**\n * Validates a user-provided mode against {@link INFRA_MODES}.\n *\n * @throws When the value is not a known mode.\n */\nexport const parseInfraMode = (value: string): InfraMode => {\n  if ((INFRA_MODES as readonly string[]).includes(value)) {\n    return value as InfraMode;\n  }\n\n  throw new Error(\n    `Unknown infra mode \"${value}\". Expected one of: ${INFRA_MODES.join(', ')}`\n  );\n};\n\n/**\n * Runs the installer with the terminal attached, so its own prompts and\n * progress bars reach the user unchanged.\n *\n * @returns The script's exit code.\n */\nconst runInstaller = (command: string, args: string[]): Promise<number> =>\n  new Promise((resolve, reject) => {\n    const child = spawn(command, args, { stdio: 'inherit' });\n\n    child.on('error', reject);\n    child.on('close', (code) => resolve(code ?? 1));\n  });\n\n/**\n * Downloads the hosted installer and runs it: desktop app, all-in-one Docker\n * container or Docker Compose stack, chosen interactively unless `mode` is set.\n *\n * Exposed as `intlayer init infra` and as a step of `intlayer init --interactive`.\n */\nexport const initInfra = async (\n  options: InitInfraOptions = {}\n): Promise<void> => {\n  const p = await loadPrompts();\n  const runner = getInstallerRunner();\n  const scriptUrl = options.scriptUrl ?? runner.url;\n\n  const spinner = p.spinner();\n  spinner.start(`Fetching ${scriptUrl}`);\n\n  let script: string;\n\n  try {\n    const response = await fetch(scriptUrl);\n\n    if (!response.ok) {\n      throw new Error(`${response.status} ${response.statusText}`);\n    }\n\n    script = await response.text();\n  } catch (error) {\n    spinner.stop('Could not download the installer');\n    p.log.error(\n      `${(error as Error).message}\\nRun it directly: ${\n        process.platform === 'win32'\n          ? `irm ${scriptUrl} | iex`\n          : `curl -fsSL ${scriptUrl} | sh`\n      }`\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  spinner.stop('Installer downloaded');\n\n  const directory = await mkdtemp(join(tmpdir(), 'intlayer-install-'));\n  const scriptPath = join(directory, runner.fileName);\n\n  try {\n    await writeFile(scriptPath, script, { mode: 0o700 });\n\n    const [command, args] = runner.command(scriptPath, options.mode);\n    const exitCode = await runInstaller(command, args);\n\n    if (exitCode !== 0) {\n      process.exitCode = exitCode;\n    }\n  } finally {\n    await rm(directory, { recursive: true, force: true });\n  }\n};\n"],"mappings":";;;;;;;;;AAOA,MAAa,cAAc;CAAC;CAAW;CAAU;AAAS;;;;;;AAS1D,MAAa,qBAAqB;AAClC,MAAa,6BAA6B;AAiB1C,MAAM,eAAgC;CACpC,KAAK;CACL,UAAU;CACV,UAAU,YAAY,SAAS,CAC7B,MACA,CAAC,YAAY,GAAI,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAE,CAChD;AACF;AAEA,MAAM,iBAAkC;CACtC,KAAK;CACL,UAAU;CACV,UAAU,YAAY,SAAS,CAC7B,cACA;EACE;EACA;EACA;EACA;EACA;EACA,GAAI,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;CAChC,CACF;AACF;AAEA,MAAM,2BACJ,QAAQ,aAAa,UAAU,iBAAiB;;;;;;AAOlD,MAAa,kBAAkB,UAA6B;CAC1D,IAAK,YAAkC,SAAS,KAAK,GACnD,OAAO;CAGT,MAAM,IAAI,MACR,uBAAuB,MAAM,sBAAsB,YAAY,KAAK,IAAI,GAC1E;AACF;;;;;;;AAQA,MAAM,gBAAgB,SAAiB,SACrC,IAAI,SAAS,SAAS,WAAW;CAC/B,MAAM,YAAQA,0BAAM,SAAS,MAAM,EAAE,OAAO,UAAU,CAAC;CAEvD,MAAM,GAAG,SAAS,MAAM;CACxB,MAAM,GAAG,UAAU,SAAS,QAAQ,QAAQ,CAAC,CAAC;AAChD,CAAC;;;;;;;AAQH,MAAa,YAAY,OACvB,UAA4B,CAAC,MACX;CAClB,MAAM,IAAI,MAAMC,gCAAY;CAC5B,MAAM,SAAS,mBAAmB;CAClC,MAAM,YAAY,QAAQ,aAAa,OAAO;CAE9C,MAAM,UAAU,EAAE,QAAQ;CAC1B,QAAQ,MAAM,YAAY,WAAW;CAErC,IAAI;CAEJ,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,SAAS;EAEtC,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,GAAG,SAAS,OAAO,GAAG,SAAS,YAAY;EAG7D,SAAS,MAAM,SAAS,KAAK;CAC/B,SAAS,OAAO;EACd,QAAQ,KAAK,kCAAkC;EAC/C,EAAE,IAAI,MACJ,GAAI,MAAgB,QAAQ,qBAC1B,QAAQ,aAAa,UACjB,OAAO,UAAU,UACjB,cAAc,UAAU,QAEhC;EACA,QAAQ,WAAW;EACnB;CACF;CAEA,QAAQ,KAAK,sBAAsB;CAEnC,MAAM,YAAY,UAAMC,8BAAQC,oBAAKC,gBAAO,GAAG,mBAAmB,CAAC;CACnE,MAAM,iBAAaD,gBAAK,WAAW,OAAO,QAAQ;CAElD,IAAI;EACF,UAAME,4BAAU,YAAY,QAAQ,EAAE,MAAM,IAAM,CAAC;EAEnD,MAAM,CAAC,SAAS,QAAQ,OAAO,QAAQ,YAAY,QAAQ,IAAI;EAC/D,MAAM,WAAW,MAAM,aAAa,SAAS,IAAI;EAEjD,IAAI,aAAa,GACf,QAAQ,WAAW;CAEvB,UAAU;EACR,UAAMC,qBAAG,WAAW;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;CACtD;AACF"}

package/dist/cjs/scan.cjs

@@ -10,21 +10,44 @@ let _intlayer_engine_scan = require("@intlayer/engine/scan");
 /** Human-readable labels for each scorable check type. */
 const checkLabels = {
 	robots_robotsPresent: "robots.txt present",
-	robots_noLocalizedUrlsForgotten: "robots.txt keeps locale paths crawlable",
-	sitemap_sitemapPresent: "sitemap.xml present",
+	robots_noLocalizedUrlsForgotten: "robots.txt keeps localized URLs crawlable",
+	sitemap_sitemapPresent: "sitemap present",
 	sitemap_noLocalizedUrlsForgotten: "sitemap lists every locale",
 	sitemap_hasAlternates: "sitemap has alternate links",
 	sitemap_hasXDefault: "sitemap has x-default",
 	url_htmlLang: "html lang attribute",
 	url_htmlDir: "html dir attribute",
+	url_currentLocale: "locale signals consistent (lang, URL, hreflang)",
+	url_ogLocale: "og:locale meta tag",
 	url_hasCanonical: "canonical link",
 	url_hreflang: "hreflang tags",
-	url_hasLocalizedLinks: "localized internal links",
+	url_hreflangReciprocal: "hreflang alternates link back",
 	url_hasXDefault: "x-default hreflang",
-	url_allAnchorsLocalized: "all internal links localized",
-	url_currentLocale: "current locale detected",
+	url_hasLocalizedLinks: "localized internal links",
+	url_allAnchorsLocalized: "all internal links keep the locale",
+	url_hasLangSelector: "crawlable language switcher",
 	url_unusedBundleContent: "unused bundle locale content"
 };
+/** Human-readable labels of the routing strategies. */
+const routingLabels = {
+	"prefix-all": "locale prefix on every URL (/en/…, /fr/…)",
+	"prefix-no-default": "locale prefix except for the default locale",
+	"search-params": "locale in a query parameter",
+	subdomain: "locale subdomain (fr.example.com)",
+	domain: "one domain per locale",
+	"no-prefix": "no locale in the URL (cookie / header based)",
+	unknown: "unknown"
+};
+/** Human-readable labels of the technology categories. */
+const categoryLabels = {
+	framework: "Framework",
+	"i18n-library": "i18n library",
+	tms: "TMS",
+	"translation-proxy": "Translation proxy",
+	cms: "CMS"
+};
+/** Maximum number of detail lines printed under a failing check. */
+const MAX_DETAIL_LINES = 3;
 const statusIcon = (status) => {
 	if (status === "success") return (0, _intlayer_config_logger.colorize)("✓", _intlayer_config_colors.GREEN);
 	if (status === "warning") return (0, _intlayer_config_logger.colorize)("⚠", _intlayer_config_colors.YELLOW);
@@ -35,6 +58,18 @@ const scoreColor = (score) => {
 	if (score >= 50) return _intlayer_config_colors.YELLOW;
 	return _intlayer_config_colors.RED;
 };
+/** Print a check with, when it fails, a short explanation. */
+const logCheck = (appLogger, event) => {
+	const type = event.type.split("\\")[0];
+	if (!type) return;
+	appLogger(`  ${statusIcon(event.status)} ${checkLabels[type] ?? type}`);
+	if (event.status === "success") return;
+	const detailLines = (0, _intlayer_engine_scan.getCheckDetailLines)(event.details?.[event.status]);
+	detailLines.slice(0, MAX_DETAIL_LINES).forEach((line, index) => {
+		appLogger((0, _intlayer_config_logger.colorize)(`${index === 0 ? "      " : "        "}${line}`, _intlayer_config_colors.GREY));
+	});
+	if (detailLines.length > MAX_DETAIL_LINES) appLogger((0, _intlayer_config_logger.colorize)(`      … ${detailLines.length - MAX_DETAIL_LINES} more (use --json)`, _intlayer_config_colors.GREY));
+};
 /**
 * Scan a website for i18n/SEO health and bundle weight, printing a formatted
 * report (or JSON with `--json`).
@@ -56,13 +91,14 @@ const scan = async (url, options = {}) => {
 	appLogger(`Score: ${(0, _intlayer_config_logger.colorize)(`${result.score}/100`, scoreColor(result.score))}`);
 	appLogger(`Page size: ${(0, _intlayer_config_logger.colorize)((0, _intlayer_engine_scan.formatSize)(result.totalPageSize), _intlayer_config_colors.BLUE)} ${(0, _intlayer_config_logger.colorize)(`(HTML ${(0, _intlayer_engine_scan.formatSize)(result.htmlSize)})`, _intlayer_config_colors.GREY)}`);
 	if (result.locales.length > 0) appLogger(`Locales: ${(0, _intlayer_config_logger.colorize)(result.locales.join(", "), _intlayer_config_colors.GREEN)}`);
-	appLogger("\nChecks:");
-	for (const event of result.events) {
-		const type = event.type.split("\\")[0];
-		if (!type) continue;
-		const label = checkLabels[type] ?? type;
-		appLogger(`  ${statusIcon(event.status)} ${label}`);
+	const { routing } = result;
+	appLogger(`Routing: ${(0, _intlayer_config_logger.colorize)(routingLabels[routing.strategy], _intlayer_config_colors.BLUE)} ${(0, _intlayer_config_logger.colorize)(`(${routing.evidence}${routing.defaultLocale ? `, default locale: ${routing.defaultLocale}` : ""})`, _intlayer_config_colors.GREY)}`);
+	if (result.technologies.length > 0) {
+		appLogger("\nStack:");
+		for (const technology of result.technologies) appLogger(`  ${(0, _intlayer_config_logger.colorize)(categoryLabels[technology.category], _intlayer_config_colors.GREY)} ${technology.name}${technology.version ? ` ${technology.version}` : ""} ${(0, _intlayer_config_logger.colorize)(`(${technology.evidence})`, _intlayer_config_colors.GREY)}`);
 	}
+	appLogger("\nChecks:");
+	for (const event of result.events) logCheck(appLogger, event);
 	if (result.bundle && result.bundle.totalLocaleSize > 0) {
 		const { bundle } = result;
 		appLogger("\nBundle locale weight:");

package/dist/cjs/scan.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"scan.cjs","names":["colorize","ANSIColors","getConfiguration","getAppLogger","scanWebsite","formatSize"],"sources":["../../src/scan.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { formatSize, type ScanEvent, scanWebsite } from '@intlayer/engine/scan';\nimport type { ConfigurationOptions } from './cli';\n\n/** Options accepted by the {@link scan} command. */\nexport type ScanCommandOptions = {\n  /** Disable the deeper puppeteer-based render scan. */\n  deep?: boolean;\n  /** Output the raw {@link ScanResult} as JSON instead of formatted text. */\n  json?: boolean;\n  configOptions?: ConfigurationOptions;\n};\n\n/** Human-readable labels for each scorable check type. */\nconst checkLabels: Record<string, string> = {\n  robots_robotsPresent: 'robots.txt present',\n  robots_noLocalizedUrlsForgotten: 'robots.txt keeps locale paths crawlable',\n  sitemap_sitemapPresent: 'sitemap.xml present',\n  sitemap_noLocalizedUrlsForgotten: 'sitemap lists every locale',\n  sitemap_hasAlternates: 'sitemap has alternate links',\n  sitemap_hasXDefault: 'sitemap has x-default',\n  url_htmlLang: 'html lang attribute',\n  url_htmlDir: 'html dir attribute',\n  url_hasCanonical: 'canonical link',\n  url_hreflang: 'hreflang tags',\n  url_hasLocalizedLinks: 'localized internal links',\n  url_hasXDefault: 'x-default hreflang',\n  url_allAnchorsLocalized: 'all internal links localized',\n  url_currentLocale: 'current locale detected',\n  url_unusedBundleContent: 'unused bundle locale content',\n};\n\nconst statusIcon = (status: ScanEvent['status']): string => {\n  if (status === 'success') return colorize('✓', ANSIColors.GREEN);\n  if (status === 'warning') return colorize('⚠', ANSIColors.YELLOW);\n  return colorize('✗', ANSIColors.RED);\n};\n\nconst scoreColor = (score: number) => {\n  if (score >= 80) return ANSIColors.GREEN;\n  if (score >= 50) return ANSIColors.YELLOW;\n  return ANSIColors.RED;\n};\n\n/**\n * Scan a website for i18n/SEO health and bundle weight, printing a formatted\n * report (or JSON with `--json`).\n *\n * @example\n * ```sh\n * npx intlayer scan https://intlayer.org\n * ```\n */\nexport const scan = async (\n  url: string,\n  options: ScanCommandOptions = {}\n): Promise<void> => {\n  const configuration = getConfiguration(options.configOptions);\n  const appLogger = getAppLogger(configuration);\n\n  const result = await scanWebsite(url, { deep: options.deep });\n\n  if (options.json) {\n    appLogger(JSON.stringify(result, null, 2));\n    return;\n  }\n\n  appLogger(\n    `\\n🔍 Scanned ${colorize(result.url, ANSIColors.GREY_LIGHT)} ${colorize(\n      `(${result.mode} mode)`,\n      ANSIColors.GREY\n    )}\\n`\n  );\n\n  appLogger(\n    `Score: ${colorize(`${result.score}/100`, scoreColor(result.score))}`\n  );\n  appLogger(\n    `Page size: ${colorize(formatSize(result.totalPageSize), ANSIColors.BLUE)} ${colorize(\n      `(HTML ${formatSize(result.htmlSize)})`,\n      ANSIColors.GREY\n    )}`\n  );\n  if (result.locales.length > 0) {\n    appLogger(\n      `Locales: ${colorize(result.locales.join(', '), ANSIColors.GREEN)}`\n    );\n  }\n\n  appLogger('\\nChecks:');\n  for (const event of result.events) {\n    const type = event.type.split('\\\\')[0];\n\n    if (!type) continue;\n\n    const label = checkLabels[type] ?? type;\n    appLogger(`  ${statusIcon(event.status)} ${label}`);\n  }\n\n  if (result.bundle && result.bundle.totalLocaleSize > 0) {\n    const { bundle } = result;\n    appLogger('\\nBundle locale weight:');\n    appLogger(\n      `  Translations shipped: ${colorize(formatSize(bundle.totalLocaleSize), ANSIColors.BLUE)}`\n    );\n    appLogger(\n      `  Unused (other locales): ${colorize(\n        `${formatSize(bundle.totalUnusedLocaleSize)} (${bundle.unusedPercentOfLocale}%)`,\n        bundle.unusedPercentOfLocale > 30\n          ? ANSIColors.RED\n          : bundle.unusedPercentOfLocale > 0\n            ? ANSIColors.YELLOW\n            : ANSIColors.GREEN\n      )}`\n    );\n  }\n};\n"],"mappings":";;;;;;;;;;AAgBA,MAAM,cAAsC;CAC1C,sBAAsB;CACtB,iCAAiC;CACjC,wBAAwB;CACxB,kCAAkC;CAClC,uBAAuB;CACvB,qBAAqB;CACrB,cAAc;CACd,aAAa;CACb,kBAAkB;CAClB,cAAc;CACd,uBAAuB;CACvB,iBAAiB;CACjB,yBAAyB;CACzB,mBAAmB;CACnB,yBAAyB;AAC3B;AAEA,MAAM,cAAc,WAAwC;CAC1D,IAAI,WAAW,WAAW,WAAOA,kCAAS,KAAKC,wBAAW,KAAK;CAC/D,IAAI,WAAW,WAAW,WAAOD,kCAAS,KAAKC,wBAAW,MAAM;CAChE,WAAOD,kCAAS,KAAKC,wBAAW,GAAG;AACrC;AAEA,MAAM,cAAc,UAAkB;CACpC,IAAI,SAAS,IAAI,OAAOA,wBAAW;CACnC,IAAI,SAAS,IAAI,OAAOA,wBAAW;CACnC,OAAOA,wBAAW;AACpB;;;;;;;;;;AAWA,MAAa,OAAO,OAClB,KACA,UAA8B,CAAC,MACb;CAClB,MAAM,oBAAgBC,wCAAiB,QAAQ,aAAa;CAC5D,MAAM,gBAAYC,sCAAa,aAAa;CAE5C,MAAM,SAAS,UAAMC,mCAAY,KAAK,EAAE,MAAM,QAAQ,KAAK,CAAC;CAE5D,IAAI,QAAQ,MAAM;EAChB,UAAU,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;EACzC;CACF;CAEA,UACE,oBAAgBJ,kCAAS,OAAO,KAAKC,wBAAW,UAAU,EAAE,OAAGD,kCAC7D,IAAI,OAAO,KAAK,SAChBC,wBAAW,IACb,EAAE,GACJ;CAEA,UACE,cAAUD,kCAAS,GAAG,OAAO,MAAM,OAAO,WAAW,OAAO,KAAK,CAAC,GACpE;CACA,UACE,kBAAcA,sCAASK,kCAAW,OAAO,aAAa,GAAGJ,wBAAW,IAAI,EAAE,OAAGD,kCAC3E,aAASK,kCAAW,OAAO,QAAQ,EAAE,IACrCJ,wBAAW,IACb,GACF;CACA,IAAI,OAAO,QAAQ,SAAS,GAC1B,UACE,gBAAYD,kCAAS,OAAO,QAAQ,KAAK,IAAI,GAAGC,wBAAW,KAAK,GAClE;CAGF,UAAU,WAAW;CACrB,KAAK,MAAM,SAAS,OAAO,QAAQ;EACjC,MAAM,OAAO,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC;EAEpC,IAAI,CAAC,MAAM;EAEX,MAAM,QAAQ,YAAY,SAAS;EACnC,UAAU,KAAK,WAAW,MAAM,MAAM,EAAE,GAAG,OAAO;CACpD;CAEA,IAAI,OAAO,UAAU,OAAO,OAAO,kBAAkB,GAAG;EACtD,MAAM,EAAE,WAAW;EACnB,UAAU,yBAAyB;EACnC,UACE,+BAA2BD,sCAASK,kCAAW,OAAO,eAAe,GAAGJ,wBAAW,IAAI,GACzF;EACA,UACE,iCAA6BD,kCAC3B,OAAGK,kCAAW,OAAO,qBAAqB,EAAE,IAAI,OAAO,sBAAsB,KAC7E,OAAO,wBAAwB,KAC3BJ,wBAAW,MACX,OAAO,wBAAwB,IAC7BA,wBAAW,SACXA,wBAAW,KACnB,GACF;CACF;AACF"}
+{"version":3,"file":"scan.cjs","names":["colorize","ANSIColors","getCheckDetailLines","getConfiguration","getAppLogger","scanWebsite","formatSize"],"sources":["../../src/scan.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport {\n  type DetectedTechnology,\n  formatSize,\n  getCheckDetailLines,\n  type ScanEvent,\n  type ScanResult,\n  scanWebsite,\n} from '@intlayer/engine/scan';\nimport type { ConfigurationOptions } from './cli';\n\n/** Options accepted by the {@link scan} command. */\nexport type ScanCommandOptions = {\n  /** Disable the deeper puppeteer-based render scan. */\n  deep?: boolean;\n  /** Output the raw {@link ScanResult} as JSON instead of formatted text. */\n  json?: boolean;\n  configOptions?: ConfigurationOptions;\n};\n\n/** Human-readable labels for each scorable check type. */\nconst checkLabels: Record<string, string> = {\n  robots_robotsPresent: 'robots.txt present',\n  robots_noLocalizedUrlsForgotten: 'robots.txt keeps localized URLs crawlable',\n  sitemap_sitemapPresent: 'sitemap present',\n  sitemap_noLocalizedUrlsForgotten: 'sitemap lists every locale',\n  sitemap_hasAlternates: 'sitemap has alternate links',\n  sitemap_hasXDefault: 'sitemap has x-default',\n  url_htmlLang: 'html lang attribute',\n  url_htmlDir: 'html dir attribute',\n  url_currentLocale: 'locale signals consistent (lang, URL, hreflang)',\n  url_ogLocale: 'og:locale meta tag',\n  url_hasCanonical: 'canonical link',\n  url_hreflang: 'hreflang tags',\n  url_hreflangReciprocal: 'hreflang alternates link back',\n  url_hasXDefault: 'x-default hreflang',\n  url_hasLocalizedLinks: 'localized internal links',\n  url_allAnchorsLocalized: 'all internal links keep the locale',\n  url_hasLangSelector: 'crawlable language switcher',\n  url_unusedBundleContent: 'unused bundle locale content',\n};\n\n/** Human-readable labels of the routing strategies. */\nconst routingLabels: Record<ScanResult['routing']['strategy'], string> = {\n  'prefix-all': 'locale prefix on every URL (/en/…, /fr/…)',\n  'prefix-no-default': 'locale prefix except for the default locale',\n  'search-params': 'locale in a query parameter',\n  subdomain: 'locale subdomain (fr.example.com)',\n  domain: 'one domain per locale',\n  'no-prefix': 'no locale in the URL (cookie / header based)',\n  unknown: 'unknown',\n};\n\n/** Human-readable labels of the technology categories. */\nconst categoryLabels: Record<DetectedTechnology['category'], string> = {\n  framework: 'Framework',\n  'i18n-library': 'i18n library',\n  tms: 'TMS',\n  'translation-proxy': 'Translation proxy',\n  cms: 'CMS',\n};\n\n/** Maximum number of detail lines printed under a failing check. */\nconst MAX_DETAIL_LINES = 3;\n\nconst statusIcon = (status: ScanEvent['status']): string => {\n  if (status === 'success') return colorize('✓', ANSIColors.GREEN);\n  if (status === 'warning') return colorize('⚠', ANSIColors.YELLOW);\n  return colorize('✗', ANSIColors.RED);\n};\n\nconst scoreColor = (score: number) => {\n  if (score >= 80) return ANSIColors.GREEN;\n  if (score >= 50) return ANSIColors.YELLOW;\n  return ANSIColors.RED;\n};\n\n/** Print a check with, when it fails, a short explanation. */\nconst logCheck = (\n  appLogger: ReturnType<typeof getAppLogger>,\n  event: ScanEvent\n): void => {\n  const type = event.type.split('\\\\')[0];\n  if (!type) return;\n\n  appLogger(`  ${statusIcon(event.status)} ${checkLabels[type] ?? type}`);\n\n  if (event.status === 'success') return;\n\n  const detailLines = getCheckDetailLines(event.details?.[event.status]);\n  detailLines.slice(0, MAX_DETAIL_LINES).forEach((line, index) => {\n    appLogger(\n      colorize(`${index === 0 ? '      ' : '        '}${line}`, ANSIColors.GREY)\n    );\n  });\n  if (detailLines.length > MAX_DETAIL_LINES) {\n    appLogger(\n      colorize(\n        `      … ${detailLines.length - MAX_DETAIL_LINES} more (use --json)`,\n        ANSIColors.GREY\n      )\n    );\n  }\n};\n\n/**\n * Scan a website for i18n/SEO health and bundle weight, printing a formatted\n * report (or JSON with `--json`).\n *\n * @example\n * ```sh\n * npx intlayer scan https://intlayer.org\n * ```\n */\nexport const scan = async (\n  url: string,\n  options: ScanCommandOptions = {}\n): Promise<void> => {\n  const configuration = getConfiguration(options.configOptions);\n  const appLogger = getAppLogger(configuration);\n\n  const result = await scanWebsite(url, { deep: options.deep });\n\n  if (options.json) {\n    appLogger(JSON.stringify(result, null, 2));\n    return;\n  }\n\n  appLogger(\n    `\\n🔍 Scanned ${colorize(result.url, ANSIColors.GREY_LIGHT)} ${colorize(\n      `(${result.mode} mode)`,\n      ANSIColors.GREY\n    )}\\n`\n  );\n\n  appLogger(\n    `Score: ${colorize(`${result.score}/100`, scoreColor(result.score))}`\n  );\n  appLogger(\n    `Page size: ${colorize(formatSize(result.totalPageSize), ANSIColors.BLUE)} ${colorize(\n      `(HTML ${formatSize(result.htmlSize)})`,\n      ANSIColors.GREY\n    )}`\n  );\n  if (result.locales.length > 0) {\n    appLogger(\n      `Locales: ${colorize(result.locales.join(', '), ANSIColors.GREEN)}`\n    );\n  }\n\n  const { routing } = result;\n  appLogger(\n    `Routing: ${colorize(routingLabels[routing.strategy], ANSIColors.BLUE)} ${colorize(\n      `(${routing.evidence}${routing.defaultLocale ? `, default locale: ${routing.defaultLocale}` : ''})`,\n      ANSIColors.GREY\n    )}`\n  );\n\n  if (result.technologies.length > 0) {\n    appLogger('\\nStack:');\n    for (const technology of result.technologies) {\n      appLogger(\n        `  ${colorize(categoryLabels[technology.category], ANSIColors.GREY)} ${technology.name}${\n          technology.version ? ` ${technology.version}` : ''\n        } ${colorize(`(${technology.evidence})`, ANSIColors.GREY)}`\n      );\n    }\n  }\n\n  appLogger('\\nChecks:');\n  for (const event of result.events) {\n    logCheck(appLogger, event);\n  }\n\n  if (result.bundle && result.bundle.totalLocaleSize > 0) {\n    const { bundle } = result;\n    appLogger('\\nBundle locale weight:');\n    appLogger(\n      `  Translations shipped: ${colorize(formatSize(bundle.totalLocaleSize), ANSIColors.BLUE)}`\n    );\n    appLogger(\n      `  Unused (other locales): ${colorize(\n        `${formatSize(bundle.totalUnusedLocaleSize)} (${bundle.unusedPercentOfLocale}%)`,\n        bundle.unusedPercentOfLocale > 30\n          ? ANSIColors.RED\n          : bundle.unusedPercentOfLocale > 0\n            ? ANSIColors.YELLOW\n            : ANSIColors.GREEN\n      )}`\n    );\n  }\n};\n"],"mappings":"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"}

package/dist/cjs/searchDoc.cjs

@@ -28,6 +28,7 @@ const searchDoc = async ({ query, limit = 10, configOptions }) => {
 			appLogger(`${(0, _intlayer_config_logger.colorizeKey)("Title")}: ${chunk.docName}`);
 			appLogger(`${(0, _intlayer_config_logger.colorizeKey)("URL")}: ${chunk.docUrl}`);
 			appLogger(`${(0, _intlayer_config_logger.colorizeKey)("Chunk")}: ${chunk.chunkNumber}`);
+			if (chunk.priority !== void 0) appLogger(`${(0, _intlayer_config_logger.colorizeKey)("Priority")}: ${(0, _intlayer_config_logger.colorizeNumber)(chunk.priority)}`);
 			appLogger(`${(0, _intlayer_config_logger.colorizeKey)("Content")}:`);
 			appLogger(chunk.content);
 		});

package/dist/cjs/searchDoc.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"searchDoc.cjs","names":["getConfiguration","getAppLogger","getSearchAPI","colorizeNumber","colorizeKey"],"sources":["../../src/searchDoc.ts"],"sourcesContent":["import { getSearchAPI } from '@intlayer/api';\nimport {\n  colorizeKey,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { logConfigDetails } from '@intlayer/engine/cli';\n\ninterface SearchDocOptions {\n  query: string;\n  limit?: number;\n  configOptions?: GetConfigurationOptions;\n}\n\nexport const searchDoc = async ({\n  query,\n  limit = 10,\n  configOptions,\n}: SearchDocOptions) => {\n  const config = getConfiguration(configOptions);\n  logConfigDetails(configOptions);\n\n  const appLogger = getAppLogger(config);\n\n  try {\n    const { searchDoc } = getSearchAPI(undefined, config);\n    const response = await searchDoc({\n      input: query,\n      limit: limit.toString(),\n      returnContent: 'true',\n    });\n\n    if (!response.data || !Array.isArray(response.data)) {\n      appLogger('No relevant chunks found.');\n      return;\n    }\n\n    const chunks = response.data;\n\n    appLogger(`Found ${colorizeNumber(chunks.length)} relevant chunks:`);\n\n    chunks.forEach((chunk: any) => {\n      appLogger('---');\n      appLogger(`${colorizeKey('File')}: ${chunk.fileKey}`);\n      appLogger(`${colorizeKey('Title')}: ${chunk.docName}`);\n      appLogger(`${colorizeKey('URL')}: ${chunk.docUrl}`);\n      appLogger(`${colorizeKey('Chunk')}: ${chunk.chunkNumber}`);\n      appLogger(`${colorizeKey('Content')}:`);\n      appLogger(chunk.content);\n    });\n  } catch (error) {\n    const errorMessage =\n      error instanceof Error ? error.message : 'An unknown error occurred';\n    appLogger(`Search failed: ${errorMessage}`, { level: 'error' });\n  }\n};\n"],"mappings":";;;;;;;AAkBA,MAAa,YAAY,OAAO,EAC9B,OACA,QAAQ,IACR,oBACsB;CACtB,MAAM,aAASA,wCAAiB,aAAa;CAC7C,2CAAiB,aAAa;CAE9B,MAAM,gBAAYC,sCAAa,MAAM;CAErC,IAAI;EACF,MAAM,EAAE,kBAAcC,4BAAa,QAAW,MAAM;EACpD,MAAM,WAAW,MAAM,UAAU;GAC/B,OAAO;GACP,OAAO,MAAM,SAAS;GACtB,eAAe;EACjB,CAAC;EAED,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,QAAQ,SAAS,IAAI,GAAG;GACnD,UAAU,2BAA2B;GACrC;EACF;EAEA,MAAM,SAAS,SAAS;EAExB,UAAU,aAASC,wCAAe,OAAO,MAAM,EAAE,kBAAkB;EAEnE,OAAO,SAAS,UAAe;GAC7B,UAAU,KAAK;GACf,UAAU,OAAGC,qCAAY,MAAM,EAAE,IAAI,MAAM,SAAS;GACpD,UAAU,OAAGA,qCAAY,OAAO,EAAE,IAAI,MAAM,SAAS;GACrD,UAAU,OAAGA,qCAAY,KAAK,EAAE,IAAI,MAAM,QAAQ;GAClD,UAAU,OAAGA,qCAAY,OAAO,EAAE,IAAI,MAAM,aAAa;GACzD,UAAU,OAAGA,qCAAY,SAAS,EAAE,EAAE;GACtC,UAAU,MAAM,OAAO;EACzB,CAAC;CACH,SAAS,OAAO;EAGd,UAAU,kBADR,iBAAiB,QAAQ,MAAM,UAAU,+BACC,EAAE,OAAO,QAAQ,CAAC;CAChE;AACF"}
+{"version":3,"file":"searchDoc.cjs","names":["getConfiguration","getAppLogger","getSearchAPI","colorizeNumber","colorizeKey"],"sources":["../../src/searchDoc.ts"],"sourcesContent":["import { getSearchAPI } from '@intlayer/api';\nimport {\n  colorizeKey,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { logConfigDetails } from '@intlayer/engine/cli';\n\n/** A documentation chunk returned by the search endpoint with `returnContent`. */\ntype SearchDocChunk = Exclude<\n  NonNullable<\n    Awaited<ReturnType<ReturnType<typeof getSearchAPI>['searchDoc']>>['data']\n  >,\n  string[]\n>[number];\n\ninterface SearchDocOptions {\n  query: string;\n  limit?: number;\n  configOptions?: GetConfigurationOptions;\n}\n\nexport const searchDoc = async ({\n  query,\n  limit = 10,\n  configOptions,\n}: SearchDocOptions) => {\n  const config = getConfiguration(configOptions);\n  logConfigDetails(configOptions);\n\n  const appLogger = getAppLogger(config);\n\n  try {\n    const { searchDoc } = getSearchAPI(undefined, config);\n    const response = await searchDoc({\n      input: query,\n      limit: limit.toString(),\n      returnContent: 'true',\n    });\n\n    if (!response.data || !Array.isArray(response.data)) {\n      appLogger('No relevant chunks found.');\n      return;\n    }\n\n    // Ranked by relevance, weighted by the `priority` front matter of each doc\n    const chunks = response.data as SearchDocChunk[];\n\n    appLogger(`Found ${colorizeNumber(chunks.length)} relevant chunks:`);\n\n    chunks.forEach((chunk) => {\n      appLogger('---');\n      appLogger(`${colorizeKey('File')}: ${chunk.fileKey}`);\n      appLogger(`${colorizeKey('Title')}: ${chunk.docName}`);\n      appLogger(`${colorizeKey('URL')}: ${chunk.docUrl}`);\n      appLogger(`${colorizeKey('Chunk')}: ${chunk.chunkNumber}`);\n      if (chunk.priority !== undefined) {\n        appLogger(\n          `${colorizeKey('Priority')}: ${colorizeNumber(chunk.priority)}`\n        );\n      }\n      appLogger(`${colorizeKey('Content')}:`);\n      appLogger(chunk.content);\n    });\n  } catch (error) {\n    const errorMessage =\n      error instanceof Error ? error.message : 'An unknown error occurred';\n    appLogger(`Search failed: ${errorMessage}`, { level: 'error' });\n  }\n};\n"],"mappings":";;;;;;;AA0BA,MAAa,YAAY,OAAO,EAC9B,OACA,QAAQ,IACR,oBACsB;CACtB,MAAM,aAASA,wCAAiB,aAAa;CAC7C,2CAAiB,aAAa;CAE9B,MAAM,gBAAYC,sCAAa,MAAM;CAErC,IAAI;EACF,MAAM,EAAE,kBAAcC,4BAAa,QAAW,MAAM;EACpD,MAAM,WAAW,MAAM,UAAU;GAC/B,OAAO;GACP,OAAO,MAAM,SAAS;GACtB,eAAe;EACjB,CAAC;EAED,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,QAAQ,SAAS,IAAI,GAAG;GACnD,UAAU,2BAA2B;GACrC;EACF;EAGA,MAAM,SAAS,SAAS;EAExB,UAAU,aAASC,wCAAe,OAAO,MAAM,EAAE,kBAAkB;EAEnE,OAAO,SAAS,UAAU;GACxB,UAAU,KAAK;GACf,UAAU,OAAGC,qCAAY,MAAM,EAAE,IAAI,MAAM,SAAS;GACpD,UAAU,OAAGA,qCAAY,OAAO,EAAE,IAAI,MAAM,SAAS;GACrD,UAAU,OAAGA,qCAAY,KAAK,EAAE,IAAI,MAAM,QAAQ;GAClD,UAAU,OAAGA,qCAAY,OAAO,EAAE,IAAI,MAAM,aAAa;GACzD,IAAI,MAAM,aAAa,QACrB,UACE,OAAGA,qCAAY,UAAU,EAAE,QAAID,wCAAe,MAAM,QAAQ,GAC9D;GAEF,UAAU,OAAGC,qCAAY,SAAS,EAAE,EAAE;GACtC,UAAU,MAAM,OAAO;EACzB,CAAC;CACH,SAAS,OAAO;EAGd,UAAU,kBADR,iBAAiB,QAAQ,MAAM,UAAU,+BACC,EAAE,OAAO,QAAQ,CAAC;CAChE;AACF"}

package/dist/cjs/utils/selectCmsEnvironment.cjs

@@ -35,7 +35,7 @@ const selectCmsEnvironment = async (environmentName, intlayerAPI, config) => {
 			appLogger(`Using environment: ${(0, _intlayer_config_logger.colorize)(targetEnvironment.name, _intlayer_config_colors.CYAN)} (default)`);
 			return;
 		}
-		await intlayerAPI.project.selectEnvironment(String(targetEnvironment.id));
+		await intlayerAPI.environment.selectEnvironment(String(targetEnvironment.id));
 		appLogger(`Using environment: ${(0, _intlayer_config_logger.colorize)(targetEnvironment.name, _intlayer_config_colors.CYAN)}`);
 	} catch (error) {
 		appLogger(`Failed to select environment "${environmentName}": ${error}`, { level: "warn" });

package/dist/cjs/utils/selectCmsEnvironment.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"selectCmsEnvironment.cjs","names":["getAppLogger","colorize","ANSIColors"],"sources":["../../../src/utils/selectCmsEnvironment.ts"],"sourcesContent":["import type { IntlayerAPIProxy } from '@intlayer/api';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Selects the CMS project environment that matches `environmentName`.\n *\n * Convention: session.activeEnvironmentId = null means \"production\" (default).\n * When the target environment is the project's default, we reset the session to\n * null instead of storing the env's ObjectId — so no API call is needed.\n *\n * No-op when `environmentName` is undefined.\n */\nexport const selectCmsEnvironment = async (\n  environmentName: string | undefined,\n  intlayerAPI: IntlayerAPIProxy,\n  config: IntlayerConfig\n): Promise<void> => {\n  if (!environmentName) return;\n\n  const appLogger = getAppLogger(config);\n\n  try {\n    const sessionResult = await intlayerAPI.oAuth.getCliSessionMe();\n    const project = sessionResult.data?.project;\n\n    if (!project) {\n      appLogger(\n        `Cannot resolve environment \"${environmentName}\": no project selected in session.`,\n        { level: 'warn' }\n      );\n      return;\n    }\n\n    const projectEnvironments: any[] = (project as any).environments ?? [];\n\n    if (projectEnvironments.length === 0) {\n      // No environments stored — everything is implicitly production; nothing to select\n      return;\n    }\n\n    const targetEnvironment = projectEnvironments.find(\n      (environment: any) =>\n        environment.name.toLowerCase() === environmentName.toLowerCase() ||\n        String(environment.id) === environmentName\n    );\n\n    if (!targetEnvironment) {\n      const availableNames = projectEnvironments\n        .map((environment: any) => environment.name)\n        .join(', ');\n      appLogger(\n        `Environment \"${environmentName}\" not found in project. Available: ${colorize(availableNames, ANSIColors.BLUE)}.`,\n        { level: 'error' }\n      );\n      return;\n    }\n\n    // Production / default env → null convention; no API call needed\n    if (targetEnvironment.isDefault) {\n      appLogger(\n        `Using environment: ${colorize(targetEnvironment.name, ANSIColors.CYAN)} (default)`\n      );\n      return;\n    }\n\n    await intlayerAPI.project.selectEnvironment(String(targetEnvironment.id));\n\n    appLogger(\n      `Using environment: ${colorize(targetEnvironment.name, ANSIColors.CYAN)}`\n    );\n  } catch (error) {\n    appLogger(`Failed to select environment \"${environmentName}\": ${error}`, {\n      level: 'warn',\n    });\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAa,uBAAuB,OAClC,iBACA,aACA,WACkB;CAClB,IAAI,CAAC,iBAAiB;CAEtB,MAAM,gBAAYA,sCAAa,MAAM;CAErC,IAAI;EAEF,MAAM,WAAU,MADY,YAAY,MAAM,gBAAgB,EACjC,CAAC,MAAM;EAEpC,IAAI,CAAC,SAAS;GACZ,UACE,+BAA+B,gBAAgB,qCAC/C,EAAE,OAAO,OAAO,CAClB;GACA;EACF;EAEA,MAAM,sBAA8B,QAAgB,gBAAgB,CAAC;EAErE,IAAI,oBAAoB,WAAW,GAEjC;EAGF,MAAM,oBAAoB,oBAAoB,MAC3C,gBACC,YAAY,KAAK,YAAY,MAAM,gBAAgB,YAAY,KAC/D,OAAO,YAAY,EAAE,MAAM,eAC/B;EAEA,IAAI,CAAC,mBAAmB;GACtB,MAAM,iBAAiB,oBACpB,KAAK,gBAAqB,YAAY,IAAI,CAAC,CAC3C,KAAK,IAAI;GACZ,UACE,gBAAgB,gBAAgB,yCAAqCC,kCAAS,gBAAgBC,wBAAW,IAAI,EAAE,IAC/G,EAAE,OAAO,QAAQ,CACnB;GACA;EACF;EAGA,IAAI,kBAAkB,WAAW;GAC/B,UACE,0BAAsBD,kCAAS,kBAAkB,MAAMC,wBAAW,IAAI,EAAE,WAC1E;GACA;EACF;EAEA,MAAM,YAAY,QAAQ,kBAAkB,OAAO,kBAAkB,EAAE,CAAC;EAExE,UACE,0BAAsBD,kCAAS,kBAAkB,MAAMC,wBAAW,IAAI,GACxE;CACF,SAAS,OAAO;EACd,UAAU,iCAAiC,gBAAgB,KAAK,SAAS,EACvE,OAAO,OACT,CAAC;CACH;AACF"}
+{"version":3,"file":"selectCmsEnvironment.cjs","names":["getAppLogger","colorize","ANSIColors"],"sources":["../../../src/utils/selectCmsEnvironment.ts"],"sourcesContent":["import type { IntlayerAPIProxy } from '@intlayer/api';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Selects the CMS project environment that matches `environmentName`.\n *\n * Convention: session.activeEnvironmentId = null means \"production\" (default).\n * When the target environment is the project's default, we reset the session to\n * null instead of storing the env's ObjectId — so no API call is needed.\n *\n * No-op when `environmentName` is undefined.\n */\nexport const selectCmsEnvironment = async (\n  environmentName: string | undefined,\n  intlayerAPI: IntlayerAPIProxy,\n  config: IntlayerConfig\n): Promise<void> => {\n  if (!environmentName) return;\n\n  const appLogger = getAppLogger(config);\n\n  try {\n    const sessionResult = await intlayerAPI.oAuth.getCliSessionMe();\n    const project = sessionResult.data?.project;\n\n    if (!project) {\n      appLogger(\n        `Cannot resolve environment \"${environmentName}\": no project selected in session.`,\n        { level: 'warn' }\n      );\n      return;\n    }\n\n    const projectEnvironments: any[] = (project as any).environments ?? [];\n\n    if (projectEnvironments.length === 0) {\n      // No environments stored — everything is implicitly production; nothing to select\n      return;\n    }\n\n    const targetEnvironment = projectEnvironments.find(\n      (environment: any) =>\n        environment.name.toLowerCase() === environmentName.toLowerCase() ||\n        String(environment.id) === environmentName\n    );\n\n    if (!targetEnvironment) {\n      const availableNames = projectEnvironments\n        .map((environment: any) => environment.name)\n        .join(', ');\n      appLogger(\n        `Environment \"${environmentName}\" not found in project. Available: ${colorize(availableNames, ANSIColors.BLUE)}.`,\n        { level: 'error' }\n      );\n      return;\n    }\n\n    // Production / default env → null convention; no API call needed\n    if (targetEnvironment.isDefault) {\n      appLogger(\n        `Using environment: ${colorize(targetEnvironment.name, ANSIColors.CYAN)} (default)`\n      );\n      return;\n    }\n\n    await intlayerAPI.environment.selectEnvironment(\n      String(targetEnvironment.id)\n    );\n\n    appLogger(\n      `Using environment: ${colorize(targetEnvironment.name, ANSIColors.CYAN)}`\n    );\n  } catch (error) {\n    appLogger(`Failed to select environment \"${environmentName}\": ${error}`, {\n      level: 'warn',\n    });\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAa,uBAAuB,OAClC,iBACA,aACA,WACkB;CAClB,IAAI,CAAC,iBAAiB;CAEtB,MAAM,gBAAYA,sCAAa,MAAM;CAErC,IAAI;EAEF,MAAM,WAAU,MADY,YAAY,MAAM,gBAAgB,EACjC,CAAC,MAAM;EAEpC,IAAI,CAAC,SAAS;GACZ,UACE,+BAA+B,gBAAgB,qCAC/C,EAAE,OAAO,OAAO,CAClB;GACA;EACF;EAEA,MAAM,sBAA8B,QAAgB,gBAAgB,CAAC;EAErE,IAAI,oBAAoB,WAAW,GAEjC;EAGF,MAAM,oBAAoB,oBAAoB,MAC3C,gBACC,YAAY,KAAK,YAAY,MAAM,gBAAgB,YAAY,KAC/D,OAAO,YAAY,EAAE,MAAM,eAC/B;EAEA,IAAI,CAAC,mBAAmB;GACtB,MAAM,iBAAiB,oBACpB,KAAK,gBAAqB,YAAY,IAAI,CAAC,CAC3C,KAAK,IAAI;GACZ,UACE,gBAAgB,gBAAgB,yCAAqCC,kCAAS,gBAAgBC,wBAAW,IAAI,EAAE,IAC/G,EAAE,OAAO,QAAQ,CACnB;GACA;EACF;EAGA,IAAI,kBAAkB,WAAW;GAC/B,UACE,0BAAsBD,kCAAS,kBAAkB,MAAMC,wBAAW,IAAI,EAAE,WAC1E;GACA;EACF;EAEA,MAAM,YAAY,YAAY,kBAC5B,OAAO,kBAAkB,EAAE,CAC7B;EAEA,UACE,0BAAsBD,kCAAS,kBAAkB,MAAMC,wBAAW,IAAI,GACxE;CACF,SAAS,OAAO;EACd,UAAU,iCAAiC,gBAAgB,KAAK,SAAS,EACvE,OAAO,OACT,CAAC;CACH;AACF"}

package/dist/esm/cli.mjs

@@ -153,13 +153,14 @@ const setAPI = () => {
 	/**
 	* INIT
 	*/
-	const initCmd = program.command("init").description("Initialize Intlayer in the project").option("--project-root [projectRoot]", "Project root directory").option("--no-gitignore", "Do not add .intlayer to .gitignore").option("--no-github-actions", "Do not scaffold the fill and test GitHub Actions workflows").option("--no-framework-setup", "Do not set up the project (Intlayer config, tsconfig, bundler plugin, middleware/proxy, providers in layout/page)").option("-i, --interactive", "Interactively choose what to set up (packages, skills, MCP, VS Code extension, LSP, …)").action(async (options) => {
-		const { init } = await import("./init.mjs");
+	const initCmd = program.command("init").description("Initialize Intlayer in the project").option("--project-root [projectRoot]", "Project root directory").option("--no-gitignore", "Do not add .intlayer to .gitignore").option("--no-github-actions", "Do not scaffold the fill and test GitHub Actions workflows").option("--no-framework-setup", "Do not set up the project (Intlayer config, tsconfig, bundler plugin, middleware/proxy, providers in layout/page)").option("-i, --interactive", "Interactively choose what to set up (packages, skills, MCP, VS Code extension, LSP, …)").option("--routing <routing>", "Locale routing: prefix-no-default | prefix-all | no-prefix | search-params | none").action(async (options) => {
+		const { init, parseLocaleRoutingChoice, getRoutingInitOptions } = await import("./init.mjs");
 		return init(options.projectRoot, {
 			noGitignore: options.gitignore === false,
 			noGithubActions: options.githubActions === false,
 			noFrameworkSetup: options.frameworkSetup === false,
-			upgradeToVersion: packageJson.version
+			upgradeToVersion: packageJson.version,
+			...options.routing ? getRoutingInitOptions(parseLocaleRoutingChoice(options.routing)) : {}
 		}, options.interactive === true);
 	});
 	initCmd.command("skills").description("Initialize Intlayer skills in the project").option("--project-root [projectRoot]", "Project root directory").action(async (options) => {
@@ -174,6 +175,10 @@ const setAPI = () => {
 		const { initInfra, parseInfraMode } = await import("./initInfra.mjs");
 		return initInfra({ mode: options.mode ? parseInfraMode(options.mode) : void 0 });
 	});
+	initCmd.command("extension").alias("chrome-extension").description("Install the Intlayer Chrome extension or Firefox add-on in your browser").action(async () => {
+		const { initChromeExtension } = await import("./initChromeExtension.mjs");
+		return initChromeExtension();
+	});
 	/**
 	* UPGRADE
 	*/