Я бы оставил tsconfig.json
как json и добавил бы необходимые комментарии, например, в README.md.
Другой вариант - добавить комментарии в json, например:
// tsconfig.json
{
"//comment": "comment content",
"compilerOptions": {
...
},
}
Если вам нужна большая гибкость, вы можете добавить шаг сборки для генерации tsconfig.json
из файла. js.
// tsconfig.js
// comments or code here
module.exports = {
"compilerOptions": {
"module": "commonjs",
},
};
// tsconfigBuilder.js
const fs = require('fs');
const config = require('./tsconfig');
fs.writeFileSync('./tsconfig.json', JSON.stringify(config, null, 2));
Добавить скрипт в package.json
для генерации tsconfig.json
от tsconfig.js
до шага компилятора.
// package.json
"scripts": {
"build-tsconfig": "node tsconfigBuilder.js",
...
},
И все готово.