Export an interface for JSON `CompilerOptions`

Search Terms

• CompilerOptions
• convertCompilerOptionsFromJson

Suggestion

Currently TypeScript exports the CompilerOptions interface, which represents the compiler options that can be passed in. However, since this interface uses enums, it doesn't match with the format of compilerOptions in the tsconfig.json file. I'd like to be able to use a JsonCompilerOptions (or some better name) interface to strictly type options in libraries that wrap TypeScript without rewriting the interface.

Use Cases

• Libraries that wrap TypeScript like rollup-plugin-typescript can strictly type overrides for values in tsconfig without either requiring the user to import TypeScript enums or rewriting the interface.
• The convertCompilerOptionsFromJson function takes in any currently, and could instead use this hypothetical interface.

Examples

TypeScript wrapping libraries can let consumers override tsconfig options

import { Plugin } from 'rollup';
import { JsonCompilerOptions } from 'typescript';

interface Options extends JsonCompilerOptions {
    customOptions?: string;
}

export default function rollupPluginTypescript(options?: Options): Plugin;

Strict typing for convertCompilerOptionsFromJson

import { convertCompilerOptionsFromJson } from 'typescript';

// Type error
const opts = convertCompilerOptionsFromJson({ allowJs: 'true' }, process.cwd());

Checklist

My suggestion meets these guidelines:

• This wouldn't be a breaking change in existing TypeScript/JavaScript code
• This wouldn't change the runtime behavior of existing JavaScript code
• This could be implemented without emitting different JS based on the types of the expressions
• This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, etc.)
• This feature would agree with the rest of TypeScript's Design Goals.

lib/typescript.d.ts にリンクされている公開 CompilerOptions 宣言と、src/compiler/commandLineParser.ts のエントリポイント convertCompilerOptionsFromJson から始めます。JSON 形式のオプションインターフェイスを定義して公開し、その後、変換関数がそれを受け入れ、要求された型チェックの動作を維持することを確認します。