@outfitter/tooling 0.3.0 → 0.3.4

package/dist/shared/@outfitter/{tooling-9errkcvk.js → tooling-1hez6j9d.js}

@@ -15,7 +15,7 @@ async function runFix(paths = []) {
     stdio: ["inherit", "inherit", "inherit"]
   });
   const exitCode = await proc.exited;
-  process.exit(exitCode);
+  process.exitCode = exitCode;
 }
 
 export { buildFixCommand, runFix };

package/dist/shared/@outfitter/{tooling-cj5vsa9k.js → tooling-6cxfdx0q.js}

@@ -11,7 +11,7 @@ function getChangedPackagePaths(files) {
       packageNames.add(match[1]);
     }
   }
-  return [...packageNames].sort();
+  return [...packageNames].toSorted();
 }
 function getChangedChangesetFiles(files) {
   const pattern = /^\.changeset\/([^/]+\.md)$/;
@@ -22,7 +22,7 @@ function getChangedChangesetFiles(files) {
       results.push(match[1]);
     }
   }
-  return results.sort();
+  return results.toSorted();
 }
 function checkChangesetRequired(changedPackages, changesetFiles) {
   if (changedPackages.length === 0) {
@@ -57,7 +57,7 @@ function parseChangesetFrontmatterPackageNames(markdownContent) {
       packages.add(match[2]);
     }
   }
-  return [...packages].sort();
+  return [...packages].toSorted();
 }
 function findIgnoredPackageReferences(input) {
   if (input.ignoredPackages.length === 0 || input.changesetFiles.length === 0) {
@@ -70,10 +70,10 @@ function findIgnoredPackageReferences(input) {
     const referencedPackages = parseChangesetFrontmatterPackageNames(content);
     const invalidReferences = referencedPackages.filter((pkg) => ignored.has(pkg));
     if (invalidReferences.length > 0) {
-      results.push({ file, packages: invalidReferences.sort() });
+      results.push({ file, packages: invalidReferences.toSorted() });
     }
   }
-  return results.sort((a, b) => a.file.localeCompare(b.file));
+  return results.toSorted((a, b) => a.file.localeCompare(b.file));
 }
 function loadIgnoredPackages(cwd) {
   const configPath = join(cwd, ".changeset", "config.json");
@@ -112,38 +112,41 @@ async function runCheckChangeset(options = {}) {
   if (options.skip || process.env["NO_CHANGESET"] === "1") {
     process.stdout.write(`${COLORS.dim}check-changeset skipped (NO_CHANGESET=1)${COLORS.reset}
 `);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   }
   if (process.env["GITHUB_EVENT_NAME"] === "push") {
     process.stdout.write(`${COLORS.dim}check-changeset skipped (push event)${COLORS.reset}
 `);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   }
   const cwd = process.cwd();
   let changedFiles;
   try {
     const proc = Bun.spawnSync(["git", "diff", "--name-only", "origin/main...HEAD"], { cwd });
     if (proc.exitCode !== 0) {
-      process.exit(0);
+      process.exitCode = 0;
+      return;
     }
     changedFiles = proc.stdout.toString().trim().split(`
 `).filter((line) => line.length > 0);
   } catch {
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   }
   const changedPackages = getChangedPackagePaths(changedFiles);
   if (changedPackages.length === 0) {
     process.stdout.write(`${COLORS.green}No package source changes detected.${COLORS.reset}
 `);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   }
   const changesetFiles = getChangedChangesetFiles(changedFiles);
   const check = checkChangesetRequired(changedPackages, changesetFiles);
   if (!check.ok) {
-    process.stderr.write(`${COLORS.red}Missing changeset!${COLORS.reset}
-
-`);
-    process.stderr.write(`The following packages have source changes but no changeset:
+    process.stderr.write(`${COLORS.yellow}No changeset found.${COLORS.reset} ` + "Consider adding one with `bun run changeset` for a custom changelog entry.\n\n");
+    process.stderr.write(`Packages with source changes:
 
 `);
     for (const pkg of check.missingFor) {
@@ -151,9 +154,8 @@ async function runCheckChangeset(options = {}) {
 `);
     }
     process.stderr.write(`
-Run ${COLORS.blue}bun run changeset${COLORS.reset} to add a changeset, ` + `or add the ${COLORS.blue}no-changeset${COLORS.reset} label to skip.
+Run ${COLORS.blue}bun run changeset${COLORS.reset} for a custom changelog entry, ` + `or add ${COLORS.blue}release:none${COLORS.reset} to skip.
 `);
-    process.exit(1);
   }
   const ignoredReferences = getIgnoredReferencesForChangedChangesets(cwd, changesetFiles);
   if (ignoredReferences.length > 0) {
@@ -174,11 +176,12 @@ Run ${COLORS.blue}bun run changeset${COLORS.reset} to add a changeset, ` + `or a
     process.stderr.write(`
 Update the affected changeset files to remove ignored packages before merging.
 `);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   process.stdout.write(`${COLORS.green}Changeset found for ${changedPackages.length} changed package(s).${COLORS.reset}
 `);
-  process.exit(0);
+  process.exitCode = 0;
 }
 
 export { getChangedPackagePaths, getChangedChangesetFiles, checkChangesetRequired, parseIgnoredPackagesFromChangesetConfig, parseChangesetFrontmatterPackageNames, findIgnoredPackageReferences, runCheckChangeset };

package/dist/shared/@outfitter/{tooling-qk5xgmxr.js → tooling-875svjnz.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   __require
-} from "./tooling-dvwh9qve.js";
+} from "./tooling-jnrs9rqd.js";
 
 // packages/tooling/src/cli/check-tsdoc.ts
 import { resolve } from "path";
@@ -225,7 +225,7 @@ function discoverPackages(cwd) {
       seenEntryPoints.add(entryPoint);
     } catch {}
   }
-  return packages.sort((a, b) => a.name.localeCompare(b.name));
+  return packages.toSorted((a, b) => a.name.localeCompare(b.name));
 }
 function collectReExportedSourceFiles(sourceFile, program, pkgPath) {
   const result = [];
@@ -388,7 +388,8 @@ async function runCheckTsdoc(options = {}) {
 ` + `Searched: packages/*/src/index.ts, apps/*/src/index.ts, src/index.ts
 ` + `Use --package <path> to specify a package path explicitly.
 `);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   if (resolveJsonMode(options)) {
     process.stdout.write(`${JSON.stringify(result, null, 2)}
@@ -399,7 +400,7 @@ async function runCheckTsdoc(options = {}) {
       minCoverage: options.minCoverage
     });
   }
-  process.exit(result.ok ? 0 : 1);
+  process.exitCode = result.ok ? 0 : 1;
 }
 
 export { coverageLevelSchema, declarationCoverageSchema, coverageSummarySchema, packageCoverageSchema, tsDocCheckResultSchema, isExportedDeclaration, getDeclarationName, getDeclarationKind, classifyDeclaration, analyzeSourceFile, calculateCoverage, resolveJsonMode, analyzeCheckTsdoc, printCheckTsdocHuman, runCheckTsdoc };

package/dist/shared/@outfitter/{tooling-mxwc1n8w.js → tooling-9ram55dd.js}

@@ -33,7 +33,7 @@ function buildUltraciteCommand(options) {
     "ultracite",
     "init",
     "--linter",
-    "biome",
+    "oxlint",
     "--pm",
     "bun",
     "--quiet"
@@ -49,7 +49,8 @@ async function runInit(cwd = process.cwd()) {
   if (!await pkgFile.exists()) {
     process.stderr.write(`No package.json found in current directory
 `);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   const pkg = await pkgFile.json();
   const frameworkFlags = detectFrameworks(pkg);
@@ -62,7 +63,7 @@ async function runInit(cwd = process.cwd()) {
     stdio: ["inherit", "inherit", "inherit"]
   });
   const exitCode = await proc.exited;
-  process.exit(exitCode);
+  process.exitCode = exitCode;
 }
 
 export { detectFrameworks, buildUltraciteCommand, runInit };

package/dist/shared/@outfitter/{tooling-0x5q15ec.js → tooling-a4bfx4be.js}

@@ -15,7 +15,7 @@ async function runCheck(paths = []) {
     stdio: ["inherit", "inherit", "inherit"]
   });
   const exitCode = await proc.exited;
-  process.exit(exitCode);
+  process.exitCode = exitCode;
 }
 
 export { buildCheckCommand, runCheck };

package/dist/shared/@outfitter/{tooling-r9976n43.js → tooling-amrbp7cm.js}

@@ -26,7 +26,7 @@ function findBoundaryViolations(entries) {
       }
     }
   }
-  return violations.sort((a, b) => {
+  return violations.toSorted((a, b) => {
     const fileCompare = a.file.localeCompare(b.file);
     if (fileCompare !== 0) {
       return fileCompare;
@@ -78,13 +78,15 @@ async function runCheckBoundaryInvocations() {
     const message = error instanceof Error ? error.message : "unknown read failure";
     process.stderr.write(`Boundary invocation check failed before evaluation: ${message}
 `);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   const violations = findBoundaryViolations(entries);
   if (violations.length === 0) {
     process.stdout.write(`No boundary invocation violations detected in root/apps scripts.
 `);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   }
   process.stderr.write(`Boundary invocation violations detected:
 
@@ -94,7 +96,7 @@ async function runCheckBoundaryInvocations() {
 `);
   }
   process.stderr.write("\nUse canonical command surfaces (e.g. `outfitter repo ...` or package bins) instead of executing packages/*/src directly.\n");
-  process.exit(1);
+  process.exitCode = 1;
 }
 
 export { detectBoundaryViolation, findBoundaryViolations, readScriptEntries, runCheckBoundaryInvocations };

package/dist/shared/@outfitter/{tooling-2n2dpsaa.js → tooling-d363b88r.js}

@@ -2,7 +2,7 @@
 import {
   analyzeSourceFile,
   calculateCoverage
-} from "./tooling-qk5xgmxr.js";
+} from "./tooling-875svjnz.js";
 
 // packages/tooling/src/cli/pre-push.ts
 import { existsSync, readFileSync } from "fs";
@@ -255,31 +255,55 @@ function runScript(scriptName) {
   });
   return result.exitCode === 0;
 }
+function checkBunVersion(projectRoot = process.cwd()) {
+  const versionFile = join(projectRoot, ".bun-version");
+  if (!existsSync(versionFile)) {
+    return { matches: true };
+  }
+  const expected = readFileSync(versionFile, "utf-8").trim();
+  const actual = Bun.version;
+  if (expected === actual) {
+    return { matches: true };
+  }
+  return { matches: false, expected, actual };
+}
 async function runPrePush(options = {}) {
   log(`${COLORS.blue}Pre-push verify${COLORS.reset} (TDD-aware)`);
   log("");
+  if (options.force) {
+    log(`${COLORS.yellow}Force flag set${COLORS.reset} - skipping strict verification`);
+    process.exitCode = 0;
+    return;
+  }
+  const versionCheck = checkBunVersion();
+  if (!versionCheck.matches) {
+    log(`${COLORS.red}Bun version mismatch${COLORS.reset}: running ${versionCheck.actual}, pinned ${versionCheck.expected}`);
+    log("Fix: bunx @outfitter/tooling upgrade-bun");
+    log("");
+    process.exitCode = 1;
+    return;
+  }
   const branch = getCurrentBranch();
   if (isReleaseBranch(branch)) {
     log(`${COLORS.yellow}Release branch detected${COLORS.reset}: ${COLORS.blue}${branch}${COLORS.reset}`);
     log(`${COLORS.yellow}Skipping strict verification${COLORS.reset} for automated changeset release push`);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   }
   if (isRedPhaseBranch(branch)) {
     if (maybeSkipForRedPhase("branch", branch)) {
-      process.exit(0);
+      process.exitCode = 0;
+      return;
     }
   }
   if (isScaffoldBranch(branch)) {
     if (hasRedPhaseBranchInContext(branch)) {
       if (maybeSkipForRedPhase("context", branch)) {
-        process.exit(0);
+        process.exitCode = 0;
+        return;
       }
     }
   }
-  if (options.force) {
-    log(`${COLORS.yellow}Force flag set${COLORS.reset} - skipping strict verification`);
-    process.exit(0);
-  }
   const plan = createVerificationPlan(readPackageScripts());
   if (!plan.ok) {
     log(`${COLORS.red}Strict pre-push verification is not configured${COLORS.reset}`);
@@ -288,7 +312,8 @@ async function runPrePush(options = {}) {
     log("Add one of:");
     log("  - verify:ci");
     log("  - typecheck + (check or lint) + build + test");
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   log(`Running strict verification for branch: ${COLORS.blue}${branch}${COLORS.reset}`);
   if (plan.source === "verify:ci") {
@@ -307,7 +332,8 @@ async function runPrePush(options = {}) {
     log("  - feature-tests");
     log("  - feature/tests");
     log("  - feature_tests");
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   const changedFiles = getChangedFilesForPush();
   if (hasPackageSourceChanges(changedFiles)) {
@@ -317,7 +343,7 @@ async function runPrePush(options = {}) {
   }
   log("");
   log(`${COLORS.green}Strict verification passed${COLORS.reset}`);
-  process.exit(0);
+  process.exitCode = 0;
 }
 
-export { isRedPhaseBranch, isScaffoldBranch, isReleaseBranch, isTestOnlyPath, areFilesTestOnly, canBypassRedPhaseByChangedFiles, hasPackageSourceChanges, createVerificationPlan, runPrePush };
+export { isRedPhaseBranch, isScaffoldBranch, isReleaseBranch, isTestOnlyPath, areFilesTestOnly, canBypassRedPhaseByChangedFiles, hasPackageSourceChanges, createVerificationPlan, checkBunVersion, runPrePush };

package/dist/shared/@outfitter/{tooling-1y8w5ahg.js → tooling-gcdvsqqp.js}

@@ -23,14 +23,16 @@ async function runCheckCleanTree(options = {}) {
   if (diffResult.exitCode !== 0) {
     process.stderr.write(`Failed to run git diff
 `);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   const modified = parseGitDiff(diffResult.stdout.toString());
   const lsResult = Bun.spawnSync(["git", "ls-files", "--others", "--exclude-standard", "--", ...pathArgs], { stderr: "pipe" });
   if (lsResult.exitCode !== 0) {
     process.stderr.write(`Failed to run git ls-files
 `);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   const untracked = parseUntrackedFiles(lsResult.stdout.toString());
   const clean = modified.length === 0 && untracked.length === 0;
@@ -38,7 +40,8 @@ async function runCheckCleanTree(options = {}) {
   if (status.clean) {
     process.stdout.write(`${COLORS.green}Working tree is clean.${COLORS.reset}
 `);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   }
   process.stderr.write(`${COLORS.red}Working tree is dirty after verification:${COLORS.reset}
 
@@ -64,7 +67,7 @@ This likely means a build step produced uncommitted changes.
 `);
   process.stderr.write(`Commit these changes or add them to .gitignore.
 `);
-  process.exit(1);
+  process.exitCode = 1;
 }
 
 export { parseGitDiff, parseUntrackedFiles, isCleanTree, runCheckCleanTree };

package/dist/shared/@outfitter/{tooling-enjcenja.js → tooling-h04te11c.js}

@@ -85,7 +85,7 @@ function discoverEntries(packageRoot) {
     }
     entries.push(match);
   }
-  return entries.sort();
+  return entries.toSorted();
 }
 function addConfigFileExports(expected, pkg) {
   const CONFIG_RE = /\.(json|jsonc|yml|yaml|toml)$/;
@@ -154,13 +154,15 @@ async function runCheckExports(options = {}) {
     if (!Array.isArray(rawConfig)) {
       process.stderr.write(`bunup.config.ts must export a workspace array
 `);
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     workspaces = rawConfig;
   } catch {
     process.stderr.write(`Could not load bunup.config.ts from ${cwd}
 `);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
   const results = [];
   for (const workspace of workspaces) {
@@ -223,7 +225,7 @@ async function runCheckExports(options = {}) {
 `);
     }
   }
-  process.exit(checkResult.ok ? 0 : 1);
+  process.exitCode = checkResult.ok ? 0 : 1;
 }
 
 export { entryToSubpath, compareExports, resolveJsonMode, runCheckExports };

package/dist/shared/@outfitter/tooling-ja1zg5yc.js

@@ -0,0 +1,214 @@
+// @bun
+// packages/tooling/src/cli/check-markdown-links.ts
+import { existsSync } from "fs";
+import { dirname, resolve } from "path";
+var MD_LINK_RE = /\[([^\]]*)\]\(([^)]+)\)/g;
+var SKIP_PROTOCOLS = /^(https?:\/\/|mailto:|data:|tel:)/;
+var FENCE_RE = /^(\s*)((`{3,})|~{3,})(.*)$/;
+function stripInlineCodeSpans(line) {
+  let result = "";
+  let index = 0;
+  while (index < line.length) {
+    if (line[index] !== "`") {
+      result += line[index];
+      index += 1;
+      continue;
+    }
+    let tickCount = 1;
+    while (line[index + tickCount] === "`") {
+      tickCount += 1;
+    }
+    const opener = line.slice(index, index + tickCount);
+    index += tickCount;
+    let closingIndex = -1;
+    let cursor = index;
+    while (cursor < line.length) {
+      if (line[cursor] !== "`") {
+        cursor += 1;
+        continue;
+      }
+      let runLength = 1;
+      while (line[cursor + runLength] === "`") {
+        runLength += 1;
+      }
+      if (runLength === tickCount) {
+        closingIndex = cursor;
+        break;
+      }
+      cursor += runLength;
+    }
+    if (closingIndex === -1) {
+      result += opener;
+      continue;
+    }
+    index = closingIndex + tickCount;
+  }
+  return result;
+}
+function extractMarkdownLinks(content) {
+  const lines = content.split(`
+`);
+  const links = [];
+  let inCodeFence = false;
+  let fenceChar = "";
+  let fenceCount = 0;
+  for (let i = 0;i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+    const fenceMatch = FENCE_RE.exec(trimmed);
+    if (fenceMatch) {
+      const marker = fenceMatch[2] ?? "";
+      const char = marker[0] ?? "`";
+      const count = marker.length;
+      if (!inCodeFence) {
+        inCodeFence = true;
+        fenceChar = char;
+        fenceCount = count;
+        continue;
+      }
+      if (char === fenceChar && count >= fenceCount && !(fenceMatch[4] ?? "").trim()) {
+        inCodeFence = false;
+        continue;
+      }
+    }
+    if (inCodeFence)
+      continue;
+    const stripped = stripInlineCodeSpans(line);
+    for (const match of stripped.matchAll(MD_LINK_RE)) {
+      let target = match[2];
+      if (SKIP_PROTOCOLS.test(target))
+        continue;
+      if (target.startsWith("#"))
+        continue;
+      const hashIndex = target.indexOf("#");
+      if (hashIndex !== -1) {
+        target = target.substring(0, hashIndex);
+      }
+      if (target === "")
+        continue;
+      links.push({ target, line: i + 1 });
+    }
+  }
+  return links;
+}
+async function validateLinks(rootDir, files) {
+  const broken = [];
+  for (const file of files) {
+    const absolutePath = resolve(rootDir, file);
+    const content = await Bun.file(absolutePath).text();
+    const links = extractMarkdownLinks(content);
+    const fileDir = dirname(absolutePath);
+    for (const link of links) {
+      if (link.target.startsWith("docs/packages/") || link.target.startsWith("./docs/packages/") || link.target.startsWith("../docs/packages/")) {
+        continue;
+      }
+      const resolvedTarget = resolve(fileDir, link.target);
+      const relativeFromRoot = resolvedTarget.substring(rootDir.length + 1);
+      if (relativeFromRoot.startsWith("docs/packages/")) {
+        continue;
+      }
+      if (!existsSync(resolvedTarget)) {
+        broken.push({
+          source: file,
+          target: link.target,
+          line: link.line
+        });
+      }
+    }
+  }
+  return broken;
+}
+var DEFAULT_PATTERNS = [
+  "docs/**/*.md",
+  "packages/*/README.md",
+  "AGENTS.md",
+  "CLAUDE.md",
+  "README.md",
+  ".claude/CLAUDE.md"
+];
+async function discoverFiles(rootDir, patterns) {
+  const files = new Set;
+  for (const pattern of patterns) {
+    const glob = new Bun.Glob(pattern);
+    for await (const match of glob.scan({ cwd: rootDir, absolute: false })) {
+      files.add(match);
+    }
+  }
+  return [...files].toSorted();
+}
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  dim: "\x1B[2m",
+  cyan: "\x1B[36m"
+};
+async function runCheckMarkdownLinks(rootDir, patterns) {
+  const effectivePatterns = patterns ?? DEFAULT_PATTERNS;
+  const files = await discoverFiles(rootDir, effectivePatterns);
+  if (files.length === 0) {
+    process.stdout.write(`No markdown files found.
+`);
+    return 0;
+  }
+  const broken = await validateLinks(rootDir, files);
+  if (broken.length === 0) {
+    process.stdout.write(`${COLORS.green}All links valid across ${files.length} markdown file(s).${COLORS.reset}
+`);
+    return 0;
+  }
+  const bySource = new Map;
+  for (const link of broken) {
+    const existing = bySource.get(link.source);
+    if (existing) {
+      existing.push(link);
+    } else {
+      bySource.set(link.source, [link]);
+    }
+  }
+  process.stderr.write(`${COLORS.red}Found ${broken.length} broken link(s):${COLORS.reset}
+
+`);
+  for (const [source, links] of bySource) {
+    process.stderr.write(`  ${COLORS.yellow}${source}${COLORS.reset}
+`);
+    for (const link of links) {
+      process.stderr.write(`    ${COLORS.cyan}${link.line}${COLORS.reset}  ${COLORS.dim}${link.target}${COLORS.reset}
+`);
+    }
+    process.stderr.write(`
+`);
+  }
+  return 1;
+}
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    process.stdout.write(`Usage: check-markdown-links [dirs/patterns...]
+
+Validates that relative links in markdown files resolve to existing files.
+
+Arguments:
+  dirs/patterns  Glob patterns to scan (defaults: docs/, packages/*/README.md, etc.)
+
+Options:
+  --help  Show this help message
+
+Exit codes:
+  0  All links valid
+  1  Broken links found
+`);
+    process.exitCode = 0;
+    return;
+  }
+  const cwd = process.cwd();
+  const patterns = args.length > 0 ? args.filter((a) => !a.startsWith("--")) : undefined;
+  const exitCode = await runCheckMarkdownLinks(cwd, patterns);
+  process.exitCode = exitCode;
+}
+if (import.meta.main) {
+  main();
+}
+
+export { extractMarkdownLinks, validateLinks, runCheckMarkdownLinks };

package/dist/shared/@outfitter/tooling-mkynjra9.js

@@ -0,0 +1,23 @@
+// @bun
+// packages/tooling/src/bun-version-compat.ts
+function parseSemver(version) {
+  const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!match?.[1] || !match[2] || !match[3]) {
+    return;
+  }
+  return {
+    major: Number.parseInt(match[1], 10),
+    minor: Number.parseInt(match[2], 10),
+    patch: Number.parseInt(match[3], 10)
+  };
+}
+function isTypesBunVersionCompatible(bunVersion, bunTypesVersion) {
+  const parsedBun = parseSemver(bunVersion);
+  const parsedTypes = parseSemver(bunTypesVersion);
+  if (!parsedBun || !parsedTypes) {
+    return bunVersion === bunTypesVersion;
+  }
+  return parsedBun.major === parsedTypes.major && parsedBun.minor === parsedTypes.minor && parsedTypes.patch <= parsedBun.patch;
+}
+
+export { parseSemver, isTypesBunVersionCompatible };