beeequeue · May 25, 2026 · May 19, 2026 · May 19, 2026 · May 17, 2026 · May 17, 2026
diff --git a/.changeset/config.json b/.changeset/config.json
@@ -1,4 +1,5 @@
 {
+  "$schema": "../packages/config/schema.json",
   "changelog": [
     "@changesets/changelog-github",
     { "repo": "changesets/changesets" }

diff --git a/.changeset/cool-camels-type.md b/.changeset/cool-camels-type.md
@@ -0,0 +1,40 @@
+---
+"@changesets/config": major
+---
+
+Removed `read` and `parse` functions in favor of `readConfig`, which returns `{ config, warnings, errors }` instead of throwing on issues.
+
+```ts
+// before.ts
+import { parse } from "@changesets/config";
+import { getPackages } from "@manypkg/get-packages";
+
+const config = parse({ commit: true }, await getPackages());
+
+try {
+  return parse({ commit: true }, packages);
+} catch (err) {
+  if (err instanceof ValidationError) {
+    console.error(`Invalid config: ${err.message}`);
+  } else {
+    throw err;
+  }
+}
+
+// after.ts
+import { readConfig } from "@changesets/config";
+import { getPackages } from "@manypkg/get-packages";
+
+// both arguments are optional
+const { config, warnings, errors } = readConfig(
+  process.cwd(),
+  await getPackages(),
+);
+
+if (warnings.length !== 0) {
+  console.warn(warnings.join("\n"));
+}
+if (config == null) {
+  console.error(errors.join("\n"));
+}
+```
diff --git a/.changeset/cute-deserts-like.md b/.changeset/cute-deserts-like.md
@@ -0,0 +1,5 @@
+---
+"@changesets/errors": minor
+---
+
+Added `cause` option to `ExitError` to help surface the cause behind exiting.
diff --git a/.changeset/rich-geckos-end.md b/.changeset/rich-geckos-end.md
@@ -0,0 +1,5 @@
+---
+"@changesets/config": minor
+---
+
+Refactored config parsing to use Valibot and validation rules.
diff --git a/.changeset/wicked-dryers-shave.md b/.changeset/wicked-dryers-shave.md
@@ -0,0 +1,5 @@
+---
+"@changesets/errors": major
+---
+
+Removed `ValidationError`.
diff --git a/package.json b/package.json
@@ -26,13 +26,14 @@
     "watch": "tsdown --watch",
     "format": "oxfmt --check",
     "format:fix": "oxfmt",
+    "generate-json-schema": "node packages/config/scripts/generate-json-schema.ts",
     "lint": "eslint",
     "test": "vitest",
     "types:check": "tsc",
     "check-all": "pnpm build && pnpm test run && pnpm types:check && pnpm lint && pnpm format",
     "version-packages": "pnpm changeset version && pnpm format:fix",
     "release": "pnpm changeset publish",
-    "changeset": "NODE_OPTIONS=--experimental-strip-types packages/cli/bin.js"
+    "changeset": "node packages/cli/bin.js"
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",

diff --git a/packages/apply-release-plan/src/index.test.ts b/packages/apply-release-plan/src/index.test.ts
@@ -20,7 +20,7 @@ import { getPackages } from "@manypkg/get-packages";
 import { outdent } from "outdent";
 import { exec } from "tinyexec";
 import { describe, expect, it, test } from "vitest";
-import applyReleasePlan from "./index.ts";
+import { applyReleasePlan } from "./index.ts";
 
 const changesetsCliChangelogPath = path.resolve(
   import.meta.dirname,

diff --git a/packages/assemble-release-plan/README.md b/packages/assemble-release-plan/README.md
@@ -10,16 +10,21 @@ Usage
 ```ts
 import assembleReleasePlan from "@changesets/assemble-release-plan";
 import { readChangesets } from "@changesets/read";
-import { read } from "@changesets/config";
+import { readConfig } from "@changesets/config";
 import { getPackages } from "@manypkg/get-packages";
 import { readPreState } from "@changesets/pre";
 
 const packages = await getPackages(cwd);
 const preState = await readPreState(cwd);
-const config = await read(cwd, packages);
+const { config } = await readConfig(cwd, packages);
 const changesets = await readChangesets(cwd, sinceRef);
 
-const releasePlan = assembleReleasePlan(changesets, packages, config, preState);
+const releasePlan = assembleReleasePlan(
+  changesets,
+  packages,
+  config!,
+  preState,
+);
 ```
 
 Signature

diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -40,7 +40,6 @@
     "@changesets/config": "workspace:^",
     "@changesets/errors": "workspace:^",
     "@changesets/get-dependents-graph": "workspace:^",
-    "@changesets/get-release-plan": "workspace:^",
     "@changesets/git": "workspace:^",
     "@changesets/pre": "workspace:^",
     "@changesets/read": "workspace:^",

diff --git a/packages/cli/src/commands/add/index.ts b/packages/cli/src/commands/add/index.ts
@@ -1,7 +1,6 @@
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import c from "@changesets/color";
-import { read } from "@changesets/config";
 import { ExitError } from "@changesets/errors";
 import * as git from "@changesets/git";
 import { shouldSkipPackage } from "@changesets/should-skip-package";
@@ -12,6 +11,7 @@ import launchEditor from "launch-editor";
 import { getCommitFunctions } from "../../commit/getCommitFunctions.ts";
 import * as cli from "../../utils/cli-utilities.ts";
 import { importantWarning } from "../../utils/cli-utilities.ts";
+import { readConfig } from "../../utils/read-config.ts";
 import { getVersionableChangedPackages } from "../../utils/versionablePackages.ts";
 import { ensureChangesetFolder } from "../shared.ts";
 import { createChangeset } from "./createChangeset.ts";
@@ -37,7 +37,7 @@ export async function add(options?: AddOptions): Promise<void> {
     throw new ExitError(1);
   }
 
-  const config = await read(packages.rootDir, packages);
+  const config = await readConfig(packages);
 
   const versionablePackages = packages.packages.filter(
     (pkg) =>

diff --git a/packages/cli/src/commands/publish/__tests__/index.test.ts b/packages/cli/src/commands/publish/__tests__/index.test.ts
@@ -33,7 +33,7 @@ describe("Publish command", () => {
       });
       await expect(
         publishCommand({ cwd, tag: "experimental" }),
-      ).rejects.toThrowError();
+      ).rejects.toThrow();
     });
   });
 });
diff --git a/packages/cli/src/commands/publish/index.ts b/packages/cli/src/commands/publish/index.ts
@@ -1,5 +1,4 @@
 import c from "@changesets/color";
-import { read } from "@changesets/config";
 import { ExitError } from "@changesets/errors";
 import * as git from "@changesets/git";
 import { readPreState } from "@changesets/pre";
@@ -8,6 +7,7 @@ import { log, spinner } from "@clack/prompts";
 import { getPackages } from "@manypkg/get-packages";
 import { importantWarning } from "../../utils/cli-utilities.ts";
 import { getUntaggedPackages } from "../../utils/getUntaggedPackages.ts";
+import { readConfig } from "../../utils/read-config.ts";
 import { ensureChangesetFolder } from "../shared.ts";
 import { publishPackages } from "./publishPackages.ts";
 
@@ -65,7 +65,7 @@ To resolve this exit the pre mode by running ${c.cyan("changeset pre exit")}.
     showNonLatestTagWarning(options?.tag, preState);
   }
 
-  const config = await read(packages.rootDir, packages);
+  const config = await readConfig(packages);
   const tagPrivatePackages =
     config.privatePackages && config.privatePackages.tag;
 

diff --git a/packages/cli/src/commands/status/index.ts b/packages/cli/src/commands/status/index.ts
@@ -1,12 +1,14 @@
 import fs from "node:fs/promises";
 import path from "node:path";
+import { assembleReleasePlan } from "@changesets/assemble-release-plan";
 import c from "@changesets/color";
-import { read } from "@changesets/config";
 import { ExitError } from "@changesets/errors";
-import { getReleasePlan } from "@changesets/get-release-plan";
+import { readPreState } from "@changesets/pre";
+import { readChangesets } from "@changesets/read";
 import type { ComprehensiveRelease } from "@changesets/types";
 import { log } from "@clack/prompts";
 import { getPackages } from "@manypkg/get-packages";
+import { readConfig } from "../../utils/read-config.ts";
 import { getVersionableChangedPackages } from "../../utils/versionablePackages.ts";
 import { ensureChangesetFolder } from "../shared.ts";
 
@@ -22,12 +24,16 @@ export async function status(options?: StatusOptions) {
 
   const packages = await getPackages(cwd);
   await ensureChangesetFolder(packages.rootDir);
-  const config = await read(packages.rootDir, packages);
 
-  const releasePlan = await getReleasePlan(
-    packages.rootDir,
-    options?.since,
+  const config = await readConfig(packages);
+  const preState = await readPreState(packages.rootDir);
+  const changesets = await readChangesets(packages.rootDir, options?.since);
+
+  const releasePlan = assembleReleasePlan(
+    changesets,
+    packages,
     config,
+    preState,
   );
   const changedPackages = await getVersionableChangedPackages(config, {
     cwd: packages.rootDir,

diff --git a/packages/cli/src/commands/tag/index.ts b/packages/cli/src/commands/tag/index.ts
@@ -1,10 +1,10 @@
 import c from "@changesets/color";
-import { read } from "@changesets/config";
 import * as git from "@changesets/git";
 import { shouldSkipPackage } from "@changesets/should-skip-package";
 import { log, progress } from "@clack/prompts";
 import { getPackages, type Tool } from "@manypkg/get-packages";
 import { getUntaggedPackages } from "../../utils/getUntaggedPackages.ts";
+import { readConfig } from "../../utils/read-config.ts";
 import { ensureChangesetFolder } from "../shared.ts";
 
 function buildTag(tool: Tool, pkg: { name: string; newVersion: string }) {
@@ -30,7 +30,7 @@ export async function tag(options?: TagOptions) {
   const cwd = options?.cwd ?? process.cwd();
   const packages = await getPackages(cwd);
   await ensureChangesetFolder(packages.rootDir);
-  const config = await read(packages.rootDir, packages);
+  const config = await readConfig(packages);
 
   const allExistingTags = await git.getAllTags(packages.rootDir);
 

diff --git a/packages/cli/src/commands/version/index.ts b/packages/cli/src/commands/version/index.ts
@@ -3,7 +3,6 @@ import { fileURLToPath } from "node:url";
 import { applyReleasePlan } from "@changesets/apply-release-plan";
 import { assembleReleasePlan } from "@changesets/assemble-release-plan";
 import c from "@changesets/color";
-import { read } from "@changesets/config";
 import { ExitError } from "@changesets/errors";
 import { getDependentsGraph } from "@changesets/get-dependents-graph";
 import * as git from "@changesets/git";
@@ -15,6 +14,7 @@ import { log } from "@clack/prompts";
 import { getPackages } from "@manypkg/get-packages";
 import { getCommitFunctions } from "../../commit/getCommitFunctions.ts";
 import { importantWarning } from "../../utils/cli-utilities.ts";
+import { readConfig } from "../../utils/read-config.ts";
 import { ensureChangesetFolder } from "../shared.ts";
 
 export interface VersionOptions {
@@ -29,7 +29,7 @@ export async function version(options: VersionOptions) {
 
   const packages = await getPackages(cwd);
   await ensureChangesetFolder(packages.rootDir);
-  const config = await read(packages.rootDir, packages);
+  const config = await readConfig(packages);
 
   const messages: string[] = [];
   let ignore: readonly string[] | undefined;

diff --git a/packages/cli/src/commands/version/version.test.ts b/packages/cli/src/commands/version/version.test.ts
@@ -1800,10 +1800,6 @@ describe("snapshot release", () => {
         "0.0.0-alpha.1639354050879.abcdef",
       ],
       ["{datetime}-{tag}", "alpha", "0.0.0-20211213000730-alpha"],
-      // Legacy support
-      ["", "test", "0.0.0-test-20211213000730"],
-      [undefined, "canary", "0.0.0-canary-20211213000730"],
-      [null, "alpha", "0.0.0-alpha-20211213000730"],
     ])(
       "should customize release correctly based on snapshotPrereleaseTemplate template: %s (tag: '%s')",
       async (snapshotTemplate, snapshotValue, expectedResult) => {
@@ -1890,7 +1886,7 @@ describe("snapshot release", () => {
           commit: false,
           snapshot: {
             useCalculatedVersion: true,
-            prereleaseTemplate: null,
+            prereleaseTemplate: undefined,
           },
         }),
       });
@@ -1937,7 +1933,7 @@ describe("snapshot release", () => {
           ...modifiedDefaultConfig,
           snapshot: {
             useCalculatedVersion: true,
-            prereleaseTemplate: null,
+            prereleaseTemplate: undefined,
           },
         }),
       });
@@ -1987,7 +1983,7 @@ describe("snapshot release", () => {
           ignore: ["pkg-a"],
           snapshot: {
             useCalculatedVersion: true,
-            prereleaseTemplate: null,
+            prereleaseTemplate: undefined,
           },
         }),
       });

diff --git a/packages/cli/src/utils/read-config.ts b/packages/cli/src/utils/read-config.ts
@@ -0,0 +1,34 @@
+import c from "@changesets/color";
+import { readConfig as originalReadConfig } from "@changesets/config";
+import { ExitError } from "@changesets/errors";
+import type { Config, Packages } from "@changesets/types";
+import { log } from "@clack/prompts";
+
+export async function readConfig(packages: Packages): Promise<Config> {
+  const { config, warnings, errors } = await originalReadConfig(
+    packages.rootDir,
+    packages,
+  );
+
+  const messages: string[] = [];
+
+  for (const warning of warnings) {
+    messages.push(c.yellow(warning));
+  }
+  if (errors != null) {
+    for (const error of errors) {
+      messages.push(c.red(error));
+    }
+  }
+
+  const logFn = errors != null ? log.error : log.warn;
+  if (messages.length !== 0) {
+    logFn(`Found issues in your config:\n- ${messages.join("\n- ")}`);
+  }
+
+  if (errors != null) {
+    throw new ExitError(1, { cause: new Error(errors.join("\n")) });
+  }
+
+  return config;
+}
diff --git a/packages/config/README.md b/packages/config/README.md
@@ -6,19 +6,17 @@
 [![View changelog](https://npmx.dev/api/registry/badge/version/@changesets/cli?color=229fe4&value=View+changelog&label=+)](./CHANGELOG.md)
 
 ```tsx
-import { parse, read, ValidationError } from "@changesets/config";
+import { readConfig } from "@changesets/config";
 
-let config = await read(process.cwd(), workspaces);
+const { config, warnings, errors } = await readConfig(process.cwd());
 
-let config = parse({ commit: true }, workspaces);
-
-try {
-  return parse({ commit: true }, workspaces);
-} catch (err) {
-  if (err instanceof ValidationError) {
-    let message = err.message;
-  } else {
-    throw err;
-  }
+if (warnings.length !== 0) {
+  console.warn(warnings);
+}
+if (config == null) {
+  console.error(errors);
+  return;
 }
+
+console.log(config);
 ```
diff --git a/packages/config/package.json b/packages/config/package.json
@@ -18,8 +18,10 @@
     "./package.json": "./package.json",
     "./schema.json": "./schema.json"
   },
+  "scripts": {
+    "generate-json-schema": "node scripts/generate-json-schema.ts"
+  },
   "dependencies": {
-    "@changesets/errors": "workspace:^",
     "@changesets/get-dependents-graph": "workspace:^",
     "@changesets/should-skip-package": "workspace:^",
     "@changesets/types": "workspace:^",
@@ -29,10 +31,15 @@
   "devDependencies": {
     "@changesets/test-utils": "workspace:*",
     "@types/picomatch": "4.0.3",
+    "@valibot/to-json-schema": "^1.7.0",
     "outdent": "^0.8.0",
+    "valibot": "^1.4.0",
     "vitest": "^4.1.6"
   },
   "engines": {
     "node": "^22.11 || ^24 || >=26"
+  },
+  "inlinedDependencies": {
+    "valibot": "1.4.0"
   }
 }