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.

Comienza con la declaración pública de CompilerOptions enlazada en lib/typescript.d.ts y el punto de entrada convertCompilerOptionsFromJson en src/compiler/commandLineParser.ts. Define la interfaz de opciones con forma de JSON y expónla públicamente; después, asegúrate de que la función de conversión la acepte y conserve el comportamiento solicitado de comprobación de tipos.