@wpelevator/wp-release 0.9.0 → 0.11.0

package/dist/changeset-release.js

@@ -1,501 +1,418 @@
-import { randomUUID } from 'node:crypto';
-import { execFile } from 'node:child_process';
-import { access, mkdir, readdir, readFile, rm, writeFile, } from 'node:fs/promises';
 import path from 'node:path';
-import { promisify } from 'node:util';
+import { getVersionedReleases, prependChangelog } from "./changelog.js";
 import { loadChangesetConfig } from "./changeset-config.js";
-import { findMainPluginFile } from "./package-meta.js";
-import { findConstantValues } from "./version-check.js";
-import { formatChangelogList, formatChangeset, getChangesetBump, getNextVersion, parseChangeset, } from "./changesets.js";
+import { applyDependents, assertDependentsSourcesReleased, collectPinDriftWarnings, expandDependentsPlan, findBundledPinChanges, hasChangeset, selectReleasePlan, stripDependentsPlan, updateDependencyDeclaration, } from "./changeset-dependents.js";
+import { consumeChangeset, readChangesets, readChangesetsSince, writeChangeset, } from "./changeset-files.js";
+import { assertKnownPackages, discoverPackages, getChangedPackages, toChangesetPackage, } from "./changeset-packages.js";
+import { getChangesetBump, getNextVersion } from "./changesets.js";
 import { ValidationError } from "./errors.js";
-const execFileAsync = promisify(execFile);
+import { FileJournal } from "./file-journal.js";
+import { getPreviousTag, getReleaseNotes, getTagVersion, selectTagPackages, } from "./release-tags.js";
+import { ReleaseRepository } from "./release-repository.js";
+import { formatTag } from "./tag-format.js";
+import { verifyVersionTargets, writeVersion } from "./version-files.js";
+import { isPrerelease } from "./versions.js";
+const MISSING_CONFIG = 'No wp-release config found. Add wp-release.config.js or pass --config <path>.';
 /**
- * Discover configured packages, pending changesets, and their proposed versions.
+ * Changeset releases of a repository: recording changesets, versioning the
+ * packages they name and tagging the releases.
  *
- * @param input Repository root and optional explicit config file.
- * @return A release plan; `undefined` when no config is present.
+ * Each operation loads the configuration, discovers the packages and reads the
+ * pending changesets again, so that one instance can version and then tag.
+ * Git runs through the injected runner.
  */
-export async function getChangesetReleasePlan(input) {
-    const context = await getReleaseContext(input);
-    return context?.plan;
-}
-/**
- * Discover the packages of the repository configuration.
- *
- * @param  input Repository root and optional explicit config file.
- * @return Packages in the configured order with their current versions.
- * @throws {ValidationError} Without a config, or for an invalid one.
- */
-export async function getChangesetPackages(input) {
-    const loaded = await requireConfig(input);
-    const packages = await discoverPackages(input.cwd, loaded.config);
-    return packages.map(toChangesetPackage);
-}
-async function getReleaseContext(input) {
-    const loaded = await loadChangesetConfig(input);
-    if (!loaded) {
-        return undefined;
+export class ChangesetRelease {
+    cwd;
+    configFile;
+    repository;
+    /**
+     * @param options Repository root, config file and git runner.
+     */
+    constructor(options) {
+        this.cwd = options.cwd;
+        this.configFile = options.configFile;
+        this.repository = new ReleaseRepository({
+            cwd: options.cwd,
+            runner: options.git,
+        });
     }
-    const config = loaded.config;
-    const packages = await discoverPackages(input.cwd, config);
-    const changesets = await readChangesets(input.cwd, config);
-    const releases = [];
-    packages.forEach((pkg) => {
-        const bump = getChangesetBump(changesets, pkg.name);
-        if (bump) {
-            const packageChangesets = changesets.filter((changeset) => Object.hasOwn(changeset.packages, pkg.name));
-            const nextVersion = config.nextVersion
-                ? config.nextVersion({
-                    package: pkg,
-                    bump,
-                    currentVersion: pkg.currentVersion,
-                    changesets: packageChangesets,
-                })
-                : getNextVersion(pkg.currentVersion, bump);
-            if ('string' !== typeof nextVersion || !nextVersion.trim()) {
-                throw new ValidationError(`The nextVersion strategy returned an empty version for package "${pkg.name}".`);
+    /**
+     * Discover configured packages, pending changesets, and their proposed
+     * versions.
+     *
+     * @return A release plan; `undefined` when no config is present.
+     */
+    async getPlan() {
+        const context = await this.loadContext();
+        return context?.plan;
+    }
+    /**
+     * Discover the packages of the repository configuration.
+     *
+     * @return Packages in the configured order with their current versions.
+     * @throws {ValidationError} Without a config, or for an invalid one.
+     */
+    async getPackages() {
+        const config = await this.requireConfig();
+        const packages = await discoverPackages(this.repository, config);
+        return packages.map(toChangesetPackage);
+    }
+    /**
+     * Create a Changesets-compatible Markdown file.
+     *
+     * @param  options Packages, summary and file name.
+     * @return Created file path.
+     * @throws {ValidationError} For unknown packages or an existing file.
+     */
+    async add(options) {
+        const config = await this.requireConfig();
+        const packages = await discoverPackages(this.repository, config);
+        assertKnownPackages(packages, Object.keys(options.packages));
+        return writeChangeset(this.getChangesetDirectory(config), options.packages, options.summary, options.name);
+    }
+    /**
+     * Apply pending package versions and changelogs. A failed run restores
+     * every file it changed.
+     *
+     * @param  options Versioning options.
+     * @return Planned releases and whether files were changed.
+     * @throws {ValidationError} Without a config, or for an invalid plan.
+     */
+    async version(options = {}) {
+        const context = await this.requireContext();
+        const { config, packages } = context;
+        const withDependents = options.dependents ?? true;
+        let releasePlan = context.plan;
+        if (options.packages) {
+            releasePlan = expandDependentsPlan(await selectReleasePlan(context.plan, packages, options.packages, config, withDependents));
+        }
+        else if (!withDependents) {
+            releasePlan = stripDependentsPlan(context.plan);
+        }
+        // A dependent must not release while one of the packages it depends on has
+        // pending changesets that aren't released in the same run, or it would
+        // bundle unreleased code under a changelog that cannot credit it. The
+        // check only applies to repositories that adopted the dependents policy.
+        if (withDependents && config.dependents) {
+            await assertDependentsSourcesReleased(releasePlan, context.plan, packages, config);
+        }
+        const date = options.date ?? new Date().toISOString().slice(0, 10);
+        const releases = await getVersionedReleases(this.repository, config, releasePlan.releases, this.getChangesetDirectory(config));
+        if (!options.dryRun) {
+            await this.writeReleases(context, releasePlan, releases, date, options.packages);
+        }
+        return {
+            changesets: releasePlan.changesets,
+            releases,
+            date,
+            changed: !options.dryRun &&
+                (releasePlan.changesets.length > 0 ||
+                    releasePlan.releases.length > 0),
+        };
+    }
+    /**
+     * Create missing release tags, optionally pushing them to the origin
+     * remote. Each tag comes with the title and notes of its release, for a
+     * workflow step to create the GitHub Release.
+     *
+     * @param  options Tag options.
+     * @return Per-package tags and release notes.
+     * @throws {ValidationError} For conflicting options, unknown packages or version mismatches.
+     */
+    async tag(options = {}) {
+        if (options.untagged && options.push) {
+            throw new ValidationError('Listing untagged releases cannot be combined with pushing tags.');
+        }
+        const context = await this.requireContext();
+        const selected = selectTagPackages(context.packages, options.packages ?? [], options.version);
+        const packages = options.since
+            ? (await getChangedPackages(this.repository, selected, options.since)).packages
+            : selected;
+        const results = [];
+        const dryRun = options.dryRun || options.untagged;
+        const tagFormat = context.config.tagFormat ?? '{path}/{version}';
+        for (const pkg of packages) {
+            const version = await getTagVersion(pkg, options.version);
+            if (undefined !== options.version &&
+                options.version !== version) {
+                throw new ValidationError(`Package "${pkg.name}" is at version ${version}, not ${options.version}.`);
+            }
+            const tag = formatTag(tagFormat, pkg, version);
+            const exists = await this.repository.tagExists(tag);
+            if (!exists) {
+                await verifyVersionTargets(this.repository, pkg, version);
             }
-            releases.push({
-                package: pkg,
-                bump,
-                currentVersion: pkg.currentVersion,
-                nextVersion,
-                changesets: packageChangesets,
+            const previousTag = await getPreviousTag(this.repository, formatTag(tagFormat, pkg, ''), version);
+            const notes = await getReleaseNotes(this.repository, context.config, pkg, { version, tag, previousTag }, exists ? tag : 'HEAD');
+            if (!exists && !dryRun) {
+                await this.repository.createTag(tag);
+            }
+            results.push({
+                package: pkg.name,
+                version,
+                tag,
+                title: `${pkg.name}@${version}`,
+                ...(previousTag ? { previousTag } : {}),
+                prerelease: isPrerelease(version),
+                exists,
+                created: !exists && !dryRun,
+                notes,
             });
         }
-    });
-    changesets.forEach((changeset) => {
-        Object.keys(changeset.packages).forEach((name) => {
-            if (!packages.some((pkg) => pkg.name === name)) {
-                throw new ValidationError(`Changeset ${changeset.fileName} refers to unknown package "${name}".`);
+        // Push one tag at a time because GitHub doesn't create push events for
+        // tags when more than three are pushed at once.
+        if (options.push && !dryRun) {
+            for (const item of results.filter((result) => result.created)) {
+                await this.repository.pushTag(item.tag);
             }
-        });
-    });
-    return { config, packages, plan: { changesets, releases } };
-}
-/**
- * Create a Changesets-compatible Markdown file.
- *
- * @param input Repository, packages and summary.
- * @return Created file path.
- */
-export async function addChangeset(input) {
-    const loaded = await requireConfig(input);
-    const packages = await discoverPackages(input.cwd, loaded.config);
-    Object.keys(input.packages).forEach((name) => {
-        if (!packages.some((pkg) => pkg.name === name)) {
-            throw new ValidationError(`Unknown package "${name}".`);
         }
-    });
-    const directory = path.resolve(input.cwd, loaded.config.changesets ?? '.changeset');
-    await mkdir(directory, { recursive: true });
-    const fileName = `${input.name ?? randomUUID().slice(0, 8)}.md`;
-    const file = path.join(directory, fileName);
-    let exists = false;
-    try {
-        await access(file);
-        exists = true;
-    }
-    catch (error) {
-        if ('ENOENT' !== error.code) {
-            throw error;
-        }
-    }
-    if (exists) {
-        throw new ValidationError(`Changeset ${fileName} already exists.`);
-    }
-    const entries = Object.entries(input.packages)
-        .sort((a, b) => a[0].localeCompare(b[0]))
-        .map(([name, bump]) => `${JSON.stringify(name)}: ${bump}`)
-        .join('\n');
-    await writeFile(file, `---\n${entries}\n---\n\n${input.summary.trim()}\n`);
-    return file;
-}
-/**
- * Apply pending package versions and changelogs.
- *
- * @param input Repository and versioning options.
- * @return Planned releases and whether files were changed.
- */
-export async function versionChangesets(input) {
-    const context = await getReleaseContext(input);
-    if (!context) {
-        throw new ValidationError('No wp-release config found. Add wp-release.config.js or pass --config <path>.');
-    }
-    const { config, packages } = context;
-    const releasePlan = input.packages
-        ? selectReleasePlan(context.plan, packages, input.packages)
-        : context.plan;
-    const date = input.date ?? new Date().toISOString().slice(0, 10);
-    const changesetDirectory = path.resolve(input.cwd, config.changesets ?? '.changeset');
-    const releases = await getVersionedReleases(input.cwd, config, releasePlan.releases, changesetDirectory);
-    if (!input.dryRun) {
-        const journal = new Map();
+        return {
+            tags: options.untagged
+                ? results.filter((result) => !result.exists)
+                : results,
+        };
+    }
+    /**
+     * Check whether changed files belong to packages without a changeset.
+     *
+     * @param  options Base git ref.
+     * @return Changed packages and missing changeset identifiers.
+     * @throws {ValidationError} Without a config.
+     */
+    async getStatus(options = {}) {
+        const { config, packages, plan } = await this.requireContext();
+        const { changesets, releases } = plan;
+        const since = options.since ??
+            (config.baseBranch ? `origin/${config.baseBranch}` : undefined);
+        const changed = since
+            ? await getChangedPackages(this.repository, packages, since)
+            : { packages: [], filesByPackage: {} };
+        const changedPackages = changed.packages.map((pkg) => pkg.name);
+        const changesetsInDiff = since
+            ? await readChangesetsSince(this.repository, this.getChangesetDirectory(config), changesets, since)
+            : [];
+        const hasEmptyChangeset = changesetsInDiff.some((changeset) => 0 === Object.keys(changeset.packages).length);
+        const bundled = await findBundledPinChanges(changed, changesetsInDiff, packages, config);
+        const missingChangesets = hasEmptyChangeset
+            ? []
+            : changedPackages.filter((name) => !hasChangeset(changesetsInDiff, name) &&
+                !bundled.has(name));
+        // A pin that doesn't resolve the local package selects a registry release
+        // instead, which the dependents policy won't re-release automatically.
+        const warnings = config.dependents
+            ? await collectPinDriftWarnings(config, packages)
+            : [];
+        return {
+            changesets,
+            releases,
+            changedPackages,
+            changedPackageFiles: changed.filesByPackage,
+            missingChangesets,
+            warnings,
+        };
+    }
+    /**
+     * Write the versions, dependency specs and changelogs of the releases and
+     * consume the applied changesets, restoring every changed file when a
+     * step fails.
+     *
+     * @param context  Release context.
+     * @param plan     Selected release plan.
+     * @param releases Releases with their changelog entries.
+     * @param date     Release date, as YYYY-MM-DD.
+     * @param applied  Versioned packages, or undefined when all were versioned.
+     */
+    async writeReleases(context, plan, releases, date, applied) {
+        const journal = new FileJournal();
+        const changesetDirectory = this.getChangesetDirectory(context.config);
         try {
             for (const release of releases) {
-                const configured = packages.find((pkg) => pkg.name === release.package.name);
-                if (!configured) {
-                    throw new ValidationError(`Unknown package "${release.package.name}".`);
-                }
-                for (const target of configured.versionConfig.to) {
-                    await writeVersion(configured.directory, target, release.nextVersion, journal);
-                }
-                await verifyVersionTargets(input.cwd, configured, release.nextVersion);
-                await prependChangelog(configured.directory, release, date, config.readmeChangelog ?? false, config.changelogInsertAfter, journal);
+                await this.writeRelease(context, plan, release, date, journal);
             }
-            for (const changeset of releasePlan.changesets) {
-                await consumeChangeset(path.join(changesetDirectory, changeset.fileName), changeset, input.packages, journal);
+            for (const changeset of plan.changesets) {
+                await consumeChangeset(path.join(changesetDirectory, changeset.fileName), changeset, applied, journal);
             }
         }
         catch (error) {
-            const rollbackErrors = await restoreFileJournal(journal);
+            const rollbackErrors = await journal.restore();
             if (rollbackErrors.length) {
                 throw new AggregateError([error, ...rollbackErrors], 'Changeset versioning failed and one or more file changes could not be rolled back.');
             }
             throw error;
         }
     }
-    return {
-        changesets: releasePlan.changesets,
-        releases,
-        date,
-        changed: !input.dryRun && releasePlan.changesets.length > 0,
-    };
-}
-/**
- * Format the changelog entries of each release, with the configured
- * formatter and the commit that added each changeset.
- *
- * @param cwd                Repository root.
- * @param config             Repository release configuration.
- * @param releases           Package releases.
- * @param changesetDirectory Directory of the changeset files.
- * @return Releases with their changelog entries.
- */
-async function getVersionedReleases(cwd, config, releases, changesetDirectory) {
-    const commits = new Map();
-    const getCommit = (changeset) => {
-        const cached = commits.get(changeset.fileName) ??
-            getChangesetCommit(cwd, path.join(changesetDirectory, changeset.fileName));
-        commits.set(changeset.fileName, cached);
-        return cached;
-    };
-    return Promise.all(releases.map(async (release) => {
-        const entries = [];
-        // Format one at a time, so that formatters calling an API aren't rate limited.
-        for (const changeset of release.changesets) {
-            entries.push(await getChangelogEntry(config, release.package, changeset, getCommit));
-        }
-        return { ...release, changelog: formatChangelogList(entries) };
-    }));
-}
-async function getChangelogEntry(config, pkg, changeset, getCommit) {
-    const summary = changeset.summary.trim();
-    if (!summary || !config.changelogEntry) {
-        return summary;
-    }
-    const commit = await getCommit(changeset);
-    const entry = await config.changelogEntry({
-        package: pkg,
-        changeset,
-        ...(commit ? { commit } : {}),
-    });
-    if ('string' !== typeof entry) {
-        throw new ValidationError(`The changelogEntry formatter didn't return a string for changeset ${changeset.fileName}.`);
-    }
-    return entry.trim();
-}
-/**
- * Find the commit that added a changeset file.
- *
- * @param cwd  Repository root.
- * @param file Changeset file.
- * @return Commit, or undefined when the file isn't committed.
- */
-async function getChangesetCommit(cwd, file) {
-    const output = await git(cwd, [
-        'log',
-        '--diff-filter=A',
-        '--format=%H%x1f%h%x1f%s',
-        '-1',
-        '--',
-        path.relative(cwd, file).split(path.sep).join('/'),
-    ]);
-    const [hash, shortHash = '', subject = ''] = output
-        .trim()
-        .split('\x1f');
-    return hash ? { hash, shortHash, subject } : undefined;
-}
-/**
- * Limit a release plan to some packages and the changesets that name them.
- *
- * @param  plan     Release plan of all pending changesets.
- * @param  packages Configured packages.
- * @param  names    Packages to version.
- * @return Release plan of the named packages.
- * @throws {ValidationError} For unknown packages.
- */
-function selectReleasePlan(plan, packages, names) {
-    names.forEach((name) => {
-        if (!packages.some((pkg) => pkg.name === name)) {
-            throw new ValidationError(`Unknown package "${name}".`);
-        }
-    });
-    return {
-        releases: plan.releases.filter((release) => names.includes(release.package.name)),
-        changesets: plan.changesets.filter((changeset) => names.some((name) => Object.hasOwn(changeset.packages, name))),
-    };
-}
-/**
- * Remove an applied changeset, or only the applied packages from a changeset
- * that names other packages too, so that their releases keep its summary.
- *
- * @param file      Changeset file.
- * @param changeset Parsed changeset.
- * @param applied   Versioned packages, or undefined when all were versioned.
- * @param journal   File journal for rolling back.
- */
-async function consumeChangeset(file, changeset, applied, journal) {
-    const remaining = Object.entries(changeset.packages).filter(([name]) => undefined !== applied && !applied.includes(name));
-    await rememberFile(journal, file);
-    if (remaining.length) {
-        await writeFile(file, formatChangeset({
-            packages: Object.fromEntries(remaining),
-            summary: changeset.summary,
-        }));
-    }
-    else {
-        await rm(file);
-    }
-}
-/**
- * Create missing release tags, optionally pushing them to the configured remote.
- *
- * @param input Repository and tag options.
- * @return Per-package tags and release notes.
- */
-export async function tagChangesets(input) {
-    if (input.githubRelease && !input.push) {
-        throw new ValidationError('GitHub Releases require pushing the tags.');
-    }
-    if (input.untagged && input.push) {
-        throw new ValidationError('Listing untagged releases cannot be combined with pushing tags.');
-    }
-    const context = await getReleaseContext(input);
-    if (!context) {
-        throw new ValidationError('No wp-release config found. Add wp-release.config.js or pass --config <path>.');
-    }
-    const selected = selectPackages(context.packages, input);
-    const packages = input.since
-        ? (await changedPackagesSince(input.cwd, selected, input.since))
-            .packages
-        : selected;
-    const results = [];
-    const dryRun = input.dryRun || input.untagged;
-    const tagFormat = context.config.tagFormat ?? '{path}/{version}';
-    for (const pkg of packages) {
-        const version = await getTagVersion(pkg, input.version);
-        if (undefined !== input.version && input.version !== version) {
-            throw new ValidationError(`Package "${pkg.name}" is at version ${version}, not ${input.version}.`);
-        }
-        const tag = formatTag(tagFormat, pkg, version);
-        const exists = await gitTagExists(input.cwd, tag);
-        if (!exists) {
-            await verifyVersionTargets(input.cwd, pkg, version);
-        }
-        const previousTag = await getPreviousTag(input.cwd, formatTag(tagFormat, pkg, ''), version);
-        const notes = await getReleaseNotes(input.cwd, context.config, pkg, { version, tag, previousTag }, exists ? tag : 'HEAD');
-        if (!exists && !dryRun) {
-            await git(input.cwd, ['tag', tag]);
+    /**
+     * Write the version, the dependency specs of bundled sources and the
+     * changelog of a release.
+     *
+     * @param context Release context.
+     * @param plan    Selected release plan.
+     * @param release Release with its changelog entries.
+     * @param date    Release date, as YYYY-MM-DD.
+     * @param journal File journal for rolling back.
+     */
+    async writeRelease(context, plan, release, date, journal) {
+        const { config } = context;
+        const configured = context.packages.find((pkg) => pkg.name === release.package.name);
+        if (!configured) {
+            throw new ValidationError(`Unknown package "${release.package.name}".`);
+        }
+        for (const target of configured.versionConfig.to) {
+            await writeVersion(configured.directory, target, release.nextVersion, journal);
+        }
+        for (const sourceName of release.sources ?? []) {
+            const source = plan.releases.find((item) => item.package.name === sourceName);
+            if (!source) {
+                throw new ValidationError(`The dependent package "${release.package.name}" bundles unreleased package "${sourceName}".`);
+            }
+            await updateDependencyDeclaration({
+                dependent: release.package,
+                source: source.package,
+                version: source.nextVersion,
+                rule: config.dependents,
+                journal,
+            });
         }
-        results.push({
-            package: pkg.name,
-            version,
-            tag,
-            ...(previousTag ? { previousTag } : {}),
-            prerelease: isPrerelease(version),
-            exists,
-            created: !exists && !dryRun,
-            notes,
+        await verifyVersionTargets(this.repository, configured, release.nextVersion);
+        await prependChangelog(configured.directory, release, date, config.readmeChangelog ?? false, config.changelogInsertAfter, journal);
+    }
+    /**
+     * Load the configuration, discover the packages and plan the releases of
+     * the pending changesets, including the releases of their dependents.
+     *
+     * @return Release context, undefined without a config.
+     * @throws {ValidationError} For an invalid config, plan or changeset.
+     */
+    async loadContext() {
+        const loaded = await loadChangesetConfig({
+            cwd: this.cwd,
+            ...(this.configFile ? { configFile: this.configFile } : {}),
         });
-    }
-    // Push one tag at a time because GitHub doesn't create push events for
-    // tags when more than three are pushed at once.
-    if (input.push && !dryRun) {
-        for (const item of results.filter((result) => result.created)) {
-            await git(input.cwd, ['push', 'origin', item.tag]);
-        }
-    }
-    if (input.githubRelease && !dryRun) {
-        for (const release of results) {
-            await createGitHubRelease(input.cwd, release);
-        }
-    }
-    return {
-        tags: input.untagged
-            ? results.filter((result) => !result.exists)
-            : results,
-    };
-}
-async function createGitHubRelease(cwd, release) {
-    try {
-        await execFileAsync('gh', ['release', 'view', release.tag], {
-            cwd,
+        if (!loaded) {
+            return undefined;
+        }
+        const config = loaded.config;
+        const packages = await discoverPackages(this.repository, config);
+        const changesets = await readChangesets(this.getChangesetDirectory(config));
+        const releases = [];
+        packages.forEach((pkg) => {
+            const bump = getChangesetBump(changesets, pkg.name);
+            if (bump) {
+                const packageChangesets = changesets.filter((changeset) => Object.hasOwn(changeset.packages, pkg.name));
+                const nextVersion = config.nextVersion
+                    ? config.nextVersion({
+                        package: pkg,
+                        bump,
+                        currentVersion: pkg.currentVersion,
+                        changesets: packageChangesets,
+                    })
+                    : getNextVersion(pkg.currentVersion, bump);
+                if ('string' !== typeof nextVersion || !nextVersion.trim()) {
+                    throw new ValidationError(`The nextVersion strategy returned an empty version for package "${pkg.name}".`);
+                }
+                releases.push({
+                    package: pkg,
+                    bump,
+                    currentVersion: pkg.currentVersion,
+                    nextVersion,
+                    changesets: packageChangesets,
+                });
+            }
         });
-    }
-    catch {
-        try {
-            await execFileAsync('gh', [
-                'release',
-                'create',
-                release.tag,
-                '--title',
-                `${release.package}@${release.version}`,
-                '--notes',
-                release.notes,
-                ...(release.prerelease ? ['--prerelease'] : []),
-            ], { cwd });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            throw new ValidationError(`Could not create GitHub Release for ${release.tag}: ${message}`);
+        changesets.forEach((changeset) => {
+            Object.keys(changeset.packages).forEach((name) => {
+                if (!packages.some((pkg) => pkg.name === name)) {
+                    throw new ValidationError(`Changeset ${changeset.fileName} refers to unknown package "${name}".`);
+                }
+            });
+        });
+        await applyDependents(releases, packages, config);
+        return { config, packages, plan: { changesets, releases } };
+    }
+    /**
+     * Load the release context of a repository that has to be configured.
+     *
+     * @return Release context.
+     * @throws {ValidationError} Without a config.
+     */
+    async requireContext() {
+        const context = await this.loadContext();
+        if (!context) {
+            throw new ValidationError(MISSING_CONFIG);
+        }
+        return context;
+    }
+    /**
+     * Load the configuration of a repository that has to be configured.
+     *
+     * @return Repository release configuration.
+     * @throws {ValidationError} Without a config.
+     */
+    async requireConfig() {
+        const loaded = await loadChangesetConfig({
+            cwd: this.cwd,
+            ...(this.configFile ? { configFile: this.configFile } : {}),
+        });
+        if (!loaded) {
+            throw new ValidationError(MISSING_CONFIG);
         }
+        return loaded.config;
     }
-}
-/**
- * Get the version to tag. Packages versioned by their git tags have no
- * version file, so the expected version is the version to tag, or else the
- * latest CHANGELOG.md version.
- *
- * @param pkg      Configured package.
- * @param expected Expected version from --version, if any.
- * @return Version to tag.
- */
-async function getTagVersion(pkg, expected) {
-    if ('git-tag' !== pkg.versionConfig.from.kind) {
-        return pkg.currentVersion;
+    /**
+     * Get the directory of the changeset files.
+     *
+     * @param config Repository release configuration.
+     * @return Absolute directory path.
+     */
+    getChangesetDirectory(config) {
+        return path.resolve(this.cwd, config.changesets ?? '.changeset');
     }
-    return (expected ??
-        (await getLatestChangelogVersion(pkg.directory, pkg.currentVersion)));
 }
 /**
- * Pick the packages passed with --package, or all packages without it.
+ * Discover configured packages, pending changesets, and their proposed versions.
  *
- * @param  packages Configured packages.
- * @param  input    Tag options.
- * @return Selected packages in the configured order.
- * @throws {ValidationError} For unknown packages, or --version without a single package.
+ * @param input Repository root and optional explicit config file.
+ * @return A release plan; `undefined` when no config is present.
  */
-function selectPackages(packages, input) {
-    const names = input.packages ?? [];
-    if (undefined !== input.version && 1 !== names.length) {
-        throw new ValidationError('An expected version requires exactly one package.');
-    }
-    names.forEach((name) => {
-        if (!packages.some((pkg) => pkg.name === name)) {
-            throw new ValidationError(`Unknown package "${name}".`);
-        }
-    });
-    return names.length
-        ? packages.filter((pkg) => names.includes(pkg.name))
-        : packages;
+export async function getChangesetReleasePlan(input) {
+    return new ChangesetRelease(input).getPlan();
 }
 /**
- * Find the tag of the newest release before a version.
+ * Discover the packages of the repository configuration.
  *
- * @param cwd     Repository root.
- * @param prefix  Tag prefix of the package, like `plugins/alpha/`.
- * @param version Version being released.
- * @return Previous tag, or undefined for the first release.
+ * @param  input Repository root and optional explicit config file.
+ * @return Packages in the configured order with their current versions.
+ * @throws {ValidationError} Without a config, or for an invalid one.
  */
-async function getPreviousTag(cwd, prefix, version) {
-    const output = await git(cwd, ['tag', '--list', `${prefix}*`]);
-    return output
-        .trim()
-        .split(/\r?\n/)
-        .filter((tag) => tag.startsWith(prefix))
-        .map((tag) => ({ tag, version: tag.slice(prefix.length) }))
-        .filter((item) => isVersion(item.version) &&
-        compareVersions(item.version, version) < 0)
-        .sort((a, b) => compareVersions(b.version, a.version))[0]?.tag;
+export async function getChangesetPackages(input) {
+    return new ChangesetRelease(input).getPackages();
 }
 /**
- * Build the release notes of a tag with the configured formatter.
+ * Create a Changesets-compatible Markdown file.
  *
- * @param cwd                 Repository root.
- * @param config              Repository release configuration.
- * @param pkg                 Released package.
- * @param release             Version, tag and previous tag of the release.
- * @param release.version     Released version.
- * @param release.tag         Release tag.
- * @param release.previousTag Tag of the previous release, if any.
- * @param end                 Commit of the release: the tag, or HEAD before tagging.
- * @return Release notes.
+ * @param input Repository, packages and summary.
+ * @return Created file path.
  */
-async function getReleaseNotes(cwd, config, pkg, release, end) {
-    const changelog = await readReleaseNotes(pkg.directory, release.version);
-    const commits = await getReleaseCommits(cwd, pkg, end, release.previousTag);
-    const notes = changelog ||
-        commits
-            .map((commit) => `- ${commit.subject} (${commit.shortHash})`)
-            .join('\n');
-    if (!config.releaseNotes) {
-        return notes;
-    }
-    const formatted = await config.releaseNotes({
-        package: toChangesetPackage(pkg),
-        ...release,
-        changelog,
-        commits,
-        notes,
-    });
-    if ('string' !== typeof formatted) {
-        throw new ValidationError(`The releaseNotes formatter didn't return a string for package "${pkg.name}".`);
-    }
-    return formatted.trim();
+export async function addChangeset(input) {
+    return new ChangesetRelease(input).add(input);
 }
 /**
- * List the commits that changed a package since its previous release.
+ * Apply pending package versions and changelogs.
  *
- * @param cwd         Repository root.
- * @param pkg         Released package.
- * @param end         Commit of the release.
- * @param previousTag Tag of the previous release, if any.
- * @return Commits, newest first.
+ * @param input Repository and versioning options.
+ * @return Planned releases and whether files were changed.
  */
-async function getReleaseCommits(cwd, pkg, end, previousTag) {
-    const packageFromRepo = path.relative(cwd, pkg.directory).split(path.sep).join('/') ||
-        '.';
-    const output = await git(cwd, [
-        'log',
-        '--format=%H%x1f%h%x1f%s',
-        previousTag ? `${previousTag}..${end}` : end,
-        '--',
-        packageFromRepo,
-    ]);
-    return output
-        .trim()
-        .split(/\r?\n/)
-        .filter(Boolean)
-        .map((line) => {
-        const [hash = '', shortHash = '', subject = ''] = line.split('\x1f');
-        return { hash, shortHash, subject };
-    });
+export async function versionChangesets(input) {
+    return new ChangesetRelease(input).version(input);
 }
 /**
- * Remove the release configuration from a package passed to config callbacks.
+ * Create missing release tags, optionally pushing them to the configured remote.
  *
- * @param pkg Configured package.
- * @return Package without its group configuration.
+ * @param input Repository and tag options.
+ * @return Per-package tags and release notes.
  */
-function toChangesetPackage(pkg) {
-    return {
-        name: pkg.name,
-        directory: pkg.directory,
-        path: pkg.path,
-        type: pkg.type,
-        currentVersion: pkg.currentVersion,
-    };
+export async function tagChangesets(input) {
+    return new ChangesetRelease(input).tag(input);
 }
 /**
  * Check whether changed files belong to packages without a changeset.
@@ -504,646 +421,5 @@ function toChangesetPackage(pkg) {
  * @return Changed packages and missing changeset identifiers.
  */
 export async function getChangesetStatus(input) {
-    const context = await getReleaseContext(input);
-    if (!context) {
-        throw new ValidationError('No wp-release config found. Add wp-release.config.js or pass --config <path>.');
-    }
-    const { plan } = context;
-    const { changesets, releases } = plan;
-    const since = input.since ??
-        (context.config.baseBranch
-            ? `origin/${context.config.baseBranch}`
-            : undefined);
-    const changed = since
-        ? await changedPackagesSince(input.cwd, context.packages, since)
-        : { packages: [], filesByPackage: {} };
-    const changedPackages = changed.packages.map((pkg) => pkg.name);
-    const changesetsInDiff = since
-        ? await readChangesetsSince(input.cwd, context.config, changesets, since)
-        : [];
-    const hasEmptyChangeset = changesetsInDiff.some((changeset) => 0 === Object.keys(changeset.packages).length);
-    const missingChangesets = hasEmptyChangeset
-        ? []
-        : changedPackages.filter((name) => !changesetsInDiff.some((item) => Object.hasOwn(item.packages, name)));
-    return {
-        changesets,
-        releases,
-        changedPackages,
-        changedPackageFiles: changed.filesByPackage,
-        missingChangesets,
-    };
-}
-async function requireConfig(input) {
-    const loaded = await loadChangesetConfig(input);
-    if (!loaded) {
-        throw new ValidationError('No wp-release config found. Add wp-release.config.js or pass --config <path>.');
-    }
-    return loaded;
-}
-async function readChangesets(cwd, config) {
-    const directory = path.resolve(cwd, config.changesets ?? '.changeset');
-    let entries;
-    try {
-        entries = await readdir(directory);
-    }
-    catch (error) {
-        if ('ENOENT' === error.code) {
-            return [];
-        }
-        throw error;
-    }
-    return Promise.all(entries
-        .filter((name) => name.endsWith('.md') && !name.startsWith('README'))
-        .sort()
-        .map(async (name) => parseChangeset(await readFile(path.join(directory, name), 'utf8'), name)));
-}
-async function readChangesetsSince(cwd, config, changesets, since) {
-    const directory = path.resolve(cwd, config.changesets ?? '.changeset');
-    const relativeDirectory = path
-        .relative(cwd, directory)
-        .split(path.sep)
-        .join('/');
-    const output = await git(cwd, [
-        'diff',
-        '--name-only',
-        '--diff-filter=ACMR',
-        `${since}...HEAD`,
-        '--',
-        relativeDirectory,
-    ]);
-    const changedFiles = new Set(output.trim().split(/\r?\n/).filter(Boolean));
-    return changesets.filter((changeset) => changedFiles.has(path.posix.join(relativeDirectory, changeset.fileName)));
-}
-async function discoverPackages(cwd, config) {
-    const root = path.resolve(cwd, config.root ?? '.');
-    const packages = [];
-    const hasRecursiveGlob = config.packages.some((item) => item.glob.split('/').includes('**'));
-    const directories = await findDirectories(root, '', hasRecursiveGlob
-        ? Infinity
-        : Math.max(1, ...config.packages.map((item) => item.glob.split('/').length + 2)));
-    for (const group of config.packages) {
-        const matcher = globRegExp(group.glob);
-        const candidates = matcher.test('.')
-            ? ['.', ...directories]
-            : directories;
-        const matches = candidates
-            .filter((item) => matcher.test(item) &&
-            !(group.exclude ?? []).some((excluded) => globRegExp(excluded).test(item)))
-            .sort();
-        if (!matches.length) {
-            throw new ValidationError(`Package glob "${group.glob}" did not match any directories under ${root}.`);
-        }
-        for (const relativePath of matches) {
-            const directory = path.join(root, relativePath);
-            const name = await packageName(directory, relativePath, group.idFrom ?? 'path');
-            const currentVersion = await readVersion(cwd, directory, group.version.from, relativePath, group.tagType);
-            if (packages.some((pkg) => pkg.name === name)) {
-                throw new ValidationError(`Package identifier "${name}" is configured more than once.`);
-            }
-            packages.push({
-                name,
-                directory,
-                path: relativePath,
-                type: packageType(group),
-                currentVersion,
-                group,
-                versionConfig: group.version,
-            });
-        }
-    }
-    return packages;
-}
-async function findDirectories(root, prefix = '', maxDepth = 5) {
-    let entries;
-    try {
-        entries = await readdir(path.join(root, prefix), {
-            withFileTypes: true,
-        });
-    }
-    catch (error) {
-        if ('ENOENT' === error.code) {
-            return [];
-        }
-        throw error;
-    }
-    const directories = entries.filter((item) => item.isDirectory() &&
-        !['.git', 'node_modules', 'vendor', 'dist'].includes(item.name));
-    if (prefix.split(path.sep).filter(Boolean).length >= maxDepth) {
-        return directories.map((item) => path.join(prefix, item.name));
-    }
-    const children = await Promise.all(directories.map((item) => findDirectories(root, path.join(prefix, item.name), maxDepth)));
-    return [
-        ...directories.map((item) => path.join(prefix, item.name)),
-        ...children.flat(),
-    ];
-}
-function globRegExp(glob) {
-    const escaped = glob
-        .split('/')
-        .map((part) => {
-        if ('**' === part) {
-            return '.*';
-        }
-        return part
-            .replaceAll(/[.+^${}()|[\]\\]/g, '\\$&')
-            .replaceAll('*', '[^/]*')
-            .replaceAll('?', '[^/]');
-    })
-        .join('/');
-    return new RegExp(`^${escaped}$`);
-}
-async function packageName(directory, relativePath, idFrom) {
-    if ('path' === idFrom) {
-        if ('.' === relativePath) {
-            return path.basename(directory);
-        }
-        return relativePath.split(path.sep).join('/');
-    }
-    const [file, field] = idFrom.split('#');
-    if (!file || !field) {
-        throw new ValidationError(`Invalid package identifier source "${idFrom}".`);
-    }
-    const manifest = await readJson(path.join(directory, file));
-    const name = manifest[field];
-    if ('string' !== typeof name || !name.trim()) {
-        throw new ValidationError(`Expected ${file}#${field} in ${directory}.`);
-    }
-    return name;
-}
-async function readVersion(cwd, directory, descriptor, relativePath, tagType) {
-    if ('package-json' === descriptor.kind ||
-        'composer-json' === descriptor.kind) {
-        const manifest = await readJson(path.join(directory, descriptor.file));
-        const version = manifest[descriptor.field];
-        if ('string' === typeof version && version.trim()) {
-            return version;
-        }
-        throw new ValidationError(`Missing ${descriptor.file}#${descriptor.field} in ${directory}.`);
-    }
-    if ('git-tag' === descriptor.kind) {
-        const pattern = descriptor.pattern ?? '{path}/{version}';
-        const tagsOutput = await git(cwd, [
-            'tag',
-            '--list',
-            `${formatTemplatePrefix(pattern, relativePath, tagType)}*`,
-        ]);
-        const tags = tagsOutput.trim().split(/\r?\n/).filter(Boolean);
-        const versions = tags
-            .map((tag) => tag.match(/(?:^|\/|v)(\d+\.\d+\.\d+)$/)?.[1])
-            .filter((item) => Boolean(item));
-        versions.sort((a, b) => compareVersions(b, a));
-        if (versions[0]) {
-            return versions[0];
-        }
-        throw new ValidationError(`No git tag matches ${pattern} for ${relativePath}.`);
-    }
-    if ('php-constant' === descriptor.kind) {
-        const file = path.join(directory, descriptor.file);
-        const contents = await readFile(file, 'utf8');
-        const versions = findConstantValues(contents, descriptor.constant);
-        if (versions[0]) {
-            return versions[0];
-        }
-        throw new ValidationError(`Missing PHP constant ${descriptor.constant} in ${file}.`);
-    }
-    const file = path.join(directory, await getVersionFile(directory, descriptor.kind, descriptor.file));
-    const contents = await readFile(file, 'utf8');
-    const label = 'wordpress-stable-tag' === descriptor.kind ? 'Stable tag' : 'Version';
-    const match = new RegExp(`^\\s*\\*?\\s*${label}:\\s*([^\\r\\n]+)`, 'im').exec(contents);
-    if (!match) {
-        throw new ValidationError(`Missing ${label} header in ${file}.`);
-    }
-    return match[1]?.trim() ?? '';
-}
-async function writeVersion(directory, descriptor, version, journal) {
-    if ('package-json' === descriptor.kind ||
-        'composer-json' === descriptor.kind) {
-        const file = path.join(directory, descriptor.file);
-        const contents = await readFile(file, 'utf8');
-        const manifest = JSON.parse(contents);
-        if ('composer-json' === descriptor.kind &&
-            descriptor.ifPresent &&
-            !Object.hasOwn(manifest, descriptor.field)) {
-            return;
-        }
-        manifest[descriptor.field] = version;
-        await rememberFile(journal, file);
-        await writeFile(file, `${JSON.stringify(manifest, null, '\t')}\n`);
-        return;
-    }
-    if ('php-constant' === descriptor.kind) {
-        const file = path.join(directory, descriptor.file);
-        const contents = await readFile(file, 'utf8');
-        const constant = escapeRegExp(descriptor.constant);
-        const definePattern = new RegExp(`(\\bdefine\\s*\\(\\s*(['"])${constant}\\2\\s*,\\s*)(['"])(.*?)\\3`, 'g');
-        const declarationPattern = new RegExp(`(\\bconst\\s+${constant}\\s*=\\s*)(['"])(.*?)\\2`, 'g');
-        const updated = contents
-            .replace(definePattern, (_match, prefix, _nameQuote, quote) => `${prefix}${quote}${version}${quote}`)
-            .replace(declarationPattern, (_match, prefix, quote) => `${prefix}${quote}${version}${quote}`);
-        if (updated === contents) {
-            throw new ValidationError(`Missing PHP constant ${descriptor.constant} in ${file}.`);
-        }
-        await rememberFile(journal, file);
-        await writeFile(file, updated);
-        return;
-    }
-    if ('wordpress-stable-tag' === descriptor.kind &&
-        descriptor.ifPresent &&
-        !(await versionFileExists(directory, descriptor.kind, descriptor.file))) {
-        return;
-    }
-    const file = path.join(directory, await getVersionFile(directory, descriptor.kind, descriptor.file));
-    const contents = await readFile(file, 'utf8');
-    const label = 'wordpress-stable-tag' === descriptor.kind ? 'Stable tag' : 'Version';
-    const expression = new RegExp(`(^\\s*\\*?\\s*${label}:\\s*)[^\\r\\n]+`, 'im');
-    if (!expression.test(contents)) {
-        throw new ValidationError(`Missing ${label} header in ${file}.`);
-    }
-    await rememberFile(journal, file);
-    await writeFile(file, contents.replace(expression, `$1${version}`));
-}
-async function getVersionFile(directory, kind, configuredFile) {
-    if (configuredFile) {
-        return configuredFile;
-    }
-    if ('wordpress-plugin-header' === kind) {
-        const file = await findMainPluginFile({ dir: directory });
-        if (file) {
-            return file;
-        }
-        throw new ValidationError(`Could not find a plugin header file in ${directory}.`);
-    }
-    if ('wordpress-stable-tag' === kind) {
-        for (const file of ['readme.txt', 'readme.md']) {
-            try {
-                await access(path.join(directory, file));
-                return file;
-            }
-            catch {
-                // Try the next WordPress readme filename.
-            }
-        }
-        throw new ValidationError(`Could not find readme.txt or readme.md in ${directory}.`);
-    }
-    return 'style.css';
-}
-async function versionFileExists(directory, kind, configuredFile) {
-    if (configuredFile) {
-        try {
-            await access(path.join(directory, configuredFile));
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    if ('wordpress-stable-tag' === kind) {
-        const files = await Promise.all(['readme.txt', 'readme.md'].map(async (file) => {
-            try {
-                await access(path.join(directory, file));
-                return true;
-            }
-            catch {
-                return false;
-            }
-        }));
-        return files.some(Boolean);
-    }
-    return true;
-}
-async function prependChangelog(directory, release, date, readmeChangelog, changelogInsertAfter, journal) {
-    const summaries = release.changesets
-        .map((item) => item.summary.trim())
-        .filter(Boolean);
-    const section = `## ${release.nextVersion} (${date})\n\n${release.changelog}\n\n`;
-    const changelog = path.join(directory, 'CHANGELOG.md');
-    let previous = '';
-    try {
-        previous = await readFile(changelog, 'utf8');
-    }
-    catch (error) {
-        if ('ENOENT' !== error.code) {
-            throw error;
-        }
-    }
-    const releaseHeading = new RegExp(`^## ${escapeRegExp(release.nextVersion)} \\(`, 'm');
-    if (!releaseHeading.test(previous)) {
-        await rememberFile(journal, changelog);
-        if (undefined !== changelogInsertAfter) {
-            await writeFile(changelog, insertAfterMarker(previous, changelogInsertAfter, section, changelog));
-        }
-        else {
-            const versionHeading = /^##[ \t]+v?\d+(?:\.\d+){1,2}(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?(?:[ \t]+.*)?$/m.exec(previous);
-            const heading = /^#[ \t]+[^\r\n]+[ \t]*$/m.exec(previous);
-            const insertion = versionHeading ?? heading;
-            if (insertion) {
-                const before = previous
-                    .slice(0, insertion.index)
-                    .replace(/(?:\r?\n)*$/, '');
-                const after = previous.slice(insertion.index);
-                const prefix = before ? `${before}\n\n` : '';
-                await writeFile(changelog, `${prefix}${section}${after}`);
-            }
-            else {
-                await writeFile(changelog, `${section}${previous}`);
-            }
-        }
-    }
-    if (readmeChangelog) {
-        const readme = ['readme.txt', 'readme.md'].map((name) => path.join(directory, name));
-        let readmeUpdated = false;
-        let readmeFound = false;
-        let readmeMarkerFound = false;
-        let readmeAlreadyVersioned = false;
-        for (const file of readme) {
-            try {
-                const contents = await readFile(file, 'utf8');
-                readmeFound = true;
-                const defaultHeading = undefined === changelogInsertAfter
-                    ? /^==\s*Changelog\s*==\s*$/im.exec(contents)?.[0]
-                    : undefined;
-                const insertionMarker = changelogInsertAfter ?? defaultHeading;
-                readmeMarkerFound ||=
-                    undefined !== insertionMarker &&
-                        contents.includes(insertionMarker);
-                const alreadyVersioned = new RegExp(`^=\\s*${escapeRegExp(release.nextVersion)}\\s*=$`, 'm').test(contents);
-                readmeAlreadyVersioned ||= alreadyVersioned;
-                if (insertionMarker &&
-                    !alreadyVersioned &&
-                    !readmeUpdated &&
-                    contents.includes(insertionMarker)) {
-                    const readmeSection = `\n\n= ${release.nextVersion} =\n\n${summaries
-                        .map((item) => `* ${item.replaceAll(/\r?\n/g, '\n  ')}`)
-                        .join('\n')}\n\n`;
-                    await rememberFile(journal, file);
-                    await writeFile(file, insertAfterMarker(contents, insertionMarker, readmeSection.trimStart(), file));
-                    readmeUpdated = true;
-                }
-            }
-            catch (error) {
-                if ('ENOENT' !== error.code) {
-                    throw error;
-                }
-            }
-        }
-        if (changelogInsertAfter &&
-            readmeFound &&
-            !readmeMarkerFound &&
-            !readmeAlreadyVersioned) {
-            throw new ValidationError(`Changelog insertion marker "${changelogInsertAfter}" was not found in a plugin readme in ${directory}.`);
-        }
-    }
-}
-function insertAfterMarker(contents, marker, section, file) {
-    const index = contents.indexOf(marker);
-    if (-1 === index) {
-        throw new ValidationError(`Changelog insertion marker "${marker}" was not found in ${file}.`);
-    }
-    const markerEnd = index + marker.length;
-    const after = contents
-        .slice(markerEnd)
-        .replace(/^(?:[ \t]*\r?\n)+/, '');
-    const lineEnding = contents.includes('\r\n') ? '\r\n' : '\n';
-    return `${contents.slice(0, markerEnd)}${lineEnding}${lineEnding}${section.replaceAll('\n', lineEnding)}${after}`;
-}
-async function changedPackagesSince(cwd, packages, since) {
-    const output = await git(cwd, [
-        'diff',
-        '--name-only',
-        `${since}...HEAD`,
-    ]);
-    const changedFiles = output.trim().split(/\r?\n/).filter(Boolean);
-    const filesByPackage = {};
-    const changed = packages.filter((pkg) => {
-        const packageFromRepo = path
-            .relative(cwd, pkg.directory)
-            .split(path.sep)
-            .join('/');
-        const matchingFiles = '.' === packageFromRepo
-            ? changedFiles
-            : changedFiles.filter((file) => file === packageFromRepo ||
-                file.startsWith(`${packageFromRepo}/`));
-        if (matchingFiles.length) {
-            filesByPackage[pkg.name] = matchingFiles;
-        }
-        return matchingFiles.length > 0;
-    });
-    return { packages: changed, filesByPackage };
-}
-function formatTag(format, pkg, version) {
-    const type = pkg.group.tagType ?? defaultTagType(pkg.path, pkg.type);
-    return format
-        .replaceAll('{name}', pkg.name)
-        .replaceAll('{slug}', '.' === pkg.path
-        ? path.basename(pkg.directory)
-        : path.basename(pkg.path))
-        .replaceAll('{path}', pkg.path)
-        .replaceAll('{type}', type)
-        .replaceAll('{version}', version);
-}
-function defaultTagType(packagePath, type) {
-    if ('.' === packagePath && type) {
-        return type;
-    }
-    const first = packagePath.split('/')[0] ?? 'package';
-    const irregular = {
-        actions: 'action',
-        plugins: 'plugin',
-        themes: 'theme',
-        php: 'php',
-        js: 'js',
-    };
-    return irregular[first] ?? first.replace(/s$/, '');
-}
-function formatTemplatePrefix(pattern, packagePath, tagType) {
-    return pattern
-        .replaceAll('{path}', packagePath)
-        .replaceAll('{type}', tagType ?? defaultTagType(packagePath))
-        .replaceAll('{name}', packagePath.split('/').at(-1) ?? packagePath)
-        .replaceAll('{slug}', packagePath.split('/').at(-1) ?? packagePath)
-        .replaceAll('{version}', '');
-}
-async function verifyVersionTargets(cwd, pkg, expected) {
-    for (const target of pkg.versionConfig.to) {
-        let actual;
-        if ('composer-json' === target.kind &&
-            target.ifPresent &&
-            !Object.hasOwn(await readJson(path.join(pkg.directory, target.file)), target.field)) {
-            actual = undefined;
-        }
-        else if ('wordpress-stable-tag' === target.kind &&
-            target.ifPresent &&
-            !(await versionFileExists(pkg.directory, target.kind, target.file))) {
-            actual = undefined;
-        }
-        else {
-            actual = await readVersion(cwd, pkg.directory, target, pkg.path, pkg.group.tagType);
-        }
-        if (undefined !== actual && actual !== expected) {
-            throw new ValidationError(`Version mismatch for ${pkg.name}: expected ${expected}, found ${actual}.`);
-        }
-    }
-}
-async function gitTagExists(cwd, tag) {
-    const result = await git(cwd, ['tag', '--list', tag]);
-    return result.trim() === tag;
-}
-async function git(cwd, args) {
-    const directory = path.resolve(cwd);
-    try {
-        const { stdout } = await execFileAsync('git', ['-c', `safe.directory=${directory}`, ...args], { cwd: directory });
-        return stdout;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new ValidationError(`Git command failed (${args.join(' ')}): ${message}`);
-    }
-}
-async function readReleaseNotes(directory, version) {
-    let contents = '';
-    try {
-        contents = await readFile(path.join(directory, 'CHANGELOG.md'), 'utf8');
-    }
-    catch (error) {
-        if ('ENOENT' !== error.code) {
-            throw error;
-        }
-    }
-    const lines = contents.split(/\r?\n/);
-    const headingIndex = lines.findIndex((line) => new RegExp(`^##\\s+${escapeRegExp(version)}(?:\\s|$)`).test(line));
-    if (-1 === headingIndex) {
-        return '';
-    }
-    const followingHeading = lines.findIndex((line, index) => index > headingIndex && /^##\s/.test(line));
-    const end = -1 === followingHeading ? lines.length : followingHeading;
-    return lines
-        .slice(headingIndex + 1, end)
-        .join('\n')
-        .trim();
-}
-async function getLatestChangelogVersion(directory, fallback) {
-    try {
-        const contents = await readFile(path.join(directory, 'CHANGELOG.md'), 'utf8');
-        const match = /^##\s+(\d+\.\d+\.\d+)(?:\s|$)/m.exec(contents);
-        return match?.[1] ?? fallback;
-    }
-    catch (error) {
-        if ('ENOENT' === error.code) {
-            return fallback;
-        }
-        throw error;
-    }
-}
-function escapeRegExp(value) {
-    return value.replaceAll(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-async function rememberFile(journal, file) {
-    if (journal.has(file)) {
-        return;
-    }
-    try {
-        journal.set(file, await readFile(file, 'utf8'));
-    }
-    catch (error) {
-        if ('ENOENT' !== error.code) {
-            throw error;
-        }
-        journal.set(file, undefined);
-    }
-}
-async function restoreFileJournal(journal) {
-    const errors = [];
-    for (const [file, contents] of [...journal.entries()].reverse()) {
-        try {
-            if (undefined === contents) {
-                await rm(file, { force: true });
-            }
-            else {
-                await writeFile(file, contents);
-            }
-        }
-        catch (error) {
-            errors.push(error instanceof Error ? error : new Error(String(error)));
-        }
-    }
-    return errors;
-}
-async function readJson(file) {
-    try {
-        return JSON.parse(await readFile(file, 'utf8'));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new ValidationError(`Could not read JSON manifest ${file}: ${message}`);
-    }
-}
-function packageType(group) {
-    const kind = group.version.from.kind;
-    if ('wordpress-plugin-header' === kind) {
-        return 'plugin';
-    }
-    if ('wordpress-theme-header' === kind) {
-        return 'theme';
-    }
-    if ('package-json' === kind) {
-        return 'npm';
-    }
-    return 'other';
-}
-const VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?$/;
-function isVersion(version) {
-    return VERSION_PATTERN.test(version);
-}
-function isPrerelease(version) {
-    return Boolean(VERSION_PATTERN.exec(version)?.[4]);
-}
-/**
- * Compare two versions with SemVer precedence, where a pre-release like
- * 1.0.0-rc.1 comes before 1.0.0.
- *
- * @param left  Version.
- * @param right Version to compare with.
- * @return Negative when left is lower, positive when higher, otherwise 0.
- */
-function compareVersions(left, right) {
-    const [leftCore = '', leftPre] = splitPrerelease(left);
-    const [rightCore = '', rightPre] = splitPrerelease(right);
-    const a = leftCore.split('.').map(Number);
-    const b = rightCore.split('.').map(Number);
-    const core = (a[0] ?? 0) - (b[0] ?? 0) ||
-        (a[1] ?? 0) - (b[1] ?? 0) ||
-        (a[2] ?? 0) - (b[2] ?? 0);
-    if (core || leftPre === rightPre) {
-        return core;
-    }
-    if (undefined === leftPre || undefined === rightPre) {
-        return undefined === leftPre ? 1 : -1;
-    }
-    return comparePrerelease(leftPre.split('.'), rightPre.split('.'));
-}
-function splitPrerelease(version) {
-    const index = version.indexOf('-');
-    return -1 === index
-        ? [version]
-        : [version.slice(0, index), version.slice(index + 1)];
-}
-function comparePrerelease(left, right) {
-    const [a, ...leftRest] = left;
-    const [b, ...rightRest] = right;
-    if (undefined === a || undefined === b) {
-        return (undefined === a ? 0 : 1) - (undefined === b ? 0 : 1);
-    }
-    const order = compareIdentifier(a, b);
-    return order || comparePrerelease(leftRest, rightRest);
-}
-function compareIdentifier(a, b) {
-    const aNumeric = /^\d+$/.test(a);
-    const bNumeric = /^\d+$/.test(b);
-    if (aNumeric && bNumeric) {
-        return Number(a) - Number(b);
-    }
-    if (aNumeric || bNumeric) {
-        return aNumeric ? -1 : 1;
-    }
-    return Number(a > b) - Number(a < b);
+    return new ChangesetRelease(input).getStatus(input);
 }