@wpelevator/wp-release 0.5.0 → 0.6.1

package/dist/commands/changeset-status.d.ts

@@ -0,0 +1,43 @@
+export interface ChangesetStatusResult {
+    changesets: Array<{
+        fileName: string;
+        packages: Record<string, string>;
+        summary: string;
+    }>;
+    releases: Array<{
+        package: string;
+        bump: string;
+        currentVersion: string;
+        nextVersion: string;
+    }>;
+    changedPackages: string[];
+    changedPackageFiles: Record<string, string[]>;
+    missingChangesets: string[];
+}
+declare const _default: {
+    name: string;
+    usage: string;
+    summary: string;
+    help: string;
+    options: {
+        readonly since: {
+            readonly type: "string";
+        };
+    };
+    run({ values, cwd, configFile, logger }: import("./command.ts").CommandContext): Promise<{
+        exitCode: number;
+        result: {
+            releases: {
+                package: string;
+                bump: "patch" | "minor" | "major";
+                currentVersion: string;
+                nextVersion: string;
+            }[];
+            changesets: import("../changesets.ts").Changeset[];
+            changedPackages: string[];
+            changedPackageFiles: Record<string, string[]>;
+            missingChangesets: string[];
+        };
+    }>;
+};
+export default _default;

package/dist/commands/changeset-status.js

@@ -0,0 +1,65 @@
+import { getChangesetStatus } from "../changeset-release.js";
+import { changesetStatusArgs, parseChangesetStatusArgs, } from "./changeset-args.js";
+export default {
+    name: 'changeset-status',
+    usage: 'changeset-status [--since <ref>]',
+    summary: 'Show pending releases and check changed packages for changesets.',
+    help: `Options:
+  --since <ref>          Compare changed files with this git ref (for CI)
+
+Exit status is 2 when a changed package has no changeset added since the comparison base.
+An empty changeset added since the comparison base counts as an explicit no-release decision.`,
+    options: changesetStatusArgs,
+    async run({ values, cwd, configFile, logger }) {
+        const { since } = parseChangesetStatusArgs(values);
+        const result = await getChangesetStatus({
+            cwd,
+            ...(configFile ? { configFile } : {}),
+            ...(since ? { since } : {}),
+        });
+        logger.summary(() => {
+            const rows = result.changedPackages.map((name) => {
+                let status = 'no release requested';
+                if (result.releases.some((release) => release.package.name === name)) {
+                    status = 'changeset found';
+                }
+                if (result.missingChangesets.includes(name)) {
+                    status = 'missing changeset';
+                }
+                return [name, status];
+            });
+            return [
+                '### Changeset status',
+                '',
+                '| Package | Status |',
+                '| --- | --- |',
+                ...rows.map((row) => `| ${row.join(' | ')} |`),
+            ].join('\n');
+        });
+        result.releases.forEach((release) => logger.info(`${release.package.name}: ${release.currentVersion} → ${release.nextVersion} (${release.bump})`));
+        if (result.missingChangesets.length) {
+            result.missingChangesets.forEach((name) => {
+                const file = result.changedPackageFiles[name]?.[0];
+                logger.error(`Changed package "${name}" has no changeset.`, {
+                    file,
+                    title: 'Missing changeset',
+                });
+            });
+        }
+        else if (!result.releases.length) {
+            logger.info('No pending package releases.');
+        }
+        return {
+            exitCode: result.missingChangesets.length ? 2 : 0,
+            result: {
+                ...result,
+                releases: result.releases.map((item) => ({
+                    package: item.package.name,
+                    bump: item.bump,
+                    currentVersion: item.currentVersion,
+                    nextVersion: item.nextVersion,
+                })),
+            },
+        };
+    },
+};

package/dist/commands/changeset-tag.d.ts

@@ -0,0 +1,28 @@
+declare const _default: {
+    name: string;
+    usage: string;
+    summary: string;
+    help: string;
+    options: {
+        readonly push: {
+            readonly type: "boolean";
+        };
+        readonly 'dry-run': {
+            readonly type: "boolean";
+        };
+        readonly untagged: {
+            readonly type: "boolean";
+        };
+        readonly 'github-release': {
+            readonly type: "boolean";
+        };
+        readonly since: {
+            readonly type: "string";
+        };
+    };
+    run({ values, cwd, configFile, logger }: import("./command.ts").CommandContext): Promise<{
+        exitCode: number;
+        result: import("../changeset-release.ts").ChangesetTagResult;
+    }>;
+};
+export default _default;

package/dist/commands/changeset-tag.js

@@ -0,0 +1,30 @@
+import { tagChangesets } from "../changeset-release.js";
+import { parseChangesetTagArgs, changesetTagArgs } from "./changeset-args.js";
+export default {
+    name: 'changeset-tag',
+    usage: 'changeset-tag [--dry-run] [--untagged] [--since <ref>] [--push] [--github-release]',
+    summary: 'Create missing release tags for configured package versions.',
+    help: `Options:
+  --dry-run              List missing tags without creating them
+  --untagged             List only releases without a tag, without creating tags
+  --since <ref>          Tag packages changed since this git ref
+  --push                 Push newly created tags to origin
+  --github-release       Create a GitHub Release for each tag
+
+Tags are created only when absent, and GitHub Releases are created only when
+missing, so rerunning after a partial failure is safe. --github-release also
+requires --push. With --json or --github-output, --untagged lists the releases
+that still need a tag, for example to release each of them with a separate
+workflow.`,
+    options: changesetTagArgs,
+    async run({ values, cwd, configFile, logger }) {
+        const args = parseChangesetTagArgs(values);
+        const result = await tagChangesets({
+            cwd,
+            ...(configFile ? { configFile } : {}),
+            ...args,
+        });
+        result.tags.forEach((item) => logger.info(`${item.created ? 'Created' : 'Exists'} ${item.tag}`));
+        return { exitCode: 0, result };
+    },
+};

package/dist/commands/changeset-version.d.ts

@@ -0,0 +1,38 @@
+export interface ChangesetVersionResult {
+    date: string;
+    changed: boolean;
+    releases: Array<{
+        package: string;
+        bump: string;
+        currentVersion: string;
+        nextVersion: string;
+    }>;
+}
+declare const _default: {
+    name: string;
+    usage: string;
+    summary: string;
+    help: string;
+    options: {
+        readonly 'dry-run': {
+            readonly type: "boolean";
+        };
+        readonly date: {
+            readonly type: "string";
+        };
+    };
+    run({ values, cwd, configFile, logger }: import("./command.ts").CommandContext): Promise<{
+        exitCode: number;
+        result: {
+            date: string;
+            changed: boolean;
+            releases: {
+                package: string;
+                bump: "patch" | "minor" | "major";
+                currentVersion: string;
+                nextVersion: string;
+            }[];
+        };
+    }>;
+};
+export default _default;

package/dist/commands/changeset-version.js

@@ -0,0 +1,39 @@
+import { versionChangesets } from "../changeset-release.js";
+import { parseChangesetVersionArgs, changesetVersionArgs, } from "./changeset-args.js";
+export default {
+    name: 'changeset-version',
+    usage: 'changeset-version [--dry-run] [--date <YYYY-MM-DD>]',
+    summary: 'Apply pending version bumps and changelog entries.',
+    help: `Options:
+  --dry-run              Print the release plan without writing files
+  --date <YYYY-MM-DD>    Changelog date (default: today)
+
+Updates configured version files, prepends changelog entries and removes the
+applied changeset files.`,
+    options: changesetVersionArgs,
+    async run({ values, cwd, configFile, logger }) {
+        const args = parseChangesetVersionArgs(values);
+        const result = await versionChangesets({
+            cwd,
+            ...(configFile ? { configFile } : {}),
+            ...args,
+        });
+        result.releases.forEach((release) => logger.info(`${release.package.name}: ${release.currentVersion} → ${release.nextVersion} (${release.bump})`));
+        if (!result.releases.length) {
+            logger.info('No pending package releases.');
+        }
+        return {
+            exitCode: 0,
+            result: {
+                date: result.date,
+                changed: result.changed,
+                releases: result.releases.map((item) => ({
+                    package: item.package.name,
+                    bump: item.bump,
+                    currentVersion: item.currentVersion,
+                    nextVersion: item.nextVersion,
+                })),
+            },
+        };
+    },
+};

package/dist/commands/command.d.ts

@@ -11,6 +11,8 @@ export interface CommandContext {
     positionals: string[];
     /** Working directory that relative paths resolve against. */
     cwd: string;
+    /** Explicit JavaScript release config path from --config, if supplied. */
+    configFile?: string;
     /** Logger for the command output. */
     logger: Logger;
 }

package/dist/index.d.ts

@@ -14,6 +14,9 @@ export { ZIP_MTIME, ZIP_FILE_MODE, createZip } from './zip.ts';
 export { isUrl, downloadFile } from './download.ts';
 export { readZipEntries, getZipEntryErrors, extractZip } from './unzip.ts';
 export { GIT_TAG_FORMAT, VersionMismatchError, getGitTagVersion, findConstantValues, findConstantDefinitions, findVersionMismatches, getVersionMismatchProblems, } from './version-check.ts';
+export { CHANGESET_BUMPS, parseChangeset, formatChangeset, getChangesetBump, getNextVersion, } from './changesets.ts';
+export { addChangeset, getChangesetReleasePlan, getChangesetStatus, versionChangesets, tagChangesets, } from './changeset-release.ts';
+export { defineConfig, packageJsonVersion, composerJsonVersion, wordpressPluginVersion, wordpressThemeVersion, wordpressStableTag, gitTagVersion, phpConstantVersion, loadChangesetConfig, } from './changeset-config.ts';
 export { Svn, SvnError, createSvnRunner, parseStatus, toSvnPath, } from './svn.ts';
 export { syncDirectory, copyFileIfChanged } from './sync.ts';
 export { ASSET_MIME_TYPES, SvnDeploy } from './svn-deploy.ts';
@@ -34,6 +37,9 @@ export type { FindMainPluginFileInput, HeaderValues, PackageMeta, ParseFileHeade
 export type { CreateZipInput } from './zip.ts';
 export type { ExtractZipInput, ZipEntryInfo, ZipEntryType } from './unzip.ts';
 export type { FindVersionMismatchesInput, GitTagInput, VersionCheckResult, VersionMismatch, } from './version-check.ts';
+export type { Changeset, ChangesetBump, ChangesetPackages, ChangesetConfig, ChangesetPackageType, ChangesetPackage, PackageRelease, ChangesetReleasePlan, } from './changesets.ts';
+export type { ChangesetRepository, ChangesetVersionInput, ChangesetTagInput, ChangesetTagResult, } from './changeset-release.ts';
+export type { WpReleaseConfig, ChangesetPackageGroup, PackageVersionConfig, PackageVersionSource, PackageVersionTarget, PackageIdSource, NextVersionInput, PackageJsonVersionOptions, ComposerJsonVersionOptions, WordPressVersionFileOptions, GitTagVersionOptions, PhpConstantVersionOptions, LoadChangesetConfigInput, } from './changeset-config.ts';
 export type { SvnCheckoutInput, SvnCommandInput, SvnCommandOutput, SvnCommitInput, SvnCopyInput, SvnDepth, SvnOptions, SvnPathsInput, SvnPropsetInput, SvnRunner, SvnStatusEntry, SvnStatusType, SvnUpdateInput, } from './svn.ts';
 export type { SyncDirectoryInput, SyncResult } from './sync.ts';
 export type { SummaryContext } from './summary.ts';

package/dist/index.js

@@ -14,6 +14,9 @@ export { ZIP_MTIME, ZIP_FILE_MODE, createZip } from "./zip.js";
 export { isUrl, downloadFile } from "./download.js";
 export { readZipEntries, getZipEntryErrors, extractZip } from "./unzip.js";
 export { GIT_TAG_FORMAT, VersionMismatchError, getGitTagVersion, findConstantValues, findConstantDefinitions, findVersionMismatches, getVersionMismatchProblems, } from "./version-check.js";
+export { CHANGESET_BUMPS, parseChangeset, formatChangeset, getChangesetBump, getNextVersion, } from "./changesets.js";
+export { addChangeset, getChangesetReleasePlan, getChangesetStatus, versionChangesets, tagChangesets, } from "./changeset-release.js";
+export { defineConfig, packageJsonVersion, composerJsonVersion, wordpressPluginVersion, wordpressThemeVersion, wordpressStableTag, gitTagVersion, phpConstantVersion, loadChangesetConfig, } from "./changeset-config.js";
 export { Svn, SvnError, createSvnRunner, parseStatus, toSvnPath, } from "./svn.js";
 export { syncDirectory, copyFileIfChanged } from "./sync.js";
 export { ASSET_MIME_TYPES, SvnDeploy } from "./svn-deploy.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wpelevator/wp-release",
-	"version": "0.5.0",
+	"version": "0.6.1",
 	"description": "Package, checksum, sign, verify and version-check WordPress plugins and themes, and deploy plugins to WordPress.org SVN",
 	"license": "MIT",
 	"repository": {