tegami 1.1.2 → 1.1.3

package/dist/cli/index.d.ts

@@ -1,4 +1,4 @@
-import { f as Tegami, j as Draft, t as Awaitable, v as PublishPlan } from "../types-B50RK1rR.js";
+import { f as Tegami, j as Draft, t as Awaitable, v as PublishPlan } from "../types-DEyZ2r-2.js";
 
 //#region src/cli/index.d.ts
 interface TegamiCLIOptions {

package/dist/cli/index.js

@@ -279,11 +279,12 @@ function createTegamiCliRegistry(tegami) {
 			};
 			commands.set(definition.path.join("\0"), definition);
 			const api = {
-				option(name, { short, description = "", type }) {
+				option(name, { short, description = "", type, multiple }) {
 					definition.options.push({
 						name,
 						short,
 						type,
+						multiple,
 						description
 					});
 					return api;
@@ -295,6 +296,14 @@ function createTegamiCliRegistry(tegami) {
 					});
 					return api;
 				},
+				positionals(name) {
+					definition.positionals.push({
+						name,
+						required: false,
+						multiple: true
+					});
+					return api;
+				},
 				action(fn) {
 					definition.action = fn;
 				}
@@ -332,7 +341,12 @@ function createTegamiCliRegistry(tegami) {
 	};
 }
 function formatUsage(command) {
-	return [...command.path, ...command.positionals.map((positional) => positional.required ? `<${positional.name}>` : `[${positional.name}]`)].join(" ");
+	const s = [...command.path];
+	for (const positional of command.positionals) {
+		let c = positional.multiple ? `...${positional.name}` : positional.name;
+		s.push(positional.required ? `<${c}>` : `[${c}]`);
+	}
+	return s.join(" ");
 }
 function findCommand(commands, argv) {
 	if (argv.length === 0) return commands.get("");
@@ -343,28 +357,34 @@ function findCommand(commands, argv) {
 	}
 }
 function parseCommandArgs(command, args) {
-	const optionConfig = { help: {
+	const optionsConfig = { help: {
 		type: "boolean",
 		short: "h"
 	} };
-	for (const option of command.options) optionConfig[option.name] = option.short ? {
-		type: option.type,
-		short: option.short
-	} : { type: option.type };
+	for (const option of command.options) {
+		const config = optionsConfig[option.name] = { type: option.type };
+		if (option.short) config.short = option.short;
+		if (option.multiple) config.multiple = true;
+	}
 	const parsed = parseArgs({
 		args,
-		options: optionConfig,
+		options: optionsConfig,
 		strict: true,
 		allowPositionals: command.positionals.length > 0
 	});
 	const positionals = {};
-	if (parsed.positionals.length > command.positionals.length) throw new Error("Too many arguments");
 	for (const positional of command.positionals) {
+		if (positional.multiple) {
+			const value = positionals[positional.name] = [];
+			while (parsed.positionals.length > 0) value.push(parsed.positionals.shift());
+			continue;
+		}
 		const value = parsed.positionals.shift();
 		if (value === void 0 && positional.required) throw new Error(`missing required argument: ${positional.name}`);
 		if (value === void 0) continue;
 		positionals[positional.name] = value;
 	}
+	if (parsed.positionals.length > 0) throw new Error("Too many arguments");
 	return {
 		values: parsed.values,
 		positionals
@@ -471,9 +491,10 @@ function registerCoreCommands(cli, tegami, options) {
 	cli.command("publish", { description: "publish packages from the publish lock" }).option("dry-run", {
 		type: "boolean",
 		description: "validate the publish lock without publishing"
-	}).action(async ({ values }) => {
+	}).positionals("packages").action(async ({ values, positionals }) => {
 		await publishPackages(tegami, {
 			dryRun: values["dry-run"],
+			packages: positionals.packages?.length ? positionals.packages : void 0,
 			cli: options
 		});
 	});
@@ -538,7 +559,10 @@ async function publishPackages(tegami, options) {
 	intro(dryRun ? "Publish packages (dry run)" : "Publish packages");
 	const s = spinner();
 	s.start(dryRun ? "Validating publish lock" : "Publishing packages");
-	const plan = customPublish ? await customPublish() : await tegami.publish({ dryRun });
+	const plan = customPublish ? await customPublish() : await tegami.publish({
+		dryRun,
+		packages: options.packages
+	});
 	if (plan === "skipped") {
 		s.stop(dryRun ? "No publish lock to validate" : "Nothing to publish");
 		outro(`No publishable packages were found in ${context.lockPath}.`);

package/dist/generators/simple.d.ts

@@ -1,4 +1,4 @@
-import { r as LogGenerator } from "../types-B50RK1rR.js";
+import { r as LogGenerator } from "../types-DEyZ2r-2.js";
 
 //#region src/generators/simple.d.ts
 declare function simpleGenerator(): LogGenerator;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as WorkspacePackage, M as DraftPolicy, N as PackageDraft, O as PackageGraph, P as BumpType, _ as PublishOptions, a as PublishPreflight, b as TegamiContext, c as TegamiPluginOption, d as GenerateChangelogOptions, f as Tegami, g as PackagePublishResult, h as PackagePublishPlan, i as PackageOptions, j as Draft, k as PackageGroup, m as PublishLock, n as GroupOptions, o as TegamiOptions, p as tegami, r as LogGenerator, s as TegamiPlugin, v as PublishPlan, y as CommitChangelog } from "./types-B50RK1rR.js";
+import { A as WorkspacePackage, M as DraftPolicy, N as PackageDraft, O as PackageGraph, P as BumpType, _ as PublishOptions, a as PublishPreflight, b as TegamiContext, c as TegamiPluginOption, d as GenerateChangelogOptions, f as Tegami, g as PackagePublishResult, h as PackagePublishPlan, i as PackageOptions, j as Draft, k as PackageGroup, m as PublishLock, n as GroupOptions, o as TegamiOptions, p as tegami, r as LogGenerator, s as TegamiPlugin, v as PublishPlan, y as CommitChangelog } from "./types-DEyZ2r-2.js";
 export { type BumpType, type CommitChangelog, type Draft, type DraftPolicy, GenerateChangelogOptions, type GroupOptions, type LogGenerator, type PackageDraft, PackageGraph, type PackageGroup, type PackageOptions, type PackagePublishPlan, type PackagePublishResult, type PublishLock, type PublishOptions, type PublishPlan, type PublishPreflight, Tegami, type TegamiContext, type TegamiOptions, type TegamiPlugin, type TegamiPluginOption, WorkspacePackage, tegami };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { n as generateFromCommits } from "./generate-Bg86OJP4.js";
 import { r as handlePluginError } from "./error-BhMYq9iW.js";
 import { a as parseChangelogFile, o as readChangelogEntries, t as createDraft } from "./draft-CzUiQasJ.js";
-import { a as runPreflights, i as publishPlanStatus, o as runPublishPlan, r as initPublishPlan, t as npm } from "./npm-DoPhFKji.js";
+import { a as runPreflights, i as publishPlanStatus, o as runPublishPlan, r as initPublishPlan, t as npm } from "./npm-CaBYeOeV.js";
 import { n as WorkspacePackage, t as PackageGraph } from "./graph-BmXTJZxx.js";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import path, { join } from "node:path";
@@ -98,9 +98,9 @@ function tegami(options = {}) {
 			}
 			return createDraft(changelogs, context);
 		},
-		async publishStatus() {
+		async publishStatus(publishOptions = {}) {
 			const context = await getContextResolved();
-			const plan = await initPublishPlan(context, {});
+			const plan = await initPublishPlan(context, publishOptions);
 			if (!plan) return "idle";
 			await runPreflights(context, plan);
 			return publishPlanStatus(plan, context);
@@ -115,9 +115,9 @@ function tegami(options = {}) {
 			if (Array.from(plan.packages.values()).every((pkg) => pkg.publishResult.type === "skipped")) return "skipped";
 			return plan;
 		},
-		async cleanup() {
+		async cleanup(publishOptions = {}) {
 			const context = await getContextResolved();
-			const plan = await initPublishPlan(context, {});
+			const plan = await initPublishPlan(context, publishOptions);
 			if (!plan) return {
 				state: "skipped",
 				reason: "no-plan"

package/dist/{npm-DoPhFKji.js → npm-CaBYeOeV.js}

@@ -8,7 +8,7 @@ import fs, { readFile, writeFile } from "node:fs/promises";
 import path, { join } from "node:path";
 import { x } from "tinyexec";
 import * as semver$1 from "semver";
-import { parse as parse$1, parseDocument, stringify } from "yaml";
+import { parseDocument } from "yaml";
 import { detect } from "package-manager-detector";
 import { tmpdir } from "node:os";
 import { intro, note, outro } from "@clack/prompts";
@@ -59,82 +59,115 @@ async function initPublishPlan(context, options) {
 	return plan;
 }
 function resolvePublishTargets(plan) {
-	const ordered = [];
-	const scanned = /* @__PURE__ */ new Set();
-	function scan(id, stack) {
+	/** the iteration order = publish order */
+	const orderedMap = /* @__PURE__ */ new Map();
+	/** package id -> true while scanning hard wait, false while scanning optional wait */
+	const stack = /* @__PURE__ */ new Map();
+	function scan(id) {
 		const preflight = plan.packages.get(id)?.preflight;
 		if (!preflight || !preflight.shouldPublish) return;
-		if (stack.has(id)) throw new Error(`circular reference of deps: ${[...stack, id].join(" -> ")}`);
-		if (scanned.has(id)) return;
+		switch (stack.get(id)) {
+			case true: throw new Error(`circular reference of deps: ${[...stack.keys(), id].join(" -> ")}`);
+			case false: return;
+		}
+		if (orderedMap.has(id)) return;
+		let split = false;
 		if (preflight.wait) {
-			stack.add(id);
-			for (const dep of preflight.wait) scan(dep, stack);
-			stack.delete(id);
+			stack.set(id, true);
+			split ||= preflight.wait.length > 0;
+			for (const dep of preflight.wait) scan(dep);
+		}
+		if (preflight.optionalWait) {
+			stack.set(id, false);
+			split ||= preflight.optionalWait.length > 0;
+			for (const dep of preflight.optionalWait) scan(dep);
 		}
-		ordered.push(id);
-		scanned.add(id);
+		stack.delete(id);
+		orderedMap.set(id, { split });
 	}
-	const stack = /* @__PURE__ */ new Set();
-	for (const id of plan.packages.keys()) scan(id, stack);
-	return ordered;
+	for (const id of plan.packages.keys()) scan(id);
+	return orderedMap;
 }
 async function runPublishPlan(context, plan) {
-	const { dryRun = false } = plan.options;
-	const onPublishResult = async (pkg, publishResult) => {
-		const packagePlan = plan.packages.get(pkg.id);
-		if (!packagePlan) return;
-		packagePlan.publishResult = publishResult;
-		if (publishResult.type === "skipped") return;
-		for (const plugin of context.plugins) await handlePluginError(plugin, "afterPublish", () => plugin.afterPublish?.call(context, {
-			pkg,
-			plan
-		}));
-	};
-	publishLoop: for (const id of resolvePublishTargets(plan)) {
+	const { dryRun = false, unstable_maxChunk = 5 } = plan.options;
+	for (const plugin of context.plugins) await handlePluginError(plugin, "beforePublishAll", () => plugin.beforePublishAll?.call(context, { plan }));
+	async function publish(pkg) {
+		if (dryRun) return { type: "published" };
+		try {
+			for (const plugin of context.plugins) if (await handlePluginError(plugin, "willPublish", () => plugin.willPublish?.call(context, { pkg })) === false) return { type: "skipped" };
+			for (const plugin of context.plugins) {
+				const publishResult = await handlePluginError(plugin, "publish", () => plugin.publish?.call(context, {
+					pkg,
+					plan
+				}));
+				if (publishResult) return publishResult;
+			}
+		} catch (e) {
+			return {
+				type: "failed",
+				error: e instanceof Error ? e.message : String(e)
+			};
+		}
+		return {
+			type: "failed",
+			error: `There is no plugin to publish package "${pkg.id}", please make sure the package has a supported provider plugin.`
+		};
+	}
+	let promises = [];
+	for (const [id, { split }] of resolvePublishTargets(plan)) {
 		const pkg = context.graph.get(id);
-		if (dryRun) {
-			await onPublishResult(pkg, { type: "published" });
-			continue;
+		const packagePlan = plan.packages.get(pkg.id);
+		if (!pkg || !packagePlan) continue;
+		if (split || promises.length >= unstable_maxChunk) {
+			await Promise.all(promises);
+			promises = [];
 		}
-		for (const plugin of context.plugins) if (await handlePluginError(plugin, "willPublish", () => plugin.willPublish?.call(context, { pkg })) === false) continue publishLoop;
-		for (const plugin of context.plugins) {
-			const publishResult = await handlePluginError(plugin, "publish", () => plugin.publish?.call(context, {
+		promises.push(publish(pkg).then(async (result) => {
+			packagePlan.publishResult = result;
+			if (result.type === "skipped") return;
+			for (const plugin of context.plugins) await handlePluginError(plugin, "afterPublish", () => plugin.afterPublish?.call(context, {
 				pkg,
 				plan
 			}));
-			if (publishResult) {
-				await onPublishResult(pkg, publishResult);
-				continue publishLoop;
-			}
-		}
-		await onPublishResult(pkg, {
-			type: "failed",
-			error: `There is no plugin to publish package "${pkg.id}", please make sure the package has a supported provider plugin.`
-		});
+		}));
 	}
+	await Promise.all(promises);
 	for (const packagePlan of plan.packages.values()) packagePlan.publishResult ??= { type: "skipped" };
 	for (const plugin of context.plugins) await handlePluginError(plugin, "afterPublishAll", () => plugin.afterPublishAll?.call(context, { plan }));
 }
 async function runPreflights(context, plan) {
-	const promises = [];
-	for (const [id, packagePlan] of plan.packages) {
-		const pkg = context.graph.get(id);
+	const { graph } = context;
+	await Promise.all(Array.from(plan.packages, async ([id, packagePlan]) => {
+		const pkg = graph.get(id);
 		packagePlan.preflight = { shouldPublish: false };
-		if (!packagePlan.updated) continue;
-		promises.push((async () => {
-			for (const plugin of context.plugins) {
-				const res = await handlePluginError(plugin, "publishPreflight", () => plugin.publishPreflight?.call(context, {
-					pkg,
-					plan
-				}));
-				if (res) {
-					packagePlan.preflight = res;
-					break;
-				}
+		if (!packagePlan.updated) return;
+		for (const plugin of context.plugins) {
+			const res = await handlePluginError(plugin, "publishPreflight", () => plugin.publishPreflight?.call(context, {
+				pkg,
+				plan
+			}));
+			if (res) {
+				packagePlan.preflight = res;
+				break;
 			}
-		})());
+		}
+	}));
+	if (plan.options.packages?.length) {
+		const only = /* @__PURE__ */ new Set();
+		function addOnly(id) {
+			if (only.has(id)) return;
+			const preflight = plan.packages.get(id)?.preflight;
+			if (!preflight) return;
+			only.add(id);
+			if (preflight.wait) for (const dep of preflight.wait) addOnly(dep);
+			if (preflight.optionalWait) for (const dep of preflight.optionalWait) addOnly(dep);
+		}
+		for (const name of plan.options.packages) for (const pkg of graph.getByName(name)) addOnly(pkg.id);
+		for (const [id, packagePlan] of plan.packages) {
+			if (only.has(id)) continue;
+			packagePlan.preflight.shouldPublish = false;
+		}
 	}
-	await Promise.all(promises);
 	for (const plugin of context.plugins) await handlePluginError(plugin, "afterPreflight", () => plugin.afterPreflight?.call(context, { plan }));
 }
 async function publishPlanStatus(plan, context) {
@@ -752,9 +785,10 @@ async function resolveNpmGraph(cwd, client) {
 			if (isNodeError(error) && error.code === "ENOENT") return void 0;
 			throw error;
 		});
-		const data = content && assertPnpmWorkspace(parse$1(content));
-		if (data) {
-			catalogSources.push(createPnpmCatalogSource(pnpmWorkspacePath, data));
+		if (content) {
+			const doc = parseDocument(content);
+			const data = assertPnpmWorkspace(doc.toJSON());
+			catalogSources.push(createPnpmCatalogSource(pnpmWorkspacePath, doc));
 			patterns.push(...data.packages ?? []);
 		}
 	} else if (client === "yarn") {
@@ -846,24 +880,26 @@ async function readManifest(packagePath) {
 	assertPackageManifest(parsed);
 	return parsed;
 }
-function createPnpmCatalogSource(filePath, workspace) {
+function createPnpmCatalogSource(filePath, doc) {
 	return {
 		resolve(name, catalogName) {
-			if (catalogName === "default") return workspace.catalog?.[name];
-			return workspace.catalogs?.[catalogName]?.[name];
+			const value = doc.getIn(catalogName === "default" ? ["catalog", name] : [
+				"catalogs",
+				catalogName,
+				name
+			]);
+			return typeof value === "string" ? value : void 0;
 		},
 		setRange(name, catalogName, range) {
-			if (catalogName === "default") {
-				workspace.catalog ??= {};
-				workspace.catalog[name] = range;
-			} else {
-				workspace.catalogs ??= {};
-				workspace.catalogs[catalogName] ??= {};
-				workspace.catalogs[catalogName][name] = range;
-			}
+			doc.setIn(catalogName === "default" ? ["catalog", name] : [
+				"catalogs",
+				catalogName,
+				name
+			], range);
 		},
 		async write() {
-			await writeFile(filePath, `${stringify(workspace, { lineWidth: 0 }).trim()}\n`);
+			const output = doc.toString();
+			await writeFile(filePath, output.endsWith("\n") ? output : `${output}\n`);
 		}
 	};
 }
@@ -1035,8 +1071,13 @@ function npm({ client: defaultClient, onBreakPeerDep = "set", updateLockFile = t
 			active = true;
 		},
 		async publishPreflight({ pkg }) {
-			if (!(pkg instanceof NpmPackage)) return;
-			return { shouldPublish: pkg.version !== void 0 && pkg.manifest.private !== true };
+			if (!(pkg instanceof NpmPackage) || !this.npm?.graph) return;
+			const optionalWait = [];
+			for (const { linked } of pkg.listDependencies(this.npm.graph)) if (linked) optionalWait.push(linked.id);
+			return {
+				shouldPublish: pkg.version !== void 0 && pkg.manifest.private !== true,
+				optionalWait: optionalWait.length > 0 ? optionalWait : void 0
+			};
 		},
 		resolvePlanStatus({ plan }) {
 			if (!active) return;

package/dist/plugins/cargo.d.ts

@@ -1,2 +1,2 @@
-import { D as cargo, E as CargoPluginOptions, T as CargoPackage, w as CargoGraph } from "../types-B50RK1rR.js";
+import { D as cargo, E as CargoPluginOptions, T as CargoPackage, w as CargoGraph } from "../types-DEyZ2r-2.js";
 export { CargoGraph, CargoPackage, CargoPluginOptions, cargo };

package/dist/plugins/git.d.ts

@@ -1,4 +1,4 @@
-import { s as TegamiPlugin } from "../types-B50RK1rR.js";
+import { s as TegamiPlugin } from "../types-DEyZ2r-2.js";
 
 //#region src/plugins/git.d.ts
 interface GitPluginOptions {

package/dist/plugins/github.d.ts

@@ -1,4 +1,4 @@
-import { A as WorkspacePackage, b as TegamiContext, j as Draft, s as TegamiPlugin, t as Awaitable, v as PublishPlan } from "../types-B50RK1rR.js";
+import { A as WorkspacePackage, b as TegamiContext, j as Draft, s as TegamiPlugin, t as Awaitable, v as PublishPlan } from "../types-DEyZ2r-2.js";
 import { GitPluginOptions } from "./git.js";
 
 //#region src/plugins/github.d.ts
@@ -24,7 +24,7 @@ interface VersionPullRequestOptions {
    */
   forceCreate?: boolean;
   /**
-   * Pull request branch.
+   * Pull request branch. Publish group PRs are created under `<branch>/`.
    *
    * @default "tegami/version-packages"
    */
@@ -35,9 +35,24 @@ interface VersionPullRequestOptions {
    * @default "main"
    */
   base?: string;
-  /** Override details for "Version Packages" PR. */
+  /**
+   * Publish groups to split into separate version PRs, each entry is a package (or a list of
+   * packages) to version & publish together. Packages not covered by any group are collected
+   * into an extra "unlisted packages" PR.
+   *
+   * Merging a group PR publishes only its members, the remaining PRs are re-synced on every
+   * publish run until all of them are merged & published.
+   */
+  groups?: (string | string[])[];
+  /**
+   * Override details for a version PR.
+   *
+   * Only called at version-time: publish group PRs re-synced at publish-time keep the stored
+   * title and use a default body.
+   */
   create?: (this: TegamiContext, opts: {
     draft: Draft;
+    publishGroup?: string[];
   }) => Awaitable<VersionPullRequest>;
 }
 /** Options for creating GitHub releases after a successful publish. */

package/dist/plugins/github.js

@@ -3,7 +3,7 @@ import { t as changelogFilename } from "../generate-Bg86OJP4.js";
 import { a as cached, n as execFailure, o as isCI } from "../error-BhMYq9iW.js";
 import { o as readChangelogEntries, t as createDraft } from "../draft-CzUiQasJ.js";
 import { git } from "./git.js";
-import { n as createVersionRequestBody, r as hasGitChanges, t as commitVersionBranchChanges } from "../version-request-oxy16TJ1.js";
+import { t as onVersionRequest } from "../version-request-DlLpLLK3.js";
 import { readFile, writeFile } from "node:fs/promises";
 import { basename, join, relative, resolve } from "node:path";
 import { x } from "tinyexec";
@@ -346,7 +346,37 @@ function github(options = {}) {
 	function getRenderer(context) {
 		return renderer ??= createChangelogRenderer(context);
 	}
-	const cliSnapshots = /* @__PURE__ */ new Map();
+	const versionRequests = onVersionRequest({
+		name: "github",
+		summary: "Merge this PR to publish the versioned packages.",
+		options: options.versionPr,
+		enabled(context) {
+			const { repo, token } = context.github ?? {};
+			return Boolean(repo && token);
+		},
+		find(context, { head }) {
+			const { repo, token } = context.github;
+			return findOpenPullRequest(repo, head, token);
+		},
+		create(context, request) {
+			const { repo, token } = context.github;
+			return createPullRequest(repo, {
+				title: request.title,
+				body: request.body,
+				head: request.head,
+				base: request.base,
+				token
+			});
+		},
+		update(context, number, request) {
+			const { repo, token } = context.github;
+			return updatePullRequest(repo, number, {
+				title: request.title,
+				body: request.body,
+				token
+			});
+		}
+	});
 	return [git(options), {
 		name: "github",
 		init() {
@@ -356,6 +386,7 @@ function github(options = {}) {
 			};
 		},
 		async resolvePlanStatus({ plan }) {
+			if (versionRequests.resolvePlanStatus() === "pending") return "pending";
 			const { repo, token } = this.github;
 			if (!repo || !token || releaseOptions === false) return;
 			const requiredTags = /* @__PURE__ */ new Set();
@@ -430,37 +461,16 @@ function github(options = {}) {
 			if (result.exitCode !== 0) throw execFailure("Failed to configure git remote for GitHub Actions.", result);
 		},
 		initCliDraft() {
-			for (const pkg of this.graph.getPackages()) cliSnapshots.set(pkg.id, pkg.version);
+			versionRequests.initCliDraft.call(this);
 		},
-		async applyCliDraft(draft) {
-			const config = options.versionPr ?? {};
-			if (config === false || !(config.forceCreate || isCI()) || !await hasGitChanges(this.cwd)) return;
-			const repo = this.github?.repo;
-			const { branch = "tegami/version-packages", base = "main" } = config;
-			const basePR = await config.create?.call(this, { draft });
-			const pr = {
-				title: basePR?.title ?? "Version Packages",
-				body: basePR?.body ?? createVersionRequestBody(draft, this, cliSnapshots, "Merge this PR to publish the versioned packages.")
-			};
-			await commitVersionBranchChanges(this.cwd, branch, pr.title);
-			const token = this.github?.token;
-			if (!repo) return;
-			const openPr = await findOpenPullRequest(repo, branch, token);
-			if (openPr !== void 0) {
-				await updatePullRequest(repo, openPr, {
-					title: pr.title,
-					body: pr.body,
-					token
-				});
-				return;
-			}
-			await createPullRequest(repo, {
-				title: pr.title,
-				body: pr.body,
-				head: branch,
-				base,
-				token
-			});
+		applyCliDraft(draft) {
+			return versionRequests.applyCliDraft.call(this, draft);
+		},
+		initPublishPlan(opts) {
+			versionRequests.initPublishPlan.call(this, opts);
+		},
+		beforePublishAll(opts) {
+			return versionRequests.beforePublishAll.call(this, opts);
 		}
 	}];
 }

package/dist/plugins/gitlab.d.ts

@@ -1,4 +1,4 @@
-import { A as WorkspacePackage, b as TegamiContext, j as Draft, s as TegamiPlugin, t as Awaitable, v as PublishPlan } from "../types-B50RK1rR.js";
+import { A as WorkspacePackage, b as TegamiContext, j as Draft, s as TegamiPlugin, t as Awaitable, v as PublishPlan } from "../types-DEyZ2r-2.js";
 import { GitPluginOptions } from "./git.js";
 
 //#region src/plugins/gitlab.d.ts
@@ -22,7 +22,7 @@ interface VersionMergeRequestOptions {
    */
   forceCreate?: boolean;
   /**
-   * Merge request branch.
+   * Merge request branch. Publish group MRs are created under `<branch>/`.
    *
    * @default "tegami/version-packages"
    */
@@ -33,9 +33,24 @@ interface VersionMergeRequestOptions {
    * @default "main"
    */
   base?: string;
-  /** Override details for "Version Packages" MR. */
+  /**
+   * Publish groups to split into separate version MRs, each entry is a package (or a list of
+   * packages) to version & publish together. Packages not covered by any group are collected
+   * into an extra "unlisted packages" MR.
+   *
+   * Merging a group MR publishes only its members, the remaining MRs are re-synced on every
+   * publish run until all of them are merged & published.
+   */
+  groups?: (string | string[])[];
+  /**
+   * Override details for a version MR.
+   *
+   * Only called at version-time: publish group MRs re-synced at publish-time keep the stored
+   * title and use a default body.
+   */
   create?: (this: TegamiContext, opts: {
     draft: Draft;
+    publishGroup?: string[];
   }) => Awaitable<VersionMergeRequest>;
 }
 /** Options for creating GitLab releases after a successful publish. */