typedoc 0.23.26 → 0.24.0-beta.2

package/dist/lib/models/reflections/declaration.d.ts

@@ -4,8 +4,9 @@ import { type TraverseCallback } from "./abstract";
 import { ContainerReflection } from "./container";
 import type { SignatureReflection } from "./signature";
 import type { TypeParameterReflection } from "./type-parameter";
-import type { Serializer, JSONOutput } from "../../serialization";
-import type { CommentDisplayPart } from "../comments";
+import type { Serializer, JSONOutput, Deserializer } from "../../serialization";
+import { CommentDisplayPart } from "../comments";
+import { SourceReference } from "../sources/file";
 /**
  * Stores hierarchical type data.
  *
@@ -39,9 +40,21 @@ export declare enum ConversionFlags {
  * kind of a reflection is stored in its ´kind´ member.
  */
 export declare class DeclarationReflection extends ContainerReflection {
+    readonly variant: "reference" | "declaration";
+    /**
+     * A list of all source files that contributed to this reflection.
+     */
+    sources?: SourceReference[];
+    /**
+     * A precomputed boost derived from the searchCategoryBoosts and searchGroupBoosts options, used when
+     * boosting search relevance scores at runtime. May be modified by plugins.
+     */
+    relevanceBoost?: number;
     /**
      * The escaped name of this declaration assigned by the TS compiler if there is an associated symbol.
      * This is used to retrieve properties for analyzing inherited members.
+     *
+     * Not serialized, only useful during conversion.
      * @internal
      */
     escapedName?: ts.__String;
@@ -124,12 +137,13 @@ export declare class DeclarationReflection extends ContainerReflection {
     /**
      * The version of the module when found.
      */
-    version?: string;
+    packageVersion?: string;
     /**
      * Flags for information about a reflection which is needed solely during conversion.
      * @internal
      */
     conversionFlags: ConversionFlags;
+    isDeclaration(): this is DeclarationReflection;
     hasGetterOrSetter(): boolean;
     getAllSignatures(): SignatureReflection[];
     /** @internal */
@@ -148,4 +162,5 @@ export declare class DeclarationReflection extends ContainerReflection {
      */
     toString(): string;
     toObject(serializer: Serializer): JSONOutput.DeclarationReflection;
+    fromObject(de: Deserializer, obj: JSONOutput.DeclarationReflection | JSONOutput.ProjectReflection): void;
 }

package/dist/lib/models/reflections/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../../../src/lib/models/reflections/declaration.ts"],"names":[],"mappings":"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"}

package/dist/lib/models/reflections/declaration.js

@@ -4,6 +4,10 @@ exports.DeclarationReflection = exports.ConversionFlags = void 0;
 const types_1 = require("../types");
 const abstract_1 = require("./abstract");
 const container_1 = require("./container");
+const comments_1 = require("../comments");
+const file_1 = require("../sources/file");
+const ReflectionSymbolId_1 = require("./ReflectionSymbolId");
+const kind_1 = require("./kind");
 /**
  * @internal
  */
@@ -21,12 +25,16 @@ var ConversionFlags;
 class DeclarationReflection extends container_1.ContainerReflection {
     constructor() {
         super(...arguments);
+        this.variant = "declaration";
         /**
          * Flags for information about a reflection which is needed solely during conversion.
          * @internal
          */
         this.conversionFlags = ConversionFlags.None;
     }
+    isDeclaration() {
+        return true;
+    }
     hasGetterOrSetter() {
         return !!this.getSignature || !!this.setSignature;
     }
@@ -110,6 +118,10 @@ class DeclarationReflection extends container_1.ContainerReflection {
     toObject(serializer) {
         return {
             ...super.toObject(serializer),
+            variant: this.variant,
+            packageVersion: this.packageVersion,
+            sources: serializer.toObjectsOptional(this.sources),
+            relevanceBoost: this.relevanceBoost === 1 ? undefined : this.relevanceBoost,
             typeParameters: serializer.toObjectsOptional(this.typeParameters),
             type: serializer.toObject(this.type),
             signatures: serializer.toObjectsOptional(this.signatures),
@@ -126,5 +138,46 @@ class DeclarationReflection extends container_1.ContainerReflection {
             implementedBy: serializer.toObjectsOptional(this.implementedBy),
         };
     }
+    fromObject(de, obj) {
+        super.fromObject(de, obj);
+        // This happens when merging multiple projects together.
+        // If updating this, also check ProjectReflection.fromObject.
+        if (obj.variant === "project") {
+            this.kind = kind_1.ReflectionKind.Module;
+            this.packageVersion = obj.packageVersion;
+            if (obj.readme) {
+                this.readme = comments_1.Comment.deserializeDisplayParts(de, obj.readme);
+            }
+            de.defer(() => {
+                for (const [id, sid] of Object.entries(obj.symbolIdMap || {})) {
+                    const refl = this.project.getReflectionById(de.oldIdToNewId[+id] ?? -1);
+                    if (refl) {
+                        this.project.registerSymbolId(refl, new ReflectionSymbolId_1.ReflectionSymbolId(sid));
+                    }
+                    else {
+                        de.logger.warn(`Serialized project contained a reflection with id ${id} but it was not present in deserialized project.`);
+                    }
+                }
+            });
+            return;
+        }
+        this.packageVersion = obj.packageVersion;
+        this.sources = de.reviveMany(obj.sources, (src) => new file_1.SourceReference(src.fileName, src.line, src.character));
+        this.relevanceBoost = obj.relevanceBoost;
+        this.typeParameters = de.reviveMany(obj.typeParameters, (tp) => de.constructReflection(tp));
+        this.type = de.revive(obj.type, (t) => de.constructType(t));
+        this.signatures = de.reviveMany(obj.signatures, (r) => de.constructReflection(r));
+        this.indexSignature = de.revive(obj.indexSignature, (r) => de.constructReflection(r));
+        this.getSignature = de.revive(obj.getSignature, (r) => de.constructReflection(r));
+        this.setSignature = de.revive(obj.setSignature, (r) => de.constructReflection(r));
+        this.defaultValue = obj.defaultValue;
+        this.overwrites = de.reviveType(obj.overwrites);
+        this.inheritedFrom = de.reviveType(obj.inheritedFrom);
+        this.implementationOf = de.reviveType(obj.implementationOf);
+        this.extendedTypes = de.reviveMany(obj.extendedTypes, (t) => de.reviveType(t));
+        this.extendedBy = de.reviveMany(obj.extendedBy, (t) => de.reviveType(t));
+        this.implementedTypes = de.reviveMany(obj.implementedTypes, (t) => de.reviveType(t));
+        this.implementedBy = de.reviveMany(obj.implementedBy, (t) => de.reviveType(t));
+    }
 }
 exports.DeclarationReflection = DeclarationReflection;

package/dist/lib/models/reflections/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../../../src/lib/models/reflections/declaration.ts"],"names":[],"mappings":"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"}

package/dist/lib/models/reflections/id.d.ts

@@ -0,0 +1,30 @@
+import ts from "typescript";
+import type { JSONOutput, Serializer } from "../../serialization/index";
+/**
+ * See {@link ReflectionSymbolId}
+ */
+export type ReflectionSymbolIdString = string & {
+    readonly __reflectionSymbolId: unique symbol;
+};
+/**
+ * This exists so that TypeDoc can store a unique identifier for a `ts.Symbol` without
+ * keeping a reference to the `ts.Symbol` itself. This identifier should be stable across
+ * runs so long as the symbol is exported from the same file.
+ */
+export declare class ReflectionSymbolId {
+    readonly fileName: string;
+    readonly qualifiedName: string;
+    /**
+     * Note: This is **not** serialized. It exists for sorting by declaration order, but
+     * should not be needed when deserializing from JSON.
+     */
+    pos: number;
+    constructor(symbol: ts.Symbol, declaration?: ts.Declaration);
+    constructor(json: JSONOutput.ReflectionSymbolId);
+    getStableKey(): ReflectionSymbolIdString;
+    toObject(serializer: Serializer): {
+        sourceFileName: string;
+        qualifiedName: string;
+    };
+}
+//# sourceMappingURL=id.d.ts.map

package/dist/lib/models/reflections/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../src/lib/models/reflections/id.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGxE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,MAAM,CAAC;CAChD,CAAC;AAEF;;;;GAIG;AACH,qBAAa,kBAAkB;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;gBAEA,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW;gBAC/C,IAAI,EAAE,UAAU,CAAC,kBAAkB;IAqB/C,YAAY,IAAI,wBAAwB;IAQxC,QAAQ,CAAC,UAAU,EAAE,UAAU;;;;CAQlC"}

package/dist/lib/models/reflections/id.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReflectionSymbolId = void 0;
+const path_1 = require("path");
+const typescript_1 = __importDefault(require("typescript"));
+const tsutils_1 = require("../../utils/tsutils");
+/**
+ * This exists so that TypeDoc can store a unique identifier for a `ts.Symbol` without
+ * keeping a reference to the `ts.Symbol` itself. This identifier should be stable across
+ * runs so long as the symbol is exported from the same file.
+ */
+class ReflectionSymbolId {
+    constructor(symbol, declaration) {
+        if ("name" in symbol) {
+            declaration ?? (declaration = symbol?.declarations?.[0]);
+            this.fileName = declaration?.getSourceFile().fileName ?? "\0";
+            if (symbol.declarations?.some(typescript_1.default.isSourceFile)) {
+                this.qualifiedName = "";
+            }
+            else {
+                this.qualifiedName = (0, tsutils_1.getQualifiedName)(symbol, symbol.name);
+            }
+            this.pos = declaration?.pos ?? Infinity;
+        }
+        else {
+            this.fileName = symbol.sourceFileName;
+            this.qualifiedName = symbol.qualifiedName;
+            this.pos = Infinity;
+        }
+    }
+    getStableKey() {
+        if (Number.isFinite(this.pos)) {
+            return `${this.fileName}\0${this.qualifiedName}\0${this.pos}`;
+        }
+        else {
+            return `${this.fileName}\0${this.qualifiedName}`;
+        }
+    }
+    toObject(serializer) {
+        return {
+            sourceFileName: (0, path_1.isAbsolute)(this.fileName)
+                ? (0, path_1.relative)(serializer.projectRoot, this.fileName)
+                : this.fileName,
+            qualifiedName: this.qualifiedName,
+        };
+    }
+}
+exports.ReflectionSymbolId = ReflectionSymbolId;
+//# sourceMappingURL=id.js.map

package/dist/lib/models/reflections/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../src/lib/models/reflections/id.ts"],"names":[],"mappings":";;;;;;AAAA,+BAA4C;AAC5C,4DAA4B;AAE5B,iDAAuD;AASvD;;;;GAIG;AACH,MAAa,kBAAkB;IAW3B,YACI,MAAiD,EACjD,WAA4B;QAE5B,IAAI,MAAM,IAAI,MAAM,EAAE;YAClB,WAAW,KAAX,WAAW,GAAK,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAC;YAC1C,IAAI,CAAC,QAAQ,GAAG,WAAW,EAAE,aAAa,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC;YAC9D,IAAI,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,oBAAE,CAAC,YAAY,CAAC,EAAE;gBAC5C,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;aAC3B;iBAAM;gBACH,IAAI,CAAC,aAAa,GAAG,IAAA,0BAAgB,EAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;aAC9D;YACD,IAAI,CAAC,GAAG,GAAG,WAAW,EAAE,GAAG,IAAI,QAAQ,CAAC;SAC3C;aAAM;YACH,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC;YACtC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;YAC1C,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC;SACvB;IACL,CAAC;IAED,YAAY;QACR,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC3B,OAAO,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,GAAG,EAA8B,CAAC;SAC7F;aAAM;YACH,OAAO,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,aAAa,EAA8B,CAAC;SAChF;IACL,CAAC;IAED,QAAQ,CAAC,UAAsB;QAC3B,OAAO;YACH,cAAc,EAAE,IAAA,iBAAU,EAAC,IAAI,CAAC,QAAQ,CAAC;gBACrC,CAAC,CAAC,IAAA,eAAQ,EAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC;gBACjD,CAAC,CAAC,IAAI,CAAC,QAAQ;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa;SACpC,CAAC;IACN,CAAC;CACJ;AA/CD,gDA+CC"}

package/dist/lib/models/reflections/index.d.ts

@@ -10,3 +10,5 @@ export { ReferenceReflection } from "./reference";
 export { SignatureReflection } from "./signature";
 export { TypeParameterReflection, VarianceModifier } from "./type-parameter";
 export { splitUnquotedString } from "./utils";
+export type { ReflectionVariant } from "./variant";
+export { ReflectionSymbolId, type ReflectionSymbolIdString, } from "./ReflectionSymbolId";

package/dist/lib/models/reflections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/models/reflections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EACH,kBAAkB,EAClB,KAAK,wBAAwB,GAChC,MAAM,sBAAsB,CAAC"}

package/dist/lib/models/reflections/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.splitUnquotedString = exports.VarianceModifier = exports.TypeParameterReflection = exports.SignatureReflection = exports.ReferenceReflection = exports.ProjectReflection = exports.ParameterReflection = exports.ReflectionKind = exports.ConversionFlags = exports.DeclarationReflection = exports.ContainerReflection = exports.TraverseProperty = exports.ReflectionFlags = exports.ReflectionFlag = exports.Reflection = void 0;
+exports.ReflectionSymbolId = exports.splitUnquotedString = exports.VarianceModifier = exports.TypeParameterReflection = exports.SignatureReflection = exports.ReferenceReflection = exports.ProjectReflection = exports.ParameterReflection = exports.ReflectionKind = exports.ConversionFlags = exports.DeclarationReflection = exports.ContainerReflection = exports.TraverseProperty = exports.ReflectionFlags = exports.ReflectionFlag = exports.Reflection = void 0;
 var abstract_1 = require("./abstract");
 Object.defineProperty(exports, "Reflection", { enumerable: true, get: function () { return abstract_1.Reflection; } });
 Object.defineProperty(exports, "ReflectionFlag", { enumerable: true, get: function () { return abstract_1.ReflectionFlag; } });
@@ -26,3 +26,5 @@ Object.defineProperty(exports, "TypeParameterReflection", { enumerable: true, ge
 Object.defineProperty(exports, "VarianceModifier", { enumerable: true, get: function () { return type_parameter_1.VarianceModifier; } });
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "splitUnquotedString", { enumerable: true, get: function () { return utils_1.splitUnquotedString; } });
+var ReflectionSymbolId_1 = require("./ReflectionSymbolId");
+Object.defineProperty(exports, "ReflectionSymbolId", { enumerable: true, get: function () { return ReflectionSymbolId_1.ReflectionSymbolId; } });

package/dist/lib/models/reflections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/models/reflections/index.ts"],"names":[],"mappings":";;;AAAA,uCAKoB;AAJhB,sGAAA,UAAU,OAAA;AACV,0GAAA,cAAc,OAAA;AACd,2GAAA,eAAe,OAAA;AACf,4GAAA,gBAAgB,OAAA;AAGpB,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,6CAAuE;AAA9D,oHAAA,qBAAqB,OAAA;AAAE,8GAAA,eAAe,OAAA;AAE/C,+BAAwC;AAA/B,sGAAA,cAAc,OAAA;AACvB,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAC1B,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,mDAA6E;AAApE,yHAAA,uBAAuB,OAAA;AAAE,kHAAA,gBAAgB,OAAA;AAClD,iCAA8C;AAArC,4GAAA,mBAAmB,OAAA;AAE5B,2DAG8B;AAF1B,wHAAA,kBAAkB,OAAA"}

package/dist/lib/models/reflections/kind.d.ts

@@ -1,3 +1,4 @@
+import type { EnumKeys } from "../../utils";
 /**
  * Defines the available reflection kinds.
  */
@@ -27,19 +28,30 @@ export declare enum ReflectionKind {
     TypeAlias = 4194304,
     Reference = 8388608
 }
-/** @hidden */
 export declare namespace ReflectionKind {
+    type KindString = EnumKeys<typeof ReflectionKind>;
     const All: number;
+    /** @internal */
     const ClassOrInterface: number;
+    /** @internal */
     const VariableOrProperty: number;
+    /** @internal */
     const FunctionOrMethod: number;
+    /** @internal */
     const ClassMember: number;
+    /** @internal */
     const SomeSignature: number;
+    /** @internal */
     const SomeModule: number;
+    /** @internal */
     const SomeType: number;
+    /** @internal */
     const SomeValue: number;
+    /** @internal */
     const SomeMember: number;
+    /** @internal */
     const SomeExport: number;
+    /** @internal */
     const ExportContainer: number;
     /** @internal */
     const Inheritable: number;
@@ -50,4 +62,6 @@ export declare namespace ReflectionKind {
      * @internal
      */
     const SignatureContainer: number;
+    function singularString(kind: ReflectionKind): string;
+    function pluralString(kind: ReflectionKind): string;
 }

package/dist/lib/models/reflections/kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind.d.ts","sourceRoot":"","sources":["../../../../src/lib/models/reflections/kind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,oBAAY,cAAc;IACtB,OAAO,IAAM;IACb,MAAM,IAAM;IACZ,SAAS,IAAM;IACf,IAAI,IAAM;IACV,UAAU,KAAO;IACjB,QAAQ,KAAO;IACf,QAAQ,KAAO;IACf,KAAK,MAAO;IACZ,SAAS,MAAQ;IACjB,WAAW,MAAQ;IACnB,QAAQ,OAAQ;IAChB,MAAM,OAAQ;IACd,aAAa,OAAS;IACtB,cAAc,OAAS;IACvB,oBAAoB,QAAS;IAC7B,SAAS,QAAS;IAClB,WAAW,QAAU;IACrB,aAAa,SAAU;IACvB,QAAQ,SAAU;IAClB,YAAY,SAAU;IACtB,YAAY,UAAW;IACvB,aAAa,UAAW;IACxB,SAAS,UAAW;IACpB,SAAS,UAAW;CACvB;AAED,yBAAiB,cAAc,CAAC;IAC5B,KAAY,UAAU,GAAG,QAAQ,CAAC,OAAO,cAAc,CAAC,CAAC;IAElD,MAAM,GAAG,QAAmC,CAAC;IAEpD,gBAAgB;IACT,MAAM,gBAAgB,QACsB,CAAC;IACpD,gBAAgB;IACT,MAAM,kBAAkB,QACsB,CAAC;IACtD,gBAAgB;IACT,MAAM,gBAAgB,QACsB,CAAC;IACpD,gBAAgB;IACT,MAAM,WAAW,QAIG,CAAC;IAC5B,gBAAgB;IACT,MAAM,aAAa,QAKK,CAAC;IAChC,gBAAgB;IACT,MAAM,UAAU,QAAmD,CAAC;IAC3E,gBAAgB;IACT,MAAM,QAAQ,QAIO,CAAC;IAC7B,gBAAgB;IACT,MAAM,SAAS,QAGU,CAAC;IACjC,gBAAgB;IACT,MAAM,UAAU,QAII,CAAC;IAC5B,gBAAgB;IACT,MAAM,UAAU,QASK,CAAC;IAC7B,gBAAgB;IACT,MAAM,eAAe,QAC0B,CAAC;IAEvD,gBAAgB;IACT,MAAM,WAAW,QAKM,CAAC;IAE/B,gBAAgB;IACT,MAAM,sBAAsB,QAGV,CAAC;IAE1B;;;OAGG;IACI,MAAM,kBAAkB,QACqB,CAAC;IAerD,SAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAM3D;IAED,SAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAMzD;CACJ"}

package/dist/lib/models/reflections/kind.js

@@ -31,33 +31,42 @@ var ReflectionKind;
     ReflectionKind[ReflectionKind["TypeAlias"] = 4194304] = "TypeAlias";
     ReflectionKind[ReflectionKind["Reference"] = 8388608] = "Reference";
 })(ReflectionKind = exports.ReflectionKind || (exports.ReflectionKind = {}));
-/** @hidden */
 (function (ReflectionKind) {
     ReflectionKind.All = ReflectionKind.Reference * 2 - 1;
+    /** @internal */
     ReflectionKind.ClassOrInterface = ReflectionKind.Class | ReflectionKind.Interface;
+    /** @internal */
     ReflectionKind.VariableOrProperty = ReflectionKind.Variable | ReflectionKind.Property;
+    /** @internal */
     ReflectionKind.FunctionOrMethod = ReflectionKind.Function | ReflectionKind.Method;
+    /** @internal */
     ReflectionKind.ClassMember = ReflectionKind.Accessor |
         ReflectionKind.Constructor |
         ReflectionKind.Method |
         ReflectionKind.Property;
+    /** @internal */
     ReflectionKind.SomeSignature = ReflectionKind.CallSignature |
         ReflectionKind.IndexSignature |
         ReflectionKind.ConstructorSignature |
         ReflectionKind.GetSignature |
         ReflectionKind.SetSignature;
+    /** @internal */
     ReflectionKind.SomeModule = ReflectionKind.Namespace | ReflectionKind.Module;
+    /** @internal */
     ReflectionKind.SomeType = ReflectionKind.Interface |
         ReflectionKind.TypeLiteral |
         ReflectionKind.TypeParameter |
         ReflectionKind.TypeAlias;
+    /** @internal */
     ReflectionKind.SomeValue = ReflectionKind.Variable |
         ReflectionKind.Function |
         ReflectionKind.ObjectLiteral;
+    /** @internal */
     ReflectionKind.SomeMember = ReflectionKind.EnumMember |
         ReflectionKind.Property |
         ReflectionKind.Method |
         ReflectionKind.Accessor;
+    /** @internal */
     ReflectionKind.SomeExport = ReflectionKind.Module |
         ReflectionKind.Namespace |
         ReflectionKind.Enum |
@@ -67,6 +76,7 @@ var ReflectionKind;
         ReflectionKind.Interface |
         ReflectionKind.TypeAlias |
         ReflectionKind.Reference;
+    /** @internal */
     ReflectionKind.ExportContainer = ReflectionKind.SomeModule | ReflectionKind.Project;
     /** @internal */
     ReflectionKind.Inheritable = ReflectionKind.Accessor |
@@ -83,4 +93,36 @@ var ReflectionKind;
      * @internal
      */
     ReflectionKind.SignatureContainer = ReflectionKind.ContainsCallSignatures | ReflectionKind.Accessor;
+    const SINGULARS = {
+        [ReflectionKind.Enum]: "Enumeration",
+        [ReflectionKind.EnumMember]: "Enumeration Member",
+    };
+    const PLURALS = {
+        [ReflectionKind.Class]: "Classes",
+        [ReflectionKind.Property]: "Properties",
+        [ReflectionKind.Enum]: "Enumerations",
+        [ReflectionKind.EnumMember]: "Enumeration Members",
+        [ReflectionKind.TypeAlias]: "Type Aliases",
+    };
+    function singularString(kind) {
+        if (kind in SINGULARS) {
+            return SINGULARS[kind];
+        }
+        else {
+            return getKindString(kind);
+        }
+    }
+    ReflectionKind.singularString = singularString;
+    function pluralString(kind) {
+        if (kind in PLURALS) {
+            return PLURALS[kind];
+        }
+        else {
+            return getKindString(kind) + "s";
+        }
+    }
+    ReflectionKind.pluralString = pluralString;
 })(ReflectionKind = exports.ReflectionKind || (exports.ReflectionKind = {}));
+function getKindString(kind) {
+    return ReflectionKind[kind].replace(/(.)([A-Z])/g, (_m, a, b) => a + " " + b.toLowerCase());
+}

package/dist/lib/models/reflections/kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind.js","sourceRoot":"","sources":["../../../../src/lib/models/reflections/kind.ts"],"names":[],"mappings":"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"}

package/dist/lib/models/reflections/parameter.d.ts

@@ -1,8 +1,9 @@
 import type { SomeType } from "..";
 import { Reflection, TraverseCallback } from "./abstract";
 import type { SignatureReflection } from "./signature";
-import type { Serializer, JSONOutput } from "../../serialization";
+import type { Serializer, JSONOutput, Deserializer } from "../../serialization";
 export declare class ParameterReflection extends Reflection {
+    readonly variant = "param";
     parent?: SignatureReflection;
     defaultValue?: string;
     type?: SomeType;
@@ -20,4 +21,5 @@ export declare class ParameterReflection extends Reflection {
      */
     toString(): string;
     toObject(serializer: Serializer): JSONOutput.ParameterReflection;
+    fromObject(de: Deserializer, obj: JSONOutput.ParameterReflection): void;
 }

package/dist/lib/models/reflections/parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../../../../src/lib/models/reflections/parameter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhF,qBAAa,mBAAoB,SAAQ,UAAU;IAC/C,QAAQ,CAAC,OAAO,WAAW;IAElB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAEtC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;;;;;;OAOG;IACM,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAe5C;;OAEG;IACM,QAAQ;IAIR,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC,mBAAmB;IAShE,UAAU,CACf,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,UAAU,CAAC,mBAAmB,GACpC,IAAI;CAKV"}

package/dist/lib/models/reflections/parameter.js

@@ -4,6 +4,10 @@ exports.ParameterReflection = void 0;
 const types_1 = require("../types");
 const abstract_1 = require("./abstract");
 class ParameterReflection extends abstract_1.Reflection {
+    constructor() {
+        super(...arguments);
+        this.variant = "param";
+    }
     /**
      * Traverse all potential child reflections of this reflection.
      *
@@ -29,9 +33,15 @@ class ParameterReflection extends abstract_1.Reflection {
     toObject(serializer) {
         return {
             ...super.toObject(serializer),
+            variant: this.variant,
             type: serializer.toObject(this.type),
             defaultValue: this.defaultValue,
         };
     }
+    fromObject(de, obj) {
+        super.fromObject(de, obj);
+        this.type = de.reviveType(obj.type);
+        this.defaultValue = obj.defaultValue;
+    }
 }
 exports.ParameterReflection = ParameterReflection;

package/dist/lib/models/reflections/parameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.js","sourceRoot":"","sources":["../../../../src/lib/models/reflections/parameter.ts"],"names":[],"mappings":";;;AACA,oCAA0C;AAC1C,yCAA4E;AAI5E,MAAa,mBAAoB,SAAQ,qBAAU;IAAnD;;QACa,YAAO,GAAG,OAAO,CAAC;IAuD/B,CAAC;IA/CG;;;;;;;OAOG;IACM,QAAQ,CAAC,QAA0B;QACxC,IAAI,IAAI,CAAC,IAAI,YAAY,sBAAc,EAAE;YACrC,IACI,QAAQ,CACJ,IAAI,CAAC,IAAI,CAAC,WAAW,EACrB,2BAAgB,CAAC,WAAW,CAC/B,KAAK,KAAK,EACb;gBACE,OAAO;aACV;SACJ;QAED,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACM,QAAQ;QACb,OAAO,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IAEQ,QAAQ,CAAC,UAAsB;QACpC,OAAO;YACH,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACpC,YAAY,EAAE,IAAI,CAAC,YAAY;SAClC,CAAC;IACN,CAAC;IAEQ,UAAU,CACf,EAAgB,EAChB,GAAmC;QAEnC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IACzC,CAAC;CACJ;AAxDD,kDAwDC"}

package/dist/lib/models/reflections/project.d.ts

@@ -2,7 +2,10 @@ import { Reflection } from "./abstract";
 import { ContainerReflection } from "./container";
 import type * as ts from "typescript";
 import { ReflectionKind } from "./kind";
-import type { CommentDisplayPart } from "../comments";
+import { CommentDisplayPart } from "../comments";
+import { ReflectionSymbolId } from "./ReflectionSymbolId";
+import type { Serializer } from "../../serialization/serializer";
+import type { Deserializer, JSONOutput } from "../../serialization/index";
 /**
  * A reflection that represents the root of the project.
  *
@@ -10,7 +13,9 @@ import type { CommentDisplayPart } from "../comments";
  * and source files of the processed project through this reflection.
  */
 export declare class ProjectReflection extends ContainerReflection {
+    readonly variant = "project";
     private symbolToReflectionIdMap;
+    private reflectionIdToSymbolIdMap;
     private reflectionIdToSymbolMap;
     private referenceGraph?;
     /**
@@ -23,6 +28,14 @@ export declare class ProjectReflection extends ContainerReflection {
     reflections: {
         [id: number]: Reflection;
     };
+    /**
+     * The name of the package that this reflection documents according to package.json.
+     */
+    packageName?: string;
+    /**
+     * The version of the package that this reflection documents according to package.json.
+     */
+    packageVersion?: string;
     /**
      * The contents of the readme.md file of the project when found.
      */
@@ -40,11 +53,11 @@ export declare class ProjectReflection extends ContainerReflection {
      */
     getReflectionsByKind(kind: ReflectionKind): Reflection[];
     /**
-     * When excludeNotExported is set, if a symbol is exported only under a different name
-     * there will be a reference which points to the symbol, but the symbol will not be converted
-     * and the rename will point to nothing. Warn the user if this happens.
+     * Disassociate this project with all TypeScript created objects, allowing the underlying
+     * `ts.Program` to be garbage collected. This is very important for monorepo projects where
+     * we need to create multiple programs. See #1606 and surrounding discussion.
      */
-    removeDanglingReferences(): void;
+    forgetTsReferences(): void;
     /**
      * Registers the given reflection so that it can be quickly looked up by helper methods.
      * Should be called for *every* reflection added to the project.
@@ -66,7 +79,21 @@ export declare class ProjectReflection extends ContainerReflection {
      * @internal
      */
     getReflectionFromSymbol(symbol: ts.Symbol): Reflection | undefined;
+    /**
+     * Gets the reflection associated with the given symbol id, if it exists.
+     * @internal
+     */
+    getReflectionFromSymbolId(symbolId: ReflectionSymbolId): Reflection | undefined;
+    /** @internal */
+    getSymbolIdFromReflection(reflection: Reflection): ReflectionSymbolId | undefined;
     /** @internal */
+    registerSymbolId(reflection: Reflection, id: ReflectionSymbolId): void;
+    /**
+     * THIS MAY NOT BE USED AFTER CONVERSION HAS FINISHED.
+     * @internal
+     */
     getSymbolFromReflection(reflection: Reflection): ts.Symbol | undefined;
     private getReferenceGraph;
+    toObject(serializer: Serializer): JSONOutput.ProjectReflection;
+    fromObject(de: Deserializer, obj: JSONOutput.ProjectReflection): void;
 }

package/dist/lib/models/reflections/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/lib/models/reflections/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQlD,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAW,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG1E;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,mBAAmB;IACtD,QAAQ,CAAC,OAAO,aAAa;IAG7B,OAAO,CAAC,uBAAuB,CACR;IAEvB,OAAO,CAAC,yBAAyB,CAAyC;IAE1E,OAAO,CAAC,uBAAuB,CAAgC;IAG/D,OAAO,CAAC,cAAc,CAAC,CAAwB;IAE/C;;;;;;OAMG;IACH,WAAW,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAM;IAE/C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;gBAElB,IAAI,EAAE,MAAM;IAKxB;;OAEG;IACM,SAAS,IAAI,IAAI,IAAI,iBAAiB;IAI/C;;;;;OAKG;IACH,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE;IAMxD;;;;OAIG;IACH,kBAAkB;IAalB;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM;IAe7D;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,UAAU;IA+DvC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIrD;;;OAGG;IACH,uBAAuB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;IAIzC;;;OAGG;IACH,yBAAyB,CAAC,QAAQ,EAAE,kBAAkB;IAOtD,gBAAgB;IAChB,yBAAyB,CAAC,UAAU,EAAE,UAAU;IAIhD,gBAAgB;IAChB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,kBAAkB;IAO/D;;;OAGG;IACH,uBAAuB,CAAC,UAAU,EAAE,UAAU;IAI9C,OAAO,CAAC,iBAAiB;IAkBhB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC,iBAAiB;IAgB9D,UAAU,CACf,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,UAAU,CAAC,iBAAiB,GAClC,IAAI;CAsBV"}