@releasekit/publish 0.2.0 → 0.3.0-next.0

package/dist/{chunk-H7AKSLZP.js → chunk-GOBII36Q.js}

@@ -30,9 +30,9 @@ function getDefaultConfig() {
     githubRelease: {
       enabled: true,
       draft: true,
-      generateNotes: true,
-      perPackage: false,
-      prerelease: "auto"
+      perPackage: true,
+      prerelease: "auto",
+      releaseNotes: "auto"
     },
     verify: {
       npm: {
@@ -80,10 +80,9 @@ function toPublishConfig(config) {
     githubRelease: {
       enabled: config.githubRelease?.enabled ?? defaults.githubRelease.enabled,
       draft: config.githubRelease?.draft ?? defaults.githubRelease.draft,
-      generateNotes: config.githubRelease?.generateNotes ?? defaults.githubRelease.generateNotes,
       perPackage: config.githubRelease?.perPackage ?? defaults.githubRelease.perPackage,
       prerelease: config.githubRelease?.prerelease ?? defaults.githubRelease.prerelease,
-      notesFile: config.githubRelease?.notesFile
+      releaseNotes: config.githubRelease?.releaseNotes ?? defaults.githubRelease.releaseNotes
     },
     verify: {
       npm: {
@@ -584,6 +583,9 @@ async function runGitCommitStage(ctx) {
     return;
   }
   const filePaths = input.updates.map((u) => path3.resolve(cwd, u.filePath));
+  if (ctx.additionalFiles) {
+    filePaths.push(...ctx.additionalFiles.map((f) => path3.resolve(cwd, f)));
+  }
   if (filePaths.length === 0) {
     info2("No files to commit");
     return;
@@ -716,6 +718,62 @@ async function runGitPushStage(ctx) {
 // src/stages/github-release.ts
 import * as fs4 from "fs";
 import { debug as debug3, info as info4, success as success4, warn as warn2 } from "@releasekit/core";
+function resolveNotes(notesSetting, tag, changelogs, pipelineNotes) {
+  if (notesSetting === "none") {
+    return { useGithubNotes: false };
+  }
+  if (notesSetting === "github") {
+    return { useGithubNotes: true };
+  }
+  if (notesSetting !== "auto") {
+    const body = readFileIfExists(notesSetting);
+    if (body) return { body, useGithubNotes: false };
+    debug3(`Notes file not found: ${notesSetting}, falling back to GitHub auto-notes`);
+    return { useGithubNotes: true };
+  }
+  if (pipelineNotes) {
+    const body = findNotesForTag(tag, pipelineNotes);
+    if (body) return { body, useGithubNotes: false };
+  }
+  const packageBody = formatChangelogForTag(tag, changelogs);
+  if (packageBody) {
+    return { body: packageBody, useGithubNotes: false };
+  }
+  return { useGithubNotes: true };
+}
+function isVersionOnlyTag(tag) {
+  return /^v?\d+\.\d+\.\d+/.test(tag);
+}
+function findNotesForTag(tag, notes) {
+  for (const [packageName, body] of Object.entries(notes)) {
+    if (tag.startsWith(`${packageName}@`) && body.trim()) {
+      return body;
+    }
+  }
+  const entries = Object.values(notes).filter((b) => b.trim());
+  if (entries.length === 1 && isVersionOnlyTag(tag)) return entries[0];
+  return void 0;
+}
+function readFileIfExists(filePath) {
+  try {
+    const content = fs4.readFileSync(filePath, "utf-8").trim();
+    return content || void 0;
+  } catch {
+    return void 0;
+  }
+}
+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);
+  if (!target || target.entries.length === 0) return void 0;
+  const lines = [];
+  for (const entry of target.entries) {
+    const scope = entry.scope ? `**${entry.scope}:** ` : "";
+    lines.push(`- ${scope}${entry.description}`);
+  }
+  return lines.join("\n");
+}
 async function runGithubReleaseStage(ctx) {
   const { config, cliOptions, output } = ctx;
   const dryRun = cliOptions.dryRun;
@@ -728,14 +786,6 @@ async function runGithubReleaseStage(ctx) {
     info4("No tags available for GitHub release");
     return;
   }
-  let notesBody;
-  if (config.githubRelease.notesFile) {
-    try {
-      notesBody = fs4.readFileSync(config.githubRelease.notesFile, "utf-8");
-    } catch {
-      debug3(`Could not read notes file: ${config.githubRelease.notesFile}`);
-    }
-  }
   const firstTag = tags[0];
   if (!firstTag) return;
   const tagsToRelease = config.githubRelease.perPackage ? tags : [firstTag];
@@ -758,9 +808,15 @@ async function runGithubReleaseStage(ctx) {
     if (isPreRel) {
       ghArgs.push("--prerelease");
     }
-    if (notesBody) {
-      ghArgs.push("--notes", notesBody);
-    } else if (config.githubRelease.generateNotes) {
+    const { body, useGithubNotes } = resolveNotes(
+      config.githubRelease.releaseNotes,
+      tag,
+      ctx.input.changelogs,
+      ctx.releaseNotes
+    );
+    if (body) {
+      ghArgs.push("--notes", body);
+    } else if (useGithubNotes) {
       ghArgs.push("--generate-notes");
     }
     try {
@@ -1136,6 +1192,8 @@ async function runPipeline(input, config, options) {
     cliOptions: options,
     packageManager: detectPackageManager(cwd),
     cwd,
+    releaseNotes: options.releaseNotes,
+    additionalFiles: options.additionalFiles,
     output: {
       dryRun: options.dryRun,
       git: { committed: false, tags: [], pushed: false },

package/dist/cli.cjs

@@ -59,9 +59,9 @@ function getDefaultConfig() {
     githubRelease: {
       enabled: true,
       draft: true,
-      generateNotes: true,
-      perPackage: false,
-      prerelease: "auto"
+      perPackage: true,
+      prerelease: "auto",
+      releaseNotes: "auto"
     },
     verify: {
       npm: {
@@ -109,10 +109,9 @@ function toPublishConfig(config) {
     githubRelease: {
       enabled: config.githubRelease?.enabled ?? defaults.githubRelease.enabled,
       draft: config.githubRelease?.draft ?? defaults.githubRelease.draft,
-      generateNotes: config.githubRelease?.generateNotes ?? defaults.githubRelease.generateNotes,
       perPackage: config.githubRelease?.perPackage ?? defaults.githubRelease.perPackage,
       prerelease: config.githubRelease?.prerelease ?? defaults.githubRelease.prerelease,
-      notesFile: config.githubRelease?.notesFile
+      releaseNotes: config.githubRelease?.releaseNotes ?? defaults.githubRelease.releaseNotes
     },
     verify: {
       npm: {
@@ -551,6 +550,9 @@ async function runGitCommitStage(ctx) {
     return;
   }
   const filePaths = input.updates.map((u) => path2.resolve(cwd, u.filePath));
+  if (ctx.additionalFiles) {
+    filePaths.push(...ctx.additionalFiles.map((f) => path2.resolve(cwd, f)));
+  }
   if (filePaths.length === 0) {
     (0, import_core4.info)("No files to commit");
     return;
@@ -699,6 +701,62 @@ function getDistTag(version, defaultTag = "latest") {
 }
 
 // src/stages/github-release.ts
+function resolveNotes(notesSetting, tag, changelogs, pipelineNotes) {
+  if (notesSetting === "none") {
+    return { useGithubNotes: false };
+  }
+  if (notesSetting === "github") {
+    return { useGithubNotes: true };
+  }
+  if (notesSetting !== "auto") {
+    const body = readFileIfExists(notesSetting);
+    if (body) return { body, useGithubNotes: false };
+    (0, import_core6.debug)(`Notes file not found: ${notesSetting}, falling back to GitHub auto-notes`);
+    return { useGithubNotes: true };
+  }
+  if (pipelineNotes) {
+    const body = findNotesForTag(tag, pipelineNotes);
+    if (body) return { body, useGithubNotes: false };
+  }
+  const packageBody = formatChangelogForTag(tag, changelogs);
+  if (packageBody) {
+    return { body: packageBody, useGithubNotes: false };
+  }
+  return { useGithubNotes: true };
+}
+function isVersionOnlyTag(tag) {
+  return /^v?\d+\.\d+\.\d+/.test(tag);
+}
+function findNotesForTag(tag, notes) {
+  for (const [packageName, body] of Object.entries(notes)) {
+    if (tag.startsWith(`${packageName}@`) && body.trim()) {
+      return body;
+    }
+  }
+  const entries = Object.values(notes).filter((b) => b.trim());
+  if (entries.length === 1 && isVersionOnlyTag(tag)) return entries[0];
+  return void 0;
+}
+function readFileIfExists(filePath) {
+  try {
+    const content = fs3.readFileSync(filePath, "utf-8").trim();
+    return content || void 0;
+  } catch {
+    return void 0;
+  }
+}
+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);
+  if (!target || target.entries.length === 0) return void 0;
+  const lines = [];
+  for (const entry of target.entries) {
+    const scope = entry.scope ? `**${entry.scope}:** ` : "";
+    lines.push(`- ${scope}${entry.description}`);
+  }
+  return lines.join("\n");
+}
 async function runGithubReleaseStage(ctx) {
   const { config, cliOptions, output } = ctx;
   const dryRun = cliOptions.dryRun;
@@ -711,14 +769,6 @@ async function runGithubReleaseStage(ctx) {
     (0, import_core6.info)("No tags available for GitHub release");
     return;
   }
-  let notesBody;
-  if (config.githubRelease.notesFile) {
-    try {
-      notesBody = fs3.readFileSync(config.githubRelease.notesFile, "utf-8");
-    } catch {
-      (0, import_core6.debug)(`Could not read notes file: ${config.githubRelease.notesFile}`);
-    }
-  }
   const firstTag = tags[0];
   if (!firstTag) return;
   const tagsToRelease = config.githubRelease.perPackage ? tags : [firstTag];
@@ -741,9 +791,15 @@ async function runGithubReleaseStage(ctx) {
     if (isPreRel) {
       ghArgs.push("--prerelease");
     }
-    if (notesBody) {
-      ghArgs.push("--notes", notesBody);
-    } else if (config.githubRelease.generateNotes) {
+    const { body, useGithubNotes } = resolveNotes(
+      config.githubRelease.releaseNotes,
+      tag,
+      ctx.input.changelogs,
+      ctx.releaseNotes
+    );
+    if (body) {
+      ghArgs.push("--notes", body);
+    } else if (useGithubNotes) {
       ghArgs.push("--generate-notes");
     }
     try {
@@ -1148,6 +1204,8 @@ async function runPipeline(input, config, options) {
     cliOptions: options,
     packageManager: detectPackageManager(cwd),
     cwd,
+    releaseNotes: options.releaseNotes,
+    additionalFiles: options.additionalFiles,
     output: {
       dryRun: options.dryRun,
       git: { committed: false, tags: [], pushed: false },

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
   loadConfig,
   parseInput,
   runPipeline
-} from "./chunk-H7AKSLZP.js";
+} from "./chunk-GOBII36Q.js";
 
 // src/cli.ts
 import { EXIT_CODES, setJsonMode, setLogLevel } from "@releasekit/core";

package/dist/index.cjs

@@ -82,9 +82,9 @@ function getDefaultConfig() {
     githubRelease: {
       enabled: true,
       draft: true,
-      generateNotes: true,
-      perPackage: false,
-      prerelease: "auto"
+      perPackage: true,
+      prerelease: "auto",
+      releaseNotes: "auto"
     },
     verify: {
       npm: {
@@ -132,10 +132,9 @@ function toPublishConfig(config) {
     githubRelease: {
       enabled: config.githubRelease?.enabled ?? defaults.githubRelease.enabled,
       draft: config.githubRelease?.draft ?? defaults.githubRelease.draft,
-      generateNotes: config.githubRelease?.generateNotes ?? defaults.githubRelease.generateNotes,
       perPackage: config.githubRelease?.perPackage ?? defaults.githubRelease.perPackage,
       prerelease: config.githubRelease?.prerelease ?? defaults.githubRelease.prerelease,
-      notesFile: config.githubRelease?.notesFile
+      releaseNotes: config.githubRelease?.releaseNotes ?? defaults.githubRelease.releaseNotes
     },
     verify: {
       npm: {
@@ -595,6 +594,9 @@ async function runGitCommitStage(ctx) {
     return;
   }
   const filePaths = input.updates.map((u) => path2.resolve(cwd, u.filePath));
+  if (ctx.additionalFiles) {
+    filePaths.push(...ctx.additionalFiles.map((f) => path2.resolve(cwd, f)));
+  }
   if (filePaths.length === 0) {
     (0, import_core4.info)("No files to commit");
     return;
@@ -743,6 +745,62 @@ function getDistTag(version, defaultTag = "latest") {
 }
 
 // src/stages/github-release.ts
+function resolveNotes(notesSetting, tag, changelogs, pipelineNotes) {
+  if (notesSetting === "none") {
+    return { useGithubNotes: false };
+  }
+  if (notesSetting === "github") {
+    return { useGithubNotes: true };
+  }
+  if (notesSetting !== "auto") {
+    const body = readFileIfExists(notesSetting);
+    if (body) return { body, useGithubNotes: false };
+    (0, import_core6.debug)(`Notes file not found: ${notesSetting}, falling back to GitHub auto-notes`);
+    return { useGithubNotes: true };
+  }
+  if (pipelineNotes) {
+    const body = findNotesForTag(tag, pipelineNotes);
+    if (body) return { body, useGithubNotes: false };
+  }
+  const packageBody = formatChangelogForTag(tag, changelogs);
+  if (packageBody) {
+    return { body: packageBody, useGithubNotes: false };
+  }
+  return { useGithubNotes: true };
+}
+function isVersionOnlyTag(tag) {
+  return /^v?\d+\.\d+\.\d+/.test(tag);
+}
+function findNotesForTag(tag, notes) {
+  for (const [packageName, body] of Object.entries(notes)) {
+    if (tag.startsWith(`${packageName}@`) && body.trim()) {
+      return body;
+    }
+  }
+  const entries = Object.values(notes).filter((b) => b.trim());
+  if (entries.length === 1 && isVersionOnlyTag(tag)) return entries[0];
+  return void 0;
+}
+function readFileIfExists(filePath) {
+  try {
+    const content = fs3.readFileSync(filePath, "utf-8").trim();
+    return content || void 0;
+  } catch {
+    return void 0;
+  }
+}
+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);
+  if (!target || target.entries.length === 0) return void 0;
+  const lines = [];
+  for (const entry of target.entries) {
+    const scope = entry.scope ? `**${entry.scope}:** ` : "";
+    lines.push(`- ${scope}${entry.description}`);
+  }
+  return lines.join("\n");
+}
 async function runGithubReleaseStage(ctx) {
   const { config, cliOptions, output } = ctx;
   const dryRun = cliOptions.dryRun;
@@ -755,14 +813,6 @@ async function runGithubReleaseStage(ctx) {
     (0, import_core6.info)("No tags available for GitHub release");
     return;
   }
-  let notesBody;
-  if (config.githubRelease.notesFile) {
-    try {
-      notesBody = fs3.readFileSync(config.githubRelease.notesFile, "utf-8");
-    } catch {
-      (0, import_core6.debug)(`Could not read notes file: ${config.githubRelease.notesFile}`);
-    }
-  }
   const firstTag = tags[0];
   if (!firstTag) return;
   const tagsToRelease = config.githubRelease.perPackage ? tags : [firstTag];
@@ -785,9 +835,15 @@ async function runGithubReleaseStage(ctx) {
     if (isPreRel) {
       ghArgs.push("--prerelease");
     }
-    if (notesBody) {
-      ghArgs.push("--notes", notesBody);
-    } else if (config.githubRelease.generateNotes) {
+    const { body, useGithubNotes } = resolveNotes(
+      config.githubRelease.releaseNotes,
+      tag,
+      ctx.input.changelogs,
+      ctx.releaseNotes
+    );
+    if (body) {
+      ghArgs.push("--notes", body);
+    } else if (useGithubNotes) {
       ghArgs.push("--generate-notes");
     }
     try {
@@ -1192,6 +1248,8 @@ async function runPipeline(input, config, options) {
     cliOptions: options,
     packageManager: detectPackageManager(cwd),
     cwd,
+    releaseNotes: options.releaseNotes,
+    additionalFiles: options.additionalFiles,
     output: {
       dryRun: options.dryRun,
       git: { committed: false, tags: [], pushed: false },

package/dist/index.d.cts

@@ -31,10 +31,10 @@ interface GitConfig {
 interface GitHubReleaseConfig {
     enabled: boolean;
     draft: boolean;
-    generateNotes: boolean;
     perPackage: boolean;
     prerelease: 'auto' | boolean;
-    notesFile?: string;
+    /** 'auto' | 'github' | 'none' | file path */
+    releaseNotes: string;
 }
 interface VerifyRegistryConfig {
     enabled: boolean;
@@ -66,6 +66,10 @@ interface PublishCliOptions {
     skipVerification: boolean;
     json: boolean;
     verbose: boolean;
+    /** Per-package release notes keyed by package name, from the notes pipeline. */
+    releaseNotes?: Record<string, string>;
+    /** Additional files to stage in the git commit (e.g., changelog files from the notes step). */
+    additionalFiles?: string[];
 }
 interface PublishResult {
     packageName: string;
@@ -111,6 +115,10 @@ interface PipelineContext {
     packageManager: PackageManager;
     output: PublishOutput;
     cwd: string;
+    /** Per-package release notes keyed by package name, passed from the notes pipeline. */
+    releaseNotes?: Record<string, string>;
+    /** Additional files to stage in the git commit (e.g., changelog files from the notes step). */
+    additionalFiles?: string[];
 }
 
 declare function loadConfig(options?: LoadOptions): PublishConfig;

package/dist/index.d.ts

@@ -31,10 +31,10 @@ interface GitConfig {
 interface GitHubReleaseConfig {
     enabled: boolean;
     draft: boolean;
-    generateNotes: boolean;
     perPackage: boolean;
     prerelease: 'auto' | boolean;
-    notesFile?: string;
+    /** 'auto' | 'github' | 'none' | file path */
+    releaseNotes: string;
 }
 interface VerifyRegistryConfig {
     enabled: boolean;
@@ -66,6 +66,10 @@ interface PublishCliOptions {
     skipVerification: boolean;
     json: boolean;
     verbose: boolean;
+    /** Per-package release notes keyed by package name, from the notes pipeline. */
+    releaseNotes?: Record<string, string>;
+    /** Additional files to stage in the git commit (e.g., changelog files from the notes step). */
+    additionalFiles?: string[];
 }
 interface PublishResult {
     packageName: string;
@@ -111,6 +115,10 @@ interface PipelineContext {
     packageManager: PackageManager;
     output: PublishOutput;
     cwd: string;
+    /** Per-package release notes keyed by package name, passed from the notes pipeline. */
+    releaseNotes?: Record<string, string>;
+    /** Additional files to stage in the git commit (e.g., changelog files from the notes step). */
+    additionalFiles?: string[];
 }
 
 declare function loadConfig(options?: LoadOptions): PublishConfig;

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@releasekit/publish",
-  "version": "0.2.0",
+  "version": "0.3.0-next.0",
   "description": "Publish packages to npm and crates.io with git tagging and GitHub releases",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -52,8 +52,8 @@
     "semver": "^7.7.4",
     "smol-toml": "^1.6.0",
     "zod": "^4.3.6",
-    "@releasekit/config": "0.1.0",
-    "@releasekit/core": "0.1.0"
+    "@releasekit/core": "0.1.0",
+    "@releasekit/config": "0.1.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.6",