@microsoft/api-extractor 7.19.2 → 7.19.5

package/lib/schemas/api-extractor.schema.json

@@ -1,205 +1,205 @@
-{
-  "title": "API Extractor Configuration",
-  "description": "Describes how the API Extractor tool will process a project.",
-  "type": "object",
-  "properties": {
-    "$schema": {
-      "description": "Part of the JSON Schema standard, this optional keyword declares the URL of the schema that the file conforms to. Editors may download the schema and use it to perform syntax highlighting.",
-      "type": "string"
-    },
-
-    "extends": {
-      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects.",
-      "type": "string"
-    },
-
-    "projectFolder": {
-      "description": "Determines the \"<projectFolder>\" token that can be used with other config file settings.  The project folder typically contains the tsconfig.json and package.json config files, but the path is user-defined.  The path is resolved relative to the folder of the config file that contains the setting.  The default value for \"projectFolder\" is the token \"<lookup>\", which means the folder is determined using the following heuristics:\n\nIf the config/rig.json system is used (as defined by @rushstack/rig-package), then the \"<lookup>\" value will be the package folder that referenced the rig.\n\nOtherwise, the \"<lookup>\" value is determined by traversing parent folders, starting from the folder containing api-extractor.json, and stopping at the first folder that contains a tsconfig.json file.  If a tsconfig.json file cannot be found in this way, then an error will be reported.",
-      "type": "string"
-    },
-
-    "mainEntryPointFilePath": {
-      "description": "Specifies the .d.ts file to be used as the starting point for analysis.  API Extractor analyzes the symbols exported by this module. The file extension must be \".d.ts\" and not \".ts\". The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
-      "type": "string"
-    },
-
-    "bundledPackages": {
-      "description": "A list of NPM package names whose exports should be treated as part of this package.",
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-
-    "compiler": {
-      "description": "Determines how the TypeScript compiler engine will be invoked by API Extractor.",
-      "type": "object",
-      "properties": {
-        "tsconfigFilePath": {
-          "description": "Specifies the path to the tsconfig.json file to be used by API Extractor when analyzing the project.  The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".  Note: This setting will be ignored if \"overrideTsconfig\" is used.",
-          "type": "string"
-        },
-        "overrideTsconfig": {
-          "description": "Provides a compiler configuration that will be used instead of reading the tsconfig.json file from disk. The object must conform to the TypeScript tsconfig schema: http://json.schemastore.org/tsconfig  If omitted, then the tsconfig.json file will be read from the \"projectFolder\".",
-          "type": "object"
-        },
-        "skipLibCheck": {
-          "description": "This option causes the compiler to be invoked with the --skipLibCheck option. This option is not recommended and may cause API Extractor to produce incomplete or incorrect declarations, but it may be required when dependencies contain declarations that are incompatible with the TypeScript engine that API Extractor uses for its analysis.  Where possible, the underlying issue should be fixed rather than relying on skipLibCheck.",
-          "type": "boolean"
-        }
-      },
-      "additionalProperties": false
-    },
-
-    "apiReport": {
-      "description": "Configures how the API report file (*.api.md) will be generated.",
-      "type": "object",
-      "properties": {
-        "enabled": {
-          "description": "Whether to generate an API report.",
-          "type": "boolean"
-        },
-
-        "reportFileName": {
-          "description": "The filename for the API report files.  It will be combined with \"reportFolder\" or \"reportTempFolder\" to produce a full file path. The file extension should be \".api.md\", and the string should not contain a path separator such as \"\\\" or \"/\".",
-          "type": "string"
-        },
-
-        "reportFolder": {
-          "description": "Specifies the folder where the API report file is written.  The file name portion is determined by the \"reportFileName\" setting. The API report file is normally tracked by Git.  Changes to it can be used to trigger a branch policy, e.g. for an API review. The path is resolved relative to the folder of the config file that contains the setting; to change this,  prepend a folder token such as \"<projectFolder>\".",
-          "type": "string"
-        },
-
-        "reportTempFolder": {
-          "description": "Specifies the folder where the temporary report file is written.  The file name portion is determined by the \"reportFileName\" setting. After the temporary file is written to disk, it is compared with the file in the \"reportFolder\". If they are different, a production build will fail. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
-          "type": "string"
-        }
-      },
-      "required": ["enabled"],
-      "additionalProperties": false
-    },
-
-    "docModel": {
-      "description": "Configures how the doc model file (*.api.json) will be generated.",
-      "type": "object",
-      "properties": {
-        "enabled": {
-          "description": "Whether to generate doc model file.",
-          "type": "boolean"
-        },
-        "apiJsonFilePath": {
-          "description": "The output path for the doc model file.  The file extension should be \".api.json\". The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
-          "type": "string"
-        }
-      },
-      "required": ["enabled"],
-      "additionalProperties": false
-    },
-
-    "dtsRollup": {
-      "description": "Configures how the .d.ts rollup file will be generated.",
-      "type": "object",
-      "properties": {
-        "enabled": {
-          "description": "Whether to generate the .d.ts rollup file.",
-          "type": "boolean"
-        },
-        "untrimmedFilePath": {
-          "description": "Specifies the output path for a .d.ts rollup file to be generated without any trimming. This file will include all declarations that are exported by the main entry point. If the path is an empty string, then this file will not be written. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
-          "type": "string"
-        },
-        "betaTrimmedFilePath": {
-          "description": "Specifies the output path for a .d.ts rollup file to be generated with trimming for a \"beta\" release. This file will include only declarations that are marked as \"@public\" or \"@beta\". The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
-          "type": "string"
-        },
-        "publicTrimmedFilePath": {
-          "description": "Specifies the output path for a .d.ts rollup file to be generated with trimming for a \"public\" release. This file will include only declarations that are marked as \"@public\". If the path is an empty string, then this file will not be written. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
-          "type": "string"
-        },
-        "omitTrimmingComments": {
-          "description": "When a declaration is trimmed, by default it will be replaced by a code comment such as \"Excluded from this release type: exampleMember\".  Set \"omitTrimmingComments\" to true to remove the declaration completely.",
-          "type": "boolean"
-        }
-      },
-      "required": ["enabled"],
-      "additionalProperties": false
-    },
-
-    "tsdocMetadata": {
-      "description": "Configures how the tsdoc-metadata.json file will be generated.",
-      "type": "object",
-      "properties": {
-        "enabled": {
-          "description": "Whether to generate the tsdoc-metadata.json file.",
-          "type": "boolean"
-        },
-        "tsdocMetadataFilePath": {
-          "description": "Specifies where the TSDoc metadata file should be written. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\". The default value is \"<lookup>\", which causes the path to be automatically inferred from the \"tsdocMetadata\", \"typings\" or \"main\" fields of the project's package.json.  If none of these fields are set, the lookup falls back to \"tsdoc-metadata.json\" in the package folder.",
-          "type": "string"
-        }
-      },
-      "additionalProperties": false
-    },
-
-    "newlineKind": {
-      "description": "Specifies what type of newlines API Extractor should use when writing output files.  By default, the output files will be written with Windows-style newlines.  To use POSIX-style newlines, specify \"lf\" instead. To use the OS's default newline kind, specify \"os\".",
-      "type": "string",
-      "enum": ["crlf", "lf", "os"],
-      "default": "crlf"
-    },
-
-    "messages": {
-      "description": "Configures how API Extractor reports error and warning messages produced during analysis.",
-      "type": "object",
-      "properties": {
-        "compilerMessageReporting": {
-          "description": "Configures handling of diagnostic messages generating the TypeScript compiler while analyzing the input .d.ts files.",
-          "$ref": "#/definitions/extractorMessageReportingTable"
-        },
-        "extractorMessageReporting": {
-          "description": "Configures handling of messages reported by API Extractor during its analysis.",
-          "$ref": "#/definitions/extractorMessageReportingTable"
-        },
-        "tsdocMessageReporting": {
-          "description": "Configures handling of messages reported by the TSDoc parser when analyzing code comments.",
-          "$ref": "#/definitions/extractorMessageReportingTable"
-        }
-      },
-      "additionalProperties": false
-    },
-
-    "testMode": {
-      "description": "Set to true invoking API Extractor's test harness. When \"testMode\" is true, the \"toolVersion\" field in the .api.json file is assigned an empty string to prevent spurious diffs in output files tracked for tests.",
-      "type": "boolean"
-    }
-  },
-  "required": ["mainEntryPointFilePath"],
-  "additionalProperties": false,
-
-  "definitions": {
-    "extractorMessageReportingTable": {
-      "type": "object",
-      "description": "Specifies a table of reporting rules for different message identifiers, and also the default rule used for identifiers that do not appear in the table. The key is a message identifier for the associated type of message, or \"default\" to specify the default policy. For example, the key might be \"TS2551\" (a compiler message), \"tsdoc-link-tag-unescaped-text\" (a TSDOc message), or \"ae-extra-release-tag\" (a message related to the API Extractor analysis).",
-      "patternProperties": {
-        ".+": {
-          "type": "object",
-          "description": "Configures reporting for a given message identifier.",
-          "properties": {
-            "logLevel": {
-              "type": "string",
-              "description": "Specifies whether the message should be written to the the tool's output log. Note that the \"addToApiReportFile\" property may supersede this option.",
-              "enum": ["error", "warning", "none"]
-            },
-            "addToApiReportFile": {
-              "type": "boolean",
-              "description": "If API Extractor is configured to write an API review file (.api.md), then the message will be written inside that file.  If the API review file is NOT being written, then the message is instead logged according to the \"logLevel\" option."
-            }
-          },
-          "additionalProperties": false,
-          "required": ["logLevel"]
-        }
-      },
-      "additionalProperties": false
-    }
-  }
-}
+{
+  "title": "API Extractor Configuration",
+  "description": "Describes how the API Extractor tool will process a project.",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "description": "Part of the JSON Schema standard, this optional keyword declares the URL of the schema that the file conforms to. Editors may download the schema and use it to perform syntax highlighting.",
+      "type": "string"
+    },
+
+    "extends": {
+      "description": "Optionally specifies another JSON config file that this file extends from.  This provides a way for standard settings to be shared across multiple projects.",
+      "type": "string"
+    },
+
+    "projectFolder": {
+      "description": "Determines the \"<projectFolder>\" token that can be used with other config file settings.  The project folder typically contains the tsconfig.json and package.json config files, but the path is user-defined.  The path is resolved relative to the folder of the config file that contains the setting.  The default value for \"projectFolder\" is the token \"<lookup>\", which means the folder is determined using the following heuristics:\n\nIf the config/rig.json system is used (as defined by @rushstack/rig-package), then the \"<lookup>\" value will be the package folder that referenced the rig.\n\nOtherwise, the \"<lookup>\" value is determined by traversing parent folders, starting from the folder containing api-extractor.json, and stopping at the first folder that contains a tsconfig.json file.  If a tsconfig.json file cannot be found in this way, then an error will be reported.",
+      "type": "string"
+    },
+
+    "mainEntryPointFilePath": {
+      "description": "Specifies the .d.ts file to be used as the starting point for analysis.  API Extractor analyzes the symbols exported by this module. The file extension must be \".d.ts\" and not \".ts\". The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
+      "type": "string"
+    },
+
+    "bundledPackages": {
+      "description": "A list of NPM package names whose exports should be treated as part of this package.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+
+    "compiler": {
+      "description": "Determines how the TypeScript compiler engine will be invoked by API Extractor.",
+      "type": "object",
+      "properties": {
+        "tsconfigFilePath": {
+          "description": "Specifies the path to the tsconfig.json file to be used by API Extractor when analyzing the project.  The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".  Note: This setting will be ignored if \"overrideTsconfig\" is used.",
+          "type": "string"
+        },
+        "overrideTsconfig": {
+          "description": "Provides a compiler configuration that will be used instead of reading the tsconfig.json file from disk. The object must conform to the TypeScript tsconfig schema: http://json.schemastore.org/tsconfig  If omitted, then the tsconfig.json file will be read from the \"projectFolder\".",
+          "type": "object"
+        },
+        "skipLibCheck": {
+          "description": "This option causes the compiler to be invoked with the --skipLibCheck option. This option is not recommended and may cause API Extractor to produce incomplete or incorrect declarations, but it may be required when dependencies contain declarations that are incompatible with the TypeScript engine that API Extractor uses for its analysis.  Where possible, the underlying issue should be fixed rather than relying on skipLibCheck.",
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+
+    "apiReport": {
+      "description": "Configures how the API report file (*.api.md) will be generated.",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "description": "Whether to generate an API report.",
+          "type": "boolean"
+        },
+
+        "reportFileName": {
+          "description": "The filename for the API report files.  It will be combined with \"reportFolder\" or \"reportTempFolder\" to produce a full file path. The file extension should be \".api.md\", and the string should not contain a path separator such as \"\\\" or \"/\".",
+          "type": "string"
+        },
+
+        "reportFolder": {
+          "description": "Specifies the folder where the API report file is written.  The file name portion is determined by the \"reportFileName\" setting. The API report file is normally tracked by Git.  Changes to it can be used to trigger a branch policy, e.g. for an API review. The path is resolved relative to the folder of the config file that contains the setting; to change this,  prepend a folder token such as \"<projectFolder>\".",
+          "type": "string"
+        },
+
+        "reportTempFolder": {
+          "description": "Specifies the folder where the temporary report file is written.  The file name portion is determined by the \"reportFileName\" setting. After the temporary file is written to disk, it is compared with the file in the \"reportFolder\". If they are different, a production build will fail. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
+          "type": "string"
+        }
+      },
+      "required": ["enabled"],
+      "additionalProperties": false
+    },
+
+    "docModel": {
+      "description": "Configures how the doc model file (*.api.json) will be generated.",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "description": "Whether to generate doc model file.",
+          "type": "boolean"
+        },
+        "apiJsonFilePath": {
+          "description": "The output path for the doc model file.  The file extension should be \".api.json\". The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
+          "type": "string"
+        }
+      },
+      "required": ["enabled"],
+      "additionalProperties": false
+    },
+
+    "dtsRollup": {
+      "description": "Configures how the .d.ts rollup file will be generated.",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "description": "Whether to generate the .d.ts rollup file.",
+          "type": "boolean"
+        },
+        "untrimmedFilePath": {
+          "description": "Specifies the output path for a .d.ts rollup file to be generated without any trimming. This file will include all declarations that are exported by the main entry point. If the path is an empty string, then this file will not be written. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
+          "type": "string"
+        },
+        "betaTrimmedFilePath": {
+          "description": "Specifies the output path for a .d.ts rollup file to be generated with trimming for a \"beta\" release. This file will include only declarations that are marked as \"@public\" or \"@beta\". The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
+          "type": "string"
+        },
+        "publicTrimmedFilePath": {
+          "description": "Specifies the output path for a .d.ts rollup file to be generated with trimming for a \"public\" release. This file will include only declarations that are marked as \"@public\". If the path is an empty string, then this file will not be written. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\".",
+          "type": "string"
+        },
+        "omitTrimmingComments": {
+          "description": "When a declaration is trimmed, by default it will be replaced by a code comment such as \"Excluded from this release type: exampleMember\".  Set \"omitTrimmingComments\" to true to remove the declaration completely.",
+          "type": "boolean"
+        }
+      },
+      "required": ["enabled"],
+      "additionalProperties": false
+    },
+
+    "tsdocMetadata": {
+      "description": "Configures how the tsdoc-metadata.json file will be generated.",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "description": "Whether to generate the tsdoc-metadata.json file.",
+          "type": "boolean"
+        },
+        "tsdocMetadataFilePath": {
+          "description": "Specifies where the TSDoc metadata file should be written. The path is resolved relative to the folder of the config file that contains the setting; to change this, prepend a folder token such as \"<projectFolder>\". The default value is \"<lookup>\", which causes the path to be automatically inferred from the \"tsdocMetadata\", \"typings\" or \"main\" fields of the project's package.json.  If none of these fields are set, the lookup falls back to \"tsdoc-metadata.json\" in the package folder.",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+
+    "newlineKind": {
+      "description": "Specifies what type of newlines API Extractor should use when writing output files.  By default, the output files will be written with Windows-style newlines.  To use POSIX-style newlines, specify \"lf\" instead. To use the OS's default newline kind, specify \"os\".",
+      "type": "string",
+      "enum": ["crlf", "lf", "os"],
+      "default": "crlf"
+    },
+
+    "messages": {
+      "description": "Configures how API Extractor reports error and warning messages produced during analysis.",
+      "type": "object",
+      "properties": {
+        "compilerMessageReporting": {
+          "description": "Configures handling of diagnostic messages generating the TypeScript compiler while analyzing the input .d.ts files.",
+          "$ref": "#/definitions/extractorMessageReportingTable"
+        },
+        "extractorMessageReporting": {
+          "description": "Configures handling of messages reported by API Extractor during its analysis.",
+          "$ref": "#/definitions/extractorMessageReportingTable"
+        },
+        "tsdocMessageReporting": {
+          "description": "Configures handling of messages reported by the TSDoc parser when analyzing code comments.",
+          "$ref": "#/definitions/extractorMessageReportingTable"
+        }
+      },
+      "additionalProperties": false
+    },
+
+    "testMode": {
+      "description": "Set to true invoking API Extractor's test harness. When \"testMode\" is true, the \"toolVersion\" field in the .api.json file is assigned an empty string to prevent spurious diffs in output files tracked for tests.",
+      "type": "boolean"
+    }
+  },
+  "required": ["mainEntryPointFilePath"],
+  "additionalProperties": false,
+
+  "definitions": {
+    "extractorMessageReportingTable": {
+      "type": "object",
+      "description": "Specifies a table of reporting rules for different message identifiers, and also the default rule used for identifiers that do not appear in the table. The key is a message identifier for the associated type of message, or \"default\" to specify the default policy. For example, the key might be \"TS2551\" (a compiler message), \"tsdoc-link-tag-unescaped-text\" (a TSDOc message), or \"ae-extra-release-tag\" (a message related to the API Extractor analysis).",
+      "patternProperties": {
+        ".+": {
+          "type": "object",
+          "description": "Configures reporting for a given message identifier.",
+          "properties": {
+            "logLevel": {
+              "type": "string",
+              "description": "Specifies whether the message should be written to the the tool's output log. Note that the \"addToApiReportFile\" property may supersede this option.",
+              "enum": ["error", "warning", "none"]
+            },
+            "addToApiReportFile": {
+              "type": "boolean",
+              "description": "If API Extractor is configured to write an API review file (.api.md), then the message will be written inside that file.  If the API review file is NOT being written, then the message is instead logged according to the \"logLevel\" option."
+            }
+          },
+          "additionalProperties": false,
+          "required": ["logLevel"]
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/lib/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,uCAAyB;AACzB,oDAA4B;AAE5B,2EAAwE;AACxE,+CAA4C;AAE5C,OAAO,CAAC,GAAG,CACT,EAAE,CAAC,GAAG;IACJ,gBAAM,CAAC,IAAI,CAAC,iBAAiB,qBAAS,CAAC,OAAO,GAAG,GAAG,gBAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAC7G,CAAC;AAEF,MAAM,MAAM,GAA4B,IAAI,iDAAuB,EAAE,CAAC;AAEtE,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,gBAAM,CAAC,GAAG,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport * as os from 'os';\r\nimport colors from 'colors';\r\n\r\nimport { ApiExtractorCommandLine } from './cli/ApiExtractorCommandLine';\r\nimport { Extractor } from './api/Extractor';\r\n\r\nconsole.log(\r\n  os.EOL +\r\n    colors.bold(`api-extractor ${Extractor.version} ` + colors.cyan(' - https://api-extractor.com/') + os.EOL)\r\n);\r\n\r\nconst parser: ApiExtractorCommandLine = new ApiExtractorCommandLine();\r\n\r\nparser.execute().catch((error) => {\r\n  console.error(colors.red(`An unexpected error occurred: ${error}`));\r\n  process.exit(1);\r\n});\r\n"]}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,uCAAyB;AACzB,oDAA4B;AAE5B,2EAAwE;AACxE,+CAA4C;AAE5C,OAAO,CAAC,GAAG,CACT,EAAE,CAAC,GAAG;IACJ,gBAAM,CAAC,IAAI,CAAC,iBAAiB,qBAAS,CAAC,OAAO,GAAG,GAAG,gBAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAC7G,CAAC;AAEF,MAAM,MAAM,GAA4B,IAAI,iDAAuB,EAAE,CAAC;AAEtE,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,gBAAM,CAAC,GAAG,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as os from 'os';\nimport colors from 'colors';\n\nimport { ApiExtractorCommandLine } from './cli/ApiExtractorCommandLine';\nimport { Extractor } from './api/Extractor';\n\nconsole.log(\n  os.EOL +\n    colors.bold(`api-extractor ${Extractor.version} ` + colors.cyan(' - https://api-extractor.com/') + os.EOL)\n);\n\nconst parser: ApiExtractorCommandLine = new ApiExtractorCommandLine();\n\nparser.execute().catch((error) => {\n  console.error(colors.red(`An unexpected error occurred: ${error}`));\n  process.exit(1);\n});\n"]}

package/package.json

@@ -1,61 +1,64 @@
 {
-	"name": "@microsoft/api-extractor",
-	"version": "7.19.2",
-	"description": "Analyze the exported API for a TypeScript library and generate reviews, documentation, and .d.ts rollups",
-	"keywords": [
-		"typescript",
-		"API",
-		"JSDoc",
-		"AEDoc",
-		"TSDoc",
-		"generate",
-		"documentation",
-		"declaration",
-		"dts",
-		".d.ts",
-		"rollup",
-		"bundle",
-		"compiler",
-		"alpha",
-		"beta"
-	],
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/microsoft/rushstack.git",
-		"directory": "apps/api-extractor"
-	},
-	"homepage": "https://api-extractor.com",
-	"main": "lib/index.js",
-	"typings": "dist/rollup.d.ts",
-	"bin": {
-		"api-extractor": "./bin/api-extractor"
-	},
-	"license": "MIT",
-	"dependencies": {
-		"@microsoft/api-extractor-model": "7.15.1",
-		"@microsoft/tsdoc": "0.13.2",
-		"@microsoft/tsdoc-config": "~0.15.2",
-		"@rushstack/node-core-library": "3.44.2",
-		"@rushstack/rig-package": "0.3.6",
-		"@rushstack/ts-command-line": "4.10.5",
-		"colors": "~1.2.1",
-		"lodash": "~4.17.15",
-		"resolve": "~1.17.0",
-		"semver": "~7.3.0",
-		"source-map": "~0.6.1",
-		"typescript": "~4.5.2"
-	},
-	"devDependencies": {
-		"@rushstack/eslint-config": "2.5.0",
-		"@rushstack/heft": "0.43.0",
-		"@rushstack/heft-node-rig": "1.4.1",
-		"@types/heft-jest": "1.0.1",
-		"@types/lodash": "4.14.116",
-		"@types/node": "12.20.24",
-		"@types/resolve": "1.17.1",
-		"@types/semver": "7.3.5"
-	},
-	"scripts": {
-		"build": "heft test --clean"
-	}
-}
+  "name": "@microsoft/api-extractor",
+  "version": "7.19.5",
+  "description": "Analyze the exported API for a TypeScript library and generate reviews, documentation, and .d.ts rollups",
+  "keywords": [
+    "typescript",
+    "API",
+    "JSDoc",
+    "AEDoc",
+    "TSDoc",
+    "generate",
+    "documentation",
+    "declaration",
+    "dts",
+    ".d.ts",
+    "rollup",
+    "bundle",
+    "compiler",
+    "alpha",
+    "beta"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/rushstack.git",
+    "directory": "apps/api-extractor"
+  },
+  "homepage": "https://api-extractor.com",
+  "main": "lib/index.js",
+  "typings": "dist/rollup.d.ts",
+  "bin": {
+    "api-extractor": "./bin/api-extractor"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@microsoft/api-extractor-model": "7.15.4",
+    "@microsoft/tsdoc": "0.13.2",
+    "@microsoft/tsdoc-config": "~0.15.2",
+    "@rushstack/node-core-library": "3.45.1",
+    "@rushstack/rig-package": "0.3.8",
+    "@rushstack/ts-command-line": "4.10.7",
+    "colors": "~1.2.1",
+    "lodash": "~4.17.15",
+    "resolve": "~1.17.0",
+    "semver": "~7.3.0",
+    "source-map": "~0.6.1",
+    "typescript": "~4.5.2"
+  },
+  "devDependencies": {
+    "@rushstack/eslint-config": "2.5.2",
+    "@rushstack/heft": "0.44.2",
+    "@rushstack/heft-node-rig": "1.7.1",
+    "@types/heft-jest": "1.0.1",
+    "@types/lodash": "4.14.116",
+    "@types/node": "12.20.24",
+    "@types/resolve": "1.17.1",
+    "@types/semver": "7.3.5"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "_phase:build": "heft build --clean",
+    "_phase:test": "heft test --no-build"
+  },
+  "readme": "# @microsoft/api-extractor\n\n\n![API Extractor](https://github.com/microsoft/rushstack/raw/master/common/wiki-images/api-extractor-title.png?raw=true)\n<br />\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; https://api-extractor.com/\n\n<!-- ------------------------------------------------------------------ -->\n<!-- Text below this line should stay in sync with the web site content -->\n<!-- ------------------------------------------------------------------ -->\n\n**API Extractor** helps you build better [TypeScript](https://www.typescriptlang.org/) library packages.  Suppose for example that your company has published an NPM package called \"**awesome-widgets**\" that exports many classes and interfaces.  As developers start to depend on your library, you may encounter issues such as...\n\n- **Accidental breaks:**  People keep reporting that their code won't compile after a supposedly \"minor\" update.  To address this, you boldly propose that every **awesome-widgets** pull request must be approved by an experienced developer from your team.  But that proves unrealistic -- nobody has time to look at every single PR!  What you really need is a way to detect PRs that change API contracts, and flag them for review.  That would focus attention in the right place... but how to do that?\n\n- **Missing exports:** Suppose the **awesome-widgets** package exports an API function `AwesomeButton.draw()` that requires a parameter of type `DrawStyle`, but you forgot to export this enum.  Things seem fine at first, but when a developer tries to call that function, they discover that there's no way to specify the `DrawStyle`.  How to avoid these oversights?\n\n- **Accidental exports:** You meant for your `DrawHelper` class to be kept internal, but one day you realize it's being exported.  When you try to remove it, consumers complain that they're using it.  How do we avoid this in the future?\n\n- **Alpha/Beta graduation:**  You want to release previews of new APIs that are not ready for prime time yet.  But if you did a major SemVer bump every time these definitions evolve, the villagers would be after you with torches and pitchforks!  A better approach is to designate certain classes/members as **alpha** quality, then promote them to **beta** and finally to **public** as they mature.  But how to indicate this to your consumers?  (And how to detect scoping mistakes?  A **public** function should never return a **beta** result.)\n\n- **\\*.d.ts rollup:** You webpacked your library into a nice **\\*.js** bundle file -- so why ship your typings as a messy tree of **lib/\\*.d.ts** files full of private definitions?  Can't we consolidate them into a tidy **\\*.d.ts** rollup file?  And if you publish internal/beta/public releases, each release type should get its own **\\*.d.ts** file with appropriate trimming.  Developers building a production project don't want to see a bunch of **internal** and **beta** members in their VS Code IntelliSense!\n\n- **Online documentation:**  You have faithfully annotated each TypeScript member with nice [TSDoc](https://github.com/microsoft/tsdoc) descriptions.  Now that your library has shipped, it's time to set up [a nicely formatted](https://docs.microsoft.com/en-us/javascript/api/sp-http) API reference.  What tool to use?\n\n**API Extractor** provides an integrated, professional-quality solution for all these problems.  It is invoked at build time by your toolchain and leverages the TypeScript compiler engine to:\n\n- Detect a project's exported API surface\n- Capture the contracts in a concise report designed to facilitate review\n- Warn about common mistakes (e.g. missing exports, inconsistent visibility, etc.)\n- Generate \\*.d.ts rollups with trimming according to release type\n- Output API documentation in a portable format that's easy to integrate with your content pipeline\n\nBest of all, **API Extractor** is free and open source.  Join the community and create a pull request!\n\n<!-- ------------------------------------------------------------------ -->\n<!-- Text above this line should stay in sync with the web site content -->\n<!-- ------------------------------------------------------------------ -->\n\n## Getting Started\n\nFor more details and support resources, please visit: https://api-extractor.com/\n\n## Links\n\n- [CHANGELOG.md](\n  https://github.com/microsoft/rushstack/blob/master/apps/api-extractor/CHANGELOG.md) - Find\n  out what's new in the latest version\n- [API Reference](https://rushstack.io/pages/api/api-extractor/)\n\nAPI Extractor is part of the [Rush Stack](https://rushstack.io/) family of projects.\n"
+}