@williamthorsen/release-kit 5.4.0 → 7.0.0

package/dist/esm/parseRequestedTags.js

@@ -1,10 +1,7 @@
-function parseRequestedTags(flagValue) {
-  if (flagValue === void 0) {
-    return void 0;
-  }
-  const segments = flagValue.split(",").filter(Boolean);
-  return segments.length === 0 ? void 0 : segments;
+export function parseRequestedTags(flagValue) {
+    if (flagValue === undefined) {
+        return undefined;
+    }
+    const segments = flagValue.split(',').filter(Boolean);
+    return segments.length === 0 ? undefined : segments;
 }
-export {
-  parseRequestedTags
-};

package/dist/esm/prepareCommand.d.ts

@@ -1,7 +1,38 @@
 import type { WriteResult } from '@williamthorsen/nmr-core';
-import type { ReleaseType } from './types.ts';
+import type { ReleaseType } from './types.js';
 export declare const RELEASE_TAGS_FILE = "tmp/.release-tags";
 export declare const RELEASE_SUMMARY_FILE = "tmp/.release-summary";
+export declare const prepareFlagSchema: {
+    dryRun: {
+        long: string;
+        type: "boolean";
+    };
+    force: {
+        long: string;
+        type: "boolean";
+    };
+    noGitChecks: {
+        long: string;
+        type: "boolean";
+        short: string;
+    };
+    bump: {
+        long: string;
+        type: "string";
+    };
+    setVersion: {
+        long: string;
+        type: "string";
+    };
+    only: {
+        long: string;
+        type: "string";
+    };
+    withReleaseNotes: {
+        long: string;
+        type: "boolean";
+    };
+};
 export declare function parseArgs(argv: string[]): {
     dryRun: boolean;
     force: boolean;

package/dist/esm/prepareCommand.js

@@ -1,4 +1,4 @@
-import { parseArgs as coreParseArgs, translateParseError, writeFileWithCheck } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError, writeFileWithCheck } from '@williamthorsen/nmr-core';
 import { assertCleanWorkingTree } from "./assertCleanWorkingTree.js";
 import { buildDependencyGraph } from "./buildDependencyGraph.js";
 import { buildReleaseSummary } from "./buildReleaseSummary.js";
@@ -11,301 +11,255 @@ import { releasePrepareMono } from "./releasePrepareMono.js";
 import { reportPrepare } from "./reportPrepare.js";
 import { validateConfig } from "./validateConfig.js";
 import { validateOnlyExcludesStrandedDependents } from "./validateOnlyExcludesStrandedDependents.js";
-const RELEASE_TAGS_FILE = "tmp/.release-tags";
-const RELEASE_SUMMARY_FILE = "tmp/.release-summary";
-const VALID_BUMP_TYPES = ["major", "minor", "patch"];
+export const RELEASE_TAGS_FILE = 'tmp/.release-tags';
+export const RELEASE_SUMMARY_FILE = 'tmp/.release-summary';
+const VALID_BUMP_TYPES = ['major', 'minor', 'patch'];
 const CANONICAL_SEMVER_PATTERN = /^\d+\.\d+\.\d+$/;
 function isReleaseType(value) {
-  return VALID_BUMP_TYPES.includes(value);
+    return VALID_BUMP_TYPES.includes(value);
 }
-function showHelp() {
-  console.info(`
-Usage: npx @williamthorsen/release-kit prepare [options]
-
-Options:
-  --dry-run             Run without modifying any files
-  --bump=major|minor|patch  Override the bump type for all workspaces
-  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps.
-                         Requires --only in monorepo mode (rejected when a 'project' block is configured).
-  --force               Release even when no commits or no bump-worthy commits exist
-                         since the last tag. Defaults to patch when --bump is not given;
-                         use --bump=X to release at a different level.
-  --no-git-checks, -n   Skip the clean-working-tree check
-  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only;
-                         rejected when a 'project' block is configured)
-  --with-release-notes  Also write per-workspace release-notes previews under {workspacePath}/docs/
-                         (docs/README.v{version}.md and docs/RELEASE_NOTES.v{version}.md).
-                         Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).
-  --help                Show this help message
-`);
-}
-const prepareFlagSchema = {
-  dryRun: { long: "--dry-run", type: "boolean" },
-  force: { long: "--force", type: "boolean" },
-  noGitChecks: {
-    long: "--no-git-checks",
-    type: "boolean",
-    short: "-n"
-  },
-  bump: { long: "--bump", type: "string" },
-  setVersion: { long: "--set-version", type: "string" },
-  only: { long: "--only", type: "string" },
-  withReleaseNotes: { long: "--with-release-notes", type: "boolean" },
-  help: { long: "--help", type: "boolean", short: "-h" }
+export const prepareFlagSchema = {
+    dryRun: { long: '--dry-run', type: 'boolean' },
+    force: { long: '--force', type: 'boolean' },
+    noGitChecks: {
+        long: '--no-git-checks',
+        type: 'boolean',
+        short: '-n',
+    },
+    bump: { long: '--bump', type: 'string' },
+    setVersion: { long: '--set-version', type: 'string' },
+    only: { long: '--only', type: 'string' },
+    withReleaseNotes: { long: '--with-release-notes', type: 'boolean' },
 };
-function parseArgs(argv) {
-  let parsed;
-  try {
-    parsed = coreParseArgs(argv, prepareFlagSchema);
-  } catch (error) {
-    throw new Error(translateParseError(error));
-  }
-  const { flags } = parsed;
-  if (flags.help) {
-    showHelp();
-    process.exit(0);
-  }
-  let bumpOverride;
-  if (flags.bump !== void 0) {
-    if (!isReleaseType(flags.bump)) {
-      throw new Error(`Invalid bump type "${flags.bump}". Must be one of: ${VALID_BUMP_TYPES.join(", ")}`);
+export function parseArgs(argv) {
+    const { flags } = parseArgsOrExit(argv, prepareFlagSchema);
+    let bumpOverride;
+    if (flags.bump !== undefined) {
+        if (!isReleaseType(flags.bump)) {
+            reportError(`Invalid bump type "${flags.bump}". Must be one of: ${VALID_BUMP_TYPES.join(', ')}`);
+            process.exit(1);
+        }
+        bumpOverride = flags.bump;
+    }
+    let setVersion;
+    if (flags.setVersion !== undefined) {
+        if (!CANONICAL_SEMVER_PATTERN.test(flags.setVersion)) {
+            reportError(`Invalid --set-version value "${flags.setVersion}". Must be canonical semver (N.N.N, no pre-release suffix).`);
+            process.exit(1);
+        }
+        setVersion = flags.setVersion;
+    }
+    let only;
+    if (flags.only !== undefined) {
+        only = flags.only.split(',');
     }
-    bumpOverride = flags.bump;
-  }
-  let setVersion;
-  if (flags.setVersion !== void 0) {
-    if (!CANONICAL_SEMVER_PATTERN.test(flags.setVersion)) {
-      throw new Error(
-        `Invalid --set-version value "${flags.setVersion}". Must be canonical semver (N.N.N, no pre-release suffix).`
-      );
+    if (setVersion !== undefined && bumpOverride !== undefined) {
+        reportError('--set-version cannot be combined with --bump');
+        process.exit(1);
+    }
+    if (setVersion !== undefined && flags.force) {
+        reportError('--set-version cannot be combined with --force');
+        process.exit(1);
     }
-    setVersion = flags.setVersion;
-  }
-  let only;
-  if (flags.only !== void 0) {
-    only = flags.only.split(",");
-  }
-  if (setVersion !== void 0 && bumpOverride !== void 0) {
-    throw new Error("--set-version cannot be combined with --bump");
-  }
-  if (setVersion !== void 0 && flags.force) {
-    throw new Error("--set-version cannot be combined with --force");
-  }
-  return {
-    dryRun: flags.dryRun,
-    force: flags.force,
-    noGitChecks: flags.noGitChecks,
-    bumpOverride,
-    only,
-    setVersion,
-    withReleaseNotes: flags.withReleaseNotes
-  };
+    return {
+        dryRun: flags.dryRun,
+        force: flags.force,
+        noGitChecks: flags.noGitChecks,
+        bumpOverride,
+        only,
+        setVersion,
+        withReleaseNotes: flags.withReleaseNotes,
+    };
 }
-function writeReleaseTags(tags, dryRun) {
-  if (tags.length === 0) {
-    return void 0;
-  }
-  return writeFileWithCheck(RELEASE_TAGS_FILE, tags.join("\n"), {
-    dryRun,
-    overwrite: true
-  });
+export function writeReleaseTags(tags, dryRun) {
+    if (tags.length === 0) {
+        return undefined;
+    }
+    return writeFileWithCheck(RELEASE_TAGS_FILE, tags.join('\n'), {
+        dryRun,
+        overwrite: true,
+    });
 }
-async function prepareCommand(argv) {
-  let dryRun;
-  let force;
-  let noGitChecks;
-  let bumpOverride;
-  let only;
-  let setVersion;
-  let withReleaseNotes;
-  try {
-    ({ dryRun, force, noGitChecks, bumpOverride, only, setVersion, withReleaseNotes } = parseArgs(argv));
-  } catch (error) {
-    console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-  const options = {
-    dryRun,
-    force,
-    ...bumpOverride === void 0 ? {} : { bumpOverride },
-    ...setVersion === void 0 ? {} : { setVersion },
-    ...withReleaseNotes ? { withReleaseNotes: true } : {}
-  };
-  if (dryRun) {
-    console.info("\n\u{1F50D} DRY RUN \u2014 no files will be modified\n");
-  }
-  if (!dryRun && !noGitChecks) {
+export async function prepareCommand(argv) {
+    const { dryRun, force, noGitChecks, bumpOverride, only, setVersion, withReleaseNotes } = parseArgs(argv);
+    const options = {
+        dryRun,
+        force,
+        ...(bumpOverride === undefined ? {} : { bumpOverride }),
+        ...(setVersion === undefined ? {} : { setVersion }),
+        ...(withReleaseNotes ? { withReleaseNotes: true } : {}),
+    };
+    if (dryRun) {
+        console.info('\n🔍 DRY RUN — no files will be modified\n');
+    }
+    if (!dryRun && !noGitChecks) {
+        try {
+            assertCleanWorkingTree();
+        }
+        catch (error) {
+            reportError(error instanceof Error ? error.message : String(error));
+            process.exit(1);
+        }
+    }
+    const userConfig = await loadAndValidateConfig();
+    let discoveredPaths;
     try {
-      assertCleanWorkingTree();
-    } catch (error) {
-      console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
-      process.exit(1);
+        discoveredPaths = await discoverWorkspaces();
+    }
+    catch (error) {
+        reportError(`Failed to discover workspaces: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    if (discoveredPaths === undefined) {
+        runSinglePackageMode(userConfig, options, only, dryRun);
+    }
+    else {
+        runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion, dryRun);
     }
-  }
-  const userConfig = await loadAndValidateConfig();
-  let discoveredPaths;
-  try {
-    discoveredPaths = await discoverWorkspaces();
-  } catch (error) {
-    console.error(`Error discovering workspaces: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-  if (discoveredPaths === void 0) {
-    runSinglePackageMode(userConfig, options, only, dryRun);
-  } else {
-    runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion, dryRun);
-  }
 }
 function runSinglePackageMode(userConfig, options, only, dryRun) {
-  if (only !== void 0) {
-    console.error("Error: --only is only supported for monorepo configurations");
-    process.exit(1);
-  }
-  if (options.force && options.bumpOverride === void 0) {
-    console.error(
-      "Error: --force without --bump is only supported for monorepo configurations. Use --bump=major|minor|patch to set the level for a single-package release."
-    );
-    process.exit(1);
-  }
-  const config = mergeSinglePackageConfig(userConfig);
-  runAndReport(() => releasePrepare(config, options), dryRun);
+    if (only !== undefined) {
+        reportError('--only is only supported for monorepo configurations');
+        process.exit(1);
+    }
+    if (options.force && options.bumpOverride === undefined) {
+        reportError('--force without --bump is only supported for monorepo configurations. ' +
+            'Use --bump=major|minor|patch to set the level for a single-package release.');
+        process.exit(1);
+    }
+    const config = mergeSinglePackageConfig(userConfig);
+    runAndReport(() => releasePrepare(config, options), dryRun);
 }
 function runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion, dryRun) {
-  let config;
-  try {
-    const rootPackage = readRootPackageVersion();
-    config = mergeMonorepoConfig(discoveredPaths, userConfig, rootPackage);
-  } catch (error) {
-    console.error(`Error resolving workspaces: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-  if (setVersion !== void 0 && config.project !== void 0) {
-    console.error(
-      "Error: --set-version cannot be combined with a project release. --set-version operates on a single workspace; a project release rolls up every contributing workspace. To use --set-version, run on a config without a `project` block."
-    );
-    process.exit(1);
-  }
-  if (only !== void 0 && config.project !== void 0) {
-    console.error(
-      "Error: --only cannot be combined with a project release. To release a single workspace, use a config without a `project` block, or run a full `prepare` (no --only) to include the project release."
-    );
-    process.exit(1);
-  }
-  if (only !== void 0) {
-    const knownNames = config.workspaces.map((w) => w.dir);
-    for (const name of only) {
-      if (!knownNames.includes(name)) {
-        console.error(`Error: Unknown workspace "${name}". Known workspaces: ${knownNames.join(", ")}`);
+    let config;
+    try {
+        const rootPackage = readRootPackageVersion();
+        config = mergeMonorepoConfig(discoveredPaths, userConfig, rootPackage);
+    }
+    catch (error) {
+        reportError(`Failed to resolve workspaces: ${error instanceof Error ? error.message : String(error)}`);
         process.exit(1);
-      }
     }
-    const graph = buildDependencyGraph(config.workspaces);
-    const violations = validateOnlyExcludesStrandedDependents(config.workspaces, only, graph, (workspace) => {
-      const tagPrefixes = [
-        workspace.tagPrefix,
-        ...workspace.legacyIdentities?.map((identity) => identity.tagPrefix) ?? []
-      ];
-      const result = getCommitsSinceTarget(tagPrefixes, workspace.paths);
-      return { has: result.commits.length > 0, tag: result.tag };
-    });
-    if (violations !== void 0) {
-      console.error("Error: --only excludes packages with changes that would be stranded by the release.");
-      console.error("The following packages must be added to --only or have their dependencies removed:");
-      for (const violation of violations) {
-        const since = violation.tag ?? "the beginning";
-        console.error(`  - ${violation.dir} (downstream of ${violation.downstreamOf}; has commits since ${since})`);
-      }
-      console.error("Alternatively, run `release-kit prepare` without --only to release everything.");
-      process.exit(1);
+    if (setVersion !== undefined && config.project !== undefined) {
+        reportError('--set-version cannot be combined with a project release. ' +
+            '--set-version operates on a single workspace; a project release rolls up every ' +
+            'contributing workspace. To use --set-version, run on a config without a `project` block.');
+        process.exit(1);
+    }
+    if (only !== undefined && config.project !== undefined) {
+        reportError('--only cannot be combined with a project release. ' +
+            'To release a single workspace, use a config without a `project` block, ' +
+            'or run a full `prepare` (no --only) to include the project release.');
+        process.exit(1);
     }
-    config.workspaces = config.workspaces.filter((w) => only.includes(w.dir));
-  }
-  if (setVersion !== void 0) {
-    if (only === void 0) {
-      console.error("Error: --set-version requires --only in monorepo mode");
-      process.exit(1);
+    if (only !== undefined) {
+        const knownNames = config.workspaces.map((w) => w.dir);
+        for (const name of only) {
+            if (!knownNames.includes(name)) {
+                reportError(`Unknown workspace "${name}". Known workspaces: ${knownNames.join(', ')}`);
+                process.exit(1);
+            }
+        }
+        const graph = buildDependencyGraph(config.workspaces);
+        const violations = validateOnlyExcludesStrandedDependents(config.workspaces, only, graph, (workspace) => {
+            const tagPrefixes = [
+                workspace.tagPrefix,
+                ...(workspace.legacyIdentities?.map((identity) => identity.tagPrefix) ?? []),
+            ];
+            const result = getCommitsSinceTarget(tagPrefixes, workspace.paths);
+            return { has: result.commits.length > 0, tag: result.tag };
+        });
+        if (violations !== undefined) {
+            reportError('--only excludes packages with changes that would be stranded by the release.');
+            process.stderr.write('The following packages must be added to --only or have their dependencies removed:\n');
+            for (const violation of violations) {
+                const since = violation.tag ?? 'the beginning';
+                process.stderr.write(`  - ${violation.dir} (downstream of ${violation.downstreamOf}; has commits since ${since})\n`);
+            }
+            process.stderr.write('Alternatively, run `release-kit prepare` without --only to release everything.\n');
+            process.exit(1);
+        }
+        config.workspaces = config.workspaces.filter((w) => only.includes(w.dir));
     }
-    if (config.workspaces.length !== 1) {
-      console.error(
-        `Error: --set-version requires --only to match exactly one workspace; matched ${config.workspaces.length}`
-      );
-      process.exit(1);
+    if (setVersion !== undefined) {
+        if (only === undefined) {
+            reportError('--set-version requires --only in monorepo mode');
+            process.exit(1);
+        }
+        if (config.workspaces.length !== 1) {
+            reportError(`--set-version requires --only to match exactly one workspace; matched ${config.workspaces.length}`);
+            process.exit(1);
+        }
     }
-  }
-  runAndReport(() => releasePrepareMono(config, options), dryRun);
+    runAndReport(() => releasePrepareMono(config, options), dryRun);
 }
 async function loadAndValidateConfig() {
-  let rawConfig;
-  try {
-    rawConfig = await loadConfig();
-  } catch (error) {
-    console.error(`Error loading config: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-  if (rawConfig === void 0) {
-    return void 0;
-  }
-  const { config, errors, warnings } = validateConfig(rawConfig);
-  if (errors.length > 0) {
-    console.error("Invalid config:");
-    for (const err of errors) {
-      console.error(`  \u274C ${err}`);
+    let rawConfig;
+    try {
+        rawConfig = await loadConfig();
+    }
+    catch (error) {
+        reportError(`Failed to load config: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    if (rawConfig === undefined) {
+        return undefined;
+    }
+    const { config, errors, warnings } = validateConfig(rawConfig);
+    if (errors.length > 0) {
+        process.stderr.write('Invalid config:\n');
+        for (const err of errors) {
+            process.stderr.write(`  ❌ ${err}\n`);
+        }
+        process.exit(1);
+    }
+    for (const warning of warnings) {
+        console.warn(`  ⚠️  ${warning}`);
     }
-    process.exit(1);
-  }
-  for (const warning of warnings) {
-    console.warn(`  \u26A0\uFE0F  ${warning}`);
-  }
-  return config;
+    return config;
 }
 function runAndReport(execute, dryRun) {
-  let result;
-  try {
-    result = execute();
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-  process.stdout.write(reportPrepare(result) + "\n");
-  const writeResult = writeReleaseTags(result.tags, dryRun);
-  if (writeResult?.outcome === "failed") {
-    console.error(`Error writing release tags: ${writeResult.error ?? "unknown error"}`);
-    process.exit(1);
-  }
-  if (writeResult) {
-    if (dryRun) {
-      console.info(dim(`  [dry-run] Would write ${RELEASE_TAGS_FILE}: ${result.tags.join(" ")}`));
-    } else {
-      console.info(dim(`  Wrote ${RELEASE_TAGS_FILE}: ${result.tags.join(" ")}`));
-      console.info(dim(`
-   Release tags file: ${RELEASE_TAGS_FILE}`));
+    let result;
+    try {
+        result = execute();
     }
-  }
-  const summary = buildReleaseSummary(result);
-  if (summary.length > 0) {
-    const summaryResult = writeFileWithCheck(RELEASE_SUMMARY_FILE, summary, {
-      dryRun,
-      overwrite: true
-    });
-    if (summaryResult.outcome === "failed") {
-      console.error(`Error writing release summary: ${summaryResult.error ?? "unknown error"}`);
-      process.exit(1);
+    catch (error) {
+        reportError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
     }
-    if (dryRun) {
-      console.info(dim(`  [dry-run] Would write ${RELEASE_SUMMARY_FILE}`));
-    } else {
-      console.info(dim(`  Wrote ${RELEASE_SUMMARY_FILE}`));
+    process.stdout.write(reportPrepare(result) + '\n');
+    const writeResult = writeReleaseTags(result.tags, dryRun);
+    if (writeResult?.outcome === 'failed') {
+        reportError(`Failed to write release tags: ${writeResult.error ?? 'unknown error'}`);
+        process.exit(1);
+    }
+    if (writeResult) {
+        if (dryRun) {
+            console.info(dim(`  [dry-run] Would write ${RELEASE_TAGS_FILE}: ${result.tags.join(' ')}`));
+        }
+        else {
+            console.info(dim(`  Wrote ${RELEASE_TAGS_FILE}: ${result.tags.join(' ')}`));
+            console.info(dim(`\n   Release tags file: ${RELEASE_TAGS_FILE}`));
+        }
+    }
+    const summary = buildReleaseSummary(result);
+    if (summary.length > 0) {
+        const summaryResult = writeFileWithCheck(RELEASE_SUMMARY_FILE, summary, {
+            dryRun,
+            overwrite: true,
+        });
+        if (summaryResult.outcome === 'failed') {
+            reportError(`Failed to write release summary: ${summaryResult.error ?? 'unknown error'}`);
+            process.exit(1);
+        }
+        if (dryRun) {
+            console.info(dim(`  [dry-run] Would write ${RELEASE_SUMMARY_FILE}`));
+        }
+        else {
+            console.info(dim(`  Wrote ${RELEASE_SUMMARY_FILE}`));
+        }
+    }
+    if (writeResult && !dryRun) {
+        process.stderr.write(`\nRun 'release-kit commit' to create the release commit.\n`);
     }
-  }
-  if (writeResult && !dryRun) {
-    console.error(`
-Run 'release-kit commit' to create the release commit.`);
-  }
 }
-export {
-  RELEASE_SUMMARY_FILE,
-  RELEASE_TAGS_FILE,
-  parseArgs,
-  prepareCommand,
-  writeReleaseTags
-};

package/dist/esm/previewTagPrefixes.d.ts

@@ -1,4 +1,4 @@
-import type { UndeclaredTagPrefix } from './detectUndeclaredTagPrefixes.ts';
+import type { UndeclaredTagPrefix } from './detectUndeclaredTagPrefixes.js';
 export interface TagPrefixPreviewRow {
     workspacePath: string;
     dir: string;