2017-03-01 18:28:51 +01:00
|
|
|
/// <reference path="sys.ts"/>
|
2014-07-13 01:04:16 +02:00
|
|
|
/// <reference path="types.ts"/>
|
|
|
|
/// <reference path="core.ts"/>
|
2015-10-31 02:10:05 +01:00
|
|
|
/// <reference path="diagnosticInformationMap.generated.ts"/>
|
2014-07-13 01:04:16 +02:00
|
|
|
/// <reference path="scanner.ts"/>
|
|
|
|
|
2015-06-12 18:01:48 +02:00
|
|
|
namespace ts {
|
2016-08-24 01:11:52 +02:00
|
|
|
/* @internal */
|
|
|
|
export const compileOnSaveCommandLineOption: CommandLineOption = { name: "compileOnSave", type: "boolean" };
|
2015-03-31 19:52:21 +02:00
|
|
|
/* @internal */
|
2016-06-06 20:29:03 +02:00
|
|
|
export const optionDeclarations: CommandLineOption[] = [
|
2017-02-08 21:14:43 +01:00
|
|
|
// CommandLine only options
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
|
|
|
name: "help",
|
|
|
|
shortName: "h",
|
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Command_line_Options,
|
2014-08-02 02:12:29 +02:00
|
|
|
description: Diagnostics.Print_this_message,
|
|
|
|
},
|
2016-05-24 20:33:23 +02:00
|
|
|
{
|
|
|
|
name: "help",
|
|
|
|
shortName: "?",
|
|
|
|
type: "boolean"
|
|
|
|
},
|
2015-07-27 13:52:57 +02:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "all",
|
2015-07-27 13:52:57 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Command_line_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Show_all_compiler_options,
|
2015-07-27 13:52:57 +02:00
|
|
|
},
|
2015-04-08 09:14:23 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "version",
|
|
|
|
shortName: "v",
|
2015-04-08 09:14:23 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Command_line_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Print_the_compiler_s_version,
|
2015-04-08 09:14:23 +02:00
|
|
|
},
|
2015-04-21 05:33:31 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "init",
|
2015-04-21 05:33:31 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Command_line_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Initializes_a_TypeScript_project_and_creates_a_tsconfig_json_file,
|
2015-04-21 05:33:31 +02:00
|
|
|
},
|
2015-06-18 23:01:31 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "project",
|
|
|
|
shortName: "p",
|
2016-11-09 21:12:48 +01:00
|
|
|
type: "string",
|
2017-02-08 08:10:43 +01:00
|
|
|
isFilePath: true,
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Command_line_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
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,
|
2016-11-09 21:12:48 +01:00
|
|
|
},
|
2015-01-15 22:22:23 +01:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "pretty",
|
2015-01-15 22:22:23 +01:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Command_line_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Stylize_errors_and_messages_using_color_and_context_experimental
|
2015-01-15 22:22:23 +01:00
|
|
|
},
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "watch",
|
|
|
|
shortName: "w",
|
|
|
|
type: "boolean",
|
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Command_line_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Watch_input_files,
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
2017-02-08 21:14:43 +01:00
|
|
|
|
|
|
|
// Basic
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "target",
|
|
|
|
shortName: "t",
|
|
|
|
type: createMapFromTemplate({
|
|
|
|
"es3": ScriptTarget.ES3,
|
|
|
|
"es5": ScriptTarget.ES5,
|
|
|
|
"es6": ScriptTarget.ES2015,
|
|
|
|
"es2015": ScriptTarget.ES2015,
|
|
|
|
"es2016": ScriptTarget.ES2016,
|
|
|
|
"es2017": ScriptTarget.ES2017,
|
|
|
|
"esnext": ScriptTarget.ESNext,
|
|
|
|
}),
|
|
|
|
paramType: Diagnostics.VERSION,
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Specify_ECMAScript_target_version_Colon_ES3_default_ES5_ES2015_ES2016_ES2017_or_ESNEXT,
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "module",
|
|
|
|
shortName: "m",
|
2017-01-11 18:52:50 +01:00
|
|
|
type: createMapFromTemplate({
|
2016-02-11 21:45:52 +01:00
|
|
|
"none": ModuleKind.None,
|
2014-08-02 02:12:29 +02:00
|
|
|
"commonjs": ModuleKind.CommonJS,
|
2015-04-10 21:10:38 +02:00
|
|
|
"amd": ModuleKind.AMD,
|
|
|
|
"system": ModuleKind.System,
|
2015-04-24 05:50:35 +02:00
|
|
|
"umd": ModuleKind.UMD,
|
2016-10-14 10:54:54 +02:00
|
|
|
"es6": ModuleKind.ES2015,
|
2015-10-15 19:50:47 +02:00
|
|
|
"es2015": ModuleKind.ES2015,
|
2017-06-06 02:16:29 +02:00
|
|
|
"esnext": ModuleKind.ESNext
|
2016-08-16 01:41:32 +02:00
|
|
|
}),
|
2014-08-02 02:12:29 +02:00
|
|
|
paramType: Diagnostics.KIND,
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-06-06 02:16:29 +02:00
|
|
|
description: Diagnostics.Specify_module_code_generation_Colon_commonjs_amd_system_umd_es2015_or_ESNext,
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
2015-04-26 17:37:02 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "lib",
|
|
|
|
type: "list",
|
|
|
|
element: {
|
|
|
|
name: "lib",
|
|
|
|
type: createMapFromTemplate({
|
|
|
|
// 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",
|
2017-03-16 01:21:07 +01:00
|
|
|
"esnext": "lib.esnext.d.ts",
|
2017-02-08 08:10:43 +01:00
|
|
|
// Host only
|
|
|
|
"dom": "lib.dom.d.ts",
|
|
|
|
"dom.iterable": "lib.dom.iterable.d.ts",
|
|
|
|
"webworker": "lib.webworker.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",
|
2017-05-24 18:50:38 +02:00
|
|
|
"es2017.intl": "lib.es2017.intl.d.ts",
|
2017-03-15 23:38:55 +01:00
|
|
|
"esnext.asynciterable": "lib.esnext.asynciterable.d.ts",
|
2017-02-08 08:10:43 +01:00
|
|
|
}),
|
|
|
|
},
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Specify_library_files_to_be_included_in_the_compilation_Colon
|
2015-04-08 09:14:23 +02:00
|
|
|
},
|
2015-04-21 05:33:31 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "allowJs",
|
2015-04-21 05:33:31 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Allow_javascript_files_to_be_compiled
|
2015-04-21 05:33:31 +02:00
|
|
|
},
|
2017-03-22 23:45:27 +01:00
|
|
|
{
|
|
|
|
name: "checkJs",
|
|
|
|
type: "boolean",
|
|
|
|
category: Diagnostics.Basic_Options,
|
|
|
|
description: Diagnostics.Report_errors_in_js_files
|
|
|
|
},
|
2015-06-18 23:01:31 +02:00
|
|
|
{
|
|
|
|
name: "jsx",
|
2017-01-11 18:52:50 +01:00
|
|
|
type: createMapFromTemplate({
|
2015-06-18 23:01:31 +02:00
|
|
|
"preserve": JsxEmit.Preserve,
|
2017-01-23 21:42:39 +01:00
|
|
|
"react-native": JsxEmit.ReactNative,
|
2015-06-18 23:01:31 +02:00
|
|
|
"react": JsxEmit.React
|
2016-08-16 01:41:32 +02:00
|
|
|
}),
|
2015-06-18 23:01:31 +02:00
|
|
|
paramType: Diagnostics.KIND,
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-01-23 21:42:39 +01:00
|
|
|
description: Diagnostics.Specify_JSX_code_generation_Colon_preserve_react_native_or_react,
|
2015-04-26 17:37:02 +02:00
|
|
|
},
|
2014-12-17 05:25:19 +01:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "declaration",
|
|
|
|
shortName: "d",
|
2014-12-17 05:25:19 +01:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Generates_corresponding_d_ts_file,
|
2014-12-17 05:25:19 +01:00
|
|
|
},
|
Add support for --noEmitHelpers flag
This PR is a Work In Progress that addresses multiple `__extends`
being output as described in #1350: Multiple `__extends` being output
when `--module amd` is set.
The issue still exists as of `v1.5.0 - f53e6a8`.
Apparently a fix was created for this in #1356 but according to #2009, a
[comment](https://github.com/Microsoft/TypeScript/issues/2009#issuecomment-74136291)
later indicated that this was never merged in.
Further conversation continued in #2487 but did not yield any result. I
refer to my earlier recommendation in #1350.
> My question is this, would the TypeScript team be open to a flag that
> can be passed to tsc that will generate something like the following
> ```ts
> define(["require", "exports", "__extends", './mammal'], function (require, exports, __extends, Mammal) {
> var Human = (function (_super) {
> __extends(Human, _super);
> function Human() {
> _super.apply(this, arguments);
> }
> return Human;
> })(Mammal);
> return Human;
> });
> ```
To continue with the naming convention I have chosen the flag
`--noEmitHelpers`.
2015-04-24 04:16:11 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "sourceMap",
|
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Generates_corresponding_map_file,
|
Add support for --noEmitHelpers flag
This PR is a Work In Progress that addresses multiple `__extends`
being output as described in #1350: Multiple `__extends` being output
when `--module amd` is set.
The issue still exists as of `v1.5.0 - f53e6a8`.
Apparently a fix was created for this in #1356 but according to #2009, a
[comment](https://github.com/Microsoft/TypeScript/issues/2009#issuecomment-74136291)
later indicated that this was never merged in.
Further conversation continued in #2487 but did not yield any result. I
refer to my earlier recommendation in #1350.
> My question is this, would the TypeScript team be open to a flag that
> can be passed to tsc that will generate something like the following
> ```ts
> define(["require", "exports", "__extends", './mammal'], function (require, exports, __extends, Mammal) {
> var Human = (function (_super) {
> __extends(Human, _super);
> function Human() {
> _super.apply(this, arguments);
> }
> return Human;
> })(Mammal);
> return Human;
> });
> ```
To continue with the naming convention I have chosen the flag
`--noEmitHelpers`.
2015-04-24 04:16:11 +02:00
|
|
|
},
|
2014-10-27 20:48:46 +01:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "outFile",
|
|
|
|
type: "string",
|
|
|
|
isFilePath: true,
|
|
|
|
paramType: Diagnostics.FILE,
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Concatenate_and_emit_output_to_single_file,
|
2014-10-27 20:48:46 +01:00
|
|
|
},
|
2016-08-06 00:10:02 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "outDir",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "string",
|
2017-02-08 08:10:43 +01:00
|
|
|
isFilePath: true,
|
|
|
|
paramType: Diagnostics.DIRECTORY,
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Redirect_output_structure_to_the_directory,
|
2016-08-06 00:10:02 +02:00
|
|
|
},
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "rootDir",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "string",
|
2015-01-15 22:22:23 +01:00
|
|
|
isFilePath: true,
|
2014-08-02 02:12:29 +02:00
|
|
|
paramType: Diagnostics.LOCATION,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Specify_the_root_directory_of_input_files_Use_to_control_the_output_directory_structure_with_outDir,
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
2016-03-26 00:37:28 +01:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "removeComments",
|
2016-03-26 00:37:28 +01:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Do_not_emit_comments_to_output,
|
2016-03-26 00:37:28 +01:00
|
|
|
},
|
2016-06-25 00:38:39 +02:00
|
|
|
{
|
2014-12-17 05:25:19 +01:00
|
|
|
name: "noEmit",
|
2016-06-25 00:38:39 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2014-12-17 05:25:19 +01:00
|
|
|
description: Diagnostics.Do_not_emit_outputs,
|
2016-06-25 00:38:39 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "importHelpers",
|
2016-06-25 00:38:39 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Import_emit_helpers_from_tslib
|
2016-06-25 00:38:39 +02:00
|
|
|
},
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2017-03-15 23:38:55 +01:00
|
|
|
name: "downlevelIteration",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "boolean",
|
2017-03-15 23:38:55 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.Provide_full_support_for_iterables_in_for_of_spread_and_destructuring_when_targeting_ES5_or_ES3
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "isolatedModules",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Basic_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.Transpile_each_file_as_a_separate_module_similar_to_ts_transpileModule
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
2017-02-08 08:10:43 +01:00
|
|
|
|
2017-03-16 00:15:59 +01:00
|
|
|
// Strict Type Checks
|
2015-06-04 22:56:33 +02:00
|
|
|
{
|
2017-03-15 23:38:55 +01:00
|
|
|
name: "strict",
|
2015-06-04 22:56:33 +02:00
|
|
|
type: "boolean",
|
2017-03-15 23:38:55 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Strict_Type_Checking_Options,
|
|
|
|
description: Diagnostics.Enable_all_strict_type_checking_options
|
2015-06-04 22:56:33 +02:00
|
|
|
},
|
2016-05-22 02:44:37 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "noImplicitAny",
|
2016-05-22 02:44:37 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Strict_Type_Checking_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Raise_error_on_expressions_and_declarations_with_an_implied_any_type,
|
2016-05-22 02:44:37 +02:00
|
|
|
},
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "strictNullChecks",
|
2015-06-04 22:56:33 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Strict_Type_Checking_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Enable_strict_null_checks
|
2015-08-21 02:37:56 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "noImplicitThis",
|
2016-05-22 02:44:37 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Strict_Type_Checking_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Raise_error_on_this_expressions_with_an_implied_any_type,
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
|
|
|
{
|
2017-03-16 00:15:59 +01:00
|
|
|
name: "alwaysStrict",
|
2014-12-10 21:37:09 +01:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Strict_Type_Checking_Options,
|
2017-03-16 00:15:59 +01:00
|
|
|
description: Diagnostics.Parse_in_strict_mode_and_emit_use_strict_for_each_source_file
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
2017-03-16 00:15:59 +01:00
|
|
|
|
|
|
|
// Additional Checks
|
2014-12-10 21:37:09 +01:00
|
|
|
{
|
2017-03-16 00:15:59 +01:00
|
|
|
name: "noUnusedLocals",
|
2014-12-10 21:37:09 +01:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-16 00:15:59 +01:00
|
|
|
category: Diagnostics.Additional_Checks,
|
|
|
|
description: Diagnostics.Report_errors_on_unused_locals,
|
2014-12-10 21:37:09 +01:00
|
|
|
},
|
2015-11-02 22:20:48 +01:00
|
|
|
{
|
2017-03-16 00:15:59 +01:00
|
|
|
name: "noUnusedParameters",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-16 00:15:59 +01:00
|
|
|
category: Diagnostics.Additional_Checks,
|
|
|
|
description: Diagnostics.Report_errors_on_unused_parameters,
|
2015-11-02 22:20:48 +01:00
|
|
|
},
|
2015-01-15 22:22:23 +01:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "noImplicitReturns",
|
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-16 00:15:59 +01:00
|
|
|
category: Diagnostics.Additional_Checks,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Report_error_when_not_all_code_paths_in_function_return_a_value
|
2015-01-15 22:22:23 +01:00
|
|
|
},
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "noFallthroughCasesInSwitch",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "boolean",
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-03-16 00:15:59 +01:00
|
|
|
category: Diagnostics.Additional_Checks,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Report_errors_for_fallthrough_cases_in_switch_statement
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
2017-02-08 08:10:43 +01:00
|
|
|
|
|
|
|
// Module Resolution
|
2015-04-15 07:11:25 +02:00
|
|
|
{
|
2015-08-21 01:13:49 +02:00
|
|
|
name: "moduleResolution",
|
2017-01-11 18:52:50 +01:00
|
|
|
type: createMapFromTemplate({
|
2015-08-21 01:13:49 +02:00
|
|
|
"node": ModuleResolutionKind.NodeJs,
|
2015-11-19 06:46:45 +01:00
|
|
|
"classic": ModuleResolutionKind.Classic,
|
2016-08-16 01:41:32 +02:00
|
|
|
}),
|
2016-09-10 04:37:51 +02:00
|
|
|
paramType: Diagnostics.STRATEGY,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Module_Resolution_Options,
|
2017-02-08 06:54:56 +01:00
|
|
|
description: Diagnostics.Specify_module_resolution_strategy_Colon_node_Node_js_or_classic_TypeScript_pre_1_6,
|
2015-10-15 23:43:51 +02:00
|
|
|
},
|
2015-11-09 23:24:19 +01:00
|
|
|
{
|
2015-11-19 06:46:45 +01:00
|
|
|
name: "baseUrl",
|
2015-04-15 07:11:25 +02:00
|
|
|
type: "string",
|
|
|
|
isFilePath: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Module_Resolution_Options,
|
2015-11-25 01:41:41 +01:00
|
|
|
description: Diagnostics.Base_directory_to_resolve_non_absolute_module_names
|
2015-04-15 07:11:25 +02:00
|
|
|
},
|
2015-03-31 04:33:15 +02:00
|
|
|
{
|
2015-11-19 06:46:45 +01:00
|
|
|
// this option can only be specified in tsconfig.json
|
|
|
|
// use type = object to copy the value as-is
|
|
|
|
name: "paths",
|
|
|
|
type: "object",
|
2017-02-08 06:54:56 +01:00
|
|
|
isTSConfigOnly: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Module_Resolution_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.A_series_of_entries_which_re_map_imports_to_lookup_locations_relative_to_the_baseUrl
|
2017-02-08 06:54:56 +01:00
|
|
|
|
2015-03-31 04:33:15 +02:00
|
|
|
},
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2015-11-19 06:46:45 +01:00
|
|
|
// this option can only be specified in tsconfig.json
|
|
|
|
// use type = object to copy the value as-is
|
|
|
|
name: "rootDirs",
|
2016-03-10 20:14:29 +01:00
|
|
|
type: "list",
|
2015-11-26 01:41:09 +01:00
|
|
|
isTSConfigOnly: true,
|
2016-03-10 20:14:29 +01:00
|
|
|
element: {
|
|
|
|
name: "rootDirs",
|
|
|
|
type: "string",
|
|
|
|
isFilePath: true
|
2017-02-08 06:54:56 +01:00
|
|
|
},
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Module_Resolution_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.List_of_root_folders_whose_combined_content_represents_the_structure_of_the_project_at_runtime
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
|
|
|
{
|
2016-06-11 00:44:11 +02:00
|
|
|
name: "typeRoots",
|
|
|
|
type: "list",
|
|
|
|
element: {
|
|
|
|
name: "typeRoots",
|
2016-06-13 18:33:49 +02:00
|
|
|
type: "string",
|
|
|
|
isFilePath: true
|
2017-02-08 06:54:56 +01:00
|
|
|
},
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Module_Resolution_Options,
|
2017-02-08 06:54:56 +01:00
|
|
|
description: Diagnostics.List_of_folders_to_include_type_definitions_from
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
2015-08-27 02:13:53 +02:00
|
|
|
{
|
2016-04-06 22:49:25 +02:00
|
|
|
name: "types",
|
|
|
|
type: "list",
|
|
|
|
element: {
|
|
|
|
name: "types",
|
|
|
|
type: "string"
|
|
|
|
},
|
2017-02-08 21:14:43 +01:00
|
|
|
showInSimplifiedHelpView: true,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Module_Resolution_Options,
|
2016-04-06 22:49:25 +02:00
|
|
|
description: Diagnostics.Type_declaration_files_to_be_included_in_compilation
|
2015-08-27 02:13:53 +02:00
|
|
|
},
|
2014-12-10 21:37:09 +01:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "allowSyntheticDefaultImports",
|
2014-12-10 21:37:09 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Module_Resolution_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Allow_default_imports_from_modules_with_no_default_export_This_does_not_affect_code_emit_just_typechecking
|
2014-12-10 21:37:09 +01:00
|
|
|
},
|
2017-02-08 08:10:43 +01:00
|
|
|
|
2017-02-08 21:14:43 +01:00
|
|
|
// Source Maps
|
2015-02-03 22:15:28 +01:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "sourceRoot",
|
|
|
|
type: "string",
|
|
|
|
isFilePath: true,
|
|
|
|
paramType: Diagnostics.LOCATION,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Source_Map_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Specify_the_location_where_debugger_should_locate_TypeScript_files_instead_of_source_locations,
|
2015-02-03 22:15:28 +01:00
|
|
|
},
|
2014-08-02 02:12:29 +02:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "mapRoot",
|
|
|
|
type: "string",
|
|
|
|
isFilePath: true,
|
|
|
|
paramType: Diagnostics.LOCATION,
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Source_Map_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Specify_the_location_where_debugger_should_locate_map_files_instead_of_generated_locations,
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "inlineSourceMap",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "boolean",
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Source_Map_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Emit_a_single_file_with_source_maps_instead_of_having_a_separate_file
|
2014-08-02 02:12:29 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "inlineSources",
|
2014-08-02 02:12:29 +02:00
|
|
|
type: "boolean",
|
2017-03-22 20:01:08 +01:00
|
|
|
category: Diagnostics.Source_Map_Options,
|
2017-02-14 07:21:34 +01:00
|
|
|
description: Diagnostics.Emit_the_source_alongside_the_sourcemaps_within_a_single_file_requires_inlineSourceMap_or_sourceMap_to_be_set
|
2015-04-02 02:58:28 +02:00
|
|
|
},
|
2017-02-08 21:14:43 +01:00
|
|
|
|
2017-02-08 08:10:43 +01:00
|
|
|
// Experimental
|
2015-06-02 00:01:24 +02:00
|
|
|
{
|
|
|
|
name: "experimentalDecorators",
|
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Experimental_Options,
|
2015-06-02 00:01:24 +02:00
|
|
|
description: Diagnostics.Enables_experimental_support_for_ES7_decorators
|
|
|
|
},
|
2015-04-02 02:58:28 +02:00
|
|
|
{
|
|
|
|
name: "emitDecoratorMetadata",
|
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Experimental_Options,
|
2015-06-02 00:01:24 +02:00
|
|
|
description: Diagnostics.Enables_experimental_support_for_emitting_type_metadata_for_decorators
|
2015-08-21 01:13:49 +02:00
|
|
|
},
|
2017-02-08 08:10:43 +01:00
|
|
|
|
2017-02-08 21:14:43 +01:00
|
|
|
// Advanced
|
2015-08-21 01:13:49 +02:00
|
|
|
{
|
2017-03-16 00:15:59 +01:00
|
|
|
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
|
2015-10-15 23:43:51 +02:00
|
|
|
},
|
2015-09-03 19:49:39 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "diagnostics",
|
2015-09-03 19:49:39 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Show_diagnostic_information
|
2015-09-03 19:49:39 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "extendedDiagnostics",
|
2015-09-03 19:49:39 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.Show_verbose_diagnostic_information
|
2015-09-03 19:49:39 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "traceResolution",
|
2015-09-03 19:49:39 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Enable_tracing_of_the_name_resolution_process
|
2015-09-03 19:49:39 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "listFiles",
|
2015-09-03 19:49:39 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Print_names_of_files_part_of_the_compilation
|
2015-10-29 17:33:27 +01:00
|
|
|
},
|
2015-10-15 23:43:51 +02:00
|
|
|
{
|
2016-04-06 22:25:29 +02:00
|
|
|
name: "listEmittedFiles",
|
2015-10-15 23:43:51 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 06:54:56 +01:00
|
|
|
description: Diagnostics.Print_names_of_generated_files_part_of_the_compilation
|
2015-11-09 23:24:19 +01:00
|
|
|
},
|
2017-02-08 08:10:43 +01:00
|
|
|
|
2016-11-19 01:50:43 +01:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "out",
|
|
|
|
type: "string",
|
|
|
|
isFilePath: false, // This is intentionally broken to support compatability with existing tsconfig files
|
|
|
|
// for correct behaviour, please use outFile
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
paramType: Diagnostics.FILE,
|
2017-02-08 21:25:38 +01:00
|
|
|
description: Diagnostics.Deprecated_Use_outFile_instead_Concatenate_and_emit_output_to_single_file,
|
2017-02-08 21:14:43 +01:00
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "reactNamespace",
|
|
|
|
type: "string",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 21:25:38 +01:00
|
|
|
description: Diagnostics.Deprecated_Use_jsxFactory_instead_Specify_the_object_invoked_for_createElement_when_targeting_react_JSX_emit
|
2017-02-08 21:14:43 +01:00
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "skipDefaultLibCheck",
|
2016-12-30 23:39:51 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 21:25:38 +01:00
|
|
|
description: Diagnostics.Deprecated_Use_skipLibCheck_instead_Skip_type_checking_of_default_library_declaration_files
|
2016-11-19 01:50:43 +01:00
|
|
|
},
|
2015-11-09 23:24:19 +01:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "charset",
|
2015-11-19 06:46:45 +01:00
|
|
|
type: "string",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.The_character_set_of_the_input_files
|
2015-11-19 06:46:45 +01:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "emitBOM",
|
2017-02-08 06:54:56 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-14 07:21:34 +01:00
|
|
|
description: Diagnostics.Emit_a_UTF_8_Byte_Order_Mark_BOM_in_the_beginning_of_output_files
|
2015-11-19 06:46:45 +01:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "locale",
|
|
|
|
type: "string",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.The_locale_used_when_displaying_messages_to_the_user_e_g_en_us
|
2015-11-20 06:11:57 +01:00
|
|
|
},
|
2016-04-06 01:33:11 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "newLine",
|
|
|
|
type: createMapFromTemplate({
|
|
|
|
"crlf": NewLineKind.CarriageReturnLineFeed,
|
|
|
|
"lf": NewLineKind.LineFeed
|
|
|
|
}),
|
|
|
|
paramType: Diagnostics.NEWLINE,
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Specify_the_end_of_line_sequence_to_be_used_when_emitting_files_Colon_CRLF_dos_or_LF_unix,
|
2016-04-06 01:33:11 +02:00
|
|
|
},
|
2016-04-06 22:49:25 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "noErrorTruncation",
|
2016-02-15 03:41:38 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.Do_not_truncate_error_messages
|
2016-04-06 22:49:25 +02:00
|
|
|
},
|
2015-11-20 06:33:33 +01:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "noLib",
|
2015-11-09 23:24:19 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Do_not_include_the_default_library_file_lib_d_ts
|
2015-11-20 22:45:25 +01:00
|
|
|
},
|
2015-09-16 22:57:51 +02:00
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "noResolve",
|
2015-10-28 22:02:46 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.Do_not_add_triple_slash_references_or_imported_modules_to_the_list_of_compiled_files
|
2015-11-26 06:23:35 +01:00
|
|
|
},
|
|
|
|
{
|
2017-02-08 08:10:43 +01:00
|
|
|
name: "stripInternal",
|
2015-11-26 06:23:35 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 08:10:43 +01:00
|
|
|
description: Diagnostics.Do_not_emit_declarations_for_code_that_has_an_internal_annotation,
|
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "disableSizeLimit",
|
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.Disable_size_limitations_on_JavaScript_projects
|
2016-02-03 23:16:09 +01:00
|
|
|
},
|
|
|
|
{
|
2016-02-06 01:30:01 +01:00
|
|
|
name: "noImplicitUseStrict",
|
2016-02-03 23:16:09 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2016-02-03 23:16:09 +01:00
|
|
|
description: Diagnostics.Do_not_emit_use_strict_directives_in_module_output
|
2016-02-15 03:41:38 +01:00
|
|
|
},
|
2016-02-13 16:48:25 +01:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "noEmitHelpers",
|
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Do_not_generate_custom_helper_functions_like_extends_in_compiled_output
|
2016-05-24 02:00:10 +02:00
|
|
|
},
|
2016-04-06 22:25:29 +02:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "noEmitOnError",
|
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Do_not_emit_outputs_if_any_errors_were_reported,
|
2016-04-06 22:25:29 +02:00
|
|
|
},
|
2016-03-28 23:20:29 +02:00
|
|
|
{
|
2017-02-08 21:14:43 +01:00
|
|
|
name: "preserveConstEnums",
|
|
|
|
type: "boolean",
|
2017-02-09 04:25:08 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
2017-02-08 21:14:43 +01:00
|
|
|
description: Diagnostics.Do_not_erase_const_enum_declarations_in_generated_code
|
2016-03-28 23:20:29 +02:00
|
|
|
},
|
2016-03-14 22:51:24 +01:00
|
|
|
{
|
2017-02-09 04:32:27 +01:00
|
|
|
name: "declarationDir",
|
|
|
|
type: "string",
|
|
|
|
isFilePath: true,
|
|
|
|
paramType: Diagnostics.DIRECTORY,
|
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.Output_directory_for_generated_declaration_files
|
2016-03-24 19:42:18 +01:00
|
|
|
},
|
2016-02-15 03:41:38 +01:00
|
|
|
{
|
2017-02-09 04:32:27 +01:00
|
|
|
name: "skipLibCheck",
|
2016-02-15 03:41:38 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:32:27 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.Skip_type_checking_of_declaration_files,
|
2016-06-11 09:12:04 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-09 04:32:27 +01:00
|
|
|
name: "allowUnusedLabels",
|
2016-06-11 09:12:04 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:32:27 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.Do_not_report_errors_on_unused_labels
|
2016-10-09 00:49:51 +02:00
|
|
|
},
|
|
|
|
{
|
2017-02-09 04:32:27 +01:00
|
|
|
name: "allowUnreachableCode",
|
2016-10-09 00:49:51 +02:00
|
|
|
type: "boolean",
|
2017-02-09 04:32:27 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.Do_not_report_errors_on_unreachable_code
|
2017-02-14 22:35:16 +01:00
|
|
|
},
|
2017-03-03 19:25:10 +01:00
|
|
|
{
|
2017-02-09 04:32:27 +01:00
|
|
|
name: "suppressExcessPropertyErrors",
|
|
|
|
type: "boolean",
|
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.Suppress_excess_property_checks_for_object_literals,
|
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "suppressImplicitAnyIndexErrors",
|
|
|
|
type: "boolean",
|
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.Suppress_noImplicitAny_errors_for_indexing_objects_lacking_index_signatures,
|
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "forceConsistentCasingInFileNames",
|
2017-03-03 19:25:10 +01:00
|
|
|
type: "boolean",
|
2017-02-09 04:32:27 +01:00
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.Disallow_inconsistently_cased_references_to_the_same_file
|
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "maxNodeModuleJsDepth",
|
|
|
|
type: "number",
|
|
|
|
category: Diagnostics.Advanced_Options,
|
|
|
|
description: Diagnostics.The_maximum_dependency_depth_to_search_under_node_modules_and_load_JavaScript_files
|
2017-03-03 19:25:10 +01:00
|
|
|
},
|
2017-02-14 22:35:16 +01:00
|
|
|
{
|
|
|
|
// A list of plugins to load in the language service
|
|
|
|
name: "plugins",
|
|
|
|
type: "list",
|
|
|
|
isTSConfigOnly: true,
|
|
|
|
element: {
|
|
|
|
name: "plugin",
|
|
|
|
type: "object"
|
2017-03-15 23:38:55 +01:00
|
|
|
},
|
2017-03-22 20:01:08 +01:00
|
|
|
description: Diagnostics.List_of_language_service_plugins
|
2015-09-03 19:49:39 +02:00
|
|
|
}
|
2014-07-13 01:04:16 +02:00
|
|
|
];
|
2015-03-31 19:52:21 +02:00
|
|
|
|
2016-03-10 20:14:29 +01:00
|
|
|
/* @internal */
|
2016-11-19 02:46:06 +01:00
|
|
|
export let typeAcquisitionDeclarations: CommandLineOption[] = [
|
2016-03-10 20:14:29 +01:00
|
|
|
{
|
2016-11-21 22:42:42 +01:00
|
|
|
/* @deprecated typingOptions.enableAutoDiscovery
|
|
|
|
* Use typeAcquisition.enable instead.
|
|
|
|
*/
|
2016-03-10 20:14:29 +01:00
|
|
|
name: "enableAutoDiscovery",
|
|
|
|
type: "boolean",
|
|
|
|
},
|
|
|
|
{
|
2016-11-19 02:46:06 +01:00
|
|
|
name: "enable",
|
2016-03-10 20:14:29 +01:00
|
|
|
type: "boolean",
|
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "include",
|
|
|
|
type: "list",
|
|
|
|
element: {
|
|
|
|
name: "include",
|
|
|
|
type: "string"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
name: "exclude",
|
|
|
|
type: "list",
|
|
|
|
element: {
|
2016-03-16 22:08:49 +01:00
|
|
|
name: "exclude",
|
2016-03-10 20:14:29 +01:00
|
|
|
type: "string"
|
|
|
|
}
|
2015-09-03 19:49:39 +02:00
|
|
|
}
|
2014-07-13 01:04:16 +02:00
|
|
|
];
|
2015-03-31 19:52:21 +02:00
|
|
|
|
2015-08-25 23:34:34 +02:00
|
|
|
/* @internal */
|
2015-07-27 13:52:57 +02:00
|
|
|
export interface OptionNameMap {
|
|
|
|
optionNameMap: Map<CommandLineOption>;
|
|
|
|
shortOptionNames: Map<string>;
|
|
|
|
}
|
2014-07-13 01:04:16 +02:00
|
|
|
|
2016-08-18 00:23:28 +02:00
|
|
|
/* @internal */
|
|
|
|
export const defaultInitCompilerOptions: CompilerOptions = {
|
|
|
|
module: ModuleKind.CommonJS,
|
|
|
|
target: ScriptTarget.ES5,
|
2017-03-16 00:41:39 +01:00
|
|
|
strict: true
|
2016-08-18 00:23:28 +02:00
|
|
|
};
|
|
|
|
|
2015-07-27 13:52:57 +02:00
|
|
|
let optionNameMapCache: OptionNameMap;
|
2016-03-28 23:20:29 +02:00
|
|
|
|
2016-11-21 22:42:42 +01:00
|
|
|
/* @internal */
|
2016-11-22 23:47:44 +01:00
|
|
|
export function convertEnableAutoDiscoveryToEnable(typeAcquisition: TypeAcquisition): TypeAcquisition {
|
|
|
|
// Convert deprecated typingOptions.enableAutoDiscovery to typeAcquisition.enable
|
2016-11-21 22:42:42 +01:00
|
|
|
if (typeAcquisition && typeAcquisition.enableAutoDiscovery !== undefined && typeAcquisition.enable === undefined) {
|
2016-11-22 23:47:44 +01:00
|
|
|
const result: TypeAcquisition = {
|
|
|
|
enable: typeAcquisition.enableAutoDiscovery,
|
|
|
|
include: typeAcquisition.include || [],
|
|
|
|
exclude: typeAcquisition.exclude || []
|
|
|
|
};
|
2017-01-07 08:44:17 +01:00
|
|
|
return result;
|
2016-11-21 22:42:42 +01:00
|
|
|
}
|
2016-11-22 23:47:44 +01:00
|
|
|
return typeAcquisition;
|
2016-11-21 22:42:42 +01:00
|
|
|
}
|
|
|
|
|
2017-05-25 22:30:27 +02:00
|
|
|
function getOptionNameMap(): OptionNameMap {
|
2015-07-27 13:52:57 +02:00
|
|
|
if (optionNameMapCache) {
|
|
|
|
return optionNameMapCache;
|
|
|
|
}
|
2014-07-13 01:04:16 +02:00
|
|
|
|
2016-08-11 01:47:06 +02:00
|
|
|
const optionNameMap = createMap<CommandLineOption>();
|
|
|
|
const shortOptionNames = createMap<string>();
|
2015-01-15 22:22:23 +01:00
|
|
|
forEach(optionDeclarations, option => {
|
2016-12-05 23:13:32 +01:00
|
|
|
optionNameMap.set(option.name.toLowerCase(), option);
|
2015-01-15 22:22:23 +01:00
|
|
|
if (option.shortName) {
|
2016-12-05 23:13:32 +01:00
|
|
|
shortOptionNames.set(option.shortName, option.name);
|
2015-01-15 22:22:23 +01:00
|
|
|
}
|
|
|
|
});
|
2015-07-27 13:52:57 +02:00
|
|
|
|
|
|
|
optionNameMapCache = { optionNameMap, shortOptionNames };
|
|
|
|
return optionNameMapCache;
|
|
|
|
}
|
|
|
|
|
2016-03-14 23:53:42 +01:00
|
|
|
/* @internal */
|
2016-03-16 21:49:36 +01:00
|
|
|
export function createCompilerDiagnosticForInvalidCustomType(opt: CommandLineOptionOfCustomType): Diagnostic {
|
2016-12-28 18:05:52 +01:00
|
|
|
const namesOfType = arrayFrom(opt.type.keys()).map(key => `'${key}'`).join(", ");
|
2016-03-16 21:49:36 +01:00
|
|
|
return createCompilerDiagnostic(Diagnostics.Argument_for_0_option_must_be_Colon_1, `--${opt.name}`, namesOfType);
|
2016-03-14 23:53:42 +01:00
|
|
|
}
|
|
|
|
|
2016-03-28 23:20:29 +02:00
|
|
|
/* @internal */
|
|
|
|
export function parseCustomTypeOption(opt: CommandLineOptionOfCustomType, value: string, errors: Diagnostic[]) {
|
2016-12-07 17:19:47 +01:00
|
|
|
return convertJsonOptionOfCustomType(opt, trimString(value || ""), errors);
|
2016-03-28 23:20:29 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/* @internal */
|
2016-06-10 23:14:32 +02:00
|
|
|
export function parseListTypeOption(opt: CommandLineOptionOfListType, value = "", errors: Diagnostic[]): (string | number)[] | undefined {
|
|
|
|
value = trimString(value);
|
|
|
|
if (startsWith(value, "-")) {
|
|
|
|
return undefined;
|
|
|
|
}
|
2016-06-10 23:35:13 +02:00
|
|
|
if (value === "") {
|
2016-06-10 23:14:32 +02:00
|
|
|
return [];
|
|
|
|
}
|
|
|
|
const values = value.split(",");
|
2016-03-28 23:20:29 +02:00
|
|
|
switch (opt.element.type) {
|
|
|
|
case "number":
|
2016-06-10 23:14:32 +02:00
|
|
|
return map(values, parseInt);
|
2016-03-28 23:20:29 +02:00
|
|
|
case "string":
|
2016-06-10 23:14:32 +02:00
|
|
|
return map(values, v => v || "");
|
2016-03-28 23:20:29 +02:00
|
|
|
default:
|
|
|
|
return filter(map(values, v => parseCustomTypeOption(<CommandLineOptionOfCustomType>opt.element, v, errors)), v => !!v);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-08-28 03:16:22 +02:00
|
|
|
export function parseCommandLine(commandLine: string[], readFile?: (path: string) => string): ParsedCommandLine {
|
2015-11-04 23:02:33 +01:00
|
|
|
const options: CompilerOptions = {};
|
|
|
|
const fileNames: string[] = [];
|
|
|
|
const errors: Diagnostic[] = [];
|
2015-07-27 13:52:57 +02:00
|
|
|
|
2014-07-13 01:04:16 +02:00
|
|
|
parseStrings(commandLine);
|
|
|
|
return {
|
2014-11-18 21:05:40 +01:00
|
|
|
options,
|
2015-02-04 01:08:46 +01:00
|
|
|
fileNames,
|
2014-11-18 21:05:40 +01:00
|
|
|
errors
|
2014-07-13 01:04:16 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
function parseStrings(args: string[]) {
|
2015-06-26 02:36:19 +02:00
|
|
|
let i = 0;
|
2014-07-13 01:04:16 +02:00
|
|
|
while (i < args.length) {
|
2017-05-25 22:30:27 +02:00
|
|
|
const s = args[i];
|
2015-12-23 00:45:00 +01:00
|
|
|
i++;
|
2014-07-13 01:04:16 +02:00
|
|
|
if (s.charCodeAt(0) === CharacterCodes.at) {
|
|
|
|
parseResponseFile(s.slice(1));
|
|
|
|
}
|
|
|
|
else if (s.charCodeAt(0) === CharacterCodes.minus) {
|
2017-05-25 22:30:27 +02:00
|
|
|
const opt = getOptionFromName(s.slice(s.charCodeAt(1) === CharacterCodes.minus ? 2 : 1), /*allowShort*/ true);
|
2016-12-05 23:13:32 +01:00
|
|
|
if (opt) {
|
2016-03-10 20:14:29 +01:00
|
|
|
if (opt.isTSConfigOnly) {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Option_0_can_only_be_specified_in_tsconfig_json_file, opt.name));
|
2014-07-13 01:04:16 +02:00
|
|
|
}
|
2016-03-10 20:14:29 +01:00
|
|
|
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(Diagnostics.Compiler_option_0_expects_an_argument, opt.name));
|
|
|
|
}
|
|
|
|
|
|
|
|
switch (opt.type) {
|
|
|
|
case "number":
|
|
|
|
options[opt.name] = parseInt(args[i]);
|
|
|
|
i++;
|
|
|
|
break;
|
|
|
|
case "boolean":
|
2016-10-24 19:45:07 +02:00
|
|
|
// boolean flag has optional value true, false, others
|
2016-12-18 07:44:54 +01:00
|
|
|
const optValue = args[i];
|
2016-10-24 19:45:07 +02:00
|
|
|
options[opt.name] = optValue !== "false";
|
|
|
|
// consume next argument as boolean flag value
|
|
|
|
if (optValue === "false" || optValue === "true") {
|
|
|
|
i++;
|
|
|
|
}
|
2016-03-10 20:14:29 +01:00
|
|
|
break;
|
|
|
|
case "string":
|
|
|
|
options[opt.name] = args[i] || "";
|
|
|
|
i++;
|
|
|
|
break;
|
|
|
|
case "list":
|
2016-06-10 23:14:32 +02:00
|
|
|
const result = parseListTypeOption(<CommandLineOptionOfListType>opt, args[i], errors);
|
|
|
|
options[opt.name] = result || [];
|
|
|
|
if (result) {
|
|
|
|
i++;
|
|
|
|
}
|
2016-03-10 20:14:29 +01:00
|
|
|
break;
|
|
|
|
// If not a primitive, the possible types are specified in what is effectively a map of options.
|
|
|
|
default:
|
2016-03-28 23:20:29 +02:00
|
|
|
options[opt.name] = parseCustomTypeOption(<CommandLineOptionOfCustomType>opt, args[i], errors);
|
2016-03-10 20:14:29 +01:00
|
|
|
i++;
|
|
|
|
break;
|
|
|
|
}
|
2014-07-13 01:04:16 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Unknown_compiler_option_0, s));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else {
|
2015-02-04 01:08:46 +01:00
|
|
|
fileNames.push(s);
|
2014-07-13 01:04:16 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-02-04 01:08:46 +01:00
|
|
|
function parseResponseFile(fileName: string) {
|
2015-11-04 23:02:33 +01:00
|
|
|
const text = readFile ? readFile(fileName) : sys.readFile(fileName);
|
2014-07-13 01:04:16 +02:00
|
|
|
|
|
|
|
if (!text) {
|
2015-02-04 01:08:46 +01:00
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.File_0_not_found, fileName));
|
2014-07-13 01:04:16 +02:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-11-04 23:02:33 +01:00
|
|
|
const args: string[] = [];
|
2015-06-26 02:36:19 +02:00
|
|
|
let pos = 0;
|
2014-07-13 01:04:16 +02:00
|
|
|
while (true) {
|
|
|
|
while (pos < text.length && text.charCodeAt(pos) <= CharacterCodes.space) pos++;
|
|
|
|
if (pos >= text.length) break;
|
2015-11-04 23:02:33 +01:00
|
|
|
const start = pos;
|
2014-07-13 01:04:16 +02:00
|
|
|
if (text.charCodeAt(start) === CharacterCodes.doubleQuote) {
|
|
|
|
pos++;
|
|
|
|
while (pos < text.length && text.charCodeAt(pos) !== CharacterCodes.doubleQuote) pos++;
|
|
|
|
if (pos < text.length) {
|
|
|
|
args.push(text.substring(start + 1, pos));
|
|
|
|
pos++;
|
|
|
|
}
|
|
|
|
else {
|
2015-02-04 01:08:46 +01:00
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Unterminated_quoted_string_in_response_file_0, fileName));
|
2014-07-13 01:04:16 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
while (text.charCodeAt(pos) > CharacterCodes.space) pos++;
|
|
|
|
args.push(text.substring(start, pos));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
parseStrings(args);
|
|
|
|
}
|
|
|
|
}
|
2015-01-15 22:22:23 +01:00
|
|
|
|
2017-05-25 22:30:27 +02:00
|
|
|
function getOptionFromName(optionName: string, allowShort = false): CommandLineOption | undefined {
|
|
|
|
optionName = optionName.toLowerCase();
|
|
|
|
const { optionNameMap, shortOptionNames } = getOptionNameMap();
|
|
|
|
// Try to translate short option names to their full equivalents.
|
|
|
|
if (allowShort) {
|
|
|
|
const short = shortOptionNames.get(optionName);
|
|
|
|
if (short !== undefined) {
|
|
|
|
optionName = short;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return optionNameMap.get(optionName);
|
|
|
|
}
|
|
|
|
|
2015-03-31 19:52:21 +02:00
|
|
|
/**
|
2017-04-03 18:32:39 +02:00
|
|
|
* Read tsconfig.json file
|
|
|
|
* @param fileName The path to the config file
|
|
|
|
*/
|
2016-05-03 23:52:41 +02:00
|
|
|
export function readConfigFile(fileName: string, readFile: (path: string) => string): { config?: any; error?: Diagnostic } {
|
2015-07-24 02:30:31 +02:00
|
|
|
let text = "";
|
2015-01-15 22:22:23 +01:00
|
|
|
try {
|
2015-08-28 01:52:49 +02:00
|
|
|
text = readFile(fileName);
|
2015-01-15 22:22:23 +01:00
|
|
|
}
|
|
|
|
catch (e) {
|
2015-04-23 03:09:55 +02:00
|
|
|
return { error: createCompilerDiagnostic(Diagnostics.Cannot_read_file_0_Colon_1, fileName, e.message) };
|
|
|
|
}
|
2015-10-15 00:10:05 +02:00
|
|
|
return parseConfigFileTextToJson(fileName, text);
|
2015-04-23 03:09:55 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2017-04-03 18:32:39 +02:00
|
|
|
* Parse the text of the tsconfig.json file
|
|
|
|
* @param fileName The path to the config file
|
|
|
|
* @param jsonText The text of the config file
|
|
|
|
*/
|
2016-08-29 23:13:22 +02:00
|
|
|
export function parseConfigFileTextToJson(fileName: string, jsonText: string, stripComments = true): { config?: any; error?: Diagnostic } {
|
2015-04-23 03:09:55 +02:00
|
|
|
try {
|
2016-08-29 23:13:22 +02:00
|
|
|
const jsonTextToParse = stripComments ? removeComments(jsonText) : jsonText;
|
|
|
|
return { config: /\S/.test(jsonTextToParse) ? JSON.parse(jsonTextToParse) : {} };
|
2015-01-15 22:22:23 +01:00
|
|
|
}
|
|
|
|
catch (e) {
|
2015-04-23 03:00:09 +02:00
|
|
|
return { error: createCompilerDiagnostic(Diagnostics.Failed_to_parse_file_0_Colon_1, fileName, e.message) };
|
2015-01-15 22:22:23 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-08-18 00:23:28 +02:00
|
|
|
/**
|
|
|
|
* Generate tsconfig configuration when running command line "--init"
|
|
|
|
* @param options commandlineOptions to be generated into tsconfig.json
|
|
|
|
* @param fileNames array of filenames to be generated into tsconfig.json
|
|
|
|
*/
|
|
|
|
/* @internal */
|
2017-04-11 23:23:26 +02:00
|
|
|
export function generateTSConfig(options: CompilerOptions, fileNames: string[], newLine: string): string {
|
2016-08-18 00:23:28 +02:00
|
|
|
const compilerOptions = extend(options, defaultInitCompilerOptions);
|
2017-02-09 04:07:15 +01:00
|
|
|
const configurations: { compilerOptions: MapLike<CompilerOptionsValue>; files?: string[] } = {
|
2016-08-18 00:23:28 +02:00
|
|
|
compilerOptions: serializeCompilerOptions(compilerOptions)
|
|
|
|
};
|
|
|
|
if (fileNames && fileNames.length) {
|
|
|
|
// only set the files property if we have at least one file
|
|
|
|
configurations.files = fileNames;
|
|
|
|
}
|
|
|
|
|
2017-02-09 04:07:15 +01:00
|
|
|
|
|
|
|
return writeConfigurations();
|
2016-08-18 00:23:28 +02:00
|
|
|
|
|
|
|
function getCustomTypeMapOfCommandLineOption(optionDefinition: CommandLineOption): Map<string | number> | undefined {
|
|
|
|
if (optionDefinition.type === "string" || optionDefinition.type === "number" || optionDefinition.type === "boolean") {
|
|
|
|
// this is of a type CommandLineOptionOfPrimitiveType
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
else if (optionDefinition.type === "list") {
|
|
|
|
return getCustomTypeMapOfCommandLineOption((<CommandLineOptionOfListType>optionDefinition).element);
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
return (<CommandLineOptionOfCustomType>optionDefinition).type;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-12-05 23:13:32 +01:00
|
|
|
function getNameOfCompilerOptionValue(value: CompilerOptionsValue, customTypeMap: Map<string | number>): string | undefined {
|
2016-08-18 00:23:28 +02:00
|
|
|
// There is a typeMap associated with this command-line option so use it to map value back to its name
|
2016-12-28 18:16:38 +01:00
|
|
|
return forEachEntry(customTypeMap, (mapValue, key) => {
|
2016-12-05 23:13:32 +01:00
|
|
|
if (mapValue === value) {
|
2016-08-18 00:23:28 +02:00
|
|
|
return key;
|
|
|
|
}
|
2016-12-05 23:13:32 +01:00
|
|
|
});
|
2016-08-18 00:23:28 +02:00
|
|
|
}
|
|
|
|
|
2016-12-05 23:13:32 +01:00
|
|
|
function serializeCompilerOptions(options: CompilerOptions): MapLike<CompilerOptionsValue> {
|
2016-12-27 21:46:28 +01:00
|
|
|
const result: ts.MapLike<CompilerOptionsValue> = {};
|
2016-08-18 00:23:28 +02:00
|
|
|
const optionsNameMap = getOptionNameMap().optionNameMap;
|
|
|
|
|
|
|
|
for (const name in options) {
|
|
|
|
if (hasProperty(options, name)) {
|
|
|
|
// tsconfig only options cannot be specified via command line,
|
|
|
|
// so we can assume that only types that can appear here string | number | boolean
|
2017-03-22 20:01:08 +01:00
|
|
|
if (optionsNameMap.has(name) && optionsNameMap.get(name).category === Diagnostics.Command_line_Options) {
|
2017-02-08 21:35:31 +01:00
|
|
|
continue;
|
|
|
|
}
|
|
|
|
const value = options[name];
|
|
|
|
const optionDefinition = optionsNameMap.get(name.toLowerCase());
|
|
|
|
if (optionDefinition) {
|
|
|
|
const customTypeMap = getCustomTypeMapOfCommandLineOption(optionDefinition);
|
|
|
|
if (!customTypeMap) {
|
|
|
|
// There is no map associated with this compiler option then use the value as-is
|
|
|
|
// This is the case if the value is expect to be string, number, boolean or list of string
|
|
|
|
result[name] = value;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
if (optionDefinition.type === "list") {
|
|
|
|
const convertedValue: string[] = [];
|
|
|
|
for (const element of value as (string | number)[]) {
|
|
|
|
convertedValue.push(getNameOfCompilerOptionValue(element, customTypeMap));
|
2016-08-18 00:23:28 +02:00
|
|
|
}
|
2017-02-08 21:35:31 +01:00
|
|
|
result[name] = convertedValue;
|
2016-08-18 00:23:28 +02:00
|
|
|
}
|
2017-02-08 21:35:31 +01:00
|
|
|
else {
|
|
|
|
// There is a typeMap associated with this command-line option so use it to map value back to its name
|
|
|
|
result[name] = getNameOfCompilerOptionValue(value, customTypeMap);
|
|
|
|
}
|
|
|
|
}
|
2016-08-18 00:23:28 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return result;
|
|
|
|
}
|
2017-02-09 04:07:15 +01:00
|
|
|
|
|
|
|
function getDefaultValueForOption(option: CommandLineOption) {
|
|
|
|
switch (option.type) {
|
|
|
|
case "number":
|
|
|
|
return 1;
|
|
|
|
case "boolean":
|
|
|
|
return true;
|
|
|
|
case "string":
|
|
|
|
return option.isFilePath ? "./" : "";
|
|
|
|
case "list":
|
|
|
|
return [];
|
|
|
|
case "object":
|
|
|
|
return {};
|
|
|
|
default:
|
|
|
|
return arrayFrom((<CommandLineOptionOfCustomType>option).type.keys())[0];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-03-16 00:08:32 +01:00
|
|
|
function makePadding(paddingLength: number): string {
|
|
|
|
return Array(paddingLength + 1).join(" ");
|
|
|
|
}
|
|
|
|
|
2017-02-09 04:07:15 +01:00
|
|
|
function writeConfigurations() {
|
2017-03-16 00:08:32 +01:00
|
|
|
// Filter applicable options to place in the file
|
2017-02-09 04:07:15 +01:00
|
|
|
const categorizedOptions = reduceLeft(
|
2017-03-22 20:01:08 +01:00
|
|
|
filter(optionDeclarations, o => o.category !== Diagnostics.Command_line_Options && o.category !== Diagnostics.Advanced_Options),
|
2017-02-09 04:07:15 +01:00
|
|
|
(memo, value) => {
|
|
|
|
if (value.category) {
|
2017-02-09 04:25:08 +01:00
|
|
|
const name = getLocaleSpecificMessage(value.category);
|
|
|
|
(memo[name] || (memo[name] = [])).push(value);
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
|
|
|
return memo;
|
|
|
|
}, <MapLike<CommandLineOption[]>>{});
|
|
|
|
|
2017-03-16 00:08:32 +01:00
|
|
|
// Serialize all options and thier descriptions
|
|
|
|
let marginLength = 0;
|
2017-02-09 04:07:15 +01:00
|
|
|
let seenKnownKeys = 0;
|
2017-03-16 00:08:32 +01:00
|
|
|
const nameColumn: string[] = [];
|
|
|
|
const descriptionColumn: string[] = [];
|
2017-04-11 23:18:11 +02:00
|
|
|
const knownKeysCount = getOwnKeys(configurations.compilerOptions).length;
|
2017-02-09 04:07:15 +01:00
|
|
|
for (const category in categorizedOptions) {
|
2017-03-16 00:08:32 +01:00
|
|
|
if (nameColumn.length !== 0) {
|
|
|
|
nameColumn.push("");
|
|
|
|
descriptionColumn.push("");
|
|
|
|
}
|
|
|
|
nameColumn.push(`/* ${category} */`);
|
|
|
|
descriptionColumn.push("");
|
2017-02-09 04:07:15 +01:00
|
|
|
for (const option of categorizedOptions[category]) {
|
2017-03-16 00:08:32 +01:00
|
|
|
let optionName;
|
2017-03-16 00:41:39 +01:00
|
|
|
if (hasProperty(configurations.compilerOptions, option.name)) {
|
2017-04-11 23:18:11 +02:00
|
|
|
optionName = `"${option.name}": ${JSON.stringify(configurations.compilerOptions[option.name])}${(seenKnownKeys += 1) === knownKeysCount ? "" : ","}`;
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
|
|
|
else {
|
2017-03-16 00:08:32 +01:00
|
|
|
optionName = `// "${option.name}": ${JSON.stringify(getDefaultValueForOption(option))},`;
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
2017-03-16 00:08:32 +01:00
|
|
|
nameColumn.push(optionName);
|
|
|
|
descriptionColumn.push(`/* ${option.description && getLocaleSpecificMessage(option.description) || option.name} */`);
|
|
|
|
marginLength = Math.max(optionName.length, marginLength);
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
2017-03-16 00:08:32 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Write the output
|
|
|
|
const tab = makePadding(2);
|
|
|
|
const result: string[] = [];
|
|
|
|
result.push(`{`);
|
|
|
|
result.push(`${tab}"compilerOptions": {`);
|
|
|
|
// Print out each row, aligning all the descriptions on the same column.
|
|
|
|
for (let i = 0; i < nameColumn.length; i++) {
|
|
|
|
const optionName = nameColumn[i];
|
|
|
|
const description = descriptionColumn[i];
|
2017-06-01 22:43:44 +02:00
|
|
|
result.push(optionName && `${tab}${tab}${optionName}${ description && (makePadding(marginLength - optionName.length + 2) + description)}`);
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
|
|
|
if (configurations.files && configurations.files.length) {
|
2017-03-16 00:08:32 +01:00
|
|
|
result.push(`${tab}},`);
|
|
|
|
result.push(`${tab}"files": [`);
|
2017-02-09 04:07:15 +01:00
|
|
|
for (let i = 0; i < configurations.files.length; i++) {
|
2017-03-16 00:08:32 +01:00
|
|
|
result.push(`${tab}${tab}${JSON.stringify(configurations.files[i])}${i === configurations.files.length - 1 ? "" : ","}`);
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
2017-03-16 00:08:32 +01:00
|
|
|
result.push(`${tab}]`);
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
|
|
|
else {
|
2017-03-16 00:08:32 +01:00
|
|
|
result.push(`${tab}}`);
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
2017-03-16 00:08:32 +01:00
|
|
|
result.push(`}`);
|
2017-02-09 04:07:15 +01:00
|
|
|
|
2017-04-11 23:23:26 +02:00
|
|
|
return result.join(newLine);
|
2017-02-09 04:07:15 +01:00
|
|
|
}
|
2016-08-18 00:23:28 +02:00
|
|
|
}
|
|
|
|
|
2015-10-29 12:56:13 +01:00
|
|
|
/**
|
|
|
|
* Remove the comments from a json like text.
|
|
|
|
* Comments can be single line comments (starting with # or //) or multiline comments using / * * /
|
|
|
|
*
|
|
|
|
* This method replace comment content by whitespace rather than completely remove them to keep positions in json parsing error reporting accurate.
|
|
|
|
*/
|
|
|
|
function removeComments(jsonText: string): string {
|
2015-10-31 23:16:04 +01:00
|
|
|
let output = "";
|
2015-11-04 23:02:33 +01:00
|
|
|
const scanner = createScanner(ScriptTarget.ES5, /* skipTrivia */ false, LanguageVariant.Standard, jsonText);
|
2015-10-31 23:16:04 +01:00
|
|
|
let token: SyntaxKind;
|
|
|
|
while ((token = scanner.scan()) !== SyntaxKind.EndOfFileToken) {
|
|
|
|
switch (token) {
|
|
|
|
case SyntaxKind.SingleLineCommentTrivia:
|
|
|
|
case SyntaxKind.MultiLineCommentTrivia:
|
2015-11-01 15:31:16 +01:00
|
|
|
// replace comments with whitespace to preserve original character positions
|
|
|
|
output += scanner.getTokenText().replace(/\S/g, " ");
|
2015-10-31 23:16:04 +01:00
|
|
|
break;
|
|
|
|
default:
|
|
|
|
output += scanner.getTokenText();
|
|
|
|
break;
|
2015-10-29 12:56:13 +01:00
|
|
|
}
|
2015-10-31 23:16:04 +01:00
|
|
|
}
|
|
|
|
return output;
|
2015-10-29 12:56:13 +01:00
|
|
|
}
|
|
|
|
|
2015-03-31 19:52:21 +02:00
|
|
|
/**
|
2017-04-03 18:32:39 +02:00
|
|
|
* Parse the contents of a config file (tsconfig.json).
|
|
|
|
* @param json The contents of the config file to parse
|
|
|
|
* @param host Instance of ParseConfigHost used to enumerate files in folder.
|
|
|
|
* @param basePath A root directory to resolve relative path entries in the config
|
|
|
|
* file to. e.g. outDir
|
2017-04-11 22:57:21 +02:00
|
|
|
* @param resolutionStack Only present for backwards-compatibility. Should be empty.
|
2017-04-03 18:32:39 +02:00
|
|
|
*/
|
2017-04-11 22:57:21 +02:00
|
|
|
export function parseJsonConfigFileContent(
|
|
|
|
json: any,
|
|
|
|
host: ParseConfigHost,
|
|
|
|
basePath: string,
|
|
|
|
existingOptions: CompilerOptions = {},
|
|
|
|
configFileName?: string,
|
|
|
|
resolutionStack: Path[] = [],
|
|
|
|
extraFileExtensions: JsFileExtensionInfo[] = [],
|
|
|
|
): ParsedCommandLine {
|
2016-03-10 20:14:29 +01:00
|
|
|
const errors: Diagnostic[] = [];
|
2016-07-25 23:48:41 +02:00
|
|
|
|
2017-04-11 22:57:21 +02:00
|
|
|
let options = (() => {
|
2017-05-08 20:00:58 +02:00
|
|
|
const { include, exclude, files, options, compileOnSave } = parseConfig(json, host, basePath, configFileName, resolutionStack, errors);
|
2017-04-13 00:11:16 +02:00
|
|
|
if (include) { json.include = include; }
|
|
|
|
if (exclude) { json.exclude = exclude; }
|
|
|
|
if (files) { json.files = files; }
|
2017-05-08 20:00:58 +02:00
|
|
|
if (compileOnSave !== undefined) { json.compileOnSave = compileOnSave; }
|
2017-04-11 22:57:21 +02:00
|
|
|
return options;
|
|
|
|
})();
|
|
|
|
|
|
|
|
options = extend(existingOptions, options);
|
|
|
|
options.configFilePath = configFileName;
|
|
|
|
|
2016-11-22 23:47:44 +01:00
|
|
|
// typingOptions has been deprecated and is only supported for backward compatibility purposes.
|
|
|
|
// It should be removed in future releases - use typeAcquisition instead.
|
2016-11-21 22:42:42 +01:00
|
|
|
const jsonOptions = json["typeAcquisition"] || json["typingOptions"];
|
|
|
|
const typeAcquisition: TypeAcquisition = convertTypeAcquisitionFromJsonWorker(jsonOptions, basePath, errors, configFileName);
|
2016-05-04 23:50:58 +02:00
|
|
|
|
2017-04-11 22:57:21 +02:00
|
|
|
const { fileNames, wildcardDirectories } = getFileNames();
|
2016-08-24 01:11:52 +02:00
|
|
|
const compileOnSave = convertCompileOnSaveOptionFromJson(json, basePath, errors);
|
2015-01-15 22:22:23 +01:00
|
|
|
|
|
|
|
return {
|
2015-10-17 23:35:28 +02:00
|
|
|
options,
|
2015-12-07 23:58:13 +01:00
|
|
|
fileNames,
|
2016-11-19 02:46:06 +01:00
|
|
|
typeAcquisition,
|
2016-05-06 19:12:12 +02:00
|
|
|
raw: json,
|
2015-12-07 23:58:13 +01:00
|
|
|
errors,
|
2016-08-24 01:11:52 +02:00
|
|
|
wildcardDirectories,
|
|
|
|
compileOnSave
|
2015-01-15 22:22:23 +01:00
|
|
|
};
|
|
|
|
|
2017-04-11 22:57:21 +02:00
|
|
|
function getFileNames(): ExpandResult {
|
2015-12-03 19:44:24 +01:00
|
|
|
let fileNames: string[];
|
2015-01-16 02:12:45 +01:00
|
|
|
if (hasProperty(json, "files")) {
|
2015-12-03 19:44:24 +01:00
|
|
|
if (isArray(json["files"])) {
|
|
|
|
fileNames = <string[]>json["files"];
|
2016-10-24 20:00:32 +02:00
|
|
|
if (fileNames.length === 0) {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.The_files_list_in_config_file_0_is_empty, configFileName || "tsconfig.json"));
|
|
|
|
}
|
2015-01-16 02:12:45 +01:00
|
|
|
}
|
2015-07-29 02:59:17 +02:00
|
|
|
else {
|
2015-10-01 01:10:52 +02:00
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Compiler_option_0_requires_a_value_of_type_1, "files", "Array"));
|
2015-07-29 02:59:17 +02:00
|
|
|
}
|
2015-01-16 02:12:45 +01:00
|
|
|
}
|
2015-09-22 00:39:53 +02:00
|
|
|
|
2015-12-03 19:44:24 +01:00
|
|
|
let includeSpecs: string[];
|
|
|
|
if (hasProperty(json, "include")) {
|
|
|
|
if (isArray(json["include"])) {
|
|
|
|
includeSpecs = <string[]>json["include"];
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Compiler_option_0_requires_a_value_of_type_1, "include", "Array"));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
let excludeSpecs: string[];
|
|
|
|
if (hasProperty(json, "exclude")) {
|
|
|
|
if (isArray(json["exclude"])) {
|
|
|
|
excludeSpecs = <string[]>json["exclude"];
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Compiler_option_0_requires_a_value_of_type_1, "exclude", "Array"));
|
|
|
|
}
|
|
|
|
}
|
2016-05-26 02:07:36 +02:00
|
|
|
else {
|
2016-11-18 15:55:03 +01:00
|
|
|
// If no includes were specified, exclude common package folders and the outDir
|
|
|
|
excludeSpecs = includeSpecs ? [] : ["node_modules", "bower_components", "jspm_packages"];
|
2016-05-26 02:07:36 +02:00
|
|
|
|
2016-09-01 21:57:23 +02:00
|
|
|
const outDir = json["compilerOptions"] && json["compilerOptions"]["outDir"];
|
|
|
|
if (outDir) {
|
|
|
|
excludeSpecs.push(outDir);
|
|
|
|
}
|
2016-05-26 02:07:36 +02:00
|
|
|
}
|
2015-11-12 22:23:53 +01:00
|
|
|
|
2015-12-03 19:44:24 +01:00
|
|
|
if (fileNames === undefined && includeSpecs === undefined) {
|
2015-12-07 23:58:13 +01:00
|
|
|
includeSpecs = ["**/*"];
|
2015-01-15 22:22:23 +01:00
|
|
|
}
|
2015-12-03 19:44:24 +01:00
|
|
|
|
2016-12-09 22:36:43 +01:00
|
|
|
const result = matchFileNames(fileNames, includeSpecs, excludeSpecs, basePath, options, host, errors, extraFileExtensions);
|
2016-10-24 20:00:32 +02:00
|
|
|
|
|
|
|
if (result.fileNames.length === 0 && !hasProperty(json, "files") && resolutionStack.length === 0) {
|
|
|
|
errors.push(
|
|
|
|
createCompilerDiagnostic(
|
|
|
|
Diagnostics.No_inputs_were_found_in_config_file_0_Specified_include_paths_were_1_and_exclude_paths_were_2,
|
|
|
|
configFileName || "tsconfig.json",
|
|
|
|
JSON.stringify(includeSpecs || []),
|
|
|
|
JSON.stringify(excludeSpecs || [])));
|
|
|
|
}
|
|
|
|
|
|
|
|
return result;
|
2015-01-15 22:22:23 +01:00
|
|
|
}
|
|
|
|
}
|
2015-10-17 23:35:28 +02:00
|
|
|
|
2017-05-08 20:00:58 +02:00
|
|
|
interface ParsedTsconfig {
|
|
|
|
include: string[] | undefined;
|
|
|
|
exclude: string[] | undefined;
|
|
|
|
files: string[] | undefined;
|
|
|
|
options: CompilerOptions;
|
|
|
|
compileOnSave: boolean | undefined;
|
|
|
|
}
|
2017-04-11 22:57:21 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* This *just* extracts options/include/exclude/files out of a config file.
|
|
|
|
* It does *not* resolve the included files.
|
|
|
|
*/
|
|
|
|
function parseConfig(
|
|
|
|
json: any,
|
|
|
|
host: ParseConfigHost,
|
|
|
|
basePath: string,
|
|
|
|
configFileName: string,
|
2017-04-13 00:11:16 +02:00
|
|
|
resolutionStack: Path[],
|
2017-04-11 22:57:21 +02:00
|
|
|
errors: Diagnostic[],
|
|
|
|
): ParsedTsconfig {
|
|
|
|
|
|
|
|
basePath = normalizeSlashes(basePath);
|
|
|
|
const getCanonicalFileName = createGetCanonicalFileName(host.useCaseSensitiveFileNames);
|
|
|
|
const resolvedPath = toPath(configFileName || "", basePath, getCanonicalFileName);
|
|
|
|
|
|
|
|
if (resolutionStack.indexOf(resolvedPath) >= 0) {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Circularity_detected_while_resolving_configuration_Colon_0, [...resolutionStack, resolvedPath].join(" -> ")));
|
2017-05-08 20:00:58 +02:00
|
|
|
return { include: undefined, exclude: undefined, files: undefined, options: {}, compileOnSave: undefined };
|
2017-04-11 22:57:21 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
if (hasProperty(json, "excludes")) {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Unknown_option_excludes_Did_you_mean_exclude));
|
|
|
|
}
|
|
|
|
|
|
|
|
let options: CompilerOptions = convertCompilerOptionsFromJsonWorker(json.compilerOptions, basePath, errors, configFileName);
|
|
|
|
let include: string[] | undefined = json.include, exclude: string[] | undefined = json.exclude, files: string[] | undefined = json.files;
|
2017-05-08 20:00:58 +02:00
|
|
|
let compileOnSave: boolean | undefined = json.compileOnSave;
|
2017-04-11 22:57:21 +02:00
|
|
|
|
|
|
|
if (json.extends) {
|
|
|
|
// copy the resolution stack so it is never reused between branches in potential diamond-problem scenarios.
|
|
|
|
resolutionStack = resolutionStack.concat([resolvedPath]);
|
|
|
|
const base = getExtendedConfig(json.extends, host, basePath, getCanonicalFileName, resolutionStack, errors);
|
|
|
|
if (base) {
|
|
|
|
include = include || base.include;
|
|
|
|
exclude = exclude || base.exclude;
|
|
|
|
files = files || base.files;
|
2017-05-08 20:00:58 +02:00
|
|
|
if (compileOnSave === undefined) {
|
|
|
|
compileOnSave = base.compileOnSave;
|
|
|
|
}
|
2017-04-11 22:57:21 +02:00
|
|
|
options = assign({}, base.options, options);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-05-08 20:00:58 +02:00
|
|
|
return { include, exclude, files, options, compileOnSave };
|
2017-04-11 22:57:21 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
function getExtendedConfig(
|
|
|
|
extended: any, // Usually a string.
|
|
|
|
host: ts.ParseConfigHost,
|
|
|
|
basePath: string,
|
|
|
|
getCanonicalFileName: (fileName: string) => string,
|
|
|
|
resolutionStack: Path[],
|
|
|
|
errors: Diagnostic[],
|
|
|
|
): ParsedTsconfig | undefined {
|
|
|
|
if (typeof extended !== "string") {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Compiler_option_0_requires_a_value_of_type_1, "extends", "string"));
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
|
2017-04-13 00:11:16 +02:00
|
|
|
extended = normalizeSlashes(extended);
|
|
|
|
|
2017-04-11 22:57:21 +02:00
|
|
|
// If the path isn't a rooted or relative path, don't try to resolve it (we reserve the right to special case module-id like paths in the future)
|
2017-04-13 00:11:16 +02:00
|
|
|
if (!(isRootedDiskPath(extended) || startsWith(extended, "./") || startsWith(extended, "../"))) {
|
2017-04-11 22:57:21 +02:00
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.A_path_in_an_extends_option_must_be_relative_or_rooted_but_0_is_not, extended));
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
|
|
|
|
let extendedConfigPath = toPath(extended, basePath, getCanonicalFileName);
|
|
|
|
if (!host.fileExists(extendedConfigPath) && !endsWith(extendedConfigPath, ".json")) {
|
|
|
|
extendedConfigPath = extendedConfigPath + ".json" as Path;
|
|
|
|
if (!host.fileExists(extendedConfigPath)) {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.File_0_does_not_exist, extended));
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const extendedResult = readConfigFile(extendedConfigPath, path => host.readFile(path));
|
|
|
|
if (extendedResult.error) {
|
|
|
|
errors.push(extendedResult.error);
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
|
|
|
|
const extendedDirname = getDirectoryPath(extendedConfigPath);
|
|
|
|
const relativeDifference = convertToRelativePath(extendedDirname, basePath, getCanonicalFileName);
|
|
|
|
const updatePath: (path: string) => string = path => isRootedDiskPath(path) ? path : combinePaths(relativeDifference, path);
|
2017-05-08 20:00:58 +02:00
|
|
|
const { include, exclude, files, options, compileOnSave } = parseConfig(extendedResult.config, host, extendedDirname, getBaseFileName(extendedConfigPath), resolutionStack, errors);
|
|
|
|
return { include: map(include, updatePath), exclude: map(exclude, updatePath), files: map(files, updatePath), compileOnSave, options };
|
2017-04-11 22:57:21 +02:00
|
|
|
}
|
|
|
|
|
2016-08-24 01:11:52 +02:00
|
|
|
export function convertCompileOnSaveOptionFromJson(jsonOption: any, basePath: string, errors: Diagnostic[]): boolean {
|
|
|
|
if (!hasProperty(jsonOption, compileOnSaveCommandLineOption.name)) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
const result = convertJsonOption(compileOnSaveCommandLineOption, jsonOption["compileOnSave"], basePath, errors);
|
|
|
|
if (typeof result === "boolean" && result) {
|
|
|
|
return result;
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2016-03-20 04:59:32 +01:00
|
|
|
export function convertCompilerOptionsFromJson(jsonOptions: any, basePath: string, configFileName?: string): { options: CompilerOptions, errors: Diagnostic[] } {
|
2015-11-04 23:02:33 +01:00
|
|
|
const errors: Diagnostic[] = [];
|
2016-03-20 04:59:32 +01:00
|
|
|
const options = convertCompilerOptionsFromJsonWorker(jsonOptions, basePath, errors, configFileName);
|
|
|
|
return { options, errors };
|
|
|
|
}
|
|
|
|
|
2016-11-19 02:46:06 +01:00
|
|
|
export function convertTypeAcquisitionFromJson(jsonOptions: any, basePath: string, configFileName?: string): { options: TypeAcquisition, errors: Diagnostic[] } {
|
2016-03-20 04:59:32 +01:00
|
|
|
const errors: Diagnostic[] = [];
|
2016-11-19 02:46:06 +01:00
|
|
|
const options = convertTypeAcquisitionFromJsonWorker(jsonOptions, basePath, errors, configFileName);
|
2016-03-20 04:59:32 +01:00
|
|
|
return { options, errors };
|
|
|
|
}
|
|
|
|
|
|
|
|
function convertCompilerOptionsFromJsonWorker(jsonOptions: any,
|
2016-03-17 00:35:51 +01:00
|
|
|
basePath: string, errors: Diagnostic[], configFileName?: string): CompilerOptions {
|
2016-03-16 00:30:11 +01:00
|
|
|
|
2016-09-22 23:55:58 +02:00
|
|
|
const options: CompilerOptions = getBaseFileName(configFileName) === "jsconfig.json"
|
2016-10-12 04:19:40 +02:00
|
|
|
? { allowJs: true, maxNodeModuleJsDepth: 2, allowSyntheticDefaultImports: true, skipLibCheck: true }
|
2016-09-22 23:55:58 +02:00
|
|
|
: {};
|
2016-03-20 04:59:32 +01:00
|
|
|
convertOptionsFromJson(optionDeclarations, jsonOptions, basePath, options, Diagnostics.Unknown_compiler_option_0, errors);
|
2016-03-16 00:30:11 +01:00
|
|
|
return options;
|
|
|
|
}
|
|
|
|
|
2016-11-19 02:46:06 +01:00
|
|
|
function convertTypeAcquisitionFromJsonWorker(jsonOptions: any,
|
|
|
|
basePath: string, errors: Diagnostic[], configFileName?: string): TypeAcquisition {
|
2016-03-16 00:30:11 +01:00
|
|
|
|
2016-11-19 02:46:06 +01:00
|
|
|
const options: TypeAcquisition = { enable: getBaseFileName(configFileName) === "jsconfig.json", include: [], exclude: [] };
|
2016-11-22 23:47:44 +01:00
|
|
|
const typeAcquisition = convertEnableAutoDiscoveryToEnable(jsonOptions);
|
|
|
|
convertOptionsFromJson(typeAcquisitionDeclarations, typeAcquisition, basePath, options, Diagnostics.Unknown_type_acquisition_option_0, errors);
|
2016-03-16 00:30:11 +01:00
|
|
|
|
|
|
|
return options;
|
|
|
|
}
|
|
|
|
|
2016-03-20 04:59:32 +01:00
|
|
|
function convertOptionsFromJson(optionDeclarations: CommandLineOption[], jsonOptions: any, basePath: string,
|
2016-11-19 02:46:06 +01:00
|
|
|
defaultOptions: CompilerOptions | TypeAcquisition, diagnosticMessage: DiagnosticMessage, errors: Diagnostic[]) {
|
2015-10-17 23:35:28 +02:00
|
|
|
|
|
|
|
if (!jsonOptions) {
|
2016-05-03 23:52:41 +02:00
|
|
|
return;
|
2015-10-17 23:35:28 +02:00
|
|
|
}
|
|
|
|
|
2015-11-04 23:02:33 +01:00
|
|
|
const optionNameMap = arrayToMap(optionDeclarations, opt => opt.name);
|
2015-10-17 23:35:28 +02:00
|
|
|
|
2015-11-04 23:02:33 +01:00
|
|
|
for (const id in jsonOptions) {
|
2016-12-05 23:13:32 +01:00
|
|
|
const opt = optionNameMap.get(id);
|
|
|
|
if (opt) {
|
2016-03-16 00:30:11 +01:00
|
|
|
defaultOptions[opt.name] = convertJsonOption(opt, jsonOptions[id], basePath, errors);
|
2015-10-17 23:35:28 +02:00
|
|
|
}
|
|
|
|
else {
|
2016-03-16 00:30:11 +01:00
|
|
|
errors.push(createCompilerDiagnostic(diagnosticMessage, id));
|
2015-10-17 23:35:28 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-03-17 00:35:51 +01:00
|
|
|
function convertJsonOption(opt: CommandLineOption, value: any, basePath: string, errors: Diagnostic[]): CompilerOptionsValue {
|
2016-03-10 20:14:29 +01:00
|
|
|
const optType = opt.type;
|
|
|
|
const expectedType = typeof optType === "string" ? optType : "string";
|
|
|
|
if (optType === "list" && isArray(value)) {
|
|
|
|
return convertJsonOptionOfListType(<CommandLineOptionOfListType>opt, value, basePath, errors);
|
2016-02-23 04:00:06 +01:00
|
|
|
}
|
2016-03-10 20:14:29 +01:00
|
|
|
else if (typeof value === expectedType) {
|
|
|
|
if (typeof optType !== "string") {
|
|
|
|
return convertJsonOptionOfCustomType(<CommandLineOptionOfCustomType>opt, value, errors);
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
if (opt.isFilePath) {
|
|
|
|
value = normalizePath(combinePaths(basePath, value));
|
|
|
|
if (value === "") {
|
|
|
|
value = ".";
|
|
|
|
}
|
2016-02-23 04:00:06 +01:00
|
|
|
}
|
|
|
|
}
|
2016-03-10 20:14:29 +01:00
|
|
|
return value;
|
2016-02-23 04:00:06 +01:00
|
|
|
}
|
2016-03-10 20:14:29 +01:00
|
|
|
else {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.Compiler_option_0_requires_a_value_of_type_1, opt.name, expectedType));
|
2016-02-23 04:00:06 +01:00
|
|
|
}
|
2016-03-10 20:14:29 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
function convertJsonOptionOfCustomType(opt: CommandLineOptionOfCustomType, value: string, errors: Diagnostic[]) {
|
|
|
|
const key = value.toLowerCase();
|
2016-12-05 23:13:32 +01:00
|
|
|
const val = opt.type.get(key);
|
|
|
|
if (val !== undefined) {
|
|
|
|
return val;
|
2016-03-10 20:14:29 +01:00
|
|
|
}
|
|
|
|
else {
|
2016-03-16 21:49:36 +01:00
|
|
|
errors.push(createCompilerDiagnosticForInvalidCustomType(opt));
|
2016-03-10 20:14:29 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
function convertJsonOptionOfListType(option: CommandLineOptionOfListType, values: any[], basePath: string, errors: Diagnostic[]): any[] {
|
2016-03-16 23:29:13 +01:00
|
|
|
return filter(map(values, v => convertJsonOption(option.element, v, basePath, errors)), v => !!v);
|
2016-02-23 04:00:06 +01:00
|
|
|
}
|
2016-05-03 23:52:41 +02:00
|
|
|
|
|
|
|
function trimString(s: string) {
|
|
|
|
return typeof s.trim === "function" ? s.trim() : s.replace(/^[\s]+|[\s]+$/g, "");
|
2015-10-17 23:35:28 +02:00
|
|
|
}
|
2015-12-03 19:44:24 +01:00
|
|
|
|
2015-12-17 00:49:31 +01:00
|
|
|
/**
|
|
|
|
* Tests for a path that ends in a recursive directory wildcard.
|
2016-01-04 20:37:25 +01:00
|
|
|
* Matches **, \**, **\, and \**\, but not a**b.
|
2015-12-17 00:49:31 +01:00
|
|
|
*
|
2016-01-04 20:37:25 +01:00
|
|
|
* NOTE: used \ in place of / above to avoid issues with multiline comments.
|
2015-12-17 00:49:31 +01:00
|
|
|
*
|
|
|
|
* Breakdown:
|
|
|
|
* (^|\/) # matches either the beginning of the string or a directory separator.
|
|
|
|
* \*\* # matches the recursive directory wildcard "**".
|
|
|
|
* \/?$ # matches an optional trailing directory separator at the end of the string.
|
|
|
|
*/
|
2015-12-15 00:21:12 +01:00
|
|
|
const invalidTrailingRecursionPattern = /(^|\/)\*\*\/?$/;
|
2015-12-17 00:49:31 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Tests for a path with multiple recursive directory wildcards.
|
2016-01-04 20:37:25 +01:00
|
|
|
* Matches **\** and **\a\**, but not **\a**b.
|
2015-12-17 00:49:31 +01:00
|
|
|
*
|
2016-01-04 20:37:25 +01:00
|
|
|
* NOTE: used \ in place of / above to avoid issues with multiline comments.
|
2015-12-17 00:49:31 +01:00
|
|
|
*
|
|
|
|
* Breakdown:
|
|
|
|
* (^|\/) # matches either the beginning of the string or a directory separator.
|
|
|
|
* \*\*\/ # matches a recursive directory wildcard "**" followed by a directory separator.
|
|
|
|
* (.*\/)? # optionally matches any number of characters followed by a directory separator.
|
|
|
|
* \*\* # matches a recursive directory wildcard "**"
|
|
|
|
* ($|\/) # matches either the end of the string or a directory separator.
|
|
|
|
*/
|
2015-12-15 00:21:12 +01:00
|
|
|
const invalidMultipleRecursionPatterns = /(^|\/)\*\*\/(.*\/)?\*\*($|\/)/;
|
2015-12-07 23:58:13 +01:00
|
|
|
|
2016-07-01 18:59:07 +02:00
|
|
|
/**
|
|
|
|
* Tests for a path where .. appears after a recursive directory wildcard.
|
|
|
|
* Matches **\..\*, **\a\..\*, and **\.., but not ..\**\*
|
|
|
|
*
|
|
|
|
* NOTE: used \ in place of / above to avoid issues with multiline comments.
|
|
|
|
*
|
|
|
|
* Breakdown:
|
|
|
|
* (^|\/) # matches either the beginning of the string or a directory separator.
|
|
|
|
* \*\*\/ # matches a recursive directory wildcard "**" followed by a directory separator.
|
|
|
|
* (.*\/)? # optionally matches any number of characters followed by a directory separator.
|
|
|
|
* \.\. # matches a parent directory path component ".."
|
|
|
|
* ($|\/) # matches either the end of the string or a directory separator.
|
|
|
|
*/
|
|
|
|
const invalidDotDotAfterRecursiveWildcardPattern = /(^|\/)\*\*\/(.*\/)?\.\.($|\/)/;
|
|
|
|
|
2015-12-17 00:49:31 +01:00
|
|
|
/**
|
|
|
|
* Tests for a path containing a wildcard character in a directory component of the path.
|
2016-01-04 20:37:25 +01:00
|
|
|
* Matches \*\, \?\, and \a*b\, but not \a\ or \a\*.
|
2015-12-17 00:49:31 +01:00
|
|
|
*
|
2016-01-04 20:37:25 +01:00
|
|
|
* NOTE: used \ in place of / above to avoid issues with multiline comments.
|
2015-12-17 00:49:31 +01:00
|
|
|
*
|
|
|
|
* Breakdown:
|
|
|
|
* \/ # matches a directory separator.
|
|
|
|
* [^/]*? # matches any number of characters excluding directory separators (non-greedy).
|
|
|
|
* [*?] # matches either a wildcard character (* or ?)
|
|
|
|
* [^/]* # matches any number of characters excluding directory separators (greedy).
|
|
|
|
* \/ # matches a directory separator.
|
|
|
|
*/
|
|
|
|
const watchRecursivePattern = /\/[^/]*?[*?][^/]*\//;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Matches the portion of a wildcard path that does not contain wildcards.
|
2016-01-04 20:37:25 +01:00
|
|
|
* Matches \a of \a\*, or \a\b\c of \a\b\c\?\d.
|
|
|
|
*
|
|
|
|
* NOTE: used \ in place of / above to avoid issues with multiline comments.
|
2015-12-17 00:49:31 +01:00
|
|
|
*
|
|
|
|
* Breakdown:
|
|
|
|
* ^ # matches the beginning of the string
|
|
|
|
* [^*?]* # matches any number of non-wildcard characters
|
|
|
|
* (?=\/[^/]*[*?]) # lookahead that matches a directory separator followed by
|
|
|
|
* # a path component that contains at least one wildcard character (* or ?).
|
|
|
|
*/
|
|
|
|
const wildcardDirectoryPattern = /^[^*?]*(?=\/[^/]*[*?])/;
|
|
|
|
|
2015-12-03 19:44:24 +01:00
|
|
|
/**
|
|
|
|
* Expands an array of file specifications.
|
|
|
|
*
|
|
|
|
* @param fileNames The literal file names to include.
|
2015-12-16 22:42:17 +01:00
|
|
|
* @param include The wildcard file specifications to include.
|
|
|
|
* @param exclude The wildcard file specifications to exclude.
|
2015-12-03 19:44:24 +01:00
|
|
|
* @param basePath The base path for any relative file specifications.
|
|
|
|
* @param options Compiler options.
|
|
|
|
* @param host The host used to resolve files and directories.
|
|
|
|
* @param errors An array for diagnostic reporting.
|
|
|
|
*/
|
2017-02-13 21:19:33 +01:00
|
|
|
function matchFileNames(fileNames: string[], include: string[], exclude: string[], basePath: string, options: CompilerOptions, host: ParseConfigHost, errors: Diagnostic[], extraFileExtensions: JsFileExtensionInfo[]): ExpandResult {
|
2015-12-03 19:44:24 +01:00
|
|
|
basePath = normalizePath(basePath);
|
|
|
|
|
2015-12-07 23:58:13 +01:00
|
|
|
// The exclude spec list is converted into a regular expression, which allows us to quickly
|
|
|
|
// test whether a file or directory should be excluded before recursively traversing the
|
|
|
|
// file system.
|
|
|
|
const keyMapper = host.useCaseSensitiveFileNames ? caseSensitiveKeyMapper : caseInsensitiveKeyMapper;
|
|
|
|
|
|
|
|
// Literal file names (provided via the "files" array in tsconfig.json) are stored in a
|
2015-12-08 19:54:23 +01:00
|
|
|
// file map with a possibly case insensitive key. We use this map later when when including
|
2015-12-07 23:58:13 +01:00
|
|
|
// wildcard paths.
|
2016-08-11 01:47:06 +02:00
|
|
|
const literalFileMap = createMap<string>();
|
2015-12-07 23:58:13 +01:00
|
|
|
|
2015-12-08 19:54:23 +01:00
|
|
|
// Wildcard paths (provided via the "includes" array in tsconfig.json) are stored in a
|
|
|
|
// file map with a possibly case insensitive key. We use this map to store paths matched
|
2015-12-07 23:58:13 +01:00
|
|
|
// via wildcard, and to handle extension priority.
|
2016-08-11 01:47:06 +02:00
|
|
|
const wildcardFileMap = createMap<string>();
|
2015-12-07 23:58:13 +01:00
|
|
|
|
2015-12-16 22:42:17 +01:00
|
|
|
if (include) {
|
|
|
|
include = validateSpecs(include, errors, /*allowTrailingRecursion*/ false);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (exclude) {
|
|
|
|
exclude = validateSpecs(exclude, errors, /*allowTrailingRecursion*/ true);
|
|
|
|
}
|
|
|
|
|
2015-12-07 23:58:13 +01:00
|
|
|
// Wildcard directories (provided as part of a wildcard path) are stored in a
|
|
|
|
// file map that marks whether it was a regular wildcard match (with a `*` or `?` token),
|
|
|
|
// or a recursive directory. This information is used by filesystem watchers to monitor for
|
|
|
|
// new entries in these paths.
|
2016-12-05 23:13:32 +01:00
|
|
|
const wildcardDirectories = getWildcardDirectories(include, exclude, basePath, host.useCaseSensitiveFileNames);
|
2015-12-07 23:58:13 +01:00
|
|
|
|
2015-12-08 19:54:23 +01:00
|
|
|
// Rather than requery this for each file and filespec, we query the supported extensions
|
2015-12-07 23:58:13 +01:00
|
|
|
// once and store it on the expansion context.
|
2016-12-09 22:36:43 +01:00
|
|
|
const supportedExtensions = getSupportedExtensions(options, extraFileExtensions);
|
2015-12-07 23:58:13 +01:00
|
|
|
|
|
|
|
// Literal files are always included verbatim. An "include" or "exclude" specification cannot
|
|
|
|
// remove a literal file.
|
2015-12-03 19:44:24 +01:00
|
|
|
if (fileNames) {
|
|
|
|
for (const fileName of fileNames) {
|
2015-12-15 00:21:12 +01:00
|
|
|
const file = combinePaths(basePath, fileName);
|
2016-12-05 23:13:32 +01:00
|
|
|
literalFileMap.set(keyMapper(file), file);
|
2015-12-03 19:44:24 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-16 22:42:17 +01:00
|
|
|
if (include && include.length > 0) {
|
|
|
|
for (const file of host.readDirectory(basePath, supportedExtensions, exclude, include)) {
|
2015-12-15 00:21:12 +01:00
|
|
|
// If we have already included a literal or wildcard path with a
|
|
|
|
// higher priority extension, we should skip this file.
|
|
|
|
//
|
|
|
|
// This handles cases where we may encounter both <file>.ts and
|
|
|
|
// <file>.d.ts (or <file>.js if "allowJs" is enabled) in the same
|
|
|
|
// directory when they are compilation outputs.
|
|
|
|
if (hasFileWithHigherPriorityExtension(file, literalFileMap, wildcardFileMap, supportedExtensions, keyMapper)) {
|
2015-12-07 23:58:13 +01:00
|
|
|
continue;
|
|
|
|
}
|
2015-12-03 19:44:24 +01:00
|
|
|
|
2015-12-15 00:21:12 +01:00
|
|
|
// We may have included a wildcard path with a lower priority
|
|
|
|
// extension due to the user-defined order of entries in the
|
|
|
|
// "include" array. If there is a lower priority extension in the
|
|
|
|
// same directory, we should remove it.
|
|
|
|
removeWildcardFilesWithLowerPriorityExtension(file, wildcardFileMap, supportedExtensions, keyMapper);
|
2015-12-03 19:44:24 +01:00
|
|
|
|
2015-12-15 00:21:12 +01:00
|
|
|
const key = keyMapper(file);
|
2016-12-05 23:13:32 +01:00
|
|
|
if (!literalFileMap.has(key) && !wildcardFileMap.has(key)) {
|
|
|
|
wildcardFileMap.set(key, file);
|
2015-12-03 19:44:24 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2015-12-07 23:58:13 +01:00
|
|
|
|
2016-12-28 18:05:52 +01:00
|
|
|
const literalFiles = arrayFrom(literalFileMap.values());
|
|
|
|
const wildcardFiles = arrayFrom(wildcardFileMap.values());
|
2015-12-15 00:21:12 +01:00
|
|
|
return {
|
|
|
|
fileNames: literalFiles.concat(wildcardFiles),
|
|
|
|
wildcardDirectories
|
|
|
|
};
|
2015-12-03 19:44:24 +01:00
|
|
|
}
|
|
|
|
|
2015-12-15 00:21:12 +01:00
|
|
|
function validateSpecs(specs: string[], errors: Diagnostic[], allowTrailingRecursion: boolean) {
|
|
|
|
const validSpecs: string[] = [];
|
|
|
|
for (const spec of specs) {
|
|
|
|
if (!allowTrailingRecursion && invalidTrailingRecursionPattern.test(spec)) {
|
2015-12-16 22:42:17 +01:00
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.File_specification_cannot_end_in_a_recursive_directory_wildcard_Asterisk_Asterisk_Colon_0, spec));
|
2015-12-03 19:44:24 +01:00
|
|
|
}
|
2015-12-15 00:21:12 +01:00
|
|
|
else if (invalidMultipleRecursionPatterns.test(spec)) {
|
2015-12-16 22:42:17 +01:00
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.File_specification_cannot_contain_multiple_recursive_directory_wildcards_Asterisk_Asterisk_Colon_0, spec));
|
2015-12-07 23:58:13 +01:00
|
|
|
}
|
2016-07-01 18:59:07 +02:00
|
|
|
else if (invalidDotDotAfterRecursiveWildcardPattern.test(spec)) {
|
|
|
|
errors.push(createCompilerDiagnostic(Diagnostics.File_specification_cannot_contain_a_parent_directory_that_appears_after_a_recursive_directory_wildcard_Asterisk_Asterisk_Colon_0, spec));
|
|
|
|
}
|
2015-12-15 00:21:12 +01:00
|
|
|
else {
|
|
|
|
validSpecs.push(spec);
|
2015-12-07 23:58:13 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-15 00:21:12 +01:00
|
|
|
return validSpecs;
|
2015-12-07 23:58:13 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2015-12-15 00:21:12 +01:00
|
|
|
* Gets directories in a set of include patterns that should be watched for changes.
|
2015-12-07 23:58:13 +01:00
|
|
|
*/
|
2016-12-05 23:13:32 +01:00
|
|
|
function getWildcardDirectories(include: string[], exclude: string[], path: string, useCaseSensitiveFileNames: boolean): MapLike<WatchDirectoryFlags> {
|
2015-12-15 00:21:12 +01:00
|
|
|
// We watch a directory recursively if it contains a wildcard anywhere in a directory segment
|
|
|
|
// of the pattern:
|
|
|
|
//
|
|
|
|
// /a/b/**/d - Watch /a/b recursively to catch changes to any d in any subfolder recursively
|
|
|
|
// /a/b/*/d - Watch /a/b recursively to catch any d in any immediate subfolder, even if a new subfolder is added
|
2016-10-07 18:29:11 +02:00
|
|
|
// /a/b - Watch /a/b recursively to catch changes to anything in any recursive subfoler
|
2015-12-15 00:21:12 +01:00
|
|
|
//
|
|
|
|
// We watch a directory without recursion if it contains a wildcard in the file segment of
|
|
|
|
// the pattern:
|
|
|
|
//
|
|
|
|
// /a/b/* - Watch /a/b directly to catch any new file
|
|
|
|
// /a/b/a?z - Watch /a/b directly to catch any new file matching a?z
|
2016-05-31 19:11:04 +02:00
|
|
|
const rawExcludeRegex = getRegularExpressionForWildcard(exclude, path, "exclude");
|
|
|
|
const excludeRegex = rawExcludeRegex && new RegExp(rawExcludeRegex, useCaseSensitiveFileNames ? "" : "i");
|
2016-12-27 21:46:28 +01:00
|
|
|
const wildcardDirectories: ts.MapLike<WatchDirectoryFlags> = {};
|
2015-12-16 22:42:17 +01:00
|
|
|
if (include !== undefined) {
|
2015-12-15 00:21:12 +01:00
|
|
|
const recursiveKeys: string[] = [];
|
2015-12-16 22:42:17 +01:00
|
|
|
for (const file of include) {
|
2016-10-07 18:29:11 +02:00
|
|
|
const spec = normalizePath(combinePaths(path, file));
|
|
|
|
if (excludeRegex && excludeRegex.test(spec)) {
|
2015-12-16 22:42:17 +01:00
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
2016-10-07 18:29:11 +02:00
|
|
|
const match = getWildcardDirectoryFromSpec(spec, useCaseSensitiveFileNames);
|
2015-12-15 00:21:12 +01:00
|
|
|
if (match) {
|
2016-10-07 18:29:11 +02:00
|
|
|
const { key, flags } = match;
|
2016-08-15 21:03:39 +02:00
|
|
|
const existingFlags = wildcardDirectories[key];
|
2015-12-15 00:21:12 +01:00
|
|
|
if (existingFlags === undefined || existingFlags < flags) {
|
|
|
|
wildcardDirectories[key] = flags;
|
|
|
|
if (flags === WatchDirectoryFlags.Recursive) {
|
|
|
|
recursiveKeys.push(key);
|
|
|
|
}
|
|
|
|
}
|
2015-12-07 23:58:13 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-15 00:21:12 +01:00
|
|
|
// Remove any subpaths under an existing recursively watched directory.
|
2016-12-27 21:46:28 +01:00
|
|
|
for (const key in wildcardDirectories) if (hasProperty(wildcardDirectories, key)) {
|
2016-08-15 21:03:39 +02:00
|
|
|
for (const recursiveKey of recursiveKeys) {
|
|
|
|
if (key !== recursiveKey && containsPath(recursiveKey, key, path, !useCaseSensitiveFileNames)) {
|
|
|
|
delete wildcardDirectories[key];
|
2015-12-15 00:21:12 +01:00
|
|
|
}
|
|
|
|
}
|
2017-04-05 07:34:51 +02:00
|
|
|
}
|
2015-12-07 23:58:13 +01:00
|
|
|
}
|
|
|
|
|
2015-12-15 00:21:12 +01:00
|
|
|
return wildcardDirectories;
|
2015-12-07 23:58:13 +01:00
|
|
|
}
|
2015-12-03 19:44:24 +01:00
|
|
|
|
2016-10-07 18:29:11 +02:00
|
|
|
function getWildcardDirectoryFromSpec(spec: string, useCaseSensitiveFileNames: boolean): { key: string, flags: WatchDirectoryFlags } | undefined {
|
|
|
|
const match = wildcardDirectoryPattern.exec(spec);
|
2016-10-12 19:08:43 +02:00
|
|
|
if (match) {
|
|
|
|
return {
|
2016-10-07 18:29:11 +02:00
|
|
|
key: useCaseSensitiveFileNames ? match[0] : match[0].toLowerCase(),
|
|
|
|
flags: watchRecursivePattern.test(spec) ? WatchDirectoryFlags.Recursive : WatchDirectoryFlags.None
|
2016-10-12 19:08:43 +02:00
|
|
|
};
|
|
|
|
}
|
2016-10-24 15:48:05 +02:00
|
|
|
if (isImplicitGlob(spec)) {
|
2016-10-12 19:08:43 +02:00
|
|
|
return { key: spec, flags: WatchDirectoryFlags.Recursive };
|
|
|
|
}
|
2016-10-24 15:48:05 +02:00
|
|
|
return undefined;
|
2016-10-07 18:29:11 +02:00
|
|
|
}
|
|
|
|
|
2015-12-07 23:58:13 +01:00
|
|
|
/**
|
|
|
|
* Determines whether a literal or wildcard file has already been included that has a higher
|
|
|
|
* extension priority.
|
|
|
|
*
|
|
|
|
* @param file The path to the file.
|
|
|
|
* @param extensionPriority The priority of the extension.
|
|
|
|
* @param context The expansion context.
|
|
|
|
*/
|
2015-12-15 00:21:12 +01:00
|
|
|
function hasFileWithHigherPriorityExtension(file: string, literalFiles: Map<string>, wildcardFiles: Map<string>, extensions: string[], keyMapper: (value: string) => string) {
|
|
|
|
const extensionPriority = getExtensionPriority(file, extensions);
|
2017-02-13 21:19:33 +01:00
|
|
|
const adjustedExtensionPriority = adjustExtensionPriority(extensionPriority, extensions);
|
2016-01-05 19:11:44 +01:00
|
|
|
for (let i = ExtensionPriority.Highest; i < adjustedExtensionPriority; i++) {
|
2015-12-15 00:21:12 +01:00
|
|
|
const higherPriorityExtension = extensions[i];
|
|
|
|
const higherPriorityPath = keyMapper(changeExtension(file, higherPriorityExtension));
|
2016-12-05 23:13:32 +01:00
|
|
|
if (literalFiles.has(higherPriorityPath) || wildcardFiles.has(higherPriorityPath)) {
|
2015-12-07 23:58:13 +01:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Removes files included via wildcard expansion with a lower extension priority that have
|
|
|
|
* already been included.
|
|
|
|
*
|
|
|
|
* @param file The path to the file.
|
|
|
|
* @param extensionPriority The priority of the extension.
|
|
|
|
* @param context The expansion context.
|
|
|
|
*/
|
2015-12-15 00:21:12 +01:00
|
|
|
function removeWildcardFilesWithLowerPriorityExtension(file: string, wildcardFiles: Map<string>, extensions: string[], keyMapper: (value: string) => string) {
|
|
|
|
const extensionPriority = getExtensionPriority(file, extensions);
|
2017-02-13 21:19:33 +01:00
|
|
|
const nextExtensionPriority = getNextLowestExtensionPriority(extensionPriority, extensions);
|
2016-01-05 19:11:44 +01:00
|
|
|
for (let i = nextExtensionPriority; i < extensions.length; i++) {
|
2015-12-15 00:21:12 +01:00
|
|
|
const lowerPriorityExtension = extensions[i];
|
|
|
|
const lowerPriorityPath = keyMapper(changeExtension(file, lowerPriorityExtension));
|
2016-12-05 23:13:32 +01:00
|
|
|
wildcardFiles.delete(lowerPriorityPath);
|
2015-12-03 19:44:24 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets a case sensitive key.
|
|
|
|
*
|
|
|
|
* @param key The original key.
|
|
|
|
*/
|
|
|
|
function caseSensitiveKeyMapper(key: string) {
|
|
|
|
return key;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets a case insensitive key.
|
|
|
|
*
|
|
|
|
* @param key The original key.
|
|
|
|
*/
|
|
|
|
function caseInsensitiveKeyMapper(key: string) {
|
|
|
|
return key.toLowerCase();
|
|
|
|
}
|
2017-05-25 22:30:27 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Produces a cleaned version of compiler options with personally identifiying info (aka, paths) removed.
|
|
|
|
* Also converts enum values back to strings.
|
|
|
|
*/
|
|
|
|
/* @internal */
|
|
|
|
export function convertCompilerOptionsForTelemetry(opts: ts.CompilerOptions): ts.CompilerOptions {
|
|
|
|
const out: ts.CompilerOptions = {};
|
|
|
|
for (const key in opts) if (opts.hasOwnProperty(key)) {
|
|
|
|
const type = getOptionFromName(key);
|
|
|
|
if (type !== undefined) { // Ignore unknown options
|
|
|
|
out[key] = getOptionValueWithEmptyStrings(opts[key], type);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return out;
|
|
|
|
}
|
|
|
|
|
|
|
|
function getOptionValueWithEmptyStrings(value: any, option: CommandLineOption): {} {
|
|
|
|
switch (option.type) {
|
|
|
|
case "object": // "paths". Can't get any useful information from the value since we blank out strings, so just return "".
|
|
|
|
return "";
|
|
|
|
case "string": // Could be any arbitrary string -- use empty string instead.
|
|
|
|
return "";
|
|
|
|
case "number": // Allow numbers, but be sure to check it's actually a number.
|
|
|
|
return typeof value === "number" ? value : "";
|
|
|
|
case "boolean":
|
|
|
|
return typeof value === "boolean" ? value : "";
|
|
|
|
case "list":
|
|
|
|
const elementType = (option as CommandLineOptionOfListType).element;
|
|
|
|
return ts.isArray(value) ? value.map(v => getOptionValueWithEmptyStrings(v, elementType)) : "";
|
|
|
|
default:
|
|
|
|
return ts.forEachEntry(option.type, (optionEnumValue, optionStringValue) => {
|
|
|
|
if (optionEnumValue === value) {
|
|
|
|
return optionStringValue;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
|
|
|
}
|
2017-05-24 18:50:38 +02:00
|
|
|
}
|