chore: add git cliff for changelog

Author: danielpza

cliff.toml

@@ -0,0 +1,39 @@
+# git-cliff ~ configuration file
+# https://git-cliff.org/docs/configuration
+
+[changelog]
+# A Tera template to be rendered for each release in the changelog.
+# See https://keats.github.io/tera/docs/#introduction
+body = """
+{% if version %}\
+    ## {{ version | trim_start_matches(pat="v") }} - {{ timestamp | date(format="%Y-%m-%d") }}\
+{% else %}\
+    ## Unreleased
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {% for commit in commits %}\
+        - {% if commit.breaking %}[**breaking**] {% endif %}{{ commit.message | upper_first }}\
+          {% if commit.remote.username %} by @{{ commit.remote.username }}{%- endif %}\
+          {% if commit.remote.pr_number %} in #{{ commit.remote.pr_number }}\
+		  {% else %} in ([{{ commit.id | truncate(length=7, end="") }}]({{ commit.id }}))\
+		  {%- endif %}
+    {% endfor %}\
+{% endfor %}\
+{% raw %}\n{% endraw %}
+"""
+
+[git]
+conventional_commits = true
+filter_commits = true
+commit_parsers = [
+  { message = "^feat", group = "Features" },
+  { message = "^fix", group = "Bug Fixes" },
+  { message = "^doc", group = "Documentation" },
+  { message = "^perf", group = "Performance" },
+  { message = "^refactor", group = "Refactor" },
+  { message = "^style", group = "Styling" },
+  { message = "^test", group = "Testing" },
+  { message = "^chore\\(release\\):", skip = true },
+  { message = "^chore|^ci", group = "Miscellaneous Tasks" },
+]

package.json

@@ -40,6 +40,7 @@
     "@typescript-eslint/rule-tester": "^8.44.0",
     "eslint": "^9.35.0",
     "eslint-doc-generator": "^2.2.2",
+    "git-cliff": "^2.10.0",
     "prettier": "^3.6.2",
     "tsdown": "^0.15.2",
     "tsx": "^4.20.5",

pnpm-lock.yaml

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+version=$(pnpm git-cliff --bumped-version)
+
+if [[ $version == v* ]]; then
+  version=${version:1}
+fi
+
+pnpm git-cliff --tag "${version}" --output CHANGELOG.md
+pnpm version "${version}" --no-git-tag-version
+
+git add CHANGELOG.md package.json
+
+git commit -m "chore(release): v${version}"
+git tag -a -m "${version}" v"${version}"