@santi020k/eslint-config-basic 3.1.0 → 3.3.0

package/dist/cli-advanced.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli-advanced.ts"],"sourcesContent":["/* eslint-disable no-console -- CLI handlers own user-facing terminal output */\n/* eslint-disable complexity -- report builders intentionally cover compatibility and config-source branches */\nimport { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { createRequire, findPackageJSON } from 'node:module'\nimport { basename, dirname, join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\n\ninterface SemverApi {\n  satisfies: (version: string, range: string) => boolean\n  subset: (subRange: string, superRange: string) => boolean\n  validRange: (range: string) => null | string\n}\n\ninterface PackageManifest {\n  engines?: { node?: string }\n  name?: string\n  peerDependencies?: Record<string, string>\n  version?: string\n}\n\ninterface ResolvedPackageManifest {\n  manifest: PackageManifest\n  path: string\n}\n\ninterface FlatConfigEntry {\n  files?: unknown\n  name?: string\n  rules?: Record<string, unknown>\n}\n\ninterface ProjectEslint {\n  calculateConfigForFile: (filePath: string) => Promise<unknown>\n  lintFiles: (patterns: string[]) => Promise<LintResult[]>\n}\n\ninterface LintResult {\n  filePath: string\n  messages: {\n    column?: number\n    endColumn?: number\n    endLine?: number\n    line?: number\n    message: string\n    ruleId: null | string\n  }[]\n}\n\ninterface RuleDiagnostic {\n  column: null | number\n  endColumn: null | number\n  endLine: null | number\n  file: string\n  line: null | number\n  message: string\n}\n\ntype ProjectEslintConstructor = new(options: { cwd: string }) => ProjectEslint\n\nexport interface ExplainRuleOptions {\n  file?: string\n  json?: boolean\n  rule: string\n}\n\nconst CONFIG_FILENAMES = [\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]\n\nconst BASIC_PACKAGE_NAME = '@santi020k/eslint-config-basic'\nconst FULL_PACKAGE_NAME = '@santi020k/eslint-config-full'\n\nconst RULE_PACKAGE_HINTS: Partial<Record<string, string>> = {\n  '@angular-eslint': '@santi020k/eslint-config-angular',\n  '@eslint-react': '@santi020k/eslint-config-react',\n  '@next/next': '@santi020k/eslint-config-next',\n  '@typescript-eslint': '@santi020k/eslint-config-typescript',\n  astro: '@santi020k/eslint-config-astro',\n  cypress: '@santi020k/eslint-config-testing',\n  jest: '@santi020k/eslint-config-testing',\n  jsonc: '@santi020k/eslint-config-formats',\n  playwright: '@santi020k/eslint-config-testing',\n  react: '@santi020k/eslint-config-react',\n  'testing-library': '@santi020k/eslint-config-testing',\n  unicorn: '@santi020k/eslint-config-extensions',\n  vue: '@santi020k/eslint-config-vue'\n}\n\nconst semver = createRequire(import.meta.url)('semver') as SemverApi\n\nconst readJson = (filePath: string): null | Record<string, unknown> => {\n  if (!existsSync(filePath)) return null\n\n  try {\n    return JSON.parse(readFileSync(filePath, 'utf8')) as Record<string, unknown>\n  } catch {\n    return null\n  }\n}\n\nconst findConfigPath = (cwd: string): null | string => (\n  CONFIG_FILENAMES.map(file => join(cwd, file)).find(file => existsSync(file)) ?? null\n)\n\nconst flattenConfig = async (value: unknown): Promise<FlatConfigEntry[]> => {\n  const resolved = await value\n\n  if (Array.isArray(resolved)) {\n    const nested = await Promise.all(resolved.map(entry => flattenConfig(entry)))\n\n    return nested.flat()\n  }\n\n  if (resolved && typeof resolved === 'object') return [resolved]\n\n  return []\n}\n\nconst loadConfigEntries = async (configPath: null | string): Promise<FlatConfigEntry[]> => {\n  if (!configPath) return []\n\n  try {\n    const loaded: unknown = await import(`${pathToFileURL(configPath).href}?basic-eslint-explain=${Date.now()}`)\n\n    if (!loaded || typeof loaded !== 'object' || !('default' in loaded)) return []\n\n    return await flattenConfig((loaded).default)\n  } catch {\n    return []\n  }\n}\n\nconst loadProjectEslint = (cwd: string): ProjectEslint => {\n  const projectRequire = createRequire(join(cwd, 'package.json'))\n  const eslintModule = projectRequire('eslint') as { ESLint?: ProjectEslintConstructor }\n\n  if (!eslintModule.ESLint) throw new Error('The installed eslint package does not expose the ESLint API.')\n\n  return new eslintModule.ESLint({ cwd })\n}\n\nconst getRuleSeverity = (ruleValue: unknown): unknown => (\n  Array.isArray(ruleValue) ? ruleValue[0] : ruleValue\n)\n\nconst isRuleEnabled = (ruleValue: unknown): boolean => {\n  const severity = getRuleSeverity(ruleValue)\n\n  return severity !== 0 && severity !== 'off'\n}\n\nconst getPackageHint = (rule: string): null | string => {\n  const prefix = rule.includes('/') ? rule.slice(0, rule.indexOf('/')) : rule\n  const scopedPrefix = rule.startsWith('@') ? rule.split('/').slice(0, 2).join('/') : prefix\n\n  return RULE_PACKAGE_HINTS[scopedPrefix] ?? RULE_PACKAGE_HINTS[prefix] ?? null\n}\n\nconst getRuleDiagnostics = async (\n  eslint: ProjectEslint,\n  file: string,\n  rule: string\n): Promise<RuleDiagnostic[]> => {\n  if (rule !== 'complexity') return []\n\n  try {\n    const results = await eslint.lintFiles([file])\n\n    return results.flatMap(result => result.messages\n      .filter(message => message.ruleId === rule)\n      .map(message => ({\n        column: message.column ?? null,\n        endColumn: message.endColumn ?? null,\n        endLine: message.endLine ?? null,\n        file: result.filePath,\n        line: message.line ?? null,\n        message: message.message\n      })))\n  } catch {\n    return []\n  }\n}\n\nexport const handleExplainRule = async (\n  cwd: string = process.cwd(),\n  options: ExplainRuleOptions\n): Promise<void> => {\n  const configPath = findConfigPath(cwd)\n  const file = options.file ?? 'eslint.config.js'\n  const eslint = loadProjectEslint(cwd)\n  const effective = await eslint.calculateConfigForFile(file) as null | { rules?: Record<string, unknown> }\n  const effectiveValue = effective?.rules?.[options.rule]\n  const entries = await loadConfigEntries(configPath)\n  const diagnostics = await getRuleDiagnostics(eslint, file, options.rule)\n\n  const sources = entries.flatMap((entry, index) => {\n    if (!entry.rules || !Object.hasOwn(entry.rules, options.rule)) return []\n\n    return [{\n      files: entry.files ?? null,\n      index,\n      name: entry.name ?? `anonymous config #${index + 1}`,\n      value: entry.rules[options.rule]\n    }]\n  })\n\n  const payload = {\n    configFile: configPath ? basename(configPath) : null,\n    diagnostics,\n    effective: effectiveValue ?? null,\n    enabled: effectiveValue !== undefined && isRuleEnabled(effectiveValue),\n    file,\n    packageHint: getPackageHint(options.rule),\n    rule: options.rule,\n    severity: effectiveValue === undefined ? null : getRuleSeverity(effectiveValue),\n    sources\n  }\n\n  if (options.json) {\n    console.log(JSON.stringify(payload, null, 2))\n  } else {\n    console.log([\n      `ESLint rule explanation: ${payload.rule}`,\n      `- File: ${payload.file}`,\n      `- Config: ${payload.configFile ?? 'none'}`,\n      `- Effective value: ${JSON.stringify(payload.effective)}`,\n      `- Enabled: ${payload.enabled ? 'yes' : 'no'}`,\n      `- Likely package: ${payload.packageHint ?? 'core or custom config'}`,\n      `- Defining entries: ${payload.sources.length}`,\n      ...(payload.diagnostics.length > 0 ?\n        [`- Current findings: ${payload.diagnostics.length}`] :\n        [])\n    ].join('\\n'))\n\n    for (const source of payload.sources) {\n      console.log(`  - ${source.name}: ${JSON.stringify(source.value)}`)\n    }\n\n    for (const diagnostic of payload.diagnostics) {\n      console.log(\n        `  - ${diagnostic.file}:${diagnostic.line ?? '?'}:${diagnostic.column ?? '?'} ` +\n        diagnostic.message\n      )\n    }\n  }\n\n  if (effectiveValue === undefined) process.exitCode = 1\n}\n\nconst getDependencyVersions = (manifest: null | Record<string, unknown>): Record<string, string> => {\n  const fields = ['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies']\n  const dependencies: Record<string, string> = {}\n\n  for (const field of fields) {\n    const values = manifest?.[field]\n\n    if (!values || typeof values !== 'object' || Array.isArray(values)) continue\n\n    for (const [name, version] of Object.entries(values)) {\n      if (typeof version === 'string') dependencies[name] = version\n    }\n  }\n\n  return dependencies\n}\n\nconst readResolvedManifest = (\n  basePath: string,\n  packageName: string\n): null | ResolvedPackageManifest => {\n  try {\n    const manifestPath = findPackageJSON(packageName, pathToFileURL(basePath))\n\n    const manifest = manifestPath ?\n      readJson(manifestPath) as null | PackageManifest :\n      null\n\n    if (manifestPath && manifest?.name === packageName) return { manifest, path: manifestPath }\n  } catch {\n    // Fall through for runtimes where package-JSON resolution is unavailable.\n  }\n\n  try {\n    let directory = dirname(createRequire(basePath).resolve(packageName))\n\n    for (let depth = 0; depth < 6; depth++) {\n      const manifestPath = join(directory, 'package.json')\n      const manifest = readJson(manifestPath) as null | PackageManifest\n\n      if (manifest?.name === packageName) return { manifest, path: manifestPath }\n\n      directory = dirname(directory)\n    }\n  } catch {\n    return null\n  }\n\n  return null\n}\n\nconst readWorkspaceManifest = (cwd: string, packageName: string): null | ResolvedPackageManifest => {\n  const packagesPath = join(cwd, 'packages')\n\n  if (!existsSync(packagesPath)) return null\n\n  for (const entry of readdirSync(packagesPath, { withFileTypes: true })) {\n    if (!entry.isDirectory()) continue\n\n    const manifestPath = join(packagesPath, entry.name, 'package.json')\n    const manifest = readJson(manifestPath) as null | PackageManifest\n\n    if (manifest?.name === packageName) return { manifest, path: manifestPath }\n  }\n\n  return null\n}\n\nexport const createCompatibilityReport = (cwd: string = process.cwd()) => {\n  const rootManifestPath = join(cwd, 'package.json')\n  const rootManifest = readJson(rootManifestPath)\n  const declared = getDependencyVersions(rootManifest)\n  const consumerNodeRange = (rootManifest as null | PackageManifest)?.engines?.node ?? null\n\n  const configPackages = Object.keys(declared)\n    .filter(name => name.startsWith('@santi020k/eslint-config-'))\n    .sort()\n\n  const runtimeVersions = {\n    consumerNodeRange,\n    eslint: readResolvedManifest(rootManifestPath, 'eslint')?.manifest.version ?? null,\n    node: process.versions.node,\n    typescript: readResolvedManifest(rootManifestPath, 'typescript')?.manifest.version ?? null\n  }\n\n  const packages = configPackages.map(name => {\n    const resolvedPackage = readResolvedManifest(rootManifestPath, name) ?? readWorkspaceManifest(cwd, name)\n    const manifest = resolvedPackage?.manifest\n    const issues: string[] = []\n\n    const aggregatedBasic = name === FULL_PACKAGE_NAME && resolvedPackage ?\n      readResolvedManifest(resolvedPackage.path, BASIC_PACKAGE_NAME) :\n      null\n\n    if (!manifest) {\n      issues.push('declared but not installed')\n    } else {\n      const nodeRange = manifest.engines?.node\n\n      if (nodeRange && !semver.satisfies(runtimeVersions.node, nodeRange)) {\n        issues.push(`requires Node ${nodeRange}`)\n      }\n\n      if (nodeRange && consumerNodeRange) {\n        if (!semver.validRange(consumerNodeRange)) {\n          issues.push(`consumer engines.node ${consumerNodeRange} is not a valid semver range`)\n        } else if (!semver.subset(consumerNodeRange, nodeRange)) {\n          issues.push(\n            `consumer engines.node ${consumerNodeRange} permits unsupported runtimes; requires ${nodeRange}`\n          )\n        }\n      }\n\n      for (const peer of ['eslint', 'typescript']) {\n        const range = manifest.peerDependencies?.[peer]\n        const version = runtimeVersions[peer as 'eslint' | 'typescript']\n\n        if (range && version && !semver.satisfies(version, range)) {\n          issues.push(`requires ${peer} ${range}, resolved ${version}`)\n        }\n      }\n    }\n\n    return {\n      aggregatedBasic: name === FULL_PACKAGE_NAME ?\n        {\n          name: BASIC_PACKAGE_NAME,\n          resolved: aggregatedBasic?.manifest.version ?? null,\n          resolvedPath: aggregatedBasic?.path ?? null\n        } :\n        null,\n      declared: declared[name],\n      issues,\n      name,\n      resolved: manifest?.version ?? null,\n      resolvedPath: resolvedPackage?.path ?? null\n    }\n  })\n\n  return {\n    compatible: packages.every(item => item.issues.length === 0),\n    packages,\n    runtime: runtimeVersions\n  }\n}\n\nexport const handleCompatibility = (\n  cwd: string = process.cwd(),\n  json = false\n): void => {\n  const report = createCompatibilityReport(cwd)\n\n  if (json) {\n    console.log(JSON.stringify(report, null, 2))\n  } else {\n    console.log([\n      `ESLint compatibility: ${report.compatible ? 'compatible' : 'issues found'}`,\n      `- Node: ${report.runtime.node}`,\n      `- Consumer Node range: ${report.runtime.consumerNodeRange ?? 'not declared'}`,\n      `- ESLint: ${report.runtime.eslint ?? 'not installed'}`,\n      `- TypeScript: ${report.runtime.typescript ?? 'not installed'}`\n    ].join('\\n'))\n\n    for (const item of report.packages) {\n      console.log(\n        `- ${item.name}: ${item.resolved ?? 'not installed'}` +\n        (item.resolvedPath ? ` at ${item.resolvedPath}` : '') +\n        (item.issues.length > 0 ? ` (${item.issues.join('; ')})` : '')\n      )\n\n      if (item.aggregatedBasic) {\n        console.log(\n          `  - Composer ${item.aggregatedBasic.name}: ` +\n          (item.aggregatedBasic.resolved ?? 'not resolved') +\n          (item.aggregatedBasic.resolvedPath ? ` at ${item.aggregatedBasic.resolvedPath}` : '')\n        )\n      }\n    }\n  }\n\n  if (!report.compatible) process.exitCode = 1\n}\n"],"mappings":"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","names":[]}

package/dist/cli-migration.js

@@ -175,6 +175,13 @@ const FACTORY_ALIAS_REPLACEMENTS = /* @__PURE__ */ new Set([
   "astroConfig",
   "gitignore"
 ]);
+const PARAMETER_PROPERTY_MODIFIERS = /* @__PURE__ */ new Set([
+  "override",
+  "private",
+  "protected",
+  "public",
+  "readonly"
+]);
 const dependencyFields = [
   "dependencies",
   "devDependencies",
@@ -323,16 +330,121 @@ const getEnclosingDelimiter = (content, offset) => {
   }
   return null;
 };
+const findClosingDelimiter = (content, start, opener, closer) => {
+  let depth = 0;
+  for (let index = start; index < content.length; index++) {
+    if (content[index] === opener) depth++;
+    else if (content[index] === closer && --depth === 0) return index + 1;
+  }
+  return content.length;
+};
+const getShadowedRanges = (content, name) => {
+  const masked = maskNonCode(content);
+  const importRanges = getImportRanges(content);
+  let searchable = masked;
+  for (const range of importRanges.toReversed()) {
+    searchable = `${searchable.slice(0, range.start)}${" ".repeat(range.end - range.start)}${searchable.slice(range.end)}`;
+  }
+  const getArrowRange = (start, arrowIndex) => {
+    const relativeBodyStart = searchable.slice(arrowIndex + 2).search(/\S/);
+    const bodyStart = relativeBodyStart === -1 ? searchable.length : arrowIndex + 2 + relativeBodyStart;
+    const bodyDelimiter = searchable[bodyStart];
+    let bodyCloser;
+    if (bodyDelimiter === "(") bodyCloser = ")";
+    else if (bodyDelimiter === "[") bodyCloser = "]";
+    if (bodyDelimiter === "{") {
+      return { end: findClosingDelimiter(searchable, bodyStart, "{", "}"), start };
+    }
+    if (bodyCloser) {
+      return { end: findClosingDelimiter(searchable, bodyStart, bodyDelimiter, bodyCloser), start };
+    }
+    const lineEnd = searchable.indexOf("\n", arrowIndex + 2);
+    return { end: lineEnd === -1 ? searchable.length : lineEnd, start };
+  };
+  const unparenthesizedArrowPattern = new RegExp(`\\b${name}\\b\\s*=>`, "gm");
+  const ranges = [...searchable.matchAll(unparenthesizedArrowPattern)].map((match) => getArrowRange(match.index, searchable.indexOf("=>", match.index)));
+  const splitAtTopLevel = (value, separator) => {
+    const parts = [];
+    const closers = { "(": ")", "[": "]", "{": "}" };
+    const expectedClosers = [];
+    let partStart = 0;
+    for (let index = 0; index < value.length; index++) {
+      const character = value[index];
+      const closer = closers[character];
+      if (closer) expectedClosers.push(closer);
+      else if (character === expectedClosers.at(-1)) expectedClosers.pop();
+      else if (character === separator && expectedClosers.length === 0) {
+        parts.push(value.slice(partStart, index));
+        partStart = index + 1;
+      }
+    }
+    parts.push(value.slice(partStart));
+    return parts;
+  };
+  const hasBindingName = (value) => {
+    let binding = splitAtTopLevel(value, "=")[0].trim();
+    if (binding.startsWith("...")) binding = binding.slice(3).trim();
+    binding = splitAtTopLevel(binding, ":")[0].trim();
+    const bindingParts = binding.split(/\s+/);
+    while (PARAMETER_PROPERTY_MODIFIERS.has(bindingParts[0])) bindingParts.shift();
+    binding = bindingParts.join(" ");
+    if (binding.startsWith("{") && binding.endsWith("}")) {
+      return splitAtTopLevel(binding.slice(1, -1), ",").some((property) => {
+        const propertyParts = splitAtTopLevel(property, ":");
+        return hasBindingName(propertyParts.length > 1 ? propertyParts.slice(1).join(":") : property);
+      });
+    }
+    if (binding.startsWith("[") && binding.endsWith("]")) {
+      return splitAtTopLevel(binding.slice(1, -1), ",").some(hasBindingName);
+    }
+    return binding.replace(/\?$/, "") === name;
+  };
+  const hasParameterBinding = (parameters) => splitAtTopLevel(parameters, ",").some(hasBindingName);
+  const parameterOwnerPattern = /(?:\bfunction\b[^()]*|\bcatch|\b(?:constructor|[a-zA-Z_$][\w$]*))\s*$/;
+  for (let parameterStart = 0; parameterStart < searchable.length; parameterStart++) {
+    if (searchable[parameterStart] !== "(") continue;
+    const parameterEnd = findClosingDelimiter(searchable, parameterStart, "(", ")");
+    if (searchable[parameterEnd - 1] !== ")") continue;
+    const parameters = searchable.slice(parameterStart + 1, parameterEnd - 1);
+    if (!hasParameterBinding(parameters)) continue;
+    const relativeBodyStart = searchable.slice(parameterEnd).search(/\S/);
+    const bodyStart = relativeBodyStart === -1 ? searchable.length : parameterEnd + relativeBodyStart;
+    if (searchable.startsWith("=>", bodyStart)) {
+      ranges.push(getArrowRange(parameterStart, bodyStart));
+      continue;
+    }
+    if (searchable[bodyStart] !== "{") continue;
+    const ownerMatch = parameterOwnerPattern.exec(searchable.slice(0, parameterStart));
+    if (!ownerMatch) continue;
+    ranges.push({
+      end: findClosingDelimiter(searchable, bodyStart, "{", "}"),
+      start: ownerMatch.index
+    });
+  }
+  const blockBindingPattern = new RegExp(`\\b(?:const|let|var|function|class)\\s+${name}\\b`, "g");
+  for (const match of searchable.matchAll(blockBindingPattern)) {
+    const blockStart = searchable.lastIndexOf("{", match.index);
+    if (blockStart !== -1) {
+      ranges.push({
+        end: findClosingDelimiter(searchable, blockStart, "{", "}"),
+        start: blockStart
+      });
+    }
+  }
+  return ranges;
+};
 const replaceBindingReferences = (content, from, to, invokeReferences = false) => {
   const importRanges = getImportRanges(content);
   const masked = maskNonCode(content);
   const identifierPattern = new RegExp(`\\b${from}\\b`, "g");
   const matches = [...masked.matchAll(identifierPattern)];
+  const shadowedRanges = getShadowedRanges(content, from);
   let updated = content;
   for (const match of matches.reverse()) {
     const offset = match.index;
     const isImportSpecifier = importRanges.some((range) => offset >= range.start && offset < range.end);
-    if (isImportSpecifier) continue;
+    const isShadowed = shadowedRanges.some((range) => offset >= range.start && offset < range.end);
+    if (isImportSpecifier || isShadowed) continue;
     const precedingContent = masked.slice(0, offset).trimEnd();
     const preceding = precedingContent.at(-1);
     const following = masked.slice(offset + from.length);
@@ -356,24 +468,27 @@ const replaceImportedAlias = (content, from, to, invokeReferences = false) => {
   const owner = REMOVED_ALIAS_OWNERS[from];
   const acceptedPackages = /* @__PURE__ */ new Set([BASIC_PACKAGE, FULL_PACKAGE, ...owner ? [owner] : []]);
   const importPattern = /import\s*\{([^}]*)\}\s*from\s*(['"])(@santi020k\/eslint-config-[^'"]+)\2/g;
-  let updated = content.replace(importPattern, (statement, specifierText, _quote, packageName) => {
-    if (!acceptedPackages.has(packageName)) return statement;
-    const specifiers = specifierText.split(",");
-    const rewritten = specifiers.map((specifier) => {
-      const aliasMatch = /^(\s*)([a-zA-Z_$][\w$]*)\s+as\s+([a-zA-Z_$][\w$]*)(\s*)$/.exec(specifier);
-      if (aliasMatch?.[2] === from) {
-        const localName = aliasMatch[3];
-        bindings.push({ from: localName, to: localName });
-        return `${aliasMatch[1]}${to} as ${localName}${aliasMatch[4]}`;
-      }
-      const directMatch = /^(\s*)([a-zA-Z_$][\w$]*)(\s*)$/.exec(specifier);
-      if (directMatch?.[2] !== from) return specifier;
-      bindings.push({ from, to });
-      return `${directMatch[1]}${to}${directMatch[3]}`;
-    });
-    const rewrittenText = rewritten.join(",");
-    return rewrittenText === specifierText ? statement : statement.replace(specifierText, rewrittenText);
-  });
+  let updated = content.replace(
+    importPattern,
+    (statement, specifierText, _quote, packageName) => {
+      if (!acceptedPackages.has(packageName)) return statement;
+      const specifiers = specifierText.split(",");
+      const rewritten = specifiers.map((specifier) => {
+        const aliasMatch = /^(\s*)([a-zA-Z_$][\w$]*)\s+as\s+([a-zA-Z_$][\w$]*)(\s*)$/.exec(specifier);
+        if (aliasMatch?.[2] === from) {
+          const localName = aliasMatch[3];
+          bindings.push({ from: localName, to: localName });
+          return `${aliasMatch[1]}${to} as ${localName}${aliasMatch[4]}`;
+        }
+        const directMatch = /^(\s*)([a-zA-Z_$][\w$]*)(\s*)$/.exec(specifier);
+        if (directMatch?.[2] !== from) return specifier;
+        bindings.push({ from, to });
+        return `${directMatch[1]}${to}${directMatch[3]}`;
+      });
+      const rewrittenText = rewritten.join(",");
+      return rewrittenText === specifierText ? statement : statement.replace(specifierText, rewrittenText);
+    }
+  );
   for (const binding of bindings) {
     updated = replaceBindingReferences(updated, binding.from, binding.to, invokeReferences);
   }
@@ -420,17 +535,234 @@ const hasCodePropertySeparator = (codeContent, match) => {
   const matchIndex = match.index ?? -1;
   return matchIndex >= 0 && separatorOffset >= 0 && codeContent[matchIndex + separatorOffset] === ":";
 };
+const replaceCodeProperty = (content, property, replacement, matches) => {
+  const masked = maskNonCode(content, true);
+  const pattern = new RegExp(`\\b${property}\\b(?=\\s*:)`, "g");
+  const propertyMatches = matches ?? [...masked.matchAll(pattern)];
+  let updated = content;
+  for (const match of propertyMatches.toReversed()) {
+    const { index } = match;
+    if (index === void 0) continue;
+    updated = `${updated.slice(0, index)}${replacement}${updated.slice(index + property.length)}`;
+  }
+  return updated;
+};
+const toFeatureName = (value) => {
+  const trimmed = value.trim();
+  const enumMatch = /^(?:Extension|Format|Library|Testing|Tool)\.([a-zA-Z0-9_$]+)$/.exec(trimmed);
+  const stringMatch = /^(['"])([^'"]+)\1$/.exec(trimmed);
+  const raw = enumMatch?.[1] ?? stringMatch?.[2];
+  return raw ? toKebabCase(raw) : null;
+};
+const getOwningObjectStart = (structure, position) => {
+  const objectStarts = [];
+  for (let index = 0; index < position; index++) {
+    if (structure[index] === "{") objectStarts.push(index);
+    if (structure[index] === "}") objectStarts.pop();
+  }
+  return objectStarts.at(-1);
+};
+const getDefineConfigOptionOwners = (searchable) => {
+  const owners = new Set(
+    [...searchable.matchAll(/\bdefineConfig\s*\(\s*\{/g)].map((match) => match.index + match[0].lastIndexOf("{"))
+  );
+  const optionNames = new Set(
+    [...searchable.matchAll(/\bdefineConfig\s*\(\s*([a-zA-Z_$][\w$]*)\b/g)].map((match) => match[1])
+  );
+  for (const optionName of optionNames) {
+    const bindingPattern = new RegExp(`\\b(?:const|let|var)\\s+${optionName}\\s*=\\s*\\{`, "g");
+    for (const match of searchable.matchAll(bindingPattern)) {
+      owners.add(match.index + match[0].lastIndexOf("{"));
+    }
+  }
+  return owners;
+};
+const getDirectChildObjectStarts = (structure, containerStart) => {
+  const children = [];
+  const objectStarts = [containerStart];
+  for (let index = containerStart + 1; index < structure.length && objectStarts.length > 0; index++) {
+    if (structure[index] === "{") {
+      if (objectStarts.at(-1) === containerStart) children.push(index);
+      objectStarts.push(index);
+    } else if (structure[index] === "}") {
+      objectStarts.pop();
+    }
+  }
+  return children;
+};
+const getOwnedObjectPropertyStarts = (searchable, structure, property, owners) => {
+  const pattern = new RegExp(`\\b${property}\\b\\s*:\\s*\\{`, "g");
+  return [...searchable.matchAll(pattern)].flatMap((match) => {
+    const owner = getOwningObjectStart(structure, match.index);
+    const objectStart = match.index + match[0].lastIndexOf("{");
+    return owner !== void 0 && owners.has(owner) && hasCodePropertySeparator(structure, match) && structure[objectStart] === "{" ? [objectStart] : [];
+  });
+};
+const getBasicOptionOwners = (searchable, structure) => {
+  const owners = getDefineConfigOptionOwners(searchable);
+  for (const projectDefaultsOwner of getOwnedObjectPropertyStarts(
+    searchable,
+    structure,
+    "projectDefaults",
+    owners
+  )) {
+    owners.add(projectDefaultsOwner);
+  }
+  const visitedProjectContainers = /* @__PURE__ */ new Set();
+  let projectContainers = getOwnedObjectPropertyStarts(searchable, structure, "projects", owners);
+  while (projectContainers.length > 0) {
+    for (const container of projectContainers) {
+      visitedProjectContainers.add(container);
+      for (const projectOwner of getDirectChildObjectStarts(structure, container)) {
+        owners.add(projectOwner);
+      }
+    }
+    projectContainers = getOwnedObjectPropertyStarts(searchable, structure, "projects", owners).filter((container) => !visitedProjectContainers.has(container));
+  }
+  return owners;
+};
+const getOwnedPropertyMatches = (searchable, structure, property, owners) => {
+  const pattern = new RegExp(`\\b${property}\\b\\s*:`, "g");
+  return [...searchable.matchAll(pattern)].flatMap((match) => {
+    const owner = getOwningObjectStart(structure, match.index);
+    return owner !== void 0 && owners.has(owner) && hasCodePropertySeparator(structure, match) ? [match] : [];
+  });
+};
+const modernizeLiteralFeatureArrays = (content) => {
+  const searchable = maskNonCode(content, true);
+  const structure = maskNonCode(content);
+  const optionOwners = getBasicOptionOwners(searchable, structure);
+  const selections = [...searchable.matchAll(
+    /\b(?:extensions|formats|libraries|testing|tools)\b\s*:\s*\[([\s\S]*?)\]\s*,?/g
+  )].flatMap((match) => {
+    if (/\/[/*]/.test(content.slice(match.index, match.index + match[0].length))) return [];
+    const features2 = match[1].split(",").filter(Boolean).map(toFeatureName);
+    const owner = getOwningObjectStart(structure, match.index);
+    if (owner === void 0 || !optionOwners.has(owner) || !hasCodePropertySeparator(structure, match) || features2.length === 0 || features2.some((feature) => feature === null)) return [];
+    return [{
+      end: match.index + match[0].length,
+      features: features2,
+      owner,
+      start: match.index
+    }];
+  });
+  if (selections.length === 0) return { changed: false, content, features: [] };
+  const features = [...new Set(selections.flatMap((selection) => selection.features))];
+  const selectionsByOwner = /* @__PURE__ */ new Map();
+  for (const selection of selections) {
+    const ownedSelections = selectionsByOwner.get(selection.owner);
+    if (ownedSelections) ownedSelections.push(selection);
+    else selectionsByOwner.set(selection.owner, [selection]);
+  }
+  const existingFeaturesByOwner = /* @__PURE__ */ new Map();
+  for (const match of searchable.matchAll(/\bfeatures\b\s*:\s*\{/g)) {
+    const owner = getOwningObjectStart(structure, match.index);
+    if (owner !== void 0 && !existingFeaturesByOwner.has(owner)) {
+      existingFeaturesByOwner.set(owner, match);
+    }
+  }
+  const edits = [];
+  for (const [owner, ownedSelections] of selectionsByOwner) {
+    const ownedFeatures = [...new Set(ownedSelections.flatMap((selection) => selection.features))];
+    const first = ownedSelections[0];
+    const lineStart = content.lastIndexOf("\n", first.start) + 1;
+    const indent = /^\s*/.exec(content.slice(lineStart, first.start))?.[0] ?? "";
+    const existingFeatures = existingFeaturesByOwner.get(owner);
+    const featureBlock = existingFeatures ? `
+${ownedFeatures.map((feature) => `${indent}  ${JSON.stringify(feature)}: true,`).join("\n")}` : [
+      "features: {",
+      ...ownedFeatures.map((feature) => `${indent}  ${JSON.stringify(feature)}: true,`),
+      `${indent}},`
+    ].join("\n");
+    for (const selection of ownedSelections) {
+      edits.push({
+        end: selection.end,
+        replacement: !existingFeatures && selection === first ? featureBlock : "",
+        start: selection.start
+      });
+    }
+    if (existingFeatures) {
+      const insertionIndex = (existingFeatures.index ?? 0) + existingFeatures[0].length;
+      edits.push({
+        end: insertionIndex,
+        replacement: featureBlock,
+        start: insertionIndex
+      });
+    }
+  }
+  let updated = content;
+  for (const edit of edits.sort((a, b) => b.start - a.start)) {
+    updated = `${updated.slice(0, edit.start)}${edit.replacement}${updated.slice(edit.end)}`;
+  }
+  return { changed: updated !== content, content: updated, features };
+};
+const modernizeConfigOptions = (content) => {
+  const changes = [];
+  let updated = content;
+  const searchable = maskNonCode(updated, true);
+  const structure = maskNonCode(updated);
+  const basicOptionOwners = getBasicOptionOwners(searchable, structure);
+  const featureOwners = new Set(
+    getOwnedPropertyMatches(searchable, structure, "features", basicOptionOwners).flatMap((match) => {
+      if (match.index === void 0) return [];
+      const owner = getOwningObjectStart(structure, match.index);
+      return owner === void 0 ? [] : [owner];
+    })
+  );
+  const integrationMatches = getOwnedPropertyMatches(searchable, structure, "integrations", basicOptionOwners).filter((match) => {
+    if (match.index === void 0) return false;
+    const owner = getOwningObjectStart(structure, match.index);
+    return owner !== void 0 && !featureOwners.has(owner);
+  });
+  if (integrationMatches.length > 0) {
+    updated = replaceCodeProperty(updated, "integrations", "features", integrationMatches);
+    changes.push("Replaced the deprecated integrations map with features.");
+  }
+  const updatedSearchable = maskNonCode(updated, true);
+  const updatedStructure = maskNonCode(updated);
+  const optionOwners = getDefineConfigOptionOwners(updatedSearchable);
+  const rootMatches = getOwnedPropertyMatches(updatedSearchable, updatedStructure, "root", optionOwners);
+  const rootAliasMatches = /* @__PURE__ */ new Map([
+    ["detectRootDir", getOwnedPropertyMatches(updatedSearchable, updatedStructure, "detectRootDir", optionOwners)],
+    ["tsconfigRootDir", getOwnedPropertyMatches(updatedSearchable, updatedStructure, "tsconfigRootDir", optionOwners)]
+  ]);
+  const rootAliases = [...rootAliasMatches].filter(([, matches]) => matches.length > 0).map(([alias]) => alias);
+  if (rootMatches.length === 0 && rootAliases.length === 1) {
+    const alias = rootAliases[0];
+    updated = replaceCodeProperty(updated, alias, "root", rootAliasMatches.get(alias));
+    changes.push(`Replaced ${alias} with the v3 root option.`);
+  } else if (rootAliases.length > 0) {
+    changes.push(
+      `Manual action required: consolidate ${rootAliases.join(" and ")} into root after confirming they resolve to the same directory.`
+    );
+  }
+  const featureMigration = modernizeLiteralFeatureArrays(updated);
+  if (featureMigration.changed) {
+    updated = featureMigration.content;
+    changes.push(`Replaced literal category arrays with the v3 features map (${featureMigration.features.join(", ")}).`);
+  }
+  if (maskNonCode(updated, true).includes("better-tailwindcss/no-unknown-classes")) {
+    changes.push(
+      'Manual action required: replace the raw better-tailwindcss/no-unknown-classes override with projects["<scope>"].tailwind.noUnknownClasses.'
+    );
+  }
+  return { changes, content: updated };
+};
 const getExplicitConfigFeaturePackages = (content) => {
   const packages = /* @__PURE__ */ new Set();
   const codeContent = maskNonCode(content);
   const searchableContent = maskNonCode(content, true);
+  const optionOwners = getBasicOptionOwners(searchableContent, codeContent);
+  const isBasicOption = (match) => {
+    const owner = getOwningObjectStart(codeContent, match.index ?? -1);
+    return owner !== void 0 && optionOwners.has(owner) && hasCodePropertySeparator(codeContent, match);
+  };
   for (const category of Object.keys(FEATURE_PACKAGES)) {
     const categorySelections = searchableContent.matchAll(
-      // eslint-disable-next-line security/detect-non-literal-regexp -- category names come from the internal package registry
       new RegExp(`(?:\\b${category}\\b|['"]${category}['"])\\s*:\\s*\\[([\\s\\S]*?)\\]`, "g")
     );
     for (const selection of categorySelections) {
-      if (hasCodePropertySeparator(codeContent, selection) && selection[1].trim()) {
+      if (isBasicOption(selection) && selection[1].trim()) {
         packages.add(FEATURE_PACKAGES[category]);
         break;
       }
@@ -438,7 +770,7 @@ const getExplicitConfigFeaturePackages = (content) => {
   }
   const featureSelections = /(?:\b(?:features|integrations)\b|['"](?:features|integrations)['"])\s*:\s*\{([\s\S]*?)\}/g;
   for (const selection of searchableContent.matchAll(featureSelections)) {
-    if (!hasCodePropertySeparator(codeContent, selection)) continue;
+    if (!isBasicOption(selection)) continue;
     const enabledFeaturePattern = /(?:['"]([^'"]+)['"]|([a-zA-Z_$][\w$-]*))\s*:\s*true\b/g;
     for (const match of selection[1].matchAll(enabledFeaturePattern)) {
       const featureName = (match[1] || match[2]).toLowerCase();
@@ -448,7 +780,7 @@ const getExplicitConfigFeaturePackages = (content) => {
   }
   const enumPresetPattern = /(?:\bpreset\b|['"]preset['"])\s*:\s*Preset\.(All|App|CI|Library|Monorepo)/g;
   for (const match of searchableContent.matchAll(enumPresetPattern)) {
-    if (!hasCodePropertySeparator(codeContent, match)) continue;
+    if (!isBasicOption(match)) continue;
     const presetName = match[1].toLowerCase();
     for (const packageName of PRESET_FEATURE_PACKAGES[presetName] ?? []) {
       packages.add(packageName);
@@ -456,31 +788,39 @@ const getExplicitConfigFeaturePackages = (content) => {
   }
   const stringPresetPattern = /(?:\bpreset\b|['"]preset['"])\s*:\s*(['"`])(all|app|ci|library|monorepo)\1/g;
   for (const match of searchableContent.matchAll(stringPresetPattern)) {
-    if (!hasCodePropertySeparator(codeContent, match)) continue;
+    if (!isBasicOption(match)) continue;
     for (const packageName of PRESET_FEATURE_PACKAGES[match[2]] ?? []) {
       packages.add(packageName);
     }
   }
   const strictPattern = /(?:\bstrict\b|['"]strict['"])\s*:\s*(['"`])pedantic\1/g;
   for (const match of searchableContent.matchAll(strictPattern)) {
-    if (hasCodePropertySeparator(codeContent, match)) {
+    if (isBasicOption(match)) {
       packages.add(FEATURE_PACKAGES.extensions);
       break;
     }
   }
   return [...packages];
 };
+const replacePackageSpecifiers = (content, from, to) => content.replace(
+  /(\b(?:from|import|export)\s*(?:\(\s*)?|\brequire\s*\(\s*)(['"])([^'"]+)\2/g,
+  (statement, prefix, quote, specifier) => specifier === from ? `${prefix}${quote}${to}${quote}` : statement
+);
 const migrateConfigToV3 = (content, mode) => {
   const changes = [];
   const featurePackages = new Set(getExplicitConfigFeaturePackages(content));
   let migrated = content;
-  if (migrated.includes(LITE_PACKAGE)) {
-    migrated = migrated.replaceAll(LITE_PACKAGE, BASIC_PACKAGE);
+  const liteMigrated = replacePackageSpecifiers(migrated, LITE_PACKAGE, BASIC_PACKAGE);
+  if (liteMigrated !== migrated) {
+    migrated = liteMigrated;
     changes.push("Replaced the Lite compatibility import with Basic.");
   }
-  if (mode === "full" && migrated.includes(BASIC_PACKAGE)) {
-    migrated = migrated.replaceAll(BASIC_PACKAGE, FULL_PACKAGE);
-    changes.push("Switched the root config import to the full bundle.");
+  if (mode === "full") {
+    const fullMigrated = replacePackageSpecifiers(migrated, BASIC_PACKAGE, FULL_PACKAGE);
+    if (fullMigrated !== migrated) {
+      migrated = fullMigrated;
+      changes.push("Switched the root config import to the full bundle.");
+    }
   }
   if (mode === "lean") {
     const split = splitBasicIntegrationImports(migrated);
@@ -506,13 +846,21 @@ const migrateConfigToV3 = (content, mode) => {
     migrated = remixMigrated;
     changes.push('Moved frameworks.remix to frameworks["react-router"].');
   }
-  if (migrated.includes(REMIX_PACKAGE)) {
-    migrated = migrated.replaceAll(REMIX_PACKAGE, FRAMEWORK_PACKAGES["react-router"]);
+  const reactRouterMigrated = replacePackageSpecifiers(
+    migrated,
+    REMIX_PACKAGE,
+    FRAMEWORK_PACKAGES["react-router"]
+  );
+  if (reactRouterMigrated !== migrated) {
+    migrated = reactRouterMigrated;
     changes.push("Replaced the Remix package import with React Router.");
   }
   if (/\bloadModule\b/.test(migrated)) {
     changes.push("Manual action required: replace loadModule usage with createModuleLoader(resolver).");
   }
+  const modernized = modernizeConfigOptions(migrated);
+  migrated = modernized.content;
+  changes.push(...modernized.changes);
   return {
     changes,
     content: migrated,
@@ -525,13 +873,18 @@ const shouldUseFullBundle = (configContent, packageJson, forceFull) => {
   if (configContent) {
     const codeContent = maskNonCode(configContent);
     const searchableContent = maskNonCode(configContent, true);
+    const optionOwners = getDefineConfigOptionOwners(searchableContent);
+    const isRootOption = (match) => {
+      const owner = getOwningObjectStart(codeContent, match.index ?? -1);
+      return owner !== void 0 && optionOwners.has(owner) && hasCodePropertySeparator(codeContent, match);
+    };
     const enumPresetPattern = /(?:\bpreset\b|['"]preset['"])\s*:\s*Preset\.All/g;
     for (const match of searchableContent.matchAll(enumPresetPattern)) {
-      if (hasCodePropertySeparator(codeContent, match)) return true;
+      if (isRootOption(match)) return true;
     }
     const stringPresetPattern = /(?:\bpreset\b|['"]preset['"])\s*:\s*(['"`])all\1/g;
     for (const match of searchableContent.matchAll(stringPresetPattern)) {
-      if (hasCodePropertySeparator(codeContent, match)) return true;
+      if (isRootOption(match)) return true;
     }
   }
   return getDeclaredConfigPackages(packageJson).has(FULL_PACKAGE);
@@ -780,3 +1133,4 @@ export {
   handleMigrateV3,
   migrateConfigToV3
 };
+//# sourceMappingURL=cli-migration.js.map