tegami 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/{types-DKeF_CDv.d.ts → types-DKZsadC8.d.ts}

@@ -138,6 +138,12 @@ declare class PackageGraph {
   unregisterGroup(name: string): void;
 }
 //#endregion
+//#region src/plugins/gitlab/api.d.ts
+interface GitLabToken {
+  value: string;
+  type: "private-token" | "job-token";
+}
+//#endregion
 //#region src/context.d.ts
 interface TegamiContext {
   /** absolute path */
@@ -154,6 +160,13 @@ interface TegamiContext {
     repo?: string;
     token?: string;
   };
+  /** additional context when GitLab plugin is configured */
+  gitlab?: {
+    repo?: string;
+    token?: GitLabToken;
+    apiUrl?: string;
+    webUrl?: string;
+  };
   /** additional context when npm plugin is configured */
   npm?: {
     client: AgentName;
@@ -341,6 +354,95 @@ declare class PublishLock {
   serialize(): string;
 }
 //#endregion
+//#region src/changelog/generate.d.ts
+interface GenerateFromCommitsOptions {
+  /** Start revision. Defaults to the latest reachable git tag, or all history if none exists. */
+  from?: string;
+  /** End revision. Defaults to HEAD. */
+  to?: string;
+}
+interface CommitChangelog {
+  filename: string;
+  content: string;
+  packages: Record<string, BumpType | ChangelogPackageConfig>;
+  changes: CommitChange[];
+}
+interface CommitChange {
+  hash: string;
+  subject: string;
+  body: string;
+  packages: string[];
+  type: BumpType;
+  title: string;
+}
+//#endregion
+//#region src/index.d.ts
+interface GenerateChangelogOptions extends GenerateFromCommitsOptions {
+  /**
+   * Write changelog files to disk.
+   *
+   * @default true
+   */
+  write?: boolean;
+}
+interface Tegami {
+  /** Create pending changelog files from git commit history. */
+  generateChangelog(options?: GenerateChangelogOptions): Promise<CommitChangelog[]>;
+  /** Build a draft from pending changelog files. */
+  draft(): Promise<Draft>;
+  /** Publish packages from the publish lock. */
+  publish(options?: PublishOptions): Promise<PublishPlan | "skipped">;
+  /**
+   * Check publish status.
+   *
+   * Prefer `publish()` over this if you are publishing packages, it will also check the publish status.
+   */
+  publishStatus(): Promise<"pending" | "success" | "idle">;
+  /** Remove the publish lock file after publishing has finished successfully. */
+  cleanup(): Promise<{
+    state: "removed";
+  } | {
+    state: "skipped";
+    reason: "no-plan" | "pending";
+  }>;
+  /** Internal APIs, do not use it unless you know what you are doing */
+  _internal: {
+    context(): Promise<TegamiContext>; /** access context without requiring graph resolution */
+    contextUnresolved(): Promise<TegamiContext>;
+    options: TegamiOptions;
+  };
+}
+/** Create a Tegami project handle. */
+declare function tegami<const Groups extends string = string>(options?: TegamiOptions<Groups>): Tegami;
+//#endregion
+//#region src/cli/core.d.ts
+interface TegamiCliCommand<Values extends Record<string, boolean | string | undefined>, Positionals extends Record<string, string | undefined>> {
+  option<const Name extends string, const T extends "string" | "boolean">(name: Name, opts: {
+    type: T;
+    short?: string;
+    description?: string;
+  }): TegamiCliCommand<Values & { [k in Name]?: T extends "string" ? string : boolean }, Positionals>;
+  positional<const Name extends string, const Required extends boolean = true>(name: Name, required?: Required): TegamiCliCommand<Values, Positionals & { [K in Name]: Required extends true ? string : string | undefined }>;
+  action(fn: (options: {
+    context: TegamiContext;
+    values: Values;
+    positionals: Positionals;
+  }) => Awaitable<void>): void;
+}
+interface TegamiCliRegistry {
+  command(path: string, options?: {
+    description?: string;
+    /**
+     * If the package graph must be resolved to run this action.
+     *
+     * @default true
+     */
+    resolve?: boolean;
+  }): TegamiCliCommand<Record<never, never>, Record<never, never>>;
+  help(): string;
+  parse(argv: string[]): Promise<void>;
+}
+//#endregion
 //#region src/types.d.ts
 /** Generates changelog content for a package release. */
 interface LogGenerator {
@@ -376,6 +478,18 @@ interface TegamiOptions<Groups extends string = string> {
   npm?: NpmPluginOptions;
   cargo?: CargoPluginOptions;
 }
+interface SharedGoOptions {
+  /**
+   * Whether to publish this module (create git tags).
+   *
+   * @default true
+   */
+  publish?: boolean;
+}
+interface SharedNpmOptions {
+  /** npm dist-tag used when publishing. */
+  distTag?: string;
+}
 interface GroupOptions {
   /** Prerelease identifier appended to bumped versions (e.g. `alpha` → `1.1.0-alpha.0`). */
   prerelease?: string;
@@ -384,9 +498,9 @@ interface GroupOptions {
   /** when multiple packages in the group are published, only one git tag will be created (as well as GitHub release) */
   syncGitTag?: boolean;
   /** npm-specific options. */
-  npm?: {
-    /** npm dist-tag used when publishing. */distTag?: string;
-  };
+  npm?: SharedNpmOptions;
+  /** go-specific options. */
+  go?: SharedGoOptions;
 }
 interface PackageOptions<Group extends string = string> {
   /** Prerelease identifier appended to bumped versions (e.g. `alpha` → `1.1.0-alpha.0`). */
@@ -394,16 +508,18 @@ interface PackageOptions<Group extends string = string> {
   /** the group of this package, ignored if the group doesn't exist */
   group?: Group;
   /** npm-specific options. */
-  npm?: {
-    /** npm dist-tag used when publishing. */distTag?: string;
-  };
+  npm?: SharedNpmOptions;
+  /** go-specific options. */
+  go?: SharedGoOptions;
 }
 type TegamiPluginOption = TegamiPlugin | TegamiPluginOption[];
 interface TegamiPlugin {
   name: string;
   enforce?: "pre" | "default" | "post";
-  /** When Tegami initializes */
+  /** When Tegami initializes. */
   init?(this: TegamiContext): Awaitable<void>;
+  /** When Tegami CLI initializes, this runs before `resolve()`. */
+  initCli?(this: TegamiContext, cli: TegamiCliRegistry): Awaitable<void>;
   /** Resolve workspace packages and dependency metadata into the shared graph. */
   resolve?(this: TegamiContext): Awaitable<void>;
   /** Called when Tegami creates an empty draft. */
@@ -455,12 +571,10 @@ interface TegamiPlugin {
   afterPublishAll?(this: TegamiContext, opts: {
     plan: PublishPlan;
   }): Awaitable<void>;
-  /** CLI lifecycle hooks. */
-  cli?: {
-    /** Called once before a CLI command runs. */init?(this: TegamiContext): Awaitable<void>; /** Called after `tegami version` returns a draft. */
-    draftCreated?(this: TegamiContext, draft: Draft): Awaitable<void>; /** Called after `tegami version` applies a draft. */
-    draftApplied?(this: TegamiContext, draft: Draft): Awaitable<void>;
-  };
+  /** Called after `tegami version` returns a draft. */
+  initCliDraft?(this: TegamiContext, draft: Draft): Awaitable<void>;
+  /** Called after `tegami version` applies a draft. */
+  applyCliDraft?(this: TegamiContext, draft: Draft): Awaitable<void>;
 }
 type Awaitable<T> = T | Promise<T>;
 interface PublishPreflight {
@@ -478,4 +592,4 @@ interface PublishPreflight {
   wait?: string[];
 }
 //#endregion
-export { WorkspacePackage as C, ChangelogPackageConfig as D, PackageDraft as E, BumpType as O, PackageGroup as S, DraftPolicy as T, NpmPackage as _, PublishPreflight as a, TegamiContext as b, TegamiPluginOption as c, PackagePublishResult as d, PublishOptions as f, cargo as g, CargoPluginOptions as h, PackageOptions as i, PublishLock as l, CargoPackage as m, GroupOptions as n, TegamiOptions as o, PublishPlan as p, LogGenerator as r, TegamiPlugin as s, Awaitable as t, PackagePublishPlan as u, NpmPluginOptions as v, Draft as w, PackageGraph as x, npm as y };
+export { PackageDraft as A, npm as C, WorkspacePackage as D, PackageGroup as E, Draft as O, NpmPluginOptions as S, PackageGraph as T, PublishPlan as _, PublishPreflight as a, cargo as b, TegamiPluginOption as c, tegami as d, CommitChangelog as f, PublishOptions as g, PackagePublishResult as h, PackageOptions as i, BumpType as j, DraftPolicy as k, GenerateChangelogOptions as l, PackagePublishPlan as m, GroupOptions as n, TegamiOptions as o, PublishLock as p, LogGenerator as r, TegamiPlugin as s, Awaitable as t, Tegami as u, CargoPackage as v, TegamiContext as w, NpmPackage as x, CargoPluginOptions as y };

package/dist/version-request-cFS0Suzd.js

@@ -0,0 +1,69 @@
+import { r as formatNpmDistTag } from "./semver-EKJ8yK5U.js";
+import { n as execFailure } from "./error-We7chQVJ.js";
+import { x } from "tinyexec";
+//#region src/utils/version-request.ts
+async function hasGitChanges(cwd) {
+	return (await x("git", ["status", "--porcelain"], { nodeOptions: { cwd } })).stdout.trim().length > 0;
+}
+async function commitVersionBranchChanges(cwd, branch, title) {
+	const gitOptions = { nodeOptions: { cwd } };
+	let result = await x("git", [
+		"checkout",
+		"-B",
+		branch
+	], gitOptions);
+	if (result.exitCode !== 0) throw execFailure("Failed to create the version branch.", result);
+	result = await x("git", ["add", "-A"], gitOptions);
+	if (result.exitCode !== 0) throw execFailure("Failed to stage version changes.", result);
+	result = await x("git", [
+		"commit",
+		"-m",
+		title
+	], gitOptions);
+	if (result.exitCode !== 0) throw execFailure("Failed to commit version changes.", result);
+	result = await x("git", [
+		"push",
+		"--force",
+		"-u",
+		"origin",
+		branch
+	], gitOptions);
+	if (result.exitCode !== 0) throw execFailure("Failed to push the version branch to origin. Ensure `origin` is configured and you have push access.", result);
+}
+function createVersionRequestBody(draft, context, snapshots, summary) {
+	const packageLines = [];
+	const changesets = /* @__PURE__ */ new Map();
+	for (const [id, packageDraft] of draft.getPackageDrafts()) {
+		const pkg = context.graph.get(id);
+		if (!pkg) continue;
+		for (const entry of packageDraft.changelogs ?? []) {
+			const list = changesets.get(entry);
+			if (list) list.push(pkg);
+			else changesets.set(entry, [pkg]);
+		}
+		const originalVersion = snapshots.get(pkg.id);
+		if (!originalVersion || originalVersion === pkg.version) continue;
+		packageLines.push(`| \`${pkg.name}\` | \`${originalVersion}\` | \`${pkg.version}\`${formatNpmDistTag(packageDraft.npm?.distTag)} |`);
+	}
+	const changelogLines = [];
+	for (const [entry, linkedPackages] of changesets) {
+		changelogLines.push(`### ${entry.subject ?? `\`${entry.filename}\``}`, "");
+		changelogLines.push("<details>", `<summary>Show Bumped Packages (${linkedPackages.length})</summary>`, "", ...linkedPackages.map((pkg) => `- \`${pkg.id}\``), "", "</details>", "");
+		for (const section of entry.sections) {
+			changelogLines.push(`#### ${section.title}`, "");
+			if (section.content) changelogLines.push(section.content);
+		}
+	}
+	const sections = [
+		"## Summary",
+		"",
+		summary,
+		""
+	];
+	if (packageLines.length > 0) sections.push("| Package | From | To |", "| --- | --- | --- |", ...packageLines);
+	if (changelogLines.length > 0) sections.push("", "## Changelogs", ...changelogLines);
+	sections.push("");
+	return sections.join("\n");
+}
+//#endregion
+export { createVersionRequestBody as n, hasGitChanges as r, commitVersionBranchChanges as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tegami",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "description": "Utility for package versioning & publish",
   "license": "MIT",
   "author": "Fuma Nama",
@@ -18,6 +18,7 @@
     "./generators/simple": "./dist/generators/simple.js",
     "./plugins/git": "./dist/plugins/git.js",
     "./plugins/github": "./dist/plugins/github.js",
+    "./plugins/gitlab": "./dist/plugins/gitlab.js",
     "./plugins/go": "./dist/plugins/go.js",
     "./providers/cargo": "./dist/providers/cargo.js",
     "./providers/npm": "./dist/providers/npm.js",
@@ -29,10 +30,7 @@
   "dependencies": {
     "@clack/prompts": "^1.6.0",
     "@rainbowatcher/toml-edit-js": "^0.6.5",
-    "commander": "^15.0.0",
     "js-yaml": "^5.1.0",
-    "mdast-util-from-markdown": "^2.0.3",
-    "mdast-util-to-markdown": "^2.1.2",
     "package-manager-detector": "^1.6.0",
     "semver": "^7.8.5",
     "tinyexec": "^1.2.4",
@@ -40,7 +38,6 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/mdast": "^4.0.4",
     "@types/node": "^26.0.0",
     "@types/semver": "^7.7.1",
     "tsdown": "^0.22.3",

package/dist/api-D-jf_8xY.js

@@ -1,116 +0,0 @@
-//#region src/plugins/github/api.ts
-function parseGitHubRepo(repo) {
-	const [owner, name] = repo.split("/", 2);
-	if (!owner || !name) throw new Error(`Invalid GitHub repository: ${repo}`);
-	return {
-		owner,
-		repo: name
-	};
-}
-async function githubRequest(path, token, init = {}) {
-	const headers = new Headers(init.headers);
-	headers.set("Accept", "application/vnd.github+json");
-	headers.set("X-GitHub-Api-Version", "2022-11-28");
-	if (token) headers.set("Authorization", `Bearer ${token}`);
-	return fetch(`https://api.github.com${path}`, {
-		...init,
-		headers
-	});
-}
-async function releaseExistsByTag(repo, tag, token) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	const response = await githubRequest(`/repos/${owner}/${name}/releases/tags/${encodeURIComponent(tag)}`, token, { method: "HEAD" });
-	if (response.status === 404) return false;
-	if (!response.ok) throw new Error(`Failed to get GitHub release for ${tag}.`);
-	return true;
-}
-async function createRelease(repo, options) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	if (!(await githubRequest(`/repos/${owner}/${name}/releases`, options.token, {
-		method: "POST",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({
-			tag_name: options.tag,
-			name: options.title,
-			body: options.notes,
-			prerelease: options.prerelease ?? false
-		})
-	})).ok) throw new Error(`Failed to create GitHub release for ${options.tag}.`);
-}
-async function findOpenPullRequest(repo, headBranch, token) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	const response = await githubRequest(`/repos/${owner}/${name}/pulls?${new URLSearchParams({
-		head: `${owner}:${headBranch}`,
-		state: "open"
-	})}`, token);
-	if (!response.ok) throw new Error("Failed to check for an existing version pull request.");
-	return (await response.json())[0]?.number;
-}
-async function updatePullRequest(repo, number, options) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	if (!(await githubRequest(`/repos/${owner}/${name}/pulls/${number}`, options.token, {
-		method: "PATCH",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({
-			title: options.title,
-			body: options.body
-		})
-	})).ok) throw new Error("Failed to update the version pull request.");
-}
-async function createPullRequest(repo, options) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	if (!(await githubRequest(`/repos/${owner}/${name}/pulls`, options.token, {
-		method: "POST",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({
-			title: options.title,
-			body: options.body,
-			head: options.head,
-			base: options.base
-		})
-	})).ok) throw new Error("Failed to create the version pull request.");
-}
-async function getPullRequest(repo, number, token) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	const response = await githubRequest(`/repos/${owner}/${name}/pulls/${number}`, token);
-	if (!response.ok) throw new Error(`Failed to resolve pull request #${number}.`);
-	const data = await response.json();
-	return {
-		headRefName: data.head.ref,
-		baseRefOid: data.base.sha,
-		headRefOid: data.head.sha,
-		headRepository: data.head.repo
-	};
-}
-async function findIssueCommentByPrefix(repo, issueNumber, prefix, token) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	let page = 1;
-	while (true) {
-		const response = await githubRequest(`/repos/${owner}/${name}/issues/${issueNumber}/comments?per_page=100&page=${page}`, token);
-		if (!response.ok) throw new Error("Failed to list pull request comments.");
-		const batch = await response.json();
-		if (batch.length === 0) break;
-		const comment = batch.find((comment) => comment.body.startsWith(prefix));
-		if (comment) return comment.id;
-		if (batch.length < 100) break;
-		page += 1;
-	}
-}
-async function updateIssueComment(repo, commentId, body, token) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	if (!(await githubRequest(`/repos/${owner}/${name}/issues/comments/${commentId}`, token, {
-		method: "PATCH",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({ body })
-	})).ok) throw new Error("Failed to update pull request comment.");
-}
-async function createIssueComment(repo, issueNumber, body, token) {
-	const { owner, repo: name } = parseGitHubRepo(repo);
-	if (!(await githubRequest(`/repos/${owner}/${name}/issues/${issueNumber}/comments`, token, {
-		method: "POST",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({ body })
-	})).ok) throw new Error("Failed to create pull request comment.");
-}
-//#endregion
-export { findOpenPullRequest as a, updateIssueComment as c, findIssueCommentByPrefix as i, updatePullRequest as l, createPullRequest as n, getPullRequest as o, createRelease as r, releaseExistsByTag as s, createIssueComment as t };

package/dist/index-CQXmwyLn.d.ts

@@ -1,64 +0,0 @@
-import { D as ChangelogPackageConfig, O as BumpType, b as TegamiContext, f as PublishOptions, o as TegamiOptions, p as PublishPlan, w as Draft, x as PackageGraph } from "./types-DKeF_CDv.js";
-
-//#region src/changelog/generate.d.ts
-interface GenerateFromCommitsOptions {
-  /** Start revision. Defaults to the latest reachable git tag, or all history if none exists. */
-  from?: string;
-  /** End revision. Defaults to HEAD. */
-  to?: string;
-}
-interface CommitChangelog {
-  filename: string;
-  content: string;
-  packages: Record<string, BumpType | ChangelogPackageConfig>;
-  changes: CommitChange[];
-}
-interface CommitChange {
-  hash: string;
-  subject: string;
-  body: string;
-  packages: string[];
-  type: BumpType;
-  title: string;
-}
-//#endregion
-//#region src/index.d.ts
-interface GenerateChangelogOptions extends GenerateFromCommitsOptions {
-  /**
-   * Write changelog files to disk.
-   *
-   * @default true
-   */
-  write?: boolean;
-}
-interface Tegami {
-  /** Create pending changelog files from git commit history. */
-  generateChangelog(options?: GenerateChangelogOptions): Promise<CommitChangelog[]>;
-  /** Build a draft from pending changelog files. */
-  draft(): Promise<Draft>;
-  /** Publish packages from the publish lock. */
-  publish(options?: PublishOptions): Promise<PublishPlan | "skipped">;
-  /**
-   * Check publish status.
-   *
-   * Prefer `publish()` over this if you are publishing packages, it will also check the publish status.
-   */
-  publishStatus(): Promise<"pending" | "success" | "idle">;
-  /** Remove the publish lock file after publishing has finished successfully. */
-  cleanup(): Promise<{
-    state: "removed";
-  } | {
-    state: "skipped";
-    reason: "no-plan" | "pending";
-  }>;
-  /** Internal APIs, do not use it unless you know what you are doing */
-  _internal: {
-    context(): Promise<TegamiContext>;
-    graph(): Promise<PackageGraph>;
-    options: TegamiOptions;
-  };
-}
-/** Create a Tegami project handle. */
-declare function tegami<const Groups extends string = string>(options?: TegamiOptions<Groups>): Tegami;
-//#endregion
-export { CommitChangelog as i, Tegami as n, tegami as r, GenerateChangelogOptions as t };