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.

Bắt đầu với khai báo công khai CompilerOptions được liên kết trong lib/typescript.d.ts và entry point convertCompilerOptionsFromJson trong src/compiler/commandLineParser.ts. Định nghĩa interface tùy chọn có dạng JSON và expose nó công khai, sau đó đảm bảo hàm chuyển đổi chấp nhận nó mà vẫn giữ nguyên hành vi kiểm tra kiểu được yêu cầu.