import preferenceSchema from "../../userPreferences.schema.json" with { type: "json" };

import {

type CompilerOptionType,

type Declaration,

diagnostic,

type OptionsModel,

} from "./options-model.ts";

export const formattingProperties = {

...preferenceSchema.$defs.EditorSettings.properties,

...preferenceSchema.$defs.FormatCodeSettings.properties,

};

export const formattingDeclarations: Declaration[] = Object.entries(formattingProperties).map(([name, property]) => ({

name,

kind: "enum" in property ? "Enum" : property.type === "boolean" ? "Boolean" : property.type === "integer" ? "Number" : "String",

...(property.type === "integer" ? { minValue: 0 } : {}),

}));

export const formattingFields = Object.entries(formattingProperties).map(([name, property]) => {

const field = name[0].toUpperCase() + name.slice(1);

const enumName = "Formatting" + ("x-go-type" in property ? property["x-go-type"] : field);

const enumType = "x-go-underlying" in property ? property["x-go-underlying"] : "string";

return {

name,

field,

type: property.type === "boolean" ? "Tristate" : "enum" in property ? `*${enumName}` : property.type === "integer" ? "*int" : "*string",

enumName,

enumType,

values: "enum" in property ? property.enum : undefined,

};

});

export const pluginImportFields: { name: string; type: CompilerOptionType; }[] = [

{ name: "name", type: "string" },

];

export const options: OptionsModel = {

schemaOnlyOptions: [

{

name: "charset",

type: "string",

description: "The text encoding used to read source files in early TypeScript versions.",

},

{

name: "out",

type: "string",

description: "The legacy predecessor of outFile, which combined emitted JavaScript into a single file.",

},

{

name: "noImplicitUseStrict",

type: "boolean",

description: "Disable adding 'use strict' directives to emitted JavaScript.",

},

{

name: "noStrictGenericChecks",

type: "boolean",

description: "Disable strict checking of generic signatures in function types.",

},

{

name: "keyofStringsOnly",

type: "boolean",

description: "Make keyof return only strings instead of strings, numbers, or symbols.",

},

{

name: "suppressExcessPropertyErrors",

type: "boolean",

description: "Disable excess property errors when creating object literals.",

},

{

name: "suppressImplicitAnyIndexErrors",

type: "boolean",

description: "Suppress noImplicitAny errors when indexing objects that lack index signatures.",

},

{

name: "preserveValueImports",

type: "boolean",

description: "Preserve unused imported values in JavaScript output. Superseded by verbatimModuleSyntax.",

},

{

name: "importsNotUsedAsValues",

type: "enum",

values: ["remove", "preserve", "error"],

description: "Control emit and checking for imports used only as types. Superseded by verbatimModuleSyntax.",

},

],

compilerOptions: [

{

name: "allowJs",

type: "Tristate",

jsconfigDefault: true,

declaration: {

group: "optionsForCompiler",

affectsBuildInfo: true,

showInSimplifiedHelpView: true,

category: diagnostic("JavaScript Support"),

description: diagnostic("Allow JavaScript files to be a part of your program. Use the 'checkJs' option to get errors from these files."),

defaultValueDescription: diagnostic("`false`, unless `checkJs` is set"),

},

},

{

name: "allowArbitraryExtensions",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Modules"),

description: diagnostic("Enable importing files with any extension, provided a declaration file is present."),

defaultValueDescription: false,

},

},

{

name: "allowImportingTsExtensions",

transpile: { value: "clear" },

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Modules"),

description: diagnostic("Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set."),

defaultValueDescription: false,

},

},

{

name: "allowNonTsExtensions",

transpile: { value: true },

type: "Tristate",

},

{

name: "allowUmdGlobalAccess",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Modules"),

description: diagnostic("Allow accessing UMD globals from modules."),

defaultValueDescription: false,

},

},

{

name: "allowUnreachableCode",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Disable error reporting for unreachable code."),

defaultValueDescription: { go: "core.TSUnknown" },

},

},

{

name: "allowUnusedLabels",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Disable error reporting for unused labels."),

defaultValueDescription: { go: "core.TSUnknown" },

},

},

{

name: "assumeChangesOnlyAffectDirectDependencies",

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

affectsSemanticDiagnostics: true,

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Watch and Build Modes"),

description: diagnostic("Have recompiles in projects that use 'incremental' and 'watch' mode assume that changes within a file will only affect files directly depending on it."),

defaultValueDescription: false,

},

},

{

name: "checkJs",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

showInSimplifiedHelpView: true,

category: diagnostic("JavaScript Support"),

description: diagnostic("Enable error reporting in type-checked JavaScript files."),

defaultValueDescription: false,

},

},

{

name: "customConditions",

type: "[]string",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Modules"),

description: diagnostic("Conditions to set in addition to the resolver-specific defaults when resolving imports."),

},

},

{

name: "composite",

transpile: { value: "clear" },

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsBuildInfo: true,

isTSConfigOnly: true,

category: diagnostic("Projects"),

defaultValueDescription: false,

description: diagnostic("Enable constraints that allow a TypeScript project to be used with project references."),

},

},

{

name: "emitDeclarationOnly",

transpile: { value: "clear", declarationValue: true },

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

// Full emit is calculated separately, so this does not set affectsEmit.

affectsBuildInfo: true,

showInSimplifiedHelpView: true,

category: diagnostic("Emit"),

description: diagnostic("Only output d.ts files and not JavaScript files."),

defaultValueDescription: false,

},

},

{

name: "emitBOM",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files."),

defaultValueDescription: false,

},

},

{

name: "emitDecoratorMetadata",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Language and Environment"),

description: diagnostic("Emit design-type metadata for decorated declarations in source files."),

defaultValueDescription: false,

},

},

{

name: "declaration",

transpile: { value: false, declarationValue: true },

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

// Full emit is calculated separately, so this does not set affectsEmit.

shortName: "d",

affectsBuildInfo: true,

showInSimplifiedHelpView: true,

category: diagnostic("Emit"),

description: diagnostic("Generate .d.ts files from TypeScript and JavaScript files in your project."),

defaultValueDescription: diagnostic("`false`, unless `composite` is set"),

},

},

{

name: "declarationDir",

transpile: { value: "clear" },

type: "string",

pathKind: "directory",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

affectsDeclarationPath: true,

isFilePath: true,

category: diagnostic("Emit"),

description: diagnostic("Specify the output directory for generated declaration files."),

},

},

{

name: "declarationMap",

transpile: { value: false, declarationValue: "preserve" },

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

// Full emit is calculated separately, so this does not set affectsEmit.

affectsBuildInfo: true,

showInSimplifiedHelpView: true,

category: diagnostic("Emit"),

defaultValueDescription: false,

description: diagnostic("Create sourcemaps for d.ts files."),

},

},

{

name: "deduplicatePackages",

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

category: diagnostic("Type Checking"),

description: diagnostic("Deduplicate packages with the same name and version."),

documentationAnchor: false,

defaultValueDescription: true,

},

},

{

name: "disableSizeLimit",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Editor Support"),

description: diagnostic("Remove the 20mb cap on total source code size for JavaScript files in the TypeScript language server."),

defaultValueDescription: false,

},

},

{

name: "disableSourceOfProjectReferenceRedirect",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

isTSConfigOnly: true,

category: diagnostic("Projects"),

description: diagnostic("Disable preferring source files instead of declaration files when referencing composite projects."),

defaultValueDescription: false,

},

},

{

name: "disableSolutionSearching",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

isTSConfigOnly: true,

category: diagnostic("Projects"),

description: diagnostic("Opt a project out of multi-project reference checking when editing."),

defaultValueDescription: false,

},

},

{

name: "disableReferencedProjectLoad",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

isTSConfigOnly: true,

category: diagnostic("Projects"),

description: diagnostic("Reduce the number of projects loaded automatically by TypeScript."),

defaultValueDescription: false,

},

},

{

name: "erasableSyntaxOnly",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Interop Constraints"),

description: diagnostic("Do not allow runtime constructs that are not part of ECMAScript."),

defaultValueDescription: false,

affectsBuildInfo: true,

affectsSemanticDiagnostics: true,

},

},

{

name: "exactOptionalPropertyTypes",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Interpret optional property types as written, rather than adding 'undefined'."),

defaultValueDescription: false,

},

},

{

name: "experimentalDecorators",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Language and Environment"),

description: diagnostic("Enable experimental support for legacy experimental decorators."),

defaultValueDescription: false,

},

},

{

name: "forceConsistentCasingInFileNames",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Interop Constraints"),

description: diagnostic("Ensure that casing is correct in imports."),

defaultValueDescription: true,

},

},

{

name: "isolatedModules",

transpile: { value: true, unless: "verbatimModuleSyntax" },

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Interop Constraints"),

description: diagnostic("Ensure that each file can be safely transpiled without relying on other imports."),

defaultValueDescription: false,

},

},

{

name: "isolatedDeclarations",

transpile: { value: false, declarationValue: true },

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Interop Constraints"),

description: diagnostic("Require sufficient annotation on exports so other tools can trivially generate declaration files."),

defaultValueDescription: false,

affectsBuildInfo: true,

affectsSemanticDiagnostics: true,

},

},

{

name: "ignoreConfig",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

showInSimplifiedHelpView: true,

category: diagnostic("Command-line Options"),

isCommandLineOnly: true,

description: diagnostic("Ignore the tsconfig found and build with commandline options and files."),

defaultValueDescription: false,

},

},

{

name: "ignoreDeprecations",

type: "string",

declaration: {

group: "optionsForCompiler",

defaultValueDescription: { go: "core.TSUnknown" },

},

},

{

name: "importHelpers",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Allow importing helper functions from tslib once per project, instead of including them per-file."),

defaultValueDescription: false,

},

},

{

name: "inlineSourceMap",

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

// Full emit is calculated separately, so this does not set affectsEmit.

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Include sourcemap files inside the emitted JavaScript."),

defaultValueDescription: false,

},

},

{

name: "inlineSources",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Include source code in the sourcemaps inside the emitted JavaScript."),

defaultValueDescription: false,

},

},

{

name: "init",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

showInSimplifiedHelpView: true,

category: diagnostic("Command-line Options"),

description: diagnostic("Initializes a TypeScript project and creates a tsconfig.json file."),

defaultValueDescription: false,

},

},

{

name: "incremental",

transpile: { value: "clear" },

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

shortName: "i",

category: diagnostic("Projects"),

description: diagnostic("Save .tsbuildinfo files to allow for incremental compilation of projects."),

defaultValueDescription: diagnostic("`false`, unless `composite` is set"),

},

},

{

name: "jsx",

type: "JsxEmit",

declaration: {

group: "optionsForCompiler",

// JSX without this option is a semantic error; changing it must refresh semantic diagnostics.

affectsEmit: true,

affectsBuildInfo: true,

affectsSemanticDiagnostics: true,

showInSimplifiedHelpView: true,

category: diagnostic("Language and Environment"),

description: diagnostic("Specify what JSX code is generated."),

defaultValueDescription: { go: "core.TSUnknown" },

},

},

{

name: "jsxFactory",

type: "string",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Language and Environment"),

description: diagnostic("Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'."),

defaultValueDescription: "`React.createElement`",

},

},

{

name: "jsxFragmentFactory",

type: "string",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Language and Environment"),

description: diagnostic("Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'."),

defaultValueDescription: "React.Fragment",

},

},

{

name: "jsxImportSource",

type: "string",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Language and Environment"),

description: diagnostic("Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'."),

defaultValueDescription: "react",

},

},

{

name: "lib",

transpile: { value: "clear" },

type: "[]string",

declaration: {

group: "optionsForCompiler",

showInSimplifiedHelpView: true,

category: diagnostic("Language and Environment"),

description: diagnostic("Specify a set of bundled library declaration files that describe the target runtime environment."),

},

},

{

name: "libReplacement",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Language and Environment"),

description: diagnostic("Enable lib replacement."),

defaultValueDescription: false,

},

},

{

name: "locale",

type: "string",

declaration: {

group: "commonOptionsWithBuild",

category: diagnostic("Command-line Options"),

isCommandLineOnly: true,

description: diagnostic("Set the language of the messaging from TypeScript. This does not affect emit."),

defaultValueDescription: diagnostic("Platform specific"),

extraValidation: "locale",

},

},

{

name: "mapRoot",

type: "string",

pathKind: "sourceMapLocation",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Specify the location where debugger should locate map files instead of generated locations."),

},

},

{

name: "module",

type: "ModuleKind",

declaration: {

group: "optionsForCompiler",

shortName: "m",

affectsEmit: true,

affectsBuildInfo: true,

showInSimplifiedHelpView: true,

category: diagnostic("Modules"),

description: diagnostic("Specify what module code is generated."),

defaultValueDescription: { go: "core.TSUnknown" },

},

},

{

name: "moduleResolution",

type: "ModuleResolutionKind",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Modules"),

description: diagnostic("Specify how TypeScript looks up a file from a given module specifier."),

defaultValueDescription: diagnostic("`nodenext` if `module` is `nodenext`; `node16` if `module` is `node16` or `node18`; otherwise, `bundler`."),

},

},

{

name: "moduleSuffixes",

type: "[]string",

declaration: {

group: "optionsForCompiler",

listPreserveFalsyValues: true,

category: diagnostic("Modules"),

description: diagnostic("List of file name suffixes to search when resolving a module."),

},

},

{

name: "moduleDetection",

type: "ModuleDetectionKind",

parseAliases: [

"moduleDetectionKind",

],

declaration: {

group: "optionsForCompiler",

description: diagnostic("Control what method is used to detect module-format JS files."),

category: diagnostic("Language and Environment"),

defaultValueDescription: diagnostic('"auto": Treat files with imports, exports, import.meta, jsx (with jsx: react-jsx), or esm format (with module: node16+) as modules.'),

},

},

{

name: "newLine",

type: "NewLineKind",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Set the newline character for emitting files."),

defaultValueDescription: "lf",

},

},

{

name: "noEmit",

transpile: { value: "clear" },

type: "Tristate",

jsconfigDefault: true,

declaration: {

group: "commonOptionsWithBuild",

showInSimplifiedHelpView: true,

category: diagnostic("Emit"),

description: diagnostic("Disable emitting files from a compilation."),

defaultValueDescription: false,

},

},

{

name: "noCheck",

transpile: { value: true },

type: "Tristate",

declaration: {

group: "commonOptionsWithBuild",

// The builder handles this specially so changing noCheck does not discard all diagnostics.

showInSimplifiedHelpView: false,

category: diagnostic("Compiler Diagnostics"),

description: diagnostic("Disable full type checking (only critical parse and emit errors will be reported)."),

defaultValueDescription: false,

},

},

{

name: "noErrorTruncation",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Output Formatting"),

description: diagnostic("Disable truncating types in error messages."),

defaultValueDescription: false,

},

},

{

name: "noFallthroughCasesInSwitch",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Enable error reporting for fallthrough cases in switch statements."),

defaultValueDescription: false,

},

},

{

name: "noImplicitAny",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

strictFlag: true,

category: diagnostic("Type Checking"),

description: diagnostic("Enable error reporting for expressions and declarations with an implied 'any' type."),

defaultValueDescription: diagnostic("`true`, unless `strict` is `false`"),

},

},

{

name: "noImplicitThis",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

strictFlag: true,

category: diagnostic("Type Checking"),

description: diagnostic("Enable error reporting when 'this' is given the type 'any'."),

defaultValueDescription: diagnostic("`true`, unless `strict` is `false`"),

},

},

{

name: "noImplicitReturns",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Enable error reporting for codepaths that do not explicitly return in a function."),

defaultValueDescription: false,

},

},

{

name: "noEmitHelpers",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Disable generating custom helper functions like '__extends' in compiled output."),

defaultValueDescription: false,

},

},

{

name: "noLib",

transpile: { value: true, declarationValue: false },

type: "Tristate",

declaration: {

group: "optionsForCompiler",

// Transpilation does not supply library source files, so noLib avoids reporting missing files.

category: diagnostic("Language and Environment"),

description: diagnostic("Disable including any library files, including the default lib.d.ts."),

defaultValueDescription: false,

},

},

{

name: "noPropertyAccessFromIndexSignature",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

showInSimplifiedHelpView: false,

category: diagnostic("Type Checking"),

description: diagnostic("Enforces using indexed accessors for keys declared using an indexed type."),

defaultValueDescription: false,

},

},

{

name: "noUncheckedIndexedAccess",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Add 'undefined' to a type when accessed using an index."),

defaultValueDescription: false,

},

},

{

name: "noEmitOnError",

transpile: { value: "clear" },

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Disable emitting files if any type checking errors are reported."),

defaultValueDescription: false,

},

},

{

name: "noUnusedLocals",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Enable error reporting when local variables aren't read."),

defaultValueDescription: false,

},

},

{

name: "noUnusedParameters",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Raise an error when a function parameter isn't read."),

defaultValueDescription: false,

},

},

{

name: "noResolve",

transpile: { value: true },

type: "Tristate",

declaration: {

group: "optionsForCompiler",

// Transpilation does not resolve the full program, so noResolve avoids reporting missing files.

category: diagnostic("Modules"),

description: diagnostic("Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project."),

defaultValueDescription: false,

},

},

{

name: "noImplicitOverride",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Type Checking"),

description: diagnostic("Ensure overriding members in derived classes are marked with an override modifier."),

defaultValueDescription: false,

},

},

{

name: "noUncheckedSideEffectImports",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Modules"),

description: diagnostic("Check side effect imports."),

defaultValueDescription: true,

},

},

{

name: "outDir",

type: "string",

pathKind: "directory",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

affectsDeclarationPath: true,

isFilePath: true,

showInSimplifiedHelpView: true,

category: diagnostic("Emit"),

description: diagnostic("Specify an output folder for all emitted files."),

},

},

{

name: "paths",

transpile: { value: "clear" },

type: "*collections.OrderedMap[string, []string]",

declaration: {

group: "optionsForCompiler",

allowConfigDirTemplateSubstitution: true,

isTSConfigOnly: true,

category: diagnostic("Modules"),

description: diagnostic("Specify a set of entries that re-map imports to additional lookup locations."),

},

},

{

name: "plugins",

type: "[]PluginImport",

comment: "Plugins are parsed only so tools can report that native TypeScript does not support them.",

declaration: {

group: "optionsForCompiler",

isTSConfigOnly: true,

description: diagnostic("Specify a list of language service plugins to include."),

category: diagnostic("Editor Support"),

},

},

{

name: "preserveConstEnums",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Emit"),

description: diagnostic("Disable erasing 'const enum' declarations in generated code."),

defaultValueDescription: false,

},

},

{

name: "preserveSymlinks",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Interop Constraints"),

description: diagnostic("Disable resolving symlinks to their realpath. This correlates to the same flag in node."),

defaultValueDescription: false,

},

},

{

name: "project",

type: "string",

pathKind: "fileOrDirectory",

declaration: {

group: "optionsForCompiler",

shortName: "p",

isFilePath: true,

allowConfigDirTemplateSubstitution: false,

showInSimplifiedHelpView: true,

category: diagnostic("Command-line Options"),

description: diagnostic("Compile the project given the path to its configuration file, or to a folder with a 'tsconfig.json'."),

},

},

{

name: "resolveJsonModule",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Modules"),

description: diagnostic("Enable importing .json files."),

defaultValueDescription: false,

},

},

{

name: "resolvePackageJsonExports",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Modules"),

description: diagnostic("Use the package.json 'exports' field when resolving package imports."),

defaultValueDescription: diagnostic("`true` when 'moduleResolution' is 'node16', 'nodenext', or 'bundler'; otherwise `false`."),

},

},

{

name: "resolvePackageJsonImports",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

category: diagnostic("Modules"),

description: diagnostic("Use the package.json 'imports' field when resolving imports."),

defaultValueDescription: diagnostic("`true` when 'moduleResolution' is 'node16', 'nodenext', or 'bundler'; otherwise `false`."),

},

},

{

name: "removeComments",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

showInSimplifiedHelpView: true,

category: diagnostic("Emit"),

defaultValueDescription: false,

description: diagnostic("Disable emitting comments."),

},

},

{

name: "rewriteRelativeImportExtensions",

type: "Tristate",

declaration: {

group: "optionsForCompiler",

affectsSemanticDiagnostics: true,

affectsBuildInfo: true,

category: diagnostic("Modules"),

description: diagnostic("Rewrite '.ts', '.tsx', '.mts', and '.cts' file extensions in relative import paths to their JavaScript equivalent in output files."),

defaultValueDescription: false,

},

},

{

name: "reactNamespace",

type: "string",

declaration: {

group: "optionsForCompiler",

affectsEmit: true,

affectsBuildInfo: true,

category: diagnostic("Language and Environment"),

description: diagnostic("Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit."),

defaultValueDescription: "`React`",