@aral `// @ts-check` is really welcome and needed for files like eslint config or prettier config where you do not have other options like TS
So for example in #faker we use it like this https://github.com/faker-js/faker/blob/ede6ffac383a853c12b7a47cebbb031ba80627aa/.eslintrc.js#LL1C1-L1C1 together with https://github.com/Shinigami92/eslint-define-config