@microsoft/api-extractor-model 7.13.18 → 7.15.2

package/lib/model/ApiPackage.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiPackage.js","sourceRoot":"","sources":["../../src/model/ApiPackage.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport { DeclarationReference } from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItem, ApiItemKind, IApiItemJson } from '../items/ApiItem';\r\nimport { ApiItemContainerMixin, IApiItemContainerMixinOptions } from '../mixins/ApiItemContainerMixin';\r\nimport {\r\n  JsonFile,\r\n  IJsonFileSaveOptions,\r\n  PackageJsonLookup,\r\n  IPackageJson,\r\n  JsonObject\r\n} from '@rushstack/node-core-library';\r\nimport { ApiDocumentedItem, IApiDocumentedItemOptions } from '../items/ApiDocumentedItem';\r\nimport { ApiEntryPoint } from './ApiEntryPoint';\r\nimport { IApiNameMixinOptions, ApiNameMixin } from '../mixins/ApiNameMixin';\r\nimport { DeserializerContext, ApiJsonSchemaVersion } from './DeserializerContext';\r\nimport { TSDocConfiguration } from '@microsoft/tsdoc';\r\nimport { TSDocConfigFile } from '@microsoft/tsdoc-config';\r\n\r\n/**\r\n * Constructor options for {@link ApiPackage}.\r\n * @public\r\n */\r\nexport interface IApiPackageOptions\r\n  extends IApiItemContainerMixinOptions,\r\n    IApiNameMixinOptions,\r\n    IApiDocumentedItemOptions {\r\n  tsdocConfiguration: TSDocConfiguration;\r\n}\r\n\r\nexport interface IApiPackageMetadataJson {\r\n  /**\r\n   * The NPM package name for the tool that wrote the *.api.json file.\r\n   * For informational purposes only.\r\n   */\r\n  toolPackage: string;\r\n\r\n  /**\r\n   * The NPM package version for the tool that wrote the *.api.json file.\r\n   * For informational purposes only.\r\n   */\r\n  toolVersion: string;\r\n\r\n  /**\r\n   * The schema version for the .api.json file format.  Used for determining whether the file format is\r\n   * supported, and for backwards compatibility.\r\n   */\r\n  schemaVersion: ApiJsonSchemaVersion;\r\n\r\n  /**\r\n   * To support forwards compatibility, the `oldestForwardsCompatibleVersion` field tracks the oldest schema version\r\n   * whose corresponding deserializer could safely load this file.\r\n   *\r\n   * @remarks\r\n   * Normally api-extractor-model should refuse to load a schema version that is newer than the latest version\r\n   * that its deserializer understands.  However, sometimes a schema change may merely introduce some new fields\r\n   * without modifying or removing any existing fields.  In this case, an older api-extractor-model library can\r\n   * safely deserialize the newer version (by ignoring the extra fields that it doesn't recognize).  The newer\r\n   * serializer can use this field to communicate that.\r\n   *\r\n   * If present, the `oldestForwardsCompatibleVersion` must be less than or equal to\r\n   * `IApiPackageMetadataJson.schemaVersion`.\r\n   */\r\n  oldestForwardsCompatibleVersion?: ApiJsonSchemaVersion;\r\n\r\n  /**\r\n   * The TSDoc configuration that was used when analyzing the API for this package.\r\n   *\r\n   * @remarks\r\n   *\r\n   * The structure of this objet is defined by the `@microsoft/tsdoc-config` library.\r\n   * Normally this configuration is loaded from the project's tsdoc.json file.  It is stored\r\n   * in the .api.json file so that doc comments can be parsed accurately when loading the file.\r\n   */\r\n  tsdocConfig: JsonObject;\r\n}\r\n\r\nexport interface IApiPackageJson extends IApiItemJson {\r\n  /**\r\n   * A file header that stores metadata about the tool that wrote the *.api.json file.\r\n   */\r\n  metadata: IApiPackageMetadataJson;\r\n}\r\n\r\n/**\r\n * Options for {@link ApiPackage.saveToJsonFile}.\r\n * @public\r\n */\r\nexport interface IApiPackageSaveOptions extends IJsonFileSaveOptions {\r\n  /**\r\n   * Optionally specifies a value for the \"toolPackage\" field in the output .api.json data file;\r\n   * otherwise, the value will be \"api-extractor-model\".\r\n   */\r\n  toolPackage?: string;\r\n\r\n  /**\r\n   * Optionally specifies a value for the \"toolVersion\" field in the output .api.json data file;\r\n   * otherwise, the value will be the current version of the api-extractor-model package.\r\n   */\r\n  toolVersion?: string;\r\n\r\n  /**\r\n   * Set to true only when invoking API Extractor's test harness.\r\n   *\r\n   * @remarks\r\n   * When `testMode` is true, the `toolVersion` field in the .api.json file is assigned an empty string\r\n   * to prevent spurious diffs in output files tracked for tests.\r\n   */\r\n  testMode?: boolean;\r\n}\r\n\r\n/**\r\n * Represents an NPM package containing API declarations.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * @public\r\n */\r\nexport class ApiPackage extends ApiItemContainerMixin(ApiNameMixin(ApiDocumentedItem)) {\r\n  private readonly _tsdocConfiguration: TSDocConfiguration;\r\n\r\n  public constructor(options: IApiPackageOptions) {\r\n    super(options);\r\n\r\n    this._tsdocConfiguration = options.tsdocConfiguration;\r\n  }\r\n\r\n  public static loadFromJsonFile(apiJsonFilename: string): ApiPackage {\r\n    const jsonObject: IApiPackageJson = JsonFile.load(apiJsonFilename);\r\n\r\n    if (!jsonObject || !jsonObject.metadata || typeof jsonObject.metadata.schemaVersion !== 'number') {\r\n      throw new Error(\r\n        `Error loading ${apiJsonFilename}:` +\r\n          `\\nThe file format is not recognized; the \"metadata.schemaVersion\" field is missing or invalid`\r\n      );\r\n    }\r\n\r\n    const schemaVersion: number = jsonObject.metadata.schemaVersion;\r\n\r\n    if (schemaVersion < ApiJsonSchemaVersion.OLDEST_SUPPORTED) {\r\n      throw new Error(\r\n        `Error loading ${apiJsonFilename}:` +\r\n          `\\nThe file format is version ${schemaVersion},` +\r\n          ` whereas ${ApiJsonSchemaVersion.OLDEST_SUPPORTED} is the oldest version supported by this tool`\r\n      );\r\n    }\r\n\r\n    let oldestForwardsCompatibleVersion: number = schemaVersion;\r\n    if (jsonObject.metadata.oldestForwardsCompatibleVersion) {\r\n      // Sanity check\r\n      if (jsonObject.metadata.oldestForwardsCompatibleVersion > schemaVersion) {\r\n        throw new Error(\r\n          `Error loading ${apiJsonFilename}:` +\r\n            `\\nInvalid file format; \"oldestForwardsCompatibleVersion\" cannot be newer than \"schemaVersion\"`\r\n        );\r\n      }\r\n      oldestForwardsCompatibleVersion = jsonObject.metadata.oldestForwardsCompatibleVersion;\r\n    }\r\n\r\n    let versionToDeserialize: number = schemaVersion;\r\n    if (versionToDeserialize > ApiJsonSchemaVersion.LATEST) {\r\n      // If the file format is too new, can we treat it as some earlier compatible version\r\n      // as indicated by oldestForwardsCompatibleVersion?\r\n      versionToDeserialize = Math.max(oldestForwardsCompatibleVersion, ApiJsonSchemaVersion.LATEST);\r\n\r\n      if (versionToDeserialize > ApiJsonSchemaVersion.LATEST) {\r\n        // Nope, still too new\r\n        throw new Error(\r\n          `Error loading ${apiJsonFilename}:` +\r\n            `\\nThe file format version ${schemaVersion} was written by a newer release of` +\r\n            ` the api-extractor-model library; you may need to upgrade your software`\r\n        );\r\n      }\r\n    }\r\n\r\n    const tsdocConfiguration: TSDocConfiguration = new TSDocConfiguration();\r\n\r\n    if (versionToDeserialize >= ApiJsonSchemaVersion.V_1004) {\r\n      const tsdocConfigFile: TSDocConfigFile = TSDocConfigFile.loadFromObject(\r\n        jsonObject.metadata.tsdocConfig\r\n      );\r\n      if (tsdocConfigFile.hasErrors) {\r\n        throw new Error(`Error loading ${apiJsonFilename}:\\n` + tsdocConfigFile.getErrorSummary());\r\n      }\r\n\r\n      tsdocConfigFile.configureParser(tsdocConfiguration);\r\n    }\r\n\r\n    const context: DeserializerContext = new DeserializerContext({\r\n      apiJsonFilename,\r\n      toolPackage: jsonObject.metadata.toolPackage,\r\n      toolVersion: jsonObject.metadata.toolVersion,\r\n      versionToDeserialize: versionToDeserialize,\r\n      tsdocConfiguration\r\n    });\r\n\r\n    return ApiItem.deserialize(jsonObject, context) as ApiPackage;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.Package;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    // No prefix needed, because ApiPackage is the only possible member of an ApiModel\r\n    return this.name;\r\n  }\r\n\r\n  public get entryPoints(): ReadonlyArray<ApiEntryPoint> {\r\n    return this.members as ReadonlyArray<ApiEntryPoint>;\r\n  }\r\n\r\n  /**\r\n   * The TSDoc configuration that was used when analyzing the API for this package.\r\n   *\r\n   * @remarks\r\n   *\r\n   * Normally this configuration is loaded from the project's tsdoc.json file.  It is stored\r\n   * in the .api.json file so that doc comments can be parsed accurately when loading the file.\r\n   */\r\n  public get tsdocConfiguration(): TSDocConfiguration {\r\n    return this._tsdocConfiguration;\r\n  }\r\n\r\n  /** @override */\r\n  public addMember(member: ApiEntryPoint): void {\r\n    if (member.kind !== ApiItemKind.EntryPoint) {\r\n      throw new Error('Only items of type ApiEntryPoint may be added to an ApiPackage');\r\n    }\r\n    super.addMember(member);\r\n  }\r\n\r\n  public findEntryPointsByPath(importPath: string): ReadonlyArray<ApiEntryPoint> {\r\n    return this.findMembersByName(importPath) as ReadonlyArray<ApiEntryPoint>;\r\n  }\r\n\r\n  public saveToJsonFile(apiJsonFilename: string, options?: IApiPackageSaveOptions): void {\r\n    if (!options) {\r\n      options = {};\r\n    }\r\n\r\n    const packageJson: IPackageJson = PackageJsonLookup.loadOwnPackageJson(__dirname);\r\n\r\n    const tsdocConfigFile: TSDocConfigFile = TSDocConfigFile.loadFromParser(this.tsdocConfiguration);\r\n    const tsdocConfig: JsonObject = tsdocConfigFile.saveToObject();\r\n\r\n    const jsonObject: IApiPackageJson = {\r\n      metadata: {\r\n        toolPackage: options.toolPackage || packageJson.name,\r\n        // In test mode, we don't write the real version, since that would cause spurious diffs whenever\r\n        // the version is bumped.  Instead we write a placeholder string.\r\n        toolVersion: options.testMode ? '[test mode]' : options.toolVersion || packageJson.version,\r\n        schemaVersion: ApiJsonSchemaVersion.LATEST,\r\n        oldestForwardsCompatibleVersion: ApiJsonSchemaVersion.OLDEST_FORWARDS_COMPATIBLE,\r\n        tsdocConfig\r\n      }\r\n    } as IApiPackageJson;\r\n    this.serializeInto(jsonObject);\r\n    JsonFile.save(jsonObject, apiJsonFilename, options);\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    return DeclarationReference.package(this.name);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ApiPackage.js","sourceRoot":"","sources":["../../src/model/ApiPackage.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport { DeclarationReference } from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItem, ApiItemKind, IApiItemJson } from '../items/ApiItem';\r\nimport { ApiItemContainerMixin, IApiItemContainerMixinOptions } from '../mixins/ApiItemContainerMixin';\r\nimport {\r\n  JsonFile,\r\n  IJsonFileSaveOptions,\r\n  PackageJsonLookup,\r\n  IPackageJson,\r\n  JsonObject\r\n} from '@rushstack/node-core-library';\r\nimport { ApiDocumentedItem, IApiDocumentedItemOptions } from '../items/ApiDocumentedItem';\r\nimport { ApiEntryPoint } from './ApiEntryPoint';\r\nimport { IApiNameMixinOptions, ApiNameMixin } from '../mixins/ApiNameMixin';\r\nimport { DeserializerContext, ApiJsonSchemaVersion } from './DeserializerContext';\r\nimport { TSDocConfiguration } from '@microsoft/tsdoc';\r\nimport { TSDocConfigFile } from '@microsoft/tsdoc-config';\r\n\r\n/**\r\n * Constructor options for {@link ApiPackage}.\r\n * @public\r\n */\r\nexport interface IApiPackageOptions\r\n  extends IApiItemContainerMixinOptions,\r\n    IApiNameMixinOptions,\r\n    IApiDocumentedItemOptions {\r\n  tsdocConfiguration: TSDocConfiguration;\r\n}\r\n\r\nexport interface IApiPackageMetadataJson {\r\n  /**\r\n   * The NPM package name for the tool that wrote the *.api.json file.\r\n   * For informational purposes only.\r\n   */\r\n  toolPackage: string;\r\n\r\n  /**\r\n   * The NPM package version for the tool that wrote the *.api.json file.\r\n   * For informational purposes only.\r\n   */\r\n  toolVersion: string;\r\n\r\n  /**\r\n   * The schema version for the .api.json file format.  Used for determining whether the file format is\r\n   * supported, and for backwards compatibility.\r\n   */\r\n  schemaVersion: ApiJsonSchemaVersion;\r\n\r\n  /**\r\n   * To support forwards compatibility, the `oldestForwardsCompatibleVersion` field tracks the oldest schema version\r\n   * whose corresponding deserializer could safely load this file.\r\n   *\r\n   * @remarks\r\n   * Normally api-extractor-model should refuse to load a schema version that is newer than the latest version\r\n   * that its deserializer understands.  However, sometimes a schema change may merely introduce some new fields\r\n   * without modifying or removing any existing fields.  In this case, an older api-extractor-model library can\r\n   * safely deserialize the newer version (by ignoring the extra fields that it doesn't recognize).  The newer\r\n   * serializer can use this field to communicate that.\r\n   *\r\n   * If present, the `oldestForwardsCompatibleVersion` must be less than or equal to\r\n   * `IApiPackageMetadataJson.schemaVersion`.\r\n   */\r\n  oldestForwardsCompatibleVersion?: ApiJsonSchemaVersion;\r\n\r\n  /**\r\n   * The TSDoc configuration that was used when analyzing the API for this package.\r\n   *\r\n   * @remarks\r\n   *\r\n   * The structure of this objet is defined by the `@microsoft/tsdoc-config` library.\r\n   * Normally this configuration is loaded from the project's tsdoc.json file.  It is stored\r\n   * in the .api.json file so that doc comments can be parsed accurately when loading the file.\r\n   */\r\n  tsdocConfig: JsonObject;\r\n}\r\n\r\nexport interface IApiPackageJson extends IApiItemJson {\r\n  /**\r\n   * A file header that stores metadata about the tool that wrote the *.api.json file.\r\n   */\r\n  metadata: IApiPackageMetadataJson;\r\n}\r\n\r\n/**\r\n * Options for {@link ApiPackage.saveToJsonFile}.\r\n * @public\r\n */\r\nexport interface IApiPackageSaveOptions extends IJsonFileSaveOptions {\r\n  /**\r\n   * Optionally specifies a value for the \"toolPackage\" field in the output .api.json data file;\r\n   * otherwise, the value will be \"api-extractor-model\".\r\n   */\r\n  toolPackage?: string;\r\n\r\n  /**\r\n   * Optionally specifies a value for the \"toolVersion\" field in the output .api.json data file;\r\n   * otherwise, the value will be the current version of the api-extractor-model package.\r\n   */\r\n  toolVersion?: string;\r\n\r\n  /**\r\n   * Set to true only when invoking API Extractor's test harness.\r\n   *\r\n   * @remarks\r\n   * When `testMode` is true, the `toolVersion` field in the .api.json file is assigned an empty string\r\n   * to prevent spurious diffs in output files tracked for tests.\r\n   */\r\n  testMode?: boolean;\r\n}\r\n\r\n/**\r\n * Represents an NPM package containing API declarations.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * @public\r\n */\r\nexport class ApiPackage extends ApiItemContainerMixin(ApiNameMixin(ApiDocumentedItem)) {\r\n  private readonly _tsdocConfiguration: TSDocConfiguration;\r\n\r\n  public constructor(options: IApiPackageOptions) {\r\n    super(options);\r\n\r\n    this._tsdocConfiguration = options.tsdocConfiguration;\r\n  }\r\n\r\n  public static loadFromJsonFile(apiJsonFilename: string): ApiPackage {\r\n    const jsonObject: IApiPackageJson = JsonFile.load(apiJsonFilename);\r\n\r\n    if (!jsonObject || !jsonObject.metadata || typeof jsonObject.metadata.schemaVersion !== 'number') {\r\n      throw new Error(\r\n        `Error loading ${apiJsonFilename}:` +\r\n          `\\nThe file format is not recognized; the \"metadata.schemaVersion\" field is missing or invalid`\r\n      );\r\n    }\r\n\r\n    const schemaVersion: number = jsonObject.metadata.schemaVersion;\r\n\r\n    if (schemaVersion < ApiJsonSchemaVersion.OLDEST_SUPPORTED) {\r\n      throw new Error(\r\n        `Error loading ${apiJsonFilename}:` +\r\n          `\\nThe file format is version ${schemaVersion},` +\r\n          ` whereas ${ApiJsonSchemaVersion.OLDEST_SUPPORTED} is the oldest version supported by this tool`\r\n      );\r\n    }\r\n\r\n    let oldestForwardsCompatibleVersion: number = schemaVersion;\r\n    if (jsonObject.metadata.oldestForwardsCompatibleVersion) {\r\n      // Sanity check\r\n      if (jsonObject.metadata.oldestForwardsCompatibleVersion > schemaVersion) {\r\n        throw new Error(\r\n          `Error loading ${apiJsonFilename}:` +\r\n            `\\nInvalid file format; \"oldestForwardsCompatibleVersion\" cannot be newer than \"schemaVersion\"`\r\n        );\r\n      }\r\n      oldestForwardsCompatibleVersion = jsonObject.metadata.oldestForwardsCompatibleVersion;\r\n    }\r\n\r\n    let versionToDeserialize: number = schemaVersion;\r\n    if (versionToDeserialize > ApiJsonSchemaVersion.LATEST) {\r\n      // If the file format is too new, can we treat it as some earlier compatible version\r\n      // as indicated by oldestForwardsCompatibleVersion?\r\n      versionToDeserialize = Math.max(oldestForwardsCompatibleVersion, ApiJsonSchemaVersion.LATEST);\r\n\r\n      if (versionToDeserialize > ApiJsonSchemaVersion.LATEST) {\r\n        // Nope, still too new\r\n        throw new Error(\r\n          `Error loading ${apiJsonFilename}:` +\r\n            `\\nThe file format version ${schemaVersion} was written by a newer release of` +\r\n            ` the api-extractor-model library; you may need to upgrade your software`\r\n        );\r\n      }\r\n    }\r\n\r\n    const tsdocConfiguration: TSDocConfiguration = new TSDocConfiguration();\r\n\r\n    if (versionToDeserialize >= ApiJsonSchemaVersion.V_1004) {\r\n      const tsdocConfigFile: TSDocConfigFile = TSDocConfigFile.loadFromObject(\r\n        jsonObject.metadata.tsdocConfig\r\n      );\r\n      if (tsdocConfigFile.hasErrors) {\r\n        throw new Error(`Error loading ${apiJsonFilename}:\\n` + tsdocConfigFile.getErrorSummary());\r\n      }\r\n\r\n      tsdocConfigFile.configureParser(tsdocConfiguration);\r\n    }\r\n\r\n    const context: DeserializerContext = new DeserializerContext({\r\n      apiJsonFilename,\r\n      toolPackage: jsonObject.metadata.toolPackage,\r\n      toolVersion: jsonObject.metadata.toolVersion,\r\n      versionToDeserialize: versionToDeserialize,\r\n      tsdocConfiguration\r\n    });\r\n\r\n    return ApiItem.deserialize(jsonObject, context) as ApiPackage;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.Package;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    // No prefix needed, because ApiPackage is the only possible member of an ApiModel\r\n    return this.name;\r\n  }\r\n\r\n  public get entryPoints(): ReadonlyArray<ApiEntryPoint> {\r\n    return this.members as ReadonlyArray<ApiEntryPoint>;\r\n  }\r\n\r\n  /**\r\n   * The TSDoc configuration that was used when analyzing the API for this package.\r\n   *\r\n   * @remarks\r\n   *\r\n   * Normally this configuration is loaded from the project's tsdoc.json file.  It is stored\r\n   * in the .api.json file so that doc comments can be parsed accurately when loading the file.\r\n   */\r\n  public get tsdocConfiguration(): TSDocConfiguration {\r\n    return this._tsdocConfiguration;\r\n  }\r\n\r\n  /** @override */\r\n  public addMember(member: ApiEntryPoint): void {\r\n    if (member.kind !== ApiItemKind.EntryPoint) {\r\n      throw new Error('Only items of type ApiEntryPoint may be added to an ApiPackage');\r\n    }\r\n    super.addMember(member);\r\n  }\r\n\r\n  public findEntryPointsByPath(importPath: string): ReadonlyArray<ApiEntryPoint> {\r\n    return this.findMembersByName(importPath) as ReadonlyArray<ApiEntryPoint>;\r\n  }\r\n\r\n  public saveToJsonFile(apiJsonFilename: string, options?: IApiPackageSaveOptions): void {\r\n    if (!options) {\r\n      options = {};\r\n    }\r\n\r\n    const packageJson: IPackageJson = PackageJsonLookup.loadOwnPackageJson(__dirname);\r\n\r\n    const tsdocConfigFile: TSDocConfigFile = TSDocConfigFile.loadFromParser(this.tsdocConfiguration);\r\n    const tsdocConfig: JsonObject = tsdocConfigFile.saveToObject();\r\n\r\n    const jsonObject: IApiPackageJson = {\r\n      metadata: {\r\n        toolPackage: options.toolPackage || packageJson.name,\r\n        // In test mode, we don't write the real version, since that would cause spurious diffs whenever\r\n        // the version is bumped.  Instead we write a placeholder string.\r\n        toolVersion: options.testMode ? '[test mode]' : options.toolVersion || packageJson.version,\r\n        schemaVersion: ApiJsonSchemaVersion.LATEST,\r\n        oldestForwardsCompatibleVersion: ApiJsonSchemaVersion.OLDEST_FORWARDS_COMPATIBLE,\r\n        tsdocConfig\r\n      }\r\n    } as IApiPackageJson;\r\n    this.serializeInto(jsonObject);\r\n    JsonFile.save(jsonObject, apiJsonFilename, options);\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    return DeclarationReference.package(this.name);\r\n  }\r\n}\r\n"]}

package/lib/model/ApiProperty.js

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiProperty = void 0;
 const DeclarationReference_1 = require("@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference");
+const ApiItem_1 = require("../items/ApiItem");
 const ApiStaticMixin_1 = require("../mixins/ApiStaticMixin");
 const ApiPropertyItem_1 = require("../items/ApiPropertyItem");
 /**
@@ -46,15 +47,15 @@ class ApiProperty extends (0, ApiStaticMixin_1.ApiStaticMixin)(ApiPropertyItem_1
     }
     static getContainerKey(name, isStatic) {
         if (isStatic) {
-            return `${name}|${"Property" /* Property */}|static`;
+            return `${name}|${ApiItem_1.ApiItemKind.Property}|static`;
         }
         else {
-            return `${name}|${"Property" /* Property */}|instance`;
+            return `${name}|${ApiItem_1.ApiItemKind.Property}|instance`;
         }
     }
     /** @override */
     get kind() {
-        return "Property" /* Property */;
+        return ApiItem_1.ApiItemKind.Property;
     }
     /** @override */
     get containerKey() {

package/lib/model/ApiProperty.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiProperty.js","sourceRoot":"","sources":["../../src/model/ApiProperty.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AAEjE,6DAAkF;AAClF,8DAAoF;AAQpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAa,WAAY,SAAQ,IAAA,+BAAc,EAAC,iCAAe,CAAC;IAC9D,YAAmB,OAA4B;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY,EAAE,QAAiB;QAC3D,IAAI,QAAQ,EAAE;YACZ,OAAO,GAAG,IAAI,IAAI,yBAAoB,SAAS,CAAC;SACjD;aAAM;YACL,OAAO,GAAG,IAAI,IAAI,yBAAoB,WAAW,CAAC;SACnD;IACH,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,iCAA4B;IAC9B,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,mBAAoB,CAAC,kBAAmB,EAAE,aAAa,CAAC;aACzF,WAAW,uBAAgB,CAAC;IACjC,CAAC;CACF;AA9BD,kCA8BC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiStaticMixin, IApiStaticMixinOptions } from '../mixins/ApiStaticMixin';\r\nimport { ApiPropertyItem, IApiPropertyItemOptions } from '../items/ApiPropertyItem';\r\n\r\n/**\r\n * Constructor options for {@link ApiProperty}.\r\n * @public\r\n */\r\nexport interface IApiPropertyOptions extends IApiPropertyItemOptions, IApiStaticMixinOptions {}\r\n\r\n/**\r\n * Represents a TypeScript property declaration that belongs to an `ApiClass`.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiProperty` represents a TypeScript declaration such as the `width` and `height` members in this example:\r\n *\r\n * ```ts\r\n * export class Widget {\r\n *   public width: number = 100;\r\n *\r\n *   public get height(): number {\r\n *     if (this.isSquashed()) {\r\n *       return 0;\r\n *     } else {\r\n *       return this.clientArea.height;\r\n *     }\r\n *   }\r\n * }\r\n * ```\r\n *\r\n * Note that member variables are also considered to be properties.\r\n *\r\n * If the property has both a getter function and setter function, they will be represented by a single `ApiProperty`\r\n * and must have a single documentation comment.\r\n *\r\n * Compare with {@link ApiPropertySignature}, which represents a property belonging to an interface.\r\n * For example, a class property can be `static` but an interface property cannot.\r\n *\r\n * @public\r\n */\r\nexport class ApiProperty extends ApiStaticMixin(ApiPropertyItem) {\r\n  public constructor(options: IApiPropertyOptions) {\r\n    super(options);\r\n  }\r\n\r\n  public static getContainerKey(name: string, isStatic: boolean): string {\r\n    if (isStatic) {\r\n      return `${name}|${ApiItemKind.Property}|static`;\r\n    } else {\r\n      return `${name}|${ApiItemKind.Property}|instance`;\r\n    }\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.Property;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiProperty.getContainerKey(this.name, this.isStatic);\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(this.isStatic ? Navigation.Exports : Navigation.Members, nameComponent)\r\n      .withMeaning(Meaning.Member);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ApiProperty.js","sourceRoot":"","sources":["../../src/model/ApiProperty.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AACjE,8CAA+C;AAC/C,6DAAkF;AAClF,8DAAoF;AAQpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAa,WAAY,SAAQ,IAAA,+BAAc,EAAC,iCAAe,CAAC;IAC9D,YAAmB,OAA4B;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY,EAAE,QAAiB;QAC3D,IAAI,QAAQ,EAAE;YACZ,OAAO,GAAG,IAAI,IAAI,qBAAW,CAAC,QAAQ,SAAS,CAAC;SACjD;aAAM;YACL,OAAO,GAAG,IAAI,IAAI,qBAAW,CAAC,QAAQ,WAAW,CAAC;SACnD;IACH,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,OAAO,qBAAW,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,mBAAoB,CAAC,kBAAmB,EAAE,aAAa,CAAC;aACzF,WAAW,uBAAgB,CAAC;IACjC,CAAC;CACF;AA9BD,kCA8BC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiStaticMixin, IApiStaticMixinOptions } from '../mixins/ApiStaticMixin';\r\nimport { ApiPropertyItem, IApiPropertyItemOptions } from '../items/ApiPropertyItem';\r\n\r\n/**\r\n * Constructor options for {@link ApiProperty}.\r\n * @public\r\n */\r\nexport interface IApiPropertyOptions extends IApiPropertyItemOptions, IApiStaticMixinOptions {}\r\n\r\n/**\r\n * Represents a TypeScript property declaration that belongs to an `ApiClass`.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiProperty` represents a TypeScript declaration such as the `width` and `height` members in this example:\r\n *\r\n * ```ts\r\n * export class Widget {\r\n *   public width: number = 100;\r\n *\r\n *   public get height(): number {\r\n *     if (this.isSquashed()) {\r\n *       return 0;\r\n *     } else {\r\n *       return this.clientArea.height;\r\n *     }\r\n *   }\r\n * }\r\n * ```\r\n *\r\n * Note that member variables are also considered to be properties.\r\n *\r\n * If the property has both a getter function and setter function, they will be represented by a single `ApiProperty`\r\n * and must have a single documentation comment.\r\n *\r\n * Compare with {@link ApiPropertySignature}, which represents a property belonging to an interface.\r\n * For example, a class property can be `static` but an interface property cannot.\r\n *\r\n * @public\r\n */\r\nexport class ApiProperty extends ApiStaticMixin(ApiPropertyItem) {\r\n  public constructor(options: IApiPropertyOptions) {\r\n    super(options);\r\n  }\r\n\r\n  public static getContainerKey(name: string, isStatic: boolean): string {\r\n    if (isStatic) {\r\n      return `${name}|${ApiItemKind.Property}|static`;\r\n    } else {\r\n      return `${name}|${ApiItemKind.Property}|instance`;\r\n    }\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.Property;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiProperty.getContainerKey(this.name, this.isStatic);\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(this.isStatic ? Navigation.Exports : Navigation.Members, nameComponent)\r\n      .withMeaning(Meaning.Member);\r\n  }\r\n}\r\n"]}

package/lib/model/ApiPropertySignature.js

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiPropertySignature = void 0;
 const DeclarationReference_1 = require("@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference");
+const ApiItem_1 = require("../items/ApiItem");
 const ApiPropertyItem_1 = require("../items/ApiPropertyItem");
 /**
  * Represents a TypeScript property declaration that belongs to an `ApiInterface`.
@@ -32,11 +33,11 @@ class ApiPropertySignature extends ApiPropertyItem_1.ApiPropertyItem {
         super(options);
     }
     static getContainerKey(name) {
-        return `${name}|${"PropertySignature" /* PropertySignature */}`;
+        return `${name}|${ApiItem_1.ApiItemKind.PropertySignature}`;
     }
     /** @override */
     get kind() {
-        return "PropertySignature" /* PropertySignature */;
+        return ApiItem_1.ApiItemKind.PropertySignature;
     }
     /** @override */
     get containerKey() {

package/lib/model/ApiPropertySignature.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiPropertySignature.js","sourceRoot":"","sources":["../../src/model/ApiPropertySignature.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AAEjE,8DAAoF;AAQpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,oBAAqB,SAAQ,iCAAe;IACvD,YAAmB,OAAqC;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY;QACxC,OAAO,GAAG,IAAI,IAAI,2CAA6B,EAAE,CAAC;IACpD,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,mDAAqC;IACvC,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,oBAAoB,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,oBAAqB,aAAa,CAAC;aACpD,WAAW,uBAAgB,CAAC;IACjC,CAAC;CACF;AA1BD,oDA0BC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiPropertyItem, IApiPropertyItemOptions } from '../items/ApiPropertyItem';\r\n\r\n/**\r\n * Constructor options for {@link ApiPropertySignature}.\r\n * @public\r\n */\r\nexport interface IApiPropertySignatureOptions extends IApiPropertyItemOptions {}\r\n\r\n/**\r\n * Represents a TypeScript property declaration that belongs to an `ApiInterface`.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiPropertySignature` represents a TypeScript declaration such as the `width` and `height` members in this example:\r\n *\r\n * ```ts\r\n * export interface IWidget {\r\n *   readonly width: number;\r\n *   height: number;\r\n * }\r\n * ```\r\n *\r\n * Compare with {@link ApiProperty}, which represents a property belonging to a class.\r\n * For example, a class property can be `static` but an interface property cannot.\r\n *\r\n * @public\r\n */\r\nexport class ApiPropertySignature extends ApiPropertyItem {\r\n  public constructor(options: IApiPropertySignatureOptions) {\r\n    super(options);\r\n  }\r\n\r\n  public static getContainerKey(name: string): string {\r\n    return `${name}|${ApiItemKind.PropertySignature}`;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.PropertySignature;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiPropertySignature.getContainerKey(this.name);\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(Navigation.Members, nameComponent)\r\n      .withMeaning(Meaning.Member);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ApiPropertySignature.js","sourceRoot":"","sources":["../../src/model/ApiPropertySignature.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AACjE,8CAA+C;AAC/C,8DAAoF;AAQpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,oBAAqB,SAAQ,iCAAe;IACvD,YAAmB,OAAqC;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY;QACxC,OAAO,GAAG,IAAI,IAAI,qBAAW,CAAC,iBAAiB,EAAE,CAAC;IACpD,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,OAAO,qBAAW,CAAC,iBAAiB,CAAC;IACvC,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,oBAAoB,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,oBAAqB,aAAa,CAAC;aACpD,WAAW,uBAAgB,CAAC;IACjC,CAAC;CACF;AA1BD,oDA0BC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiPropertyItem, IApiPropertyItemOptions } from '../items/ApiPropertyItem';\r\n\r\n/**\r\n * Constructor options for {@link ApiPropertySignature}.\r\n * @public\r\n */\r\nexport interface IApiPropertySignatureOptions extends IApiPropertyItemOptions {}\r\n\r\n/**\r\n * Represents a TypeScript property declaration that belongs to an `ApiInterface`.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiPropertySignature` represents a TypeScript declaration such as the `width` and `height` members in this example:\r\n *\r\n * ```ts\r\n * export interface IWidget {\r\n *   readonly width: number;\r\n *   height: number;\r\n * }\r\n * ```\r\n *\r\n * Compare with {@link ApiProperty}, which represents a property belonging to a class.\r\n * For example, a class property can be `static` but an interface property cannot.\r\n *\r\n * @public\r\n */\r\nexport class ApiPropertySignature extends ApiPropertyItem {\r\n  public constructor(options: IApiPropertySignatureOptions) {\r\n    super(options);\r\n  }\r\n\r\n  public static getContainerKey(name: string): string {\r\n    return `${name}|${ApiItemKind.PropertySignature}`;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.PropertySignature;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiPropertySignature.getContainerKey(this.name);\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(Navigation.Members, nameComponent)\r\n      .withMeaning(Meaning.Member);\r\n  }\r\n}\r\n"]}

package/lib/model/ApiTypeAlias.js

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiTypeAlias = void 0;
 const DeclarationReference_1 = require("@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference");
+const ApiItem_1 = require("../items/ApiItem");
 const ApiDeclaredItem_1 = require("../items/ApiDeclaredItem");
 const ApiReleaseTagMixin_1 = require("../mixins/ApiReleaseTagMixin");
 const ApiNameMixin_1 = require("../mixins/ApiNameMixin");
@@ -45,11 +46,11 @@ class ApiTypeAlias extends (0, ApiTypeParameterListMixin_1.ApiTypeParameterListM
         options.typeTokenRange = jsonObject.typeTokenRange;
     }
     static getContainerKey(name) {
-        return `${name}|${"TypeAlias" /* TypeAlias */}`;
+        return `${name}|${ApiItem_1.ApiItemKind.TypeAlias}`;
     }
     /** @override */
     get kind() {
-        return "TypeAlias" /* TypeAlias */;
+        return ApiItem_1.ApiItemKind.TypeAlias;
     }
     /** @override */
     get containerKey() {

package/lib/model/ApiTypeAlias.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiTypeAlias.js","sourceRoot":"","sources":["../../src/model/ApiTypeAlias.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AAGjE,8DAA0G;AAC1G,qEAA8F;AAC9F,yDAA4E;AAC5E,mFAI6C;AAmB7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,YAAa,SAAQ,IAAA,qDAAyB,EACzD,IAAA,2BAAY,EAAC,IAAA,uCAAkB,EAAC,iCAAe,CAAC,CAAC,CAClD;IAcC,YAAmB,OAA6B;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,iBAAiB,CAC7B,OAAsC,EACtC,OAA4B,EAC5B,UAA6B;QAE7B,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEtD,OAAO,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;IACrD,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY;QACxC,OAAO,GAAG,IAAI,IAAI,2BAAqB,EAAE,CAAC;IAC5C,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,mCAA6B;IAC/B,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,gBAAgB;IACT,aAAa,CAAC,UAAsC;QACzD,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAEhC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;IAC1D,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,oBAAqB,aAAa,CAAC;aACpD,WAAW,wBAAmB,CAAC;IACpC,CAAC;CACF;AA7DD,oCA6DC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { Excerpt, IExcerptTokenRange } from '../mixins/Excerpt';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiDeclaredItem, IApiDeclaredItemOptions, IApiDeclaredItemJson } from '../items/ApiDeclaredItem';\r\nimport { ApiReleaseTagMixin, IApiReleaseTagMixinOptions } from '../mixins/ApiReleaseTagMixin';\r\nimport { IApiNameMixinOptions, ApiNameMixin } from '../mixins/ApiNameMixin';\r\nimport {\r\n  ApiTypeParameterListMixin,\r\n  IApiTypeParameterListMixinOptions,\r\n  IApiTypeParameterListMixinJson\r\n} from '../mixins/ApiTypeParameterListMixin';\r\nimport { DeserializerContext } from './DeserializerContext';\r\n\r\n/**\r\n * Constructor options for {@link ApiTypeAlias}.\r\n * @public\r\n */\r\nexport interface IApiTypeAliasOptions\r\n  extends IApiNameMixinOptions,\r\n    IApiReleaseTagMixinOptions,\r\n    IApiDeclaredItemOptions,\r\n    IApiTypeParameterListMixinOptions {\r\n  typeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\nexport interface IApiTypeAliasJson extends IApiDeclaredItemJson, IApiTypeParameterListMixinJson {\r\n  typeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\n/**\r\n * Represents a TypeScript type alias declaration.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiTypeAlias` represents a definition such as one of these examples:\r\n *\r\n * ```ts\r\n * // A union type:\r\n * export type Shape = Square | Triangle | Circle;\r\n *\r\n * // A generic type alias:\r\n * export type BoxedValue<T> = { value: T };\r\n *\r\n * export type BoxedArray<T> = { array: T[] };\r\n *\r\n * // A conditional type alias:\r\n * export type Boxed<T> = T extends any[] ? BoxedArray<T[number]> : BoxedValue<T>;\r\n *\r\n * ```\r\n *\r\n * @public\r\n */\r\nexport class ApiTypeAlias extends ApiTypeParameterListMixin(\r\n  ApiNameMixin(ApiReleaseTagMixin(ApiDeclaredItem))\r\n) {\r\n  /**\r\n   * An {@link Excerpt} that describes the type of the alias.\r\n   *\r\n   * @remarks\r\n   * In the example below, the `typeExcerpt` would correspond to the subexpression\r\n   * `T extends any[] ? BoxedArray<T[number]> : BoxedValue<T>;`:\r\n   *\r\n   * ```ts\r\n   * export type Boxed<T> = T extends any[] ? BoxedArray<T[number]> : BoxedValue<T>;\r\n   * ```\r\n   */\r\n  public readonly typeExcerpt: Excerpt;\r\n\r\n  public constructor(options: IApiTypeAliasOptions) {\r\n    super(options);\r\n\r\n    this.typeExcerpt = this.buildExcerpt(options.typeTokenRange);\r\n  }\r\n\r\n  /** @override */\r\n  public static onDeserializeInto(\r\n    options: Partial<IApiTypeAliasOptions>,\r\n    context: DeserializerContext,\r\n    jsonObject: IApiTypeAliasJson\r\n  ): void {\r\n    super.onDeserializeInto(options, context, jsonObject);\r\n\r\n    options.typeTokenRange = jsonObject.typeTokenRange;\r\n  }\r\n\r\n  public static getContainerKey(name: string): string {\r\n    return `${name}|${ApiItemKind.TypeAlias}`;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.TypeAlias;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiTypeAlias.getContainerKey(this.name);\r\n  }\r\n\r\n  /** @override */\r\n  public serializeInto(jsonObject: Partial<IApiTypeAliasJson>): void {\r\n    super.serializeInto(jsonObject);\r\n\r\n    jsonObject.typeTokenRange = this.typeExcerpt.tokenRange;\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(Navigation.Exports, nameComponent)\r\n      .withMeaning(Meaning.TypeAlias);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ApiTypeAlias.js","sourceRoot":"","sources":["../../src/model/ApiTypeAlias.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AAEjE,8CAA+C;AAC/C,8DAA0G;AAC1G,qEAA8F;AAC9F,yDAA4E;AAC5E,mFAI6C;AAmB7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,YAAa,SAAQ,IAAA,qDAAyB,EACzD,IAAA,2BAAY,EAAC,IAAA,uCAAkB,EAAC,iCAAe,CAAC,CAAC,CAClD;IAcC,YAAmB,OAA6B;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,iBAAiB,CAC7B,OAAsC,EACtC,OAA4B,EAC5B,UAA6B;QAE7B,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEtD,OAAO,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;IACrD,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY;QACxC,OAAO,GAAG,IAAI,IAAI,qBAAW,CAAC,SAAS,EAAE,CAAC;IAC5C,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,OAAO,qBAAW,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,gBAAgB;IACT,aAAa,CAAC,UAAsC;QACzD,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAEhC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;IAC1D,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,oBAAqB,aAAa,CAAC;aACpD,WAAW,wBAAmB,CAAC;IACpC,CAAC;CACF;AA7DD,oCA6DC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { Excerpt, IExcerptTokenRange } from '../mixins/Excerpt';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiDeclaredItem, IApiDeclaredItemOptions, IApiDeclaredItemJson } from '../items/ApiDeclaredItem';\r\nimport { ApiReleaseTagMixin, IApiReleaseTagMixinOptions } from '../mixins/ApiReleaseTagMixin';\r\nimport { IApiNameMixinOptions, ApiNameMixin } from '../mixins/ApiNameMixin';\r\nimport {\r\n  ApiTypeParameterListMixin,\r\n  IApiTypeParameterListMixinOptions,\r\n  IApiTypeParameterListMixinJson\r\n} from '../mixins/ApiTypeParameterListMixin';\r\nimport { DeserializerContext } from './DeserializerContext';\r\n\r\n/**\r\n * Constructor options for {@link ApiTypeAlias}.\r\n * @public\r\n */\r\nexport interface IApiTypeAliasOptions\r\n  extends IApiNameMixinOptions,\r\n    IApiReleaseTagMixinOptions,\r\n    IApiDeclaredItemOptions,\r\n    IApiTypeParameterListMixinOptions {\r\n  typeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\nexport interface IApiTypeAliasJson extends IApiDeclaredItemJson, IApiTypeParameterListMixinJson {\r\n  typeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\n/**\r\n * Represents a TypeScript type alias declaration.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiTypeAlias` represents a definition such as one of these examples:\r\n *\r\n * ```ts\r\n * // A union type:\r\n * export type Shape = Square | Triangle | Circle;\r\n *\r\n * // A generic type alias:\r\n * export type BoxedValue<T> = { value: T };\r\n *\r\n * export type BoxedArray<T> = { array: T[] };\r\n *\r\n * // A conditional type alias:\r\n * export type Boxed<T> = T extends any[] ? BoxedArray<T[number]> : BoxedValue<T>;\r\n *\r\n * ```\r\n *\r\n * @public\r\n */\r\nexport class ApiTypeAlias extends ApiTypeParameterListMixin(\r\n  ApiNameMixin(ApiReleaseTagMixin(ApiDeclaredItem))\r\n) {\r\n  /**\r\n   * An {@link Excerpt} that describes the type of the alias.\r\n   *\r\n   * @remarks\r\n   * In the example below, the `typeExcerpt` would correspond to the subexpression\r\n   * `T extends any[] ? BoxedArray<T[number]> : BoxedValue<T>;`:\r\n   *\r\n   * ```ts\r\n   * export type Boxed<T> = T extends any[] ? BoxedArray<T[number]> : BoxedValue<T>;\r\n   * ```\r\n   */\r\n  public readonly typeExcerpt: Excerpt;\r\n\r\n  public constructor(options: IApiTypeAliasOptions) {\r\n    super(options);\r\n\r\n    this.typeExcerpt = this.buildExcerpt(options.typeTokenRange);\r\n  }\r\n\r\n  /** @override */\r\n  public static onDeserializeInto(\r\n    options: Partial<IApiTypeAliasOptions>,\r\n    context: DeserializerContext,\r\n    jsonObject: IApiTypeAliasJson\r\n  ): void {\r\n    super.onDeserializeInto(options, context, jsonObject);\r\n\r\n    options.typeTokenRange = jsonObject.typeTokenRange;\r\n  }\r\n\r\n  public static getContainerKey(name: string): string {\r\n    return `${name}|${ApiItemKind.TypeAlias}`;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.TypeAlias;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiTypeAlias.getContainerKey(this.name);\r\n  }\r\n\r\n  /** @override */\r\n  public serializeInto(jsonObject: Partial<IApiTypeAliasJson>): void {\r\n    super.serializeInto(jsonObject);\r\n\r\n    jsonObject.typeTokenRange = this.typeExcerpt.tokenRange;\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(Navigation.Exports, nameComponent)\r\n      .withMeaning(Meaning.TypeAlias);\r\n  }\r\n}\r\n"]}

package/lib/model/ApiVariable.js

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVariable = void 0;
 const DeclarationReference_1 = require("@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference");
+const ApiItem_1 = require("../items/ApiItem");
 const ApiDeclaredItem_1 = require("../items/ApiDeclaredItem");
 const ApiReleaseTagMixin_1 = require("../mixins/ApiReleaseTagMixin");
 const ApiNameMixin_1 = require("../mixins/ApiNameMixin");
@@ -38,11 +39,11 @@ class ApiVariable extends (0, ApiNameMixin_1.ApiNameMixin)((0, ApiReleaseTagMixi
         options.variableTypeTokenRange = jsonObject.variableTypeTokenRange;
     }
     static getContainerKey(name) {
-        return `${name}|${"Variable" /* Variable */}`;
+        return `${name}|${ApiItem_1.ApiItemKind.Variable}`;
     }
     /** @override */
     get kind() {
-        return "Variable" /* Variable */;
+        return ApiItem_1.ApiItemKind.Variable;
     }
     /** @override */
     get containerKey() {

package/lib/model/ApiVariable.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiVariable.js","sourceRoot":"","sources":["../../src/model/ApiVariable.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AAEjE,8DAA0G;AAC1G,qEAA8F;AAC9F,yDAA4E;AAmB5E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,WAAY,SAAQ,IAAA,2BAAY,EAAC,IAAA,uCAAkB,EAAC,iCAAe,CAAC,CAAC;IAMhF,YAAmB,OAA4B;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC/E,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,iBAAiB,CAC7B,OAAqC,EACrC,OAA4B,EAC5B,UAA4B;QAE5B,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEtD,OAAO,CAAC,sBAAsB,GAAG,UAAU,CAAC,sBAAsB,CAAC;IACrE,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY;QACxC,OAAO,GAAG,IAAI,IAAI,yBAAoB,EAAE,CAAC;IAC3C,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,iCAA4B;IAC9B,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,gBAAgB;IACT,aAAa,CAAC,UAAqC;QACxD,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAEhC,UAAU,CAAC,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC;IAC1E,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,oBAAqB,aAAa,CAAC;aACpD,WAAW,sBAAkB,CAAC;IACnC,CAAC;CACF;AAnDD,kCAmDC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiDeclaredItem, IApiDeclaredItemOptions, IApiDeclaredItemJson } from '../items/ApiDeclaredItem';\r\nimport { ApiReleaseTagMixin, IApiReleaseTagMixinOptions } from '../mixins/ApiReleaseTagMixin';\r\nimport { IApiNameMixinOptions, ApiNameMixin } from '../mixins/ApiNameMixin';\r\nimport { IExcerptTokenRange, Excerpt } from '../mixins/Excerpt';\r\nimport { DeserializerContext } from './DeserializerContext';\r\n\r\n/**\r\n * Constructor options for {@link ApiVariable}.\r\n * @public\r\n */\r\nexport interface IApiVariableOptions\r\n  extends IApiNameMixinOptions,\r\n    IApiReleaseTagMixinOptions,\r\n    IApiDeclaredItemOptions {\r\n  variableTypeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\nexport interface IApiVariableJson extends IApiDeclaredItemJson {\r\n  variableTypeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\n/**\r\n * Represents a TypeScript variable declaration.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiVariable` represents an exported `const` or `let` object such as these examples:\r\n *\r\n * ```ts\r\n * // A variable declaration\r\n * export let verboseLogging: boolean;\r\n *\r\n * // A constant variable declaration with an initializer\r\n * export const canvas: IWidget = createCanvas();\r\n * ```\r\n *\r\n * @public\r\n */\r\nexport class ApiVariable extends ApiNameMixin(ApiReleaseTagMixin(ApiDeclaredItem)) {\r\n  /**\r\n   * An {@link Excerpt} that describes the type of the variable.\r\n   */\r\n  public readonly variableTypeExcerpt: Excerpt;\r\n\r\n  public constructor(options: IApiVariableOptions) {\r\n    super(options);\r\n\r\n    this.variableTypeExcerpt = this.buildExcerpt(options.variableTypeTokenRange);\r\n  }\r\n\r\n  /** @override */\r\n  public static onDeserializeInto(\r\n    options: Partial<IApiVariableOptions>,\r\n    context: DeserializerContext,\r\n    jsonObject: IApiVariableJson\r\n  ): void {\r\n    super.onDeserializeInto(options, context, jsonObject);\r\n\r\n    options.variableTypeTokenRange = jsonObject.variableTypeTokenRange;\r\n  }\r\n\r\n  public static getContainerKey(name: string): string {\r\n    return `${name}|${ApiItemKind.Variable}`;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.Variable;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiVariable.getContainerKey(this.name);\r\n  }\r\n\r\n  /** @override */\r\n  public serializeInto(jsonObject: Partial<IApiVariableJson>): void {\r\n    super.serializeInto(jsonObject);\r\n\r\n    jsonObject.variableTypeTokenRange = this.variableTypeExcerpt.tokenRange;\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(Navigation.Exports, nameComponent)\r\n      .withMeaning(Meaning.Variable);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ApiVariable.js","sourceRoot":"","sources":["../../src/model/ApiVariable.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kGAKiE;AACjE,8CAA+C;AAC/C,8DAA0G;AAC1G,qEAA8F;AAC9F,yDAA4E;AAmB5E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,WAAY,SAAQ,IAAA,2BAAY,EAAC,IAAA,uCAAkB,EAAC,iCAAe,CAAC,CAAC;IAMhF,YAAmB,OAA4B;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC/E,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,iBAAiB,CAC7B,OAAqC,EACrC,OAA4B,EAC5B,UAA4B;QAE5B,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEtD,OAAO,CAAC,sBAAsB,GAAG,UAAU,CAAC,sBAAsB,CAAC;IACrE,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,IAAY;QACxC,OAAO,GAAG,IAAI,IAAI,qBAAW,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC;IAED,gBAAgB;IAChB,IAAW,IAAI;QACb,OAAO,qBAAW,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,gBAAgB;IAChB,IAAW,YAAY;QACrB,OAAO,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,gBAAgB;IACT,aAAa,CAAC,UAAqC;QACxD,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAEhC,UAAU,CAAC,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC;IAC1E,CAAC;IAED,sBAAsB;IACf,uBAAuB;QAC5B,MAAM,aAAa,GAAc,2CAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,2CAAoB,CAAC,KAAK,EAAE,CAAC;aACjF,iBAAiB,oBAAqB,aAAa,CAAC;aACpD,WAAW,sBAAkB,CAAC;IACnC,CAAC;CACF;AAnDD,kCAmDC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport {\r\n  DeclarationReference,\r\n  Meaning,\r\n  Navigation,\r\n  Component\r\n} from '@microsoft/tsdoc/lib-commonjs/beta/DeclarationReference';\r\nimport { ApiItemKind } from '../items/ApiItem';\r\nimport { ApiDeclaredItem, IApiDeclaredItemOptions, IApiDeclaredItemJson } from '../items/ApiDeclaredItem';\r\nimport { ApiReleaseTagMixin, IApiReleaseTagMixinOptions } from '../mixins/ApiReleaseTagMixin';\r\nimport { IApiNameMixinOptions, ApiNameMixin } from '../mixins/ApiNameMixin';\r\nimport { IExcerptTokenRange, Excerpt } from '../mixins/Excerpt';\r\nimport { DeserializerContext } from './DeserializerContext';\r\n\r\n/**\r\n * Constructor options for {@link ApiVariable}.\r\n * @public\r\n */\r\nexport interface IApiVariableOptions\r\n  extends IApiNameMixinOptions,\r\n    IApiReleaseTagMixinOptions,\r\n    IApiDeclaredItemOptions {\r\n  variableTypeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\nexport interface IApiVariableJson extends IApiDeclaredItemJson {\r\n  variableTypeTokenRange: IExcerptTokenRange;\r\n}\r\n\r\n/**\r\n * Represents a TypeScript variable declaration.\r\n *\r\n * @remarks\r\n *\r\n * This is part of the {@link ApiModel} hierarchy of classes, which are serializable representations of\r\n * API declarations.\r\n *\r\n * `ApiVariable` represents an exported `const` or `let` object such as these examples:\r\n *\r\n * ```ts\r\n * // A variable declaration\r\n * export let verboseLogging: boolean;\r\n *\r\n * // A constant variable declaration with an initializer\r\n * export const canvas: IWidget = createCanvas();\r\n * ```\r\n *\r\n * @public\r\n */\r\nexport class ApiVariable extends ApiNameMixin(ApiReleaseTagMixin(ApiDeclaredItem)) {\r\n  /**\r\n   * An {@link Excerpt} that describes the type of the variable.\r\n   */\r\n  public readonly variableTypeExcerpt: Excerpt;\r\n\r\n  public constructor(options: IApiVariableOptions) {\r\n    super(options);\r\n\r\n    this.variableTypeExcerpt = this.buildExcerpt(options.variableTypeTokenRange);\r\n  }\r\n\r\n  /** @override */\r\n  public static onDeserializeInto(\r\n    options: Partial<IApiVariableOptions>,\r\n    context: DeserializerContext,\r\n    jsonObject: IApiVariableJson\r\n  ): void {\r\n    super.onDeserializeInto(options, context, jsonObject);\r\n\r\n    options.variableTypeTokenRange = jsonObject.variableTypeTokenRange;\r\n  }\r\n\r\n  public static getContainerKey(name: string): string {\r\n    return `${name}|${ApiItemKind.Variable}`;\r\n  }\r\n\r\n  /** @override */\r\n  public get kind(): ApiItemKind {\r\n    return ApiItemKind.Variable;\r\n  }\r\n\r\n  /** @override */\r\n  public get containerKey(): string {\r\n    return ApiVariable.getContainerKey(this.name);\r\n  }\r\n\r\n  /** @override */\r\n  public serializeInto(jsonObject: Partial<IApiVariableJson>): void {\r\n    super.serializeInto(jsonObject);\r\n\r\n    jsonObject.variableTypeTokenRange = this.variableTypeExcerpt.tokenRange;\r\n  }\r\n\r\n  /** @beta @override */\r\n  public buildCanonicalReference(): DeclarationReference {\r\n    const nameComponent: Component = DeclarationReference.parseComponent(this.name);\r\n    return (this.parent ? this.parent.canonicalReference : DeclarationReference.empty())\r\n      .addNavigationStep(Navigation.Exports, nameComponent)\r\n      .withMeaning(Meaning.Variable);\r\n  }\r\n}\r\n"]}

package/lib/model/Deserializer.js

@@ -3,6 +3,7 @@
 // See LICENSE in the project root for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Deserializer = void 0;
+const ApiItem_1 = require("../items/ApiItem");
 const ApiClass_1 = require("./ApiClass");
 const ApiEntryPoint_1 = require("./ApiEntryPoint");
 const ApiMethod_1 = require("./ApiMethod");
@@ -26,60 +27,60 @@ class Deserializer {
     static deserialize(context, jsonObject) {
         const options = {};
         switch (jsonObject.kind) {
-            case "Class" /* Class */:
+            case ApiItem_1.ApiItemKind.Class:
                 ApiClass_1.ApiClass.onDeserializeInto(options, context, jsonObject);
                 return new ApiClass_1.ApiClass(options);
-            case "CallSignature" /* CallSignature */:
+            case ApiItem_1.ApiItemKind.CallSignature:
                 ApiCallSignature_1.ApiCallSignature.onDeserializeInto(options, context, jsonObject);
                 return new ApiCallSignature_1.ApiCallSignature(options);
-            case "Constructor" /* Constructor */:
+            case ApiItem_1.ApiItemKind.Constructor:
                 ApiConstructor_1.ApiConstructor.onDeserializeInto(options, context, jsonObject);
                 return new ApiConstructor_1.ApiConstructor(options);
-            case "ConstructSignature" /* ConstructSignature */:
+            case ApiItem_1.ApiItemKind.ConstructSignature:
                 ApiConstructSignature_1.ApiConstructSignature.onDeserializeInto(options, context, jsonObject);
                 return new ApiConstructSignature_1.ApiConstructSignature(options);
-            case "EntryPoint" /* EntryPoint */:
+            case ApiItem_1.ApiItemKind.EntryPoint:
                 ApiEntryPoint_1.ApiEntryPoint.onDeserializeInto(options, context, jsonObject);
                 return new ApiEntryPoint_1.ApiEntryPoint(options);
-            case "Enum" /* Enum */:
+            case ApiItem_1.ApiItemKind.Enum:
                 ApiEnum_1.ApiEnum.onDeserializeInto(options, context, jsonObject);
                 return new ApiEnum_1.ApiEnum(options);
-            case "EnumMember" /* EnumMember */:
+            case ApiItem_1.ApiItemKind.EnumMember:
                 ApiEnumMember_1.ApiEnumMember.onDeserializeInto(options, context, jsonObject);
                 return new ApiEnumMember_1.ApiEnumMember(options);
-            case "Function" /* Function */:
+            case ApiItem_1.ApiItemKind.Function:
                 ApiFunction_1.ApiFunction.onDeserializeInto(options, context, jsonObject);
                 return new ApiFunction_1.ApiFunction(options);
-            case "IndexSignature" /* IndexSignature */:
+            case ApiItem_1.ApiItemKind.IndexSignature:
                 ApiIndexSignature_1.ApiIndexSignature.onDeserializeInto(options, context, jsonObject);
                 return new ApiIndexSignature_1.ApiIndexSignature(options);
-            case "Interface" /* Interface */:
+            case ApiItem_1.ApiItemKind.Interface:
                 ApiInterface_1.ApiInterface.onDeserializeInto(options, context, jsonObject);
                 return new ApiInterface_1.ApiInterface(options);
-            case "Method" /* Method */:
+            case ApiItem_1.ApiItemKind.Method:
                 ApiMethod_1.ApiMethod.onDeserializeInto(options, context, jsonObject);
                 return new ApiMethod_1.ApiMethod(options);
-            case "MethodSignature" /* MethodSignature */:
+            case ApiItem_1.ApiItemKind.MethodSignature:
                 ApiMethodSignature_1.ApiMethodSignature.onDeserializeInto(options, context, jsonObject);
                 return new ApiMethodSignature_1.ApiMethodSignature(options);
-            case "Model" /* Model */:
+            case ApiItem_1.ApiItemKind.Model:
                 return new ApiModel_1.ApiModel();
-            case "Namespace" /* Namespace */:
+            case ApiItem_1.ApiItemKind.Namespace:
                 ApiNamespace_1.ApiNamespace.onDeserializeInto(options, context, jsonObject);
                 return new ApiNamespace_1.ApiNamespace(options);
-            case "Package" /* Package */:
+            case ApiItem_1.ApiItemKind.Package:
                 ApiPackage_1.ApiPackage.onDeserializeInto(options, context, jsonObject);
                 return new ApiPackage_1.ApiPackage(options);
-            case "Property" /* Property */:
+            case ApiItem_1.ApiItemKind.Property:
                 ApiProperty_1.ApiProperty.onDeserializeInto(options, context, jsonObject);
                 return new ApiProperty_1.ApiProperty(options);
-            case "PropertySignature" /* PropertySignature */:
+            case ApiItem_1.ApiItemKind.PropertySignature:
                 ApiPropertySignature_1.ApiPropertySignature.onDeserializeInto(options, context, jsonObject);
                 return new ApiPropertySignature_1.ApiPropertySignature(options);
-            case "TypeAlias" /* TypeAlias */:
+            case ApiItem_1.ApiItemKind.TypeAlias:
                 ApiTypeAlias_1.ApiTypeAlias.onDeserializeInto(options, context, jsonObject);
                 return new ApiTypeAlias_1.ApiTypeAlias(options);
-            case "Variable" /* Variable */:
+            case ApiItem_1.ApiItemKind.Variable:
                 ApiVariable_1.ApiVariable.onDeserializeInto(options, context, jsonObject);
                 return new ApiVariable_1.ApiVariable(options);
             default:

package/lib/model/Deserializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Deserializer.js","sourceRoot":"","sources":["../../src/model/Deserializer.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport { IApiItemJson, IApiItemOptions, ApiItem, ApiItemKind } from '../items/ApiItem';\r\nimport { ApiClass, IApiClassOptions, IApiClassJson } from './ApiClass';\r\nimport { ApiEntryPoint, IApiEntryPointOptions } from './ApiEntryPoint';\r\nimport { ApiMethod, IApiMethodOptions } from './ApiMethod';\r\nimport { ApiModel } from './ApiModel';\r\nimport { ApiNamespace, IApiNamespaceOptions } from './ApiNamespace';\r\nimport { ApiPackage, IApiPackageOptions } from './ApiPackage';\r\nimport { ApiInterface, IApiInterfaceOptions, IApiInterfaceJson } from './ApiInterface';\r\nimport { ApiPropertySignature, IApiPropertySignatureOptions } from './ApiPropertySignature';\r\nimport { ApiMethodSignature, IApiMethodSignatureOptions } from './ApiMethodSignature';\r\nimport { ApiProperty, IApiPropertyOptions } from './ApiProperty';\r\nimport { ApiEnumMember, IApiEnumMemberOptions, IApiEnumMemberJson } from './ApiEnumMember';\r\nimport { ApiEnum, IApiEnumOptions } from './ApiEnum';\r\nimport { IApiPropertyItemJson } from '../items/ApiPropertyItem';\r\nimport { ApiConstructor, IApiConstructorOptions } from './ApiConstructor';\r\nimport { ApiConstructSignature, IApiConstructSignatureOptions } from './ApiConstructSignature';\r\nimport { ApiFunction, IApiFunctionOptions } from './ApiFunction';\r\nimport { ApiCallSignature, IApiCallSignatureOptions } from './ApiCallSignature';\r\nimport { ApiIndexSignature, IApiIndexSignatureOptions } from './ApiIndexSignature';\r\nimport { ApiTypeAlias, IApiTypeAliasOptions, IApiTypeAliasJson } from './ApiTypeAlias';\r\nimport { ApiVariable, IApiVariableOptions, IApiVariableJson } from './ApiVariable';\r\nimport { IApiDeclaredItemJson } from '../items/ApiDeclaredItem';\r\nimport { DeserializerContext } from './DeserializerContext';\r\n\r\nexport class Deserializer {\r\n  public static deserialize(context: DeserializerContext, jsonObject: IApiItemJson): ApiItem {\r\n    const options: Partial<IApiItemOptions> = {};\r\n\r\n    switch (jsonObject.kind) {\r\n      case ApiItemKind.Class:\r\n        ApiClass.onDeserializeInto(options, context, jsonObject as IApiClassJson);\r\n        return new ApiClass(options as IApiClassOptions);\r\n      case ApiItemKind.CallSignature:\r\n        ApiCallSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiCallSignature(options as IApiCallSignatureOptions);\r\n      case ApiItemKind.Constructor:\r\n        ApiConstructor.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiConstructor(options as IApiConstructorOptions);\r\n      case ApiItemKind.ConstructSignature:\r\n        ApiConstructSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiConstructSignature(options as IApiConstructSignatureOptions);\r\n      case ApiItemKind.EntryPoint:\r\n        ApiEntryPoint.onDeserializeInto(options, context, jsonObject);\r\n        return new ApiEntryPoint(options as IApiEntryPointOptions);\r\n      case ApiItemKind.Enum:\r\n        ApiEnum.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiEnum(options as IApiEnumOptions);\r\n      case ApiItemKind.EnumMember:\r\n        ApiEnumMember.onDeserializeInto(options, context, jsonObject as IApiEnumMemberJson);\r\n        return new ApiEnumMember(options as IApiEnumMemberOptions);\r\n      case ApiItemKind.Function:\r\n        ApiFunction.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiFunction(options as IApiFunctionOptions);\r\n      case ApiItemKind.IndexSignature:\r\n        ApiIndexSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiIndexSignature(options as IApiIndexSignatureOptions);\r\n      case ApiItemKind.Interface:\r\n        ApiInterface.onDeserializeInto(options, context, jsonObject as IApiInterfaceJson);\r\n        return new ApiInterface(options as IApiInterfaceOptions);\r\n      case ApiItemKind.Method:\r\n        ApiMethod.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiMethod(options as IApiMethodOptions);\r\n      case ApiItemKind.MethodSignature:\r\n        ApiMethodSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiMethodSignature(options as IApiMethodSignatureOptions);\r\n      case ApiItemKind.Model:\r\n        return new ApiModel();\r\n      case ApiItemKind.Namespace:\r\n        ApiNamespace.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiNamespace(options as IApiNamespaceOptions);\r\n      case ApiItemKind.Package:\r\n        ApiPackage.onDeserializeInto(options, context, jsonObject);\r\n        return new ApiPackage(options as IApiPackageOptions);\r\n      case ApiItemKind.Property:\r\n        ApiProperty.onDeserializeInto(options, context, jsonObject as IApiPropertyItemJson);\r\n        return new ApiProperty(options as IApiPropertyOptions);\r\n      case ApiItemKind.PropertySignature:\r\n        ApiPropertySignature.onDeserializeInto(options, context, jsonObject as IApiPropertyItemJson);\r\n        return new ApiPropertySignature(options as IApiPropertySignatureOptions);\r\n      case ApiItemKind.TypeAlias:\r\n        ApiTypeAlias.onDeserializeInto(options, context, jsonObject as IApiTypeAliasJson);\r\n        return new ApiTypeAlias(options as IApiTypeAliasOptions);\r\n      case ApiItemKind.Variable:\r\n        ApiVariable.onDeserializeInto(options, context, jsonObject as IApiVariableJson);\r\n        return new ApiVariable(options as IApiVariableOptions);\r\n      default:\r\n        throw new Error(`Failed to deserialize unsupported API item type ${JSON.stringify(jsonObject.kind)}`);\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Deserializer.js","sourceRoot":"","sources":["../../src/model/Deserializer.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport { IApiItemJson, IApiItemOptions, ApiItem, ApiItemKind } from '../items/ApiItem';\r\nimport { ApiClass, IApiClassOptions, IApiClassJson } from './ApiClass';\r\nimport { ApiEntryPoint, IApiEntryPointOptions } from './ApiEntryPoint';\r\nimport { ApiMethod, IApiMethodOptions } from './ApiMethod';\r\nimport { ApiModel } from './ApiModel';\r\nimport { ApiNamespace, IApiNamespaceOptions } from './ApiNamespace';\r\nimport { ApiPackage, IApiPackageOptions } from './ApiPackage';\r\nimport { ApiInterface, IApiInterfaceOptions, IApiInterfaceJson } from './ApiInterface';\r\nimport { ApiPropertySignature, IApiPropertySignatureOptions } from './ApiPropertySignature';\r\nimport { ApiMethodSignature, IApiMethodSignatureOptions } from './ApiMethodSignature';\r\nimport { ApiProperty, IApiPropertyOptions } from './ApiProperty';\r\nimport { ApiEnumMember, IApiEnumMemberOptions, IApiEnumMemberJson } from './ApiEnumMember';\r\nimport { ApiEnum, IApiEnumOptions } from './ApiEnum';\r\nimport { IApiPropertyItemJson } from '../items/ApiPropertyItem';\r\nimport { ApiConstructor, IApiConstructorOptions } from './ApiConstructor';\r\nimport { ApiConstructSignature, IApiConstructSignatureOptions } from './ApiConstructSignature';\r\nimport { ApiFunction, IApiFunctionOptions } from './ApiFunction';\r\nimport { ApiCallSignature, IApiCallSignatureOptions } from './ApiCallSignature';\r\nimport { ApiIndexSignature, IApiIndexSignatureOptions } from './ApiIndexSignature';\r\nimport { ApiTypeAlias, IApiTypeAliasOptions, IApiTypeAliasJson } from './ApiTypeAlias';\r\nimport { ApiVariable, IApiVariableOptions, IApiVariableJson } from './ApiVariable';\r\nimport { IApiDeclaredItemJson } from '../items/ApiDeclaredItem';\r\nimport { DeserializerContext } from './DeserializerContext';\r\n\r\nexport class Deserializer {\r\n  public static deserialize(context: DeserializerContext, jsonObject: IApiItemJson): ApiItem {\r\n    const options: Partial<IApiItemOptions> = {};\r\n\r\n    switch (jsonObject.kind) {\r\n      case ApiItemKind.Class:\r\n        ApiClass.onDeserializeInto(options, context, jsonObject as IApiClassJson);\r\n        return new ApiClass(options as IApiClassOptions);\r\n      case ApiItemKind.CallSignature:\r\n        ApiCallSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiCallSignature(options as IApiCallSignatureOptions);\r\n      case ApiItemKind.Constructor:\r\n        ApiConstructor.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiConstructor(options as IApiConstructorOptions);\r\n      case ApiItemKind.ConstructSignature:\r\n        ApiConstructSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiConstructSignature(options as IApiConstructSignatureOptions);\r\n      case ApiItemKind.EntryPoint:\r\n        ApiEntryPoint.onDeserializeInto(options, context, jsonObject);\r\n        return new ApiEntryPoint(options as IApiEntryPointOptions);\r\n      case ApiItemKind.Enum:\r\n        ApiEnum.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiEnum(options as IApiEnumOptions);\r\n      case ApiItemKind.EnumMember:\r\n        ApiEnumMember.onDeserializeInto(options, context, jsonObject as IApiEnumMemberJson);\r\n        return new ApiEnumMember(options as IApiEnumMemberOptions);\r\n      case ApiItemKind.Function:\r\n        ApiFunction.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiFunction(options as IApiFunctionOptions);\r\n      case ApiItemKind.IndexSignature:\r\n        ApiIndexSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiIndexSignature(options as IApiIndexSignatureOptions);\r\n      case ApiItemKind.Interface:\r\n        ApiInterface.onDeserializeInto(options, context, jsonObject as IApiInterfaceJson);\r\n        return new ApiInterface(options as IApiInterfaceOptions);\r\n      case ApiItemKind.Method:\r\n        ApiMethod.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiMethod(options as IApiMethodOptions);\r\n      case ApiItemKind.MethodSignature:\r\n        ApiMethodSignature.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiMethodSignature(options as IApiMethodSignatureOptions);\r\n      case ApiItemKind.Model:\r\n        return new ApiModel();\r\n      case ApiItemKind.Namespace:\r\n        ApiNamespace.onDeserializeInto(options, context, jsonObject as IApiDeclaredItemJson);\r\n        return new ApiNamespace(options as IApiNamespaceOptions);\r\n      case ApiItemKind.Package:\r\n        ApiPackage.onDeserializeInto(options, context, jsonObject);\r\n        return new ApiPackage(options as IApiPackageOptions);\r\n      case ApiItemKind.Property:\r\n        ApiProperty.onDeserializeInto(options, context, jsonObject as IApiPropertyItemJson);\r\n        return new ApiProperty(options as IApiPropertyOptions);\r\n      case ApiItemKind.PropertySignature:\r\n        ApiPropertySignature.onDeserializeInto(options, context, jsonObject as IApiPropertyItemJson);\r\n        return new ApiPropertySignature(options as IApiPropertySignatureOptions);\r\n      case ApiItemKind.TypeAlias:\r\n        ApiTypeAlias.onDeserializeInto(options, context, jsonObject as IApiTypeAliasJson);\r\n        return new ApiTypeAlias(options as IApiTypeAliasOptions);\r\n      case ApiItemKind.Variable:\r\n        ApiVariable.onDeserializeInto(options, context, jsonObject as IApiVariableJson);\r\n        return new ApiVariable(options as IApiVariableOptions);\r\n      default:\r\n        throw new Error(`Failed to deserialize unsupported API item type ${JSON.stringify(jsonObject.kind)}`);\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/model/ModelReferenceResolver.js

@@ -3,6 +3,7 @@
 // See LICENSE in the project root for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ModelReferenceResolver = void 0;
+const ApiItem_1 = require("../items/ApiItem");
 const ApiItemContainerMixin_1 = require("../mixins/ApiItemContainerMixin");
 const ApiParameterListMixin_1 = require("../mixins/ApiParameterListMixin");
 /**
@@ -110,25 +111,25 @@ class ModelReferenceResolver {
         let selectorItemKind;
         switch (selectorName) {
             case 'class':
-                selectorItemKind = "Class" /* Class */;
+                selectorItemKind = ApiItem_1.ApiItemKind.Class;
                 break;
             case 'enum':
-                selectorItemKind = "Enum" /* Enum */;
+                selectorItemKind = ApiItem_1.ApiItemKind.Enum;
                 break;
             case 'function':
-                selectorItemKind = "Function" /* Function */;
+                selectorItemKind = ApiItem_1.ApiItemKind.Function;
                 break;
             case 'interface':
-                selectorItemKind = "Interface" /* Interface */;
+                selectorItemKind = ApiItem_1.ApiItemKind.Interface;
                 break;
             case 'namespace':
-                selectorItemKind = "Namespace" /* Namespace */;
+                selectorItemKind = ApiItem_1.ApiItemKind.Namespace;
                 break;
             case 'type':
-                selectorItemKind = "TypeAlias" /* TypeAlias */;
+                selectorItemKind = ApiItem_1.ApiItemKind.TypeAlias;
                 break;
             case 'variable':
-                selectorItemKind = "Variable" /* Variable */;
+                selectorItemKind = ApiItem_1.ApiItemKind.Variable;
                 break;
             default:
                 result.errorMessage = `Unsupported system selector "${selectorName}"`;

package/lib/model/ModelReferenceResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModelReferenceResolver.js","sourceRoot":"","sources":["../../src/model/ModelReferenceResolver.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport { DocDeclarationReference, DocMemberSelector, SelectorKind } from '@microsoft/tsdoc';\r\nimport { ApiItem, ApiItemKind } from '../items/ApiItem';\r\nimport { ApiModel } from './ApiModel';\r\nimport { ApiPackage } from './ApiPackage';\r\nimport { ApiEntryPoint } from './ApiEntryPoint';\r\nimport { ApiItemContainerMixin } from '../mixins/ApiItemContainerMixin';\r\nimport { ApiParameterListMixin } from '../mixins/ApiParameterListMixin';\r\n\r\n/**\r\n * Result object for {@link ApiModel.resolveDeclarationReference}.\r\n *\r\n * @public\r\n */\r\nexport interface IResolveDeclarationReferenceResult {\r\n  /**\r\n   * The referenced ApiItem, if the declaration reference could be resolved.\r\n   */\r\n  resolvedApiItem: ApiItem | undefined;\r\n\r\n  /**\r\n   * If resolvedApiItem is undefined, then this will always contain an error message explaining why the\r\n   * resolution failed.\r\n   */\r\n  errorMessage: string | undefined;\r\n}\r\n\r\n/**\r\n * This resolves a TSDoc declaration reference by walking the `ApiModel` hierarchy.\r\n *\r\n * @remarks\r\n *\r\n * This class is analogous to `AstReferenceResolver` from the `@microsoft/api-extractor` project,\r\n * which resolves declaration references by walking the compiler state.\r\n */\r\nexport class ModelReferenceResolver {\r\n  private readonly _apiModel: ApiModel;\r\n\r\n  public constructor(apiModel: ApiModel) {\r\n    this._apiModel = apiModel;\r\n  }\r\n\r\n  public resolve(\r\n    declarationReference: DocDeclarationReference,\r\n    contextApiItem: ApiItem | undefined\r\n  ): IResolveDeclarationReferenceResult {\r\n    const result: IResolveDeclarationReferenceResult = {\r\n      resolvedApiItem: undefined,\r\n      errorMessage: undefined\r\n    };\r\n\r\n    let apiPackage: ApiPackage | undefined = undefined;\r\n\r\n    // Is this an absolute reference?\r\n    if (declarationReference.packageName !== undefined) {\r\n      apiPackage = this._apiModel.tryGetPackageByName(declarationReference.packageName);\r\n      if (apiPackage === undefined) {\r\n        result.errorMessage = `The package \"${declarationReference.packageName}\" could not be located`;\r\n        return result;\r\n      }\r\n    } else {\r\n      // If the package name is omitted, try to infer it from the context\r\n      if (contextApiItem !== undefined) {\r\n        apiPackage = contextApiItem.getAssociatedPackage();\r\n      }\r\n\r\n      if (apiPackage === undefined) {\r\n        result.errorMessage =\r\n          `The reference does not include a package name, and the package could not be inferred` +\r\n          ` from the context`;\r\n        return result;\r\n      }\r\n    }\r\n\r\n    const importPath: string = declarationReference.importPath || '';\r\n\r\n    const foundEntryPoints: ReadonlyArray<ApiEntryPoint> = apiPackage.findEntryPointsByPath(importPath);\r\n    if (foundEntryPoints.length !== 1) {\r\n      result.errorMessage = `The import path \"${importPath}\" could not be resolved`;\r\n      return result;\r\n    }\r\n\r\n    let currentItem: ApiItem = foundEntryPoints[0];\r\n\r\n    // Now search for the member reference\r\n    for (const memberReference of declarationReference.memberReferences) {\r\n      if (memberReference.memberSymbol !== undefined) {\r\n        result.errorMessage = `Symbols are not yet supported in declaration references`;\r\n        return result;\r\n      }\r\n\r\n      if (memberReference.memberIdentifier === undefined) {\r\n        result.errorMessage = `Missing member identifier`;\r\n        return result;\r\n      }\r\n\r\n      const identifier: string = memberReference.memberIdentifier.identifier;\r\n\r\n      if (!ApiItemContainerMixin.isBaseClassOf(currentItem)) {\r\n        // For example, {@link MyClass.myMethod.X} is invalid because methods cannot contain members\r\n        result.errorMessage = `Unable to resolve ${JSON.stringify(\r\n          identifier\r\n        )} because ${currentItem.getScopedNameWithinPackage()} cannot act as a container`;\r\n        return result;\r\n      }\r\n\r\n      const foundMembers: ReadonlyArray<ApiItem> = currentItem.findMembersByName(identifier);\r\n      if (foundMembers.length === 0) {\r\n        result.errorMessage = `The member reference ${JSON.stringify(identifier)} was not found`;\r\n        return result;\r\n      }\r\n\r\n      const memberSelector: DocMemberSelector | undefined = memberReference.selector;\r\n      if (memberSelector === undefined) {\r\n        if (foundMembers.length > 1) {\r\n          result.errorMessage = `The member reference ${JSON.stringify(identifier)} was ambiguous`;\r\n          return result;\r\n        }\r\n        currentItem = foundMembers[0];\r\n      } else {\r\n        let memberSelectorResult: IResolveDeclarationReferenceResult;\r\n        switch (memberSelector.selectorKind) {\r\n          case SelectorKind.System:\r\n            memberSelectorResult = this._selectUsingSystemSelector(foundMembers, memberSelector, identifier);\r\n            break;\r\n          case SelectorKind.Index:\r\n            memberSelectorResult = this._selectUsingIndexSelector(foundMembers, memberSelector, identifier);\r\n            break;\r\n          default:\r\n            result.errorMessage = `The selector \"${memberSelector.selector}\" is not a supported selector type`;\r\n            return result;\r\n        }\r\n        if (memberSelectorResult.resolvedApiItem === undefined) {\r\n          return memberSelectorResult;\r\n        }\r\n        currentItem = memberSelectorResult.resolvedApiItem;\r\n      }\r\n    }\r\n    result.resolvedApiItem = currentItem;\r\n    return result;\r\n  }\r\n\r\n  private _selectUsingSystemSelector(\r\n    foundMembers: ReadonlyArray<ApiItem>,\r\n    memberSelector: DocMemberSelector,\r\n    identifier: string\r\n  ): IResolveDeclarationReferenceResult {\r\n    const result: IResolveDeclarationReferenceResult = {\r\n      resolvedApiItem: undefined,\r\n      errorMessage: undefined\r\n    };\r\n\r\n    const selectorName: string = memberSelector.selector;\r\n\r\n    let selectorItemKind: ApiItemKind;\r\n    switch (selectorName) {\r\n      case 'class':\r\n        selectorItemKind = ApiItemKind.Class;\r\n        break;\r\n      case 'enum':\r\n        selectorItemKind = ApiItemKind.Enum;\r\n        break;\r\n      case 'function':\r\n        selectorItemKind = ApiItemKind.Function;\r\n        break;\r\n      case 'interface':\r\n        selectorItemKind = ApiItemKind.Interface;\r\n        break;\r\n      case 'namespace':\r\n        selectorItemKind = ApiItemKind.Namespace;\r\n        break;\r\n      case 'type':\r\n        selectorItemKind = ApiItemKind.TypeAlias;\r\n        break;\r\n      case 'variable':\r\n        selectorItemKind = ApiItemKind.Variable;\r\n        break;\r\n      default:\r\n        result.errorMessage = `Unsupported system selector \"${selectorName}\"`;\r\n        return result;\r\n    }\r\n\r\n    const matches: ApiItem[] = foundMembers.filter((x) => x.kind === selectorItemKind);\r\n    if (matches.length === 0) {\r\n      result.errorMessage =\r\n        `A declaration for \"${identifier}\" was not found that matches the` +\r\n        ` TSDoc selector \"${selectorName}\"`;\r\n      return result;\r\n    }\r\n    if (matches.length > 1) {\r\n      result.errorMessage = `More than one declaration \"${identifier}\" matches the TSDoc selector \"${selectorName}\"`;\r\n    }\r\n    result.resolvedApiItem = matches[0];\r\n    return result;\r\n  }\r\n\r\n  private _selectUsingIndexSelector(\r\n    foundMembers: ReadonlyArray<ApiItem>,\r\n    memberSelector: DocMemberSelector,\r\n    identifier: string\r\n  ): IResolveDeclarationReferenceResult {\r\n    const result: IResolveDeclarationReferenceResult = {\r\n      resolvedApiItem: undefined,\r\n      errorMessage: undefined\r\n    };\r\n\r\n    const selectedMembers: ApiItem[] = [];\r\n\r\n    const selectorOverloadIndex: number = parseInt(memberSelector.selector);\r\n    for (const foundMember of foundMembers) {\r\n      if (ApiParameterListMixin.isBaseClassOf(foundMember)) {\r\n        if (foundMember.overloadIndex === selectorOverloadIndex) {\r\n          selectedMembers.push(foundMember);\r\n        }\r\n      }\r\n    }\r\n\r\n    if (selectedMembers.length === 0) {\r\n      result.errorMessage =\r\n        `An overload for ${JSON.stringify(identifier)} was not found that matches` +\r\n        ` the TSDoc selector \":${selectorOverloadIndex}\"`;\r\n      return result;\r\n    }\r\n\r\n    if (selectedMembers.length === 1) {\r\n      result.resolvedApiItem = selectedMembers[0];\r\n      return result;\r\n    }\r\n\r\n    result.errorMessage = `The member reference ${JSON.stringify(identifier)} was ambiguous`;\r\n    return result;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ModelReferenceResolver.js","sourceRoot":"","sources":["../../src/model/ModelReferenceResolver.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport { DocDeclarationReference, DocMemberSelector, SelectorKind } from '@microsoft/tsdoc';\r\nimport { ApiItem, ApiItemKind } from '../items/ApiItem';\r\nimport { ApiModel } from './ApiModel';\r\nimport { ApiPackage } from './ApiPackage';\r\nimport { ApiEntryPoint } from './ApiEntryPoint';\r\nimport { ApiItemContainerMixin } from '../mixins/ApiItemContainerMixin';\r\nimport { ApiParameterListMixin } from '../mixins/ApiParameterListMixin';\r\n\r\n/**\r\n * Result object for {@link ApiModel.resolveDeclarationReference}.\r\n *\r\n * @public\r\n */\r\nexport interface IResolveDeclarationReferenceResult {\r\n  /**\r\n   * The referenced ApiItem, if the declaration reference could be resolved.\r\n   */\r\n  resolvedApiItem: ApiItem | undefined;\r\n\r\n  /**\r\n   * If resolvedApiItem is undefined, then this will always contain an error message explaining why the\r\n   * resolution failed.\r\n   */\r\n  errorMessage: string | undefined;\r\n}\r\n\r\n/**\r\n * This resolves a TSDoc declaration reference by walking the `ApiModel` hierarchy.\r\n *\r\n * @remarks\r\n *\r\n * This class is analogous to `AstReferenceResolver` from the `@microsoft/api-extractor` project,\r\n * which resolves declaration references by walking the compiler state.\r\n */\r\nexport class ModelReferenceResolver {\r\n  private readonly _apiModel: ApiModel;\r\n\r\n  public constructor(apiModel: ApiModel) {\r\n    this._apiModel = apiModel;\r\n  }\r\n\r\n  public resolve(\r\n    declarationReference: DocDeclarationReference,\r\n    contextApiItem: ApiItem | undefined\r\n  ): IResolveDeclarationReferenceResult {\r\n    const result: IResolveDeclarationReferenceResult = {\r\n      resolvedApiItem: undefined,\r\n      errorMessage: undefined\r\n    };\r\n\r\n    let apiPackage: ApiPackage | undefined = undefined;\r\n\r\n    // Is this an absolute reference?\r\n    if (declarationReference.packageName !== undefined) {\r\n      apiPackage = this._apiModel.tryGetPackageByName(declarationReference.packageName);\r\n      if (apiPackage === undefined) {\r\n        result.errorMessage = `The package \"${declarationReference.packageName}\" could not be located`;\r\n        return result;\r\n      }\r\n    } else {\r\n      // If the package name is omitted, try to infer it from the context\r\n      if (contextApiItem !== undefined) {\r\n        apiPackage = contextApiItem.getAssociatedPackage();\r\n      }\r\n\r\n      if (apiPackage === undefined) {\r\n        result.errorMessage =\r\n          `The reference does not include a package name, and the package could not be inferred` +\r\n          ` from the context`;\r\n        return result;\r\n      }\r\n    }\r\n\r\n    const importPath: string = declarationReference.importPath || '';\r\n\r\n    const foundEntryPoints: ReadonlyArray<ApiEntryPoint> = apiPackage.findEntryPointsByPath(importPath);\r\n    if (foundEntryPoints.length !== 1) {\r\n      result.errorMessage = `The import path \"${importPath}\" could not be resolved`;\r\n      return result;\r\n    }\r\n\r\n    let currentItem: ApiItem = foundEntryPoints[0];\r\n\r\n    // Now search for the member reference\r\n    for (const memberReference of declarationReference.memberReferences) {\r\n      if (memberReference.memberSymbol !== undefined) {\r\n        result.errorMessage = `Symbols are not yet supported in declaration references`;\r\n        return result;\r\n      }\r\n\r\n      if (memberReference.memberIdentifier === undefined) {\r\n        result.errorMessage = `Missing member identifier`;\r\n        return result;\r\n      }\r\n\r\n      const identifier: string = memberReference.memberIdentifier.identifier;\r\n\r\n      if (!ApiItemContainerMixin.isBaseClassOf(currentItem)) {\r\n        // For example, {@link MyClass.myMethod.X} is invalid because methods cannot contain members\r\n        result.errorMessage = `Unable to resolve ${JSON.stringify(\r\n          identifier\r\n        )} because ${currentItem.getScopedNameWithinPackage()} cannot act as a container`;\r\n        return result;\r\n      }\r\n\r\n      const foundMembers: ReadonlyArray<ApiItem> = currentItem.findMembersByName(identifier);\r\n      if (foundMembers.length === 0) {\r\n        result.errorMessage = `The member reference ${JSON.stringify(identifier)} was not found`;\r\n        return result;\r\n      }\r\n\r\n      const memberSelector: DocMemberSelector | undefined = memberReference.selector;\r\n      if (memberSelector === undefined) {\r\n        if (foundMembers.length > 1) {\r\n          result.errorMessage = `The member reference ${JSON.stringify(identifier)} was ambiguous`;\r\n          return result;\r\n        }\r\n        currentItem = foundMembers[0];\r\n      } else {\r\n        let memberSelectorResult: IResolveDeclarationReferenceResult;\r\n        switch (memberSelector.selectorKind) {\r\n          case SelectorKind.System:\r\n            memberSelectorResult = this._selectUsingSystemSelector(foundMembers, memberSelector, identifier);\r\n            break;\r\n          case SelectorKind.Index:\r\n            memberSelectorResult = this._selectUsingIndexSelector(foundMembers, memberSelector, identifier);\r\n            break;\r\n          default:\r\n            result.errorMessage = `The selector \"${memberSelector.selector}\" is not a supported selector type`;\r\n            return result;\r\n        }\r\n        if (memberSelectorResult.resolvedApiItem === undefined) {\r\n          return memberSelectorResult;\r\n        }\r\n        currentItem = memberSelectorResult.resolvedApiItem;\r\n      }\r\n    }\r\n    result.resolvedApiItem = currentItem;\r\n    return result;\r\n  }\r\n\r\n  private _selectUsingSystemSelector(\r\n    foundMembers: ReadonlyArray<ApiItem>,\r\n    memberSelector: DocMemberSelector,\r\n    identifier: string\r\n  ): IResolveDeclarationReferenceResult {\r\n    const result: IResolveDeclarationReferenceResult = {\r\n      resolvedApiItem: undefined,\r\n      errorMessage: undefined\r\n    };\r\n\r\n    const selectorName: string = memberSelector.selector;\r\n\r\n    let selectorItemKind: ApiItemKind;\r\n    switch (selectorName) {\r\n      case 'class':\r\n        selectorItemKind = ApiItemKind.Class;\r\n        break;\r\n      case 'enum':\r\n        selectorItemKind = ApiItemKind.Enum;\r\n        break;\r\n      case 'function':\r\n        selectorItemKind = ApiItemKind.Function;\r\n        break;\r\n      case 'interface':\r\n        selectorItemKind = ApiItemKind.Interface;\r\n        break;\r\n      case 'namespace':\r\n        selectorItemKind = ApiItemKind.Namespace;\r\n        break;\r\n      case 'type':\r\n        selectorItemKind = ApiItemKind.TypeAlias;\r\n        break;\r\n      case 'variable':\r\n        selectorItemKind = ApiItemKind.Variable;\r\n        break;\r\n      default:\r\n        result.errorMessage = `Unsupported system selector \"${selectorName}\"`;\r\n        return result;\r\n    }\r\n\r\n    const matches: ApiItem[] = foundMembers.filter((x) => x.kind === selectorItemKind);\r\n    if (matches.length === 0) {\r\n      result.errorMessage =\r\n        `A declaration for \"${identifier}\" was not found that matches the` +\r\n        ` TSDoc selector \"${selectorName}\"`;\r\n      return result;\r\n    }\r\n    if (matches.length > 1) {\r\n      result.errorMessage = `More than one declaration \"${identifier}\" matches the TSDoc selector \"${selectorName}\"`;\r\n    }\r\n    result.resolvedApiItem = matches[0];\r\n    return result;\r\n  }\r\n\r\n  private _selectUsingIndexSelector(\r\n    foundMembers: ReadonlyArray<ApiItem>,\r\n    memberSelector: DocMemberSelector,\r\n    identifier: string\r\n  ): IResolveDeclarationReferenceResult {\r\n    const result: IResolveDeclarationReferenceResult = {\r\n      resolvedApiItem: undefined,\r\n      errorMessage: undefined\r\n    };\r\n\r\n    const selectedMembers: ApiItem[] = [];\r\n\r\n    const selectorOverloadIndex: number = parseInt(memberSelector.selector);\r\n    for (const foundMember of foundMembers) {\r\n      if (ApiParameterListMixin.isBaseClassOf(foundMember)) {\r\n        if (foundMember.overloadIndex === selectorOverloadIndex) {\r\n          selectedMembers.push(foundMember);\r\n        }\r\n      }\r\n    }\r\n\r\n    if (selectedMembers.length === 0) {\r\n      result.errorMessage =\r\n        `An overload for ${JSON.stringify(identifier)} was not found that matches` +\r\n        ` the TSDoc selector \":${selectorOverloadIndex}\"`;\r\n      return result;\r\n    }\r\n\r\n    if (selectedMembers.length === 1) {\r\n      result.resolvedApiItem = selectedMembers[0];\r\n      return result;\r\n    }\r\n\r\n    result.errorMessage = `The member reference ${JSON.stringify(identifier)} was ambiguous`;\r\n    return result;\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@microsoft/api-extractor-model",
-	"version": "7.13.18",
+	"version": "7.15.2",
 	"description": "A helper library for loading and saving the .api.json files created by API Extractor",
 	"repository": {
 		"type": "git",
@@ -14,12 +14,12 @@
 	"dependencies": {
 		"@microsoft/tsdoc": "0.13.2",
 		"@microsoft/tsdoc-config": "~0.15.2",
-		"@rushstack/node-core-library": "3.44.1"
+		"@rushstack/node-core-library": "3.44.3"
 	},
 	"devDependencies": {
-		"@rushstack/eslint-config": "2.5.0",
-		"@rushstack/heft": "0.42.3",
-		"@rushstack/heft-node-rig": "1.2.32",
+		"@rushstack/eslint-config": "2.5.1",
+		"@rushstack/heft": "0.43.2",
+		"@rushstack/heft-node-rig": "1.4.3",
 		"@types/heft-jest": "1.0.1",
 		"@types/node": "12.20.24"
 	},