@xylabs/toolchain 7.10.0

package/dist/actions/deplint/checkPackage/getUnlistedDevDependencies.mjs

@@ -0,0 +1,125 @@
+// src/actions/deplint/checkPackage/getUnlistedDevDependencies.ts
+import { builtinModules } from "module";
+import chalk2 from "chalk";
+
+// src/actions/deplint/packageJsonEditor.ts
+import fs2 from "fs";
+import chalk from "chalk";
+import sortPackageJson from "sort-package-json";
+
+// src/actions/deplint/getRequiredPeerDependencies.ts
+import fs from "fs";
+import path from "path";
+function findDepPackageJson(location, dep) {
+  let dir = location;
+  while (true) {
+    const candidate = path.join(dir, "node_modules", dep, "package.json");
+    if (fs.existsSync(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+
+// src/actions/deplint/packageJsonEditor.ts
+function readPackageJson(location) {
+  return JSON.parse(fs2.readFileSync(`${location}/package.json`, "utf8"));
+}
+function writePackageJson(location, pkg) {
+  const sorted = sortPackageJson(JSON.stringify(pkg, null, 2));
+  fs2.writeFileSync(`${location}/package.json`, `${sorted}
+`);
+}
+function addDep(pkg, dep, version, section) {
+  const sectionObj = pkg[section] ?? {};
+  sectionObj[dep] = version;
+  pkg[section] = sectionObj;
+}
+function resolveDepVersion(location, dep) {
+  const depPkgPath = findDepPackageJson(location, dep);
+  if (depPkgPath) {
+    try {
+      const depPkg = JSON.parse(fs2.readFileSync(depPkgPath, "utf8"));
+      const version = depPkg.version;
+      if (version) return `~${version}`;
+    } catch {
+    }
+  }
+  return "*";
+}
+function logFix(workspace, action, dep, detail) {
+  const detailStr = detail ? ` (${detail})` : "";
+  console.log(`[${chalk.blue(workspace.name)}] Fixed: ${action} ${chalk.green(dep)}${detailStr}`);
+}
+
+// src/actions/deplint/tsScriptsAliases.ts
+var VARIANT_MAP = {
+  "@xylabs/ts-scripts-yarn3": "@xylabs/ts-scripts-pnpm",
+  "@xylabs/ts-scripts-pnpm": "@xylabs/ts-scripts-yarn3",
+  "@xylabs/ts-scripts-react-yarn3": "@xylabs/ts-scripts-react-pnpm",
+  "@xylabs/ts-scripts-react-pnpm": "@xylabs/ts-scripts-react-yarn3"
+};
+function isSatisfiedByTsScriptsVariant(imp, allDeps) {
+  const variant = VARIANT_MAP[imp];
+  return variant !== void 0 && allDeps.includes(variant);
+}
+
+// src/actions/deplint/checkPackage/getUnlistedDevDependencies.ts
+function findUnlistedDevDeps(name, dependencies, devDependencies, peerDependencies, externalAllImports, distImports, externalDistTypeImports) {
+  const results = [];
+  for (const imp of externalAllImports) {
+    if (!distImports.includes(imp) && !externalDistTypeImports.includes(imp) && imp !== name && !dependencies.includes(imp) && !dependencies.includes(`@types/${imp}`) && !peerDependencies.includes(imp) && !peerDependencies.includes(`@types/${imp}`) && !devDependencies.includes(imp) && !devDependencies.includes(`@types/${imp}`) && !builtinModules.includes(imp) && !isSatisfiedByTsScriptsVariant(imp, [...dependencies, ...devDependencies, ...peerDependencies])) {
+      results.push(imp);
+    }
+  }
+  return results;
+}
+function getUnlistedDevDependencies({ name, location }, {
+  devDependencies,
+  dependencies,
+  peerDependencies
+}, {
+  allImportPaths,
+  externalAllImports,
+  distImports,
+  externalDistTypeImports
+}) {
+  const unlisted = findUnlistedDevDeps(name, dependencies, devDependencies, peerDependencies, externalAllImports, distImports, externalDistTypeImports);
+  for (const imp of unlisted) {
+    console.log(`[${chalk2.blue(name)}] Missing devDependency in package.json: ${chalk2.red(imp)}`);
+    if (allImportPaths[imp]) {
+      console.log(`  ${allImportPaths[imp].join("\n ")}`);
+    }
+  }
+  if (unlisted.length > 0) {
+    console.log(`  ${chalk2.yellow(`${location}/package.json`)}
+`);
+  }
+  return unlisted.length;
+}
+function fixUnlistedDevDependencies(workspace, {
+  devDependencies,
+  dependencies,
+  peerDependencies
+}, {
+  externalAllImports,
+  distImports,
+  externalDistTypeImports
+}) {
+  const unlisted = findUnlistedDevDeps(workspace.name, dependencies, devDependencies, peerDependencies, externalAllImports, distImports, externalDistTypeImports);
+  if (unlisted.length === 0) return 0;
+  const pkg = readPackageJson(workspace.location);
+  for (const imp of unlisted) {
+    const version = resolveDepVersion(workspace.location, imp);
+    addDep(pkg, imp, version, "devDependencies");
+    logFix(workspace, "added to devDependencies", imp, version);
+  }
+  writePackageJson(workspace.location, pkg);
+  return unlisted.length;
+}
+export {
+  findUnlistedDevDeps,
+  fixUnlistedDevDependencies,
+  getUnlistedDevDependencies
+};
+//# sourceMappingURL=getUnlistedDevDependencies.mjs.map

package/dist/actions/deplint/checkPackage/getUnlistedDevDependencies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/actions/deplint/checkPackage/getUnlistedDevDependencies.ts","../../../../src/actions/deplint/packageJsonEditor.ts","../../../../src/actions/deplint/getRequiredPeerDependencies.ts","../../../../src/actions/deplint/tsScriptsAliases.ts"],"sourcesContent":["import { builtinModules } from 'node:module'\n\nimport chalk from 'chalk'\n\nimport type { Workspace } from '../../../pm/index.ts'\nimport {\n  addDep, logFix, readPackageJson, resolveDepVersion, writePackageJson,\n} from '../packageJsonEditor.ts'\nimport { isSatisfiedByTsScriptsVariant } from '../tsScriptsAliases.ts'\nimport type { CheckPackageParams, CheckSourceParams } from './checkPackageTypes.ts'\n\nexport function findUnlistedDevDeps(\n  name: string,\n  dependencies: string[],\n  devDependencies: string[],\n  peerDependencies: string[],\n  externalAllImports: string[],\n  distImports: string[],\n  externalDistTypeImports: string[],\n): string[] {\n  const results: string[] = []\n  for (const imp of externalAllImports) {\n    if (!distImports.includes(imp)\n      && !externalDistTypeImports.includes(imp)\n      && imp !== name\n      && !dependencies.includes(imp)\n      && !dependencies.includes(`@types/${imp}`)\n      && !peerDependencies.includes(imp)\n      && !peerDependencies.includes(`@types/${imp}`)\n      && !devDependencies.includes(imp)\n      && !devDependencies.includes(`@types/${imp}`)\n      && !builtinModules.includes(imp)\n      && !isSatisfiedByTsScriptsVariant(imp, [...dependencies, ...devDependencies, ...peerDependencies])\n    ) {\n      results.push(imp)\n    }\n  }\n  return results\n}\n\nexport function getUnlistedDevDependencies(\n  { name, location }: Workspace,\n  {\n    devDependencies, dependencies, peerDependencies,\n  }: CheckPackageParams,\n  {\n    allImportPaths, externalAllImports, distImports, externalDistTypeImports,\n  }: CheckSourceParams,\n) {\n  const unlisted = findUnlistedDevDeps(name, dependencies, devDependencies, peerDependencies, externalAllImports, distImports, externalDistTypeImports)\n\n  for (const imp of unlisted) {\n    console.log(`[${chalk.blue(name)}] Missing devDependency in package.json: ${chalk.red(imp)}`)\n    if (allImportPaths[imp]) {\n      console.log(`  ${allImportPaths[imp].join('\\n ')}`)\n    }\n  }\n  if (unlisted.length > 0) {\n    console.log(`  ${chalk.yellow(`${location}/package.json`)}\\n`)\n  }\n  return unlisted.length\n}\n\nexport function fixUnlistedDevDependencies(\n  workspace: Workspace,\n  {\n    devDependencies, dependencies, peerDependencies,\n  }: CheckPackageParams,\n  {\n    externalAllImports, distImports, externalDistTypeImports,\n  }: CheckSourceParams,\n) {\n  const unlisted = findUnlistedDevDeps(workspace.name, dependencies, devDependencies, peerDependencies, externalAllImports, distImports, externalDistTypeImports)\n  if (unlisted.length === 0) return 0\n\n  const pkg = readPackageJson(workspace.location)\n\n  for (const imp of unlisted) {\n    const version = resolveDepVersion(workspace.location, imp)\n    addDep(pkg, imp, version, 'devDependencies')\n    logFix(workspace, 'added to devDependencies', imp, version)\n  }\n\n  writePackageJson(workspace.location, pkg)\n  return unlisted.length\n}\n","import fs from 'node:fs'\n\nimport chalk from 'chalk'\nimport sortPackageJson from 'sort-package-json'\n\nimport type { Workspace } from '../../pm/index.ts'\nimport { findDepPackageJson } from './getRequiredPeerDependencies.ts'\n\nexport interface PackageJson {\n  [key: string]: unknown\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n  peerDependencies?: Record<string, string>\n}\n\nexport function readPackageJson(location: string): PackageJson {\n  return JSON.parse(fs.readFileSync(`${location}/package.json`, 'utf8')) as PackageJson\n}\n\nexport function writePackageJson(location: string, pkg: PackageJson): void {\n  const sorted = sortPackageJson(JSON.stringify(pkg, null, 2))\n  fs.writeFileSync(`${location}/package.json`, `${sorted}\\n`)\n}\n\n/**\n * Move a dependency from one section to another (e.g. dependencies → devDependencies).\n */\nexport function moveDep(pkg: PackageJson, dep: string, from: string, to: string): void {\n  const fromSection = pkg[from] as Record<string, string> | undefined\n  if (!fromSection?.[dep]) return\n\n  const version = fromSection[dep]\n  delete fromSection[dep]\n  if (Object.keys(fromSection).length === 0) {\n    delete pkg[from]\n  }\n\n  const toSection = (pkg[to] ?? {}) as Record<string, string>\n  toSection[dep] = version\n  pkg[to] = toSection\n}\n\n/**\n * Remove a dependency from a section.\n */\nexport function removeDep(pkg: PackageJson, dep: string, section: string): void {\n  const sectionObj = pkg[section] as Record<string, string> | undefined\n  if (!sectionObj?.[dep]) return\n\n  delete sectionObj[dep]\n  if (Object.keys(sectionObj).length === 0) {\n    delete pkg[section]\n  }\n}\n\n/**\n * Add a dependency to a section with a resolved version.\n */\nexport function addDep(pkg: PackageJson, dep: string, version: string, section: string): void {\n  const sectionObj = (pkg[section] ?? {}) as Record<string, string>\n  sectionObj[dep] = version\n  pkg[section] = sectionObj\n}\n\n/**\n * Resolve the version for a missing dependency.\n * Looks in node_modules first, then falls back to '*'.\n */\nexport function resolveDepVersion(location: string, dep: string): string {\n  const depPkgPath = findDepPackageJson(location, dep)\n  if (depPkgPath) {\n    try {\n      const depPkg = JSON.parse(fs.readFileSync(depPkgPath, 'utf8')) as Record<string, unknown>\n      const version = depPkg.version as string | undefined\n      if (version) return `~${version}`\n    } catch {\n      // Fall through\n    }\n  }\n  return '*'\n}\n\n/**\n * Compute the expected peerDependency version range for a dependency,\n * preserving the current range style (^ vs ~).\n *\n * - If the current range uses ^, returns ^<major> (e.g. ^7)\n * - Otherwise returns ~<major>.<minor> (e.g. ~7.6)\n * - Falls back to resolveDepVersion if no installed version found\n */\nexport function resolveExpectedPeerVersion(location: string, dep: string, currentRange?: string): string {\n  const depPkgPath = findDepPackageJson(location, dep)\n  if (depPkgPath) {\n    try {\n      const depPkg = JSON.parse(fs.readFileSync(depPkgPath, 'utf8')) as Record<string, unknown>\n      const version = depPkg.version as string | undefined\n      if (version) {\n        const match = /^(\\d+)\\.(\\d+)/.exec(version)\n        if (match) {\n          if (currentRange?.startsWith('^')) {\n            return `^${match[1]}`\n          }\n          return `~${match[1]}.${match[2]}`\n        }\n        return `~${version}`\n      }\n    } catch {\n      // Fall through\n    }\n  }\n  return '*'\n}\n\nexport function logFix(workspace: Workspace, action: string, dep: string, detail?: string): void {\n  const detailStr = detail ? ` (${detail})` : ''\n  console.log(`[${chalk.blue(workspace.name)}] Fixed: ${action} ${chalk.green(dep)}${detailStr}`)\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\n\nexport function findDepPackageJson(location: string, dep: string): string | undefined {\n  let dir = location\n  while (true) {\n    const candidate = path.join(dir, 'node_modules', dep, 'package.json')\n    if (fs.existsSync(candidate)) return candidate\n    const parent = path.dirname(dir)\n    if (parent === dir) return undefined\n    dir = parent\n  }\n}\n\n/**\n * Collects the peerDependencies declared by all of a package's\n * dependencies and devDependencies. A devDependency that satisfies\n * one of these peer requirements should not be flagged as unused.\n */\nexport function getRequiredPeerDependencies(\n  location: string,\n  allDeps: string[],\n): Set<string> {\n  const required = new Set<string>()\n  for (const dep of allDeps) {\n    const depPkgPath = findDepPackageJson(location, dep)\n    if (!depPkgPath) continue\n    try {\n      const raw = fs.readFileSync(depPkgPath, 'utf8')\n      const pkg = JSON.parse(raw) as Record<string, unknown>\n      const peerDeps = pkg.peerDependencies as Record<string, string> | undefined\n      if (peerDeps) {\n        for (const peer of Object.keys(peerDeps)) {\n          required.add(peer)\n        }\n      }\n    } catch {\n      // Package not readable — skip\n    }\n  }\n  return required\n}\n","/**\n * After a packman convert, source files may still import from the old\n * ts-scripts variant (e.g. yarn3 → pnpm).  Deplint should not flag\n * these as missing when the correct PM variant is installed.\n *\n * Maps each ts-scripts package to the variant it can be satisfied by.\n */\nconst VARIANT_MAP: Record<string, string> = {\n  '@xylabs/ts-scripts-yarn3': '@xylabs/ts-scripts-pnpm',\n  '@xylabs/ts-scripts-pnpm': '@xylabs/ts-scripts-yarn3',\n  '@xylabs/ts-scripts-react-yarn3': '@xylabs/ts-scripts-react-pnpm',\n  '@xylabs/ts-scripts-react-pnpm': '@xylabs/ts-scripts-react-yarn3',\n}\n\n/**\n * Returns true if `imp` is a ts-scripts import whose other PM variant\n * is present in the dependency lists, meaning the import is satisfied.\n */\nexport function isSatisfiedByTsScriptsVariant(\n  imp: string,\n  allDeps: string[],\n): boolean {\n  const variant = VARIANT_MAP[imp]\n  return variant !== undefined && allDeps.includes(variant)\n}\n\n/**\n * Returns true if `dep` is a ts-scripts package whose other PM variant\n * appears in the import list, meaning the dep is effectively used.\n */\nexport function isUsedViaTsScriptsVariant(\n  dep: string,\n  imports: string[],\n): boolean {\n  const variant = VARIANT_MAP[dep]\n  return variant !== undefined && imports.includes(variant)\n}\n"],"mappings":"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","names":["chalk","fs","fs","fs","chalk"]}

package/dist/actions/deplint/checkPackage/getUnnecessaryPeerDependencies.mjs

@@ -0,0 +1,207 @@
+// src/actions/deplint/checkPackage/getUnnecessaryPeerDependencies.ts
+import fs4 from "fs";
+import chalk3 from "chalk";
+
+// src/actions/deplint/packageJsonEditor.ts
+import fs2 from "fs";
+import chalk from "chalk";
+import sortPackageJson from "sort-package-json";
+
+// src/actions/deplint/getRequiredPeerDependencies.ts
+import fs from "fs";
+import path from "path";
+function findDepPackageJson(location, dep) {
+  let dir = location;
+  while (true) {
+    const candidate = path.join(dir, "node_modules", dep, "package.json");
+    if (fs.existsSync(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+
+// src/actions/deplint/packageJsonEditor.ts
+function readPackageJson(location) {
+  return JSON.parse(fs2.readFileSync(`${location}/package.json`, "utf8"));
+}
+function writePackageJson(location, pkg) {
+  const sorted = sortPackageJson(JSON.stringify(pkg, null, 2));
+  fs2.writeFileSync(`${location}/package.json`, `${sorted}
+`);
+}
+function removeDep(pkg, dep, section) {
+  const sectionObj = pkg[section];
+  if (!sectionObj?.[dep]) return;
+  delete sectionObj[dep];
+  if (Object.keys(sectionObj).length === 0) {
+    delete pkg[section];
+  }
+}
+function logFix(workspace, action, dep, detail) {
+  const detailStr = detail ? ` (${detail})` : "";
+  console.log(`[${chalk.blue(workspace.name)}] Fixed: ${action} ${chalk.green(dep)}${detailStr}`);
+}
+
+// src/actions/deplint/checkPackage/getUnsatisfiedPeerDependencies.ts
+import fs3 from "fs";
+import chalk2 from "chalk";
+import semver from "semver";
+import sortPackageJson2 from "sort-package-json";
+function readDepPackageJson(location, dep) {
+  const depPkgPath = findDepPackageJson(location, dep);
+  if (!depPkgPath) return void 0;
+  try {
+    return JSON.parse(fs3.readFileSync(depPkgPath, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function readPeerDeps(location, dep) {
+  const pkg = readDepPackageJson(location, dep);
+  if (!pkg) return [];
+  const peers = pkg.peerDependencies;
+  return Object.keys(peers ?? {});
+}
+var MAX_TRANSITIVE_DEPTH = 2;
+function collectPeerSources(location, dependencies, devDependencies) {
+  const peerSources = /* @__PURE__ */ new Map();
+  const visited = /* @__PURE__ */ new Set();
+  function addPeerSource(peer, source) {
+    const sources = peerSources.get(peer) ?? [];
+    sources.push(source);
+    peerSources.set(peer, sources);
+  }
+  function collectFromDeps(deps, isRuntime, chain) {
+    for (const dep of deps) {
+      const visitKey = `${dep}:${chain.join(">")}`;
+      if (visited.has(visitKey)) continue;
+      visited.add(visitKey);
+      for (const peer of readPeerDeps(location, dep)) {
+        addPeerSource(peer, {
+          chain: chain.length > 0 ? [...chain, dep] : void 0,
+          isRuntimeDep: isRuntime,
+          requiredBy: dep
+        });
+      }
+      if (chain.length < MAX_TRANSITIVE_DEPTH) {
+        const depPkg = readDepPackageJson(location, dep);
+        if (depPkg) {
+          const transitiveDeps = Object.keys(depPkg.dependencies ?? {});
+          collectFromDeps(transitiveDeps, isRuntime, [...chain, dep]);
+        }
+      }
+    }
+  }
+  collectFromDeps(dependencies, true, []);
+  const devOnly = devDependencies.filter((d) => !dependencies.includes(d));
+  collectFromDeps(devOnly, false, []);
+  return peerSources;
+}
+function getRequiredTransitivePeers(location, { dependencies, devDependencies }) {
+  const peerSources = collectPeerSources(location, dependencies, devDependencies);
+  return new Set(peerSources.keys());
+}
+
+// src/actions/deplint/checkPackage/getUnnecessaryPeerDependencies.ts
+function isPeerImportedInDist(dep, externalDistImports, externalDistTypeImports) {
+  const baseName = dep.replace(/^@types\//, "");
+  return externalDistImports.includes(dep) || externalDistImports.includes(baseName) || externalDistTypeImports.includes(dep) || externalDistTypeImports.includes(baseName);
+}
+function findUnrequestedPeerDeps(location, packageParams, { externalDistImports, externalDistTypeImports }, exclude) {
+  const requiredPeers = getRequiredTransitivePeers(location, packageParams);
+  const unrequested = [];
+  for (const dep of packageParams.peerDependencies) {
+    if (exclude?.has(dep)) continue;
+    if (packageParams.dependencies.includes(dep)) continue;
+    if (!isPeerImportedInDist(dep, externalDistImports, externalDistTypeImports)) continue;
+    if (!requiredPeers.has(dep)) {
+      unrequested.push(dep);
+    }
+  }
+  return unrequested;
+}
+function getUnrequestedPeerDependencies({ name, location }, packageParams, sourceParams, exclude) {
+  if (!isTerminalPackage(location)) return 0;
+  const unrequested = findUnrequestedPeerDeps(location, packageParams, sourceParams, exclude);
+  for (const dep of unrequested) {
+    console.log(
+      `[${chalk3.blue(name)}] Unnecessary peerDependency ${chalk3.red(dep)} \u2014 imported in dist but no dependency requires it as a peer; should be a dependency`
+    );
+  }
+  if (unrequested.length > 0) {
+    console.log(`  ${chalk3.yellow(`${location}/package.json`)}
+`);
+  }
+  return unrequested.length;
+}
+function isTerminalPackage(location) {
+  try {
+    const pkg = JSON.parse(fs4.readFileSync(`${location}/package.json`, "utf8"));
+    return pkg.private === true;
+  } catch {
+    return false;
+  }
+}
+function fixUnrequestedPeerDependencies(workspace, packageParams, sourceParams, exclude) {
+  const unrequested = findUnrequestedPeerDeps(workspace.location, packageParams, sourceParams, exclude);
+  if (unrequested.length === 0) return 0;
+  const isTerminal = isTerminalPackage(workspace.location);
+  const tsconfigExtendsSet = new Set(sourceParams.tsconfigExtends);
+  const fixable = isTerminal ? unrequested : unrequested.filter((dep) => tsconfigExtendsSet.has(dep));
+  if (fixable.length === 0) return 0;
+  const pkg = readPackageJson(workspace.location);
+  for (const dep of fixable) {
+    const version = packageParams.peerDependencyVersions[dep] ?? "*";
+    removeDep(pkg, dep, "peerDependencies");
+    pkg.dependencies = pkg.dependencies ?? {};
+    pkg.dependencies[dep] = version;
+    logFix(workspace, "moved from peerDependencies to dependencies", dep);
+  }
+  writePackageJson(workspace.location, pkg);
+  return fixable.length;
+}
+function findRedundantPeerDeps({ peerDependencies, dependencies }, exclude) {
+  const depsSet = new Set(dependencies);
+  const redundant = [];
+  for (const dep of peerDependencies) {
+    if (exclude?.has(dep)) continue;
+    if (depsSet.has(dep)) {
+      redundant.push(dep);
+    }
+  }
+  return redundant;
+}
+function getRedundantPeerDependencies({ name, location }, packageParams, exclude) {
+  const redundant = findRedundantPeerDeps(packageParams, exclude);
+  for (const dep of redundant) {
+    console.log(
+      `[${chalk3.blue(name)}] Redundant peerDependency ${chalk3.red(dep)} \u2014 already listed in dependencies`
+    );
+  }
+  if (redundant.length > 0) {
+    console.log(`  ${chalk3.yellow(`${location}/package.json`)}
+`);
+  }
+  return redundant.length;
+}
+function fixRedundantPeerDependencies(workspace, packageParams, exclude) {
+  const redundant = findRedundantPeerDeps(packageParams, exclude);
+  if (redundant.length === 0) return 0;
+  const pkg = readPackageJson(workspace.location);
+  for (const dep of redundant) {
+    removeDep(pkg, dep, "peerDependencies");
+    logFix(workspace, "removed redundant peerDependency (kept in dependencies)", dep);
+  }
+  writePackageJson(workspace.location, pkg);
+  return redundant.length;
+}
+export {
+  findRedundantPeerDeps,
+  findUnrequestedPeerDeps,
+  fixRedundantPeerDependencies,
+  fixUnrequestedPeerDependencies,
+  getRedundantPeerDependencies,
+  getUnrequestedPeerDependencies
+};
+//# sourceMappingURL=getUnnecessaryPeerDependencies.mjs.map

package/dist/actions/deplint/checkPackage/getUnnecessaryPeerDependencies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/actions/deplint/checkPackage/getUnnecessaryPeerDependencies.ts","../../../../src/actions/deplint/packageJsonEditor.ts","../../../../src/actions/deplint/getRequiredPeerDependencies.ts","../../../../src/actions/deplint/checkPackage/getUnsatisfiedPeerDependencies.ts"],"sourcesContent":["import fs from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport type { Workspace } from '../../../pm/index.ts'\nimport {\n  logFix, readPackageJson, removeDep, writePackageJson,\n} from '../packageJsonEditor.ts'\nimport type { CheckPackageParams, CheckSourceParams } from './checkPackageTypes.ts'\nimport { getRequiredTransitivePeers } from './getUnsatisfiedPeerDependencies.ts'\n\n// --- Check A: Unrequested peers (imported but no dep requires it as a peer) ---\n\nfunction isPeerImportedInDist(dep: string, externalDistImports: string[], externalDistTypeImports: string[]): boolean {\n  const baseName = dep.replace(/^@types\\//, '')\n  return externalDistImports.includes(dep)\n    || externalDistImports.includes(baseName)\n    || externalDistTypeImports.includes(dep)\n    || externalDistTypeImports.includes(baseName)\n}\n\nexport function findUnrequestedPeerDeps(\n  location: string,\n  packageParams: CheckPackageParams,\n  { externalDistImports, externalDistTypeImports }: CheckSourceParams,\n  exclude?: Set<string>,\n): string[] {\n  const requiredPeers = getRequiredTransitivePeers(location, packageParams)\n\n  const unrequested: string[] = []\n  for (const dep of packageParams.peerDependencies) {\n    if (exclude?.has(dep)) continue\n    if (packageParams.dependencies.includes(dep)) continue\n    if (!isPeerImportedInDist(dep, externalDistImports, externalDistTypeImports)) continue\n    if (!requiredPeers.has(dep)) {\n      unrequested.push(dep)\n    }\n  }\n  return unrequested\n}\n\nexport function getUnrequestedPeerDependencies(\n  { name, location }: Workspace,\n  packageParams: CheckPackageParams,\n  sourceParams: CheckSourceParams,\n  exclude?: Set<string>,\n): number {\n  // For library packages, importing a peerDep in dist is the normal pattern —\n  // the library uses it but wants consumers to provide it.\n  if (!isTerminalPackage(location)) return 0\n\n  const unrequested = findUnrequestedPeerDeps(location, packageParams, sourceParams, exclude)\n\n  for (const dep of unrequested) {\n    console.log(\n      `[${chalk.blue(name)}] Unnecessary peerDependency ${chalk.red(dep)}`\n      + ' — imported in dist but no dependency requires it as a peer; should be a dependency',\n    )\n  }\n  if (unrequested.length > 0) {\n    console.log(`  ${chalk.yellow(`${location}/package.json`)}\\n`)\n  }\n  return unrequested.length\n}\n\nfunction isTerminalPackage(location: string): boolean {\n  try {\n    const pkg = JSON.parse(fs.readFileSync(`${location}/package.json`, 'utf8')) as Record<string, unknown>\n    return pkg.private === true\n  } catch {\n    return false\n  }\n}\n\nexport function fixUnrequestedPeerDependencies(\n  workspace: Workspace,\n  packageParams: CheckPackageParams,\n  sourceParams: CheckSourceParams,\n  exclude?: Set<string>,\n): number {\n  const unrequested = findUnrequestedPeerDeps(workspace.location, packageParams, sourceParams, exclude)\n  if (unrequested.length === 0) return 0\n\n  const isTerminal = isTerminalPackage(workspace.location)\n  const tsconfigExtendsSet = new Set(sourceParams.tsconfigExtends)\n\n  // For library packages (non-private), unrequested peers are intentional —\n  // the library wants consumers to provide them. Only move to dependencies\n  // for terminal/private packages (apps, CLIs) or when the dep is only\n  // referenced via tsconfig extends (a build-time need, not a runtime peer).\n  const fixable = isTerminal\n    ? unrequested\n    : unrequested.filter(dep => tsconfigExtendsSet.has(dep))\n\n  if (fixable.length === 0) return 0\n\n  const pkg = readPackageJson(workspace.location)\n\n  for (const dep of fixable) {\n    const version = packageParams.peerDependencyVersions[dep] ?? '*'\n    removeDep(pkg, dep, 'peerDependencies')\n    pkg.dependencies = pkg.dependencies ?? {}\n    pkg.dependencies[dep] = version\n    logFix(workspace, 'moved from peerDependencies to dependencies', dep)\n  }\n\n  writePackageJson(workspace.location, pkg)\n  return fixable.length\n}\n\n// --- Check B: Redundant peers (also in dependencies) ---\n\nexport function findRedundantPeerDeps(\n  { peerDependencies, dependencies }: CheckPackageParams,\n  exclude?: Set<string>,\n): string[] {\n  const depsSet = new Set(dependencies)\n  const redundant: string[] = []\n  for (const dep of peerDependencies) {\n    if (exclude?.has(dep)) continue\n    if (depsSet.has(dep)) {\n      redundant.push(dep)\n    }\n  }\n  return redundant\n}\n\nexport function getRedundantPeerDependencies(\n  { name, location }: Workspace,\n  packageParams: CheckPackageParams,\n  exclude?: Set<string>,\n): number {\n  const redundant = findRedundantPeerDeps(packageParams, exclude)\n\n  for (const dep of redundant) {\n    console.log(\n      `[${chalk.blue(name)}] Redundant peerDependency ${chalk.red(dep)}`\n      + ' — already listed in dependencies',\n    )\n  }\n  if (redundant.length > 0) {\n    console.log(`  ${chalk.yellow(`${location}/package.json`)}\\n`)\n  }\n  return redundant.length\n}\n\nexport function fixRedundantPeerDependencies(\n  workspace: Workspace,\n  packageParams: CheckPackageParams,\n  exclude?: Set<string>,\n): number {\n  const redundant = findRedundantPeerDeps(packageParams, exclude)\n  if (redundant.length === 0) return 0\n\n  const pkg = readPackageJson(workspace.location)\n\n  for (const dep of redundant) {\n    removeDep(pkg, dep, 'peerDependencies')\n    logFix(workspace, 'removed redundant peerDependency (kept in dependencies)', dep)\n  }\n\n  writePackageJson(workspace.location, pkg)\n  return redundant.length\n}\n","import fs from 'node:fs'\n\nimport chalk from 'chalk'\nimport sortPackageJson from 'sort-package-json'\n\nimport type { Workspace } from '../../pm/index.ts'\nimport { findDepPackageJson } from './getRequiredPeerDependencies.ts'\n\nexport interface PackageJson {\n  [key: string]: unknown\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n  peerDependencies?: Record<string, string>\n}\n\nexport function readPackageJson(location: string): PackageJson {\n  return JSON.parse(fs.readFileSync(`${location}/package.json`, 'utf8')) as PackageJson\n}\n\nexport function writePackageJson(location: string, pkg: PackageJson): void {\n  const sorted = sortPackageJson(JSON.stringify(pkg, null, 2))\n  fs.writeFileSync(`${location}/package.json`, `${sorted}\\n`)\n}\n\n/**\n * Move a dependency from one section to another (e.g. dependencies → devDependencies).\n */\nexport function moveDep(pkg: PackageJson, dep: string, from: string, to: string): void {\n  const fromSection = pkg[from] as Record<string, string> | undefined\n  if (!fromSection?.[dep]) return\n\n  const version = fromSection[dep]\n  delete fromSection[dep]\n  if (Object.keys(fromSection).length === 0) {\n    delete pkg[from]\n  }\n\n  const toSection = (pkg[to] ?? {}) as Record<string, string>\n  toSection[dep] = version\n  pkg[to] = toSection\n}\n\n/**\n * Remove a dependency from a section.\n */\nexport function removeDep(pkg: PackageJson, dep: string, section: string): void {\n  const sectionObj = pkg[section] as Record<string, string> | undefined\n  if (!sectionObj?.[dep]) return\n\n  delete sectionObj[dep]\n  if (Object.keys(sectionObj).length === 0) {\n    delete pkg[section]\n  }\n}\n\n/**\n * Add a dependency to a section with a resolved version.\n */\nexport function addDep(pkg: PackageJson, dep: string, version: string, section: string): void {\n  const sectionObj = (pkg[section] ?? {}) as Record<string, string>\n  sectionObj[dep] = version\n  pkg[section] = sectionObj\n}\n\n/**\n * Resolve the version for a missing dependency.\n * Looks in node_modules first, then falls back to '*'.\n */\nexport function resolveDepVersion(location: string, dep: string): string {\n  const depPkgPath = findDepPackageJson(location, dep)\n  if (depPkgPath) {\n    try {\n      const depPkg = JSON.parse(fs.readFileSync(depPkgPath, 'utf8')) as Record<string, unknown>\n      const version = depPkg.version as string | undefined\n      if (version) return `~${version}`\n    } catch {\n      // Fall through\n    }\n  }\n  return '*'\n}\n\n/**\n * Compute the expected peerDependency version range for a dependency,\n * preserving the current range style (^ vs ~).\n *\n * - If the current range uses ^, returns ^<major> (e.g. ^7)\n * - Otherwise returns ~<major>.<minor> (e.g. ~7.6)\n * - Falls back to resolveDepVersion if no installed version found\n */\nexport function resolveExpectedPeerVersion(location: string, dep: string, currentRange?: string): string {\n  const depPkgPath = findDepPackageJson(location, dep)\n  if (depPkgPath) {\n    try {\n      const depPkg = JSON.parse(fs.readFileSync(depPkgPath, 'utf8')) as Record<string, unknown>\n      const version = depPkg.version as string | undefined\n      if (version) {\n        const match = /^(\\d+)\\.(\\d+)/.exec(version)\n        if (match) {\n          if (currentRange?.startsWith('^')) {\n            return `^${match[1]}`\n          }\n          return `~${match[1]}.${match[2]}`\n        }\n        return `~${version}`\n      }\n    } catch {\n      // Fall through\n    }\n  }\n  return '*'\n}\n\nexport function logFix(workspace: Workspace, action: string, dep: string, detail?: string): void {\n  const detailStr = detail ? ` (${detail})` : ''\n  console.log(`[${chalk.blue(workspace.name)}] Fixed: ${action} ${chalk.green(dep)}${detailStr}`)\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\n\nexport function findDepPackageJson(location: string, dep: string): string | undefined {\n  let dir = location\n  while (true) {\n    const candidate = path.join(dir, 'node_modules', dep, 'package.json')\n    if (fs.existsSync(candidate)) return candidate\n    const parent = path.dirname(dir)\n    if (parent === dir) return undefined\n    dir = parent\n  }\n}\n\n/**\n * Collects the peerDependencies declared by all of a package's\n * dependencies and devDependencies. A devDependency that satisfies\n * one of these peer requirements should not be flagged as unused.\n */\nexport function getRequiredPeerDependencies(\n  location: string,\n  allDeps: string[],\n): Set<string> {\n  const required = new Set<string>()\n  for (const dep of allDeps) {\n    const depPkgPath = findDepPackageJson(location, dep)\n    if (!depPkgPath) continue\n    try {\n      const raw = fs.readFileSync(depPkgPath, 'utf8')\n      const pkg = JSON.parse(raw) as Record<string, unknown>\n      const peerDeps = pkg.peerDependencies as Record<string, string> | undefined\n      if (peerDeps) {\n        for (const peer of Object.keys(peerDeps)) {\n          required.add(peer)\n        }\n      }\n    } catch {\n      // Package not readable — skip\n    }\n  }\n  return required\n}\n","import fs from 'node:fs'\n\nimport chalk from 'chalk'\nimport semver from 'semver'\nimport sortPackageJson from 'sort-package-json'\n\nimport type { Workspace } from '../../../pm/index.ts'\nimport { findDepPackageJson } from '../getRequiredPeerDependencies.ts'\nimport type { CheckPackageParams } from './checkPackageTypes.ts'\n\nexport interface PeerSource {\n  /** Dependency chain for transitive peers, e.g. ['direct-dep', 'transitive-dep'] */\n  chain?: string[]\n  isRuntimeDep: boolean\n  requiredBy: string\n}\n\nexport interface UnsatisfiedPeer {\n  hasRuntimeSource: boolean\n  installedVersion?: string\n  peer: string\n  reason: 'missing' | 'version-mismatch'\n  sources: PeerSource[]\n  versionRange: string\n}\n\nfunction readDepPackageJson(location: string, dep: string): Record<string, unknown> | undefined {\n  const depPkgPath = findDepPackageJson(location, dep)\n  if (!depPkgPath) return undefined\n  try {\n    return JSON.parse(fs.readFileSync(depPkgPath, 'utf8')) as Record<string, unknown>\n  } catch {\n    return undefined\n  }\n}\n\nfunction readPeerDeps(location: string, dep: string): string[] {\n  const pkg = readDepPackageJson(location, dep)\n  if (!pkg) return []\n  const peers = pkg.peerDependencies as Record<string, string> | undefined\n  return Object.keys(peers ?? {})\n}\n\nfunction readPeerVersionRange(location: string, dep: string, peer: string): string | undefined {\n  const pkg = readDepPackageJson(location, dep)\n  if (!pkg) return undefined\n  const peers = pkg.peerDependencies as Record<string, string> | undefined\n  return peers?.[peer]\n}\n\nfunction readInstalledVersion(location: string, dep: string): string | undefined {\n  const pkg = readDepPackageJson(location, dep)\n  if (!pkg) return undefined\n  return pkg.version as string | undefined\n}\n\nfunction isPeerOptionalInAll(location: string, peer: string, sources: PeerSource[]): boolean {\n  for (const source of sources) {\n    const pkg = readDepPackageJson(location, source.requiredBy)\n    if (!pkg) continue\n    const meta = (pkg.peerDependenciesMeta as Record<string, { optional?: boolean }> | undefined)?.[peer]\n    if (!meta?.optional) return false\n  }\n  return true\n}\n\nconst MAX_TRANSITIVE_DEPTH = 2\n\nfunction collectPeerSources(\n  location: string,\n  dependencies: string[],\n  devDependencies: string[],\n): Map<string, PeerSource[]> {\n  const peerSources = new Map<string, PeerSource[]>()\n  const visited = new Set<string>()\n\n  function addPeerSource(peer: string, source: PeerSource): void {\n    const sources = peerSources.get(peer) ?? []\n    sources.push(source)\n    peerSources.set(peer, sources)\n  }\n\n  function collectFromDeps(deps: string[], isRuntime: boolean, chain: string[]): void {\n    for (const dep of deps) {\n      const visitKey = `${dep}:${chain.join('>')}`\n      if (visited.has(visitKey)) continue\n      visited.add(visitKey)\n\n      for (const peer of readPeerDeps(location, dep)) {\n        addPeerSource(peer, {\n          chain: chain.length > 0 ? [...chain, dep] : undefined,\n          isRuntimeDep: isRuntime,\n          requiredBy: dep,\n        })\n      }\n\n      // Recurse into this dep's own runtime dependencies (not devDeps)\n      if (chain.length < MAX_TRANSITIVE_DEPTH) {\n        const depPkg = readDepPackageJson(location, dep)\n        if (depPkg) {\n          const transitiveDeps = Object.keys((depPkg.dependencies as Record<string, string> | undefined) ?? {})\n          collectFromDeps(transitiveDeps, isRuntime, [...chain, dep])\n        }\n      }\n    }\n  }\n\n  collectFromDeps(dependencies, true, [])\n\n  const devOnly = devDependencies.filter(d => !dependencies.includes(d))\n  collectFromDeps(devOnly, false, [])\n\n  return peerSources\n}\n\nfunction formatChain(sources: PeerSource[]): string {\n  const chainsWithDepth = sources.filter(s => s.chain && s.chain.length > 0)\n  if (chainsWithDepth.length === 0) return ''\n  const first = chainsWithDepth[0]\n  return ` (via ${chalk.dim(first.chain!.join(' → '))})`\n}\n\n/**\n * Returns the full set of peer dependency names required by all deps and devDeps.\n * Used to prevent the unused-dependency checks from removing deps that satisfy\n * transitive peer requirements.\n */\nexport function getRequiredTransitivePeers(\n  location: string,\n  { dependencies, devDependencies }: CheckPackageParams,\n): Set<string> {\n  const peerSources = collectPeerSources(location, dependencies, devDependencies)\n  return new Set(peerSources.keys())\n}\n\nfunction logUnsatisfiedPeer(name: string, unsatisfied: UnsatisfiedPeer): void {\n  const {\n    peer, sources, reason, hasRuntimeSource, installedVersion, versionRange,\n  } = unsatisfied\n  const chainInfo = formatChain(sources)\n\n  if (reason === 'version-mismatch') {\n    const requiredByList = sources.map(s => s.requiredBy)\n    console.log(\n      `[${chalk.blue(name)}] Peer dependency version mismatch ${chalk.red(peer)}`\n      + ` — installed ${chalk.yellow(installedVersion ?? 'unknown')}`\n      + ` does not satisfy ${chalk.cyan(versionRange)}`\n      + ` (required by ${chalk.cyan(requiredByList.join(', '))})`\n      + chainInfo,\n    )\n  } else if (hasRuntimeSource) {\n    const requiredByList = sources.filter(s => s.isRuntimeDep).map(s => s.requiredBy)\n    console.log(\n      `[${chalk.blue(name)}] Unsatisfied peer dependency ${chalk.red(peer)}`\n      + ` (required by ${chalk.cyan(requiredByList.join(', '))})`\n      + chainInfo\n      + ' — must be in dependencies or peerDependencies',\n    )\n  } else {\n    const requiredByList = sources.map(s => s.requiredBy)\n    console.log(\n      `[${chalk.blue(name)}] Unsatisfied peer dependency ${chalk.red(peer)}`\n      + ` (required by devDependency ${chalk.cyan(requiredByList.join(', '))})`\n      + chainInfo\n      + ' — must be in dependencies, devDependencies, or peerDependencies',\n    )\n  }\n}\n\nfunction resolveVersionRange(location: string, sources: PeerSource[], peer: string): string {\n  for (const source of sources) {\n    const range = readPeerVersionRange(location, source.requiredBy, peer)\n    if (range) return range\n  }\n  return '*'\n}\n\nfunction checkVersionSatisfaction(location: string, peer: string, requestedRange: string): { installedVersion?: string; satisfied: boolean } {\n  const installedVersion = readInstalledVersion(location, peer)\n  if (!installedVersion) return { satisfied: true }\n  if (requestedRange === '*') return { installedVersion, satisfied: true }\n  // workspace: protocol versions resolve at install time — always satisfied\n  if (requestedRange.startsWith('workspace:')) return { installedVersion, satisfied: true }\n\n  try {\n    const satisfied = semver.satisfies(installedVersion, requestedRange, { includePrerelease: true })\n    return { installedVersion, satisfied }\n  } catch {\n    // Invalid semver range or version — skip version check\n    return { installedVersion, satisfied: true }\n  }\n}\n\nfunction findDeclaredPeerVersionMismatches(\n  name: string,\n  location: string,\n  peerDependencies: string[],\n  peerDependencyVersions: Record<string, string>,\n  exclude?: Set<string>,\n): UnsatisfiedPeer[] {\n  const results: UnsatisfiedPeer[] = []\n  for (const peer of peerDependencies) {\n    if (exclude?.has(peer) || peer === name) continue\n    const declaredRange = peerDependencyVersions[peer]\n    if (!declaredRange || declaredRange === '*') continue\n    const { installedVersion, satisfied } = checkVersionSatisfaction(location, peer, declaredRange)\n    if (!satisfied) {\n      results.push({\n        hasRuntimeSource: true,\n        installedVersion,\n        peer,\n        reason: 'version-mismatch',\n        sources: [{ isRuntimeDep: true, requiredBy: name }],\n        versionRange: declaredRange,\n      })\n    }\n  }\n  return results\n}\n\nexport function findUnsatisfiedPeers(\n  { name, location }: Workspace,\n  {\n    dependencies, devDependencies, peerDependencies, peerDependencyVersions,\n  }: CheckPackageParams,\n  exclude?: Set<string>,\n): UnsatisfiedPeer[] {\n  const peerSources = collectPeerSources(location, dependencies, devDependencies)\n  const depsSet = new Set(dependencies)\n  const devDepsSet = new Set(devDependencies)\n  const unsatisfied: UnsatisfiedPeer[] = []\n\n  for (const [peer, sources] of peerSources) {\n    if (exclude?.has(peer) || peer === name) continue\n    if (isPeerOptionalInAll(location, peer, sources)) continue\n\n    const hasRuntimeSource = sources.some(s => s.isRuntimeDep)\n    // A peer is provided if it's in dependencies or devDependencies.\n    // Being in peerDependencies alone only passes the requirement to consumers\n    // but doesn't actually provide the package (yarn will warn \"doesn't provide\").\n    const isPresent = depsSet.has(peer) || devDepsSet.has(peer)\n\n    if (!isPresent) {\n      const versionRange = resolveVersionRange(location, sources, peer)\n      unsatisfied.push({\n        hasRuntimeSource, peer, reason: 'missing', sources, versionRange,\n      })\n      continue\n    }\n\n    const versionRange = resolveVersionRange(location, sources, peer)\n    const { installedVersion, satisfied } = checkVersionSatisfaction(location, peer, versionRange)\n    if (!satisfied) {\n      unsatisfied.push({\n        hasRuntimeSource, installedVersion, peer, reason: 'version-mismatch', sources, versionRange,\n      })\n    }\n  }\n\n  return [\n    ...unsatisfied,\n    ...findDeclaredPeerVersionMismatches(name, location, peerDependencies, peerDependencyVersions, exclude),\n  ]\n}\n\n/**\n * Checks that peerDependencies of all dependencies and devDependencies are\n * properly satisfied — both present and version-compatible.\n *\n * Rules:\n * - If a dep in `dependencies` requires peer P, then P must be in\n *   `dependencies` or `peerDependencies`.\n * - If a dep in `devDependencies` requires peer P, then P can also be\n *   in `devDependencies`.\n * - If multiple deps require the same peer P and at least one is a runtime\n *   dependency, the runtime rule applies (P must be in deps or peerDeps).\n * - Checks peers transitively up to 2 levels deep in the dependency tree.\n * - Validates that installed versions satisfy the requested peer ranges.\n */\nexport interface CheckPeerResult {\n  count: number\n  unsatisfiedPeers: Set<string>\n}\n\nexport function getUnsatisfiedPeerDependencies(\n  workspace: Workspace,\n  packageParams: CheckPackageParams,\n  exclude?: Set<string>,\n): CheckPeerResult {\n  const unsatisfied = findUnsatisfiedPeers(workspace, packageParams, exclude)\n\n  for (const entry of unsatisfied) {\n    logUnsatisfiedPeer(workspace.name, entry)\n  }\n\n  if (unsatisfied.length > 0) {\n    console.log(`  ${chalk.yellow(`${workspace.location}/package.json`)}\\n`)\n  }\n  return {\n    count: unsatisfied.length,\n    unsatisfiedPeers: new Set(unsatisfied.map(u => u.peer)),\n  }\n}\n\n/**\n * Determines if a package is \"terminal\" (an app, CLI, or website — not a library).\n * Terminal packages have their peers added to dependencies; libraries use peerDependencies.\n */\nfunction isTerminalPackage(packageJsonPath: string): boolean {\n  try {\n    const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as Record<string, unknown>\n    return pkg.private === true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Fixes unsatisfied peer dependencies by adding them to package.json.\n *\n * - Terminal packages (private: true): runtime peers go to dependencies,\n *   dev-only peers go to devDependencies\n * - Library packages: runtime peers go to peerDependencies,\n *   dev-only peers go to devDependencies\n * - Version mismatches are reported but not auto-fixed (requires manual review)\n */\nexport interface FixPeerResult {\n  addedPeers: Set<string>\n  count: number\n}\n\nfunction fixVersionMismatch(\n  workspaceName: string,\n  entry: UnsatisfiedPeer,\n  pkg: Record<string, Record<string, string>>,\n): boolean {\n  const {\n    installedVersion, peer, versionRange,\n  } = entry\n  if (!installedVersion) {\n    logUnsatisfiedPeer(workspaceName, entry)\n    console.log(\n      `  ${chalk.dim('(version mismatch — could not resolve installed version)')}`,\n    )\n    return false\n  }\n\n  const match = /^(\\d+)\\.(\\d+)/.exec(installedVersion)\n  if (!match) {\n    logUnsatisfiedPeer(workspaceName, entry)\n    console.log(\n      `  ${chalk.dim('(version mismatch — could not resolve installed version)')}`,\n    )\n    return false\n  }\n\n  const expectedVersion = versionRange.startsWith('^')\n    ? `^${match[1]}`\n    : `~${match[1]}.${match[2]}`\n\n  if (pkg.peerDependencies?.[peer]) {\n    pkg.peerDependencies[peer] = expectedVersion\n  }\n  if (pkg.devDependencies?.[peer] && !pkg.devDependencies[peer].startsWith('workspace:')) {\n    pkg.devDependencies[peer] = expectedVersion\n  }\n\n  console.log(\n    `[${chalk.blue(workspaceName)}] Fixed: updated ${chalk.green(peer)}`\n    + ` version to ${chalk.cyan(expectedVersion)} (was ${chalk.yellow(versionRange)})`,\n  )\n  return true\n}\n\nexport function fixUnsatisfiedPeerDependencies(\n  workspace: Workspace,\n  packageParams: CheckPackageParams,\n  exclude?: Set<string>,\n): FixPeerResult {\n  const unsatisfied = findUnsatisfiedPeers(workspace, packageParams, exclude)\n  if (unsatisfied.length === 0) return { addedPeers: new Set(), count: 0 }\n\n  const packageJsonPath = `${workspace.location}/package.json`\n  const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as Record<string, Record<string, string>>\n  const isTerminal = isTerminalPackage(packageJsonPath)\n\n  const addedPeers = new Set<string>()\n  let fixedCount = 0\n  for (const entry of unsatisfied) {\n    const {\n      hasRuntimeSource,\n      peer,\n      reason,\n      sources,\n      versionRange,\n    } = entry\n\n    if (reason === 'version-mismatch') {\n      if (fixVersionMismatch(workspace.name, entry, pkg)) fixedCount++\n      continue\n    }\n\n    const sections = resolvePeerTargetSections(hasRuntimeSource, isTerminal)\n    for (const section of sections) {\n      pkg[section] = pkg[section] ?? {}\n      pkg[section][peer] = versionRange\n    }\n    addedPeers.add(peer)\n\n    const requiredByList = sources.map(s => s.requiredBy).join(', ')\n    console.log(\n      `[${chalk.blue(workspace.name)}] Fixed: added ${chalk.green(peer)}@${versionRange}`\n      + ` to ${chalk.cyan(sections.join(' + '))} (required by ${requiredByList})`,\n    )\n    fixedCount++\n  }\n\n  if (fixedCount > 0) {\n    const sorted = sortPackageJson(JSON.stringify(pkg, null, 2))\n    fs.writeFileSync(packageJsonPath, `${sorted}\\n`)\n  }\n\n  return { addedPeers, count: unsatisfied.length }\n}\n\n/**\n * For terminal packages (apps): runtime peers → dependencies, dev-only → devDependencies.\n * For library packages: runtime peers → peerDependencies + devDependencies (peer passes\n * the requirement to consumers, devDep satisfies it for the library's own development).\n * Dev-only peers → devDependencies only.\n */\nexport function resolvePeerTargetSections(hasRuntimeSource: boolean, isTerminal: boolean): string[] {\n  if (!hasRuntimeSource) return ['devDependencies']\n  if (isTerminal) return ['dependencies']\n  return ['peerDependencies', 'devDependencies']\n}\n"],"mappings":";AAAA,OAAOA,SAAQ;AAEf,OAAOC,YAAW;;;ACFlB,OAAOC,SAAQ;AAEf,OAAO,WAAW;AAClB,OAAO,qBAAqB;;;ACH5B,OAAO,QAAQ;AACf,OAAO,UAAU;AAEV,SAAS,mBAAmB,UAAkB,KAAiC;AACpF,MAAI,MAAM;AACV,SAAO,MAAM;AACX,UAAM,YAAY,KAAK,KAAK,KAAK,gBAAgB,KAAK,cAAc;AACpE,QAAI,GAAG,WAAW,SAAS,EAAG,QAAO;AACrC,UAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,QAAI,WAAW,IAAK,QAAO;AAC3B,UAAM;AAAA,EACR;AACF;;;ADGO,SAAS,gBAAgB,UAA+B;AAC7D,SAAO,KAAK,MAAMC,IAAG,aAAa,GAAG,QAAQ,iBAAiB,MAAM,CAAC;AACvE;AAEO,SAAS,iBAAiB,UAAkB,KAAwB;AACzE,QAAM,SAAS,gBAAgB,KAAK,UAAU,KAAK,MAAM,CAAC,CAAC;AAC3D,EAAAA,IAAG,cAAc,GAAG,QAAQ,iBAAiB,GAAG,MAAM;AAAA,CAAI;AAC5D;AAuBO,SAAS,UAAU,KAAkB,KAAa,SAAuB;AAC9E,QAAM,aAAa,IAAI,OAAO;AAC9B,MAAI,CAAC,aAAa,GAAG,EAAG;AAExB,SAAO,WAAW,GAAG;AACrB,MAAI,OAAO,KAAK,UAAU,EAAE,WAAW,GAAG;AACxC,WAAO,IAAI,OAAO;AAAA,EACpB;AACF;AA4DO,SAAS,OAAO,WAAsB,QAAgB,KAAa,QAAuB;AAC/F,QAAM,YAAY,SAAS,KAAK,MAAM,MAAM;AAC5C,UAAQ,IAAI,IAAI,MAAM,KAAK,UAAU,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,EAAE;AAChG;;;AEpHA,OAAOC,SAAQ;AAEf,OAAOC,YAAW;AAClB,OAAO,YAAY;AACnB,OAAOC,sBAAqB;AAsB5B,SAAS,mBAAmB,UAAkB,KAAkD;AAC9F,QAAM,aAAa,mBAAmB,UAAU,GAAG;AACnD,MAAI,CAAC,WAAY,QAAO;AACxB,MAAI;AACF,WAAO,KAAK,MAAMC,IAAG,aAAa,YAAY,MAAM,CAAC;AAAA,EACvD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,aAAa,UAAkB,KAAuB;AAC7D,QAAM,MAAM,mBAAmB,UAAU,GAAG;AAC5C,MAAI,CAAC,IAAK,QAAO,CAAC;AAClB,QAAM,QAAQ,IAAI;AAClB,SAAO,OAAO,KAAK,SAAS,CAAC,CAAC;AAChC;AAyBA,IAAM,uBAAuB;AAE7B,SAAS,mBACP,UACA,cACA,iBAC2B;AAC3B,QAAM,cAAc,oBAAI,IAA0B;AAClD,QAAM,UAAU,oBAAI,IAAY;AAEhC,WAAS,cAAc,MAAc,QAA0B;AAC7D,UAAM,UAAU,YAAY,IAAI,IAAI,KAAK,CAAC;AAC1C,YAAQ,KAAK,MAAM;AACnB,gBAAY,IAAI,MAAM,OAAO;AAAA,EAC/B;AAEA,WAAS,gBAAgB,MAAgB,WAAoB,OAAuB;AAClF,eAAW,OAAO,MAAM;AACtB,YAAM,WAAW,GAAG,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC;AAC1C,UAAI,QAAQ,IAAI,QAAQ,EAAG;AAC3B,cAAQ,IAAI,QAAQ;AAEpB,iBAAW,QAAQ,aAAa,UAAU,GAAG,GAAG;AAC9C,sBAAc,MAAM;AAAA,UAClB,OAAO,MAAM,SAAS,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI;AAAA,UAC5C,cAAc;AAAA,UACd,YAAY;AAAA,QACd,CAAC;AAAA,MACH;AAGA,UAAI,MAAM,SAAS,sBAAsB;AACvC,cAAM,SAAS,mBAAmB,UAAU,GAAG;AAC/C,YAAI,QAAQ;AACV,gBAAM,iBAAiB,OAAO,KAAM,OAAO,gBAAuD,CAAC,CAAC;AACpG,0BAAgB,gBAAgB,WAAW,CAAC,GAAG,OAAO,GAAG,CAAC;AAAA,QAC5D;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,kBAAgB,cAAc,MAAM,CAAC,CAAC;AAEtC,QAAM,UAAU,gBAAgB,OAAO,OAAK,CAAC,aAAa,SAAS,CAAC,CAAC;AACrE,kBAAgB,SAAS,OAAO,CAAC,CAAC;AAElC,SAAO;AACT;AAcO,SAAS,2BACd,UACA,EAAE,cAAc,gBAAgB,GACnB;AACb,QAAM,cAAc,mBAAmB,UAAU,cAAc,eAAe;AAC9E,SAAO,IAAI,IAAI,YAAY,KAAK,CAAC;AACnC;;;AHxHA,SAAS,qBAAqB,KAAa,qBAA+B,yBAA4C;AACpH,QAAM,WAAW,IAAI,QAAQ,aAAa,EAAE;AAC5C,SAAO,oBAAoB,SAAS,GAAG,KAClC,oBAAoB,SAAS,QAAQ,KACrC,wBAAwB,SAAS,GAAG,KACpC,wBAAwB,SAAS,QAAQ;AAChD;AAEO,SAAS,wBACd,UACA,eACA,EAAE,qBAAqB,wBAAwB,GAC/C,SACU;AACV,QAAM,gBAAgB,2BAA2B,UAAU,aAAa;AAExE,QAAM,cAAwB,CAAC;AAC/B,aAAW,OAAO,cAAc,kBAAkB;AAChD,QAAI,SAAS,IAAI,GAAG,EAAG;AACvB,QAAI,cAAc,aAAa,SAAS,GAAG,EAAG;AAC9C,QAAI,CAAC,qBAAqB,KAAK,qBAAqB,uBAAuB,EAAG;AAC9E,QAAI,CAAC,cAAc,IAAI,GAAG,GAAG;AAC3B,kBAAY,KAAK,GAAG;AAAA,IACtB;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,+BACd,EAAE,MAAM,SAAS,GACjB,eACA,cACA,SACQ;AAGR,MAAI,CAAC,kBAAkB,QAAQ,EAAG,QAAO;AAEzC,QAAM,cAAc,wBAAwB,UAAU,eAAe,cAAc,OAAO;AAE1F,aAAW,OAAO,aAAa;AAC7B,YAAQ;AAAA,MACN,IAAIC,OAAM,KAAK,IAAI,CAAC,gCAAgCA,OAAM,IAAI,GAAG,CAAC;AAAA,IAEpE;AAAA,EACF;AACA,MAAI,YAAY,SAAS,GAAG;AAC1B,YAAQ,IAAI,KAAKA,OAAM,OAAO,GAAG,QAAQ,eAAe,CAAC;AAAA,CAAI;AAAA,EAC/D;AACA,SAAO,YAAY;AACrB;AAEA,SAAS,kBAAkB,UAA2B;AACpD,MAAI;AACF,UAAM,MAAM,KAAK,MAAMC,IAAG,aAAa,GAAG,QAAQ,iBAAiB,MAAM,CAAC;AAC1E,WAAO,IAAI,YAAY;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,+BACd,WACA,eACA,cACA,SACQ;AACR,QAAM,cAAc,wBAAwB,UAAU,UAAU,eAAe,cAAc,OAAO;AACpG,MAAI,YAAY,WAAW,EAAG,QAAO;AAErC,QAAM,aAAa,kBAAkB,UAAU,QAAQ;AACvD,QAAM,qBAAqB,IAAI,IAAI,aAAa,eAAe;AAM/D,QAAM,UAAU,aACZ,cACA,YAAY,OAAO,SAAO,mBAAmB,IAAI,GAAG,CAAC;AAEzD,MAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,QAAM,MAAM,gBAAgB,UAAU,QAAQ;AAE9C,aAAW,OAAO,SAAS;AACzB,UAAM,UAAU,cAAc,uBAAuB,GAAG,KAAK;AAC7D,cAAU,KAAK,KAAK,kBAAkB;AACtC,QAAI,eAAe,IAAI,gBAAgB,CAAC;AACxC,QAAI,aAAa,GAAG,IAAI;AACxB,WAAO,WAAW,+CAA+C,GAAG;AAAA,EACtE;AAEA,mBAAiB,UAAU,UAAU,GAAG;AACxC,SAAO,QAAQ;AACjB;AAIO,SAAS,sBACd,EAAE,kBAAkB,aAAa,GACjC,SACU;AACV,QAAM,UAAU,IAAI,IAAI,YAAY;AACpC,QAAM,YAAsB,CAAC;AAC7B,aAAW,OAAO,kBAAkB;AAClC,QAAI,SAAS,IAAI,GAAG,EAAG;AACvB,QAAI,QAAQ,IAAI,GAAG,GAAG;AACpB,gBAAU,KAAK,GAAG;AAAA,IACpB;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,6BACd,EAAE,MAAM,SAAS,GACjB,eACA,SACQ;AACR,QAAM,YAAY,sBAAsB,eAAe,OAAO;AAE9D,aAAW,OAAO,WAAW;AAC3B,YAAQ;AAAA,MACN,IAAID,OAAM,KAAK,IAAI,CAAC,8BAA8BA,OAAM,IAAI,GAAG,CAAC;AAAA,IAElE;AAAA,EACF;AACA,MAAI,UAAU,SAAS,GAAG;AACxB,YAAQ,IAAI,KAAKA,OAAM,OAAO,GAAG,QAAQ,eAAe,CAAC;AAAA,CAAI;AAAA,EAC/D;AACA,SAAO,UAAU;AACnB;AAEO,SAAS,6BACd,WACA,eACA,SACQ;AACR,QAAM,YAAY,sBAAsB,eAAe,OAAO;AAC9D,MAAI,UAAU,WAAW,EAAG,QAAO;AAEnC,QAAM,MAAM,gBAAgB,UAAU,QAAQ;AAE9C,aAAW,OAAO,WAAW;AAC3B,cAAU,KAAK,KAAK,kBAAkB;AACtC,WAAO,WAAW,2DAA2D,GAAG;AAAA,EAClF;AAEA,mBAAiB,UAAU,UAAU,GAAG;AACxC,SAAO,UAAU;AACnB;","names":["fs","chalk","fs","fs","fs","chalk","sortPackageJson","fs","chalk","fs"]}