@vc-shell/release-config 1.2.1 → 1.2.3-beta.0

package/README.md

@@ -96,6 +96,94 @@ This command:
 
 **Note:** This is typically a one-time operation during initial setup or migration.
 
+## Programmatic API for Changelog Generation
+
+You can also use the changelog generation functionality programmatically in your own scripts:
+
+### Using the CLI
+
+```bash
+# Install the package
+yarn add -D @vc-shell/release-config
+
+# Create a configuration file
+npx vc-generate-changelogs --help
+
+# Run with your config
+npx vc-generate-changelogs changelog-config.js
+```
+
+### Using the JavaScript API
+
+```typescript
+import { generateInitialChangelogs, PackageConfig } from "@vc-shell/release-config";
+
+const packages: PackageConfig[] = [
+  {
+    name: "framework",
+    path: "framework",
+    displayName: "Framework (@vc-shell/framework)"
+  },
+  {
+    name: "cli/api-client",
+    path: "cli/api-client",
+    displayName: "API Client Generator (@vc-shell/api-client-generator)"
+  },
+  // ... more packages
+];
+
+await generateInitialChangelogs({
+  packages,
+  rootDir: process.cwd(),           // Optional: root directory
+  generateRoot: true,                // Optional: generate root changelog
+  includeRootHeader: true            // Optional: include header in root changelog
+});
+```
+
+### Configuration File Format
+
+Create a `changelog-config.js` file:
+
+```javascript
+export default {
+  packages: [
+    {
+      name: "framework",
+      path: "framework",
+      displayName: "Framework (@vc-shell/framework)"
+    },
+    // ... more packages
+  ],
+  rootDir: process.cwd(),
+  generateRoot: true,
+  includeRootHeader: true,
+};
+```
+
+### Generating Only Root Changelog
+
+If you already have package changelogs and want to regenerate just the root one:
+
+```typescript
+import { generateRootChangelog } from "@vc-shell/release-config";
+
+await generateRootChangelog({
+  packages,
+  rootDir: process.cwd(),
+  includeRootHeader: true,
+});
+```
+
+### Use Cases
+
+This programmatic API is useful for:
+- **Custom monorepo structures** - Different from standard VC-Shell layout
+- **CI/CD pipelines** - Automated changelog generation
+- **Migration scripts** - One-time setup for new repositories
+- **Custom workflows** - Integration with other release tools
+
+See [changelog-config.example.js](./changelog-config.example.js) for a complete configuration example.
+
 ### Root CHANGELOG Format
 
 The root `CHANGELOG.md` groups changes by package for each version:

package/dist/cli-generate-changelogs.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { g as i } from "./generate-changelogs-_wYT4v6U.js";
+import { resolve as s } from "node:path";
+import e from "chalk";
+async function l() {
+  const n = process.argv.slice(2);
+  (n.includes("--help") || n.includes("-h")) && (console.log(`
+${e.cyan("vc-generate-changelogs")} - Generate CHANGELOG.md files from git history
+
+${e.bold("USAGE:")}
+  vc-generate-changelogs [config-file]
+
+${e.bold("ARGUMENTS:")}
+  config-file    Path to configuration file (default: changelog-config.js)
+
+${e.bold("CONFIG FILE FORMAT:")}
+  The config file should export an object with the following structure:
+
+  export default {
+    packages: [
+      {
+        name: "framework",
+        path: "framework",
+        displayName: "Framework (@vc-shell/framework)"
+      },
+      // ... more packages
+    ],
+    rootDir: process.cwd(),           // Optional: root directory
+    generateRoot: true,                // Optional: generate root changelog
+    includeRootHeader: true            // Optional: include header in root changelog
+  };
+
+${e.bold("EXAMPLE:")}
+  vc-generate-changelogs changelog-config.js
+    `), process.exit(0));
+  const t = n[0] || "changelog-config.js", c = s(process.cwd(), t);
+  try {
+    console.log(e.blue(`📖 Loading config from ${c}...`));
+    const o = await import(c), r = o.default || o;
+    (!r.packages || !Array.isArray(r.packages)) && (console.error(e.red(`
+❌ Error: Config must export an object with 'packages' array`)), console.error(e.yellow(`
+Expected format:`)), console.error(e.gray("  export default { packages: [...] }")), process.exit(1));
+    for (const a of r.packages)
+      (!a.name || !a.path || !a.displayName) && (console.error(e.red(`
+❌ Error: Invalid package config: ${JSON.stringify(a)}`)), console.error(e.yellow(`
+Each package must have: name, path, displayName`)), process.exit(1));
+    await i(r);
+  } catch (o) {
+    o.code === "MODULE_NOT_FOUND" || o.code === "ERR_MODULE_NOT_FOUND" ? (console.error(e.red(`
+❌ Error: Config file not found: ${c}`)), console.error(e.yellow(`
+Create a config file or specify a different path.`)), console.error(e.gray(`
+Run 'vc-generate-changelogs --help' for more information.`))) : console.error(e.red(`
+❌ Error generating changelogs:`), o), process.exit(1);
+  }
+}
+l();

package/dist/generate-changelogs-_wYT4v6U.js

@@ -0,0 +1,139 @@
+import { sync as $ } from "cross-spawn";
+import { existsSync as u, readFileSync as d, writeFileSync as y } from "node:fs";
+import C from "node:path";
+import i from "chalk";
+async function L(N) {
+  const { packages: f, rootDir: m = process.cwd(), generateRoot: b = !0, includeRootHeader: g = !0 } = N;
+  console.log(i.cyan(`
+🚀 Generating initial CHANGELOG.md files...
+`));
+  for (const l of f) {
+    const a = C.join(m, l.path, "CHANGELOG.md");
+    if (u(a)) {
+      const t = `${a}.backup`, s = d(a, "utf-8");
+      y(t, s, "utf-8"), console.log(i.gray(`  📦 Backed up ${a} to ${t}`));
+    }
+    if (console.log(i.blue(`
+📝 Generating changelog for ${l.name}...`)), $(
+      "npx",
+      [
+        "conventional-changelog",
+        "-p",
+        "conventionalcommits",
+        "-i",
+        a,
+        "-s",
+        "-r",
+        "0",
+        // 0 = all commits
+        "--commit-path",
+        C.join(m, l.path)
+      ],
+      { stdio: "inherit", cwd: m }
+    ).status === 0) {
+      if (u(a)) {
+        let t = d(a, "utf-8");
+        t = t.replace(/^# CHANGELOG\s*\n/gm, ""), t = t.replace(/^# Change Log\s*\n/gm, ""), t = t.replace(/^All notable changes to this (project|package) will be documented in this file\.\s*\n/gm, ""), t = t.replace(
+          /^See \[Conventional Commits\]\(https:\/\/conventionalcommits\.org\) for commit guidelines\.\s*\n/gm,
+          ""
+        ), t = t.replace(/\n{3,}/g, `
+
+`), t = t.replace(
+          /^(##\s+\[[^\]]+\][^\n]*\n)\n(##\s+\[|$)/gm,
+          `$1
+**Note:** Version bump only
+
+$2`
+        ), t = t.trim() + `
+`, y(a, t, "utf-8");
+      }
+      console.log(i.green(`  ✓ Generated ${a}`));
+    } else
+      console.log(i.red(`  ✗ Failed to generate ${a}`));
+  }
+  b && await w({ packages: f, rootDir: m, includeRootHeader: g }), console.log(i.green(`
+✅ Initial changelogs generated successfully!`)), console.log(i.cyan(`
+📋 Next steps:`)), console.log(i.cyan("  1. Review the generated CHANGELOG.md files")), console.log(i.cyan("  2. Make any manual adjustments if needed")), console.log(i.cyan(`  3. Commit the changes
+`));
+}
+async function w(N) {
+  const { packages: f, rootDir: m = process.cwd(), includeRootHeader: b = !0 } = N;
+  console.log(i.blue(`
+📝 Generating consolidated root changelog...`));
+  const g = C.join(m, "CHANGELOG.md");
+  if (u(g)) {
+    const s = `${g}.backup`, r = d(g, "utf-8");
+    y(s, r, "utf-8"), console.log(i.gray(`  📦 Backed up ${g} to ${s}`));
+  }
+  const l = {}, a = {};
+  for (const s of f) {
+    const r = C.join(m, s.path, "CHANGELOG.md");
+    if (console.log(i.gray(`  📖 Collecting changes from ${s.name}...`)), u(r)) {
+      const p = d(r, "utf-8").split(`
+`);
+      let e = null, o = [];
+      for (const n of p) {
+        const G = n.match(/^##\s+(?:\[)?([\d.a-z-]+)(?:\])?(?:\s+\([^)]+\))?/i);
+        if (G) {
+          if (e && o.length > 0) {
+            const k = o.join(`
+`).trim();
+            l[e] || (l[e] = {}), l[e][s.displayName] = k;
+          }
+          e = G[1], o = [], a[e] || (a[e] = n.replace(/^##\s+/, ""));
+        } else e && n.trim() !== "" && !n.startsWith("# CHANGELOG") && !n.startsWith("# Change Log") && !n.startsWith("All notable changes") && !n.startsWith("See [Conventional Commits]") && o.push(n);
+      }
+      if (e && o.length > 0) {
+        const n = o.join(`
+`).trim();
+        l[e] || (l[e] = {}), l[e][s.displayName] = n;
+      }
+    }
+  }
+  let c = "";
+  b && (c = `# CHANGELOG
+
+All notable changes to this monorepo will be documented in this file.
+
+`);
+  const t = Object.keys(l).sort((s, r) => {
+    const h = s.split(/[.-]/).map((e) => isNaN(parseInt(e)) ? e : parseInt(e)), p = r.split(/[.-]/).map((e) => isNaN(parseInt(e)) ? e : parseInt(e));
+    for (let e = 0; e < Math.max(h.length, p.length); e++) {
+      const o = h[e] ?? 0, n = p[e] ?? 0;
+      if (o !== n)
+        return typeof o == "number" && typeof n == "number" ? n - o : String(n).localeCompare(String(o));
+    }
+    return 0;
+  });
+  for (const s of t) {
+    const r = l[s], h = Object.values(r).some((o) => !o || !o.trim() ? !1 : o.replace(/\*\*Note:\*\*\s+Version bump only[^\n]*/gi, "").trim().length > 0), p = a[s] || s;
+    if (c += `## ${p}
+
+`, !h) {
+      c += `**Note:** Version bump only
+
+`;
+      continue;
+    }
+    let e = !1;
+    for (const o of f) {
+      const n = r[o.displayName];
+      n && n.trim() && n.replace(/\*\*Note:\*\*\s+Version bump only[^\n]*/gi, "").trim().length > 0 && (e = !0, c += `### ${o.displayName}
+
+`, c += `${n}
+
+`);
+    }
+    e || (c += `**Note:** Version bump only
+
+`);
+  }
+  c = c.replace(/\n{3,}/g, `
+
+`), c = c.trim() + `
+`, y(g, c, "utf-8"), console.log(i.green(`  ✓ Generated ${g} with package grouping`));
+}
+export {
+  w as a,
+  L as g
+};

package/dist/release-config.js

@@ -1,31 +1,40 @@
-import w from "prompts";
-import { parse as G, valid as S } from "semver";
-import { readFileSync as N, writeFileSync as b, existsSync as R } from "node:fs";
-import k from "node:path";
+import G from "prompts";
+import { parse as A, valid as E } from "semver";
+import { readFileSync as P, writeFileSync as V, existsSync as j } from "node:fs";
+import S from "node:path";
 import n from "chalk";
-import A from "mri";
-import { argv as V } from "node:process";
+import O from "mri";
+import { argv as H } from "node:process";
 import { sync as m } from "cross-spawn";
-const v = A(V.slice(2)), E = !!v.dry;
-E && (console.log(n.inverse(n.yellow(" DRY RUN "))), console.log());
-function C(r) {
-  const g = k.resolve(r), c = k.resolve(g, "package.json");
-  return { pkg: JSON.parse(N(c, "utf-8")), pkgDir: g, pkgPath: c };
+import { g as K, a as Q } from "./generate-changelogs-_wYT4v6U.js";
+const C = O(H.slice(2)), I = !!C.dry;
+I && (console.log(n.inverse(n.yellow(" DRY RUN "))), console.log());
+function N(s) {
+  const g = S.resolve(s), l = S.resolve(g, "package.json");
+  return { pkg: JSON.parse(P(l, "utf-8")), pkgDir: g, pkgPath: l };
 }
-const W = async ({
-  packages: r,
+const z = async ({
+  packages: s,
   bumpVersion: g,
-  generateChangelog: c,
-  toTag: t,
-  customHooks: f
+  generateChangelog: l,
+  toTag: o,
+  customHooks: d
 }) => {
-  if (r.length === 0)
+  if (s.length === 0)
     throw new Error("No packages to release");
-  const l = !!v.dry;
-  l && console.log(n.yellow(`
+  const r = !!C.dry;
+  r && console.log(n.yellow(`
 ⚠️  DRY RUN MODE - No git operations will be performed
 `));
-  const { releaseType: h } = await w({
+  const { pkg: k } = N(s.find((h) => h !== ".") || s[0]), f = k.version.split(".").slice(0, 2).join("."), u = m("git", ["describe", "--tags", "--abbrev=0", "--match", `v${f}.*`], {
+    stdio: "pipe",
+    encoding: "utf-8"
+  });
+  let v = null;
+  u.status === 0 && u.stdout ? (v = u.stdout.toString().trim(), console.log(n.gray(`ℹ️  Using ${v} as reference point for changes
+`))) : console.log(n.yellow(`⚠️  No matching tag found for v${f}.*, Lerna will use default behavior
+`));
+  const { releaseType: t } = await G({
     type: "select",
     name: "releaseType",
     message: "Select release type",
@@ -36,99 +45,103 @@ const W = async ({
       { title: "Custom version", value: "custom" }
     ]
   });
-  if (!h) {
+  if (!t) {
     console.log(n.yellow(`
 Release cancelled
 `));
     return;
   }
-  const a = ["lerna", "version", "--conventional-commits"];
-  if (h === "prerelease") {
-    const { pkg: i } = C(r[0]), e = G(i.version), o = e && e.prerelease.length > 0, s = o ? e.prerelease[0] : null, { preid: y } = await w({
+  const e = ["lerna", "version"];
+  if (t === "auto")
+    e.push("--conventional-commits");
+  else if (t === "prerelease") {
+    const { pkg: h } = N(s[0]), w = A(h.version), c = w && w.prerelease.length > 0, y = c ? w.prerelease[0] : null, { preid: R } = await G({
       type: "select",
       name: "preid",
       message: "Select prerelease identifier",
       choices: [
         {
-          title: o && s === "alpha" ? "alpha (continue)" : "alpha",
+          title: c && y === "alpha" ? "alpha (continue)" : "alpha",
           value: "alpha"
         },
         {
-          title: o && s === "beta" ? "beta (continue)" : "beta",
+          title: c && y === "beta" ? "beta (continue)" : "beta",
           value: "beta"
         },
-        { title: o && s === "rc" ? "rc (continue)" : "rc", value: "rc" }
+        { title: c && y === "rc" ? "rc (continue)" : "rc", value: "rc" }
       ]
     });
-    if (!y) {
+    if (!R) {
       console.log(n.yellow(`
 Release cancelled
 `));
       return;
     }
-    o && s === y ? a.push("prerelease") : a.push("prerelease", "--preid", y), v.tag || (v.tag = y);
-  } else if (h === "graduate")
-    a.push("--conventional-graduate");
-  else if (h === "custom") {
-    const { pkg: i } = C(r[0]), { customVersion: e } = await w({
+    c && y === R ? e.push("prerelease") : e.push("prerelease", "--preid", R), C.tag || (C.tag = R);
+  } else if (t === "graduate")
+    e.push("--conventional-graduate");
+  else if (t === "custom") {
+    const { pkg: h } = N(s[0]), { customVersion: w } = await G({
       type: "text",
       name: "customVersion",
       message: "Enter custom version",
-      initial: i.version,
-      validate: (s) => S(s) ? !0 : "Invalid semver version"
+      initial: h.version,
+      validate: (y) => E(y) ? !0 : "Invalid semver version"
     });
-    if (!e) {
+    if (!w) {
       console.log(n.yellow(`
 Release cancelled
 `));
       return;
     }
-    a.push(e);
-    const o = G(e);
-    if (o && o.prerelease.length > 0 && !v.tag) {
-      const s = o.prerelease[0];
-      typeof s == "string" && (v.tag = s);
+    e.push(w);
+    const c = A(w);
+    if (c && c.prerelease.length > 0 && !C.tag) {
+      const y = c.prerelease[0];
+      typeof y == "string" && (C.tag = y);
     }
   }
-  const { yes: u } = await w({
+  const { yes: a } = await G({
     type: "confirm",
     name: "yes",
     message: "Ready to release. Continue?"
   });
-  if (!u) {
+  if (!a) {
     console.log(n.yellow(`
 Release cancelled
 `));
     return;
   }
-  l ? a.push("--no-git-tag-version", "--no-push") : a.push("--no-push"), console.log(n.cyan(`
-Running: npx ${a.join(" ")}
+  r ? e.push("--no-git-tag-version", "--no-push") : e.push("--no-push"), C.force && (e.push("--force-publish"), console.log(n.yellow(`
+⚠️  Force publish mode - all packages will be versioned
+`))), console.log(n.cyan(`
+Running: npx ${e.join(" ")}
 `));
-  const p = m("npx", a, { stdio: "inherit" });
-  if (p.status !== 0 && (console.error(n.red(`
+  const i = m("npx", e, { stdio: "inherit" });
+  if (i.status !== 0 && (console.error(n.red(`
 ❌ Release process failed
-`)), process.exit(p.status || 1)), await j(r), f) {
+`)), process.exit(i.status || 1)), await $(s), d) {
     console.log(n.cyan(`
 Running post-version hooks...
 `));
-    const { pkg: i } = C(r[0] === "." ? r[1] : r[0]);
-    await f(i.version);
+    const { pkg: h } = N(s[0] === "." ? s[1] : s[0]);
+    await d(h.version);
   }
   console.log(n.cyan(`
 Updating yarn.lock with new package versions...
 `));
-  const d = m("yarn", ["install"], { stdio: "inherit" });
-  if (d.status !== 0 && (console.error(n.red(`
+  const b = m("yarn", ["install"], { stdio: "inherit" });
+  if (b.status !== 0 && (console.error(n.red(`
 ❌ Failed to update yarn.lock
-`)), process.exit(d.status || 1)), await O(r), await H(r), !l && m("git", ["status", "--porcelain"], { stdio: "pipe" }).stdout?.toString().trim()) {
-    const o = m("git", ["describe", "--tags", "--abbrev=0"], { stdio: "pipe" }).stdout?.toString().trim() || "HEAD";
-    m("git", ["add", "-A"], { stdio: "inherit" }), m("git", ["commit", "--amend", "--no-edit", "--no-verify"], { stdio: "inherit" }), m("git", ["tag", "-f", o], { stdio: "inherit" }), console.log(n.cyan(`
+`)), process.exit(b.status || 1)), await L(s), await D(s), !r && m("git", ["status", "--porcelain"], { stdio: "pipe" }).stdout?.toString().trim()) {
+    const c = m("git", ["describe", "--tags", "--abbrev=0"], { stdio: "pipe" }).stdout?.toString().trim() || "HEAD";
+    m("git", ["add", "-A"], { stdio: "inherit" }), m("git", ["commit", "--amend", "--no-edit", "--no-verify"], { stdio: "inherit" }), m("git", ["tag", "-f", c], { stdio: "inherit" }), console.log(n.cyan(`
 Pushing changes to remote...
-`)), m("git", ["push", "origin", "HEAD", "--force-with-lease"], { stdio: "inherit" }), m("git", ["push", "origin", o, "--force"], { stdio: "inherit" }), console.log(n.green(`
+`)), m("git", ["push", "origin", "HEAD", "--force-with-lease"], { stdio: "inherit" }), m("git", ["push", "origin", c, "--force"], { stdio: "inherit" }), console.log(n.green(`
 ✅ Updated changelogs, package.json, and pushed to remote
 `));
   }
-  l ? (console.log(n.yellow(`
+  r ? (console.log(n.yellow(`
 ✅ Dry run completed successfully!
 `)), console.log(n.cyan("Changes made:")), console.log(n.cyan("  - Updated package versions")), console.log(n.cyan("  - Generated/updated CHANGELOG.md files")), console.log(n.cyan("  - npmTag will be determined from git tag in CI")), console.log(n.cyan(`  - Updated yarn.lock with new package versions
 `)), console.log(n.yellow("No git operations performed. Review changes with:")), console.log(n.cyan(`  git diff
@@ -139,111 +152,113 @@ Pushing changes to remote...
 ℹ️  npmTag will be automatically determined from git tag in CI`)), console.log(n.cyan(`   GitHub Actions will publish with the correct tag based on the git tag
 `)));
 };
-async function O(r) {
+async function L(s) {
   console.log(n.cyan(`
 Enhancing changelogs...
 `));
-  for (const g of r) {
+  for (const g of s) {
     if (g === ".") continue;
-    const c = k.join(g, "CHANGELOG.md");
-    if (!R(c)) continue;
-    let t = N(c, "utf-8");
-    t = t.replace(/^# CHANGELOG\s*\n/gm, ""), t = t.replace(/^# Change Log\s*\n/gm, ""), t = t.replace(/^All notable changes to this (project|package) will be documented in this file\.\s*\n/gm, ""), t = t.replace(
+    const l = S.join(g, "CHANGELOG.md");
+    if (!j(l)) continue;
+    let o = P(l, "utf-8");
+    o = o.replace(/^# CHANGELOG\s*\n/gm, ""), o = o.replace(/^# Change Log\s*\n/gm, ""), o = o.replace(/^All notable changes to this (project|package) will be documented in this file\.\s*\n/gm, ""), o = o.replace(
       /^See \[Conventional Commits\]\(https:\/\/conventionalcommits\.org\) for commit guidelines\.\s*\n/gm,
       ""
-    ), t = t.replace(/\n{3,}/g, `
+    ), o = o.replace(/\n{3,}/g, `
 
-`), t = t.replace(
+`), o = o.replace(
       /^(##\s+\[[^\]]+\][^\n]*\n)\n(##\s+\[|$)/gm,
       `$1
 **Note:** Version bump only for package
 
 $2`
-    ), t = t.trim() + `
-`, b(c, t, "utf-8");
+    ), o = o.trim() + `
+`, V(l, o, "utf-8");
   }
 }
-async function j(r) {
-  const g = r.find((h) => h !== ".");
+async function $(s) {
+  const g = s.find((k) => k !== ".");
   if (!g) return;
-  const { pkg: c } = C(g), t = c.version, f = "package.json", l = JSON.parse(N(f, "utf-8"));
-  l.version !== t && (l.version = t, b(f, JSON.stringify(l, null, 2) + `
-`, "utf-8"), console.log(n.gray(`  Updated root package.json version: ${t}`)));
+  const { pkg: l } = N(g), o = l.version, d = "package.json", r = JSON.parse(P(d, "utf-8"));
+  r.version !== o && (r.version = o, V(d, JSON.stringify(r, null, 2) + `
+`, "utf-8"), console.log(n.gray(`  Updated root package.json version: ${o}`)));
 }
-async function H(r) {
+async function D(s) {
   console.log(n.cyan(`
 Generating root CHANGELOG with package grouping...
 `));
-  const g = "CHANGELOG.md", c = {
+  const g = "CHANGELOG.md", l = {
     framework: "VC-Shell Framework (@vc-shell/framework)",
     "cli/api-client": "API Client Generator (@vc-shell/api-client-generator)",
     "cli/create-vc-app": "Create VC App (@vc-shell/create-vc-app)",
     "configs/release-config": "Release Config (@vc-shell/release-config)",
     "configs/vite-config": "Vite Config (@vc-shell/config-generator)",
     "configs/ts-config": "TypeScript Config (@vc-shell/ts-config)"
-  }, t = {}, f = {};
-  for (const a of r) {
-    if (a === ".") continue;
-    const u = k.join(a, "CHANGELOG.md"), p = c[a] || a;
-    if (!R(u)) continue;
-    const i = N(u, "utf-8").split(`
+  }, o = {}, d = {};
+  for (const p of s) {
+    if (p === ".") continue;
+    const f = S.join(p, "CHANGELOG.md"), u = l[p] || p;
+    if (!j(f)) continue;
+    const t = P(f, "utf-8").split(`
 `);
-    let e = null, o = [];
-    for (const s of i) {
-      const y = s.match(/^##\s+(?:\[)?([\d.a-z-]+)(?:\])?(?:\s+\([^)]+\))?/i);
-      if (y) {
-        if (e && o.length > 0) {
-          const P = o.join(`
+    let e = null, a = [];
+    for (const i of t) {
+      const b = i.match(/^##\s+(?:\[)?([\d.a-z-]+)(?:\])?(?:\s+\([^)]+\))?/i);
+      if (b) {
+        if (e && a.length > 0) {
+          const h = a.join(`
 `).trim();
-          t[e] || (t[e] = {}), t[e][p] = P;
+          o[e] || (o[e] = {}), o[e][u] = h;
         }
-        e = y[1], o = [], f[e] || (f[e] = s.replace(/^##\s+/, ""));
-      } else e && s.trim() !== "" && !s.startsWith("# CHANGELOG") && !s.startsWith("# Change Log") && !s.startsWith("All notable changes") && !s.startsWith("See [Conventional Commits]") && o.push(s);
+        e = b[1], a = [], d[e] || (d[e] = i.replace(/^##\s+/, ""));
+      } else e && i.trim() !== "" && !i.startsWith("# CHANGELOG") && !i.startsWith("# Change Log") && !i.startsWith("All notable changes") && !i.startsWith("See [Conventional Commits]") && a.push(i);
     }
-    if (e && o.length > 0) {
-      const s = o.join(`
+    if (e && a.length > 0) {
+      const i = a.join(`
 `).trim();
-      t[e] || (t[e] = {}), t[e][p] = s;
+      o[e] || (o[e] = {}), o[e][u] = i;
     }
   }
-  let l = "";
-  const h = Object.keys(t).sort((a, u) => {
-    const p = a.split(/[.-]/).map((i) => isNaN(parseInt(i)) ? i : parseInt(i)), d = u.split(/[.-]/).map((i) => isNaN(parseInt(i)) ? i : parseInt(i));
-    for (let i = 0; i < Math.max(p.length, d.length); i++) {
-      const e = p[i] ?? 0, o = d[i] ?? 0;
-      if (e !== o)
-        return typeof e == "number" && typeof o == "number" ? o - e : String(o).localeCompare(String(e));
+  let r = "";
+  const k = Object.keys(o).sort((p, f) => {
+    const u = p.split(/[.-]/).map((t) => isNaN(parseInt(t)) ? t : parseInt(t)), v = f.split(/[.-]/).map((t) => isNaN(parseInt(t)) ? t : parseInt(t));
+    for (let t = 0; t < Math.max(u.length, v.length); t++) {
+      const e = u[t] ?? 0, a = v[t] ?? 0;
+      if (e !== a)
+        return typeof e == "number" && typeof a == "number" ? a - e : String(a).localeCompare(String(e));
     }
     return 0;
   });
-  for (const a of h) {
-    const u = t[a], p = Object.values(u).some((e) => !e || !e.trim() ? !1 : e.replace(/\*\*Note:\*\*\s+Version bump only[^\n]*/gi, "").trim().length > 0), d = f[a] || a;
-    if (l += `## ${d}
+  for (const p of k) {
+    const f = o[p], u = Object.values(f).some((e) => !e || !e.trim() ? !1 : e.replace(/\*\*Note:\*\*\s+Version bump only[^\n]*/gi, "").trim().length > 0), v = d[p] || p;
+    if (r += `## ${v}
 
-`, !p) {
-      l += `**Note:** Version bump only for package
+`, !u) {
+      r += `**Note:** Version bump only for package
 
 `;
       continue;
     }
-    let i = !1;
-    for (const e of r) {
+    let t = !1;
+    for (const e of s) {
       if (e === ".") continue;
-      const o = c[e] || e, s = u[o];
-      s && s.trim() && s.replace(/\*\*Note:\*\*\s+Version bump only[^\n]*/gi, "").trim().length > 0 && (i = !0, l += `### ${o}
+      const a = l[e] || e, i = f[a];
+      i && i.trim() && i.replace(/\*\*Note:\*\*\s+Version bump only[^\n]*/gi, "").trim().length > 0 && (t = !0, r += `### ${a}
 
-`, l += `${s}
+`, r += `${i}
 
 `);
     }
-    i || (l += `**Note:** Version bump only for package
+    t || (r += `**Note:** Version bump only for package
 
 `);
   }
-  l = l.replace(/\n{3,}/g, `
+  r = r.replace(/\n{3,}/g, `
 
-`), b(g, l, "utf-8"), console.log(n.green("  ✓ Generated root CHANGELOG.md with package grouping"));
+`), V(g, r, "utf-8"), console.log(n.green("  ✓ Generated root CHANGELOG.md with package grouping"));
 }
 export {
-  W as release
+  K as generateInitialChangelogs,
+  Q as generateRootChangelog,
+  z as release
 };

package/dist/src/cli-generate-changelogs.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli-generate-changelogs.d.ts.map

package/dist/src/cli-generate-changelogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-generate-changelogs.d.ts","sourceRoot":"","sources":["../../src/cli-generate-changelogs.ts"],"names":[],"mappings":""}

package/dist/src/generate-changelogs.d.ts

@@ -0,0 +1,27 @@
+export interface PackageConfig {
+    name: string;
+    path: string;
+    displayName: string;
+}
+export interface ChangelogGeneratorOptions {
+    packages: PackageConfig[];
+    rootDir?: string;
+    generateRoot?: boolean;
+    includeRootHeader?: boolean;
+}
+/**
+ * Generates CHANGELOG.md files from all commits for specified packages
+ * @param options - Configuration options for changelog generation
+ */
+export declare function generateInitialChangelogs(options: ChangelogGeneratorOptions): Promise<void>;
+interface RootChangelogOptions {
+    packages: PackageConfig[];
+    rootDir?: string;
+    includeRootHeader?: boolean;
+}
+/**
+ * Generates consolidated root CHANGELOG.md from package changelogs
+ */
+export declare function generateRootChangelog(options: RootChangelogOptions): Promise<void>;
+export {};
+//# sourceMappingURL=generate-changelogs.d.ts.map

package/dist/src/generate-changelogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-changelogs.d.ts","sourceRoot":"","sources":["../../src/generate-changelogs.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFjG;AAED,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0JxF"}

package/dist/src/index.d.ts

@@ -1,2 +1,4 @@
 export { release } from './release';
+export { generateInitialChangelogs, generateRootChangelog } from './generate-changelogs';
+export type { PackageConfig, ChangelogGeneratorOptions } from './generate-changelogs';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/release.d.ts

@@ -17,7 +17,7 @@ export declare const release: ({ packages, bumpVersion, generateChangelog, toTag
      * @param workspaceName
      * @returns
      */
-    customHooks: (version: string) => void | Promise<void>;
+    customHooks?: (version: string) => void | Promise<void>;
     /** @deprecated Lerna handles version bumping automatically */
     bumpVersion?: (pkgName: string, version: string) => void | Promise<void>;
     /** @deprecated Lerna generates changelogs automatically */

package/dist/src/release.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/release.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,GAAU,mEAM3B;IACD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvG,8DAA8D;IAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC,kBAqMA,CAAC"}
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/release.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,GAAU,mEAM3B;IACD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvG,8DAA8D;IAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC,kBAiOA,CAAC"}

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "@vc-shell/release-config",
-  "version": "1.2.1",
+  "version": "1.2.3-beta.0",
   "type": "module",
   "main": "dist/release-config.js",
   "types": "./dist/src/index.d.ts",
   "files": [
     "dist"
   ],
+  "bin": {
+    "vc-generate-changelogs": "./dist/cli-generate-changelogs.js"
+  },
   "scripts": {
     "build": "vite build"
   },
   "dependencies": {
     "chalk": "^2.4.2",
+    "conventional-changelog-cli": "^5.0.0",
     "cross-spawn": "^7.0.3",
     "lerna": "^9.0.0",
     "mri": "^1.2.0",
@@ -30,5 +34,5 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "gitHead": "75afdc6afb8a3563385e526f9384a34557fe3561"
+  "gitHead": "1394fe061df6f536cd2f0dac0e2a6082eb0c2b64"
 }