ci(release): better parsing and exclusions

.github/workflows/release.yml

@@ -5,6 +5,7 @@ on:
       package:
         description: 'The published name of a single package to release'
         type: choice
+        required: false
         options:
           - discord.js
           - '@discordjs/brokers'
@@ -20,6 +21,11 @@ on:
           - '@discordjs/util'
           - '@discordjs/voice'
           - '@discordjs/ws'
+      exclude:
+        description: 'Comma separated list of packages to exclude from release (if not depended upon)'
+        required: false
+        type: string
+        default: '@discordjs/docgen,@discordjs/next'
 jobs:
   npm-publish:
     name: npm publish

packages/actions/package.json

@@ -47,6 +47,7 @@
 		"@discordjs/scripts": "workspace:^",
 		"@vercel/blob": "^0.22.3",
 		"@vercel/postgres": "^0.8.0",
+		"commander": "^12.1.0",
 		"meilisearch": "^0.38.0",
 		"p-limit": "^5.0.0",
 		"tslib": "^2.6.2",

packages/actions/src/releasePackages/action.yml

@@ -3,6 +3,8 @@ description: 'Tags and releases any unreleased packages'
 inputs:
   package:
     description: 'The published name of a single package to release'
+  exclude:
+    description: 'Comma separated list of packages to exclude from release (if not depended upon)'
 runs:
   using: node20
   main: ../../dist/releasePackages/index.js

packages/actions/src/releasePackages/generateReleaseTree.ts

@@ -85,7 +85,7 @@ async function getReleaseEntries() {
 	return releaseEntries;
 }
 
-export async function generateReleaseTree(packageName?: string) {
+export async function generateReleaseTree(packageName?: string, exclude?: string[]) {
 	let releaseEntries = await getReleaseEntries();
 	// Try to early return if the package doesn't have deps
 	if (packageName) {
@@ -135,6 +135,31 @@ export async function generateReleaseTree(packageName?: string) {
 		releaseEntries = unreleased;
 	}
 
+	// Prune exclusions
+	if (exclude) {
+		const neededPackages = new Set<string>();
+		const excludedReleaseTree: ReleaseEntry[][] = [];
+
+		for (const releaseBranch of releaseTree.reverse()) {
+			const newThisBranch: ReleaseEntry[] = [];
+
+			for (const entry of releaseBranch) {
+				if (exclude.includes(entry.name) && !neededPackages.has(entry.name)) {
+					continue;
+				}
+
+				newThisBranch.push(entry);
+				for (const dep of entry.dependsOn ?? []) {
+					neededPackages.add(dep);
+				}
+			}
+
+			if (newThisBranch.length) excludedReleaseTree.unshift(newThisBranch);
+		}
+
+		return excludedReleaseTree;
+	}
+
 	if (!packageName) {
 		return releaseTree;
 	}

packages/actions/src/releasePackages/index.ts

@@ -1,13 +1,24 @@
-import process from 'node:process';
 import { getInput } from '@actions/core';
+import { program } from 'commander';
 import { generateReleaseTree } from './generateReleaseTree.js';
 import { releasePackage } from './releasePackage.js';
 
-const argInput = process.argv[2];
-const useableArg = argInput === 'discord.js' || argInput?.startsWith('@discordjs/');
-const packageName = getInput('package') || useableArg ? argInput : '';
+program
+	.name('release packages')
+	.description('releases monorepo packages with proper sequencing')
+	.argument('[package]', "release a specific package (and it's dependencies)", getInput('package'))
+	.option(
+		'-e, --exclude <packages...>',
+		'exclude specific packages from releasing (will still release if necessary for another package)',
+		getInput('exclude').split(','),
+	)
+	.parse();
 
-const tree = await generateReleaseTree(packageName);
+const { exclude } = program.opts<{ exclude: string[] }>();
+const packageName = program.args[0]!;
+
+const tree = await generateReleaseTree(packageName, exclude);
+console.log(tree);
 for (const branch of tree) {
 	console.log(`Releasing ${branch.map((entry) => `${entry.name}@${entry.version}`).join(', ')}`);
 	await Promise.all(branch.map(async (release) => releasePackage(release)));