fix: docker image throws error for TypeScript config files

[danieldecsi]

Steps to Reproduce

1. Create this config file:
`.commitlintrc.ts`

import { RuleConfigSeverity } from '@commitlint/types';
import type { UserConfig } from '@commitlint/types';

export default {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'header-max-length': [RuleConfigSeverity.Error, 'always', 100],
  },
} satisfies UserConfig;


2. Run commitlint with the provided pre-built Docker image from Docker Hub:
`docker run --rm -it -v $(pwd):/app -w /app commitlint/commitlint:20.4.1 --last`

Current Behavior

Throws this error:

Error: Cannot find module '@commitlint/types'
Require stack:
- /app/.commitlintrc.ts
    at Module._resolveFilename (node:internal/modules/cjs/loader:1140:15)
    at Function.resolve (node:internal/modules/helpers:188:19)
    at jitiResolve (/usr/local/lib/node_modules/@commitlint/load/node_modules/jiti/dist/jiti.cjs:1:187220)
    at jitiRequire (/usr/local/lib/node_modules/@commitlint/load/node_modules/jiti/dist/jiti.cjs:1:189288)
    at import (/usr/local/lib/node_modules/@commitlint/load/node_modules/jiti/dist/jiti.cjs:1:199778)
    at /app/.commitlintrc.ts:1:216
    at eval_evalModule (/usr/local/lib/node_modules/@commitlint/load/node_modules/jiti/dist/jiti.cjs:1:196325)
    at jitiRequire (/usr/local/lib/node_modules/@commitlint/load/node_modules/jiti/dist/jiti.cjs:1:190233)
    at Function.import (/usr/local/lib/node_modules/@commitlint/load/node_modules/jiti/dist/jiti.cjs:1:199778)
    at file:///usr/local/lib/node_modules/@commitlint/load/node_modules/cosmiconfig-typescript-loader/dist/esm/loader.mjs:8:41
    at tsLoader (file:///usr/local/lib/node_modules/@commitlint/load/lib/utils/load-config.js:13:16)
    at #loadConfiguration (/usr/local/lib/node_modules/@commitlint/load/node_modules/cosmiconfig/dist/Explorer.js:116:42)
    at #loadConfigFileWithImports (/usr/local/lib/node_modules/@commitlint/load/node_modules/cosmiconfig/dist/Explorer.js:87:60)
    at #readConfiguration (/usr/local/lib/node_modules/@commitlint/load/node_modules/cosmiconfig/dist/Explorer.js:84:88)
    at async search (/usr/local/lib/node_modules/@commitlint/load/node_modules/cosmiconfig/dist/Explorer.js:50:40)
    at async Explorer.search (/usr/local/lib/node_modules/@commitlint/load/node_modules/cosmiconfig/dist/Explorer.js:78:20)
    at async loadConfig (file:///usr/local/lib/node_modules/@commitlint/load/lib/utils/load-config.js:53:19)
    at async load (file:///usr/local/lib/node_modules/@commitlint/load/lib/load.js:24:20)
    at async main (file:///usr/local/lib/node_modules/@commitlint/cli/lib/cli.js:200:20) {
  name: '_TypeScriptCompileError',
  filepath: '/app/.commitlintrc.ts'

Expected Behavior

Should work without errors.

Affected packages

• cli
• core
• prompt
• config-angular

Possible Solution

What I managed to figure out is that underlaying compiler that deals with TypeScript can't import @commitlint/types because it is installed globally. If it is installed locally it works well (we use commitlint also as a husky commit-msg hook and it works there without issues).

Context

No response

commitlint --version

20.4.0

git --version

2.39.2

node --version

18.x

[knocte]

commitlint --version
20.4.0

But your steps to reproduce mention 20.4.1? so which version is it?

And btw, was this working before? is it a recent regression?

[danieldecsi]

Sorry for the confusion. I'm actually building my own docker image with a really similar approach to yours, which fails with the same error, and I copy pasted one of the version from there and the other one from the command while I tried to run your image.

I tried to look into if it's a recent regression, and I'm pretty sure it's not. We upgraded our commitlint version from 11.0.0 to 20.4.1 when this popped up. Now I checked what was the last version where it worked and it's 12.1.4. I think commitlint didn't even pick up our .commitlintrc.ts before that.

These are the exact steps I'm doing:

1. Create an image from this Dockerfile:

FROM node:24.13.0-alpine

RUN apk add --no-cache git
RUN npm install -g @commitlint/cli@13.2.0 @commitlint/config-conventional@13.2.0

2. Then running it like this:

docker run --rm \
  -v "$(pwd):/workspace" \
  -w /workspace \
  commitlint \
  sh -c "npx commitlint --version && npx commitlint  --from HEAD~1 --to HEAD"

I'm not even sure if it's possible to resolve this with the current setup. @commitlint/types can't be installed globally. Maybe it would useful to add a comment about this in your documentation. We were thinking about just inlining RuleConfigSeverity.Error's value, so we don't need the package at all.

[knocte]

RUN npm install -g @commitlint/cli@13.2.0 @commitlint/config-conventional@13.2.0

Why are you installing @commitlint/cli explicitly? In my case, the way I consume commitlint is just installing @commitlint/config-conventional , which I guess must pull the cli package as a dep?

@commitlint/types can't be installed globally

Why?

BTW, note that your npm install line has a -g, so maybe if you remove the -g there it will work? It works for me at least.

Although I must say that in my case I'm not using docker (and I'm no npm expert so the differences about -g or no -g are a bit over my pay grade).