breakage 0.8.4 → 0.9.0

package/dist/breakage.x.js

@@ -1,21 +1,103 @@
 #!/usr/bin/env node
-import { n as breakagePrelude, t as breakage } from "./breakage-Dc4IldeW.js";
-import * as path$1 from "node:path";
+import { a as configFields, c as configSchema, d as loadConfig, f as resolveConfig, h as errorMessage, i as npmTest, l as defaultConfig, m as breakagePrelude, n as formatNpmReport, o as configOptions, p as validateConfig, r as npmCheck, s as configPath, t as breakage } from "./breakage-DIY49fzP.js";
+import path from "node:path";
 import logger from "takua";
-import { inspect } from "node:util";
 import { type } from "arktype";
-import { cli, completionResponse, encapsulate, help, logWarnings, noOptions, optional, options, parseBooleanOption } from "comline";
-//#region src/breakage.x.ts
-const BREAKAGE_MANUAL = options(`Check for breaking changes in a package.`, type({
-	"tagPattern?": `string`,
-	"baselineFile?": `string`,
-	testPattern: `string`,
-	testCommand: `string`,
-	certifyCommand: `string`,
-	"baseDirname?": `string`,
-	"verbose?": `boolean`
+import { cli, completionResponse, encapsulate, help, logWarnings, noOptions, optional, options, parseBooleanOption, required } from "comline";
+import { inspect } from "node:util";
+// src/npm/cli.ts
+const common = {
+	release: configOptions.optionConfigs.release,
+	npm: configOptions.optionConfigs.npm,
+	config: {
+		schema: type(`string`),
+		required: false,
+		description: `Configuration file (defaults to breakage.config.ts).`,
+		example: `--config ./breakage.config.ts`,
+		completion: {
+			fileSystem: `files`,
+			repeatable: false
+		}
+	},
+	json: {
+		schema: type(`boolean`),
+		required: false,
+		description: `Emit the structured result.`,
+		example: `--json`,
+		parse: parseBooleanOption
+	}
+};
+const npmCheckManual = options(`Check npm peer compatibility and changes in declared support.`, type({
+	"config?": `string`,
+	"json?": `boolean`,
+	"coverageOnly?": `boolean`,
+	"release?": configOptions.optionsSchema.get(`release`),
+	"npm?": configOptions.optionsSchema.get(`npm`)
 }), {
+	...common,
+	coverageOnly: {
+		schema: type(`boolean`),
+		aliases: [`coverage-only`],
+		required: false,
+		description: `Audit coverage and support changes without executing assertions.`,
+		example: `--coverage-only`,
+		parse: parseBooleanOption
+	}
+});
+const npmTestManual = options(`Run current contracts in matching complete peer environments.`, type({
+	"config?": `string`,
+	"json?": `boolean`,
+	"representative?": `string`,
+	"release?": configOptions.optionsSchema.get(`release`),
+	"npm?": configOptions.optionsSchema.get(`npm`)
+}), {
+	...common,
+	representative: {
+		schema: type(`string`),
+		required: false,
+		description: `Select an exact configured representative path relative to the package.`,
+		example: `--representative peer-environments/react-19`,
+		completion: {
+			fileSystem: `directories`,
+			repeatable: false
+		}
+	}
+});
+async function runNpmCli(action, opts, peerSelection) {
+	try {
+		const filename = path.resolve(opts.config ?? defaultConfig(process.cwd()));
+		const config = (await loadConfig(filename)).npm;
+		validateConfig(config);
+		let selection;
+		if (action === `test`) {
+			if (peerSelection && opts.representative) throw new Error(`Choose a peer range or a representative, not both.`);
+			selection = peerSelection ?? (opts.representative ? { representative: opts.representative } : void 0);
+			if (!selection) throw new Error(`Use npm test <peer> <range> or npm test --representative <path>.`);
+		}
+		const options = {
+			baseDirectory: path.dirname(filename),
+			coverageOnly: opts.coverageOnly ?? false
+		};
+		const report = selection ? await npmTest(config, selection, options) : await npmCheck(config, options);
+		process.stdout.write(opts.json ? `${JSON.stringify(report, null, 2)}\n` : formatNpmReport(report));
+		return report.exitCode;
+	} catch (error) {
+		const message = errorMessage(error);
+		process.stdout.write(opts.json ? `${JSON.stringify({
+			exitCode: 2,
+			errors: [message]
+		})}\n` : `npm setup error: ${message}\n`);
+		return 2;
+	}
+}
+// src/breakage.x.ts
+const commandOverrides = /* @__PURE__ */ new Set();
+const BREAKAGE_MANUAL = options(`Check for breaking changes in a package.`, configSchema, {
+	release: { configOnly: true },
+	npm: { configOnly: true },
+	out: { configOnly: true },
 	tagPattern: {
+		schema: configFields.tagPattern,
 		aliases: [`tag-pattern`],
 		completion: { repeatable: false },
 		flag: `g`,
@@ -24,6 +106,7 @@ const BREAKAGE_MANUAL = options(`Check for breaking changes in a package.`, type
 		example: `--tagPattern="my-library"`
 	},
 	baselineFile: {
+		schema: configFields.baselineFile,
 		aliases: [`baseline-file`],
 		completion: {
 			repeatable: false,
@@ -34,30 +117,41 @@ const BREAKAGE_MANUAL = options(`Check for breaking changes in a package.`, type
 		example: `--baseline-file=.breakage/baseline.json`
 	},
 	testPattern: {
+		schema: configFields.testPattern,
 		aliases: [`test-pattern`, `pattern`],
 		completion: { repeatable: false },
 		flag: `p`,
-		required: true,
+		required: false,
 		description: `The pattern to match test files that test the public API of the library.`,
 		example: `--pattern="*__public.test.ts"`
 	},
 	testCommand: {
+		parse: (value) => {
+			commandOverrides.add(`testCommand`);
+			return value;
+		},
+		schema: configFields.testCommand,
 		aliases: [`test-command`],
 		completion: { repeatable: false },
 		flag: `t`,
-		required: true,
+		required: false,
 		description: `Complete bash command that runs the tests for the library's public API.`,
 		example: `--testCommand="npm run test"`
 	},
-	certifyCommand: {
-		aliases: [`certify-command`],
+	test: {
+		parse: (value) => {
+			commandOverrides.add(`test`);
+			return value;
+		},
+		schema: configFields.test,
 		completion: { repeatable: false },
-		flag: `c`,
-		required: true,
-		description: `Complete bash command that determines whether a major version bump for your package is indicated in the workspace. Exit code 0 indicates that a major version bump is indicated, and exit code 1 indicates that no major version bump is indicated.`,
-		example: `--certifyCommand=\tsx scripts/certify-major-version-bump.node`
+		required: false,
+		description: `Shell command running the restored public contracts.`,
+		example: `--test="npm run test:public"`
 	},
 	baseDirname: {
+		parse: (value) => path.resolve(value),
+		schema: configFields.baseDirname,
 		aliases: [`base-dir`, `base-dirname`],
 		completion: {
 			repeatable: false,
@@ -69,6 +163,7 @@ const BREAKAGE_MANUAL = options(`Check for breaking changes in a package.`, type
 		example: `--baseDirname=./packages/my-package`
 	},
 	verbose: {
+		schema: configFields.verbose,
 		completion: { repeatable: false },
 		flag: `v`,
 		required: false,
@@ -77,16 +172,7 @@ const BREAKAGE_MANUAL = options(`Check for breaking changes in a package.`, type
 		parse: parseBooleanOption
 	}
 });
-const PRELUDE_MANUAL = options(`Resolve and fetch the release baseline for a cacheable compatibility check.`, type({
-	"tagPattern?": `string`,
-	"baseDirname?": `string`,
-	"out?": `string`,
-	"testPattern?": `string`,
-	"testCommand?": `string`,
-	"certifyCommand?": `string`,
-	"baselineFile?": `string`,
-	"verbose?": `boolean`
-}), {
+const PRELUDE_MANUAL = options(`Resolve and fetch the release baseline for a cacheable compatibility check.`, configSchema, {
 	...BREAKAGE_MANUAL.optionConfigs,
 	testPattern: {
 		...BREAKAGE_MANUAL.optionConfigs.testPattern,
@@ -96,11 +182,8 @@ const PRELUDE_MANUAL = options(`Resolve and fetch the release baseline for a cac
 		...BREAKAGE_MANUAL.optionConfigs.testCommand,
 		required: false
 	},
-	certifyCommand: {
-		...BREAKAGE_MANUAL.optionConfigs.certifyCommand,
-		required: false
-	},
 	out: {
+		schema: configFields.out,
 		completion: {
 			repeatable: false,
 			fileSystem: `files`
@@ -110,22 +193,22 @@ const PRELUDE_MANUAL = options(`Resolve and fetch the release baseline for a cac
 		example: `--out=.breakage/baseline.json`
 	}
 });
-const SCHEMA_MANUAL = options(`Create a copy of the schema for configuring breakage.`, type({ "outdir?": `string` }), { outdir: {
-	aliases: [`out-dir`],
-	completion: {
-		repeatable: false,
-		fileSystem: `directories`
-	},
-	flag: `o`,
-	required: false,
-	description: `Directory to write the schema to.`,
-	example: `--outdir=./dist`
-} });
+let loadedConfigPath;
 const parse = cli({
 	cliName: `breakage`,
+	discoverConfigPath: (segments) => {
+		if (segments[0] === `help` || segments[0] === `npm`) return void 0;
+		const explicit = segments[0] === `prelude` ? segments[1] : segments[0];
+		loadedConfigPath = configPath(explicit ?? defaultConfig(process.cwd()), explicit !== void 0);
+		return loadedConfigPath;
+	},
 	routes: optional({
 		help: null,
-		schema: null,
+		npm: optional({
+			help: null,
+			check: null,
+			test: optional({ $peer: required({ $range: null }) })
+		}),
 		prelude: optional({ $configPath: null }),
 		$configPath: null
 	}),
@@ -133,17 +216,17 @@ const parse = cli({
 		"": BREAKAGE_MANUAL,
 		$configPath: BREAKAGE_MANUAL,
 		help: noOptions(`Show usage.`),
-		schema: SCHEMA_MANUAL,
+		npm: noOptions(`Show npm compatibility commands.`),
+		"npm/help": noOptions(`Show npm compatibility commands.`),
+		"npm/check": npmCheckManual,
+		"npm/test": npmTestManual,
+		"npm/test/$peer/$range": npmTestManual,
 		prelude: PRELUDE_MANUAL,
 		"prelude/$configPath": PRELUDE_MANUAL
 	},
 	positionalCompletions: {
 		$configPath: { fileSystem: `files` },
 		"prelude/$configPath": { fileSystem: `files` }
-	},
-	discoverConfigPath: (args) => {
-		if (args[0] === `help` || args[0] === `schema`) return;
-		return (args[0] === `prelude` ? args[1] : args[0]) ?? path$1.join(process.cwd(), `breakage.config.json`);
 	}
 }, {
 	info: (message, ...data) => logger.info(`breakage`, message, data),
@@ -151,43 +234,60 @@ const parse = cli({
 });
 const completion = await completionResponse(parse.definition, process.argv);
 if (completion !== void 0) process.stdout.write(completion);
-else {
-	const { inputs, warnings, writeJsonSchema } = parse(process.argv);
+else try {
+	const { inputs, warnings } = await parse.async(process.argv);
 	logWarnings(warnings);
+	if (process.argv.slice(2).some((arg) => /^(?:--certifyCommand|--certify-command|-c)(?:=|$)/.test(arg))) throw new Error(`certifyCommand was removed. Configure release.resolveDelta and release.policy instead.`);
 	switch (inputs.case) {
+		case `npm`:
+		case `npm/help`:
 		case `help`:
 			console.log(help(parse.definition));
 			break;
-		case `schema`:
-			{
-				const { outdir } = inputs.opts;
-				writeJsonSchema(outdir ?? `.`);
-				process.stdout.write(`📝 Wrote json.schema.`);
-			}
+		case `npm/check`:
+			process.exitCode = await runNpmCli(`check`, inputs.opts);
+			break;
+		case `npm/test`:
+			process.exitCode = await runNpmCli(`test`, inputs.opts);
+			break;
+		case `npm/test/$peer/$range`:
+			process.exitCode = await runNpmCli(`test`, inputs.opts, inputs.params);
 			break;
 		case `prelude`:
 		case `prelude/$configPath`: {
+			const config = resolveConfig(inputs.opts, loadedConfigPath);
 			const baseline = await breakagePrelude({
-				...inputs.opts,
-				out: inputs.opts.out ?? `.breakage/baseline.json`
+				...config,
+				out: config.out ?? `.breakage/baseline.json`
 			});
 			process.stdout.write(`Pinned ${baseline.ref} at ${baseline.commit}.\n`);
 			break;
 		}
 		case ``:
 		case `$configPath`: {
-			const { returnValue } = await encapsulate(() => breakage(inputs.opts), {
+			const merged = resolveConfig(inputs.opts, loadedConfigPath);
+			if (commandOverrides.has(`testCommand`) && !commandOverrides.has(`test`)) delete merged.test;
+			if (commandOverrides.has(`test`) && !commandOverrides.has(`testCommand`)) delete merged.testCommand;
+			if (!merged.testPattern) throw new Error(`required arguments were not provided: testPattern.`);
+			const { returnValue } = await encapsulate(() => breakage({
+				...merged,
+				testPattern: merged.testPattern
+			}), {
 				console: true,
 				stdout: true
 			});
+			if (`release` in returnValue && returnValue.release) {
+				const { previousVersion, version, delta, breaking } = returnValue.release;
+				process.stdout.write(`Release: ${previousVersion} → ${version} (${delta}; ${breaking ? `breaking` : `compatible`}).\n`);
+			}
 			if (`testResult` in returnValue && returnValue.breakingChangesFound) process.stdout.write(returnValue.testResult);
 			if (`breakingChangesFound` in returnValue) {
 				if (returnValue.breakingChangesFound) {
-					if (returnValue.breakingChangesCertified) {
-						process.stdout.write(`👷 Breaking changes were found and certified.`);
+					if (returnValue.release?.breaking) {
+						process.stdout.write(`👷 Breaking changes are covered by the breaking release.`);
 						process.exit(0);
 					} else {
-						process.stdout.write(`❌ Breaking changes were found, but not certified.`);
+						process.stdout.write(`❌ Breaking changes require a breaking release.`);
 						process.exit(1);
 					}
 				} else {
@@ -200,8 +300,10 @@ else {
 			}
 		}
 	}
+} catch (error) {
+	process.stderr.write(`Breakage setup error: ${errorMessage(error)}\n`);
+	process.exitCode = 2;
 }
-//#endregion
 export {};
 
 //# sourceMappingURL=breakage.x.js.map

package/dist/breakage.x.js.map

@@ -1 +1 @@
-{"version":3,"file":"breakage.x.js","names":["path"],"sources":["../src/breakage.x.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport * as path from \"node:path\"\nimport { inspect } from \"node:util\"\n\nimport { type } from \"arktype\"\nimport type { OptionsGroup } from \"comline\"\nimport {\n\tcli,\n\tcompletionResponse,\n\tencapsulate,\n\thelp,\n\tlogWarnings,\n\tnoOptions,\n\toptional,\n\toptions,\n\tparseBooleanOption,\n} from \"comline\"\nimport logger from \"takua\"\n\nimport type { BreakageOptions } from \"./breakage.ts\"\nimport { breakage, breakagePrelude } from \"./breakage.ts\"\n\nconst BREAKAGE_MANUAL = options(\n\t`Check for breaking changes in a package.`,\n\ttype({\n\t\t\"tagPattern?\": `string`,\n\t\t\"baselineFile?\": `string`,\n\t\ttestPattern: `string`,\n\t\ttestCommand: `string`,\n\t\tcertifyCommand: `string`,\n\t\t\"baseDirname?\": `string`,\n\t\t\"verbose?\": `boolean`,\n\t}),\n\t{\n\t\ttagPattern: {\n\t\t\taliases: [`tag-pattern`],\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `g`,\n\t\t\trequired: false,\n\t\t\tdescription: `RegExp which, if found matched to a git tag, will be considered a release tag for your library.`,\n\t\t\texample: `--tagPattern=\"my-library\"`,\n\t\t},\n\t\tbaselineFile: {\n\t\t\taliases: [`baseline-file`],\n\t\t\tcompletion: { repeatable: false, fileSystem: `files` },\n\t\t\trequired: false,\n\t\t\tdescription: `Use the exact locally fetched commit from a prelude snapshot instead of discovering remote tags.`,\n\t\t\texample: `--baseline-file=.breakage/baseline.json`,\n\t\t},\n\t\ttestPattern: {\n\t\t\taliases: [`test-pattern`, `pattern`],\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `p`,\n\t\t\trequired: true,\n\t\t\tdescription: `The pattern to match test files that test the public API of the library.`,\n\t\t\texample: `--pattern=\"*__public.test.ts\"`,\n\t\t},\n\t\ttestCommand: {\n\t\t\taliases: [`test-command`],\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `t`,\n\t\t\trequired: true,\n\t\t\tdescription: `Complete bash command that runs the tests for the library's public API.`,\n\t\t\texample: `--testCommand=\"npm run test\"`,\n\t\t},\n\t\tcertifyCommand: {\n\t\t\taliases: [`certify-command`],\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `c`,\n\t\t\trequired: true,\n\t\t\tdescription: `Complete bash command that determines whether a major version bump for your package is indicated in the workspace. Exit code 0 indicates that a major version bump is indicated, and exit code 1 indicates that no major version bump is indicated.`,\n\t\t\texample: `--certifyCommand=\\tsx scripts/certify-major-version-bump.node`,\n\t\t},\n\t\tbaseDirname: {\n\t\t\taliases: [`base-dir`, `base-dirname`],\n\t\t\tcompletion: { repeatable: false, fileSystem: `directories` },\n\t\t\tflag: `d`,\n\t\t\trequired: false,\n\t\t\tdescription: `The base directory to run the command from.`,\n\t\t\texample: `--baseDirname=./packages/my-package`,\n\t\t},\n\t\tverbose: {\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `v`,\n\t\t\trequired: false,\n\t\t\tdescription: `Prints out more information about the process.`,\n\t\t\texample: `--verbose`,\n\t\t\tparse: parseBooleanOption,\n\t\t},\n\t},\n) satisfies OptionsGroup<BreakageOptions>\n\nconst PRELUDE_MANUAL = options(\n\t`Resolve and fetch the release baseline for a cacheable compatibility check.`,\n\ttype({\n\t\t\"tagPattern?\": `string`,\n\t\t\"baseDirname?\": `string`,\n\t\t\"out?\": `string`,\n\t\t\"testPattern?\": `string`,\n\t\t\"testCommand?\": `string`,\n\t\t\"certifyCommand?\": `string`,\n\t\t\"baselineFile?\": `string`,\n\t\t\"verbose?\": `boolean`,\n\t}),\n\t{\n\t\t...BREAKAGE_MANUAL.optionConfigs,\n\t\ttestPattern: {\n\t\t\t...BREAKAGE_MANUAL.optionConfigs.testPattern,\n\t\t\trequired: false,\n\t\t},\n\t\ttestCommand: {\n\t\t\t...BREAKAGE_MANUAL.optionConfigs.testCommand,\n\t\t\trequired: false,\n\t\t},\n\t\tcertifyCommand: {\n\t\t\t...BREAKAGE_MANUAL.optionConfigs.certifyCommand,\n\t\t\trequired: false,\n\t\t},\n\t\tout: {\n\t\t\tcompletion: { repeatable: false, fileSystem: `files` },\n\t\t\trequired: false,\n\t\t\tdescription: `Gitignored snapshot path relative to the base directory (default: .breakage/baseline.json).`,\n\t\t\texample: `--out=.breakage/baseline.json`,\n\t\t},\n\t},\n)\n\nconst SCHEMA_MANUAL = options(\n\t`Create a copy of the schema for configuring breakage.`,\n\ttype({ \"outdir?\": `string` }),\n\t{\n\t\toutdir: {\n\t\t\taliases: [`out-dir`],\n\t\t\tcompletion: { repeatable: false, fileSystem: `directories` },\n\t\t\tflag: `o`,\n\t\t\trequired: false,\n\t\t\tdescription: `Directory to write the schema to.`,\n\t\t\texample: `--outdir=./dist`,\n\t\t},\n\t},\n)\n\nconst parse = cli(\n\t{\n\t\tcliName: `breakage`,\n\t\troutes: optional({\n\t\t\thelp: null,\n\t\t\tschema: null,\n\t\t\tprelude: optional({ $configPath: null }),\n\t\t\t$configPath: null,\n\t\t}),\n\t\trouteOptions: {\n\t\t\t\"\": BREAKAGE_MANUAL,\n\t\t\t$configPath: BREAKAGE_MANUAL,\n\t\t\thelp: noOptions(`Show usage.`),\n\t\t\tschema: SCHEMA_MANUAL,\n\t\t\tprelude: PRELUDE_MANUAL,\n\t\t\t\"prelude/$configPath\": PRELUDE_MANUAL,\n\t\t},\n\t\tpositionalCompletions: {\n\t\t\t$configPath: { fileSystem: `files` },\n\t\t\t\"prelude/$configPath\": { fileSystem: `files` },\n\t\t},\n\t\tdiscoverConfigPath: (args: readonly string[]) => {\n\t\t\tif (args[0] === `help` || args[0] === `schema`) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst configPath =\n\t\t\t\t(args[0] === `prelude` ? args[1] : args[0]) ??\n\t\t\t\tpath.join(process.cwd(), `breakage.config.json`)\n\t\t\treturn configPath\n\t\t},\n\t},\n\t{\n\t\tinfo: (message, ...data) => logger.info(`breakage`, message, data),\n\t\terror: (message, ...data) => logger.error(`breakage`, message, data),\n\t},\n)\n\nconst completion = await completionResponse(parse.definition, process.argv)\nif (completion !== undefined) {\n\tprocess.stdout.write(completion)\n} else {\n\tconst { inputs, warnings, writeJsonSchema } = parse(process.argv)\n\tlogWarnings(warnings)\n\n\tswitch (inputs.case) {\n\t\tcase `help`:\n\t\t\tconsole.log(help(parse.definition))\n\t\t\tbreak\n\t\tcase `schema`:\n\t\t\t{\n\t\t\t\tconst { outdir } = inputs.opts\n\t\t\t\twriteJsonSchema(outdir ?? `.`)\n\t\t\t\tprocess.stdout.write(`📝 Wrote json.schema.`)\n\t\t\t}\n\t\t\tbreak\n\t\tcase `prelude`:\n\t\tcase `prelude/$configPath`: {\n\t\t\tconst baseline = await breakagePrelude({\n\t\t\t\t...inputs.opts,\n\t\t\t\tout: inputs.opts.out ?? `.breakage/baseline.json`,\n\t\t\t})\n\t\t\tprocess.stdout.write(`Pinned ${baseline.ref} at ${baseline.commit}.\\n`)\n\t\t\tbreak\n\t\t}\n\t\tcase ``:\n\t\tcase `$configPath`: {\n\t\t\tconst { returnValue } = await encapsulate(() => breakage(inputs.opts), {\n\t\t\t\tconsole: true,\n\t\t\t\tstdout: true,\n\t\t\t})\n\t\t\tif (`testResult` in returnValue && returnValue.breakingChangesFound) {\n\t\t\t\tprocess.stdout.write(returnValue.testResult)\n\t\t\t}\n\t\t\tif (`breakingChangesFound` in returnValue) {\n\t\t\t\tif (returnValue.breakingChangesFound) {\n\t\t\t\t\tif (returnValue.breakingChangesCertified) {\n\t\t\t\t\t\tprocess.stdout.write(\n\t\t\t\t\t\t\t`👷 Breaking changes were found and certified.`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\tprocess.exit(0)\n\t\t\t\t\t} else {\n\t\t\t\t\t\tprocess.stdout.write(\n\t\t\t\t\t\t\t`❌ Breaking changes were found, but not certified.`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\tprocess.exit(1)\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tprocess.stdout.write(`✅ No breaking changes were found.`)\n\t\t\t\t\tprocess.exit(0)\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tprocess.stdout.write(\n\t\t\t\t\t`💥 Breakage failed to determine breaking changes.` +\n\t\t\t\t\t\t`\\n` +\n\t\t\t\t\t\tinspect(returnValue),\n\t\t\t\t)\n\t\t\t\tprocess.exit(2)\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"breakage.x.js","names":[],"sources":["../src/npm/cli.ts","../src/breakage.x.ts"],"sourcesContent":["import path from \"node:path\"\n\nimport { type } from \"arktype\"\nimport type { OptionsGroup } from \"comline\"\nimport { options, parseBooleanOption } from \"comline\"\n\nimport { configOptions, defaultConfig, loadConfig } from \"../config.ts\"\n\nimport { formatNpmReport, npmCheck, npmTest } from \"./check.ts\"\nimport { errorMessage } from \"../task.ts\"\nimport { validateConfig } from \"./config.ts\"\nimport type { NpmTestSelection } from \"./types.ts\"\n\ntype CommonOptions = {\n\tconfig?: string | undefined\n\tjson?: boolean | undefined\n\trelease?: import(\"../release.ts\").ReleaseConfig\n\tnpm?: import(\"./types.ts\").NpmConfig\n}\ntype CheckOptions = CommonOptions & { coverageOnly?: boolean | undefined }\ntype TestOptions = CommonOptions & { representative?: string | undefined }\n\nconst common = {\n\trelease: configOptions.optionConfigs.release,\n\tnpm: configOptions.optionConfigs.npm,\n\tconfig: {\n\t\tschema: type(`string`),\n\t\trequired: false,\n\t\tdescription: `Configuration file (defaults to breakage.config.ts).`,\n\t\texample: `--config ./breakage.config.ts`,\n\t\tcompletion: { fileSystem: `files` as const, repeatable: false },\n\t},\n\tjson: {\n\t\tschema: type(`boolean`),\n\t\trequired: false,\n\t\tdescription: `Emit the structured result.`,\n\t\texample: `--json`,\n\t\tparse: parseBooleanOption,\n\t},\n}\n\nexport const npmCheckManual: OptionsGroup<CheckOptions> = options(\n\t`Check npm peer compatibility and changes in declared support.`,\n\ttype({\n\t\t\"config?\": `string`,\n\t\t\"json?\": `boolean`,\n\t\t\"coverageOnly?\": `boolean`,\n\t\t\"release?\": configOptions.optionsSchema.get(`release`),\n\t\t\"npm?\": configOptions.optionsSchema.get(`npm`),\n\t}),\n\t{\n\t\t...common,\n\t\tcoverageOnly: {\n\t\t\tschema: type(`boolean`),\n\t\t\taliases: [`coverage-only`],\n\t\t\trequired: false,\n\t\t\tdescription: `Audit coverage and support changes without executing assertions.`,\n\t\t\texample: `--coverage-only`,\n\t\t\tparse: parseBooleanOption,\n\t\t},\n\t},\n)\n\nexport const npmTestManual: OptionsGroup<TestOptions> = options(\n\t`Run current contracts in matching complete peer environments.`,\n\ttype({\n\t\t\"config?\": `string`,\n\t\t\"json?\": `boolean`,\n\t\t\"representative?\": `string`,\n\t\t\"release?\": configOptions.optionsSchema.get(`release`),\n\t\t\"npm?\": configOptions.optionsSchema.get(`npm`),\n\t}),\n\t{\n\t\t...common,\n\t\trepresentative: {\n\t\t\tschema: type(`string`),\n\t\t\trequired: false,\n\t\t\tdescription: `Select an exact configured representative path relative to the package.`,\n\t\t\texample: `--representative peer-environments/react-19`,\n\t\t\tcompletion: { fileSystem: `directories`, repeatable: false },\n\t\t},\n\t},\n)\n\nexport async function runNpmCli(\n\taction: `check` | `test`,\n\topts: CheckOptions & TestOptions,\n\tpeerSelection?: { peer: string; range: string },\n): Promise<number> {\n\ttry {\n\t\tconst filename = path.resolve(opts.config ?? defaultConfig(process.cwd()))\n\t\tconst config = (await loadConfig(filename)).npm\n\t\tvalidateConfig(config)\n\t\tlet selection: NpmTestSelection | undefined\n\t\tif (action === `test`) {\n\t\t\tif (peerSelection && opts.representative)\n\t\t\t\tthrow new Error(`Choose a peer range or a representative, not both.`)\n\t\t\tselection =\n\t\t\t\tpeerSelection ??\n\t\t\t\t(opts.representative\n\t\t\t\t\t? { representative: opts.representative }\n\t\t\t\t\t: undefined)\n\t\t\tif (!selection)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Use npm test <peer> <range> or npm test --representative <path>.`,\n\t\t\t\t)\n\t\t}\n\t\tconst options = {\n\t\t\tbaseDirectory: path.dirname(filename),\n\t\t\tcoverageOnly: opts.coverageOnly ?? false,\n\t\t}\n\t\tconst report = selection\n\t\t\t? await npmTest(config, selection, options)\n\t\t\t: await npmCheck(config, options)\n\t\tprocess.stdout.write(\n\t\t\topts.json\n\t\t\t\t? `${JSON.stringify(report, null, 2)}\\n`\n\t\t\t\t: formatNpmReport(report),\n\t\t)\n\t\treturn report.exitCode\n\t} catch (error) {\n\t\tconst message = errorMessage(error)\n\t\tprocess.stdout.write(\n\t\t\topts.json\n\t\t\t\t? `${JSON.stringify({ exitCode: 2, errors: [message] })}\\n`\n\t\t\t\t: `npm setup error: ${message}\\n`,\n\t\t)\n\t\treturn 2\n\t}\n}\n","#!/usr/bin/env node\n\nimport path from \"node:path\"\nimport { inspect } from \"node:util\"\n\nimport {\n\tcli,\n\tcompletionResponse,\n\tencapsulate,\n\thelp,\n\tlogWarnings,\n\tnoOptions,\n\toptional,\n\toptions,\n\tparseBooleanOption,\n\trequired,\n} from \"comline\"\nimport logger from \"takua\"\n\nimport {\n\tdefaultConfig,\n\tconfigPath,\n\tresolveConfig,\n\tconfigSchema,\n\tconfigFields,\n} from \"./config.ts\"\nimport { breakage, breakagePrelude } from \"./breakage.ts\"\nimport { errorMessage } from \"./task.ts\"\nimport { npmCheckManual, npmTestManual, runNpmCli } from \"./npm/cli.ts\"\n\n// Either command spelling can override the other spelling in a config file.\nconst commandOverrides = new Set<`test` | `testCommand`>()\n\nconst BREAKAGE_MANUAL = options(\n\t`Check for breaking changes in a package.`,\n\tconfigSchema,\n\t{\n\t\trelease: { configOnly: true },\n\t\tnpm: { configOnly: true },\n\t\tout: { configOnly: true },\n\t\ttagPattern: {\n\t\t\tschema: configFields.tagPattern,\n\t\t\taliases: [`tag-pattern`],\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `g`,\n\t\t\trequired: false,\n\t\t\tdescription: `RegExp which, if found matched to a git tag, will be considered a release tag for your library.`,\n\t\t\texample: `--tagPattern=\"my-library\"`,\n\t\t},\n\t\tbaselineFile: {\n\t\t\tschema: configFields.baselineFile,\n\t\t\taliases: [`baseline-file`],\n\t\t\tcompletion: { repeatable: false, fileSystem: `files` },\n\t\t\trequired: false,\n\t\t\tdescription: `Use the exact locally fetched commit from a prelude snapshot instead of discovering remote tags.`,\n\t\t\texample: `--baseline-file=.breakage/baseline.json`,\n\t\t},\n\t\ttestPattern: {\n\t\t\tschema: configFields.testPattern,\n\t\t\taliases: [`test-pattern`, `pattern`],\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `p`,\n\t\t\trequired: false,\n\t\t\tdescription: `The pattern to match test files that test the public API of the library.`,\n\t\t\texample: `--pattern=\"*__public.test.ts\"`,\n\t\t},\n\t\ttestCommand: {\n\t\t\tparse: (value) => {\n\t\t\t\tcommandOverrides.add(`testCommand`)\n\t\t\t\treturn value\n\t\t\t},\n\t\t\tschema: configFields.testCommand,\n\t\t\taliases: [`test-command`],\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `t`,\n\t\t\trequired: false,\n\t\t\tdescription: `Complete bash command that runs the tests for the library's public API.`,\n\t\t\texample: `--testCommand=\"npm run test\"`,\n\t\t},\n\t\ttest: {\n\t\t\tparse: (value) => {\n\t\t\t\tcommandOverrides.add(`test`)\n\t\t\t\treturn value\n\t\t\t},\n\t\t\tschema: configFields.test,\n\t\t\tcompletion: { repeatable: false },\n\t\t\trequired: false,\n\t\t\tdescription: `Shell command running the restored public contracts.`,\n\t\t\texample: `--test=\"npm run test:public\"`,\n\t\t},\n\t\tbaseDirname: {\n\t\t\tparse: (value) => path.resolve(value),\n\t\t\tschema: configFields.baseDirname,\n\t\t\taliases: [`base-dir`, `base-dirname`],\n\t\t\tcompletion: { repeatable: false, fileSystem: `directories` },\n\t\t\tflag: `d`,\n\t\t\trequired: false,\n\t\t\tdescription: `The base directory to run the command from.`,\n\t\t\texample: `--baseDirname=./packages/my-package`,\n\t\t},\n\t\tverbose: {\n\t\t\tschema: configFields.verbose,\n\t\t\tcompletion: { repeatable: false },\n\t\t\tflag: `v`,\n\t\t\trequired: false,\n\t\t\tdescription: `Prints out more information about the process.`,\n\t\t\texample: `--verbose`,\n\t\t\tparse: parseBooleanOption,\n\t\t},\n\t},\n)\n\nconst PRELUDE_MANUAL = options(\n\t`Resolve and fetch the release baseline for a cacheable compatibility check.`,\n\tconfigSchema,\n\t{\n\t\t...BREAKAGE_MANUAL.optionConfigs,\n\t\ttestPattern: {\n\t\t\t...BREAKAGE_MANUAL.optionConfigs.testPattern,\n\t\t\trequired: false,\n\t\t},\n\t\ttestCommand: {\n\t\t\t...BREAKAGE_MANUAL.optionConfigs.testCommand,\n\t\t\trequired: false,\n\t\t},\n\t\tout: {\n\t\t\tschema: configFields.out,\n\t\t\tcompletion: { repeatable: false, fileSystem: `files` },\n\t\t\trequired: false,\n\t\t\tdescription: `Gitignored snapshot path relative to the base directory (default: .breakage/baseline.json).`,\n\t\t\texample: `--out=.breakage/baseline.json`,\n\t\t},\n\t},\n)\n\nlet loadedConfigPath: string | undefined\nconst parse = cli(\n\t{\n\t\tcliName: `breakage`,\n\t\tdiscoverConfigPath: (segments: readonly string[]) => {\n\t\t\tif (segments[0] === `help` || segments[0] === `npm`) return undefined\n\t\t\tconst explicit = segments[0] === `prelude` ? segments[1] : segments[0]\n\t\t\tloadedConfigPath = configPath(\n\t\t\t\texplicit ?? defaultConfig(process.cwd()),\n\t\t\t\texplicit !== undefined,\n\t\t\t)\n\t\t\treturn loadedConfigPath\n\t\t},\n\t\troutes: optional({\n\t\t\thelp: null,\n\t\t\tnpm: optional({\n\t\t\t\thelp: null,\n\t\t\t\tcheck: null,\n\t\t\t\ttest: optional({ $peer: required({ $range: null }) }),\n\t\t\t}),\n\t\t\tprelude: optional({ $configPath: null }),\n\t\t\t$configPath: null,\n\t\t}),\n\t\trouteOptions: {\n\t\t\t\"\": BREAKAGE_MANUAL,\n\t\t\t$configPath: BREAKAGE_MANUAL,\n\t\t\thelp: noOptions(`Show usage.`),\n\t\t\tnpm: noOptions(`Show npm compatibility commands.`),\n\t\t\t\"npm/help\": noOptions(`Show npm compatibility commands.`),\n\t\t\t\"npm/check\": npmCheckManual,\n\t\t\t\"npm/test\": npmTestManual,\n\t\t\t\"npm/test/$peer/$range\": npmTestManual,\n\t\t\tprelude: PRELUDE_MANUAL,\n\t\t\t\"prelude/$configPath\": PRELUDE_MANUAL,\n\t\t},\n\t\tpositionalCompletions: {\n\t\t\t$configPath: { fileSystem: `files` },\n\t\t\t\"prelude/$configPath\": { fileSystem: `files` },\n\t\t},\n\t},\n\t{\n\t\tinfo: (message, ...data) => logger.info(`breakage`, message, data),\n\t\terror: (message, ...data) => logger.error(`breakage`, message, data),\n\t},\n)\n\nconst completion = await completionResponse(parse.definition, process.argv)\nif (completion !== undefined) {\n\tprocess.stdout.write(completion)\n} else {\n\ttry {\n\t\tconst { inputs, warnings } = await parse.async(process.argv)\n\t\tlogWarnings(warnings)\n\t\tif (\n\t\t\tprocess.argv\n\t\t\t\t.slice(2)\n\t\t\t\t.some((arg) =>\n\t\t\t\t\t/^(?:--certifyCommand|--certify-command|-c)(?:=|$)/.test(arg),\n\t\t\t\t)\n\t\t)\n\t\t\tthrow new Error(\n\t\t\t\t`certifyCommand was removed. Configure release.resolveDelta and release.policy instead.`,\n\t\t\t)\n\n\t\tswitch (inputs.case) {\n\t\t\tcase `npm`:\n\t\t\tcase `npm/help`:\n\t\t\tcase `help`:\n\t\t\t\tconsole.log(help(parse.definition))\n\t\t\t\tbreak\n\t\t\tcase `npm/check`:\n\t\t\t\tprocess.exitCode = await runNpmCli(`check`, inputs.opts)\n\t\t\t\tbreak\n\t\t\tcase `npm/test`:\n\t\t\t\tprocess.exitCode = await runNpmCli(`test`, inputs.opts)\n\t\t\t\tbreak\n\t\t\tcase `npm/test/$peer/$range`:\n\t\t\t\tprocess.exitCode = await runNpmCli(`test`, inputs.opts, inputs.params)\n\t\t\t\tbreak\n\t\t\tcase `prelude`:\n\t\t\tcase `prelude/$configPath`: {\n\t\t\t\tconst config = resolveConfig(inputs.opts, loadedConfigPath)\n\t\t\t\tconst baseline = await breakagePrelude({\n\t\t\t\t\t...config,\n\t\t\t\t\tout: config.out ?? `.breakage/baseline.json`,\n\t\t\t\t})\n\t\t\t\tprocess.stdout.write(`Pinned ${baseline.ref} at ${baseline.commit}.\\n`)\n\t\t\t\tbreak\n\t\t\t}\n\t\t\tcase ``:\n\t\t\tcase `$configPath`: {\n\t\t\t\tconst merged = resolveConfig(inputs.opts, loadedConfigPath)\n\t\t\t\tif (\n\t\t\t\t\tcommandOverrides.has(`testCommand`) &&\n\t\t\t\t\t!commandOverrides.has(`test`)\n\t\t\t\t)\n\t\t\t\t\tdelete merged.test\n\t\t\t\tif (\n\t\t\t\t\tcommandOverrides.has(`test`) &&\n\t\t\t\t\t!commandOverrides.has(`testCommand`)\n\t\t\t\t)\n\t\t\t\t\tdelete merged.testCommand\n\t\t\t\tif (!merged.testPattern)\n\t\t\t\t\tthrow new Error(`required arguments were not provided: testPattern.`)\n\t\t\t\tconst { returnValue } = await encapsulate(\n\t\t\t\t\t() =>\n\t\t\t\t\t\tbreakage({\n\t\t\t\t\t\t\t...merged,\n\t\t\t\t\t\t\ttestPattern: merged.testPattern!,\n\t\t\t\t\t\t}),\n\t\t\t\t\t{\n\t\t\t\t\t\tconsole: true,\n\t\t\t\t\t\tstdout: true,\n\t\t\t\t\t},\n\t\t\t\t)\n\t\t\t\tif (`release` in returnValue && returnValue.release) {\n\t\t\t\t\tconst { previousVersion, version, delta, breaking } =\n\t\t\t\t\t\treturnValue.release\n\t\t\t\t\tprocess.stdout.write(\n\t\t\t\t\t\t`Release: ${previousVersion} → ${version} (${delta}; ${breaking ? `breaking` : `compatible`}).\\n`,\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t\tif (`testResult` in returnValue && returnValue.breakingChangesFound) {\n\t\t\t\t\tprocess.stdout.write(returnValue.testResult)\n\t\t\t\t}\n\t\t\t\tif (`breakingChangesFound` in returnValue) {\n\t\t\t\t\tif (returnValue.breakingChangesFound) {\n\t\t\t\t\t\tif (returnValue.release?.breaking) {\n\t\t\t\t\t\t\tprocess.stdout.write(\n\t\t\t\t\t\t\t\t`👷 Breaking changes are covered by the breaking release.`,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\tprocess.exit(0)\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tprocess.stdout.write(\n\t\t\t\t\t\t\t\t`❌ Breaking changes require a breaking release.`,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\tprocess.exit(1)\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tprocess.stdout.write(`✅ No breaking changes were found.`)\n\t\t\t\t\t\tprocess.exit(0)\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tprocess.stdout.write(\n\t\t\t\t\t\t`💥 Breakage failed to determine breaking changes.` +\n\t\t\t\t\t\t\t`\\n` +\n\t\t\t\t\t\t\tinspect(returnValue),\n\t\t\t\t\t)\n\t\t\t\t\tprocess.exit(2)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tprocess.stderr.write(`Breakage setup error: ${errorMessage(error)}\\n`)\n\t\tprocess.exitCode = 2\n\t}\n}\n"],"mappings":"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"}

package/dist/changesets.d.ts

@@ -0,0 +1,8 @@
+import { c as VersionTransition, n as ReleaseDeltaContext } from "./release-D47BqRuB.js";
+/** Read the actual Changesets plan, including dependent bumps and prerelease state. */
+export declare function readChangesetsReleasePlan(directory?: string): Promise<ReadonlyMap<string, string>>;
+/** Compare the selected baseline (or current manifest) with the planned or versioned release. */
+export declare function changesetsReleaseDelta({ directory }?: {
+  directory?: string;
+}): (context: ReleaseDeltaContext) => Promise<VersionTransition>;
+//# sourceMappingURL=changesets.d.ts.map

package/dist/changesets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changesets.d.ts","names":[],"sources":["../src/changesets.ts"],"mappings":";;wBAasB,0BACrB,qBACE,QAAQ;;wBAkBK,yBACf;EACI;KACJ,SAAS,wBACL,QAAQ"}

package/dist/changesets.js

@@ -0,0 +1,27 @@
+import { s as versionTransition } from "./release-BsdIDT4g.js";
+import { assembleReleasePlan } from "@changesets/assemble-release-plan";
+import { readConfig } from "@changesets/config";
+import { readPreState } from "@changesets/pre";
+import { readChangesets } from "@changesets/read";
+import { getPackages } from "@manypkg/get-packages";
+// src/changesets.ts
+/** Read the actual Changesets plan, including dependent bumps and prerelease state. */
+async function readChangesetsReleasePlan(directory = process.cwd()) {
+	const packages = await getPackages(directory);
+	const root = packages.rootDir;
+	const { config, errors } = await readConfig(root, packages);
+	if (errors) throw new Error(errors.join(`\n`));
+	const [changesets, preState] = await Promise.all([readChangesets(root), readPreState(root)]);
+	const plan = assembleReleasePlan(changesets, packages, config, preState);
+	return new Map(plan.releases.flatMap(({ name, newVersion }) => newVersion === void 0 ? [] : [[name, newVersion]]));
+}
+/** Compare the selected baseline (or current manifest) with the planned or versioned release. */
+function changesetsReleaseDelta({ directory } = {}) {
+	return async ({ packageName, packageDirectory, currentVersion, baseline }) => {
+		const version = (await readChangesetsReleasePlan(directory ?? packageDirectory)).get(packageName) ?? currentVersion;
+		return versionTransition(baseline?.version ?? currentVersion, version);
+	};
+}
+export { changesetsReleaseDelta, readChangesetsReleasePlan };
+
+//# sourceMappingURL=changesets.js.map

package/dist/changesets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changesets.js","names":[],"sources":["../src/changesets.ts"],"sourcesContent":["import { assembleReleasePlan } from \"@changesets/assemble-release-plan\"\nimport { readConfig } from \"@changesets/config\"\nimport { readPreState } from \"@changesets/pre\"\nimport { readChangesets } from \"@changesets/read\"\nimport { getPackages } from \"@manypkg/get-packages\"\n\nimport {\n\tversionTransition,\n\ttype ReleaseDeltaContext,\n\ttype VersionTransition,\n} from \"./release.ts\"\n\n/** Read the actual Changesets plan, including dependent bumps and prerelease state. */\nexport async function readChangesetsReleasePlan(\n\tdirectory: string = process.cwd(),\n): Promise<ReadonlyMap<string, string>> {\n\tconst packages = await getPackages(directory)\n\tconst root = packages.rootDir\n\tconst { config, errors } = await readConfig(root, packages)\n\tif (errors) throw new Error(errors.join(`\\n`))\n\tconst [changesets, preState] = await Promise.all([\n\t\treadChangesets(root),\n\t\treadPreState(root),\n\t])\n\tconst plan = assembleReleasePlan(changesets, packages, config, preState)\n\treturn new Map(\n\t\tplan.releases.flatMap(({ name, newVersion }) =>\n\t\t\tnewVersion === undefined ? [] : [[name, newVersion] as const],\n\t\t),\n\t)\n}\n\n/** Compare the selected baseline (or current manifest) with the planned or versioned release. */\nexport function changesetsReleaseDelta({\n\tdirectory,\n}: { directory?: string } = {}): (\n\tcontext: ReleaseDeltaContext,\n) => Promise<VersionTransition> {\n\treturn async ({\n\t\tpackageName,\n\t\tpackageDirectory,\n\t\tcurrentVersion,\n\t\tbaseline,\n\t}) => {\n\t\tconst version =\n\t\t\t(await readChangesetsReleasePlan(directory ?? packageDirectory)).get(\n\t\t\t\tpackageName,\n\t\t\t) ?? currentVersion\n\t\treturn versionTransition(baseline?.version ?? currentVersion, version)\n\t}\n}\n"],"mappings":";;;;;;;;AAaA,eAAsB,0BACrB,YAAoB,QAAQ,IAAI,GACO;CACvC,MAAM,WAAW,MAAM,YAAY,SAAS;CAC5C,MAAM,OAAO,SAAS;CACtB,MAAM,EAAE,QAAQ,WAAW,MAAM,WAAW,MAAM,QAAQ;CAC1D,IAAI,QAAQ,MAAM,IAAI,MAAM,OAAO,KAAK,IAAI,CAAC;CAC7C,MAAM,CAAC,YAAY,YAAY,MAAM,QAAQ,IAAI,CAChD,eAAe,IAAI,GACnB,aAAa,IAAI,CAClB,CAAC;CACD,MAAM,OAAO,oBAAoB,YAAY,UAAU,QAAQ,QAAQ;CACvE,OAAO,IAAI,IACV,KAAK,SAAS,SAAS,EAAE,MAAM,iBAC9B,eAAe,KAAA,IAAY,CAAC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAU,CAC7D,CACD;AACD;;AAGA,SAAgB,uBAAuB,EACtC,cAC2B,CAAC,GAEG;CAC/B,OAAO,OAAO,EACb,aACA,kBACA,gBACA,eACK;EACL,MAAM,WACJ,MAAM,0BAA0B,aAAa,gBAAgB,EAAA,CAAG,IAChE,WACD,KAAK;EACN,OAAO,kBAAkB,UAAU,WAAW,gBAAgB,OAAO;CACtE;AACD"}

package/dist/release-BsdIDT4g.js

@@ -0,0 +1,69 @@
+import semver from "semver";
+import { type } from "arktype";
+// src/release.ts
+const releaseSchema = type({
+	"+": `reject`,
+	"resolveDelta?": type(`Function`).as(),
+	"policy?": type(`Function`).as()
+});
+/** Choose which version increments permit breaking changes. Prerelease-only increments do not. */
+function semverPolicy({ beforeV1 = `major` } = {}) {
+	if (![
+		`major`,
+		`minor`,
+		`patch`
+	].includes(beforeV1)) throw new Error(`Invalid beforeV1 policy.`);
+	return ({ previousVersion, version }) => {
+		const previous = new semver.SemVer(previousVersion);
+		const next = new semver.SemVer(version);
+		if (next.major > previous.major) return true;
+		if (previous.major !== 0 || beforeV1 === `major`) return false;
+		return next.minor > previous.minor || beforeV1 === `patch` && next.patch > previous.patch;
+	};
+}
+/** Describe a version transition without deciding whether it permits breakage. */
+function versionTransition(previousVersion, version) {
+	if (!semver.valid(previousVersion) || !semver.valid(version)) throw new Error(`Expected exact semantic versions.`);
+	return {
+		previousVersion,
+		version,
+		delta: semver.diff(previousVersion, version) ?? `none`
+	};
+}
+/** Pure comparison; equal and older versions never permit breaking changes. */
+function versionDelta(previousVersion, version, policy = semverPolicy()) {
+	const evidence = versionTransition(previousVersion, version);
+	const breaking = semver.gt(version, previousVersion) ? policy(evidence) : false;
+	if (typeof breaking !== `boolean`) throw new Error(`Release policy must return a boolean.`);
+	return {
+		...evidence,
+		breaking
+	};
+}
+function validateRelease(value) {
+	if (typeof value !== `object` || value === null || Array.isArray(value)) throw new Error(`release must be an object.`);
+	if (`version` in value) throw new Error(`release.version was removed. Use release.resolveDelta to return a version transition.`);
+	releaseSchema.assert(value);
+}
+/** Resolve and validate release evidence; policy is applied separately. */
+async function resolveReleaseDelta(config, context) {
+	validateRelease(config);
+	const transition = config.resolveDelta ? await config.resolveDelta(context) : versionTransition(context.baseline?.version ?? context.currentVersion, context.currentVersion);
+	if (transition === void 0) return void 0;
+	if (typeof transition !== `object` || transition === null || Array.isArray(transition) || typeof transition.previousVersion !== `string` || !semver.valid(transition.previousVersion) || typeof transition.version !== `string` || !semver.valid(transition.version) || !semver.valid(context.currentVersion) || semver.lt(transition.version, context.currentVersion)) throw new Error(`Invalid release transition for ${context.packageName}; expected exact versions and a current/newer target.`);
+	if (context.baseline && transition.previousVersion !== context.baseline.version) throw new Error(`Release transition for ${context.packageName} does not match the selected baseline.`);
+	const evidence = versionTransition(transition.previousVersion, transition.version);
+	if (transition.delta !== evidence.delta) throw new Error(`Release transition for ${context.packageName} has an inconsistent semver delta.`);
+	return evidence;
+}
+/** Removed hooks must fail explicitly, including in untyped configurations. */
+function rejectCertificationOptions(value) {
+	for (const key of [
+		`certifyCommand`,
+		`releaseIntent`,
+		`certifyBreaking`
+	]) if (key in value) throw new Error(`${key} was removed. Use release.resolveDelta and release.policy instead.`);
+}
+export { validateRelease as a, semverPolicy as i, releaseSchema as n, versionDelta as o, resolveReleaseDelta as r, versionTransition as s, rejectCertificationOptions as t };
+
+//# sourceMappingURL=release-BsdIDT4g.js.map

package/dist/release-BsdIDT4g.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-BsdIDT4g.js","names":[],"sources":["../src/release.ts"],"sourcesContent":["// cspell:words premajor preminor prepatch\nimport semver from \"semver\"\nimport { type } from \"arktype\"\n\nexport type ReleaseDeltaContext = {\n\tpackageName: string\n\tpackageDirectory: string\n\tcurrentVersion: string\n\t/** The selected historical release, when checking compatibility. */\n\tbaseline?: { version: string; ref?: string; commit?: string }\n}\nexport type VersionTransition = {\n\tpreviousVersion: string\n\tversion: string\n\tdelta:\n\t\t| `major`\n\t\t| `premajor`\n\t\t| `minor`\n\t\t| `preminor`\n\t\t| `patch`\n\t\t| `prepatch`\n\t\t| `prerelease`\n\t\t| `release`\n\t\t| `none`\n}\nexport type ReleaseDeltaResolver = (\n\tcontext: ReleaseDeltaContext,\n) => VersionTransition | undefined | Promise<VersionTransition | undefined>\nexport type VersionDelta = VersionTransition & { breaking: boolean }\nexport type SemverPolicyOptions = { beforeV1?: `major` | `minor` | `patch` }\nexport type ReleasePolicyFunction = (delta: VersionTransition) => boolean\nexport type ReleasePolicy = ReleasePolicyFunction\nexport const releaseSchema = type({\n\t\"+\": `reject`,\n\t\"resolveDelta?\": type(`Function`).as<ReleaseDeltaResolver>(),\n\t\"policy?\": type(`Function`).as<ReleasePolicy>(),\n})\nexport type ReleaseConfig = typeof releaseSchema.infer\n\n/** Choose which version increments permit breaking changes. Prerelease-only increments do not. */\nexport function semverPolicy({\n\tbeforeV1 = `major`,\n}: SemverPolicyOptions = {}): ReleasePolicyFunction {\n\tif (![`major`, `minor`, `patch`].includes(beforeV1))\n\t\tthrow new Error(`Invalid beforeV1 policy.`)\n\treturn ({ previousVersion, version }) => {\n\t\tconst previous = new semver.SemVer(previousVersion)\n\t\tconst next = new semver.SemVer(version)\n\t\tif (next.major > previous.major) return true\n\t\tif (previous.major !== 0 || beforeV1 === `major`) return false\n\t\treturn (\n\t\t\tnext.minor > previous.minor ||\n\t\t\t(beforeV1 === `patch` && next.patch > previous.patch)\n\t\t)\n\t}\n}\n\n/** Describe a version transition without deciding whether it permits breakage. */\nexport function versionTransition(\n\tpreviousVersion: string,\n\tversion: string,\n): VersionTransition {\n\tif (!semver.valid(previousVersion) || !semver.valid(version))\n\t\tthrow new Error(`Expected exact semantic versions.`)\n\treturn {\n\t\tpreviousVersion,\n\t\tversion,\n\t\tdelta: semver.diff(previousVersion, version) ?? `none`,\n\t}\n}\n\n/** Pure comparison; equal and older versions never permit breaking changes. */\nexport function versionDelta(\n\tpreviousVersion: string,\n\tversion: string,\n\tpolicy: ReleasePolicy = semverPolicy(),\n): VersionDelta {\n\tconst evidence = versionTransition(previousVersion, version)\n\tconst breaking = semver.gt(version, previousVersion)\n\t\t? policy(evidence)\n\t\t: false\n\tif (typeof breaking !== `boolean`)\n\t\tthrow new Error(`Release policy must return a boolean.`)\n\treturn { ...evidence, breaking }\n}\n\nexport function validateRelease(\n\tvalue: unknown,\n): asserts value is ReleaseConfig {\n\tif (typeof value !== `object` || value === null || Array.isArray(value))\n\t\tthrow new Error(`release must be an object.`)\n\tif (`version` in value)\n\t\tthrow new Error(\n\t\t\t`release.version was removed. Use release.resolveDelta to return a version transition.`,\n\t\t)\n\treleaseSchema.assert(value)\n}\n\n/** Resolve and validate release evidence; policy is applied separately. */\nexport async function resolveReleaseDelta(\n\tconfig: ReleaseConfig,\n\tcontext: ReleaseDeltaContext,\n): Promise<VersionTransition | undefined> {\n\tvalidateRelease(config)\n\tconst transition = config.resolveDelta\n\t\t? await config.resolveDelta(context)\n\t\t: versionTransition(\n\t\t\t\tcontext.baseline?.version ?? context.currentVersion,\n\t\t\t\tcontext.currentVersion,\n\t\t\t)\n\tif (transition === undefined) return undefined\n\tif (\n\t\ttypeof transition !== `object` ||\n\t\ttransition === null ||\n\t\tArray.isArray(transition) ||\n\t\ttypeof transition.previousVersion !== `string` ||\n\t\t!semver.valid(transition.previousVersion) ||\n\t\ttypeof transition.version !== `string` ||\n\t\t!semver.valid(transition.version) ||\n\t\t!semver.valid(context.currentVersion) ||\n\t\tsemver.lt(transition.version, context.currentVersion)\n\t)\n\t\tthrow new Error(\n\t\t\t`Invalid release transition for ${context.packageName}; expected exact versions and a current/newer target.`,\n\t\t)\n\tif (\n\t\tcontext.baseline &&\n\t\ttransition.previousVersion !== context.baseline.version\n\t)\n\t\tthrow new Error(\n\t\t\t`Release transition for ${context.packageName} does not match the selected baseline.`,\n\t\t)\n\tconst evidence = versionTransition(\n\t\ttransition.previousVersion,\n\t\ttransition.version,\n\t)\n\tif (transition.delta !== evidence.delta)\n\t\tthrow new Error(\n\t\t\t`Release transition for ${context.packageName} has an inconsistent semver delta.`,\n\t\t)\n\t// Only evidence crosses this boundary; resolver-supplied policy decisions are ignored.\n\treturn evidence\n}\n\n/** Removed hooks must fail explicitly, including in untyped configurations. */\nexport function rejectCertificationOptions(value: object): void {\n\tfor (const key of [`certifyCommand`, `releaseIntent`, `certifyBreaking`]) {\n\t\tif (key in value)\n\t\t\tthrow new Error(\n\t\t\t\t`${key} was removed. Use release.resolveDelta and release.policy instead.`,\n\t\t\t)\n\t}\n}\n"],"mappings":";;;AAgCA,MAAa,gBAAgB,KAAK;CACjC,KAAK;CACL,iBAAiB,KAAK,UAAU,CAAC,CAAC,GAAyB;CAC3D,WAAW,KAAK,UAAU,CAAC,CAAC,GAAkB;AAC/C,CAAC;;AAID,SAAgB,aAAa,EAC5B,WAAW,YACa,CAAC,GAA0B;CACnD,IAAI,CAAC;EAAC;EAAS;EAAS;CAAO,CAAC,CAAC,SAAS,QAAQ,GACjD,MAAM,IAAI,MAAM,0BAA0B;CAC3C,QAAQ,EAAE,iBAAiB,cAAc;EACxC,MAAM,WAAW,IAAI,OAAO,OAAO,eAAe;EAClD,MAAM,OAAO,IAAI,OAAO,OAAO,OAAO;EACtC,IAAI,KAAK,QAAQ,SAAS,OAAO,OAAO;EACxC,IAAI,SAAS,UAAU,KAAK,aAAa,SAAS,OAAO;EACzD,OACC,KAAK,QAAQ,SAAS,SACrB,aAAa,WAAW,KAAK,QAAQ,SAAS;CAEjD;AACD;;AAGA,SAAgB,kBACf,iBACA,SACoB;CACpB,IAAI,CAAC,OAAO,MAAM,eAAe,KAAK,CAAC,OAAO,MAAM,OAAO,GAC1D,MAAM,IAAI,MAAM,mCAAmC;CACpD,OAAO;EACN;EACA;EACA,OAAO,OAAO,KAAK,iBAAiB,OAAO,KAAK;CACjD;AACD;;AAGA,SAAgB,aACf,iBACA,SACA,SAAwB,aAAa,GACtB;CACf,MAAM,WAAW,kBAAkB,iBAAiB,OAAO;CAC3D,MAAM,WAAW,OAAO,GAAG,SAAS,eAAe,IAChD,OAAO,QAAQ,IACf;CACH,IAAI,OAAO,aAAa,WACvB,MAAM,IAAI,MAAM,uCAAuC;CACxD,OAAO;EAAE,GAAG;EAAU;CAAS;AAChC;AAEA,SAAgB,gBACf,OACiC;CACjC,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACrE,MAAM,IAAI,MAAM,4BAA4B;CAC7C,IAAI,aAAa,OAChB,MAAM,IAAI,MACT,uFACD;CACD,cAAc,OAAO,KAAK;AAC3B;;AAGA,eAAsB,oBACrB,QACA,SACyC;CACzC,gBAAgB,MAAM;CACtB,MAAM,aAAa,OAAO,eACvB,MAAM,OAAO,aAAa,OAAO,IACjC,kBACA,QAAQ,UAAU,WAAW,QAAQ,gBACrC,QAAQ,cACT;CACF,IAAI,eAAe,KAAA,GAAW,OAAO,KAAA;CACrC,IACC,OAAO,eAAe,YACtB,eAAe,QACf,MAAM,QAAQ,UAAU,KACxB,OAAO,WAAW,oBAAoB,YACtC,CAAC,OAAO,MAAM,WAAW,eAAe,KACxC,OAAO,WAAW,YAAY,YAC9B,CAAC,OAAO,MAAM,WAAW,OAAO,KAChC,CAAC,OAAO,MAAM,QAAQ,cAAc,KACpC,OAAO,GAAG,WAAW,SAAS,QAAQ,cAAc,GAEpD,MAAM,IAAI,MACT,kCAAkC,QAAQ,YAAY,sDACvD;CACD,IACC,QAAQ,YACR,WAAW,oBAAoB,QAAQ,SAAS,SAEhD,MAAM,IAAI,MACT,0BAA0B,QAAQ,YAAY,uCAC/C;CACD,MAAM,WAAW,kBAChB,WAAW,iBACX,WAAW,OACZ;CACA,IAAI,WAAW,UAAU,SAAS,OACjC,MAAM,IAAI,MACT,0BAA0B,QAAQ,YAAY,mCAC/C;CAED,OAAO;AACR;;AAGA,SAAgB,2BAA2B,OAAqB;CAC/D,KAAK,MAAM,OAAO;EAAC;EAAkB;EAAiB;CAAiB,GACtE,IAAI,OAAO,OACV,MAAM,IAAI,MACT,GAAG,IAAI,mEACR;AAEH"}

package/dist/release-D47BqRuB.d.ts

@@ -0,0 +1,40 @@
+type ReleaseDeltaContext = {
+  packageName: string;
+  packageDirectory: string;
+  currentVersion: string;
+  /** The selected historical release, when checking compatibility. */
+  baseline?: {
+    version: string;
+    ref?: string;
+    commit?: string;
+  };
+};
+type VersionTransition = {
+  previousVersion: string;
+  version: string;
+  delta: `major` | `premajor` | `minor` | `preminor` | `patch` | `prepatch` | `prerelease` | `release` | `none`;
+};
+type ReleaseDeltaResolver = (context: ReleaseDeltaContext) => VersionTransition | undefined | Promise<VersionTransition | undefined>;
+type VersionDelta = VersionTransition & {
+  breaking: boolean;
+};
+type SemverPolicyOptions = {
+  beforeV1?: `major` | `minor` | `patch`;
+};
+type ReleasePolicyFunction = (delta: VersionTransition) => boolean;
+type ReleasePolicy = ReleasePolicyFunction;
+declare const releaseSchema: import("arktype/internal/variants/object.ts").ObjectType<{
+  resolveDelta?: ReleaseDeltaResolver;
+  policy?: ReleasePolicyFunction;
+}, {}>;
+type ReleaseConfig = typeof releaseSchema.infer;
+/** Choose which version increments permit breaking changes. Prerelease-only increments do not. */
+declare function semverPolicy({ beforeV1 }?: SemverPolicyOptions): ReleasePolicyFunction;
+/** Describe a version transition without deciding whether it permits breakage. */
+declare function versionTransition(previousVersion: string, version: string): VersionTransition;
+/** Pure comparison; equal and older versions never permit breaking changes. */
+declare function versionDelta(previousVersion: string, version: string, policy?: ReleasePolicy): VersionDelta;
+/** Resolve and validate release evidence; policy is applied separately. */
+declare function resolveReleaseDelta(config: ReleaseConfig, context: ReleaseDeltaContext): Promise<VersionTransition | undefined>;
+export { ReleasePolicyFunction as a, VersionTransition as c, versionDelta as d, versionTransition as f, ReleasePolicy as i, resolveReleaseDelta as l, ReleaseDeltaContext as n, SemverPolicyOptions as o, ReleaseDeltaResolver as r, VersionDelta as s, ReleaseConfig as t, semverPolicy as u };
+//# sourceMappingURL=release-D47BqRuB.d.ts.map

package/dist/release-D47BqRuB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-D47BqRuB.d.ts","names":[],"sources":["../src/release.ts"],"mappings":"A,KAIY;EACX;EACA;EACA;;EAEA;IAAa;IAAiB;IAAc;;;KAEjC;EACX;EACA;EACA;;KAWW,wBACX,SAAS,wBACL,gCAAgC,QAAQ;KACjC,eAAe;EAAsB;;KACrC;EAAwB;;KACxB,yBAAyB,OAAO;KAChC,gBAAgB;cACf,6DAAa;;;;KAKd,uBAAuB,cAAc;;iBAGjC,eACf,aACE,sBAA2B;;iBAgBd,kBACf,yBACA,kBACE;;iBAWa,aACf,yBACA,iBACA,SAAQ,gBACN;;iBAuBmB,oBACrB,QAAQ,eACR,SAAS,sBACP,QAAQ"}