namespace ts {

/* @internal */

export const compileOnSaveCommandLineOption: CommandLineOption = { name: "compileOnSave", type: "boolean" };

// NOTE: The order here is important to default lib ordering as entries will have the same

// order in the generated program (see `getDefaultLibPriority` in program.ts). This

// order also affects overload resolution when a type declared in one lib is

// augmented in another lib.

const libEntries: [string, string][] = [

// JavaScript only

["es5", "lib.es5.d.ts"],

["es6", "lib.es2015.d.ts"],

["es2015", "lib.es2015.d.ts"],

["es7", "lib.es2016.d.ts"],

["es2016", "lib.es2016.d.ts"],

["es2017", "lib.es2017.d.ts"],

["es2018", "lib.es2018.d.ts"],

["esnext", "lib.esnext.d.ts"],

// Host only

["dom", "lib.dom.d.ts"],

["dom.iterable", "lib.dom.iterable.d.ts"],

["webworker", "lib.webworker.d.ts"],

["webworker.importscripts", "lib.webworker.importscripts.d.ts"],

["scripthost", "lib.scripthost.d.ts"],

// ES2015 Or ESNext By-feature options

["es2015.core", "lib.es2015.core.d.ts"],

["es2015.collection", "lib.es2015.collection.d.ts"],

["es2015.generator", "lib.es2015.generator.d.ts"],

["es2015.iterable", "lib.es2015.iterable.d.ts"],

["es2015.promise", "lib.es2015.promise.d.ts"],

["es2015.proxy", "lib.es2015.proxy.d.ts"],

["es2015.reflect", "lib.es2015.reflect.d.ts"],

["es2015.symbol", "lib.es2015.symbol.d.ts"],

["es2015.symbol.wellknown", "lib.es2015.symbol.wellknown.d.ts"],

["es2016.array.include", "lib.es2016.array.include.d.ts"],

["es2017.object", "lib.es2017.object.d.ts"],

["es2017.sharedmemory", "lib.es2017.sharedmemory.d.ts"],

["es2017.string", "lib.es2017.string.d.ts"],

["es2017.intl", "lib.es2017.intl.d.ts"],

["es2017.typedarrays", "lib.es2017.typedarrays.d.ts"],

["es2018.intl", "lib.es2018.intl.d.ts"],

["es2018.promise", "lib.es2018.promise.d.ts"],

["es2018.regexp", "lib.es2018.regexp.d.ts"],

["esnext.array", "lib.esnext.array.d.ts"],

["esnext.symbol", "lib.esnext.symbol.d.ts"],

["esnext.asynciterable", "lib.esnext.asynciterable.d.ts"],

["esnext.intl", "lib.esnext.intl.d.ts"]

];

/**

* An array of supported "lib" reference file names used to determine the order for inclusion

* when referenced, as well as for spelling suggestions. This ensures the correct ordering for

* overload resolution when a type declared in one lib is extended by another.

*/

/* @internal */

export const libs = libEntries.map(entry => entry[0]);

/**

* A map of lib names to lib files. This map is used both for parsing the "lib" command line

* option as well as for resolving lib reference directives.

*/

/* @internal */

export const libMap = createMapFromEntries(libEntries);

/* @internal */

export const commonOptionsWithBuild: CommandLineOption[] = [

{

name: "help",

shortName: "h",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Print_this_message,

},

{

name: "help",

shortName: "?",

type: "boolean"

},

{

name: "watch",

shortName: "w",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Watch_input_files,

},

{

name: "preserveWatchOutput",

type: "boolean",

showInSimplifiedHelpView: false,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Whether_to_keep_outdated_console_output_in_watch_mode_instead_of_clearing_the_screen,

},

{

name: "listFiles",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Print_names_of_files_part_of_the_compilation

},

{

name: "listEmittedFiles",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Print_names_of_generated_files_part_of_the_compilation

},

{

name: "traceResolution",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Enable_tracing_of_the_name_resolution_process

},

];

/* @internal */

export const optionDeclarations: CommandLineOption[] = [

// CommandLine only options

...commonOptionsWithBuild,

{

name: "all",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Show_all_compiler_options,

},

{

name: "version",

shortName: "v",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Print_the_compiler_s_version,

},

{

name: "init",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Initializes_a_TypeScript_project_and_creates_a_tsconfig_json_file,

},

{

name: "project",

shortName: "p",

type: "string",

isFilePath: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

paramType: Diagnostics.FILE_OR_DIRECTORY,

description: Diagnostics.Compile_the_project_given_the_path_to_its_configuration_file_or_to_a_folder_with_a_tsconfig_json,

},

{

name: "build",

type: "boolean",

shortName: "b",

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Build_one_or_more_projects_and_their_dependencies_if_out_of_date

},

{

name: "pretty",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Command_line_Options,

description: Diagnostics.Stylize_errors_and_messages_using_color_and_context_experimental

},

// Basic

{

name: "target",

shortName: "t",

type: createMapFromTemplate({

es3: ScriptTarget.ES3,

es5: ScriptTarget.ES5,

es6: ScriptTarget.ES2015,

es2015: ScriptTarget.ES2015,

es2016: ScriptTarget.ES2016,

es2017: ScriptTarget.ES2017,

es2018: ScriptTarget.ES2018,

esnext: ScriptTarget.ESNext,

}),

affectsSourceFile: true,

affectsModuleResolution: true,

paramType: Diagnostics.VERSION,

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Specify_ECMAScript_target_version_Colon_ES3_default_ES5_ES2015_ES2016_ES2017_ES2018_or_ESNEXT,

},

{

name: "module",

shortName: "m",

type: createMapFromTemplate({

none: ModuleKind.None,

commonjs: ModuleKind.CommonJS,

amd: ModuleKind.AMD,

system: ModuleKind.System,

umd: ModuleKind.UMD,

es6: ModuleKind.ES2015,

es2015: ModuleKind.ES2015,

esnext: ModuleKind.ESNext

}),

affectsModuleResolution: true,

paramType: Diagnostics.KIND,

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Specify_module_code_generation_Colon_none_commonjs_amd_system_umd_es2015_or_ESNext,

},

{

name: "lib",

type: "list",

element: {

name: "lib",

type: libMap

},

affectsModuleResolution: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Specify_library_files_to_be_included_in_the_compilation

},

{

name: "allowJs",

type: "boolean",

affectsModuleResolution: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Allow_javascript_files_to_be_compiled

},

{

name: "checkJs",

type: "boolean",

category: Diagnostics.Basic_Options,

description: Diagnostics.Report_errors_in_js_files

},

{

name: "jsx",

type: createMapFromTemplate({

"preserve": JsxEmit.Preserve,

"react-native": JsxEmit.ReactNative,

"react": JsxEmit.React

}),

affectsSourceFile: true,

paramType: Diagnostics.KIND,

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Specify_JSX_code_generation_Colon_preserve_react_native_or_react,

},

{

name: "declaration",

shortName: "d",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Generates_corresponding_d_ts_file,

},

{

name: "declarationMap",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Generates_a_sourcemap_for_each_corresponding_d_ts_file,

},

{

name: "emitDeclarationOnly",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Only_emit_d_ts_declaration_files,

},

{

name: "sourceMap",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Generates_corresponding_map_file,

},

{

name: "outFile",

type: "string",

isFilePath: true,

paramType: Diagnostics.FILE,

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Concatenate_and_emit_output_to_single_file,

},

{

name: "outDir",

type: "string",

isFilePath: true,

paramType: Diagnostics.DIRECTORY,

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Redirect_output_structure_to_the_directory,

},

{

name: "rootDir",

type: "string",

isFilePath: true,

paramType: Diagnostics.LOCATION,

category: Diagnostics.Basic_Options,

description: Diagnostics.Specify_the_root_directory_of_input_files_Use_to_control_the_output_directory_structure_with_outDir,

},

{

name: "composite",

type: "boolean",

isTSConfigOnly: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Enable_project_compilation,

},

{

name: "removeComments",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Do_not_emit_comments_to_output,

},

{

name: "noEmit",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Basic_Options,

description: Diagnostics.Do_not_emit_outputs,

},

{

name: "importHelpers",

type: "boolean",

category: Diagnostics.Basic_Options,

description: Diagnostics.Import_emit_helpers_from_tslib

},

{

name: "downlevelIteration",

type: "boolean",

category: Diagnostics.Basic_Options,

description: Diagnostics.Provide_full_support_for_iterables_in_for_of_spread_and_destructuring_when_targeting_ES5_or_ES3

},

{

name: "isolatedModules",

type: "boolean",

category: Diagnostics.Basic_Options,

description: Diagnostics.Transpile_each_file_as_a_separate_module_similar_to_ts_transpileModule

},

// Strict Type Checks

{

name: "strict",

type: "boolean",

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Enable_all_strict_type_checking_options

},

{

name: "noImplicitAny",

type: "boolean",

affectsSemanticDiagnostics: true,

strictFlag: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Raise_error_on_expressions_and_declarations_with_an_implied_any_type

},

{

name: "strictNullChecks",

type: "boolean",

affectsSemanticDiagnostics: true,

strictFlag: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Enable_strict_null_checks

},

{

name: "strictFunctionTypes",

type: "boolean",

affectsSemanticDiagnostics: true,

strictFlag: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Enable_strict_checking_of_function_types

},

{

name: "strictBindCallApply",

type: "boolean",

strictFlag: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Enable_strict_bind_call_and_apply_methods_on_functions

},

{

name: "strictPropertyInitialization",

type: "boolean",

affectsSemanticDiagnostics: true,

strictFlag: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Enable_strict_checking_of_property_initialization_in_classes

},

{

name: "noImplicitThis",

type: "boolean",

affectsSemanticDiagnostics: true,

strictFlag: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Raise_error_on_this_expressions_with_an_implied_any_type,

},

{

name: "alwaysStrict",

type: "boolean",

affectsSourceFile: true,

strictFlag: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Strict_Type_Checking_Options,

description: Diagnostics.Parse_in_strict_mode_and_emit_use_strict_for_each_source_file

},

// Additional Checks

{

name: "noUnusedLocals",

type: "boolean",

affectsSemanticDiagnostics: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Additional_Checks,

description: Diagnostics.Report_errors_on_unused_locals,

},

{

name: "noUnusedParameters",

type: "boolean",

affectsSemanticDiagnostics: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Additional_Checks,

description: Diagnostics.Report_errors_on_unused_parameters,

},

{

name: "noImplicitReturns",

type: "boolean",

affectsSemanticDiagnostics: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Additional_Checks,

description: Diagnostics.Report_error_when_not_all_code_paths_in_function_return_a_value

},

{

name: "noFallthroughCasesInSwitch",

type: "boolean",

affectsBindDiagnostics: true,

affectsSemanticDiagnostics: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Additional_Checks,

description: Diagnostics.Report_errors_for_fallthrough_cases_in_switch_statement

},

// Module Resolution

{

name: "moduleResolution",

type: createMapFromTemplate({

node: ModuleResolutionKind.NodeJs,

classic: ModuleResolutionKind.Classic,

}),

affectsModuleResolution: true,

paramType: Diagnostics.STRATEGY,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.Specify_module_resolution_strategy_Colon_node_Node_js_or_classic_TypeScript_pre_1_6,

},

{

name: "baseUrl",

type: "string",

affectsModuleResolution: true,

isFilePath: true,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.Base_directory_to_resolve_non_absolute_module_names

},

{

// this option can only be specified in tsconfig.json

// use type = object to copy the value as-is

name: "paths",

type: "object",

affectsModuleResolution: true,

isTSConfigOnly: true,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.A_series_of_entries_which_re_map_imports_to_lookup_locations_relative_to_the_baseUrl

},

{

// this option can only be specified in tsconfig.json

// use type = object to copy the value as-is

name: "rootDirs",

type: "list",

isTSConfigOnly: true,

element: {

name: "rootDirs",

type: "string",

isFilePath: true

},

affectsModuleResolution: true,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.List_of_root_folders_whose_combined_content_represents_the_structure_of_the_project_at_runtime

},

{

name: "typeRoots",

type: "list",

element: {

name: "typeRoots",

type: "string",

isFilePath: true

},

affectsModuleResolution: true,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.List_of_folders_to_include_type_definitions_from

},

{

name: "types",

type: "list",

element: {

name: "types",

type: "string"

},

affectsModuleResolution: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.Type_declaration_files_to_be_included_in_compilation

},

{

name: "allowSyntheticDefaultImports",

type: "boolean",

affectsSemanticDiagnostics: true,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.Allow_default_imports_from_modules_with_no_default_export_This_does_not_affect_code_emit_just_typechecking

},

{

name: "esModuleInterop",

type: "boolean",

affectsSemanticDiagnostics: true,

showInSimplifiedHelpView: true,

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.Enables_emit_interoperability_between_CommonJS_and_ES_Modules_via_creation_of_namespace_objects_for_all_imports_Implies_allowSyntheticDefaultImports

},

{

name: "preserveSymlinks",

type: "boolean",

category: Diagnostics.Module_Resolution_Options,

description: Diagnostics.Do_not_resolve_the_real_path_of_symlinks,

},

// Source Maps

{

name: "sourceRoot",

type: "string",

paramType: Diagnostics.LOCATION,

category: Diagnostics.Source_Map_Options,

description: Diagnostics.Specify_the_location_where_debugger_should_locate_TypeScript_files_instead_of_source_locations,

},

{

name: "mapRoot",

type: "string",

paramType: Diagnostics.LOCATION,

category: Diagnostics.Source_Map_Options,

description: Diagnostics.Specify_the_location_where_debugger_should_locate_map_files_instead_of_generated_locations,

},

{

name: "inlineSourceMap",

type: "boolean",

category: Diagnostics.Source_Map_Options,

description: Diagnostics.Emit_a_single_file_with_source_maps_instead_of_having_a_separate_file

},

{

name: "inlineSources",

type: "boolean",

category: Diagnostics.Source_Map_Options,

description: Diagnostics.Emit_the_source_alongside_the_sourcemaps_within_a_single_file_requires_inlineSourceMap_or_sourceMap_to_be_set

},

// Experimental

{

name: "experimentalDecorators",

type: "boolean",

category: Diagnostics.Experimental_Options,

description: Diagnostics.Enables_experimental_support_for_ES7_decorators

},

{

name: "emitDecoratorMetadata",

type: "boolean",

category: Diagnostics.Experimental_Options,

description: Diagnostics.Enables_experimental_support_for_emitting_type_metadata_for_decorators

},

// Advanced

{

name: "jsxFactory",

type: "string",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Specify_the_JSX_factory_function_to_use_when_targeting_react_JSX_emit_e_g_React_createElement_or_h

},

{

name: "diagnostics",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Show_diagnostic_information

},

{

name: "extendedDiagnostics",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Show_verbose_diagnostic_information

},

{

name: "resolveJsonModule",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Include_modules_imported_with_json_extension

},

{

name: "out",

type: "string",

isFilePath: false, // This is intentionally broken to support compatability with existing tsconfig files

// for correct behaviour, please use outFile

category: Diagnostics.Advanced_Options,

paramType: Diagnostics.FILE,

description: Diagnostics.Deprecated_Use_outFile_instead_Concatenate_and_emit_output_to_single_file,

},

{

name: "reactNamespace",

type: "string",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Deprecated_Use_jsxFactory_instead_Specify_the_object_invoked_for_createElement_when_targeting_react_JSX_emit

},

{

name: "skipDefaultLibCheck",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Deprecated_Use_skipLibCheck_instead_Skip_type_checking_of_default_library_declaration_files

},

{

name: "charset",

type: "string",

category: Diagnostics.Advanced_Options,

description: Diagnostics.The_character_set_of_the_input_files

},

{

name: "emitBOM",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Emit_a_UTF_8_Byte_Order_Mark_BOM_in_the_beginning_of_output_files

},

{

name: "locale",

type: "string",

category: Diagnostics.Advanced_Options,

description: Diagnostics.The_locale_used_when_displaying_messages_to_the_user_e_g_en_us

},

{

name: "newLine",

type: createMapFromTemplate({

crlf: NewLineKind.CarriageReturnLineFeed,

lf: NewLineKind.LineFeed

}),

paramType: Diagnostics.NEWLINE,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Specify_the_end_of_line_sequence_to_be_used_when_emitting_files_Colon_CRLF_dos_or_LF_unix,

},

{

name: "noErrorTruncation",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_truncate_error_messages

},

{

name: "noLib",

type: "boolean",

affectsModuleResolution: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_include_the_default_library_file_lib_d_ts

},

{

name: "noResolve",

type: "boolean",

affectsModuleResolution: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_add_triple_slash_references_or_imported_modules_to_the_list_of_compiled_files

},

{

name: "stripInternal",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_emit_declarations_for_code_that_has_an_internal_annotation,

},

{

name: "disableSizeLimit",

type: "boolean",

affectsSourceFile: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Disable_size_limitations_on_JavaScript_projects

},

{

name: "noImplicitUseStrict",

type: "boolean",

affectsSemanticDiagnostics: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_emit_use_strict_directives_in_module_output

},

{

name: "noEmitHelpers",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_generate_custom_helper_functions_like_extends_in_compiled_output

},

{

name: "noEmitOnError",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_emit_outputs_if_any_errors_were_reported,

},

{

name: "preserveConstEnums",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_erase_const_enum_declarations_in_generated_code

},

{

name: "declarationDir",

type: "string",

isFilePath: true,

paramType: Diagnostics.DIRECTORY,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Output_directory_for_generated_declaration_files

},

{

name: "skipLibCheck",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Skip_type_checking_of_declaration_files,

},

{

name: "allowUnusedLabels",

type: "boolean",

affectsBindDiagnostics: true,

affectsSemanticDiagnostics: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_report_errors_on_unused_labels

},

{

name: "allowUnreachableCode",

type: "boolean",

affectsBindDiagnostics: true,

affectsSemanticDiagnostics: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Do_not_report_errors_on_unreachable_code

},

{

name: "suppressExcessPropertyErrors",

type: "boolean",

affectsSemanticDiagnostics: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Suppress_excess_property_checks_for_object_literals,

},

{

name: "suppressImplicitAnyIndexErrors",

type: "boolean",

affectsSemanticDiagnostics: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Suppress_noImplicitAny_errors_for_indexing_objects_lacking_index_signatures,

},

{

name: "forceConsistentCasingInFileNames",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Disallow_inconsistently_cased_references_to_the_same_file

},

{

name: "maxNodeModuleJsDepth",

type: "number",

// TODO: GH#27108 affectsModuleResolution: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.The_maximum_dependency_depth_to_search_under_node_modules_and_load_JavaScript_files

},

{

name: "noStrictGenericChecks",

type: "boolean",

affectsSemanticDiagnostics: true,

category: Diagnostics.Advanced_Options,

description: Diagnostics.Disable_strict_checking_of_generic_signatures_in_function_types,

},

{

name: "keyofStringsOnly",

type: "boolean",

category: Diagnostics.Advanced_Options,

description: Diagnostics.Resolve_keyof_to_string_valued_property_names_only_no_numbers_or_symbols,

},

{

// A list of plugins to load in the language service

name: "plugins",

type: "list",

isTSConfigOnly: true,

element: {

name: "plugin",

type: "object"

},

description: Diagnostics.List_of_language_service_plugins

}

];

/* @internal */

export const semanticDiagnosticsOptionDeclarations: ReadonlyArray<CommandLineOption> =

optionDeclarations.filter(option => !!option.affectsSemanticDiagnostics);

/* @internal */

export const moduleResolutionOptionDeclarations: ReadonlyArray<CommandLineOption> =

optionDeclarations.filter(option => !!option.affectsModuleResolution);

/* @internal */

export const sourceFileAffectingCompilerOptions: ReadonlyArray<CommandLineOption> = optionDeclarations.filter(option =>

!!option.affectsSourceFile || !!option.affectsModuleResolution || !!option.affectsBindDiagnostics);

/* @internal */

export const buildOpts: CommandLineOption[] = [

...commonOptionsWithBuild,

{

name: "verbose",

shortName: "v",

category: Diagnostics.Command_line_Options,

description: Diagnostics.Enable_verbose_logging,

type: "boolean"

},

{

name: "dry",

shortName: "d",

category: Diagnostics.Command_line_Options,

description: Diagnostics.Show_what_would_be_built_or_deleted_if_specified_with_clean,

type: "boolean"

},

{

name: "force",

shortName: "f",

category: Diagnostics.Command_line_Options,

description: Diagnostics.Build_all_projects_including_those_that_appear_to_be_up_to_date,

type: "boolean"

},

{

name: "clean",

category: Diagnostics.Command_line_Options,

description: Diagnostics.Delete_the_outputs_of_all_projects,

type: "boolean"

}

];

/* @internal */

export const typeAcquisitionDeclarations: CommandLineOption[] = [

{

/* @deprecated typingOptions.enableAutoDiscovery

* Use typeAcquisition.enable instead.

*/

name: "enableAutoDiscovery",

type: "boolean",

},

{

name: "enable",

type: "boolean",

},

{

name: "include",

type: "list",

element: {

name: "include",

type: "string"

}

},

{

name: "exclude",

type: "list",

element: {

name: "exclude",

type: "string"

}

}

];

/* @internal */

export interface OptionNameMap {

optionNameMap: Map<CommandLineOption>;

shortOptionNames: Map<string>;

}

/* @internal */

export const defaultInitCompilerOptions: CompilerOptions = {

module: ModuleKind.CommonJS,

target: ScriptTarget.ES5,

strict: true,

esModuleInterop: true

};

let optionNameMapCache: OptionNameMap;

/* @internal */

export function convertEnableAutoDiscoveryToEnable(typeAcquisition: TypeAcquisition): TypeAcquisition {

// Convert deprecated typingOptions.enableAutoDiscovery to typeAcquisition.enable

if (typeAcquisition && typeAcquisition.enableAutoDiscovery !== undefined && typeAcquisition.enable === undefined) {

return {

enable: typeAcquisition.enableAutoDiscovery,

include: typeAcquisition.include || [],

exclude: typeAcquisition.exclude || []

};

}

return typeAcquisition;

}

function getOptionNameMap(): OptionNameMap {

return optionNameMapCache || (optionNameMapCache = createOptionNameMap(optionDeclarations));

}

/*@internal*/

export function createOptionNameMap(optionDeclarations: ReadonlyArray<CommandLineOption>): OptionNameMap {

const optionNameMap = createMap<CommandLineOption>();

const shortOptionNames = createMap<string>();

forEach(optionDeclarations, option => {

optionNameMap.set(option.name.toLowerCase(), option);

if (option.shortName) {

shortOptionNames.set(option.shortName, option.name);

}

});

return { optionNameMap, shortOptionNames };

}

/* @internal */

export function createCompilerDiagnosticForInvalidCustomType(opt: CommandLineOptionOfCustomType): Diagnostic {

return createDiagnosticForInvalidCustomType(opt, createCompilerDiagnostic);

}

function createDiagnosticForInvalidCustomType(opt: CommandLineOptionOfCustomType, createDiagnostic: (message: DiagnosticMessage, arg0: string, arg1: string) => Diagnostic): Diagnostic {

const namesOfType = arrayFrom(opt.type.keys()).map(key => `'${key}'`).join(", ");

return createDiagnostic(Diagnostics.Argument_for_0_option_must_be_Colon_1, `--${opt.name}`, namesOfType);

}

/* @internal */

export function parseCustomTypeOption(opt: CommandLineOptionOfCustomType, value: string, errors: Push<Diagnostic>) {

return convertJsonOptionOfCustomType(opt, trimString(value || ""), errors);

}

/* @internal */

export function parseListTypeOption(opt: CommandLineOptionOfListType, value = "", errors: Push<Diagnostic>): (string | number)[] | undefined {

value = trimString(value);

if (startsWith(value, "-")) {

return undefined;

}

if (value === "") {

return [];

}

const values = value.split(",");

switch (opt.element.type) {

case "number":

return map(values, parseInt);

case "string":

return map(values, v => v || "");

default:

return mapDefined(values, v => parseCustomTypeOption(<CommandLineOptionOfCustomType>opt.element, v, errors));

}

}

/* @internal */

export interface OptionsBase {

[option: string]: CompilerOptionsValue | undefined;

}

/** Tuple with error messages for 'unknown compiler option', 'option requires type' */

type ParseCommandLineWorkerDiagnostics = [DiagnosticMessage, DiagnosticMessage];

function parseCommandLineWorker(

getOptionNameMap: () => OptionNameMap,

[unknownOptionDiagnostic, optionTypeMismatchDiagnostic]: ParseCommandLineWorkerDiagnostics,

commandLine: ReadonlyArray<string>,

readFile?: (path: string) => string | undefined) {

const options = {} as OptionsBase;

const fileNames: string[] = [];

const errors: Diagnostic[] = [];

parseStrings(commandLine);

return {

options,

fileNames,

errors

};

function parseStrings(args: ReadonlyArray<string>) {

let i = 0;

while (i < args.length) {

const s = args[i];

i++;

if (s.charCodeAt(0) === CharacterCodes.at) {

parseResponseFile(s.slice(1));

}

else if (s.charCodeAt(0) === CharacterCodes.minus) {

const opt = getOptionDeclarationFromName(getOptionNameMap, s.slice(s.charCodeAt(1) === CharacterCodes.minus ? 2 : 1), /*allowShort*/ true);

if (opt) {

if (opt.isTSConfigOnly) {

errors.push(createCompilerDiagnostic(Diagnostics.Option_0_can_only_be_specified_in_tsconfig_json_file, opt.name));

}

else {

// Check to see if no argument was provided (e.g. "--locale" is the last command-line argument).

if (!args[i] && opt.type !== "boolean") {

errors.push(createCompilerDiagnostic(optionTypeMismatchDiagnostic, opt.name));

}

switch (opt.type) {

case "number":

options[opt.name] = parseInt(args[i]);

i++;