@microsoft/api-extractor 7.23.1 → 7.24.1

package/dist/rollup.d.ts

@@ -550,7 +550,12 @@ export declare const enum ExtractorMessageId {
     /**
      * "The property ___ has a setter but no getter."
      */
-    MissingGetter = "ae-missing-getter"
+    MissingGetter = "ae-missing-getter",
+    /**
+     * "Incorrect file type; API Extractor expects to analyze compiler outputs with the .d.ts file extension.
+     * Troubleshooting tips: `https://api-extractor.com/link/dts-error`"
+     */
+    WrongInputFileType = "ae-wrong-input-file-type"
 }
 
 /**

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.23.0"
+      "packageVersion": "7.23.1"
     }
   ]
 }

package/lib/api/ExtractorMessageId.d.ts

@@ -77,7 +77,12 @@ export declare const enum ExtractorMessageId {
     /**
      * "The property ___ has a setter but no getter."
      */
-    MissingGetter = "ae-missing-getter"
+    MissingGetter = "ae-missing-getter",
+    /**
+     * "Incorrect file type; API Extractor expects to analyze compiler outputs with the .d.ts file extension.
+     * Troubleshooting tips: `https://api-extractor.com/link/dts-error`"
+     */
+    WrongInputFileType = "ae-wrong-input-file-type"
 }
 export declare const allExtractorMessageIds: Set<string>;
 //# sourceMappingURL=ExtractorMessageId.d.ts.map

package/lib/api/ExtractorMessageId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExtractorMessageId.d.ts","sourceRoot":"","sources":["../../src/api/ExtractorMessageId.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,0BAAkB,kBAAkB;IAClC;;OAEG;IACH,eAAe,yBAAyB;IAExC;;OAEG;IACH,oBAAoB,8BAA8B;IAElD;;OAEG;IACH,uBAAuB,iCAAiC;IAExD;;OAEG;IACH,iBAAiB,2BAA2B;IAE5C;;OAEG;IACH,mBAAmB,6BAA6B;IAEhD;;OAEG;IACH,eAAe,wBAAwB;IAEvC;;OAEG;IACH,yBAAyB,mCAAmC;IAE5D;;OAEG;IACH,uBAAuB,kCAAkC;IAEzD;;OAEG;IACH,0BAA0B,oCAAoC;IAE9D;;OAEG;IACH,wBAAwB,mCAAmC;IAE3D;;OAEG;IACH,6BAA6B,uCAAuC;IAEpE;;;;;;;OAOG;IACH,wBAAwB,kCAAkC;IAE1D;;OAEG;IACH,gBAAgB,0BAA0B;IAE1C;;OAEG;IACH,cAAc,uBAAuB;IAErC;;OAEG;IACH,cAAc,wBAAwB;IAEtC;;OAEG;IACH,aAAa,sBAAsB;CACpC;AAED,eAAO,MAAM,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAiB7C,CAAC"}
+{"version":3,"file":"ExtractorMessageId.d.ts","sourceRoot":"","sources":["../../src/api/ExtractorMessageId.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,0BAAkB,kBAAkB;IAClC;;OAEG;IACH,eAAe,yBAAyB;IAExC;;OAEG;IACH,oBAAoB,8BAA8B;IAElD;;OAEG;IACH,uBAAuB,iCAAiC;IAExD;;OAEG;IACH,iBAAiB,2BAA2B;IAE5C;;OAEG;IACH,mBAAmB,6BAA6B;IAEhD;;OAEG;IACH,eAAe,wBAAwB;IAEvC;;OAEG;IACH,yBAAyB,mCAAmC;IAE5D;;OAEG;IACH,uBAAuB,kCAAkC;IAEzD;;OAEG;IACH,0BAA0B,oCAAoC;IAE9D;;OAEG;IACH,wBAAwB,mCAAmC;IAE3D;;OAEG;IACH,6BAA6B,uCAAuC;IAEpE;;;;;;;OAOG;IACH,wBAAwB,kCAAkC;IAE1D;;OAEG;IACH,gBAAgB,0BAA0B;IAE1C;;OAEG;IACH,cAAc,uBAAuB;IAErC;;OAEG;IACH,cAAc,wBAAwB;IAEtC;;OAEG;IACH,aAAa,sBAAsB;IAEnC;;;OAGG;IACH,kBAAkB,6BAA6B;CAChD;AAED,eAAO,MAAM,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAkB7C,CAAC"}

package/lib/api/ExtractorMessageId.js

@@ -19,6 +19,7 @@ exports.allExtractorMessageIds = new Set([
     'ae-cyclic-inherit-doc',
     'ae-unresolved-link',
     'ae-setter-with-docs',
-    'ae-missing-getter'
+    'ae-missing-getter',
+    'ae-wrong-input-file-type'
 ]);
 //# sourceMappingURL=ExtractorMessageId.js.map

package/lib/api/ExtractorMessageId.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExtractorMessageId.js","sourceRoot":"","sources":["../../src/api/ExtractorMessageId.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAmG9C,QAAA,sBAAsB,GAAgB,IAAI,GAAG,CAAS;IACjE,sBAAsB;IACtB,2BAA2B;IAC3B,8BAA8B;IAC9B,wBAAwB;IACxB,0BAA0B;IAC1B,qBAAqB;IACrB,gCAAgC;IAChC,+BAA+B;IAC/B,iCAAiC;IACjC,gCAAgC;IAChC,oCAAoC;IACpC,+BAA+B;IAC/B,uBAAuB;IACvB,oBAAoB;IACpB,qBAAqB;IACrB,mBAAmB;CACpB,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\n/**\n * Unique identifiers for messages reported by API Extractor during its analysis.\n *\n * @remarks\n *\n * These strings are possible values for the {@link ExtractorMessage.messageId} property\n * when the `ExtractorMessage.category` is {@link ExtractorMessageCategory.Extractor}.\n *\n * @public\n */\nexport const enum ExtractorMessageId {\n  /**\n   * \"The doc comment should not contain more than one release tag.\"\n   */\n  ExtraReleaseTag = 'ae-extra-release-tag',\n\n  /**\n   * \"This symbol has another declaration with a different release tag.\"\n   */\n  DifferentReleaseTags = 'ae-different-release-tags',\n\n  /**\n   * \"The symbol ___ is marked as ___, but its signature references ___ which is marked as ___.\"\n   */\n  IncompatibleReleaseTags = 'ae-incompatible-release-tags',\n\n  /**\n   * \"___ is exported by the package, but it is missing a release tag (`@alpha`, `@beta`, `@public`, or `@internal`).\"\n   */\n  MissingReleaseTag = 'ae-missing-release-tag',\n\n  /**\n   * \"The `@packageDocumentation` comment must appear at the top of entry point *.d.ts file.\"\n   */\n  MisplacedPackageTag = 'ae-misplaced-package-tag',\n\n  /**\n   * \"The symbol ___ needs to be exported by the entry point ___.\"\n   */\n  ForgottenExport = 'ae-forgotten-export',\n\n  /**\n   * \"The name ___ should be prefixed with an underscore because the declaration is marked as `@internal`.\"\n   */\n  InternalMissingUnderscore = 'ae-internal-missing-underscore',\n\n  /**\n   * \"Mixed release tags are not allowed for ___ because one of its declarations is marked as `@internal`.\"\n   */\n  InternalMixedReleaseTag = 'ae-internal-mixed-release-tag',\n\n  /**\n   * \"The `@preapproved` tag cannot be applied to ___ because it is not a supported declaration type.\"\n   */\n  PreapprovedUnsupportedType = 'ae-preapproved-unsupported-type',\n\n  /**\n   * \"The `@preapproved` tag cannot be applied to ___ without an `@internal` release tag.\"\n   */\n  PreapprovedBadReleaseTag = 'ae-preapproved-bad-release-tag',\n\n  /**\n   * \"The `@inheritDoc` reference could not be resolved.\"\n   */\n  UnresolvedInheritDocReference = 'ae-unresolved-inheritdoc-reference',\n\n  /**\n   * \"The `@inheritDoc` tag needs a TSDoc declaration reference; signature matching is not supported yet.\"\n   *\n   * @privateRemarks\n   * In the future, we will implement signature matching so that you can write `{@inheritDoc}` and API Extractor\n   * will find a corresponding member from a base class (or implemented interface).  Until then, the tag\n   * always needs an explicit declaration reference such as `{@inhertDoc MyBaseClass.sameMethod}`.\n   */\n  UnresolvedInheritDocBase = 'ae-unresolved-inheritdoc-base',\n\n  /**\n   * \"The `@inheritDoc` tag for ___ refers to its own declaration.\"\n   */\n  CyclicInheritDoc = 'ae-cyclic-inherit-doc',\n\n  /**\n   * \"The `@link` reference could not be resolved.\"\n   */\n  UnresolvedLink = 'ae-unresolved-link',\n\n  /**\n   * \"The doc comment for the property ___ must appear on the getter, not the setter.\"\n   */\n  SetterWithDocs = 'ae-setter-with-docs',\n\n  /**\n   * \"The property ___ has a setter but no getter.\"\n   */\n  MissingGetter = 'ae-missing-getter'\n}\n\nexport const allExtractorMessageIds: Set<string> = new Set<string>([\n  'ae-extra-release-tag',\n  'ae-different-release-tags',\n  'ae-incompatible-release-tags',\n  'ae-missing-release-tag',\n  'ae-misplaced-package-tag',\n  'ae-forgotten-export',\n  'ae-internal-missing-underscore',\n  'ae-internal-mixed-release-tag',\n  'ae-preapproved-unsupported-type',\n  'ae-preapproved-bad-release-tag',\n  'ae-unresolved-inheritdoc-reference',\n  'ae-unresolved-inheritdoc-base',\n  'ae-cyclic-inherit-doc',\n  'ae-unresolved-link',\n  'ae-setter-with-docs',\n  'ae-missing-getter'\n]);\n"]}
+{"version":3,"file":"ExtractorMessageId.js","sourceRoot":"","sources":["../../src/api/ExtractorMessageId.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAyG9C,QAAA,sBAAsB,GAAgB,IAAI,GAAG,CAAS;IACjE,sBAAsB;IACtB,2BAA2B;IAC3B,8BAA8B;IAC9B,wBAAwB;IACxB,0BAA0B;IAC1B,qBAAqB;IACrB,gCAAgC;IAChC,+BAA+B;IAC/B,iCAAiC;IACjC,gCAAgC;IAChC,oCAAoC;IACpC,+BAA+B;IAC/B,uBAAuB;IACvB,oBAAoB;IACpB,qBAAqB;IACrB,mBAAmB;IACnB,0BAA0B;CAC3B,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\n/**\n * Unique identifiers for messages reported by API Extractor during its analysis.\n *\n * @remarks\n *\n * These strings are possible values for the {@link ExtractorMessage.messageId} property\n * when the `ExtractorMessage.category` is {@link ExtractorMessageCategory.Extractor}.\n *\n * @public\n */\nexport const enum ExtractorMessageId {\n  /**\n   * \"The doc comment should not contain more than one release tag.\"\n   */\n  ExtraReleaseTag = 'ae-extra-release-tag',\n\n  /**\n   * \"This symbol has another declaration with a different release tag.\"\n   */\n  DifferentReleaseTags = 'ae-different-release-tags',\n\n  /**\n   * \"The symbol ___ is marked as ___, but its signature references ___ which is marked as ___.\"\n   */\n  IncompatibleReleaseTags = 'ae-incompatible-release-tags',\n\n  /**\n   * \"___ is exported by the package, but it is missing a release tag (`@alpha`, `@beta`, `@public`, or `@internal`).\"\n   */\n  MissingReleaseTag = 'ae-missing-release-tag',\n\n  /**\n   * \"The `@packageDocumentation` comment must appear at the top of entry point *.d.ts file.\"\n   */\n  MisplacedPackageTag = 'ae-misplaced-package-tag',\n\n  /**\n   * \"The symbol ___ needs to be exported by the entry point ___.\"\n   */\n  ForgottenExport = 'ae-forgotten-export',\n\n  /**\n   * \"The name ___ should be prefixed with an underscore because the declaration is marked as `@internal`.\"\n   */\n  InternalMissingUnderscore = 'ae-internal-missing-underscore',\n\n  /**\n   * \"Mixed release tags are not allowed for ___ because one of its declarations is marked as `@internal`.\"\n   */\n  InternalMixedReleaseTag = 'ae-internal-mixed-release-tag',\n\n  /**\n   * \"The `@preapproved` tag cannot be applied to ___ because it is not a supported declaration type.\"\n   */\n  PreapprovedUnsupportedType = 'ae-preapproved-unsupported-type',\n\n  /**\n   * \"The `@preapproved` tag cannot be applied to ___ without an `@internal` release tag.\"\n   */\n  PreapprovedBadReleaseTag = 'ae-preapproved-bad-release-tag',\n\n  /**\n   * \"The `@inheritDoc` reference could not be resolved.\"\n   */\n  UnresolvedInheritDocReference = 'ae-unresolved-inheritdoc-reference',\n\n  /**\n   * \"The `@inheritDoc` tag needs a TSDoc declaration reference; signature matching is not supported yet.\"\n   *\n   * @privateRemarks\n   * In the future, we will implement signature matching so that you can write `{@inheritDoc}` and API Extractor\n   * will find a corresponding member from a base class (or implemented interface).  Until then, the tag\n   * always needs an explicit declaration reference such as `{@inhertDoc MyBaseClass.sameMethod}`.\n   */\n  UnresolvedInheritDocBase = 'ae-unresolved-inheritdoc-base',\n\n  /**\n   * \"The `@inheritDoc` tag for ___ refers to its own declaration.\"\n   */\n  CyclicInheritDoc = 'ae-cyclic-inherit-doc',\n\n  /**\n   * \"The `@link` reference could not be resolved.\"\n   */\n  UnresolvedLink = 'ae-unresolved-link',\n\n  /**\n   * \"The doc comment for the property ___ must appear on the getter, not the setter.\"\n   */\n  SetterWithDocs = 'ae-setter-with-docs',\n\n  /**\n   * \"The property ___ has a setter but no getter.\"\n   */\n  MissingGetter = 'ae-missing-getter',\n\n  /**\n   * \"Incorrect file type; API Extractor expects to analyze compiler outputs with the .d.ts file extension.\n   * Troubleshooting tips: `https://api-extractor.com/link/dts-error`\"\n   */\n  WrongInputFileType = 'ae-wrong-input-file-type'\n}\n\nexport const allExtractorMessageIds: Set<string> = new Set<string>([\n  'ae-extra-release-tag',\n  'ae-different-release-tags',\n  'ae-incompatible-release-tags',\n  'ae-missing-release-tag',\n  'ae-misplaced-package-tag',\n  'ae-forgotten-export',\n  'ae-internal-missing-underscore',\n  'ae-internal-mixed-release-tag',\n  'ae-preapproved-unsupported-type',\n  'ae-preapproved-bad-release-tag',\n  'ae-unresolved-inheritdoc-reference',\n  'ae-unresolved-inheritdoc-base',\n  'ae-cyclic-inherit-doc',\n  'ae-unresolved-link',\n  'ae-setter-with-docs',\n  'ae-missing-getter',\n  'ae-wrong-input-file-type'\n]);\n"]}

package/lib/collector/Collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Collector.d.ts","sourceRoot":"","sources":["../../src/collector/Collector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Collector.d.ts","sourceRoot":"","sources":["../../src/collector/Collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAuB,MAAM,8BAA8B,CAAC;AAKtF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAA+B,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,eAAe,EAA2B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAuB,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IAEpB,aAAa,EAAE,aAAa,CAAC;IAE7B,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,SAAgB,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpC,SAAgB,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC;IAC5C,SAAgB,sBAAsB,EAAE,uBAAuB,CAAC;IAChE,SAAgB,cAAc,EAAE,cAAc,CAAC;IAC/C,SAAgB,oBAAoB,EAAE,oBAAoB,CAAC;IAE3D,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,aAAa,EAAE,aAAa,CAAC;IAE7C,SAAgB,cAAc,EAAE,cAAc,CAAC;IAE/C,SAAgB,eAAe,EAAE,eAAe,CAAC;IAEjD;;OAEG;IACH,SAAgB,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IAEtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IAEjD,OAAO,CAAC,cAAc,CAAwB;IAE9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGjC;IAEJ,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAgB;IAEjE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAkC;IAC9E,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAkC;IAG7E,OAAO,CAAC,QAAQ,CAAC,mCAAmC,CAA8B;gBAE/D,OAAO,EAAE,iBAAiB;IAgD7C;;;;;;OAMG;IACH,IAAW,0BAA0B,IAAI,WAAW,CAAC,MAAM,CAAC,CAE3D;IAED;;;;;;OAMG;IACH,IAAW,yBAAyB,IAAI,WAAW,CAAC,MAAM,CAAC,CAE1D;IAED,IAAW,QAAQ,IAAI,aAAa,CAAC,eAAe,CAAC,CAEpD;IAED;;;OAGG;IACH,IAAW,+BAA+B,IAAI,aAAa,CAAC,MAAM,CAAC,CAElE;IAED;;OAEG;IACI,OAAO,IAAI,IAAI;IA6GtB;;;;;OAKG;IACI,mBAAmB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,cAAc,GAAG,eAAe,GAAG,SAAS;IAQtG;;OAEG;IACI,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS;IAIxE,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc;IAOzD,wBAAwB,CAAC,cAAc,EAAE,cAAc,GAAG,mBAAmB;IAQ7E,oBAAoB,CAAC,cAAc,EAAE,cAAc,GAAG,eAAe;IAQrE,4BAA4B,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,GAAG,SAAS;IAY9E,sBAAsB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO;IAK/D,2BAA2B,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAAC,cAAc,CAAC;IAWvF;;;;;;;OAOG;WACW,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;IAelF;;;OAGG;IACI,gBAAgB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM;IA8B/D,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,kCAAkC;IAyC1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmFxB,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,4CAA4C;IAwCpD,OAAO,CAAC,wBAAwB;IA4ChC,OAAO,CAAC,yBAAyB;IAmKjC,OAAO,CAAC,4BAA4B;IAyDpC,OAAO,CAAC,2BAA2B;IAcnC,OAAO,CAAC,0CAA0C;CA2BnD"}

package/lib/collector/Collector.js

@@ -41,6 +41,7 @@ const ApiItemMetadata_1 = require("./ApiItemMetadata");
 const SymbolMetadata_1 = require("./SymbolMetadata");
 const TypeScriptInternals_1 = require("../analyzer/TypeScriptInternals");
 const AstReferenceResolver_1 = require("../analyzer/AstReferenceResolver");
+const ExtractorConfig_1 = require("../api/ExtractorConfig");
 const AstNamespaceImport_1 = require("../analyzer/AstNamespaceImport");
 const AstImport_1 = require("../analyzer/AstImport");
 /**
@@ -126,6 +127,7 @@ class Collector {
         for (const diagnostic of this._program.getSemanticDiagnostics()) {
             this.messageRouter.addCompilerDiagnostic(diagnostic);
         }
+        const sourceFiles = this.program.getSourceFiles();
         if (this.messageRouter.showDiagnostics) {
             this.messageRouter.logDiagnosticHeader('Root filenames');
             for (const fileName of this.program.getRootFileNames()) {
@@ -133,11 +135,19 @@ class Collector {
             }
             this.messageRouter.logDiagnosticFooter();
             this.messageRouter.logDiagnosticHeader('Files analyzed by compiler');
-            for (const sourceFile of this.program.getSourceFiles()) {
+            for (const sourceFile of sourceFiles) {
                 this.messageRouter.logDiagnostic(sourceFile.fileName);
             }
             this.messageRouter.logDiagnosticFooter();
         }
+        // We can throw this error earlier in CompilerState.ts, but intentionally wait until after we've logged the
+        // associated diagnostic message above to make debugging easier for developers.
+        // Typically there will be many such files -- to avoid too much noise, only report the first one.
+        const badSourceFile = sourceFiles.find(({ fileName }) => !ExtractorConfig_1.ExtractorConfig.hasDtsFileExtension(fileName));
+        if (badSourceFile) {
+            this.messageRouter.addAnalyzerIssueForPosition("ae-wrong-input-file-type" /* WrongInputFileType */, 'Incorrect file type; API Extractor expects to analyze compiler outputs with the .d.ts file extension. ' +
+                'Troubleshooting tips: https://api-extractor.com/link/dts-error', badSourceFile, 0);
+        }
         // Build the entry point
         const entryPointSourceFile = this.workingPackage.entryPointSourceFile;
         const astEntryPoint = this.astSymbolTable.fetchAstModuleFromWorkingPackage(entryPointSourceFile);

package/lib/collector/Collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"Collector.js","sourceRoot":"","sources":["../../src/collector/Collector.ts"],"names":[],"mappings":"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","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 ts from 'typescript';\nimport * as tsdoc from '@microsoft/tsdoc';\nimport { PackageJsonLookup, Sort, InternalError } from '@rushstack/node-core-library';\nimport { ReleaseTag } from '@microsoft/api-extractor-model';\n\nimport { ExtractorMessageId } from '../api/ExtractorMessageId';\n\nimport { CollectorEntity } from './CollectorEntity';\nimport { AstSymbolTable } from '../analyzer/AstSymbolTable';\nimport { AstEntity } from '../analyzer/AstEntity';\nimport { AstModule, AstModuleExportInfo } from '../analyzer/AstModule';\nimport { AstSymbol } from '../analyzer/AstSymbol';\nimport { AstDeclaration } from '../analyzer/AstDeclaration';\nimport { TypeScriptHelpers } from '../analyzer/TypeScriptHelpers';\nimport { WorkingPackage } from './WorkingPackage';\nimport { PackageDocComment } from '../aedoc/PackageDocComment';\nimport { DeclarationMetadata, InternalDeclarationMetadata } from './DeclarationMetadata';\nimport { ApiItemMetadata, IApiItemMetadataOptions } from './ApiItemMetadata';\nimport { SymbolMetadata } from './SymbolMetadata';\nimport { TypeScriptInternals, IGlobalVariableAnalyzer } from '../analyzer/TypeScriptInternals';\nimport { MessageRouter } from './MessageRouter';\nimport { AstReferenceResolver } from '../analyzer/AstReferenceResolver';\nimport { ExtractorConfig } from '../api/ExtractorConfig';\nimport { AstNamespaceImport } from '../analyzer/AstNamespaceImport';\nimport { AstImport } from '../analyzer/AstImport';\n\n/**\n * Options for Collector constructor.\n */\nexport interface ICollectorOptions {\n  /**\n   * Configuration for the TypeScript compiler.  The most important options to set are:\n   *\n   * - target: ts.ScriptTarget.ES5\n   * - module: ts.ModuleKind.CommonJS\n   * - moduleResolution: ts.ModuleResolutionKind.NodeJs\n   * - rootDir: inputFolder\n   */\n  program: ts.Program;\n\n  messageRouter: MessageRouter;\n\n  extractorConfig: ExtractorConfig;\n}\n\n/**\n * The `Collector` manages the overall data set that is used by `ApiModelGenerator`,\n * `DtsRollupGenerator`, and `ApiReportGenerator`.  Starting from the working package's entry point,\n * the `Collector` collects all exported symbols, determines how to import any symbols they reference,\n * assigns unique names, and sorts everything into a normalized alphabetical ordering.\n */\nexport class Collector {\n  public readonly program: ts.Program;\n  public readonly typeChecker: ts.TypeChecker;\n  public readonly globalVariableAnalyzer: IGlobalVariableAnalyzer;\n  public readonly astSymbolTable: AstSymbolTable;\n  public readonly astReferenceResolver: AstReferenceResolver;\n\n  public readonly packageJsonLookup: PackageJsonLookup;\n  public readonly messageRouter: MessageRouter;\n\n  public readonly workingPackage: WorkingPackage;\n\n  public readonly extractorConfig: ExtractorConfig;\n\n  /**\n   * The `ExtractorConfig.bundledPackages` names in a set.\n   */\n  public readonly bundledPackageNames: ReadonlySet<string>;\n\n  private readonly _program: ts.Program;\n\n  private readonly _tsdocParser: tsdoc.TSDocParser;\n\n  private _astEntryPoint: AstModule | undefined;\n\n  private readonly _entities: CollectorEntity[] = [];\n  private readonly _entitiesByAstEntity: Map<AstEntity, CollectorEntity> = new Map<\n    AstEntity,\n    CollectorEntity\n  >();\n\n  private readonly _starExportedExternalModulePaths: string[] = [];\n\n  private readonly _dtsTypeReferenceDirectives: Set<string> = new Set<string>();\n  private readonly _dtsLibReferenceDirectives: Set<string> = new Set<string>();\n\n  // Used by getOverloadIndex()\n  private readonly _cachedOverloadIndexesByDeclaration: Map<AstDeclaration, number>;\n\n  public constructor(options: ICollectorOptions) {\n    this.packageJsonLookup = new PackageJsonLookup();\n\n    this._program = options.program;\n    this.extractorConfig = options.extractorConfig;\n\n    const entryPointSourceFile: ts.SourceFile | undefined = options.program.getSourceFile(\n      this.extractorConfig.mainEntryPointFilePath\n    );\n\n    if (!entryPointSourceFile) {\n      throw new Error('Unable to load file: ' + this.extractorConfig.mainEntryPointFilePath);\n    }\n\n    if (!this.extractorConfig.packageFolder || !this.extractorConfig.packageJson) {\n      // TODO: We should be able to analyze projects that don't have any package.json.\n      // The ExtractorConfig class is already designed to allow this.\n      throw new Error('Unable to find a package.json file for the project being analyzed');\n    }\n\n    this.workingPackage = new WorkingPackage({\n      packageFolder: this.extractorConfig.packageFolder,\n      packageJson: this.extractorConfig.packageJson,\n      entryPointSourceFile\n    });\n\n    this.messageRouter = options.messageRouter;\n\n    this.program = options.program;\n    this.typeChecker = options.program.getTypeChecker();\n    this.globalVariableAnalyzer = TypeScriptInternals.getGlobalVariableAnalyzer(this.program);\n\n    this._tsdocParser = new tsdoc.TSDocParser(this.extractorConfig.tsdocConfiguration);\n\n    this.bundledPackageNames = new Set<string>(this.extractorConfig.bundledPackages);\n\n    this.astSymbolTable = new AstSymbolTable(\n      this.program,\n      this.typeChecker,\n      this.packageJsonLookup,\n      this.bundledPackageNames,\n      this.messageRouter\n    );\n    this.astReferenceResolver = new AstReferenceResolver(this);\n\n    this._cachedOverloadIndexesByDeclaration = new Map<AstDeclaration, number>();\n  }\n\n  /**\n   * Returns a list of names (e.g. \"example-library\") that should appear in a reference like this:\n   *\n   * ```\n   * /// <reference types=\"example-library\" />\n   * ```\n   */\n  public get dtsTypeReferenceDirectives(): ReadonlySet<string> {\n    return this._dtsTypeReferenceDirectives;\n  }\n\n  /**\n   * A list of names (e.g. \"runtime-library\") that should appear in a reference like this:\n   *\n   * ```\n   * /// <reference lib=\"runtime-library\" />\n   * ```\n   */\n  public get dtsLibReferenceDirectives(): ReadonlySet<string> {\n    return this._dtsLibReferenceDirectives;\n  }\n\n  public get entities(): ReadonlyArray<CollectorEntity> {\n    return this._entities;\n  }\n\n  /**\n   * A list of module specifiers (e.g. `\"@rushstack/node-core-library/lib/FileSystem\"`) that should be emitted\n   * as star exports (e.g. `export * from \"@rushstack/node-core-library/lib/FileSystem\"`).\n   */\n  public get starExportedExternalModulePaths(): ReadonlyArray<string> {\n    return this._starExportedExternalModulePaths;\n  }\n\n  /**\n   * Perform the analysis.\n   */\n  public analyze(): void {\n    if (this._astEntryPoint) {\n      throw new Error('DtsRollupGenerator.analyze() was already called');\n    }\n\n    // This runs a full type analysis, and then augments the Abstract Syntax Tree (i.e. declarations)\n    // with semantic information (i.e. symbols).  The \"diagnostics\" are a subset of the everyday\n    // compile errors that would result from a full compilation.\n    for (const diagnostic of this._program.getSemanticDiagnostics()) {\n      this.messageRouter.addCompilerDiagnostic(diagnostic);\n    }\n\n    if (this.messageRouter.showDiagnostics) {\n      this.messageRouter.logDiagnosticHeader('Root filenames');\n      for (const fileName of this.program.getRootFileNames()) {\n        this.messageRouter.logDiagnostic(fileName);\n      }\n      this.messageRouter.logDiagnosticFooter();\n\n      this.messageRouter.logDiagnosticHeader('Files analyzed by compiler');\n      for (const sourceFile of this.program.getSourceFiles()) {\n        this.messageRouter.logDiagnostic(sourceFile.fileName);\n      }\n      this.messageRouter.logDiagnosticFooter();\n    }\n\n    // Build the entry point\n    const entryPointSourceFile: ts.SourceFile = this.workingPackage.entryPointSourceFile;\n\n    const astEntryPoint: AstModule =\n      this.astSymbolTable.fetchAstModuleFromWorkingPackage(entryPointSourceFile);\n    this._astEntryPoint = astEntryPoint;\n\n    const packageDocCommentTextRange: ts.TextRange | undefined = PackageDocComment.tryFindInSourceFile(\n      entryPointSourceFile,\n      this\n    );\n\n    if (packageDocCommentTextRange) {\n      const range: tsdoc.TextRange = tsdoc.TextRange.fromStringRange(\n        entryPointSourceFile.text,\n        packageDocCommentTextRange.pos,\n        packageDocCommentTextRange.end\n      );\n\n      this.workingPackage.tsdocParserContext = this._tsdocParser.parseRange(range);\n\n      this.messageRouter.addTsdocMessages(this.workingPackage.tsdocParserContext, entryPointSourceFile);\n\n      this.workingPackage.tsdocComment = this.workingPackage.tsdocParserContext!.docComment;\n    }\n\n    const exportedAstEntities: AstEntity[] = [];\n\n    // Create a CollectorEntity for each top-level export\n\n    const astModuleExportInfo: AstModuleExportInfo =\n      this.astSymbolTable.fetchAstModuleExportInfo(astEntryPoint);\n\n    for (const [exportName, astEntity] of astModuleExportInfo.exportedLocalEntities) {\n      this._createCollectorEntity(astEntity, exportName);\n\n      exportedAstEntities.push(astEntity);\n    }\n\n    // Create a CollectorEntity for each indirectly referenced export.\n    // Note that we do this *after* the above loop, so that references to exported AstSymbols\n    // are encountered first as exports.\n    const alreadySeenAstSymbols: Set<AstSymbol> = new Set<AstSymbol>();\n    for (const exportedAstEntity of exportedAstEntities) {\n      this._createEntityForIndirectReferences(exportedAstEntity, alreadySeenAstSymbols);\n\n      if (exportedAstEntity instanceof AstSymbol) {\n        this.fetchSymbolMetadata(exportedAstEntity);\n      }\n    }\n\n    this._makeUniqueNames();\n\n    for (const starExportedExternalModule of astModuleExportInfo.starExportedExternalModules) {\n      if (starExportedExternalModule.externalModulePath !== undefined) {\n        this._starExportedExternalModulePaths.push(starExportedExternalModule.externalModulePath);\n      }\n    }\n\n    Sort.sortBy(this._entities, (x) => x.getSortKey());\n    Sort.sortSet(this._dtsTypeReferenceDirectives);\n    Sort.sortSet(this._dtsLibReferenceDirectives);\n    this._starExportedExternalModulePaths.sort();\n  }\n\n  /**\n   * For a given ts.Identifier that is part of an AstSymbol that we analyzed, return the CollectorEntity that\n   * it refers to.  Returns undefined if it doesn't refer to anything interesting.\n   * @remarks\n   * Throws an Error if the ts.Identifier is not part of node tree that was analyzed.\n   */\n  public tryGetEntityForNode(identifier: ts.Identifier | ts.ImportTypeNode): CollectorEntity | undefined {\n    const astEntity: AstEntity | undefined = this.astSymbolTable.tryGetEntityForNode(identifier);\n    if (astEntity) {\n      return this._entitiesByAstEntity.get(astEntity);\n    }\n    return undefined;\n  }\n\n  /**\n   * Returns the associated `CollectorEntity` for the given `astEntity`, if one was created during analysis.\n   */\n  public tryGetCollectorEntity(astEntity: AstEntity): CollectorEntity | undefined {\n    return this._entitiesByAstEntity.get(astEntity);\n  }\n\n  public fetchSymbolMetadata(astSymbol: AstSymbol): SymbolMetadata {\n    if (astSymbol.symbolMetadata === undefined) {\n      this._fetchSymbolMetadata(astSymbol);\n    }\n    return astSymbol.symbolMetadata as SymbolMetadata;\n  }\n\n  public fetchDeclarationMetadata(astDeclaration: AstDeclaration): DeclarationMetadata {\n    if (astDeclaration.declarationMetadata === undefined) {\n      // Fetching the SymbolMetadata always constructs the DeclarationMetadata\n      this._fetchSymbolMetadata(astDeclaration.astSymbol);\n    }\n    return astDeclaration.declarationMetadata as DeclarationMetadata;\n  }\n\n  public fetchApiItemMetadata(astDeclaration: AstDeclaration): ApiItemMetadata {\n    if (astDeclaration.apiItemMetadata === undefined) {\n      // Fetching the SymbolMetadata always constructs the ApiItemMetadata\n      this._fetchSymbolMetadata(astDeclaration.astSymbol);\n    }\n    return astDeclaration.apiItemMetadata as ApiItemMetadata;\n  }\n\n  public tryFetchMetadataForAstEntity(astEntity: AstEntity): SymbolMetadata | undefined {\n    if (astEntity instanceof AstSymbol) {\n      return this.fetchSymbolMetadata(astEntity);\n    }\n    if (astEntity instanceof AstImport) {\n      if (astEntity.astSymbol) {\n        return this.fetchSymbolMetadata(astEntity.astSymbol);\n      }\n    }\n    return undefined;\n  }\n\n  public isAncillaryDeclaration(astDeclaration: AstDeclaration): boolean {\n    const declarationMetadata: DeclarationMetadata = this.fetchDeclarationMetadata(astDeclaration);\n    return declarationMetadata.isAncillary;\n  }\n\n  public getNonAncillaryDeclarations(astSymbol: AstSymbol): ReadonlyArray<AstDeclaration> {\n    const result: AstDeclaration[] = [];\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      const declarationMetadata: DeclarationMetadata = this.fetchDeclarationMetadata(astDeclaration);\n      if (!declarationMetadata.isAncillary) {\n        result.push(astDeclaration);\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Removes the leading underscore, for example: \"_Example\" --> \"example*Example*_\"\n   *\n   * @remarks\n   * This causes internal definitions to sort alphabetically case-insensitive, then case-sensitive, and\n   * initially ignoring the underscore prefix, while still deterministically comparing it.\n   * The star is used as a delimiter because it is not a legal  identifier character.\n   */\n  public static getSortKeyIgnoringUnderscore(identifier: string | undefined): string {\n    if (!identifier) return '';\n\n    let parts: string[];\n\n    if (identifier[0] === '_') {\n      const withoutUnderscore: string = identifier.substr(1);\n      parts = [withoutUnderscore.toLowerCase(), '*', withoutUnderscore, '*', '_'];\n    } else {\n      parts = [identifier.toLowerCase(), '*', identifier];\n    }\n\n    return parts.join('');\n  }\n\n  /**\n   * For function-like signatures, this returns the TSDoc \"overload index\" which can be used to identify\n   * a specific overload.\n   */\n  public getOverloadIndex(astDeclaration: AstDeclaration): number {\n    const allDeclarations: ReadonlyArray<AstDeclaration> = astDeclaration.astSymbol.astDeclarations;\n    if (allDeclarations.length === 1) {\n      return 1; // trivial case\n    }\n\n    let overloadIndex: number | undefined = this._cachedOverloadIndexesByDeclaration.get(astDeclaration);\n\n    if (overloadIndex === undefined) {\n      // TSDoc index selectors are positive integers counting from 1\n      let nextIndex: number = 1;\n      for (const other of allDeclarations) {\n        // Filter out other declarations that are not overloads.  For example, an overloaded function can also\n        // be a namespace.\n        if (other.declaration.kind === astDeclaration.declaration.kind) {\n          this._cachedOverloadIndexesByDeclaration.set(other, nextIndex);\n          ++nextIndex;\n        }\n      }\n      overloadIndex = this._cachedOverloadIndexesByDeclaration.get(astDeclaration);\n    }\n\n    if (overloadIndex === undefined) {\n      // This should never happen\n      throw new InternalError('Error calculating overload index for declaration');\n    }\n\n    return overloadIndex;\n  }\n\n  private _createCollectorEntity(astEntity: AstEntity, exportedName: string | undefined): CollectorEntity {\n    let entity: CollectorEntity | undefined = this._entitiesByAstEntity.get(astEntity);\n\n    if (!entity) {\n      entity = new CollectorEntity(astEntity);\n\n      this._entitiesByAstEntity.set(astEntity, entity);\n      this._entities.push(entity);\n      this._collectReferenceDirectives(astEntity);\n    }\n\n    if (exportedName) {\n      entity.addExportName(exportedName);\n    }\n\n    return entity;\n  }\n\n  private _createEntityForIndirectReferences(\n    astEntity: AstEntity,\n    alreadySeenAstEntities: Set<AstEntity>\n  ): void {\n    if (alreadySeenAstEntities.has(astEntity)) {\n      return;\n    }\n    alreadySeenAstEntities.add(astEntity);\n\n    if (astEntity instanceof AstSymbol) {\n      astEntity.forEachDeclarationRecursive((astDeclaration: AstDeclaration) => {\n        for (const referencedAstEntity of astDeclaration.referencedAstEntities) {\n          if (referencedAstEntity instanceof AstSymbol) {\n            // We only create collector entities for root-level symbols.\n            // For example, if a symbols is nested inside a namespace, only the root-level namespace\n            // get a collector entity\n            if (referencedAstEntity.parentAstSymbol === undefined) {\n              this._createCollectorEntity(referencedAstEntity, undefined);\n            }\n          } else {\n            this._createCollectorEntity(referencedAstEntity, undefined);\n          }\n\n          this._createEntityForIndirectReferences(referencedAstEntity, alreadySeenAstEntities);\n        }\n      });\n    }\n\n    if (astEntity instanceof AstNamespaceImport) {\n      const astModuleExportInfo: AstModuleExportInfo = astEntity.fetchAstModuleExportInfo(this);\n\n      for (const exportedEntity of astModuleExportInfo.exportedLocalEntities.values()) {\n        // Create a CollectorEntity for each top-level export of AstImportInternal entity\n        const entity: CollectorEntity = this._createCollectorEntity(exportedEntity, undefined);\n        entity.addAstNamespaceImports(astEntity);\n\n        this._createEntityForIndirectReferences(exportedEntity, alreadySeenAstEntities);\n      }\n    }\n  }\n\n  /**\n   * Ensures a unique name for each item in the package typings file.\n   */\n  private _makeUniqueNames(): void {\n    // The following examples illustrate the nameForEmit heuristics:\n    //\n    // Example 1:\n    //   class X { } <--- nameForEmit should be \"A\" to simplify things and reduce possibility of conflicts\n    //   export { X as A };\n    //\n    // Example 2:\n    //   class X { } <--- nameForEmit should be \"X\" because choosing A or B would be nondeterministic\n    //   export { X as A };\n    //   export { X as B };\n    //\n    // Example 3:\n    //   class X { } <--- nameForEmit should be \"X_1\" because Y has a stronger claim to the name\n    //   export { X as A };\n    //   export { X as B };\n    //   class Y { } <--- nameForEmit should be \"X\"\n    //   export { Y as X };\n\n    // Set of names that should NOT be used when generating a unique nameForEmit\n    const usedNames: Set<string> = new Set<string>();\n\n    // First collect the names of explicit package exports, and perform a sanity check.\n    for (const entity of this._entities) {\n      for (const exportName of entity.exportNames) {\n        if (usedNames.has(exportName)) {\n          // This should be impossible\n          throw new InternalError(`A package cannot have two exports with the name \"${exportName}\"`);\n        }\n        usedNames.add(exportName);\n      }\n    }\n\n    // Ensure that each entity has a unique nameForEmit\n    for (const entity of this._entities) {\n      // What name would we ideally want to emit it as?\n      let idealNameForEmit: string;\n\n      // If this entity is exported exactly once, then we prefer the exported name\n      if (\n        entity.singleExportName !== undefined &&\n        entity.singleExportName !== ts.InternalSymbolName.Default\n      ) {\n        idealNameForEmit = entity.singleExportName;\n      } else {\n        // otherwise use the local name\n        idealNameForEmit = entity.astEntity.localName;\n      }\n\n      if (idealNameForEmit.includes('.')) {\n        // For an ImportType with a namespace chain, only the top namespace is imported.\n        idealNameForEmit = idealNameForEmit.split('.')[0];\n      }\n\n      // If the idealNameForEmit happens to be the same as one of the exports, then we're safe to use that...\n      if (entity.exportNames.has(idealNameForEmit)) {\n        // ...except that if it conflicts with a global name, then the global name wins\n        if (!this.globalVariableAnalyzer.hasGlobalName(idealNameForEmit)) {\n          // ...also avoid \"default\" which can interfere with \"export { default } from 'some-module;'\"\n          if (idealNameForEmit !== 'default') {\n            entity.nameForEmit = idealNameForEmit;\n            continue;\n          }\n        }\n      }\n\n      // Generate a unique name based on idealNameForEmit\n      let suffix: number = 1;\n      let nameForEmit: string = idealNameForEmit;\n\n      // Choose a name that doesn't conflict with usedNames or a global name\n      while (\n        nameForEmit === 'default' ||\n        usedNames.has(nameForEmit) ||\n        this.globalVariableAnalyzer.hasGlobalName(nameForEmit)\n      ) {\n        nameForEmit = `${idealNameForEmit}_${++suffix}`;\n      }\n      entity.nameForEmit = nameForEmit;\n      usedNames.add(nameForEmit);\n    }\n  }\n\n  private _fetchSymbolMetadata(astSymbol: AstSymbol): void {\n    if (astSymbol.symbolMetadata) {\n      return;\n    }\n\n    // When we solve an astSymbol, then we always also solve all of its parents and all of its declarations.\n    // The parent is solved first.\n    if (astSymbol.parentAstSymbol && astSymbol.parentAstSymbol.symbolMetadata === undefined) {\n      this._fetchSymbolMetadata(astSymbol.parentAstSymbol);\n    }\n\n    // Construct the DeclarationMetadata objects, and detect any ancillary declarations\n    this._calculateDeclarationMetadataForDeclarations(astSymbol);\n\n    // Calculate the ApiItemMetadata objects\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      this._calculateApiItemMetadata(astDeclaration);\n    }\n\n    // The most public effectiveReleaseTag for all declarations\n    let maxEffectiveReleaseTag: ReleaseTag = ReleaseTag.None;\n\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      // We know we solved this above\n      const apiItemMetadata: ApiItemMetadata = astDeclaration.apiItemMetadata as ApiItemMetadata;\n\n      const effectiveReleaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      if (effectiveReleaseTag > maxEffectiveReleaseTag) {\n        maxEffectiveReleaseTag = effectiveReleaseTag;\n      }\n    }\n\n    // Update this last when we're sure no exceptions were thrown\n    astSymbol.symbolMetadata = new SymbolMetadata({\n      maxEffectiveReleaseTag\n    });\n  }\n\n  private _calculateDeclarationMetadataForDeclarations(astSymbol: AstSymbol): void {\n    // Initialize DeclarationMetadata for each declaration\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      if (astDeclaration.declarationMetadata) {\n        throw new InternalError(\n          'AstDeclaration.declarationMetadata is not expected to have been initialized yet'\n        );\n      }\n\n      const metadata: InternalDeclarationMetadata = new InternalDeclarationMetadata();\n      metadata.tsdocParserContext = this._parseTsdocForAstDeclaration(astDeclaration);\n\n      astDeclaration.declarationMetadata = metadata;\n    }\n\n    // Detect ancillary declarations\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      // For a getter/setter pair, make the setter ancillary to the getter\n      if (astDeclaration.declaration.kind === ts.SyntaxKind.SetAccessor) {\n        let foundGetter: boolean = false;\n        for (const getterAstDeclaration of astDeclaration.astSymbol.astDeclarations) {\n          if (getterAstDeclaration.declaration.kind === ts.SyntaxKind.GetAccessor) {\n            // Associate it with the getter\n            this._addAncillaryDeclaration(getterAstDeclaration, astDeclaration);\n\n            foundGetter = true;\n          }\n        }\n\n        if (!foundGetter) {\n          this.messageRouter.addAnalyzerIssue(\n            ExtractorMessageId.MissingGetter,\n            `The property \"${astDeclaration.astSymbol.localName}\" has a setter but no getter.`,\n            astDeclaration\n          );\n        }\n      }\n    }\n  }\n\n  private _addAncillaryDeclaration(\n    mainAstDeclaration: AstDeclaration,\n    ancillaryAstDeclaration: AstDeclaration\n  ): void {\n    const mainMetadata: InternalDeclarationMetadata =\n      mainAstDeclaration.declarationMetadata as InternalDeclarationMetadata;\n    const ancillaryMetadata: InternalDeclarationMetadata =\n      ancillaryAstDeclaration.declarationMetadata as InternalDeclarationMetadata;\n\n    if (mainMetadata.ancillaryDeclarations.indexOf(ancillaryAstDeclaration) >= 0) {\n      return; // already added\n    }\n\n    if (mainAstDeclaration.astSymbol !== ancillaryAstDeclaration.astSymbol) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because declarations do not' +\n          ' belong to the same symbol'\n      );\n    }\n\n    if (mainMetadata.isAncillary) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because the target is ancillary itself'\n      );\n    }\n\n    if (ancillaryMetadata.isAncillary) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because source is already ancillary' +\n          ' to another declaration'\n      );\n    }\n\n    if (mainAstDeclaration.apiItemMetadata || ancillaryAstDeclaration.apiItemMetadata) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because the API item metadata' +\n          ' has already been constructed'\n      );\n    }\n\n    ancillaryMetadata.isAncillary = true;\n    mainMetadata.ancillaryDeclarations.push(ancillaryAstDeclaration);\n  }\n\n  private _calculateApiItemMetadata(astDeclaration: AstDeclaration): void {\n    const declarationMetadata: InternalDeclarationMetadata =\n      astDeclaration.declarationMetadata as InternalDeclarationMetadata;\n    if (declarationMetadata.isAncillary) {\n      if (astDeclaration.declaration.kind === ts.SyntaxKind.SetAccessor) {\n        if (declarationMetadata.tsdocParserContext) {\n          this.messageRouter.addAnalyzerIssue(\n            ExtractorMessageId.SetterWithDocs,\n            `The doc comment for the property \"${astDeclaration.astSymbol.localName}\"` +\n              ` must appear on the getter, not the setter.`,\n            astDeclaration\n          );\n        }\n      }\n\n      // We never calculate ApiItemMetadata for an ancillary declaration; instead, it is assigned when\n      // the main declaration is processed.\n      return;\n    }\n\n    const options: IApiItemMetadataOptions = {\n      declaredReleaseTag: ReleaseTag.None,\n      effectiveReleaseTag: ReleaseTag.None,\n      isEventProperty: false,\n      isOverride: false,\n      isSealed: false,\n      isVirtual: false,\n      isPreapproved: false,\n      releaseTagSameAsParent: false\n    };\n\n    const parserContext: tsdoc.ParserContext | undefined = declarationMetadata.tsdocParserContext;\n    if (parserContext) {\n      const modifierTagSet: tsdoc.StandardModifierTagSet = parserContext.docComment.modifierTagSet;\n\n      let declaredReleaseTag: ReleaseTag = ReleaseTag.None;\n      let extraReleaseTags: boolean = false;\n\n      if (modifierTagSet.isPublic()) {\n        declaredReleaseTag = ReleaseTag.Public;\n      }\n      if (modifierTagSet.isBeta()) {\n        if (declaredReleaseTag !== ReleaseTag.None) {\n          extraReleaseTags = true;\n        } else {\n          declaredReleaseTag = ReleaseTag.Beta;\n        }\n      }\n      if (modifierTagSet.isAlpha()) {\n        if (declaredReleaseTag !== ReleaseTag.None) {\n          extraReleaseTags = true;\n        } else {\n          declaredReleaseTag = ReleaseTag.Alpha;\n        }\n      }\n      if (modifierTagSet.isInternal()) {\n        if (declaredReleaseTag !== ReleaseTag.None) {\n          extraReleaseTags = true;\n        } else {\n          declaredReleaseTag = ReleaseTag.Internal;\n        }\n      }\n\n      if (extraReleaseTags) {\n        if (!astDeclaration.astSymbol.isExternal) {\n          // for now, don't report errors for external code\n          this.messageRouter.addAnalyzerIssue(\n            ExtractorMessageId.ExtraReleaseTag,\n            'The doc comment should not contain more than one release tag',\n            astDeclaration\n          );\n        }\n      }\n\n      options.declaredReleaseTag = declaredReleaseTag;\n\n      options.isEventProperty = modifierTagSet.isEventProperty();\n      options.isOverride = modifierTagSet.isOverride();\n      options.isSealed = modifierTagSet.isSealed();\n      options.isVirtual = modifierTagSet.isVirtual();\n      const preapprovedTag: tsdoc.TSDocTagDefinition | void =\n        this.extractorConfig.tsdocConfiguration.tryGetTagDefinition('@preapproved');\n\n      if (preapprovedTag && modifierTagSet.hasTag(preapprovedTag)) {\n        // This feature only makes sense for potentially big declarations.\n        switch (astDeclaration.declaration.kind) {\n          case ts.SyntaxKind.ClassDeclaration:\n          case ts.SyntaxKind.EnumDeclaration:\n          case ts.SyntaxKind.InterfaceDeclaration:\n          case ts.SyntaxKind.ModuleDeclaration:\n            if (declaredReleaseTag === ReleaseTag.Internal) {\n              options.isPreapproved = true;\n            } else {\n              this.messageRouter.addAnalyzerIssue(\n                ExtractorMessageId.PreapprovedBadReleaseTag,\n                `The @preapproved tag cannot be applied to \"${astDeclaration.astSymbol.localName}\"` +\n                  ` without an @internal release tag`,\n                astDeclaration\n              );\n            }\n            break;\n          default:\n            this.messageRouter.addAnalyzerIssue(\n              ExtractorMessageId.PreapprovedUnsupportedType,\n              `The @preapproved tag cannot be applied to \"${astDeclaration.astSymbol.localName}\"` +\n                ` because it is not a supported declaration type`,\n              astDeclaration\n            );\n            break;\n        }\n      }\n    }\n\n    // This needs to be set regardless of whether or not a parserContext exists\n    if (astDeclaration.parent) {\n      const parentApiItemMetadata: ApiItemMetadata = this.fetchApiItemMetadata(astDeclaration.parent);\n      options.effectiveReleaseTag =\n        options.declaredReleaseTag === ReleaseTag.None\n          ? parentApiItemMetadata.effectiveReleaseTag\n          : options.declaredReleaseTag;\n\n      options.releaseTagSameAsParent =\n        parentApiItemMetadata.effectiveReleaseTag === options.effectiveReleaseTag;\n    } else {\n      options.effectiveReleaseTag = options.declaredReleaseTag;\n    }\n\n    if (options.effectiveReleaseTag === ReleaseTag.None) {\n      if (!astDeclaration.astSymbol.isExternal) {\n        // for now, don't report errors for external code\n        // Don't report missing release tags for forgotten exports\n        const astSymbol: AstSymbol = astDeclaration.astSymbol;\n        const entity: CollectorEntity | undefined = this._entitiesByAstEntity.get(astSymbol.rootAstSymbol);\n        if (entity && entity.consumable) {\n          // We also don't report errors for the default export of an entry point, since its doc comment\n          // isn't easy to obtain from the .d.ts file\n          if (astSymbol.rootAstSymbol.localName !== '_default') {\n            this.messageRouter.addAnalyzerIssue(\n              ExtractorMessageId.MissingReleaseTag,\n              `\"${entity.astEntity.localName}\" is exported by the package, but it is missing ` +\n                `a release tag (@alpha, @beta, @public, or @internal)`,\n              astSymbol\n            );\n          }\n        }\n      }\n\n      options.effectiveReleaseTag = ReleaseTag.Public;\n    }\n\n    const apiItemMetadata: ApiItemMetadata = new ApiItemMetadata(options);\n    if (parserContext) {\n      apiItemMetadata.tsdocComment = parserContext.docComment;\n    }\n\n    astDeclaration.apiItemMetadata = apiItemMetadata;\n\n    // Lastly, share the result with any ancillary declarations\n    for (const ancillaryDeclaration of declarationMetadata.ancillaryDeclarations) {\n      ancillaryDeclaration.apiItemMetadata = apiItemMetadata;\n    }\n  }\n\n  private _parseTsdocForAstDeclaration(astDeclaration: AstDeclaration): tsdoc.ParserContext | undefined {\n    const declaration: ts.Declaration = astDeclaration.declaration;\n    let nodeForComment: ts.Node = declaration;\n\n    if (ts.isVariableDeclaration(declaration)) {\n      // Variable declarations are special because they can be combined into a list.  For example:\n      //\n      // /** A */ export /** B */ const /** C */ x = 1, /** D **/ [ /** E */ y, z] = [3, 4];\n      //\n      // The compiler will only emit comments A and C in the .d.ts file, so in general there isn't a well-defined\n      // way to document these parts.  API Extractor requires you to break them into separate exports like this:\n      //\n      // /** A */ export const x = 1;\n      //\n      // But _getReleaseTagForDeclaration() still receives a node corresponding to \"x\", so we need to walk upwards\n      // and find the containing statement in order for getJSDocCommentRanges() to read the comment that we expect.\n      const statement: ts.VariableStatement | undefined = TypeScriptHelpers.findFirstParent(\n        declaration,\n        ts.SyntaxKind.VariableStatement\n      ) as ts.VariableStatement | undefined;\n      if (statement !== undefined) {\n        // For a compound declaration, fall back to looking for C instead of A\n        if (statement.declarationList.declarations.length === 1) {\n          nodeForComment = statement;\n        }\n      }\n    }\n\n    const sourceFileText: string = declaration.getSourceFile().text;\n    const ranges: ts.CommentRange[] =\n      TypeScriptInternals.getJSDocCommentRanges(nodeForComment, sourceFileText) || [];\n\n    if (ranges.length === 0) {\n      return undefined;\n    }\n\n    // We use the JSDoc comment block that is closest to the definition, i.e.\n    // the last one preceding it\n    const range: ts.TextRange = ranges[ranges.length - 1];\n\n    const tsdocTextRange: tsdoc.TextRange = tsdoc.TextRange.fromStringRange(\n      sourceFileText,\n      range.pos,\n      range.end\n    );\n\n    const parserContext: tsdoc.ParserContext = this._tsdocParser.parseRange(tsdocTextRange);\n\n    this.messageRouter.addTsdocMessages(parserContext, declaration.getSourceFile(), astDeclaration);\n\n    // We delete the @privateRemarks block as early as possible, to ensure that it never leaks through\n    // into one of the output files.\n    parserContext.docComment.privateRemarks = undefined;\n\n    return parserContext;\n  }\n\n  private _collectReferenceDirectives(astEntity: AstEntity): void {\n    if (astEntity instanceof AstSymbol) {\n      const sourceFiles: ts.SourceFile[] = astEntity.astDeclarations.map((astDeclaration) =>\n        astDeclaration.declaration.getSourceFile()\n      );\n      return this._collectReferenceDirectivesFromSourceFiles(sourceFiles);\n    }\n\n    if (astEntity instanceof AstNamespaceImport) {\n      const sourceFiles: ts.SourceFile[] = [astEntity.astModule.sourceFile];\n      return this._collectReferenceDirectivesFromSourceFiles(sourceFiles);\n    }\n  }\n\n  private _collectReferenceDirectivesFromSourceFiles(sourceFiles: ts.SourceFile[]): void {\n    const seenFilenames: Set<string> = new Set<string>();\n\n    for (const sourceFile of sourceFiles) {\n      if (sourceFile && sourceFile.fileName) {\n        if (!seenFilenames.has(sourceFile.fileName)) {\n          seenFilenames.add(sourceFile.fileName);\n\n          for (const typeReferenceDirective of sourceFile.typeReferenceDirectives) {\n            const name: string = sourceFile.text.substring(\n              typeReferenceDirective.pos,\n              typeReferenceDirective.end\n            );\n            this._dtsTypeReferenceDirectives.add(name);\n          }\n\n          for (const libReferenceDirective of sourceFile.libReferenceDirectives) {\n            const name: string = sourceFile.text.substring(\n              libReferenceDirective.pos,\n              libReferenceDirective.end\n            );\n            this._dtsLibReferenceDirectives.add(name);\n          }\n        }\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"Collector.js","sourceRoot":"","sources":["../../src/collector/Collector.ts"],"names":[],"mappings":"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","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 ts from 'typescript';\nimport * as tsdoc from '@microsoft/tsdoc';\nimport { PackageJsonLookup, Sort, InternalError } from '@rushstack/node-core-library';\nimport { ReleaseTag } from '@microsoft/api-extractor-model';\n\nimport { ExtractorMessageId } from '../api/ExtractorMessageId';\n\nimport { CollectorEntity } from './CollectorEntity';\nimport { AstSymbolTable } from '../analyzer/AstSymbolTable';\nimport { AstEntity } from '../analyzer/AstEntity';\nimport { AstModule, AstModuleExportInfo } from '../analyzer/AstModule';\nimport { AstSymbol } from '../analyzer/AstSymbol';\nimport { AstDeclaration } from '../analyzer/AstDeclaration';\nimport { TypeScriptHelpers } from '../analyzer/TypeScriptHelpers';\nimport { WorkingPackage } from './WorkingPackage';\nimport { PackageDocComment } from '../aedoc/PackageDocComment';\nimport { DeclarationMetadata, InternalDeclarationMetadata } from './DeclarationMetadata';\nimport { ApiItemMetadata, IApiItemMetadataOptions } from './ApiItemMetadata';\nimport { SymbolMetadata } from './SymbolMetadata';\nimport { TypeScriptInternals, IGlobalVariableAnalyzer } from '../analyzer/TypeScriptInternals';\nimport { MessageRouter } from './MessageRouter';\nimport { AstReferenceResolver } from '../analyzer/AstReferenceResolver';\nimport { ExtractorConfig } from '../api/ExtractorConfig';\nimport { AstNamespaceImport } from '../analyzer/AstNamespaceImport';\nimport { AstImport } from '../analyzer/AstImport';\n\n/**\n * Options for Collector constructor.\n */\nexport interface ICollectorOptions {\n  /**\n   * Configuration for the TypeScript compiler.  The most important options to set are:\n   *\n   * - target: ts.ScriptTarget.ES5\n   * - module: ts.ModuleKind.CommonJS\n   * - moduleResolution: ts.ModuleResolutionKind.NodeJs\n   * - rootDir: inputFolder\n   */\n  program: ts.Program;\n\n  messageRouter: MessageRouter;\n\n  extractorConfig: ExtractorConfig;\n}\n\n/**\n * The `Collector` manages the overall data set that is used by `ApiModelGenerator`,\n * `DtsRollupGenerator`, and `ApiReportGenerator`.  Starting from the working package's entry point,\n * the `Collector` collects all exported symbols, determines how to import any symbols they reference,\n * assigns unique names, and sorts everything into a normalized alphabetical ordering.\n */\nexport class Collector {\n  public readonly program: ts.Program;\n  public readonly typeChecker: ts.TypeChecker;\n  public readonly globalVariableAnalyzer: IGlobalVariableAnalyzer;\n  public readonly astSymbolTable: AstSymbolTable;\n  public readonly astReferenceResolver: AstReferenceResolver;\n\n  public readonly packageJsonLookup: PackageJsonLookup;\n  public readonly messageRouter: MessageRouter;\n\n  public readonly workingPackage: WorkingPackage;\n\n  public readonly extractorConfig: ExtractorConfig;\n\n  /**\n   * The `ExtractorConfig.bundledPackages` names in a set.\n   */\n  public readonly bundledPackageNames: ReadonlySet<string>;\n\n  private readonly _program: ts.Program;\n\n  private readonly _tsdocParser: tsdoc.TSDocParser;\n\n  private _astEntryPoint: AstModule | undefined;\n\n  private readonly _entities: CollectorEntity[] = [];\n  private readonly _entitiesByAstEntity: Map<AstEntity, CollectorEntity> = new Map<\n    AstEntity,\n    CollectorEntity\n  >();\n\n  private readonly _starExportedExternalModulePaths: string[] = [];\n\n  private readonly _dtsTypeReferenceDirectives: Set<string> = new Set<string>();\n  private readonly _dtsLibReferenceDirectives: Set<string> = new Set<string>();\n\n  // Used by getOverloadIndex()\n  private readonly _cachedOverloadIndexesByDeclaration: Map<AstDeclaration, number>;\n\n  public constructor(options: ICollectorOptions) {\n    this.packageJsonLookup = new PackageJsonLookup();\n\n    this._program = options.program;\n    this.extractorConfig = options.extractorConfig;\n\n    const entryPointSourceFile: ts.SourceFile | undefined = options.program.getSourceFile(\n      this.extractorConfig.mainEntryPointFilePath\n    );\n\n    if (!entryPointSourceFile) {\n      throw new Error('Unable to load file: ' + this.extractorConfig.mainEntryPointFilePath);\n    }\n\n    if (!this.extractorConfig.packageFolder || !this.extractorConfig.packageJson) {\n      // TODO: We should be able to analyze projects that don't have any package.json.\n      // The ExtractorConfig class is already designed to allow this.\n      throw new Error('Unable to find a package.json file for the project being analyzed');\n    }\n\n    this.workingPackage = new WorkingPackage({\n      packageFolder: this.extractorConfig.packageFolder,\n      packageJson: this.extractorConfig.packageJson,\n      entryPointSourceFile\n    });\n\n    this.messageRouter = options.messageRouter;\n\n    this.program = options.program;\n    this.typeChecker = options.program.getTypeChecker();\n    this.globalVariableAnalyzer = TypeScriptInternals.getGlobalVariableAnalyzer(this.program);\n\n    this._tsdocParser = new tsdoc.TSDocParser(this.extractorConfig.tsdocConfiguration);\n\n    this.bundledPackageNames = new Set<string>(this.extractorConfig.bundledPackages);\n\n    this.astSymbolTable = new AstSymbolTable(\n      this.program,\n      this.typeChecker,\n      this.packageJsonLookup,\n      this.bundledPackageNames,\n      this.messageRouter\n    );\n    this.astReferenceResolver = new AstReferenceResolver(this);\n\n    this._cachedOverloadIndexesByDeclaration = new Map<AstDeclaration, number>();\n  }\n\n  /**\n   * Returns a list of names (e.g. \"example-library\") that should appear in a reference like this:\n   *\n   * ```\n   * /// <reference types=\"example-library\" />\n   * ```\n   */\n  public get dtsTypeReferenceDirectives(): ReadonlySet<string> {\n    return this._dtsTypeReferenceDirectives;\n  }\n\n  /**\n   * A list of names (e.g. \"runtime-library\") that should appear in a reference like this:\n   *\n   * ```\n   * /// <reference lib=\"runtime-library\" />\n   * ```\n   */\n  public get dtsLibReferenceDirectives(): ReadonlySet<string> {\n    return this._dtsLibReferenceDirectives;\n  }\n\n  public get entities(): ReadonlyArray<CollectorEntity> {\n    return this._entities;\n  }\n\n  /**\n   * A list of module specifiers (e.g. `\"@rushstack/node-core-library/lib/FileSystem\"`) that should be emitted\n   * as star exports (e.g. `export * from \"@rushstack/node-core-library/lib/FileSystem\"`).\n   */\n  public get starExportedExternalModulePaths(): ReadonlyArray<string> {\n    return this._starExportedExternalModulePaths;\n  }\n\n  /**\n   * Perform the analysis.\n   */\n  public analyze(): void {\n    if (this._astEntryPoint) {\n      throw new Error('DtsRollupGenerator.analyze() was already called');\n    }\n\n    // This runs a full type analysis, and then augments the Abstract Syntax Tree (i.e. declarations)\n    // with semantic information (i.e. symbols).  The \"diagnostics\" are a subset of the everyday\n    // compile errors that would result from a full compilation.\n    for (const diagnostic of this._program.getSemanticDiagnostics()) {\n      this.messageRouter.addCompilerDiagnostic(diagnostic);\n    }\n\n    const sourceFiles: readonly ts.SourceFile[] = this.program.getSourceFiles();\n\n    if (this.messageRouter.showDiagnostics) {\n      this.messageRouter.logDiagnosticHeader('Root filenames');\n      for (const fileName of this.program.getRootFileNames()) {\n        this.messageRouter.logDiagnostic(fileName);\n      }\n      this.messageRouter.logDiagnosticFooter();\n\n      this.messageRouter.logDiagnosticHeader('Files analyzed by compiler');\n      for (const sourceFile of sourceFiles) {\n        this.messageRouter.logDiagnostic(sourceFile.fileName);\n      }\n      this.messageRouter.logDiagnosticFooter();\n    }\n\n    // We can throw this error earlier in CompilerState.ts, but intentionally wait until after we've logged the\n    // associated diagnostic message above to make debugging easier for developers.\n    // Typically there will be many such files -- to avoid too much noise, only report the first one.\n    const badSourceFile: ts.SourceFile | undefined = sourceFiles.find(\n      ({ fileName }) => !ExtractorConfig.hasDtsFileExtension(fileName)\n    );\n    if (badSourceFile) {\n      this.messageRouter.addAnalyzerIssueForPosition(\n        ExtractorMessageId.WrongInputFileType,\n        'Incorrect file type; API Extractor expects to analyze compiler outputs with the .d.ts file extension. ' +\n          'Troubleshooting tips: https://api-extractor.com/link/dts-error',\n        badSourceFile,\n        0\n      );\n    }\n\n    // Build the entry point\n    const entryPointSourceFile: ts.SourceFile = this.workingPackage.entryPointSourceFile;\n\n    const astEntryPoint: AstModule =\n      this.astSymbolTable.fetchAstModuleFromWorkingPackage(entryPointSourceFile);\n    this._astEntryPoint = astEntryPoint;\n\n    const packageDocCommentTextRange: ts.TextRange | undefined = PackageDocComment.tryFindInSourceFile(\n      entryPointSourceFile,\n      this\n    );\n\n    if (packageDocCommentTextRange) {\n      const range: tsdoc.TextRange = tsdoc.TextRange.fromStringRange(\n        entryPointSourceFile.text,\n        packageDocCommentTextRange.pos,\n        packageDocCommentTextRange.end\n      );\n\n      this.workingPackage.tsdocParserContext = this._tsdocParser.parseRange(range);\n\n      this.messageRouter.addTsdocMessages(this.workingPackage.tsdocParserContext, entryPointSourceFile);\n\n      this.workingPackage.tsdocComment = this.workingPackage.tsdocParserContext!.docComment;\n    }\n\n    const exportedAstEntities: AstEntity[] = [];\n\n    // Create a CollectorEntity for each top-level export\n\n    const astModuleExportInfo: AstModuleExportInfo =\n      this.astSymbolTable.fetchAstModuleExportInfo(astEntryPoint);\n\n    for (const [exportName, astEntity] of astModuleExportInfo.exportedLocalEntities) {\n      this._createCollectorEntity(astEntity, exportName);\n\n      exportedAstEntities.push(astEntity);\n    }\n\n    // Create a CollectorEntity for each indirectly referenced export.\n    // Note that we do this *after* the above loop, so that references to exported AstSymbols\n    // are encountered first as exports.\n    const alreadySeenAstSymbols: Set<AstSymbol> = new Set<AstSymbol>();\n    for (const exportedAstEntity of exportedAstEntities) {\n      this._createEntityForIndirectReferences(exportedAstEntity, alreadySeenAstSymbols);\n\n      if (exportedAstEntity instanceof AstSymbol) {\n        this.fetchSymbolMetadata(exportedAstEntity);\n      }\n    }\n\n    this._makeUniqueNames();\n\n    for (const starExportedExternalModule of astModuleExportInfo.starExportedExternalModules) {\n      if (starExportedExternalModule.externalModulePath !== undefined) {\n        this._starExportedExternalModulePaths.push(starExportedExternalModule.externalModulePath);\n      }\n    }\n\n    Sort.sortBy(this._entities, (x) => x.getSortKey());\n    Sort.sortSet(this._dtsTypeReferenceDirectives);\n    Sort.sortSet(this._dtsLibReferenceDirectives);\n    this._starExportedExternalModulePaths.sort();\n  }\n\n  /**\n   * For a given ts.Identifier that is part of an AstSymbol that we analyzed, return the CollectorEntity that\n   * it refers to.  Returns undefined if it doesn't refer to anything interesting.\n   * @remarks\n   * Throws an Error if the ts.Identifier is not part of node tree that was analyzed.\n   */\n  public tryGetEntityForNode(identifier: ts.Identifier | ts.ImportTypeNode): CollectorEntity | undefined {\n    const astEntity: AstEntity | undefined = this.astSymbolTable.tryGetEntityForNode(identifier);\n    if (astEntity) {\n      return this._entitiesByAstEntity.get(astEntity);\n    }\n    return undefined;\n  }\n\n  /**\n   * Returns the associated `CollectorEntity` for the given `astEntity`, if one was created during analysis.\n   */\n  public tryGetCollectorEntity(astEntity: AstEntity): CollectorEntity | undefined {\n    return this._entitiesByAstEntity.get(astEntity);\n  }\n\n  public fetchSymbolMetadata(astSymbol: AstSymbol): SymbolMetadata {\n    if (astSymbol.symbolMetadata === undefined) {\n      this._fetchSymbolMetadata(astSymbol);\n    }\n    return astSymbol.symbolMetadata as SymbolMetadata;\n  }\n\n  public fetchDeclarationMetadata(astDeclaration: AstDeclaration): DeclarationMetadata {\n    if (astDeclaration.declarationMetadata === undefined) {\n      // Fetching the SymbolMetadata always constructs the DeclarationMetadata\n      this._fetchSymbolMetadata(astDeclaration.astSymbol);\n    }\n    return astDeclaration.declarationMetadata as DeclarationMetadata;\n  }\n\n  public fetchApiItemMetadata(astDeclaration: AstDeclaration): ApiItemMetadata {\n    if (astDeclaration.apiItemMetadata === undefined) {\n      // Fetching the SymbolMetadata always constructs the ApiItemMetadata\n      this._fetchSymbolMetadata(astDeclaration.astSymbol);\n    }\n    return astDeclaration.apiItemMetadata as ApiItemMetadata;\n  }\n\n  public tryFetchMetadataForAstEntity(astEntity: AstEntity): SymbolMetadata | undefined {\n    if (astEntity instanceof AstSymbol) {\n      return this.fetchSymbolMetadata(astEntity);\n    }\n    if (astEntity instanceof AstImport) {\n      if (astEntity.astSymbol) {\n        return this.fetchSymbolMetadata(astEntity.astSymbol);\n      }\n    }\n    return undefined;\n  }\n\n  public isAncillaryDeclaration(astDeclaration: AstDeclaration): boolean {\n    const declarationMetadata: DeclarationMetadata = this.fetchDeclarationMetadata(astDeclaration);\n    return declarationMetadata.isAncillary;\n  }\n\n  public getNonAncillaryDeclarations(astSymbol: AstSymbol): ReadonlyArray<AstDeclaration> {\n    const result: AstDeclaration[] = [];\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      const declarationMetadata: DeclarationMetadata = this.fetchDeclarationMetadata(astDeclaration);\n      if (!declarationMetadata.isAncillary) {\n        result.push(astDeclaration);\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Removes the leading underscore, for example: \"_Example\" --> \"example*Example*_\"\n   *\n   * @remarks\n   * This causes internal definitions to sort alphabetically case-insensitive, then case-sensitive, and\n   * initially ignoring the underscore prefix, while still deterministically comparing it.\n   * The star is used as a delimiter because it is not a legal  identifier character.\n   */\n  public static getSortKeyIgnoringUnderscore(identifier: string | undefined): string {\n    if (!identifier) return '';\n\n    let parts: string[];\n\n    if (identifier[0] === '_') {\n      const withoutUnderscore: string = identifier.substr(1);\n      parts = [withoutUnderscore.toLowerCase(), '*', withoutUnderscore, '*', '_'];\n    } else {\n      parts = [identifier.toLowerCase(), '*', identifier];\n    }\n\n    return parts.join('');\n  }\n\n  /**\n   * For function-like signatures, this returns the TSDoc \"overload index\" which can be used to identify\n   * a specific overload.\n   */\n  public getOverloadIndex(astDeclaration: AstDeclaration): number {\n    const allDeclarations: ReadonlyArray<AstDeclaration> = astDeclaration.astSymbol.astDeclarations;\n    if (allDeclarations.length === 1) {\n      return 1; // trivial case\n    }\n\n    let overloadIndex: number | undefined = this._cachedOverloadIndexesByDeclaration.get(astDeclaration);\n\n    if (overloadIndex === undefined) {\n      // TSDoc index selectors are positive integers counting from 1\n      let nextIndex: number = 1;\n      for (const other of allDeclarations) {\n        // Filter out other declarations that are not overloads.  For example, an overloaded function can also\n        // be a namespace.\n        if (other.declaration.kind === astDeclaration.declaration.kind) {\n          this._cachedOverloadIndexesByDeclaration.set(other, nextIndex);\n          ++nextIndex;\n        }\n      }\n      overloadIndex = this._cachedOverloadIndexesByDeclaration.get(astDeclaration);\n    }\n\n    if (overloadIndex === undefined) {\n      // This should never happen\n      throw new InternalError('Error calculating overload index for declaration');\n    }\n\n    return overloadIndex;\n  }\n\n  private _createCollectorEntity(astEntity: AstEntity, exportedName: string | undefined): CollectorEntity {\n    let entity: CollectorEntity | undefined = this._entitiesByAstEntity.get(astEntity);\n\n    if (!entity) {\n      entity = new CollectorEntity(astEntity);\n\n      this._entitiesByAstEntity.set(astEntity, entity);\n      this._entities.push(entity);\n      this._collectReferenceDirectives(astEntity);\n    }\n\n    if (exportedName) {\n      entity.addExportName(exportedName);\n    }\n\n    return entity;\n  }\n\n  private _createEntityForIndirectReferences(\n    astEntity: AstEntity,\n    alreadySeenAstEntities: Set<AstEntity>\n  ): void {\n    if (alreadySeenAstEntities.has(astEntity)) {\n      return;\n    }\n    alreadySeenAstEntities.add(astEntity);\n\n    if (astEntity instanceof AstSymbol) {\n      astEntity.forEachDeclarationRecursive((astDeclaration: AstDeclaration) => {\n        for (const referencedAstEntity of astDeclaration.referencedAstEntities) {\n          if (referencedAstEntity instanceof AstSymbol) {\n            // We only create collector entities for root-level symbols.\n            // For example, if a symbols is nested inside a namespace, only the root-level namespace\n            // get a collector entity\n            if (referencedAstEntity.parentAstSymbol === undefined) {\n              this._createCollectorEntity(referencedAstEntity, undefined);\n            }\n          } else {\n            this._createCollectorEntity(referencedAstEntity, undefined);\n          }\n\n          this._createEntityForIndirectReferences(referencedAstEntity, alreadySeenAstEntities);\n        }\n      });\n    }\n\n    if (astEntity instanceof AstNamespaceImport) {\n      const astModuleExportInfo: AstModuleExportInfo = astEntity.fetchAstModuleExportInfo(this);\n\n      for (const exportedEntity of astModuleExportInfo.exportedLocalEntities.values()) {\n        // Create a CollectorEntity for each top-level export of AstImportInternal entity\n        const entity: CollectorEntity = this._createCollectorEntity(exportedEntity, undefined);\n        entity.addAstNamespaceImports(astEntity);\n\n        this._createEntityForIndirectReferences(exportedEntity, alreadySeenAstEntities);\n      }\n    }\n  }\n\n  /**\n   * Ensures a unique name for each item in the package typings file.\n   */\n  private _makeUniqueNames(): void {\n    // The following examples illustrate the nameForEmit heuristics:\n    //\n    // Example 1:\n    //   class X { } <--- nameForEmit should be \"A\" to simplify things and reduce possibility of conflicts\n    //   export { X as A };\n    //\n    // Example 2:\n    //   class X { } <--- nameForEmit should be \"X\" because choosing A or B would be nondeterministic\n    //   export { X as A };\n    //   export { X as B };\n    //\n    // Example 3:\n    //   class X { } <--- nameForEmit should be \"X_1\" because Y has a stronger claim to the name\n    //   export { X as A };\n    //   export { X as B };\n    //   class Y { } <--- nameForEmit should be \"X\"\n    //   export { Y as X };\n\n    // Set of names that should NOT be used when generating a unique nameForEmit\n    const usedNames: Set<string> = new Set<string>();\n\n    // First collect the names of explicit package exports, and perform a sanity check.\n    for (const entity of this._entities) {\n      for (const exportName of entity.exportNames) {\n        if (usedNames.has(exportName)) {\n          // This should be impossible\n          throw new InternalError(`A package cannot have two exports with the name \"${exportName}\"`);\n        }\n        usedNames.add(exportName);\n      }\n    }\n\n    // Ensure that each entity has a unique nameForEmit\n    for (const entity of this._entities) {\n      // What name would we ideally want to emit it as?\n      let idealNameForEmit: string;\n\n      // If this entity is exported exactly once, then we prefer the exported name\n      if (\n        entity.singleExportName !== undefined &&\n        entity.singleExportName !== ts.InternalSymbolName.Default\n      ) {\n        idealNameForEmit = entity.singleExportName;\n      } else {\n        // otherwise use the local name\n        idealNameForEmit = entity.astEntity.localName;\n      }\n\n      if (idealNameForEmit.includes('.')) {\n        // For an ImportType with a namespace chain, only the top namespace is imported.\n        idealNameForEmit = idealNameForEmit.split('.')[0];\n      }\n\n      // If the idealNameForEmit happens to be the same as one of the exports, then we're safe to use that...\n      if (entity.exportNames.has(idealNameForEmit)) {\n        // ...except that if it conflicts with a global name, then the global name wins\n        if (!this.globalVariableAnalyzer.hasGlobalName(idealNameForEmit)) {\n          // ...also avoid \"default\" which can interfere with \"export { default } from 'some-module;'\"\n          if (idealNameForEmit !== 'default') {\n            entity.nameForEmit = idealNameForEmit;\n            continue;\n          }\n        }\n      }\n\n      // Generate a unique name based on idealNameForEmit\n      let suffix: number = 1;\n      let nameForEmit: string = idealNameForEmit;\n\n      // Choose a name that doesn't conflict with usedNames or a global name\n      while (\n        nameForEmit === 'default' ||\n        usedNames.has(nameForEmit) ||\n        this.globalVariableAnalyzer.hasGlobalName(nameForEmit)\n      ) {\n        nameForEmit = `${idealNameForEmit}_${++suffix}`;\n      }\n      entity.nameForEmit = nameForEmit;\n      usedNames.add(nameForEmit);\n    }\n  }\n\n  private _fetchSymbolMetadata(astSymbol: AstSymbol): void {\n    if (astSymbol.symbolMetadata) {\n      return;\n    }\n\n    // When we solve an astSymbol, then we always also solve all of its parents and all of its declarations.\n    // The parent is solved first.\n    if (astSymbol.parentAstSymbol && astSymbol.parentAstSymbol.symbolMetadata === undefined) {\n      this._fetchSymbolMetadata(astSymbol.parentAstSymbol);\n    }\n\n    // Construct the DeclarationMetadata objects, and detect any ancillary declarations\n    this._calculateDeclarationMetadataForDeclarations(astSymbol);\n\n    // Calculate the ApiItemMetadata objects\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      this._calculateApiItemMetadata(astDeclaration);\n    }\n\n    // The most public effectiveReleaseTag for all declarations\n    let maxEffectiveReleaseTag: ReleaseTag = ReleaseTag.None;\n\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      // We know we solved this above\n      const apiItemMetadata: ApiItemMetadata = astDeclaration.apiItemMetadata as ApiItemMetadata;\n\n      const effectiveReleaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      if (effectiveReleaseTag > maxEffectiveReleaseTag) {\n        maxEffectiveReleaseTag = effectiveReleaseTag;\n      }\n    }\n\n    // Update this last when we're sure no exceptions were thrown\n    astSymbol.symbolMetadata = new SymbolMetadata({\n      maxEffectiveReleaseTag\n    });\n  }\n\n  private _calculateDeclarationMetadataForDeclarations(astSymbol: AstSymbol): void {\n    // Initialize DeclarationMetadata for each declaration\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      if (astDeclaration.declarationMetadata) {\n        throw new InternalError(\n          'AstDeclaration.declarationMetadata is not expected to have been initialized yet'\n        );\n      }\n\n      const metadata: InternalDeclarationMetadata = new InternalDeclarationMetadata();\n      metadata.tsdocParserContext = this._parseTsdocForAstDeclaration(astDeclaration);\n\n      astDeclaration.declarationMetadata = metadata;\n    }\n\n    // Detect ancillary declarations\n    for (const astDeclaration of astSymbol.astDeclarations) {\n      // For a getter/setter pair, make the setter ancillary to the getter\n      if (astDeclaration.declaration.kind === ts.SyntaxKind.SetAccessor) {\n        let foundGetter: boolean = false;\n        for (const getterAstDeclaration of astDeclaration.astSymbol.astDeclarations) {\n          if (getterAstDeclaration.declaration.kind === ts.SyntaxKind.GetAccessor) {\n            // Associate it with the getter\n            this._addAncillaryDeclaration(getterAstDeclaration, astDeclaration);\n\n            foundGetter = true;\n          }\n        }\n\n        if (!foundGetter) {\n          this.messageRouter.addAnalyzerIssue(\n            ExtractorMessageId.MissingGetter,\n            `The property \"${astDeclaration.astSymbol.localName}\" has a setter but no getter.`,\n            astDeclaration\n          );\n        }\n      }\n    }\n  }\n\n  private _addAncillaryDeclaration(\n    mainAstDeclaration: AstDeclaration,\n    ancillaryAstDeclaration: AstDeclaration\n  ): void {\n    const mainMetadata: InternalDeclarationMetadata =\n      mainAstDeclaration.declarationMetadata as InternalDeclarationMetadata;\n    const ancillaryMetadata: InternalDeclarationMetadata =\n      ancillaryAstDeclaration.declarationMetadata as InternalDeclarationMetadata;\n\n    if (mainMetadata.ancillaryDeclarations.indexOf(ancillaryAstDeclaration) >= 0) {\n      return; // already added\n    }\n\n    if (mainAstDeclaration.astSymbol !== ancillaryAstDeclaration.astSymbol) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because declarations do not' +\n          ' belong to the same symbol'\n      );\n    }\n\n    if (mainMetadata.isAncillary) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because the target is ancillary itself'\n      );\n    }\n\n    if (ancillaryMetadata.isAncillary) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because source is already ancillary' +\n          ' to another declaration'\n      );\n    }\n\n    if (mainAstDeclaration.apiItemMetadata || ancillaryAstDeclaration.apiItemMetadata) {\n      throw new InternalError(\n        'Invalid call to _addAncillaryDeclaration() because the API item metadata' +\n          ' has already been constructed'\n      );\n    }\n\n    ancillaryMetadata.isAncillary = true;\n    mainMetadata.ancillaryDeclarations.push(ancillaryAstDeclaration);\n  }\n\n  private _calculateApiItemMetadata(astDeclaration: AstDeclaration): void {\n    const declarationMetadata: InternalDeclarationMetadata =\n      astDeclaration.declarationMetadata as InternalDeclarationMetadata;\n    if (declarationMetadata.isAncillary) {\n      if (astDeclaration.declaration.kind === ts.SyntaxKind.SetAccessor) {\n        if (declarationMetadata.tsdocParserContext) {\n          this.messageRouter.addAnalyzerIssue(\n            ExtractorMessageId.SetterWithDocs,\n            `The doc comment for the property \"${astDeclaration.astSymbol.localName}\"` +\n              ` must appear on the getter, not the setter.`,\n            astDeclaration\n          );\n        }\n      }\n\n      // We never calculate ApiItemMetadata for an ancillary declaration; instead, it is assigned when\n      // the main declaration is processed.\n      return;\n    }\n\n    const options: IApiItemMetadataOptions = {\n      declaredReleaseTag: ReleaseTag.None,\n      effectiveReleaseTag: ReleaseTag.None,\n      isEventProperty: false,\n      isOverride: false,\n      isSealed: false,\n      isVirtual: false,\n      isPreapproved: false,\n      releaseTagSameAsParent: false\n    };\n\n    const parserContext: tsdoc.ParserContext | undefined = declarationMetadata.tsdocParserContext;\n    if (parserContext) {\n      const modifierTagSet: tsdoc.StandardModifierTagSet = parserContext.docComment.modifierTagSet;\n\n      let declaredReleaseTag: ReleaseTag = ReleaseTag.None;\n      let extraReleaseTags: boolean = false;\n\n      if (modifierTagSet.isPublic()) {\n        declaredReleaseTag = ReleaseTag.Public;\n      }\n      if (modifierTagSet.isBeta()) {\n        if (declaredReleaseTag !== ReleaseTag.None) {\n          extraReleaseTags = true;\n        } else {\n          declaredReleaseTag = ReleaseTag.Beta;\n        }\n      }\n      if (modifierTagSet.isAlpha()) {\n        if (declaredReleaseTag !== ReleaseTag.None) {\n          extraReleaseTags = true;\n        } else {\n          declaredReleaseTag = ReleaseTag.Alpha;\n        }\n      }\n      if (modifierTagSet.isInternal()) {\n        if (declaredReleaseTag !== ReleaseTag.None) {\n          extraReleaseTags = true;\n        } else {\n          declaredReleaseTag = ReleaseTag.Internal;\n        }\n      }\n\n      if (extraReleaseTags) {\n        if (!astDeclaration.astSymbol.isExternal) {\n          // for now, don't report errors for external code\n          this.messageRouter.addAnalyzerIssue(\n            ExtractorMessageId.ExtraReleaseTag,\n            'The doc comment should not contain more than one release tag',\n            astDeclaration\n          );\n        }\n      }\n\n      options.declaredReleaseTag = declaredReleaseTag;\n\n      options.isEventProperty = modifierTagSet.isEventProperty();\n      options.isOverride = modifierTagSet.isOverride();\n      options.isSealed = modifierTagSet.isSealed();\n      options.isVirtual = modifierTagSet.isVirtual();\n      const preapprovedTag: tsdoc.TSDocTagDefinition | void =\n        this.extractorConfig.tsdocConfiguration.tryGetTagDefinition('@preapproved');\n\n      if (preapprovedTag && modifierTagSet.hasTag(preapprovedTag)) {\n        // This feature only makes sense for potentially big declarations.\n        switch (astDeclaration.declaration.kind) {\n          case ts.SyntaxKind.ClassDeclaration:\n          case ts.SyntaxKind.EnumDeclaration:\n          case ts.SyntaxKind.InterfaceDeclaration:\n          case ts.SyntaxKind.ModuleDeclaration:\n            if (declaredReleaseTag === ReleaseTag.Internal) {\n              options.isPreapproved = true;\n            } else {\n              this.messageRouter.addAnalyzerIssue(\n                ExtractorMessageId.PreapprovedBadReleaseTag,\n                `The @preapproved tag cannot be applied to \"${astDeclaration.astSymbol.localName}\"` +\n                  ` without an @internal release tag`,\n                astDeclaration\n              );\n            }\n            break;\n          default:\n            this.messageRouter.addAnalyzerIssue(\n              ExtractorMessageId.PreapprovedUnsupportedType,\n              `The @preapproved tag cannot be applied to \"${astDeclaration.astSymbol.localName}\"` +\n                ` because it is not a supported declaration type`,\n              astDeclaration\n            );\n            break;\n        }\n      }\n    }\n\n    // This needs to be set regardless of whether or not a parserContext exists\n    if (astDeclaration.parent) {\n      const parentApiItemMetadata: ApiItemMetadata = this.fetchApiItemMetadata(astDeclaration.parent);\n      options.effectiveReleaseTag =\n        options.declaredReleaseTag === ReleaseTag.None\n          ? parentApiItemMetadata.effectiveReleaseTag\n          : options.declaredReleaseTag;\n\n      options.releaseTagSameAsParent =\n        parentApiItemMetadata.effectiveReleaseTag === options.effectiveReleaseTag;\n    } else {\n      options.effectiveReleaseTag = options.declaredReleaseTag;\n    }\n\n    if (options.effectiveReleaseTag === ReleaseTag.None) {\n      if (!astDeclaration.astSymbol.isExternal) {\n        // for now, don't report errors for external code\n        // Don't report missing release tags for forgotten exports\n        const astSymbol: AstSymbol = astDeclaration.astSymbol;\n        const entity: CollectorEntity | undefined = this._entitiesByAstEntity.get(astSymbol.rootAstSymbol);\n        if (entity && entity.consumable) {\n          // We also don't report errors for the default export of an entry point, since its doc comment\n          // isn't easy to obtain from the .d.ts file\n          if (astSymbol.rootAstSymbol.localName !== '_default') {\n            this.messageRouter.addAnalyzerIssue(\n              ExtractorMessageId.MissingReleaseTag,\n              `\"${entity.astEntity.localName}\" is exported by the package, but it is missing ` +\n                `a release tag (@alpha, @beta, @public, or @internal)`,\n              astSymbol\n            );\n          }\n        }\n      }\n\n      options.effectiveReleaseTag = ReleaseTag.Public;\n    }\n\n    const apiItemMetadata: ApiItemMetadata = new ApiItemMetadata(options);\n    if (parserContext) {\n      apiItemMetadata.tsdocComment = parserContext.docComment;\n    }\n\n    astDeclaration.apiItemMetadata = apiItemMetadata;\n\n    // Lastly, share the result with any ancillary declarations\n    for (const ancillaryDeclaration of declarationMetadata.ancillaryDeclarations) {\n      ancillaryDeclaration.apiItemMetadata = apiItemMetadata;\n    }\n  }\n\n  private _parseTsdocForAstDeclaration(astDeclaration: AstDeclaration): tsdoc.ParserContext | undefined {\n    const declaration: ts.Declaration = astDeclaration.declaration;\n    let nodeForComment: ts.Node = declaration;\n\n    if (ts.isVariableDeclaration(declaration)) {\n      // Variable declarations are special because they can be combined into a list.  For example:\n      //\n      // /** A */ export /** B */ const /** C */ x = 1, /** D **/ [ /** E */ y, z] = [3, 4];\n      //\n      // The compiler will only emit comments A and C in the .d.ts file, so in general there isn't a well-defined\n      // way to document these parts.  API Extractor requires you to break them into separate exports like this:\n      //\n      // /** A */ export const x = 1;\n      //\n      // But _getReleaseTagForDeclaration() still receives a node corresponding to \"x\", so we need to walk upwards\n      // and find the containing statement in order for getJSDocCommentRanges() to read the comment that we expect.\n      const statement: ts.VariableStatement | undefined = TypeScriptHelpers.findFirstParent(\n        declaration,\n        ts.SyntaxKind.VariableStatement\n      ) as ts.VariableStatement | undefined;\n      if (statement !== undefined) {\n        // For a compound declaration, fall back to looking for C instead of A\n        if (statement.declarationList.declarations.length === 1) {\n          nodeForComment = statement;\n        }\n      }\n    }\n\n    const sourceFileText: string = declaration.getSourceFile().text;\n    const ranges: ts.CommentRange[] =\n      TypeScriptInternals.getJSDocCommentRanges(nodeForComment, sourceFileText) || [];\n\n    if (ranges.length === 0) {\n      return undefined;\n    }\n\n    // We use the JSDoc comment block that is closest to the definition, i.e.\n    // the last one preceding it\n    const range: ts.TextRange = ranges[ranges.length - 1];\n\n    const tsdocTextRange: tsdoc.TextRange = tsdoc.TextRange.fromStringRange(\n      sourceFileText,\n      range.pos,\n      range.end\n    );\n\n    const parserContext: tsdoc.ParserContext = this._tsdocParser.parseRange(tsdocTextRange);\n\n    this.messageRouter.addTsdocMessages(parserContext, declaration.getSourceFile(), astDeclaration);\n\n    // We delete the @privateRemarks block as early as possible, to ensure that it never leaks through\n    // into one of the output files.\n    parserContext.docComment.privateRemarks = undefined;\n\n    return parserContext;\n  }\n\n  private _collectReferenceDirectives(astEntity: AstEntity): void {\n    if (astEntity instanceof AstSymbol) {\n      const sourceFiles: ts.SourceFile[] = astEntity.astDeclarations.map((astDeclaration) =>\n        astDeclaration.declaration.getSourceFile()\n      );\n      return this._collectReferenceDirectivesFromSourceFiles(sourceFiles);\n    }\n\n    if (astEntity instanceof AstNamespaceImport) {\n      const sourceFiles: ts.SourceFile[] = [astEntity.astModule.sourceFile];\n      return this._collectReferenceDirectivesFromSourceFiles(sourceFiles);\n    }\n  }\n\n  private _collectReferenceDirectivesFromSourceFiles(sourceFiles: ts.SourceFile[]): void {\n    const seenFilenames: Set<string> = new Set<string>();\n\n    for (const sourceFile of sourceFiles) {\n      if (sourceFile && sourceFile.fileName) {\n        if (!seenFilenames.has(sourceFile.fileName)) {\n          seenFilenames.add(sourceFile.fileName);\n\n          for (const typeReferenceDirective of sourceFile.typeReferenceDirectives) {\n            const name: string = sourceFile.text.substring(\n              typeReferenceDirective.pos,\n              typeReferenceDirective.end\n            );\n            this._dtsTypeReferenceDirectives.add(name);\n          }\n\n          for (const libReferenceDirective of sourceFile.libReferenceDirectives) {\n            const name: string = sourceFile.text.substring(\n              libReferenceDirective.pos,\n              libReferenceDirective.end\n            );\n            this._dtsLibReferenceDirectives.add(name);\n          }\n        }\n      }\n    }\n  }\n}\n"]}

package/lib/generators/ApiModelGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiModelGenerator.d.ts","sourceRoot":"","sources":["../../src/generators/ApiModelGenerator.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,QAAQ,EAER,UAAU,EAuBX,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWnD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgC;gBAEjD,SAAS,EAAE,SAAS;IAYvC,IAAW,QAAQ,IAAI,QAAQ,CAE9B;IAEM,eAAe,IAAI,UAAU;IAuBpC,OAAO,CAAC,iBAAiB;IAqCzB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,mBAAmB;IAyF3B,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,wBAAwB;IAkDhC,OAAO,CAAC,sBAAsB;IAwC9B,OAAO,CAAC,gBAAgB;IA2DxB,OAAO,CAAC,6BAA6B;IAkDrC,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,qBAAqB;IAqC7B,OAAO,CAAC,mBAAmB;IAsD3B,OAAO,CAAC,yBAAyB;IA4CjC,OAAO,CAAC,oBAAoB;IAuD5B,OAAO,CAAC,iBAAiB;IA0DzB,OAAO,CAAC,0BAA0B;IAuDlC,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,mBAAmB;IA6C3B,OAAO,CAAC,4BAA4B;IA2CpC,OAAO,CAAC,oBAAoB;IA6C5B,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,sBAAsB;IAuB9B,OAAO,CAAC,kBAAkB;CAgB3B"}
+{"version":3,"file":"ApiModelGenerator.d.ts","sourceRoot":"","sources":["../../src/generators/ApiModelGenerator.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,QAAQ,EAER,UAAU,EAuBX,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWnD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgC;gBAEjD,SAAS,EAAE,SAAS;IAYvC,IAAW,QAAQ,IAAI,QAAQ,CAE9B;IAEM,eAAe,IAAI,UAAU;IAuBpC,OAAO,CAAC,iBAAiB;IAqCzB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,mBAAmB;IA6F3B,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,wBAAwB;IAkDhC,OAAO,CAAC,sBAAsB;IAwC9B,OAAO,CAAC,gBAAgB;IA2DxB,OAAO,CAAC,6BAA6B;IAkDrC,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,qBAAqB;IAqC7B,OAAO,CAAC,mBAAmB;IAsD3B,OAAO,CAAC,yBAAyB;IA4CjC,OAAO,CAAC,oBAAoB;IAuD5B,OAAO,CAAC,iBAAiB;IA0DzB,OAAO,CAAC,0BAA0B;IAuDlC,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,mBAAmB;IAwD3B,OAAO,CAAC,4BAA4B;IA2CpC,OAAO,CAAC,oBAAoB;IA6C5B,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,sBAAsB;IAuB9B,OAAO,CAAC,kBAAkB;CAgB3B"}

package/lib/generators/ApiModelGenerator.js

@@ -141,6 +141,9 @@ class ApiModelGenerator {
             case ts.SyntaxKind.GetAccessor:
                 this._processApiProperty(astDeclaration, exportedName, parentApiItem);
                 break;
+            case ts.SyntaxKind.SetAccessor:
+                this._processApiProperty(astDeclaration, exportedName, parentApiItem);
+                break;
             case ts.SyntaxKind.IndexSignature:
                 this._processApiIndexSignature(astDeclaration, exportedName, parentApiItem);
                 break;
@@ -510,10 +513,18 @@ class ApiModelGenerator {
         const containerKey = api_extractor_model_1.ApiProperty.getContainerKey(name, isStatic);
         let apiProperty = parentApiItem.tryGetMemberByKey(containerKey);
         if (apiProperty === undefined) {
-            const propertyDeclaration = astDeclaration.declaration;
             const nodesToCapture = [];
             const propertyTypeTokenRange = ExcerptBuilder_1.ExcerptBuilder.createEmptyTokenRange();
-            nodesToCapture.push({ node: propertyDeclaration.type, tokenRange: propertyTypeTokenRange });
+            let propertyTypeNode;
+            if (ts.isPropertyDeclaration(astDeclaration.declaration) ||
+                ts.isGetAccessorDeclaration(astDeclaration.declaration)) {
+                propertyTypeNode = astDeclaration.declaration.type;
+            }
+            if (ts.isSetAccessorDeclaration(astDeclaration.declaration)) {
+                // Note that TypeScript always reports an error if a setter does not have exactly one parameter.
+                propertyTypeNode = astDeclaration.declaration.parameters[0].type;
+            }
+            nodesToCapture.push({ node: propertyTypeNode, tokenRange: propertyTypeTokenRange });
             const excerptTokens = this._buildExcerptTokens(astDeclaration, nodesToCapture);
             const apiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);
             const docComment = apiItemMetadata.tsdocComment;

package/lib/generators/ApiModelGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiModelGenerator.js","sourceRoot":"","sources":["../../src/generators/ApiModelGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/* eslint-disable no-bitwise */\n\nimport * as ts from 'typescript';\nimport * as tsdoc from '@microsoft/tsdoc';\nimport {\n  ApiModel,\n  ApiClass,\n  ApiPackage,\n  ApiEntryPoint,\n  ApiMethod,\n  ApiNamespace,\n  ApiInterface,\n  ApiPropertySignature,\n  ApiItemContainerMixin,\n  ReleaseTag,\n  ApiProperty,\n  ApiMethodSignature,\n  IApiParameterOptions,\n  ApiEnum,\n  ApiEnumMember,\n  IExcerptTokenRange,\n  IExcerptToken,\n  ApiConstructor,\n  ApiConstructSignature,\n  ApiFunction,\n  ApiIndexSignature,\n  ApiVariable,\n  ApiTypeAlias,\n  ApiCallSignature,\n  IApiTypeParameterOptions\n} from '@microsoft/api-extractor-model';\n\nimport { Collector } from '../collector/Collector';\nimport { AstDeclaration } from '../analyzer/AstDeclaration';\nimport { ExcerptBuilder, IExcerptBuilderNodeToCapture } from './ExcerptBuilder';\nimport { AstSymbol } from '../analyzer/AstSymbol';\nimport { DeclarationReferenceGenerator } from './DeclarationReferenceGenerator';\nimport { ApiItemMetadata } from '../collector/ApiItemMetadata';\nimport { DeclarationMetadata } from '../collector/DeclarationMetadata';\nimport { AstNamespaceImport } from '../analyzer/AstNamespaceImport';\nimport { AstEntity } from '../analyzer/AstEntity';\nimport { AstModule } from '../analyzer/AstModule';\n\nexport class ApiModelGenerator {\n  private readonly _collector: Collector;\n  private readonly _apiModel: ApiModel;\n  private readonly _referenceGenerator: DeclarationReferenceGenerator;\n\n  public constructor(collector: Collector) {\n    this._collector = collector;\n    this._apiModel = new ApiModel();\n    this._referenceGenerator = new DeclarationReferenceGenerator(\n      collector.packageJsonLookup,\n      collector.workingPackage.name,\n      collector.program,\n      collector.typeChecker,\n      collector.bundledPackageNames\n    );\n  }\n\n  public get apiModel(): ApiModel {\n    return this._apiModel;\n  }\n\n  public buildApiPackage(): ApiPackage {\n    const packageDocComment: tsdoc.DocComment | undefined = this._collector.workingPackage.tsdocComment;\n\n    const apiPackage: ApiPackage = new ApiPackage({\n      name: this._collector.workingPackage.name,\n      docComment: packageDocComment,\n      tsdocConfiguration: this._collector.extractorConfig.tsdocConfiguration\n    });\n    this._apiModel.addMember(apiPackage);\n\n    const apiEntryPoint: ApiEntryPoint = new ApiEntryPoint({ name: '' });\n    apiPackage.addMember(apiEntryPoint);\n\n    // Create a CollectorEntity for each top-level export\n    for (const entity of this._collector.entities) {\n      if (entity.exported) {\n        this._processAstEntity(entity.astEntity, entity.nameForEmit, apiEntryPoint);\n      }\n    }\n\n    return apiPackage;\n  }\n\n  private _processAstEntity(\n    astEntity: AstEntity,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    if (astEntity instanceof AstSymbol) {\n      // Skip ancillary declarations; we will process them with the main declaration\n      for (const astDeclaration of this._collector.getNonAncillaryDeclarations(astEntity)) {\n        this._processDeclaration(astDeclaration, exportedName, parentApiItem);\n      }\n      return;\n    }\n\n    if (astEntity instanceof AstNamespaceImport) {\n      // Note that a single API item can belong to two different AstNamespaceImport namespaces.  For example:\n      //\n      //   // file.ts defines \"thing()\"\n      //   import * as example1 from \"./file\";\n      //   import * as example2 from \"./file\";\n      //\n      //   // ...so here we end up with example1.thing() and example2.thing()\n      //   export { example1, example2 }\n      //\n      // The current logic does not try to associate \"thing()\" with a specific parent.  Instead\n      // the API documentation will show duplicated entries for example1.thing() and example2.thing()./\n      //\n      // This could be improved in the future, but it requires a stable mechanism for choosing an associated parent.\n      // For thoughts about this:  https://github.com/microsoft/rushstack/issues/1308\n      this._processAstModule(astEntity.astModule, exportedName, parentApiItem);\n      return;\n    }\n\n    // TODO: Figure out how to represent reexported AstImport objects.  Basically we need to introduce a new\n    // ApiItem subclass for \"export alias\", similar to a type alias, but representing declarations of the\n    // form \"export { X } from 'external-package'\".  We can also use this to solve GitHub issue #950.\n  }\n\n  private _processAstModule(\n    astModule: AstModule,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astModule.moduleSymbol.name;\n    const containerKey: string = ApiNamespace.getContainerKey(name);\n\n    let apiNamespace: ApiNamespace | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiNamespace;\n\n    if (apiNamespace === undefined) {\n      apiNamespace = new ApiNamespace({\n        name,\n        docComment: undefined,\n        releaseTag: ReleaseTag.None,\n        excerptTokens: []\n      });\n      parentApiItem.addMember(apiNamespace);\n    }\n\n    astModule.astModuleExportInfo!.exportedLocalEntities.forEach(\n      (exportedEntity: AstEntity, exportedName: string) => {\n        this._processAstEntity(exportedEntity, exportedName, apiNamespace!);\n      }\n    );\n  }\n\n  private _processDeclaration(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    if ((astDeclaration.modifierFlags & ts.ModifierFlags.Private) !== 0) {\n      return; // trim out private declarations\n    }\n\n    const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n    const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n    if (releaseTag === ReleaseTag.Internal || releaseTag === ReleaseTag.Alpha) {\n      return; // trim out items marked as \"@internal\" or \"@alpha\"\n    }\n\n    switch (astDeclaration.declaration.kind) {\n      case ts.SyntaxKind.CallSignature:\n        this._processApiCallSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.Constructor:\n        this._processApiConstructor(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.ConstructSignature:\n        this._processApiConstructSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.ClassDeclaration:\n        this._processApiClass(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.EnumDeclaration:\n        this._processApiEnum(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.EnumMember:\n        this._processApiEnumMember(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.FunctionDeclaration:\n        this._processApiFunction(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.GetAccessor:\n        this._processApiProperty(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.IndexSignature:\n        this._processApiIndexSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.InterfaceDeclaration:\n        this._processApiInterface(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.MethodDeclaration:\n        this._processApiMethod(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.MethodSignature:\n        this._processApiMethodSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.ModuleDeclaration:\n        this._processApiNamespace(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.PropertyDeclaration:\n        this._processApiProperty(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.PropertySignature:\n        this._processApiPropertySignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.TypeAliasDeclaration:\n        this._processApiTypeAlias(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.VariableDeclaration:\n        this._processApiVariable(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      default:\n      // ignore unknown types\n    }\n  }\n\n  private _processChildDeclarations(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    for (const childDeclaration of astDeclaration.children) {\n      this._processDeclaration(childDeclaration, undefined, parentApiItem);\n    }\n  }\n\n  private _processApiCallSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiCallSignature.getContainerKey(overloadIndex);\n\n    let apiCallSignature: ApiCallSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiCallSignature;\n\n    if (apiCallSignature === undefined) {\n      const callSignature: ts.CallSignatureDeclaration =\n        astDeclaration.declaration as ts.CallSignatureDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: callSignature.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        callSignature.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        callSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiCallSignature = new ApiCallSignature({\n        docComment,\n        releaseTag,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiCallSignature);\n    }\n  }\n\n  private _processApiConstructor(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiConstructor.getContainerKey(overloadIndex);\n\n    let apiConstructor: ApiConstructor | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiConstructor;\n\n    if (apiConstructor === undefined) {\n      const constructorDeclaration: ts.ConstructorDeclaration =\n        astDeclaration.declaration as ts.ConstructorDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        constructorDeclaration.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiConstructor = new ApiConstructor({\n        docComment,\n        releaseTag,\n        parameters,\n        overloadIndex,\n        excerptTokens\n      });\n\n      parentApiItem.addMember(apiConstructor);\n    }\n  }\n\n  private _processApiClass(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiClass.getContainerKey(name);\n\n    let apiClass: ApiClass | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiClass;\n\n    if (apiClass === undefined) {\n      const classDeclaration: ts.ClassDeclaration = astDeclaration.declaration as ts.ClassDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        classDeclaration.typeParameters\n      );\n\n      let extendsTokenRange: IExcerptTokenRange | undefined = undefined;\n      const implementsTokenRanges: IExcerptTokenRange[] = [];\n\n      for (const heritageClause of classDeclaration.heritageClauses || []) {\n        if (heritageClause.token === ts.SyntaxKind.ExtendsKeyword) {\n          extendsTokenRange = ExcerptBuilder.createEmptyTokenRange();\n          if (heritageClause.types.length > 0) {\n            nodesToCapture.push({ node: heritageClause.types[0], tokenRange: extendsTokenRange });\n          }\n        } else if (heritageClause.token === ts.SyntaxKind.ImplementsKeyword) {\n          for (const heritageType of heritageClause.types) {\n            const implementsTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n            implementsTokenRanges.push(implementsTokenRange);\n            nodesToCapture.push({ node: heritageType, tokenRange: implementsTokenRange });\n          }\n        }\n      }\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiClass = new ApiClass({\n        name,\n        docComment,\n        releaseTag,\n        excerptTokens,\n        typeParameters,\n        extendsTokenRange,\n        implementsTokenRanges\n      });\n\n      parentApiItem.addMember(apiClass);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiClass);\n  }\n\n  private _processApiConstructSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiConstructSignature.getContainerKey(overloadIndex);\n\n    let apiConstructSignature: ApiConstructSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiConstructSignature;\n\n    if (apiConstructSignature === undefined) {\n      const constructSignature: ts.ConstructSignatureDeclaration =\n        astDeclaration.declaration as ts.ConstructSignatureDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: constructSignature.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        constructSignature.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        constructSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiConstructSignature = new ApiConstructSignature({\n        docComment,\n        releaseTag,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiConstructSignature);\n    }\n  }\n\n  private _processApiEnum(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiEnum.getContainerKey(name);\n\n    let apiEnum: ApiEnum | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiEnum;\n\n    if (apiEnum === undefined) {\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, []);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiEnum = new ApiEnum({ name, docComment, releaseTag, excerptTokens });\n      parentApiItem.addMember(apiEnum);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiEnum);\n  }\n\n  private _processApiEnumMember(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiEnumMember.getContainerKey(name);\n\n    let apiEnumMember: ApiEnumMember | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiEnumMember;\n\n    if (apiEnumMember === undefined) {\n      const enumMember: ts.EnumMember = astDeclaration.declaration as ts.EnumMember;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const initializerTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: enumMember.initializer, tokenRange: initializerTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiEnumMember = new ApiEnumMember({\n        name,\n        docComment,\n        releaseTag,\n        excerptTokens,\n        initializerTokenRange\n      });\n\n      parentApiItem.addMember(apiEnumMember);\n    }\n  }\n\n  private _processApiFunction(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiFunction.getContainerKey(name, overloadIndex);\n\n    let apiFunction: ApiFunction | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiFunction;\n\n    if (apiFunction === undefined) {\n      const functionDeclaration: ts.FunctionDeclaration =\n        astDeclaration.declaration as ts.FunctionDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: functionDeclaration.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        functionDeclaration.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        functionDeclaration.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      if (releaseTag === ReleaseTag.Internal || releaseTag === ReleaseTag.Alpha) {\n        return; // trim out items marked as \"@internal\" or \"@alpha\"\n      }\n\n      apiFunction = new ApiFunction({\n        name,\n        docComment,\n        releaseTag,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiFunction);\n    }\n  }\n\n  private _processApiIndexSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiIndexSignature.getContainerKey(overloadIndex);\n\n    let apiIndexSignature: ApiIndexSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiIndexSignature;\n\n    if (apiIndexSignature === undefined) {\n      const indexSignature: ts.IndexSignatureDeclaration =\n        astDeclaration.declaration as ts.IndexSignatureDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: indexSignature.type, tokenRange: returnTypeTokenRange });\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        indexSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiIndexSignature = new ApiIndexSignature({\n        docComment,\n        releaseTag,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiIndexSignature);\n    }\n  }\n\n  private _processApiInterface(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiInterface.getContainerKey(name);\n\n    let apiInterface: ApiInterface | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiInterface;\n\n    if (apiInterface === undefined) {\n      const interfaceDeclaration: ts.InterfaceDeclaration =\n        astDeclaration.declaration as ts.InterfaceDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        interfaceDeclaration.typeParameters\n      );\n\n      const extendsTokenRanges: IExcerptTokenRange[] = [];\n\n      for (const heritageClause of interfaceDeclaration.heritageClauses || []) {\n        if (heritageClause.token === ts.SyntaxKind.ExtendsKeyword) {\n          for (const heritageType of heritageClause.types) {\n            const extendsTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n            extendsTokenRanges.push(extendsTokenRange);\n            nodesToCapture.push({ node: heritageType, tokenRange: extendsTokenRange });\n          }\n        }\n      }\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiInterface = new ApiInterface({\n        name,\n        docComment,\n        releaseTag,\n        excerptTokens,\n        typeParameters,\n        extendsTokenRanges\n      });\n\n      parentApiItem.addMember(apiInterface);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiInterface);\n  }\n\n  private _processApiMethod(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const isStatic: boolean = (astDeclaration.modifierFlags & ts.ModifierFlags.Static) !== 0;\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiMethod.getContainerKey(name, isStatic, overloadIndex);\n\n    let apiMethod: ApiMethod | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiMethod;\n\n    if (apiMethod === undefined) {\n      const methodDeclaration: ts.MethodDeclaration = astDeclaration.declaration as ts.MethodDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: methodDeclaration.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        methodDeclaration.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        methodDeclaration.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      if (releaseTag === ReleaseTag.Internal || releaseTag === ReleaseTag.Alpha) {\n        return; // trim out items marked as \"@internal\" or \"@alpha\"\n      }\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiMethod = new ApiMethod({\n        name,\n        docComment,\n        releaseTag,\n        isStatic,\n        isOptional,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiMethod);\n    }\n  }\n\n  private _processApiMethodSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiMethodSignature.getContainerKey(name, overloadIndex);\n\n    let apiMethodSignature: ApiMethodSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiMethodSignature;\n\n    if (apiMethodSignature === undefined) {\n      const methodSignature: ts.MethodSignature = astDeclaration.declaration as ts.MethodSignature;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: methodSignature.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        methodSignature.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        methodSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiMethodSignature = new ApiMethodSignature({\n        name,\n        docComment,\n        releaseTag,\n        isOptional,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiMethodSignature);\n    }\n  }\n\n  private _processApiNamespace(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiNamespace.getContainerKey(name);\n\n    let apiNamespace: ApiNamespace | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiNamespace;\n\n    if (apiNamespace === undefined) {\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, []);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiNamespace = new ApiNamespace({ name, docComment, releaseTag, excerptTokens });\n      parentApiItem.addMember(apiNamespace);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiNamespace);\n  }\n\n  private _processApiProperty(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const isStatic: boolean = (astDeclaration.modifierFlags & ts.ModifierFlags.Static) !== 0;\n\n    const containerKey: string = ApiProperty.getContainerKey(name, isStatic);\n\n    let apiProperty: ApiProperty | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiProperty;\n\n    if (apiProperty === undefined) {\n      const propertyDeclaration: ts.PropertyDeclaration =\n        astDeclaration.declaration as ts.PropertyDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const propertyTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: propertyDeclaration.type, tokenRange: propertyTypeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiProperty = new ApiProperty({\n        name,\n        docComment,\n        releaseTag,\n        isStatic,\n        isOptional,\n        excerptTokens,\n        propertyTypeTokenRange\n      });\n      parentApiItem.addMember(apiProperty);\n    } else {\n      // If the property was already declared before (via a merged interface declaration),\n      // we assume its signature is identical, because the language requires that.\n    }\n  }\n\n  private _processApiPropertySignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiPropertySignature.getContainerKey(name);\n\n    let apiPropertySignature: ApiPropertySignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiPropertySignature;\n\n    if (apiPropertySignature === undefined) {\n      const propertySignature: ts.PropertySignature = astDeclaration.declaration as ts.PropertySignature;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const propertyTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: propertySignature.type, tokenRange: propertyTypeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiPropertySignature = new ApiPropertySignature({\n        name,\n        docComment,\n        releaseTag,\n        isOptional,\n        excerptTokens,\n        propertyTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiPropertySignature);\n    } else {\n      // If the property was already declared before (via a merged interface declaration),\n      // we assume its signature is identical, because the language requires that.\n    }\n  }\n\n  private _processApiTypeAlias(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const containerKey: string = ApiTypeAlias.getContainerKey(name);\n\n    let apiTypeAlias: ApiTypeAlias | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiTypeAlias;\n\n    if (apiTypeAlias === undefined) {\n      const typeAliasDeclaration: ts.TypeAliasDeclaration =\n        astDeclaration.declaration as ts.TypeAliasDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        typeAliasDeclaration.typeParameters\n      );\n\n      const typeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: typeAliasDeclaration.type, tokenRange: typeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiTypeAlias = new ApiTypeAlias({\n        name,\n        docComment,\n        typeParameters,\n        releaseTag,\n        excerptTokens,\n        typeTokenRange\n      });\n\n      parentApiItem.addMember(apiTypeAlias);\n    }\n  }\n\n  private _processApiVariable(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const containerKey: string = ApiVariable.getContainerKey(name);\n\n    let apiVariable: ApiVariable | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiVariable;\n\n    if (apiVariable === undefined) {\n      const variableDeclaration: ts.VariableDeclaration =\n        astDeclaration.declaration as ts.VariableDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const variableTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: variableDeclaration.type, tokenRange: variableTypeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiVariable = new ApiVariable({ name, docComment, releaseTag, excerptTokens, variableTypeTokenRange });\n\n      parentApiItem.addMember(apiVariable);\n    }\n  }\n\n  /**\n   * @param nodesToCapture - A list of child nodes whose token ranges we want to capture\n   */\n  private _buildExcerptTokens(\n    astDeclaration: AstDeclaration,\n    nodesToCapture: IExcerptBuilderNodeToCapture[]\n  ): IExcerptToken[] {\n    const excerptTokens: IExcerptToken[] = [];\n\n    // Build the main declaration\n    ExcerptBuilder.addDeclaration(excerptTokens, astDeclaration, nodesToCapture, this._referenceGenerator);\n\n    const declarationMetadata: DeclarationMetadata = this._collector.fetchDeclarationMetadata(astDeclaration);\n\n    // Add any ancillary declarations\n    for (const ancillaryDeclaration of declarationMetadata.ancillaryDeclarations) {\n      ExcerptBuilder.addBlankLine(excerptTokens);\n      ExcerptBuilder.addDeclaration(\n        excerptTokens,\n        ancillaryDeclaration,\n        nodesToCapture,\n        this._referenceGenerator\n      );\n    }\n\n    return excerptTokens;\n  }\n\n  private _captureTypeParameters(\n    nodesToCapture: IExcerptBuilderNodeToCapture[],\n    typeParameterNodes: ts.NodeArray<ts.TypeParameterDeclaration> | undefined\n  ): IApiTypeParameterOptions[] {\n    const typeParameters: IApiTypeParameterOptions[] = [];\n    if (typeParameterNodes) {\n      for (const typeParameter of typeParameterNodes) {\n        const constraintTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n        nodesToCapture.push({ node: typeParameter.constraint, tokenRange: constraintTokenRange });\n\n        const defaultTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n        nodesToCapture.push({ node: typeParameter.default, tokenRange: defaultTypeTokenRange });\n\n        typeParameters.push({\n          typeParameterName: typeParameter.name.getText().trim(),\n          constraintTokenRange,\n          defaultTypeTokenRange\n        });\n      }\n    }\n    return typeParameters;\n  }\n\n  private _captureParameters(\n    nodesToCapture: IExcerptBuilderNodeToCapture[],\n    parameterNodes: ts.NodeArray<ts.ParameterDeclaration>\n  ): IApiParameterOptions[] {\n    const parameters: IApiParameterOptions[] = [];\n    for (const parameter of parameterNodes) {\n      const parameterTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: parameter.type, tokenRange: parameterTypeTokenRange });\n      parameters.push({\n        parameterName: parameter.name.getText().trim(),\n        parameterTypeTokenRange,\n        isOptional: this._collector.typeChecker.isOptionalParameter(parameter)\n      });\n    }\n    return parameters;\n  }\n}\n"]}
+{"version":3,"file":"ApiModelGenerator.js","sourceRoot":"","sources":["../../src/generators/ApiModelGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/* eslint-disable no-bitwise */\n\nimport * as ts from 'typescript';\nimport * as tsdoc from '@microsoft/tsdoc';\nimport {\n  ApiModel,\n  ApiClass,\n  ApiPackage,\n  ApiEntryPoint,\n  ApiMethod,\n  ApiNamespace,\n  ApiInterface,\n  ApiPropertySignature,\n  ApiItemContainerMixin,\n  ReleaseTag,\n  ApiProperty,\n  ApiMethodSignature,\n  IApiParameterOptions,\n  ApiEnum,\n  ApiEnumMember,\n  IExcerptTokenRange,\n  IExcerptToken,\n  ApiConstructor,\n  ApiConstructSignature,\n  ApiFunction,\n  ApiIndexSignature,\n  ApiVariable,\n  ApiTypeAlias,\n  ApiCallSignature,\n  IApiTypeParameterOptions\n} from '@microsoft/api-extractor-model';\n\nimport { Collector } from '../collector/Collector';\nimport { AstDeclaration } from '../analyzer/AstDeclaration';\nimport { ExcerptBuilder, IExcerptBuilderNodeToCapture } from './ExcerptBuilder';\nimport { AstSymbol } from '../analyzer/AstSymbol';\nimport { DeclarationReferenceGenerator } from './DeclarationReferenceGenerator';\nimport { ApiItemMetadata } from '../collector/ApiItemMetadata';\nimport { DeclarationMetadata } from '../collector/DeclarationMetadata';\nimport { AstNamespaceImport } from '../analyzer/AstNamespaceImport';\nimport { AstEntity } from '../analyzer/AstEntity';\nimport { AstModule } from '../analyzer/AstModule';\n\nexport class ApiModelGenerator {\n  private readonly _collector: Collector;\n  private readonly _apiModel: ApiModel;\n  private readonly _referenceGenerator: DeclarationReferenceGenerator;\n\n  public constructor(collector: Collector) {\n    this._collector = collector;\n    this._apiModel = new ApiModel();\n    this._referenceGenerator = new DeclarationReferenceGenerator(\n      collector.packageJsonLookup,\n      collector.workingPackage.name,\n      collector.program,\n      collector.typeChecker,\n      collector.bundledPackageNames\n    );\n  }\n\n  public get apiModel(): ApiModel {\n    return this._apiModel;\n  }\n\n  public buildApiPackage(): ApiPackage {\n    const packageDocComment: tsdoc.DocComment | undefined = this._collector.workingPackage.tsdocComment;\n\n    const apiPackage: ApiPackage = new ApiPackage({\n      name: this._collector.workingPackage.name,\n      docComment: packageDocComment,\n      tsdocConfiguration: this._collector.extractorConfig.tsdocConfiguration\n    });\n    this._apiModel.addMember(apiPackage);\n\n    const apiEntryPoint: ApiEntryPoint = new ApiEntryPoint({ name: '' });\n    apiPackage.addMember(apiEntryPoint);\n\n    // Create a CollectorEntity for each top-level export\n    for (const entity of this._collector.entities) {\n      if (entity.exported) {\n        this._processAstEntity(entity.astEntity, entity.nameForEmit, apiEntryPoint);\n      }\n    }\n\n    return apiPackage;\n  }\n\n  private _processAstEntity(\n    astEntity: AstEntity,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    if (astEntity instanceof AstSymbol) {\n      // Skip ancillary declarations; we will process them with the main declaration\n      for (const astDeclaration of this._collector.getNonAncillaryDeclarations(astEntity)) {\n        this._processDeclaration(astDeclaration, exportedName, parentApiItem);\n      }\n      return;\n    }\n\n    if (astEntity instanceof AstNamespaceImport) {\n      // Note that a single API item can belong to two different AstNamespaceImport namespaces.  For example:\n      //\n      //   // file.ts defines \"thing()\"\n      //   import * as example1 from \"./file\";\n      //   import * as example2 from \"./file\";\n      //\n      //   // ...so here we end up with example1.thing() and example2.thing()\n      //   export { example1, example2 }\n      //\n      // The current logic does not try to associate \"thing()\" with a specific parent.  Instead\n      // the API documentation will show duplicated entries for example1.thing() and example2.thing()./\n      //\n      // This could be improved in the future, but it requires a stable mechanism for choosing an associated parent.\n      // For thoughts about this:  https://github.com/microsoft/rushstack/issues/1308\n      this._processAstModule(astEntity.astModule, exportedName, parentApiItem);\n      return;\n    }\n\n    // TODO: Figure out how to represent reexported AstImport objects.  Basically we need to introduce a new\n    // ApiItem subclass for \"export alias\", similar to a type alias, but representing declarations of the\n    // form \"export { X } from 'external-package'\".  We can also use this to solve GitHub issue #950.\n  }\n\n  private _processAstModule(\n    astModule: AstModule,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astModule.moduleSymbol.name;\n    const containerKey: string = ApiNamespace.getContainerKey(name);\n\n    let apiNamespace: ApiNamespace | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiNamespace;\n\n    if (apiNamespace === undefined) {\n      apiNamespace = new ApiNamespace({\n        name,\n        docComment: undefined,\n        releaseTag: ReleaseTag.None,\n        excerptTokens: []\n      });\n      parentApiItem.addMember(apiNamespace);\n    }\n\n    astModule.astModuleExportInfo!.exportedLocalEntities.forEach(\n      (exportedEntity: AstEntity, exportedName: string) => {\n        this._processAstEntity(exportedEntity, exportedName, apiNamespace!);\n      }\n    );\n  }\n\n  private _processDeclaration(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    if ((astDeclaration.modifierFlags & ts.ModifierFlags.Private) !== 0) {\n      return; // trim out private declarations\n    }\n\n    const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n    const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n    if (releaseTag === ReleaseTag.Internal || releaseTag === ReleaseTag.Alpha) {\n      return; // trim out items marked as \"@internal\" or \"@alpha\"\n    }\n\n    switch (astDeclaration.declaration.kind) {\n      case ts.SyntaxKind.CallSignature:\n        this._processApiCallSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.Constructor:\n        this._processApiConstructor(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.ConstructSignature:\n        this._processApiConstructSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.ClassDeclaration:\n        this._processApiClass(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.EnumDeclaration:\n        this._processApiEnum(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.EnumMember:\n        this._processApiEnumMember(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.FunctionDeclaration:\n        this._processApiFunction(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.GetAccessor:\n        this._processApiProperty(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.SetAccessor:\n        this._processApiProperty(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.IndexSignature:\n        this._processApiIndexSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.InterfaceDeclaration:\n        this._processApiInterface(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.MethodDeclaration:\n        this._processApiMethod(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.MethodSignature:\n        this._processApiMethodSignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.ModuleDeclaration:\n        this._processApiNamespace(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.PropertyDeclaration:\n        this._processApiProperty(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.PropertySignature:\n        this._processApiPropertySignature(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.TypeAliasDeclaration:\n        this._processApiTypeAlias(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      case ts.SyntaxKind.VariableDeclaration:\n        this._processApiVariable(astDeclaration, exportedName, parentApiItem);\n        break;\n\n      default:\n      // ignore unknown types\n    }\n  }\n\n  private _processChildDeclarations(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    for (const childDeclaration of astDeclaration.children) {\n      this._processDeclaration(childDeclaration, undefined, parentApiItem);\n    }\n  }\n\n  private _processApiCallSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiCallSignature.getContainerKey(overloadIndex);\n\n    let apiCallSignature: ApiCallSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiCallSignature;\n\n    if (apiCallSignature === undefined) {\n      const callSignature: ts.CallSignatureDeclaration =\n        astDeclaration.declaration as ts.CallSignatureDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: callSignature.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        callSignature.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        callSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiCallSignature = new ApiCallSignature({\n        docComment,\n        releaseTag,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiCallSignature);\n    }\n  }\n\n  private _processApiConstructor(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiConstructor.getContainerKey(overloadIndex);\n\n    let apiConstructor: ApiConstructor | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiConstructor;\n\n    if (apiConstructor === undefined) {\n      const constructorDeclaration: ts.ConstructorDeclaration =\n        astDeclaration.declaration as ts.ConstructorDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        constructorDeclaration.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiConstructor = new ApiConstructor({\n        docComment,\n        releaseTag,\n        parameters,\n        overloadIndex,\n        excerptTokens\n      });\n\n      parentApiItem.addMember(apiConstructor);\n    }\n  }\n\n  private _processApiClass(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiClass.getContainerKey(name);\n\n    let apiClass: ApiClass | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiClass;\n\n    if (apiClass === undefined) {\n      const classDeclaration: ts.ClassDeclaration = astDeclaration.declaration as ts.ClassDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        classDeclaration.typeParameters\n      );\n\n      let extendsTokenRange: IExcerptTokenRange | undefined = undefined;\n      const implementsTokenRanges: IExcerptTokenRange[] = [];\n\n      for (const heritageClause of classDeclaration.heritageClauses || []) {\n        if (heritageClause.token === ts.SyntaxKind.ExtendsKeyword) {\n          extendsTokenRange = ExcerptBuilder.createEmptyTokenRange();\n          if (heritageClause.types.length > 0) {\n            nodesToCapture.push({ node: heritageClause.types[0], tokenRange: extendsTokenRange });\n          }\n        } else if (heritageClause.token === ts.SyntaxKind.ImplementsKeyword) {\n          for (const heritageType of heritageClause.types) {\n            const implementsTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n            implementsTokenRanges.push(implementsTokenRange);\n            nodesToCapture.push({ node: heritageType, tokenRange: implementsTokenRange });\n          }\n        }\n      }\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiClass = new ApiClass({\n        name,\n        docComment,\n        releaseTag,\n        excerptTokens,\n        typeParameters,\n        extendsTokenRange,\n        implementsTokenRanges\n      });\n\n      parentApiItem.addMember(apiClass);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiClass);\n  }\n\n  private _processApiConstructSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiConstructSignature.getContainerKey(overloadIndex);\n\n    let apiConstructSignature: ApiConstructSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiConstructSignature;\n\n    if (apiConstructSignature === undefined) {\n      const constructSignature: ts.ConstructSignatureDeclaration =\n        astDeclaration.declaration as ts.ConstructSignatureDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: constructSignature.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        constructSignature.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        constructSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiConstructSignature = new ApiConstructSignature({\n        docComment,\n        releaseTag,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiConstructSignature);\n    }\n  }\n\n  private _processApiEnum(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiEnum.getContainerKey(name);\n\n    let apiEnum: ApiEnum | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiEnum;\n\n    if (apiEnum === undefined) {\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, []);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiEnum = new ApiEnum({ name, docComment, releaseTag, excerptTokens });\n      parentApiItem.addMember(apiEnum);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiEnum);\n  }\n\n  private _processApiEnumMember(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiEnumMember.getContainerKey(name);\n\n    let apiEnumMember: ApiEnumMember | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiEnumMember;\n\n    if (apiEnumMember === undefined) {\n      const enumMember: ts.EnumMember = astDeclaration.declaration as ts.EnumMember;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const initializerTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: enumMember.initializer, tokenRange: initializerTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiEnumMember = new ApiEnumMember({\n        name,\n        docComment,\n        releaseTag,\n        excerptTokens,\n        initializerTokenRange\n      });\n\n      parentApiItem.addMember(apiEnumMember);\n    }\n  }\n\n  private _processApiFunction(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiFunction.getContainerKey(name, overloadIndex);\n\n    let apiFunction: ApiFunction | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiFunction;\n\n    if (apiFunction === undefined) {\n      const functionDeclaration: ts.FunctionDeclaration =\n        astDeclaration.declaration as ts.FunctionDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: functionDeclaration.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        functionDeclaration.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        functionDeclaration.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      if (releaseTag === ReleaseTag.Internal || releaseTag === ReleaseTag.Alpha) {\n        return; // trim out items marked as \"@internal\" or \"@alpha\"\n      }\n\n      apiFunction = new ApiFunction({\n        name,\n        docComment,\n        releaseTag,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiFunction);\n    }\n  }\n\n  private _processApiIndexSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiIndexSignature.getContainerKey(overloadIndex);\n\n    let apiIndexSignature: ApiIndexSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiIndexSignature;\n\n    if (apiIndexSignature === undefined) {\n      const indexSignature: ts.IndexSignatureDeclaration =\n        astDeclaration.declaration as ts.IndexSignatureDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: indexSignature.type, tokenRange: returnTypeTokenRange });\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        indexSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiIndexSignature = new ApiIndexSignature({\n        docComment,\n        releaseTag,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiIndexSignature);\n    }\n  }\n\n  private _processApiInterface(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiInterface.getContainerKey(name);\n\n    let apiInterface: ApiInterface | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiInterface;\n\n    if (apiInterface === undefined) {\n      const interfaceDeclaration: ts.InterfaceDeclaration =\n        astDeclaration.declaration as ts.InterfaceDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        interfaceDeclaration.typeParameters\n      );\n\n      const extendsTokenRanges: IExcerptTokenRange[] = [];\n\n      for (const heritageClause of interfaceDeclaration.heritageClauses || []) {\n        if (heritageClause.token === ts.SyntaxKind.ExtendsKeyword) {\n          for (const heritageType of heritageClause.types) {\n            const extendsTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n            extendsTokenRanges.push(extendsTokenRange);\n            nodesToCapture.push({ node: heritageType, tokenRange: extendsTokenRange });\n          }\n        }\n      }\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiInterface = new ApiInterface({\n        name,\n        docComment,\n        releaseTag,\n        excerptTokens,\n        typeParameters,\n        extendsTokenRanges\n      });\n\n      parentApiItem.addMember(apiInterface);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiInterface);\n  }\n\n  private _processApiMethod(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const isStatic: boolean = (astDeclaration.modifierFlags & ts.ModifierFlags.Static) !== 0;\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiMethod.getContainerKey(name, isStatic, overloadIndex);\n\n    let apiMethod: ApiMethod | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiMethod;\n\n    if (apiMethod === undefined) {\n      const methodDeclaration: ts.MethodDeclaration = astDeclaration.declaration as ts.MethodDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: methodDeclaration.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        methodDeclaration.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        methodDeclaration.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      if (releaseTag === ReleaseTag.Internal || releaseTag === ReleaseTag.Alpha) {\n        return; // trim out items marked as \"@internal\" or \"@alpha\"\n      }\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiMethod = new ApiMethod({\n        name,\n        docComment,\n        releaseTag,\n        isStatic,\n        isOptional,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiMethod);\n    }\n  }\n\n  private _processApiMethodSignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const overloadIndex: number = this._collector.getOverloadIndex(astDeclaration);\n    const containerKey: string = ApiMethodSignature.getContainerKey(name, overloadIndex);\n\n    let apiMethodSignature: ApiMethodSignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiMethodSignature;\n\n    if (apiMethodSignature === undefined) {\n      const methodSignature: ts.MethodSignature = astDeclaration.declaration as ts.MethodSignature;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const returnTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: methodSignature.type, tokenRange: returnTypeTokenRange });\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        methodSignature.typeParameters\n      );\n\n      const parameters: IApiParameterOptions[] = this._captureParameters(\n        nodesToCapture,\n        methodSignature.parameters\n      );\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiMethodSignature = new ApiMethodSignature({\n        name,\n        docComment,\n        releaseTag,\n        isOptional,\n        typeParameters,\n        parameters,\n        overloadIndex,\n        excerptTokens,\n        returnTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiMethodSignature);\n    }\n  }\n\n  private _processApiNamespace(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiNamespace.getContainerKey(name);\n\n    let apiNamespace: ApiNamespace | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiNamespace;\n\n    if (apiNamespace === undefined) {\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, []);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiNamespace = new ApiNamespace({ name, docComment, releaseTag, excerptTokens });\n      parentApiItem.addMember(apiNamespace);\n    }\n\n    this._processChildDeclarations(astDeclaration, exportedName, apiNamespace);\n  }\n\n  private _processApiProperty(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const isStatic: boolean = (astDeclaration.modifierFlags & ts.ModifierFlags.Static) !== 0;\n\n    const containerKey: string = ApiProperty.getContainerKey(name, isStatic);\n\n    let apiProperty: ApiProperty | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiProperty;\n\n    if (apiProperty === undefined) {\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const propertyTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      let propertyTypeNode: ts.TypeNode | undefined;\n\n      if (\n        ts.isPropertyDeclaration(astDeclaration.declaration) ||\n        ts.isGetAccessorDeclaration(astDeclaration.declaration)\n      ) {\n        propertyTypeNode = astDeclaration.declaration.type;\n      }\n\n      if (ts.isSetAccessorDeclaration(astDeclaration.declaration)) {\n        // Note that TypeScript always reports an error if a setter does not have exactly one parameter.\n        propertyTypeNode = astDeclaration.declaration.parameters[0].type;\n      }\n\n      nodesToCapture.push({ node: propertyTypeNode, tokenRange: propertyTypeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiProperty = new ApiProperty({\n        name,\n        docComment,\n        releaseTag,\n        isStatic,\n        isOptional,\n        excerptTokens,\n        propertyTypeTokenRange\n      });\n      parentApiItem.addMember(apiProperty);\n    } else {\n      // If the property was already declared before (via a merged interface declaration),\n      // we assume its signature is identical, because the language requires that.\n    }\n  }\n\n  private _processApiPropertySignature(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n    const containerKey: string = ApiPropertySignature.getContainerKey(name);\n\n    let apiPropertySignature: ApiPropertySignature | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiPropertySignature;\n\n    if (apiPropertySignature === undefined) {\n      const propertySignature: ts.PropertySignature = astDeclaration.declaration as ts.PropertySignature;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const propertyTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: propertySignature.type, tokenRange: propertyTypeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n      const isOptional: boolean =\n        (astDeclaration.astSymbol.followedSymbol.flags & ts.SymbolFlags.Optional) !== 0;\n\n      apiPropertySignature = new ApiPropertySignature({\n        name,\n        docComment,\n        releaseTag,\n        isOptional,\n        excerptTokens,\n        propertyTypeTokenRange\n      });\n\n      parentApiItem.addMember(apiPropertySignature);\n    } else {\n      // If the property was already declared before (via a merged interface declaration),\n      // we assume its signature is identical, because the language requires that.\n    }\n  }\n\n  private _processApiTypeAlias(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const containerKey: string = ApiTypeAlias.getContainerKey(name);\n\n    let apiTypeAlias: ApiTypeAlias | undefined = parentApiItem.tryGetMemberByKey(\n      containerKey\n    ) as ApiTypeAlias;\n\n    if (apiTypeAlias === undefined) {\n      const typeAliasDeclaration: ts.TypeAliasDeclaration =\n        astDeclaration.declaration as ts.TypeAliasDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const typeParameters: IApiTypeParameterOptions[] = this._captureTypeParameters(\n        nodesToCapture,\n        typeAliasDeclaration.typeParameters\n      );\n\n      const typeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: typeAliasDeclaration.type, tokenRange: typeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiTypeAlias = new ApiTypeAlias({\n        name,\n        docComment,\n        typeParameters,\n        releaseTag,\n        excerptTokens,\n        typeTokenRange\n      });\n\n      parentApiItem.addMember(apiTypeAlias);\n    }\n  }\n\n  private _processApiVariable(\n    astDeclaration: AstDeclaration,\n    exportedName: string | undefined,\n    parentApiItem: ApiItemContainerMixin\n  ): void {\n    const name: string = exportedName ? exportedName : astDeclaration.astSymbol.localName;\n\n    const containerKey: string = ApiVariable.getContainerKey(name);\n\n    let apiVariable: ApiVariable | undefined = parentApiItem.tryGetMemberByKey(containerKey) as ApiVariable;\n\n    if (apiVariable === undefined) {\n      const variableDeclaration: ts.VariableDeclaration =\n        astDeclaration.declaration as ts.VariableDeclaration;\n\n      const nodesToCapture: IExcerptBuilderNodeToCapture[] = [];\n\n      const variableTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: variableDeclaration.type, tokenRange: variableTypeTokenRange });\n\n      const excerptTokens: IExcerptToken[] = this._buildExcerptTokens(astDeclaration, nodesToCapture);\n      const apiItemMetadata: ApiItemMetadata = this._collector.fetchApiItemMetadata(astDeclaration);\n      const docComment: tsdoc.DocComment | undefined = apiItemMetadata.tsdocComment;\n      const releaseTag: ReleaseTag = apiItemMetadata.effectiveReleaseTag;\n\n      apiVariable = new ApiVariable({ name, docComment, releaseTag, excerptTokens, variableTypeTokenRange });\n\n      parentApiItem.addMember(apiVariable);\n    }\n  }\n\n  /**\n   * @param nodesToCapture - A list of child nodes whose token ranges we want to capture\n   */\n  private _buildExcerptTokens(\n    astDeclaration: AstDeclaration,\n    nodesToCapture: IExcerptBuilderNodeToCapture[]\n  ): IExcerptToken[] {\n    const excerptTokens: IExcerptToken[] = [];\n\n    // Build the main declaration\n    ExcerptBuilder.addDeclaration(excerptTokens, astDeclaration, nodesToCapture, this._referenceGenerator);\n\n    const declarationMetadata: DeclarationMetadata = this._collector.fetchDeclarationMetadata(astDeclaration);\n\n    // Add any ancillary declarations\n    for (const ancillaryDeclaration of declarationMetadata.ancillaryDeclarations) {\n      ExcerptBuilder.addBlankLine(excerptTokens);\n      ExcerptBuilder.addDeclaration(\n        excerptTokens,\n        ancillaryDeclaration,\n        nodesToCapture,\n        this._referenceGenerator\n      );\n    }\n\n    return excerptTokens;\n  }\n\n  private _captureTypeParameters(\n    nodesToCapture: IExcerptBuilderNodeToCapture[],\n    typeParameterNodes: ts.NodeArray<ts.TypeParameterDeclaration> | undefined\n  ): IApiTypeParameterOptions[] {\n    const typeParameters: IApiTypeParameterOptions[] = [];\n    if (typeParameterNodes) {\n      for (const typeParameter of typeParameterNodes) {\n        const constraintTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n        nodesToCapture.push({ node: typeParameter.constraint, tokenRange: constraintTokenRange });\n\n        const defaultTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n        nodesToCapture.push({ node: typeParameter.default, tokenRange: defaultTypeTokenRange });\n\n        typeParameters.push({\n          typeParameterName: typeParameter.name.getText().trim(),\n          constraintTokenRange,\n          defaultTypeTokenRange\n        });\n      }\n    }\n    return typeParameters;\n  }\n\n  private _captureParameters(\n    nodesToCapture: IExcerptBuilderNodeToCapture[],\n    parameterNodes: ts.NodeArray<ts.ParameterDeclaration>\n  ): IApiParameterOptions[] {\n    const parameters: IApiParameterOptions[] = [];\n    for (const parameter of parameterNodes) {\n      const parameterTypeTokenRange: IExcerptTokenRange = ExcerptBuilder.createEmptyTokenRange();\n      nodesToCapture.push({ node: parameter.type, tokenRange: parameterTypeTokenRange });\n      parameters.push({\n        parameterName: parameter.name.getText().trim(),\n        parameterTypeTokenRange,\n        isOptional: this._collector.typeChecker.isOptionalParameter(parameter)\n      });\n    }\n    return parameters;\n  }\n}\n"]}

package/lib/generators/ExcerptBuilder.js

@@ -135,10 +135,10 @@ class ExcerptBuilder {
         if (capturedTokenRange) {
             capturedTokenRange.startIndex = excerptStartIndex;
             // We will assign capturedTokenRange.startIndex to be the index after the last token
-            // that was appended so far. However, if the last appended token was a separator,
-            // then omit it from the range.
+            // that was appended so far. However, if the last appended token was a separator and
+            // there is no additional spaces, omit it from the range.
             let excerptEndIndex = excerptTokens.length;
-            if (state.lastAppendedTokenIsSeparator) {
+            if (state.lastAppendedTokenIsSeparator && excerptEndIndex > excerptStartIndex + 1) {
                 excerptEndIndex--;
             }
             capturedTokenRange.endIndex = excerptEndIndex;

package/lib/generators/ExcerptBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExcerptBuilder.js","sourceRoot":"","sources":["../../src/generators/ExcerptBuilder.ts"],"names":[],"mappings":"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","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 ts from 'typescript';\nimport { DeclarationReference } from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\nimport { ExcerptTokenKind, IExcerptToken, IExcerptTokenRange } from '@microsoft/api-extractor-model';\n\nimport { Span } from '../analyzer/Span';\nimport { DeclarationReferenceGenerator } from './DeclarationReferenceGenerator';\nimport { AstDeclaration } from '../analyzer/AstDeclaration';\n\n/**\n * Used to provide ExcerptBuilder with a list of nodes whose token range we want to capture.\n */\nexport interface IExcerptBuilderNodeToCapture {\n  /**\n   * The node to capture\n   */\n  node: ts.Node | undefined;\n  /**\n   * The token range whose startIndex/endIndex will be overwritten with the indexes for the\n   * tokens corresponding to IExcerptBuilderNodeToCapture.node\n   */\n  tokenRange: IExcerptTokenRange;\n}\n\n/**\n * Internal state for ExcerptBuilder\n */\ninterface IBuildSpanState {\n  referenceGenerator: DeclarationReferenceGenerator;\n\n  /**\n   * The AST node that we will traverse to extract tokens\n   */\n  startingNode: ts.Node;\n\n  /**\n   * Normally, the excerpt will include all child nodes for `startingNode`; whereas if `childKindToStopBefore`\n   * is specified, then the node traversal will stop before (i.e. excluding) the first immediate child\n   * of `startingNode` with the specified syntax kind.\n   *\n   * @remarks\n   * For example, suppose the signature is `interface X: Y { z: string }`.  The token `{` has syntax kind\n   * `ts.SyntaxKind.FirstPunctuation`, so we can specify that to truncate the excerpt to `interface X: Y`.\n   */\n  stopBeforeChildKind: ts.SyntaxKind | undefined;\n\n  tokenRangesByNode: Map<ts.Node, IExcerptTokenRange>;\n\n  /**\n   * Normally adjacent tokens of the same kind get merged, to avoid creating lots of unnecessary extra tokens.\n   * However when an captured excerpt needs to start/end at a specific character, we temporarily disable merging by\n   * setting this flag.  After the new token is added, this flag is cleared.\n   */\n  disableMergingForNextToken: boolean;\n\n  /**\n   * Tracks whether the last appended token was a separator. If so, and we're in the middle of\n   * capturing a token range, then omit the separator from the range.\n   */\n  lastAppendedTokenIsSeparator: boolean;\n}\n\nexport class ExcerptBuilder {\n  /**\n   * Appends a blank line to the `excerptTokens` list.\n   * @param excerptTokens - The target token list to append to\n   */\n  public static addBlankLine(excerptTokens: IExcerptToken[]): void {\n    let newlines: string = '\\n\\n';\n    // If the existing text already ended with a newline, then only append one newline\n    if (excerptTokens.length > 0) {\n      const previousText: string = excerptTokens[excerptTokens.length - 1].text;\n      if (/\\n$/.test(previousText)) {\n        newlines = '\\n';\n      }\n    }\n    excerptTokens.push({ kind: ExcerptTokenKind.Content, text: newlines });\n  }\n\n  /**\n   * Appends the signature for the specified `AstDeclaration` to the `excerptTokens` list.\n   * @param excerptTokens - The target token list to append to\n   * @param nodesToCapture - A list of child nodes whose token ranges we want to capture\n   */\n  public static addDeclaration(\n    excerptTokens: IExcerptToken[],\n    astDeclaration: AstDeclaration,\n    nodesToCapture: IExcerptBuilderNodeToCapture[],\n    referenceGenerator: DeclarationReferenceGenerator\n  ): void {\n    let stopBeforeChildKind: ts.SyntaxKind | undefined = undefined;\n\n    switch (astDeclaration.declaration.kind) {\n      case ts.SyntaxKind.ClassDeclaration:\n      case ts.SyntaxKind.EnumDeclaration:\n      case ts.SyntaxKind.InterfaceDeclaration:\n        // FirstPunctuation = \"{\"\n        stopBeforeChildKind = ts.SyntaxKind.FirstPunctuation;\n        break;\n      case ts.SyntaxKind.ModuleDeclaration:\n        // ModuleBlock = the \"{ ... }\" block\n        stopBeforeChildKind = ts.SyntaxKind.ModuleBlock;\n        break;\n    }\n\n    const span: Span = new Span(astDeclaration.declaration);\n\n    const tokenRangesByNode: Map<ts.Node, IExcerptTokenRange> = new Map<ts.Node, IExcerptTokenRange>();\n    for (const excerpt of nodesToCapture || []) {\n      if (excerpt.node) {\n        tokenRangesByNode.set(excerpt.node, excerpt.tokenRange);\n      }\n    }\n\n    ExcerptBuilder._buildSpan(excerptTokens, span, {\n      referenceGenerator: referenceGenerator,\n      startingNode: span.node,\n      stopBeforeChildKind,\n      tokenRangesByNode,\n      disableMergingForNextToken: false,\n      lastAppendedTokenIsSeparator: false\n    });\n  }\n\n  public static createEmptyTokenRange(): IExcerptTokenRange {\n    return { startIndex: 0, endIndex: 0 };\n  }\n\n  private static _buildSpan(excerptTokens: IExcerptToken[], span: Span, state: IBuildSpanState): boolean {\n    if (span.kind === ts.SyntaxKind.JSDocComment) {\n      // Discard any comments\n      return true;\n    }\n\n    // Can this node start a excerpt?\n    const capturedTokenRange: IExcerptTokenRange | undefined = state.tokenRangesByNode.get(span.node);\n    let excerptStartIndex: number = 0;\n\n    if (capturedTokenRange) {\n      // We will assign capturedTokenRange.startIndex to be the index of the next token to be appended\n      excerptStartIndex = excerptTokens.length;\n      state.disableMergingForNextToken = true;\n    }\n\n    if (span.prefix) {\n      let canonicalReference: DeclarationReference | undefined = undefined;\n\n      if (span.kind === ts.SyntaxKind.Identifier) {\n        const name: ts.Identifier = span.node as ts.Identifier;\n        if (!ExcerptBuilder._isDeclarationName(name)) {\n          canonicalReference = state.referenceGenerator.getDeclarationReferenceForIdentifier(name);\n        }\n      }\n\n      if (canonicalReference) {\n        ExcerptBuilder._appendToken(\n          excerptTokens,\n          ExcerptTokenKind.Reference,\n          span.prefix,\n          state,\n          canonicalReference\n        );\n      } else {\n        ExcerptBuilder._appendToken(excerptTokens, ExcerptTokenKind.Content, span.prefix, state);\n      }\n      state.lastAppendedTokenIsSeparator = false;\n    }\n\n    for (const child of span.children) {\n      if (span.node === state.startingNode) {\n        if (state.stopBeforeChildKind && child.kind === state.stopBeforeChildKind) {\n          // We reached a child whose kind is stopBeforeChildKind, so stop traversing\n          return false;\n        }\n      }\n\n      if (!this._buildSpan(excerptTokens, child, state)) {\n        return false;\n      }\n    }\n\n    if (span.suffix) {\n      ExcerptBuilder._appendToken(excerptTokens, ExcerptTokenKind.Content, span.suffix, state);\n      state.lastAppendedTokenIsSeparator = false;\n    }\n    if (span.separator) {\n      ExcerptBuilder._appendToken(excerptTokens, ExcerptTokenKind.Content, span.separator, state);\n      state.lastAppendedTokenIsSeparator = true;\n    }\n\n    // Are we building a excerpt?  If so, set its range\n    if (capturedTokenRange) {\n      capturedTokenRange.startIndex = excerptStartIndex;\n\n      // We will assign capturedTokenRange.startIndex to be the index after the last token\n      // that was appended so far. However, if the last appended token was a separator,\n      // then omit it from the range.\n      let excerptEndIndex: number = excerptTokens.length;\n      if (state.lastAppendedTokenIsSeparator) {\n        excerptEndIndex--;\n      }\n\n      capturedTokenRange.endIndex = excerptEndIndex;\n\n      state.disableMergingForNextToken = true;\n    }\n\n    return true;\n  }\n\n  private static _appendToken(\n    excerptTokens: IExcerptToken[],\n    excerptTokenKind: ExcerptTokenKind,\n    text: string,\n    state: IBuildSpanState,\n    canonicalReference?: DeclarationReference\n  ): void {\n    if (text.length === 0) {\n      return;\n    }\n\n    if (excerptTokenKind !== ExcerptTokenKind.Content) {\n      if (\n        excerptTokenKind === ExcerptTokenKind.Reference &&\n        excerptTokens.length > 1 &&\n        !state.disableMergingForNextToken\n      ) {\n        // If the previous two tokens were a Reference and a '.', then concatenate\n        // all three tokens as a qualified name Reference.\n        const previousTokenM1: IExcerptToken = excerptTokens[excerptTokens.length - 1];\n        const previousTokenM2: IExcerptToken = excerptTokens[excerptTokens.length - 2];\n        if (\n          previousTokenM1.kind === ExcerptTokenKind.Content &&\n          previousTokenM1.text.trim() === '.' &&\n          previousTokenM2.kind === ExcerptTokenKind.Reference\n        ) {\n          previousTokenM2.text += '.' + text;\n          if (canonicalReference !== undefined) {\n            previousTokenM2.canonicalReference = canonicalReference.toString();\n          }\n          excerptTokens.pop(); // remove previousTokenM1;\n          return;\n        }\n      }\n    } else {\n      // If someone referenced this index, then we need to start a new token\n      if (excerptTokens.length > 0 && !state.disableMergingForNextToken) {\n        // Otherwise, can we merge with the previous token?\n        const previousToken: IExcerptToken = excerptTokens[excerptTokens.length - 1];\n        if (previousToken.kind === excerptTokenKind) {\n          previousToken.text += text;\n          return;\n        }\n      }\n    }\n\n    const excerptToken: IExcerptToken = { kind: excerptTokenKind, text: text };\n    if (canonicalReference !== undefined) {\n      excerptToken.canonicalReference = canonicalReference.toString();\n    }\n    excerptTokens.push(excerptToken);\n    state.disableMergingForNextToken = false;\n  }\n\n  private static _isDeclarationName(name: ts.Identifier): boolean {\n    return ExcerptBuilder._isDeclaration(name.parent) && name.parent.name === name;\n  }\n\n  private static _isDeclaration(node: ts.Node): node is ts.NamedDeclaration {\n    switch (node.kind) {\n      case ts.SyntaxKind.FunctionDeclaration:\n      case ts.SyntaxKind.FunctionExpression:\n      case ts.SyntaxKind.VariableDeclaration:\n      case ts.SyntaxKind.Parameter:\n      case ts.SyntaxKind.EnumDeclaration:\n      case ts.SyntaxKind.ClassDeclaration:\n      case ts.SyntaxKind.ClassExpression:\n      case ts.SyntaxKind.ModuleDeclaration:\n      case ts.SyntaxKind.MethodDeclaration:\n      case ts.SyntaxKind.MethodSignature:\n      case ts.SyntaxKind.PropertyDeclaration:\n      case ts.SyntaxKind.PropertySignature:\n      case ts.SyntaxKind.GetAccessor:\n      case ts.SyntaxKind.SetAccessor:\n      case ts.SyntaxKind.InterfaceDeclaration:\n      case ts.SyntaxKind.TypeAliasDeclaration:\n      case ts.SyntaxKind.TypeParameter:\n      case ts.SyntaxKind.EnumMember:\n      case ts.SyntaxKind.BindingElement:\n        return true;\n      default:\n        return false;\n    }\n  }\n}\n"]}
+{"version":3,"file":"ExcerptBuilder.js","sourceRoot":"","sources":["../../src/generators/ExcerptBuilder.ts"],"names":[],"mappings":"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","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 ts from 'typescript';\nimport { DeclarationReference } from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\nimport { ExcerptTokenKind, IExcerptToken, IExcerptTokenRange } from '@microsoft/api-extractor-model';\n\nimport { Span } from '../analyzer/Span';\nimport { DeclarationReferenceGenerator } from './DeclarationReferenceGenerator';\nimport { AstDeclaration } from '../analyzer/AstDeclaration';\n\n/**\n * Used to provide ExcerptBuilder with a list of nodes whose token range we want to capture.\n */\nexport interface IExcerptBuilderNodeToCapture {\n  /**\n   * The node to capture\n   */\n  node: ts.Node | undefined;\n  /**\n   * The token range whose startIndex/endIndex will be overwritten with the indexes for the\n   * tokens corresponding to IExcerptBuilderNodeToCapture.node\n   */\n  tokenRange: IExcerptTokenRange;\n}\n\n/**\n * Internal state for ExcerptBuilder\n */\ninterface IBuildSpanState {\n  referenceGenerator: DeclarationReferenceGenerator;\n\n  /**\n   * The AST node that we will traverse to extract tokens\n   */\n  startingNode: ts.Node;\n\n  /**\n   * Normally, the excerpt will include all child nodes for `startingNode`; whereas if `childKindToStopBefore`\n   * is specified, then the node traversal will stop before (i.e. excluding) the first immediate child\n   * of `startingNode` with the specified syntax kind.\n   *\n   * @remarks\n   * For example, suppose the signature is `interface X: Y { z: string }`.  The token `{` has syntax kind\n   * `ts.SyntaxKind.FirstPunctuation`, so we can specify that to truncate the excerpt to `interface X: Y`.\n   */\n  stopBeforeChildKind: ts.SyntaxKind | undefined;\n\n  tokenRangesByNode: Map<ts.Node, IExcerptTokenRange>;\n\n  /**\n   * Normally adjacent tokens of the same kind get merged, to avoid creating lots of unnecessary extra tokens.\n   * However when an captured excerpt needs to start/end at a specific character, we temporarily disable merging by\n   * setting this flag.  After the new token is added, this flag is cleared.\n   */\n  disableMergingForNextToken: boolean;\n\n  /**\n   * Tracks whether the last appended token was a separator. If so, and we're in the middle of\n   * capturing a token range, then omit the separator from the range.\n   */\n  lastAppendedTokenIsSeparator: boolean;\n}\n\nexport class ExcerptBuilder {\n  /**\n   * Appends a blank line to the `excerptTokens` list.\n   * @param excerptTokens - The target token list to append to\n   */\n  public static addBlankLine(excerptTokens: IExcerptToken[]): void {\n    let newlines: string = '\\n\\n';\n    // If the existing text already ended with a newline, then only append one newline\n    if (excerptTokens.length > 0) {\n      const previousText: string = excerptTokens[excerptTokens.length - 1].text;\n      if (/\\n$/.test(previousText)) {\n        newlines = '\\n';\n      }\n    }\n    excerptTokens.push({ kind: ExcerptTokenKind.Content, text: newlines });\n  }\n\n  /**\n   * Appends the signature for the specified `AstDeclaration` to the `excerptTokens` list.\n   * @param excerptTokens - The target token list to append to\n   * @param nodesToCapture - A list of child nodes whose token ranges we want to capture\n   */\n  public static addDeclaration(\n    excerptTokens: IExcerptToken[],\n    astDeclaration: AstDeclaration,\n    nodesToCapture: IExcerptBuilderNodeToCapture[],\n    referenceGenerator: DeclarationReferenceGenerator\n  ): void {\n    let stopBeforeChildKind: ts.SyntaxKind | undefined = undefined;\n\n    switch (astDeclaration.declaration.kind) {\n      case ts.SyntaxKind.ClassDeclaration:\n      case ts.SyntaxKind.EnumDeclaration:\n      case ts.SyntaxKind.InterfaceDeclaration:\n        // FirstPunctuation = \"{\"\n        stopBeforeChildKind = ts.SyntaxKind.FirstPunctuation;\n        break;\n      case ts.SyntaxKind.ModuleDeclaration:\n        // ModuleBlock = the \"{ ... }\" block\n        stopBeforeChildKind = ts.SyntaxKind.ModuleBlock;\n        break;\n    }\n\n    const span: Span = new Span(astDeclaration.declaration);\n\n    const tokenRangesByNode: Map<ts.Node, IExcerptTokenRange> = new Map<ts.Node, IExcerptTokenRange>();\n    for (const excerpt of nodesToCapture || []) {\n      if (excerpt.node) {\n        tokenRangesByNode.set(excerpt.node, excerpt.tokenRange);\n      }\n    }\n\n    ExcerptBuilder._buildSpan(excerptTokens, span, {\n      referenceGenerator: referenceGenerator,\n      startingNode: span.node,\n      stopBeforeChildKind,\n      tokenRangesByNode,\n      disableMergingForNextToken: false,\n      lastAppendedTokenIsSeparator: false\n    });\n  }\n\n  public static createEmptyTokenRange(): IExcerptTokenRange {\n    return { startIndex: 0, endIndex: 0 };\n  }\n\n  private static _buildSpan(excerptTokens: IExcerptToken[], span: Span, state: IBuildSpanState): boolean {\n    if (span.kind === ts.SyntaxKind.JSDocComment) {\n      // Discard any comments\n      return true;\n    }\n\n    // Can this node start a excerpt?\n    const capturedTokenRange: IExcerptTokenRange | undefined = state.tokenRangesByNode.get(span.node);\n    let excerptStartIndex: number = 0;\n\n    if (capturedTokenRange) {\n      // We will assign capturedTokenRange.startIndex to be the index of the next token to be appended\n      excerptStartIndex = excerptTokens.length;\n      state.disableMergingForNextToken = true;\n    }\n\n    if (span.prefix) {\n      let canonicalReference: DeclarationReference | undefined = undefined;\n\n      if (span.kind === ts.SyntaxKind.Identifier) {\n        const name: ts.Identifier = span.node as ts.Identifier;\n        if (!ExcerptBuilder._isDeclarationName(name)) {\n          canonicalReference = state.referenceGenerator.getDeclarationReferenceForIdentifier(name);\n        }\n      }\n\n      if (canonicalReference) {\n        ExcerptBuilder._appendToken(\n          excerptTokens,\n          ExcerptTokenKind.Reference,\n          span.prefix,\n          state,\n          canonicalReference\n        );\n      } else {\n        ExcerptBuilder._appendToken(excerptTokens, ExcerptTokenKind.Content, span.prefix, state);\n      }\n      state.lastAppendedTokenIsSeparator = false;\n    }\n\n    for (const child of span.children) {\n      if (span.node === state.startingNode) {\n        if (state.stopBeforeChildKind && child.kind === state.stopBeforeChildKind) {\n          // We reached a child whose kind is stopBeforeChildKind, so stop traversing\n          return false;\n        }\n      }\n\n      if (!this._buildSpan(excerptTokens, child, state)) {\n        return false;\n      }\n    }\n\n    if (span.suffix) {\n      ExcerptBuilder._appendToken(excerptTokens, ExcerptTokenKind.Content, span.suffix, state);\n      state.lastAppendedTokenIsSeparator = false;\n    }\n    if (span.separator) {\n      ExcerptBuilder._appendToken(excerptTokens, ExcerptTokenKind.Content, span.separator, state);\n      state.lastAppendedTokenIsSeparator = true;\n    }\n\n    // Are we building a excerpt?  If so, set its range\n    if (capturedTokenRange) {\n      capturedTokenRange.startIndex = excerptStartIndex;\n\n      // We will assign capturedTokenRange.startIndex to be the index after the last token\n      // that was appended so far. However, if the last appended token was a separator and\n      // there is no additional spaces, omit it from the range.\n      let excerptEndIndex: number = excerptTokens.length;\n      if (state.lastAppendedTokenIsSeparator && excerptEndIndex > excerptStartIndex + 1) {\n        excerptEndIndex--;\n      }\n\n      capturedTokenRange.endIndex = excerptEndIndex;\n\n      state.disableMergingForNextToken = true;\n    }\n\n    return true;\n  }\n\n  private static _appendToken(\n    excerptTokens: IExcerptToken[],\n    excerptTokenKind: ExcerptTokenKind,\n    text: string,\n    state: IBuildSpanState,\n    canonicalReference?: DeclarationReference\n  ): void {\n    if (text.length === 0) {\n      return;\n    }\n\n    if (excerptTokenKind !== ExcerptTokenKind.Content) {\n      if (\n        excerptTokenKind === ExcerptTokenKind.Reference &&\n        excerptTokens.length > 1 &&\n        !state.disableMergingForNextToken\n      ) {\n        // If the previous two tokens were a Reference and a '.', then concatenate\n        // all three tokens as a qualified name Reference.\n        const previousTokenM1: IExcerptToken = excerptTokens[excerptTokens.length - 1];\n        const previousTokenM2: IExcerptToken = excerptTokens[excerptTokens.length - 2];\n        if (\n          previousTokenM1.kind === ExcerptTokenKind.Content &&\n          previousTokenM1.text.trim() === '.' &&\n          previousTokenM2.kind === ExcerptTokenKind.Reference\n        ) {\n          previousTokenM2.text += '.' + text;\n          if (canonicalReference !== undefined) {\n            previousTokenM2.canonicalReference = canonicalReference.toString();\n          }\n          excerptTokens.pop(); // remove previousTokenM1;\n          return;\n        }\n      }\n    } else {\n      // If someone referenced this index, then we need to start a new token\n      if (excerptTokens.length > 0 && !state.disableMergingForNextToken) {\n        // Otherwise, can we merge with the previous token?\n        const previousToken: IExcerptToken = excerptTokens[excerptTokens.length - 1];\n        if (previousToken.kind === excerptTokenKind) {\n          previousToken.text += text;\n          return;\n        }\n      }\n    }\n\n    const excerptToken: IExcerptToken = { kind: excerptTokenKind, text: text };\n    if (canonicalReference !== undefined) {\n      excerptToken.canonicalReference = canonicalReference.toString();\n    }\n    excerptTokens.push(excerptToken);\n    state.disableMergingForNextToken = false;\n  }\n\n  private static _isDeclarationName(name: ts.Identifier): boolean {\n    return ExcerptBuilder._isDeclaration(name.parent) && name.parent.name === name;\n  }\n\n  private static _isDeclaration(node: ts.Node): node is ts.NamedDeclaration {\n    switch (node.kind) {\n      case ts.SyntaxKind.FunctionDeclaration:\n      case ts.SyntaxKind.FunctionExpression:\n      case ts.SyntaxKind.VariableDeclaration:\n      case ts.SyntaxKind.Parameter:\n      case ts.SyntaxKind.EnumDeclaration:\n      case ts.SyntaxKind.ClassDeclaration:\n      case ts.SyntaxKind.ClassExpression:\n      case ts.SyntaxKind.ModuleDeclaration:\n      case ts.SyntaxKind.MethodDeclaration:\n      case ts.SyntaxKind.MethodSignature:\n      case ts.SyntaxKind.PropertyDeclaration:\n      case ts.SyntaxKind.PropertySignature:\n      case ts.SyntaxKind.GetAccessor:\n      case ts.SyntaxKind.SetAccessor:\n      case ts.SyntaxKind.InterfaceDeclaration:\n      case ts.SyntaxKind.TypeAliasDeclaration:\n      case ts.SyntaxKind.TypeParameter:\n      case ts.SyntaxKind.EnumMember:\n      case ts.SyntaxKind.BindingElement:\n        return true;\n      default:\n        return false;\n    }\n  }\n}\n"]}

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

@@ -72,6 +72,9 @@
       "ae-unresolved-inheritdoc-base": {
         "logLevel": "warning",
         "addToApiReportFile": true
+      },
+      "ae-wrong-input-file-type": {
+        "logLevel": "error"
       }
     },
     "tsdocMessageReporting": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/api-extractor",
-  "version": "7.23.1",
+  "version": "7.24.1",
   "description": "Analyze the exported API for a TypeScript library and generate reviews, documentation, and .d.ts rollups",
   "keywords": [
     "typescript",
@@ -32,12 +32,12 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@microsoft/api-extractor-model": "7.17.2",
+    "@microsoft/api-extractor-model": "7.17.3",
     "@microsoft/tsdoc": "0.14.1",
     "@microsoft/tsdoc-config": "~0.16.1",
-    "@rushstack/node-core-library": "3.45.4",
+    "@rushstack/node-core-library": "3.45.5",
     "@rushstack/rig-package": "0.3.11",
-    "@rushstack/ts-command-line": "4.10.10",
+    "@rushstack/ts-command-line": "4.11.0",
     "colors": "~1.2.1",
     "lodash": "~4.17.15",
     "resolve": "~1.17.0",
@@ -47,8 +47,8 @@
   },
   "devDependencies": {
     "@rushstack/eslint-config": "2.6.0",
-    "@rushstack/heft": "0.45.0",
-    "@rushstack/heft-node-rig": "1.9.0",
+    "@rushstack/heft": "0.45.1",
+    "@rushstack/heft-node-rig": "1.9.2",
     "@types/heft-jest": "1.0.1",
     "@types/lodash": "4.14.116",
     "@types/node": "12.20.24",