@releasekit/publish 0.4.1 → 0.6.0

package/dist/{chunk-ZMMZ7S6G.js → chunk-53BGK2JF.js}

@@ -93,6 +93,9 @@ var EXIT_CODES = {
   VERSION_ERROR: 8,
   PUBLISH_ERROR: 9
 };
+function sanitizePackageName(name) {
+  return name.startsWith("@") ? name.slice(1).replace(/\//g, "-") : name;
+}
 
 // ../config/dist/index.js
 import * as fs2 from "fs";
@@ -230,7 +233,13 @@ var GitHubReleaseConfigSchema = z.object({
    * - 'generated': Use GitHub's auto-generated notes.
    * - 'none': No body.
    */
-  body: z.enum(["auto", "releaseNotes", "changelog", "generated", "none"]).default("auto")
+  body: z.enum(["auto", "releaseNotes", "changelog", "generated", "none"]).default("auto"),
+  /**
+   * Template string for the GitHub release title when a package name is resolved.
+   * Available variables: ${packageName} (original scoped name), ${version} (e.g. "v1.0.0").
+   * Version-only tags (e.g. "v1.0.0") always use the tag as-is.
+   */
+  titleTemplate: z.string().default("${packageName}: ${version}")
 });
 var VerifyRegistryConfigSchema = z.object({
   enabled: z.boolean().default(true),
@@ -274,7 +283,8 @@ var PublishConfigSchema = z.object({
     draft: true,
     perPackage: true,
     prerelease: "auto",
-    body: "auto"
+    body: "auto",
+    titleTemplate: "${packageName}: ${version}"
   }),
   verify: VerifyConfigSchema.default({
     npm: {
@@ -547,7 +557,8 @@ function getDefaultConfig() {
       draft: true,
       perPackage: true,
       prerelease: "auto",
-      body: "auto"
+      body: "auto",
+      titleTemplate: "${packageName}: ${version}"
     },
     verify: {
       npm: {
@@ -597,7 +608,8 @@ function toPublishConfig(config) {
       draft: config.githubRelease?.draft ?? defaults.githubRelease.draft,
       perPackage: config.githubRelease?.perPackage ?? defaults.githubRelease.perPackage,
       prerelease: config.githubRelease?.prerelease ?? defaults.githubRelease.prerelease,
-      body: config.githubRelease?.body ?? defaults.githubRelease.body
+      body: config.githubRelease?.body ?? defaults.githubRelease.body,
+      titleTemplate: config.githubRelease?.titleTemplate ?? defaults.githubRelease.titleTemplate
     },
     verify: {
       npm: {
@@ -1264,9 +1276,9 @@ function resolveNotes(bodySource, tag, changelogs, releaseNotesEnabled, pipeline
     return { useGithubNotes: true };
   }
   if (bodySource === "changelog") {
-    const packageBody2 = formatChangelogForTag(tag, changelogs);
-    if (packageBody2) {
-      return { body: packageBody2, useGithubNotes: false };
+    const packageBody = formatChangelogForTag(tag, changelogs);
+    if (packageBody) {
+      return { body: packageBody, useGithubNotes: false };
     }
     warn("No changelog found for tag, falling back to GitHub auto-notes");
     return { useGithubNotes: true };
@@ -1274,30 +1286,45 @@ function resolveNotes(bodySource, tag, changelogs, releaseNotesEnabled, pipeline
   if (releaseNotesEnabled && pipelineNotes) {
     const body = findNotesForTag(tag, pipelineNotes);
     if (body) return { body, useGithubNotes: false };
-  }
-  const packageBody = formatChangelogForTag(tag, changelogs);
-  if (packageBody) {
-    return { body: packageBody, useGithubNotes: false };
+    warn(`Release notes configured but no content found for tag ${tag}, falling back to GitHub auto-generated notes`);
   }
   return { useGithubNotes: true };
 }
 function isVersionOnlyTag(tag) {
   return /^v?\d+\.\d+\.\d+/.test(tag);
 }
-function getTitleFromTag(tag) {
-  const atIndex = tag.lastIndexOf("@");
-  if (atIndex === -1) {
-    return tag;
+function resolveTagPackage(tag, packageNames) {
+  const sorted = [...packageNames].sort((a, b) => sanitizePackageName(b).length - sanitizePackageName(a).length);
+  for (const packageName of sorted) {
+    const atPrefix = `${packageName}@`;
+    if (tag.startsWith(atPrefix)) {
+      return { packageName, version: tag.slice(atPrefix.length) };
+    }
+    const dashPrefix = `${sanitizePackageName(packageName)}-`;
+    if (tag.startsWith(dashPrefix)) {
+      const versionPart = tag.slice(dashPrefix.length);
+      if (/^v?\d/.test(versionPart)) {
+        return { packageName, version: versionPart };
+      }
+    }
   }
-  const packageName = tag.slice(0, atIndex);
-  const version = tag.slice(atIndex + 1);
-  return `${packageName} @ ${version}`;
+  return null;
+}
+function getTitleFromTag(tag, packageNames, titleTemplate) {
+  const applyTemplate = (packageName, version) => titleTemplate.replace(/\$\{packageName\}/g, packageName).replace(/\$\{version\}/g, version);
+  if (packageNames.length > 0) {
+    const resolved = resolveTagPackage(tag, packageNames);
+    if (resolved) return applyTemplate(resolved.packageName, resolved.version);
+  }
+  const atIndex = tag.lastIndexOf("@");
+  if (atIndex === -1) return tag;
+  return applyTemplate(tag.slice(0, atIndex), tag.slice(atIndex + 1));
 }
 function findNotesForTag(tag, notes) {
-  for (const [packageName, body] of Object.entries(notes)) {
-    if (tag.startsWith(`${packageName}@`) && body.trim()) {
-      return body;
-    }
+  const resolved = resolveTagPackage(tag, Object.keys(notes));
+  if (resolved) {
+    const body = notes[resolved.packageName];
+    if (body?.trim()) return body;
   }
   const entries = Object.values(notes).filter((b) => b.trim());
   if (entries.length === 1 && isVersionOnlyTag(tag)) return entries[0];
@@ -1305,8 +1332,16 @@ function findNotesForTag(tag, notes) {
 }
 function formatChangelogForTag(tag, changelogs) {
   if (changelogs.length === 0) return void 0;
-  const changelog = changelogs.find((c) => tag.startsWith(`${c.packageName}@`));
-  const target = changelog ?? (changelogs.length === 1 && isVersionOnlyTag(tag) ? changelogs[0] : void 0);
+  const resolved = resolveTagPackage(
+    tag,
+    changelogs.map((c) => c.packageName)
+  );
+  let target;
+  if (resolved) {
+    target = changelogs.find((c) => c.packageName === resolved.packageName);
+  } else if (changelogs.length === 1 && isVersionOnlyTag(tag)) {
+    target = changelogs[0];
+  }
   if (!target || target.entries.length === 0) return void 0;
   const lines = [];
   for (const entry of target.entries) {
@@ -1343,7 +1378,11 @@ async function runGithubReleaseStage(ctx) {
       success: false
     };
     const ghArgs = ["release", "create", tag];
-    ghArgs.push("--title", getTitleFromTag(tag));
+    const titlePackageNames = [
+      ...ctx.input.changelogs.map((c) => c.packageName),
+      ...ctx.releaseNotes ? Object.keys(ctx.releaseNotes) : []
+    ];
+    ghArgs.push("--title", getTitleFromTag(tag, [...new Set(titlePackageNames)], config.githubRelease.titleTemplate));
     if (config.githubRelease.draft) {
       ghArgs.push("--draft");
     }

package/dist/cli.js

@@ -9,7 +9,7 @@ import {
   runPipeline,
   setJsonMode,
   setLogLevel
-} from "./chunk-ZMMZ7S6G.js";
+} from "./chunk-53BGK2JF.js";
 
 // src/cli.ts
 import { realpathSync } from "fs";

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   parseInput,
   runPipeline,
   updateCargoVersion
-} from "./chunk-ZMMZ7S6G.js";
+} from "./chunk-53BGK2JF.js";
 export {
   BasePublishError,
   PipelineError,

package/docs/github-releases.md

@@ -140,6 +140,29 @@ Set `"draft": false` to publish releases immediately.
 
 ---
 
+## Release Title (`titleTemplate`)
+
+Controls the title of each GitHub Release when a package name is resolved from the tag.
+
+```json
+{
+  "publish": {
+    "githubRelease": {
+      "titleTemplate": "${packageName}: ${version}"
+    }
+  }
+}
+```
+
+| Variable | Value |
+|----------|-------|
+| `${packageName}` | Original scoped package name, e.g. `@scope/pkg` |
+| `${version}` | Version string extracted from the tag, e.g. `v1.0.0` |
+
+The default produces titles like `@releasekit/version: v1.0.0`. Version-only tags (e.g. `v1.0.0` with no package prefix) always use the tag string directly.
+
+---
+
 ## Per-Package Releases
 
 In a monorepo, a separate GitHub Release is created for each published package by default.
@@ -168,7 +191,8 @@ Set `"perPackage": false` to create a single release for the entire repo.
       "draft": true,
       "prerelease": "auto",
       "perPackage": true,
-      "body": "auto"
+      "body": "auto",
+      "titleTemplate": "${packageName}: ${version}"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@releasekit/publish",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Publish packages to npm and crates.io with git tagging and GitHub releases",
   "type": "module",
   "module": "./dist/index.js",
@@ -63,8 +63,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0",
-    "@releasekit/core": "0.0.0",
-    "@releasekit/config": "0.0.0"
+    "@releasekit/config": "0.0.0",
+    "@releasekit/core": "0.0.0"
   },
   "engines": {
     "node": ">=20"