21.2.2 (2026-08-13)

Bug Fixes

• parse: require colon after note keywords (conventional-commits-parser 7.1.2) (#4927) (b83c515), closes conventional-changelog/conventional-changelog#1517
• fix(container): resolve packages from TypeScript configs by @Guflly in #4914
• fix(resolve-extends): support Yarn Plug'n'Play by @Guflly in #4933

Chore, docs, etc.

• docs: fix typos in comments and JSDoc by @maxtaran2010 in #4880
• docs: fix Deno setup without package.json by @awnoa in #4896
• chore: repair broken lockfile from #4939 and add merge queue CI support by @escapedcat in #4941
• docs(config-conventional): document rules that go beyond the spec by @escapedcat in #4910

New Contributors

• @maxtaran2010 made their first contribution in #4880
• @awnoa made their first contribution in #4896
• @Guflly made their first contribution in #4914

Full Changelog: v21.2.1...v21.2.2

21.2.0 (2026-06-30)

Features

• feat(resolve-extends): resolve pure-ESM presets (conventional-changelog v7/v9/v10) by @escapedcat in #4859

Chore

• ci: install git in stock-Ubuntu baseline job by @escapedcat in #4847

Full Changelog: v21.1.0...v21.2.0

21.1.0 (2026-06-23)

Bug Fixes

• fix: remove duplicate es-toolkit@1.47.1 keys from lockfile by @escapedcat in #4833

Features

• feat(cli): add --default-config flag to lint without a config file by @escapedcat in #4805
• feat(lint): allow for custom commit parser function by @esatterwhite in #4829

Docs, chore, etc.

• test(cli): verify --cwd redirects config resolution #997 by @escapedcat in #4796
• docs: add ai agent support (skill, guide, llms.txt) by @escapedcat in #4804
• docs: add TDD commit flow and review expectations for contributors by @escapedcat in #4836

New Contributors

• @esatterwhite made their first contribution in #4829

Full Changelog: v21.0.2...v21.1.0

21.0.2 (2026-05-29)

Bug Fixes

• fix: emit actionable error when --edit cannot find COMMIT_EDITMSG (#589) by @escapedcat in #4755
• fix: apply oxfmt formatting to get-edit-commit.ts by @escapedcat in #4768
• fix(read): fail when --from and --to share no merge-base #4555 by @CervEdin in #4754
• fix: disallow same commit hash for --from and --to by @knocte in #4773

Chore/CI

• ci: have renovate rebase stale PRs before merging by @escapedcat in #4782
• chore: have renovate hold PRs for 3 days after release by @escapedcat in #4788
• chore: anchor vite 8 by @escapedcat in #4790
• ci: run commitlint once per same-repo PR by @escapedcat in #4795

New Contributors

• @CervEdin made their first contribution in #4754

Full Changelog: v21.0.1...v21.0.2

21.0.1 (2026-05-12)

Bug Fixes

• fix(load): only resolve relative formatter paths by @escapedcat in #4761
• fix(types): add presetConfig to ParserPreset interface by @SAY-5 in #4749

CI

• ci: stop spawning schedule jobs on contributors' forks by @knocte in #4753
• ci: add weekly non-blocking pnpm audit by @escapedcat in #4766

New Contributors

• @SAY-5 made their first contribution in #4749

Full Changelog: v21.0.0...v21.0.1

Heads-up: --legacy-output is a transitional escape hatch. It will be removed in a future major release. Plan to migrate your parsers / snapshots to the new format during the v21 lifecycle.

21.0.0 (2026-05-08)

Breaking

• chore!: minimum node version v22 by @escapedcat in #4679
• feat!: show input from a new line by @knocte in #4727 (adds --legacy-output flag)

Fixes

• fix: widen cz-commitlint inquirer peer dep to support v9–v12 by @escapedcat in #4682 — closes #4554

Internals (Node 22 cleanup)

• chore: replace dependencies with Node 22 built-ins by @escapedcat in #4681 — drops glob, fast-glob, import-meta-resolve, minimist, fs-extra
• refactor: replace read-pkg with native fs.readFile + JSON.parse by @escapedcat in #4742
• chore: update dependency yargs to v18 by @escapedcat in #4686
• chore: remove cross-env, move env vars to vitest config by @escapedcat in #4684

Dependency updates

• chore: update dependency @types/node to v22.19.17 by @renovate[bot] in #4739
• chore: update dependency @swc/core to v1.15.33 by @renovate[bot] in #4743

Full Changelog: v20.5.3...v21.0.0

20.5.3 (2026-04-30)

Refactor

• refactor: replace all lodash.* dependencies with es-toolkit/compat by @debuggingfuture in #4734

Docs

• docs: use nodejs commands for creating files on Windows (#4728) by @festoney8 in #4730

New Contributors

• @festoney8 made their first contribution in #4730
• @debuggingfuture made their first contribution in #4734

Full Changelog: v20.5.2...v20.5.3

20.5.2 (2026-04-25)

Just minor dep updates before the next breaking change

Chore & Docs

• chore: remove codesandbox ci integration by @escapedcat in #4680
• docs: add Windows UTF-8 encoding note to getting started guide by @Chessing234 in #4699
• docs: improve parserPreset documentation with examples and options reference by @Chessing234 in #4700
• docs: fix subject-case rule default from 'always' to 'never' by @Chessing234 in #4703

New Contributors

• @Chessing234 made their first contribution in #4699

Full Changelog: v20.5.1...v20.5.2

Bug Fixes

• load: resolve async config exports in CJS projects (#4659) (fce263f), closes #4557
• resolve-extends: always resolve extended parser presets for proper merging (#4647) (e9ef76c), closes #4640

20.4.4 (2026-03-12)

Note: Version bump only for package @commitlint/load

20.4.3 (2026-03-03)

Bug Fixes

• footer parser does not escape special chars for regex #4560 (#4634) (8ff7c7f)
• npx usage #613 (#4630) (1644f1e), closes #3 #1 #2 #4 #5 #7 #6

Bug Fixes

• is-ignored: strip CI skip markers from release commits (#4637) (56a6fd0)
• read: update git-raw-commits to v5 API (#4638) (bd6ab41)
• types: allow context parameter in QualifiedRuleConfig functions (#4636) (17537ae), closes #4357

Bug Fixes

• footer parser does not escape special chars for regex #4560 (#4634) (8ff7c7f)
• npx usage #613 (#4630) (1644f1e), closes #3 #1 #2 #4 #5 #7 #6
• types: incorrect types for rule options (#4633) (77b85f2)

Features

• upgrade conventional commit packages #4082 (#4597) (3aaf0a6)

20.3.1 (2026-01-08)

Note: Version bump only for package @commitlint/load

Bug Fixes

• types: add scope-delimiter-style types (#4592) (23c1f6e)

20.3.0 (2026-01-01)

Features

• add support for .mts config file (#4581) (66e05ab)
• rules: add scope-delimiter-style (#4580) (fc4849a)

20.2.0 (2025-12-05)

Bug Fixes

• update dependency glob to v11 [security] (#4561) (a89a08b)

Features

• cz-commitlint: support customizable commit prompt with emojis (#4540) (803c05b)
• lint: update ESLint configuration to use Vitest and remove Jest plugin (#4542) (63e7ad4)
• rules: add breaking-change-exclamation-mark (#4548) (c4d419b), closes #4547

20.1.0 (2025-09-30)

Bug Fixes

• resolve-extends: add import attribute for JSON config files (#4551) (82936c9)

Features

• config-pnpm-scopes: allow global scope (#4553) (e571970)

20.0.0 (2025-09-25)

Bug Fixes

• update dependency tar-fs to v3.1.1 [security] (#4550) (273a43e)

• feat(rules)!: make body-max-line-length ignore lines with URLs (#4486) (2f37a88), closes #4486

BREAKING CHANGES

• when lines contain URLs exceeding the maximum line length body-max-line-length will be ignored

Features

• add support for .mts config file (#4581) (66e05ab)

Note: Version bump only for package @commitlint/load

Note: Version bump only for package @commitlint/load

Note: Version bump only for package @commitlint/load

19.8.1 (2025-05-08)

Note: Version bump only for package @commitlint/load

Bug Fixes

• update dependency tinyexec to v1 (#4332) (e49449f)
• update dependency tinyexec to v1.0.1 (#4347) (c1b26d1)

Performance Improvements

• rules: optimize header-trim (#4363) (b7e404b)

19.8.0 (2025-03-07)

Bug Fixes

• config-lerna-scopes: remove deprecated @lerna/project dependency (#4284) (f2f78f1)
• update dependency semver to v7.7.1 (#4272) (6148587)

Features

• config-workspace-scopes: add config preset for npm and yarn workspaces (#4269) (67ff9e8)

Performance Improvements

• use node: prefix to bypass require.cache call for builtins (#4302) (0cd8f41)

Reverts

• Revert "fix: improve security validation regex in is-ignored function (#4258)" (#4314) (b27024a), closes #4258 #4314

Performance Improvements

• use node: prefix to bypass require.cache call for builtins (#4302) (0cd8f41)

19.6.1 (2024-12-15)

Note: Version bump only for package @commitlint/load

Bug Fixes

• force bump for container usage (#4200) (21858df)

19.6.0 (2024-11-19)

Bug Fixes

• update dependency inquirer to v9.3.7 (#4167) (610a8f2)

Features

• is-ignored: ignore reapply commits (#4186) (49ba56d)
• support using delimiter in scope-enum (#4161) (f55521d)

19.5.0 (2024-09-11)

Features

• cli: use special errorCode for missing rules/config #4142 (#4143) (d7070d8)

Note: Version bump only for package @commitlint/load

Note: Version bump only for package @commitlint/load

Features

• load: update cosmiconfig to v9 to add support for package.yaml config (#3976) (94eab40)

Note: Version bump only for package @commitlint/load

19.0.3 (2024-02-28)

Note: Version bump only for package @commitlint/load

19.0.2 (2024-02-28)

Note: Version bump only for package @commitlint/load

19.0.1 (2024-02-27)

Bug Fixes

• drop resolve-from, resolve-global and import-fresh, resolve global packages correctly (#3939) (8793c63), closes #3938

Bug Fixes

• mark @types/conventional-commits-parser as dep for @commitlint/types (#3944) (5a01f59), closes #3929 #3942

Bug Fixes

• fallback to resolve-from for Yarn P'n'P (#3941) (1eb9b5f), closes #3936

Bug Fixes

• drop resolve-from, resolve-global and import-fresh, resolve global packages correctly (#3939) (8793c63), closes #3938

19.0.0 (2024-02-27)

• feat!: migrate to pure ESM (#3850) (3423735), closes #3850

Reverts

• Revert "chore: update tools version to v20" (53fc619)
• Revert "chore!: minimum node version v20" (2816783)
• Revert "ci: add codeQuality job to run lint and format tasks (#3922)" (8bb94ca), closes #3922
• Revert "ci: update node version to v20" (8a24546)

BREAKING CHANGES

• migrate to pure ESM

• feat: migrate to pure ESM

• chore: update snapshot

• fix: load parserPreset with another await

• test: migrate to vitest

• test: remove no replacement --runInBand test-ci script

• chore: fix code reviews

• refactor(load): rewrite resolve logic

• fix(config-nx-scopes): fix syntax error

• feat(resolve-extends): add resolveFrom and loadParserPreset

• feat(load): use resolveFrom and loadParserPreset from resolve-extends

• test: include only @commitlint/* packages src in coverage

• test: explicit import vitest utilities

• test: remove @jest/globals from dependencies

• fix(resolve-extends): resolveFrom output should be platform aware

• test: restore NO_COLOR to test script

• chore: fix linting issues

• fix: should use fileURLToPath instead of pathname for Windows compatibility

• Apply suggestions from code review

• fix: should reuse cli instead call yargs()

• feat(cli): set terminalWidth as wrap to avoid work break on help

• Update .eslintrc.cjs

• feat: migrate @commitlint/config-conventional to pure ESM

• feat!: migrate to pure ESM (#3850) (3423735), closes #3850

Reverts

• Revert "chore!: minimum node version v20" (2816783)

BREAKING CHANGES

• migrate to pure ESM

• feat: migrate to pure ESM

• chore: update snapshot

• fix: load parserPreset with another await

• test: migrate to vitest

• test: remove no replacement --runInBand test-ci script

• chore: fix code reviews

• refactor(load): rewrite resolve logic

• fix(config-nx-scopes): fix syntax error

• feat(resolve-extends): add resolveFrom and loadParserPreset

• feat(load): use resolveFrom and loadParserPreset from resolve-extends

• test: include only @commitlint/* packages src in coverage

• test: explicit import vitest utilities

• test: remove @jest/globals from dependencies

• fix(resolve-extends): resolveFrom output should be platform aware

• test: restore NO_COLOR to test script

• chore: fix linting issues

• fix: should use fileURLToPath instead of pathname for Windows compatibility

• Apply suggestions from code review

• fix: should reuse cli instead call yargs()

• feat(cli): set terminalWidth as wrap to avoid work break on help

• Update .eslintrc.cjs

• feat: migrate @commitlint/config-conventional to pure ESM

18.6.1 (2024-02-13)

Note: Version bump only for package @commitlint/load

Bug Fixes

• update dependency semver to v7.6.0 (#3900) (df33003)
• update dependency tar-fs to v3.0.5 (#3903) (79d77c9)

18.6.0 (2024-01-25)

Features

• rules: add header-trim rule (#3199) (#3871) (331579a)

Note: Version bump only for package @commitlint/load

Note: Version bump only for package @commitlint/load

18.4.4 (2024-01-04)

Bug Fixes

• @commitlint/load: Remove unused @types/node dependency (#3801) (7b3f8b3)

18.4.3 (2023-11-21)

Note: Version bump only for package @commitlint/load

18.4.2 (2023-11-16)

Note: Version bump only for package @commitlint/load

18.4.1 (2023-11-12)

Bug Fixes

• update cosmiconfig to specific version (#3755) (636b8b1)

Bug Fixes

• @commitlint/load: Remove unused @types/node dependency (#3801) (7b3f8b3)
• read: remove fs-extra usage and use fs/promises (#3803) (714be66)
• subject-full-stop false positive when using ellipsis (#3839) (b4246d6)
• update dependency fs-extra to v11.2.0 (#3799) (abb4da2)
• utils: remove fs-extra usage (#3804) (92f2237)

Bug Fixes

• update dependency read-pkg to v9.0.1 (#3777) (88c4b8a)

Bug Fixes

• update dependency @types/fs-extra to v11.0.4 (#3767) (f6c4696)
• update dependency @types/tmp to v0.2.6 (#3769) (bc849bc)

Bug Fixes

• update cosmiconfig to specific version (#3755) (636b8b1)

18.4.0 (2023-11-10)

Bug Fixes

• update dependency fast-glob to v3.3.2 (#3740) (b3bf1f2)
• update dependency read-pkg to v9 (#3734) (722f518)
• update dependency tar-fs to v3 (#3718) (afb04dd)

Features

• bump cosmiconfig version and conditionally support mjs config (#3747) (a2b65fc)

18.3.0 (2023-10-26)

Bug Fixes

• update dependency @types/node to v18.18.7 (#3726) (dcc0424)

Features

• config-nx-scopes: support latest nx version (#3728) (22e6f74)

18.2.0 (2023-10-26)

Features

• load: use cosmiconfig-typescript-loader v5 to remove ts-node dependency for @commitlint/load (#3722) (1ff49ea)

18.1.0 (2023-10-25)

Bug Fixes

• update dependency read-pkg to v8 (#3717) (326f497)

Features

• [scope-enum] [scope-case] allow space after comma as scope delimiter (#3577) (13c4bfc), closes #3576

18.0.0 (2023-10-20)

• chore!: minimum node version v18 (#3644) (5b4aeaf), closes #3644

BREAKING CHANGES

• drop node v14 and v16 support

• chore: remove unused types

• docs: prepare node update and new release

• chore!: minimum TS version v5

• drop TS v4 support

• ci: remove node v14/16 checks

• chore: adjust node types to minimal supported version

• chore!: further major versions of other deps

• upgrade conventional-changelog-conventionalcommits, conventional-commits-parser, conventional-changelog-atom,

• docs: simplify releases and remove roadmap

Features

• bump cosmiconfig version and conditionally support mjs config (#3747) (a2b65fc)

Features

• load: use cosmiconfig-typescript-loader v5 to remove ts-node dependency for @commitlint/load (#3722) (1ff49ea)

Note: Version bump only for package @commitlint/load

• chore!: minimum node version v18 (#3644) (5b4aeaf), closes #3644

BREAKING CHANGES

• drop node v14 and v16 support

• chore: remove unused types

• docs: prepare node update and new release

• chore!: minimum TS version v5

• drop TS v4 support

• ci: remove node v14/16 checks

• chore: adjust node types to minimal supported version

• chore!: further major versions of other deps

• upgrade conventional-changelog-conventionalcommits, conventional-commits-parser, conventional-changelog-atom,

• docs: simplify releases and remove roadmap

17.8.1 (2023-10-20)

Note: Version bump only for package @commitlint/load

Note: Version bump only for package @commitlint/root

17.8.0 (2023-10-14)

Bug Fixes

• chore(container): add pullrequest event to container build workflow trigger (8e30bec)
• update dependency @types/fs-extra to v11.0.2 (#3681) (5c6f087)
• update dependency @types/tmp to v0.2.4 (#3682) (f9d7029)
• update dependency cosmiconfig-typescript-loader to v4.4.0 (#3688) (4bcb0c6)

Features

• lazy load cosmiconfig-typescript-loader (#3694) (b058c7c)

Features

• lazy load cosmiconfig-typescript-loader (#3694) (b058c7c)

17.7.2 (2023-09-28)

Bug Fixes

• update dependency @types/node to v20.5.1 (#3653) (cd8b775)

17.7.1 (2023-08-10)

Reverts

• Revert "feat(load): use cosmiconfig-typescript-loader v5 to remove ts-node dependency for @commitlint/load (#3633)" (8e41897), closes #3633

Bug Fixes

• update dependency @types/node to v20.5.1 (#3653) (cd8b775)

Reverts

• Revert "feat(load): use cosmiconfig-typescript-loader v5 to remove ts-node dependency for @commitlint/load (#3633)" (8e41897), closes #3633

17.7.0 (2023-08-09)

Features

• load: use cosmiconfig-typescript-loader v5 to remove ts-node dependency for @commitlint/load (#3633) (4aa46d7)

Reverts

• eslint-config-prettier to v8 (f279ff7)
• prettier to v2 to not break lerna v6 publish (cd854cb)

Features

• load: use cosmiconfig-typescript-loader v5 to remove ts-node dependency for @commitlint/load (#3633) (4aa46d7)

17.6.7 (2023-07-19)

Note: Version bump only for package @commitlint/load

Note: Version bump only for package @commitlint/root

Features

• support typescript 5.0 (#3566) (c0a27ff)

17.4.4 (2023-02-17)

Note: Version bump only for package @commitlint/load

17.4.2 (2023-01-12)

Bug Fixes

• load: fixes a bug when a ts commitlint config is compiled twice (#3499) (dc2c899)

17.4.1 (2023-01-09)

Note: Version bump only for package @commitlint/load

Bug Fixes

• parse: allow setting fieldPattern in parserOpts (#3538) (ea23c65)

Bug Fixes

• load: fixes a bug when a ts commitlint config is compiled twice (#3499) (dc2c899)
• update dependency @types/fs-extra to v11 (#3494) (8f553c7)
• update dependency @types/fs-extra to v11.0.1 (#3496) (f9a013c)

Note: Version bump only for package @commitlint/root

17.4.0 (2023-01-04)

Bug Fixes

• stop truncating the body in presence of dashes (#3476) (02a61be)
• update dependency ajv to v8.11.2 (#3440) (7829151)
• update dependency ajv to v8.12.0 (#3482) (0a53d97)
• update dependency cosmiconfig to v8 (#3459) (ee732fe)
• update dependency cosmiconfig-typescript-loader to v4.3.0 (#3448) (86b632e)
• update dependency fs-extra to v11 (#3460) (a437923)
• update dependency semver to v7.3.8 (#3441) (7599ad6)
• update dependency typescript to v4.9.4 (#3449) (bf86c7d)
• update dependency yargs to v17.6.2 (#3450) (8a43a05)

Features

• support config .cts extension (#3461) (85ad18b)

17.3.0 (2022-11-21)

Features

• config-pnpm-scopes: implement config-pnpm-scopes (#3427) (ca3ae8b)

Bug Fixes

• update dependency cosmiconfig to v8 (#3459) (ee732fe)

Features

• support config .cts extension (#3461) (85ad18b)

Note: Version bump only for package @commitlint/load

Note: Version bump only for package @commitlint/load

17.1.2 (2022-08-29)

Bug Fixes

• load: add ts-node as direct dependency (#3351) (3b66891)
• update dependency cosmiconfig-typescript-loader to v4 (#3346) (5a9d80f)

17.1.1 (2022-08-27)

Bug Fixes

• load: peer-dep version #3345 (2dd7b50)

Bug Fixes

• load: add ts-node as direct dependency (#3351) (3b66891)
• update dependency cosmiconfig-typescript-loader to v4 (#3346) (5a9d80f)

Bug Fixes

• load: peer-dep version #3345 (2dd7b50)

17.1.0 (2022-08-27)

Bug Fixes

• update dependency cosmiconfig-typescript-loader to v3 (#3253) (4e87d14)
• update dependency cosmiconfig-typescript-loader to v3.1.1 (#3282) (550ab3d)
• update dependency cosmiconfig-typescript-loader to v3.1.2 (#3343) (4213e9c)

Features

• commitlint: add additional git log args (#3334) (229c65b)

Bug Fixes

• update dependency cosmiconfig-typescript-loader to v3 (#3253) (4e87d14)

17.0.3 (2022-06-25)

Note: Version bump only for package @commitlint/load

Bug Fixes

• update dependency cosmiconfig-typescript-loader to v2.0.2 (#3250) (dfe69b0)

• chore!: minimum node version v14 (#3128) (ac5f9b4), closes #3128

BREAKING CHANGES

• drop node v12 support

• chore: rename circleci windows job

node version is not defned by the name anyways (i think)

Bug Fixes

• update dependency cosmiconfig-typescript-loader to v2 (#3154) (20122e8)

16.2.4 (2022-04-28)

Note: Version bump only for package @commitlint/load

16.2.3 (2022-03-16)

Note: Version bump only for package @commitlint/load

16.2.1 (2022-02-13)

Bug Fixes

• load: satisfy @types/node peer dependency for cosmiconfig-loader-typescript (#3008) (338180c), closes #3007

Bug Fixes

• rules: footer-leading-blank should work with body comments (#3139) (7dd88c9)
• update dependency cosmiconfig to v7.0.1 (#3138) (407837d)
• update dependency cosmiconfig-typescript-loader to v1.0.7 (#3102) (d0f2b3f)
• update dependency cosmiconfig-typescript-loader to v1.0.9 (#3106) (d91e70d)
• update dependency fs-extra to v10.1.0 (#3124) (482613f)
• update dependency semver to v7.3.6 (#3112) (ad886fd)
• update dependency semver to v7.3.7 (#3119) (c9c49b2)
• update dependency yargs to v17.4.0 (#3080) (1477d7c)
• update dependency yargs to v17.4.1 (#3116) (69bf135)