@qualcomm-ui/changesets-cli 1.0.0

package/LICENSE.txt

@@ -0,0 +1,31 @@
+Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted (subject to the limitations in the
+disclaimer below) provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+
+    * Neither the name of Qualcomm Technologies, Inc. nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
+GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
+HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,106 @@
+# @qualcomm-ui/changesets-cli
+
+Changeset automation CLI for conventional commits.
+
+This package streamlines the release process for monorepos by converting [conventional commits](https://www.conventionalcommits.org/) into [changesets](https://github.com/changesets/changesets), managing versioning, formatting changelogs, and generating combined release notes.
+
+## Installation
+
+```sh
+pnpm add -D @qualcomm-ui/changesets-cli
+```
+
+## Commands
+
+### `prep-release`
+
+Runs the full release-prep pipeline sequentially:
+
+1. Generate changesets from conventional commits
+2. Bump versions and generate changelogs
+3. Consolidate changelog formatting
+4. Generate combined release notes and write to a temporary file
+
+```sh
+qui-changesets prep-release [options]
+```
+
+| Option                        | Description                                                                   | Default                  |
+| ----------------------------- | ----------------------------------------------------------------------------- | ------------------------ |
+| `--in-steps`                  | Pause after each step and wait for confirmation                               | `false`                  |
+| `--from-release-tags`         | Diff each package from its most recent release tag instead of the base branch | `false`                  |
+| `--include-commit-links`      | Embed commit hashes in changeset summaries for changelog links                | `false`                  |
+| `--package-manager <command>` | Package manager command to use for `changeset version`                        | `pnpm`                   |
+| `--config <path>`             | Path to the changesets config file, relative to the project root              | `.changeset/config.json` |
+
+### `changeset-generate`
+
+Generates changesets from conventional commits without running the full pipeline.
+
+```sh
+qui-changesets changeset-generate [options]
+```
+
+| Option                   | Description                                                                   | Default                  |
+| ------------------------ | ----------------------------------------------------------------------------- | ------------------------ |
+| `--from-release-tags`    | Diff each package from its most recent release tag instead of the base branch | `false`                  |
+| `--include-commit-links` | Embed commit hashes in changeset summaries for changelog links                | `false`                  |
+| `--config <path>`        | Path to the changesets config file, relative to the project root              | `.changeset/config.json` |
+
+### `consolidate-changelogs`
+
+Normalizes and reformats all changed `CHANGELOG.md` files into a consistent structure.
+
+```sh
+qui-changesets consolidate-changelogs
+```
+
+### `generate-release-notes`
+
+Generates combined release notes from changed package changelogs, separating substantive changes from dependency-only updates.
+
+```sh
+qui-changesets generate-release-notes
+```
+
+### `check-versions`
+
+Checks which packages have newer local versions than what is published on npm. Sets a `should-publish` GitHub Actions output.
+
+```sh
+qui-changesets check-versions [options]
+```
+
+| Option            | Description                                                      | Default                  |
+| ----------------- | ---------------------------------------------------------------- | ------------------------ |
+| `--config <path>` | Path to the changesets config file, relative to the project root | `.changeset/config.json` |
+
+### `create-github-releases`
+
+Creates GitHub releases for published packages by parsing their changelogs.
+
+```sh
+qui-changesets create-github-releases [options]
+```
+
+| Option                | Description                                                                        | Default                  |
+| --------------------- | ---------------------------------------------------------------------------------- | ------------------------ |
+| `--token <token>`     | GitHub token for authentication (falls back to `TOKEN` or `GITHUB_TOKEN` env vars) |                          |
+| `--repo <owner/repo>` | GitHub repository in `owner/repo` format                                           | Derived from git remote  |
+| `--config <path>`     | Path to the changesets config file, relative to the project root                   | `.changeset/config.json` |
+
+## Programmatic API
+
+The package also exports core functions for use in scripts:
+
+```ts
+import {
+  conventionalCommitChangeset,
+  consolidateChangelogs,
+  generateReleaseNotes,
+} from "@qualcomm-ui/changesets-cli"
+```
+
+## License
+
+Licensed under the [BSD-3-Clause-Clear License](https://spdx.org/licenses/BSD-3-Clause-Clear.html).

package/dist/changelog-formatter.cjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/changelog-formatter.ts
+var changelog_formatter_exports = {};
+__export(changelog_formatter_exports, {
+  default: () => changelog_formatter_default
+});
+module.exports = __toCommonJS(changelog_formatter_exports);
+var typeMap = {
+  build: "Build System",
+  chore: "Miscellaneous Chores",
+  ci: "Continuous Integration",
+  docs: "Documentation",
+  feat: "Features",
+  fix: "Bug Fixes",
+  perf: "Performance Improvements",
+  refactor: "Code Refactoring",
+  style: "Styles",
+  styles: "Styles",
+  test: "Tests"
+};
+var changelogFunctions = {
+  getDependencyReleaseLine: (_changesets, dependenciesUpdated, options) => {
+    if (!options.repo) {
+      throw new Error(
+        'Please provide a repo to this changelog generator like this:\n"changelog": ["./changelog.js", { "repo": "org/repo" }]'
+      );
+    }
+    if (dependenciesUpdated.length === 0) {
+      return "";
+    }
+    const deps = dependenciesUpdated.map((d) => d.name).join(", ");
+    return `### Miscellaneous Chores
+* **deps:** update dependencies [${deps}]`;
+  },
+  getReleaseLine: (changeset, _type, options) => {
+    if (!options?.repo) {
+      throw new Error(
+        'Please provide a repo to this changelog generator like this:\n"changelog": ["./changelog.js", { "repo": "org/repo" }]'
+      );
+    }
+    let commitFromSummary;
+    const cleanedSummary = changeset.summary.split("\n").filter((line2) => !line2.trim().toLowerCase().startsWith("signed-off-by:")).join("\n").replace(/^\s*commit:\s*([^\s]+)/im, (_, commit2) => {
+      commitFromSummary = commit2;
+      return "";
+    }).trim();
+    const prMatch = cleanedSummary.match(/\(#(\d+)\)/);
+    const prNumber = prMatch?.[1];
+    const typeMatch = cleanedSummary.match(
+      /^(feat|fix|refactor|chore|perf|test|docs|styles?|ci|build)\s*(\(.+?\))?!?:\s*/i
+    );
+    const conventionalType = typeMatch?.[1]?.toLowerCase();
+    const scope = typeMatch?.[2]?.replace("(", "").replace(")", "");
+    const isBreaking = cleanedSummary.includes("!:") || cleanedSummary.toLowerCase().includes("breaking");
+    const summary = cleanedSummary.replace(
+      /^(feat|fix|refactor|chore|perf|test|docs|styles?|ci|build)\s*(\(.+?\))?!?:\s*/i,
+      ""
+    ).replace(/\s*\(#\d+\)\s*$/, "").trim();
+    const section = isBreaking ? "BREAKING CHANGES" : typeMap[conventionalType ?? ""] || "Miscellaneous";
+    let line = `### ${section}
+* ${scope ? `[${scope}]: ` : ""}${summary}`;
+    if (prNumber) {
+      line += ` ([#${prNumber}](${options.repo}/issues/${prNumber}))`;
+    }
+    const commit = commitFromSummary || changeset.commit;
+    if (commit) {
+      const shortCommit = commit.slice(0, 7);
+      line += ` ([${shortCommit}](${options.repo}/commit/${commit}))`;
+    }
+    return line;
+  }
+};
+var changelog_formatter_default = changelogFunctions;
+//# sourceMappingURL=changelog-formatter.cjs.map

package/dist/changelog-formatter.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/changelog-formatter.ts"],
+  "sourcesContent": ["// Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.\n// SPDX-License-Identifier: BSD-3-Clause-Clear\n\ninterface ChangesetInfo {\n  commit?: string\n  summary: string\n}\n\ninterface DependencyUpdated {\n  name: string\n}\n\ninterface ChangelogOptions {\n  repo: string\n}\n\nconst typeMap: Record<string, string> = {\n  build: \"Build System\",\n  chore: \"Miscellaneous Chores\",\n  ci: \"Continuous Integration\",\n  docs: \"Documentation\",\n  feat: \"Features\",\n  fix: \"Bug Fixes\",\n  perf: \"Performance Improvements\",\n  refactor: \"Code Refactoring\",\n  style: \"Styles\",\n  styles: \"Styles\",\n  test: \"Tests\",\n}\n\nconst changelogFunctions = {\n  getDependencyReleaseLine: (\n    _changesets: unknown,\n    dependenciesUpdated: DependencyUpdated[],\n    options: ChangelogOptions,\n  ) => {\n    if (!options.repo) {\n      throw new Error(\n        'Please provide a repo to this changelog generator like this:\\n\"changelog\": [\"./changelog.js\", { \"repo\": \"org/repo\" }]',\n      )\n    }\n    if (dependenciesUpdated.length === 0) {\n      return \"\"\n    }\n\n    const deps = dependenciesUpdated.map((d) => d.name).join(\", \")\n    return `### Miscellaneous Chores\\n* **deps:** update dependencies [${deps}]`\n  },\n\n  getReleaseLine: (\n    changeset: ChangesetInfo,\n    _type: string,\n    options: ChangelogOptions,\n  ) => {\n    if (!options?.repo) {\n      throw new Error(\n        'Please provide a repo to this changelog generator like this:\\n\"changelog\": [\"./changelog.js\", { \"repo\": \"org/repo\" }]',\n      )\n    }\n\n    let commitFromSummary: string | undefined\n\n    const cleanedSummary = changeset.summary\n      .split(\"\\n\")\n      .filter((line) => !line.trim().toLowerCase().startsWith(\"signed-off-by:\"))\n      .join(\"\\n\")\n      .replace(/^\\s*commit:\\s*([^\\s]+)/im, (_, commit) => {\n        commitFromSummary = commit\n        return \"\"\n      })\n      .trim()\n\n    const prMatch = cleanedSummary.match(/\\(#(\\d+)\\)/)\n    const prNumber = prMatch?.[1]\n\n    const typeMatch = cleanedSummary.match(\n      /^(feat|fix|refactor|chore|perf|test|docs|styles?|ci|build)\\s*(\\(.+?\\))?!?:\\s*/i,\n    )\n    const conventionalType = typeMatch?.[1]?.toLowerCase()\n    const scope = typeMatch?.[2]?.replace(\"(\", \"\").replace(\")\", \"\")\n    const isBreaking =\n      cleanedSummary.includes(\"!:\") ||\n      cleanedSummary.toLowerCase().includes(\"breaking\")\n    const summary = cleanedSummary\n      .replace(\n        /^(feat|fix|refactor|chore|perf|test|docs|styles?|ci|build)\\s*(\\(.+?\\))?!?:\\s*/i,\n        \"\",\n      )\n      .replace(/\\s*\\(#\\d+\\)\\s*$/, \"\")\n      .trim()\n\n    const section = isBreaking\n      ? \"BREAKING CHANGES\"\n      : typeMap[conventionalType ?? \"\"] || \"Miscellaneous\"\n\n    let line = `### ${section}\\n* ${scope ? `[${scope}]: ` : \"\"}${summary}`\n\n    if (prNumber) {\n      line += ` ([#${prNumber}](${options.repo}/issues/${prNumber}))`\n    }\n\n    const commit = commitFromSummary || changeset.commit\n    if (commit) {\n      const shortCommit = commit.slice(0, 7)\n      line += ` ([${shortCommit}](${options.repo}/commit/${commit}))`\n    }\n\n    return line\n  },\n}\n\nexport default changelogFunctions\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,IAAM,UAAkC;AAAA,EACtC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AACR;AAEA,IAAM,qBAAqB;AAAA,EACzB,0BAA0B,CACxB,aACA,qBACA,YACG;AACH,QAAI,CAAC,QAAQ,MAAM;AACjB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,QAAI,oBAAoB,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AAEA,UAAM,OAAO,oBAAoB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI;AAC7D,WAAO;AAAA,mCAA8D,IAAI;AAAA,EAC3E;AAAA,EAEA,gBAAgB,CACd,WACA,OACA,YACG;AACH,QAAI,CAAC,SAAS,MAAM;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AAEJ,UAAM,iBAAiB,UAAU,QAC9B,MAAM,IAAI,EACV,OAAO,CAACA,UAAS,CAACA,MAAK,KAAK,EAAE,YAAY,EAAE,WAAW,gBAAgB,CAAC,EACxE,KAAK,IAAI,EACT,QAAQ,4BAA4B,CAAC,GAAGC,YAAW;AAClD,0BAAoBA;AACpB,aAAO;AAAA,IACT,CAAC,EACA,KAAK;AAER,UAAM,UAAU,eAAe,MAAM,YAAY;AACjD,UAAM,WAAW,UAAU,CAAC;AAE5B,UAAM,YAAY,eAAe;AAAA,MAC/B;AAAA,IACF;AACA,UAAM,mBAAmB,YAAY,CAAC,GAAG,YAAY;AACrD,UAAM,QAAQ,YAAY,CAAC,GAAG,QAAQ,KAAK,EAAE,EAAE,QAAQ,KAAK,EAAE;AAC9D,UAAM,aACJ,eAAe,SAAS,IAAI,KAC5B,eAAe,YAAY,EAAE,SAAS,UAAU;AAClD,UAAM,UAAU,eACb;AAAA,MACC;AAAA,MACA;AAAA,IACF,EACC,QAAQ,mBAAmB,EAAE,EAC7B,KAAK;AAER,UAAM,UAAU,aACZ,qBACA,QAAQ,oBAAoB,EAAE,KAAK;AAEvC,QAAI,OAAO,OAAO,OAAO;AAAA,IAAO,QAAQ,IAAI,KAAK,QAAQ,EAAE,GAAG,OAAO;AAErE,QAAI,UAAU;AACZ,cAAQ,OAAO,QAAQ,KAAK,QAAQ,IAAI,WAAW,QAAQ;AAAA,IAC7D;AAEA,UAAM,SAAS,qBAAqB,UAAU;AAC9C,QAAI,QAAQ;AACV,YAAM,cAAc,OAAO,MAAM,GAAG,CAAC;AACrC,cAAQ,MAAM,WAAW,KAAK,QAAQ,IAAI,WAAW,MAAM;AAAA,IAC7D;AAEA,WAAO;AAAA,EACT;AACF;AAEA,IAAO,8BAAQ;",
+  "names": ["line", "commit"]
+}

package/dist/changelog-formatter.d.ts

@@ -0,0 +1,16 @@
+interface ChangesetInfo {
+    commit?: string;
+    summary: string;
+}
+interface DependencyUpdated {
+    name: string;
+}
+interface ChangelogOptions {
+    repo: string;
+}
+declare const changelogFunctions: {
+    getDependencyReleaseLine: (_changesets: unknown, dependenciesUpdated: DependencyUpdated[], options: ChangelogOptions) => string;
+    getReleaseLine: (changeset: ChangesetInfo, _type: string, options: ChangelogOptions) => string;
+};
+export default changelogFunctions;
+//# sourceMappingURL=changelog-formatter.d.ts.map

package/dist/changelog-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-formatter.d.ts","sourceRoot":"","sources":["../src/changelog-formatter.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAgBD,QAAA,MAAM,kBAAkB;4CAEP,OAAO,uBACC,iBAAiB,EAAE,WAC/B,gBAAgB;gCAgBd,aAAa,SACjB,MAAM,WACJ,gBAAgB;CAyD5B,CAAA;AAED,eAAe,kBAAkB,CAAA"}

package/dist/check-versions.d.ts

@@ -0,0 +1,4 @@
+export declare function checkVersions(options?: {
+    configPath?: string;
+}): Promise<void>;
+//# sourceMappingURL=check-versions.d.ts.map

package/dist/check-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-versions.d.ts","sourceRoot":"","sources":["../src/check-versions.ts"],"names":[],"mappings":"AAqCA,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAC,iBA2ClE"}