@xylabs/toolchain 7.10.0

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

@@ -0,0 +1,128 @@
+// src/actions/deplint/checkPackage/getWorkspaceVersionProblems.ts
+import chalk2 from "chalk";
+import semver from "semver";
+
+// 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/checkPackage/getWorkspaceVersionProblems.ts
+function checkSection(deps, versions, section, workspaceNames, problems) {
+  for (const dep of deps) {
+    if (!workspaceNames.has(dep)) continue;
+    const version = versions[dep];
+    if (version && !version.startsWith("workspace:")) {
+      problems.push({
+        dep,
+        section,
+        version
+      });
+    }
+  }
+}
+function findWorkspaceVersionProblems(packageParams, workspaceNames) {
+  const problems = [];
+  checkSection(packageParams.dependencies, packageParams.dependencyVersions, "dependencies", workspaceNames, problems);
+  checkSection(packageParams.devDependencies, packageParams.devDependencyVersions, "devDependencies", workspaceNames, problems);
+  return problems;
+}
+function findWorkspacePeerVersionProblems(packageParams, workspaceNames, location) {
+  const problems = [];
+  for (const dep of packageParams.peerDependencies) {
+    if (!workspaceNames.has(dep)) continue;
+    const declaredRange = packageParams.peerDependencyVersions[dep];
+    if (!declaredRange || declaredRange.startsWith("workspace:")) continue;
+    const resolved = resolveDepVersion(location, dep);
+    const actualVersion = resolved.startsWith("~") ? resolved.slice(1) : resolved;
+    if (actualVersion === "*") continue;
+    if (!semver.satisfies(actualVersion, declaredRange)) {
+      problems.push({
+        actualVersion,
+        declaredRange,
+        dep
+      });
+    }
+  }
+  return problems;
+}
+function getWorkspaceVersionProblems({ name, location }, packageParams, workspaceNames) {
+  const problems = findWorkspaceVersionProblems(packageParams, workspaceNames);
+  for (const {
+    dep,
+    section,
+    version
+  } of problems) {
+    console.log(
+      `[${chalk2.blue(name)}] Workspace dependency ${chalk2.red(dep)} in ${chalk2.cyan(section)} should use workspace: protocol \u2014 found ${chalk2.yellow(version)}`
+    );
+  }
+  if (problems.length > 0) {
+    console.log(`  ${chalk2.yellow(`${location}/package.json`)}
+`);
+  }
+  return problems.length;
+}
+function fixWorkspaceVersionProblems(workspace, packageParams, workspaceNames) {
+  const problems = findWorkspaceVersionProblems(packageParams, workspaceNames);
+  if (problems.length === 0) return 0;
+  const pkg = readPackageJson(workspace.location);
+  for (const { dep, section } of problems) {
+    addDep(pkg, dep, "workspace:~", section);
+    logFix(workspace, `set workspace:~ for ${section}`, dep);
+  }
+  writePackageJson(workspace.location, pkg);
+  return problems.length;
+}
+export {
+  findWorkspacePeerVersionProblems,
+  findWorkspaceVersionProblems,
+  fixWorkspaceVersionProblems,
+  getWorkspaceVersionProblems
+};
+//# sourceMappingURL=getWorkspaceVersionProblems.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/actions/deplint/checkPackage/getWorkspaceVersionProblems.ts","../../../../src/actions/deplint/packageJsonEditor.ts","../../../../src/actions/deplint/getRequiredPeerDependencies.ts"],"sourcesContent":["import chalk from 'chalk'\nimport semver from 'semver'\n\nimport type { Workspace } from '../../../pm/index.ts'\nimport {\n  addDep, logFix, readPackageJson, resolveDepVersion, writePackageJson,\n} from '../packageJsonEditor.ts'\nimport type { CheckPackageParams } from './checkPackageTypes.ts'\n\ntype DepSection = 'dependencies' | 'devDependencies' | 'peerDependencies'\n\nexport interface VersionProblem {\n  dep: string\n  section: DepSection\n  version: string\n}\n\nexport interface PeerVersionIncompatibility {\n  actualVersion: string\n  declaredRange: string\n  dep: string\n}\n\nfunction checkSection(\n  deps: string[],\n  versions: Record<string, string>,\n  section: DepSection,\n  workspaceNames: Set<string>,\n  problems: VersionProblem[],\n): void {\n  for (const dep of deps) {\n    if (!workspaceNames.has(dep)) continue\n    const version = versions[dep]\n    if (version && !version.startsWith('workspace:')) {\n      problems.push({\n        dep, section, version,\n      })\n    }\n  }\n}\n\nexport function findWorkspaceVersionProblems(\n  packageParams: CheckPackageParams,\n  workspaceNames: Set<string>,\n): VersionProblem[] {\n  const problems: VersionProblem[] = []\n\n  checkSection(packageParams.dependencies, packageParams.dependencyVersions, 'dependencies', workspaceNames, problems)\n  checkSection(packageParams.devDependencies, packageParams.devDependencyVersions, 'devDependencies', workspaceNames, problems)\n\n  return problems\n}\n\nexport function findWorkspacePeerVersionProblems(\n  packageParams: CheckPackageParams,\n  workspaceNames: Set<string>,\n  location: string,\n): PeerVersionIncompatibility[] {\n  const problems: PeerVersionIncompatibility[] = []\n\n  for (const dep of packageParams.peerDependencies) {\n    if (!workspaceNames.has(dep)) continue\n    const declaredRange = packageParams.peerDependencyVersions[dep]\n    if (!declaredRange || declaredRange.startsWith('workspace:')) continue\n\n    const resolved = resolveDepVersion(location, dep)\n    // resolveDepVersion returns ~X.Y.Z or *, extract the raw version\n    const actualVersion = resolved.startsWith('~') ? resolved.slice(1) : resolved\n    if (actualVersion === '*') continue\n\n    if (!semver.satisfies(actualVersion, declaredRange)) {\n      problems.push({\n        actualVersion, declaredRange, dep,\n      })\n    }\n  }\n\n  return problems\n}\n\nexport function getWorkspaceVersionProblems(\n  { name, location }: Workspace,\n  packageParams: CheckPackageParams,\n  workspaceNames: Set<string>,\n): number {\n  const problems = findWorkspaceVersionProblems(packageParams, workspaceNames)\n\n  for (const {\n    dep, section, version,\n  } of problems) {\n    console.log(\n      `[${chalk.blue(name)}] Workspace dependency ${chalk.red(dep)} in ${chalk.cyan(section)}`\n      + ` should use workspace: protocol — found ${chalk.yellow(version)}`,\n    )\n  }\n  if (problems.length > 0) {\n    console.log(`  ${chalk.yellow(`${location}/package.json`)}\\n`)\n  }\n  return problems.length\n}\n\nexport function fixWorkspaceVersionProblems(\n  workspace: Workspace,\n  packageParams: CheckPackageParams,\n  workspaceNames: Set<string>,\n): number {\n  const problems = findWorkspaceVersionProblems(packageParams, workspaceNames)\n  if (problems.length === 0) return 0\n\n  const pkg = readPackageJson(workspace.location)\n\n  for (const { dep, section } of problems) {\n    addDep(pkg, dep, 'workspace:~', section)\n    logFix(workspace, `set workspace:~ for ${section}`, dep)\n  }\n\n  writePackageJson(workspace.location, pkg)\n  return problems.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"],"mappings":"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","names":["chalk","fs","fs","fs","chalk"]}