typedoc 0.25.6 → 0.25.8

package/dist/index.d.ts

@@ -3,6 +3,13 @@ export { EventDispatcher, Event } from "./lib/utils/events";
 export { resetReflectionID } from "./lib/models/reflections/abstract";
 /**
  * All symbols documented under the Models namespace are also available in the root import.
+ *
+ * @categoryDescription Types
+ * Describes a TypeScript type.
+ *
+ * @categoryDescription Reflections
+ * Describes a documentation entry. The root entry is a {@link ProjectReflection}
+ * and contains {@link DeclarationReflection} instances.
  */
 export * as Models from "./lib/models";
 /**

package/dist/index.js

@@ -39,6 +39,13 @@ var abstract_1 = require("./lib/models/reflections/abstract");
 Object.defineProperty(exports, "resetReflectionID", { enumerable: true, get: function () { return abstract_1.resetReflectionID; } });
 /**
  * All symbols documented under the Models namespace are also available in the root import.
+ *
+ * @categoryDescription Types
+ * Describes a TypeScript type.
+ *
+ * @categoryDescription Reflections
+ * Describes a documentation entry. The root entry is a {@link ProjectReflection}
+ * and contains {@link DeclarationReflection} instances.
  */
 exports.Models = __importStar(require("./lib/models"));
 /**

package/dist/lib/converter/comments/discovery.d.ts

@@ -12,5 +12,6 @@ export declare function discoverFileComment(node: ts.SourceFile, commentStyle: C
     ranges: ts.CommentRange[];
     jsDoc: ts.JSDoc | undefined;
 } | undefined;
+export declare function discoverNodeComment(node: ts.Node, commentStyle: CommentStyle): DiscoveredComment | undefined;
 export declare function discoverComment(symbol: ts.Symbol, kind: ReflectionKind, logger: Logger, commentStyle: CommentStyle): DiscoveredComment | undefined;
 export declare function discoverSignatureComment(declaration: ts.SignatureDeclaration | ts.JSDocSignature, commentStyle: CommentStyle): DiscoveredComment | undefined;

package/dist/lib/converter/comments/discovery.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.discoverSignatureComment = exports.discoverComment = exports.discoverFileComment = void 0;
+exports.discoverSignatureComment = exports.discoverComment = exports.discoverNodeComment = exports.discoverFileComment = void 0;
 const typescript_1 = __importDefault(require("typescript"));
 const models_1 = require("../../models");
 const utils_1 = require("../../utils");
@@ -69,6 +69,10 @@ const wantedKinds = {
     [models_1.ReflectionKind.Class]: [
         typescript_1.default.SyntaxKind.ClassDeclaration,
         typescript_1.default.SyntaxKind.BindingElement,
+        // If marked with @class
+        typescript_1.default.SyntaxKind.VariableDeclaration,
+        typescript_1.default.SyntaxKind.ExportAssignment,
+        typescript_1.default.SyntaxKind.FunctionDeclaration,
     ],
     [models_1.ReflectionKind.Interface]: [
         typescript_1.default.SyntaxKind.InterfaceDeclaration,
@@ -116,6 +120,20 @@ function discoverFileComment(node, commentStyle) {
     }
 }
 exports.discoverFileComment = discoverFileComment;
+function discoverNodeComment(node, commentStyle) {
+    const text = node.getSourceFile().text;
+    const comments = collectCommentRanges(typescript_1.default.getLeadingCommentRanges(text, node.pos));
+    comments.reverse();
+    const selectedDocComment = comments.find((ranges) => permittedRange(text, ranges, commentStyle));
+    if (selectedDocComment) {
+        return {
+            file: node.getSourceFile(),
+            ranges: selectedDocComment,
+            jsDoc: findJsDocForComment(node, selectedDocComment),
+        };
+    }
+}
+exports.discoverNodeComment = discoverNodeComment;
 function discoverComment(symbol, kind, logger, commentStyle) {
     // For a module comment, we want the first one defined in the file,
     // not the last one, since that will apply to the import or declaration.

package/dist/lib/converter/comments/index.d.ts

@@ -10,6 +10,7 @@ export interface CommentParserConfig {
 }
 export declare function clearCommentCache(): void;
 export declare function getComment(symbol: ts.Symbol, kind: ReflectionKind, config: CommentParserConfig, logger: Logger, commentStyle: CommentStyle, checker: ts.TypeChecker | undefined): Comment | undefined;
+export declare function getNodeComment(node: ts.Node, kind: ReflectionKind, config: CommentParserConfig, logger: Logger, commentStyle: CommentStyle, checker: ts.TypeChecker | undefined): Comment | undefined;
 export declare function getFileComment(file: ts.SourceFile, config: CommentParserConfig, logger: Logger, commentStyle: CommentStyle, checker: ts.TypeChecker | undefined): Comment | undefined;
 export declare function getSignatureComment(declaration: ts.SignatureDeclaration | ts.JSDocSignature, config: CommentParserConfig, logger: Logger, commentStyle: CommentStyle, checker: ts.TypeChecker | undefined): Comment | undefined;
 export declare function getJsDocComment(declaration: ts.JSDocPropertyLikeTag | ts.JSDocCallbackTag | ts.JSDocTypedefTag | ts.JSDocTemplateTag | ts.JSDocEnumTag, config: CommentParserConfig, logger: Logger, checker: ts.TypeChecker | undefined): Comment | undefined;

package/dist/lib/converter/comments/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getJsDocComment = exports.getSignatureComment = exports.getFileComment = exports.getComment = exports.clearCommentCache = void 0;
+exports.getJsDocComment = exports.getSignatureComment = exports.getFileComment = exports.getNodeComment = exports.getComment = exports.clearCommentCache = void 0;
 const typescript_1 = __importDefault(require("typescript"));
 const models_1 = require("../../models");
 const utils_1 = require("../../utils");
@@ -89,6 +89,10 @@ function getComment(symbol, kind, config, logger, commentStyle, checker) {
     return comment;
 }
 exports.getComment = getComment;
+function getNodeComment(node, kind, config, logger, commentStyle, checker) {
+    return getCommentImpl((0, discovery_1.discoverNodeComment)(node, commentStyle), config, logger, kind === models_1.ReflectionKind.Module, checker);
+}
+exports.getNodeComment = getNodeComment;
 function getFileComment(file, config, logger, commentStyle, checker) {
     return getCommentImpl((0, discovery_1.discoverFileComment)(file, commentStyle), config, logger, 
     /* moduleComment */ true, checker);

package/dist/lib/converter/context.d.ts

@@ -79,6 +79,7 @@ export declare class Context {
     /** @internal */
     setActiveProgram(program: ts.Program | undefined): void;
     getComment(symbol: ts.Symbol, kind: ReflectionKind): import("../models/index").Comment | undefined;
+    getNodeComment(node: ts.Node, kind: ReflectionKind): import("../models/index").Comment | undefined;
     getFileComment(node: ts.SourceFile): import("../models/index").Comment | undefined;
     getJsDocComment(declaration: ts.JSDocPropertyLikeTag | ts.JSDocCallbackTag | ts.JSDocTypedefTag | ts.JSDocTemplateTag | ts.JSDocEnumTag): import("../models/index").Comment | undefined;
     getSignatureComment(declaration: ts.SignatureDeclaration | ts.JSDocSignature): import("../models/index").Comment | undefined;

package/dist/lib/converter/context.js

@@ -175,6 +175,9 @@ class Context {
     getComment(symbol, kind) {
         return (0, comments_1.getComment)(symbol, kind, this.converter.config, this.logger, this.converter.commentStyle, this.converter.useTsLinkResolution ? this.checker : undefined);
     }
+    getNodeComment(node, kind) {
+        return (0, comments_1.getNodeComment)(node, kind, this.converter.config, this.logger, this.converter.commentStyle, this.converter.useTsLinkResolution ? this.checker : undefined);
+    }
     getFileComment(node) {
         return (0, comments_1.getFileComment)(node, this.converter.config, this.logger, this.converter.commentStyle, this.converter.useTsLinkResolution ? this.checker : undefined);
     }

package/dist/lib/converter/converter.js

@@ -184,7 +184,7 @@ let Converter = (() => {
          * Compile the given source files and create a project reflection for them.
          */
         convert(entryPoints) {
-            const programs = entryPoints.map((e) => e.program);
+            const programs = (0, utils_1.unique)(entryPoints.map((e) => e.program));
             this.externalPatternCache = void 0;
             const project = new index_1.ProjectReflection(this.application.options.getValue("name"));
             const context = new context_1.Context(this, programs, project);

package/dist/lib/converter/factories/signature.d.ts

@@ -1,7 +1,11 @@
 import ts from "typescript";
-import { ParameterReflection, ReflectionKind, SignatureReflection, TypeParameterReflection } from "../../models";
+import { ParameterReflection, Reflection, ReflectionKind, SignatureReflection, TypeParameterReflection } from "../../models";
 import type { Context } from "../context";
 export declare function createSignature(context: Context, kind: ReflectionKind.CallSignature | ReflectionKind.ConstructorSignature | ReflectionKind.GetSignature | ReflectionKind.SetSignature, signature: ts.Signature, symbol: ts.Symbol | undefined, declaration?: ts.SignatureDeclaration | ts.JSDocSignature): void;
+/**
+ * Special cased constructor factory for functions tagged with `@class`
+ */
+export declare function createConstructSignatureWithType(context: Context, signature: ts.Signature, classType: Reflection): void;
 export declare function convertParameterNodes(context: Context, sigRef: SignatureReflection, parameters: readonly (ts.JSDocParameterTag | ts.ParameterDeclaration)[]): ParameterReflection[];
 export declare function convertTypeParameterNodes(context: Context, parameters: readonly ts.TypeParameterDeclaration[] | undefined): TypeParameterReflection[] | undefined;
 export declare function createTypeParamReflection(param: ts.TypeParameterDeclaration, context: Context): TypeParameterReflection;

package/dist/lib/converter/factories/signature.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertTemplateParameterNodes = exports.createTypeParamReflection = exports.convertTypeParameterNodes = exports.convertParameterNodes = exports.createSignature = void 0;
+exports.convertTemplateParameterNodes = exports.createTypeParamReflection = exports.convertTypeParameterNodes = exports.convertParameterNodes = exports.createConstructSignatureWithType = exports.createSignature = void 0;
 const typescript_1 = __importDefault(require("typescript"));
 const assert_1 = __importDefault(require("assert"));
 const models_1 = require("../../models");
@@ -17,6 +17,11 @@ function createSignature(context, kind, signature, symbol, declaration) {
     const sigRef = new models_1.SignatureReflection(kind == models_1.ReflectionKind.ConstructorSignature
         ? `new ${context.scope.parent.name}`
         : context.scope.name, kind, context.scope);
+    // This feels awful, but we need some way to tell if callable signatures on classes
+    // are "static" (e.g. `Foo()`) or not (e.g. `(new Foo())()`)
+    if (context.shouldBeStatic) {
+        sigRef.setFlag(models_1.ReflectionFlag.Static);
+    }
     const sigRefCtx = context.withScope(sigRef);
     if (symbol && declaration) {
         context.project.registerSymbolId(sigRef, new ReflectionSymbolId_1.ReflectionSymbolId(symbol, declaration));
@@ -72,6 +77,25 @@ function createSignature(context, kind, signature, symbol, declaration) {
     context.converter.trigger(converter_events_1.ConverterEvents.CREATE_SIGNATURE, context, sigRef, declaration, signature);
 }
 exports.createSignature = createSignature;
+/**
+ * Special cased constructor factory for functions tagged with `@class`
+ */
+function createConstructSignatureWithType(context, signature, classType) {
+    (0, assert_1.default)(context.scope instanceof models_1.DeclarationReflection);
+    const declaration = signature.getDeclaration();
+    const sigRef = new models_1.SignatureReflection(`new ${context.scope.parent.name}`, models_1.ReflectionKind.ConstructorSignature, context.scope);
+    const sigRefCtx = context.withScope(sigRef);
+    if (declaration) {
+        sigRef.comment = context.getSignatureComment(declaration);
+    }
+    sigRef.typeParameters = convertTypeParameters(sigRefCtx, sigRef, signature.typeParameters);
+    sigRef.type = models_1.ReferenceType.createResolvedReference(context.scope.parent.name, classType, context.project);
+    context.registerReflection(sigRef, undefined);
+    context.scope.signatures ??= [];
+    context.scope.signatures.push(sigRef);
+    context.converter.trigger(converter_events_1.ConverterEvents.CREATE_SIGNATURE, context, sigRef, declaration, signature);
+}
+exports.createConstructSignatureWithType = createConstructSignatureWithType;
 function convertParameters(context, sigRef, parameters, parameterNodes) {
     return parameters.map((param, i) => {
         const declaration = param.valueDeclaration;

package/dist/lib/converter/plugins/CategoryPlugin.js

@@ -155,7 +155,7 @@ let CategoryPlugin = (() => {
             obj.groups.forEach((group) => {
                 if (group.categories)
                     return;
-                group.categories = this.getReflectionCategories(group.children);
+                group.categories = this.getReflectionCategories(obj, group.children);
                 if (group.categories && group.categories.length > 1) {
                     group.categories.sort(CategoryPlugin.sortCatCallback);
                 }
@@ -170,7 +170,7 @@ let CategoryPlugin = (() => {
             if (!obj.children || obj.children.length === 0 || obj.categories) {
                 return;
             }
-            obj.categories = this.getReflectionCategories(obj.children);
+            obj.categories = this.getReflectionCategories(obj, obj.children);
             if (obj.categories && obj.categories.length > 1) {
                 obj.categories.sort(CategoryPlugin.sortCatCallback);
             }
@@ -188,7 +188,7 @@ let CategoryPlugin = (() => {
          *   relevance boost to be used when searching
          * @returns An array containing all children of the given reflection categorized
          */
-        getReflectionCategories(reflections) {
+        getReflectionCategories(parent, reflections) {
             const categories = new Map();
             for (const child of reflections) {
                 const childCategories = this.extractCategories(child);
@@ -207,6 +207,22 @@ let CategoryPlugin = (() => {
                     }
                 }
             }
+            if (parent.comment) {
+                (0, utils_1.removeIf)(parent.comment.blockTags, (tag) => {
+                    if (tag.tag === "@categoryDescription") {
+                        const { header, body } = models_1.Comment.splitPartsToHeaderAndBody(tag.content);
+                        const cat = categories.get(header);
+                        if (cat) {
+                            cat.description = body;
+                        }
+                        else {
+                            this.application.logger.warn(`Comment for ${parent.getFriendlyFullName()} includes @categoryDescription for "${header}", but no child is placed in that category.`);
+                        }
+                        return true;
+                    }
+                    return false;
+                });
+            }
             for (const cat of categories.values()) {
                 this.sortFunction(cat.children);
             }

package/dist/lib/converter/plugins/GroupPlugin.d.ts

@@ -1,4 +1,4 @@
-import { DeclarationReflection } from "../../models/reflections/index";
+import { ContainerReflection, DeclarationReflection } from "../../models/reflections/index";
 import { ReflectionGroup } from "../../models/ReflectionGroup";
 import { ConverterComponent } from "../components";
 /**
@@ -39,7 +39,7 @@ export declare class GroupPlugin extends ConverterComponent {
      * @param reflections  The reflections that should be grouped.
      * @returns An array containing all children of the given reflection grouped by their kind.
      */
-    getReflectionGroups(reflections: DeclarationReflection[]): ReflectionGroup[];
+    getReflectionGroups(parent: ContainerReflection, reflections: DeclarationReflection[]): ReflectionGroup[];
     /**
      * Callback used to sort groups by name.
      */

package/dist/lib/converter/plugins/GroupPlugin.js

@@ -135,7 +135,7 @@ let GroupPlugin = (() => {
                     !reflection.children.some((c) => c.kindOf(index_1.ReflectionKind.Module))) {
                     this.sortFunction(reflection.children);
                 }
-                reflection.groups = this.getReflectionGroups(reflection.children);
+                reflection.groups = this.getReflectionGroups(reflection, reflection.children);
             }
         }
         /**
@@ -188,7 +188,7 @@ let GroupPlugin = (() => {
          * @param reflections  The reflections that should be grouped.
          * @returns An array containing all children of the given reflection grouped by their kind.
          */
-        getReflectionGroups(reflections) {
+        getReflectionGroups(parent, reflections) {
             const groups = new Map();
             reflections.forEach((child) => {
                 for (const name of this.getGroups(child)) {
@@ -200,6 +200,22 @@ let GroupPlugin = (() => {
                     group.children.push(child);
                 }
             });
+            if (parent.comment) {
+                (0, utils_1.removeIf)(parent.comment.blockTags, (tag) => {
+                    if (tag.tag === "@groupDescription") {
+                        const { header, body } = models_1.Comment.splitPartsToHeaderAndBody(tag.content);
+                        const cat = groups.get(header);
+                        if (cat) {
+                            cat.description = body;
+                        }
+                        else {
+                            this.application.logger.warn(`Comment for ${parent.getFriendlyFullName()} includes @groupDescription for "${header}", but no child is placed in that group.`);
+                        }
+                        return true;
+                    }
+                    return false;
+                });
+            }
             return Array.from(groups.values()).sort(GroupPlugin.sortGroupCallback);
         }
         /**

package/dist/lib/converter/plugins/LinkResolverPlugin.d.ts

@@ -10,4 +10,5 @@ export declare class LinkResolverPlugin extends ConverterComponent {
     initialize(): void;
     onResolve(context: Context): void;
     resolveLinks(project: ProjectReflection): void;
+    private resolveCategoryLinks;
 }

package/dist/lib/converter/plugins/LinkResolverPlugin.js

@@ -94,6 +94,25 @@ let LinkResolverPlugin = (() => {
                     reflection.readme) {
                     reflection.readme = this.owner.resolveLinks(reflection.readme, reflection);
                 }
+                if (reflection instanceof models_1.ContainerReflection) {
+                    if (reflection.groups) {
+                        for (const group of reflection.groups) {
+                            if (group.description) {
+                                group.description = this.owner.resolveLinks(group.description, reflection);
+                            }
+                            if (group.categories) {
+                                for (const cat of group.categories) {
+                                    this.resolveCategoryLinks(cat, reflection);
+                                }
+                            }
+                        }
+                    }
+                    if (reflection.categories) {
+                        for (const cat of reflection.categories) {
+                            this.resolveCategoryLinks(cat, reflection);
+                        }
+                    }
+                }
             }
             if (project.readme) {
                 project.readme = this.owner.resolveLinks(project.readme, project);
@@ -112,6 +131,11 @@ let LinkResolverPlugin = (() => {
                 }
             }
         }
+        resolveCategoryLinks(category, owner) {
+            if (category.description) {
+                category.description = this.owner.resolveLinks(category.description, owner);
+            }
+        }
     };
     _LinkResolverPlugin_validation_accessor_storage = new WeakMap();
     __setFunctionName(_classThis, "LinkResolverPlugin");

package/dist/lib/converter/symbols.js

@@ -47,8 +47,8 @@ const conversionOrder = [
     typescript_1.default.SymbolFlags.BlockScopedVariable,
     typescript_1.default.SymbolFlags.FunctionScopedVariable,
     typescript_1.default.SymbolFlags.ExportValue,
-    typescript_1.default.SymbolFlags.TypeAlias,
     typescript_1.default.SymbolFlags.Function, // Before NamespaceModule
+    typescript_1.default.SymbolFlags.TypeAlias,
     typescript_1.default.SymbolFlags.Method,
     typescript_1.default.SymbolFlags.Interface,
     typescript_1.default.SymbolFlags.Property,
@@ -244,6 +244,12 @@ function convertFunctionOrMethod(context, symbol, exportSymbol) {
     // This will *NOT* be called for variables that look like functions, they need a special case.
     const isMethod = !!(symbol.flags &
         (typescript_1.default.SymbolFlags.Property | typescript_1.default.SymbolFlags.Method));
+    if (!isMethod) {
+        const comment = context.getComment(symbol, models_1.ReflectionKind.Function);
+        if (comment?.hasModifier("@class")) {
+            return convertSymbolAsClass(context, symbol, exportSymbol);
+        }
+    }
     const declarations = symbol.getDeclarations()?.filter(typescript_1.default.isFunctionLike) ?? [];
     // Don't do anything if we inherited this method and it is private.
     if (isMethod &&
@@ -276,8 +282,7 @@ function convertFunctionOrMethod(context, symbol, exportSymbol) {
     for (const sig of signatures) {
         (0, signature_1.createSignature)(scope, models_1.ReflectionKind.CallSignature, sig, symbol);
     }
-    convertFunctionProperties(scope, symbol, type);
-    return typescript_1.default.SymbolFlags.NamespaceModule;
+    return convertFunctionProperties(scope, symbol, type);
 }
 // getDeclaredTypeOfSymbol gets the INSTANCE type
 // getTypeOfSymbolAtLocation gets the STATIC type
@@ -484,7 +489,11 @@ function convertVariable(context, symbol, exportSymbol) {
     if (comment?.hasModifier("@namespace")) {
         return convertVariableAsNamespace(context, symbol, exportSymbol);
     }
-    if (type.getCallSignatures().length) {
+    if (comment?.hasModifier("@class")) {
+        return convertSymbolAsClass(context, symbol, exportSymbol);
+    }
+    if (type.getCallSignatures().length &&
+        !type.getConstructSignatures().length) {
         return convertVariableAsFunction(context, symbol, exportSymbol);
     }
     const reflection = context.createDeclarationReflection(context.scope.kindOf(models_1.ReflectionKind.VariableContainer)
@@ -557,8 +566,8 @@ function convertVariableAsFunction(context, symbol, exportSymbol) {
     for (const signature of type.getCallSignatures()) {
         (0, signature_1.createSignature)(reflectionContext, models_1.ReflectionKind.CallSignature, signature, symbol);
     }
-    convertFunctionProperties(context.withScope(reflection), symbol, type);
-    return typescript_1.default.SymbolFlags.Property | typescript_1.default.SymbolFlags.NamespaceModule;
+    return (convertFunctionProperties(context.withScope(reflection), symbol, type) |
+        typescript_1.default.SymbolFlags.Property);
 }
 function convertFunctionProperties(context, symbol, type) {
     // #2436/#2461: Functions created with Object.assign on a function likely have properties
@@ -573,7 +582,51 @@ function convertFunctionProperties(context, symbol, type) {
         ((0, enum_1.hasAllFlags)(symbol.flags, nsFlags) ||
             !(0, enum_1.hasAnyFlag)(symbol.flags, nsFlags))) {
         convertSymbols(context, type.getProperties());
+        return typescript_1.default.SymbolFlags.NamespaceModule;
     }
+    return typescript_1.default.SymbolFlags.None;
+}
+function convertSymbolAsClass(context, symbol, exportSymbol) {
+    const reflection = context.createDeclarationReflection(models_1.ReflectionKind.Class, symbol, exportSymbol);
+    const rc = context.withScope(reflection);
+    context.finalizeDeclarationReflection(reflection);
+    if (!symbol.valueDeclaration) {
+        context.logger.error(`No value declaration found when converting ${symbol.name} as a class`, symbol.declarations?.[0]);
+        return;
+    }
+    const type = context.checker.getTypeOfSymbolAtLocation(symbol, symbol.valueDeclaration);
+    rc.shouldBeStatic = true;
+    convertSymbols(rc, 
+    // Prototype is implicitly this class, don't document it.
+    type.getProperties().filter((prop) => prop.name !== "prototype"));
+    for (const sig of type.getCallSignatures()) {
+        (0, signature_1.createSignature)(rc, models_1.ReflectionKind.CallSignature, sig, undefined);
+    }
+    rc.shouldBeStatic = false;
+    const ctors = type.getConstructSignatures();
+    if (ctors.length) {
+        const constructMember = rc.createDeclarationReflection(models_1.ReflectionKind.Constructor, ctors?.[0]?.declaration?.symbol, void 0, "constructor");
+        // Modifiers are the same for all constructors
+        if (ctors.length && ctors[0].declaration) {
+            setModifiers(symbol, ctors[0].declaration, constructMember);
+        }
+        context.finalizeDeclarationReflection(constructMember);
+        const constructContext = rc.withScope(constructMember);
+        for (const sig of ctors) {
+            (0, signature_1.createConstructSignatureWithType)(constructContext, sig, reflection);
+        }
+        const instType = ctors[0].getReturnType();
+        convertSymbols(rc, instType.getProperties());
+        for (const sig of instType.getCallSignatures()) {
+            (0, signature_1.createSignature)(rc, models_1.ReflectionKind.CallSignature, sig, undefined);
+        }
+    }
+    else {
+        context.logger.warn(`${reflection.getFriendlyFullName()} is being converted as a class, but does not have any construct signatures`, symbol.valueDeclaration);
+    }
+    return (typescript_1.default.SymbolFlags.TypeAlias |
+        typescript_1.default.SymbolFlags.Interface |
+        typescript_1.default.SymbolFlags.Namespace);
 }
 function convertAccessor(context, symbol, exportSymbol) {
     const reflection = context.createDeclarationReflection(models_1.ReflectionKind.Accessor, symbol, exportSymbol);

package/dist/lib/converter/types.js

@@ -87,10 +87,7 @@ function convertType(context, typeOrNode) {
     // We need to check it here, not just in the union checker, because typeToTypeNode
     // will use the origin when serializing
     // aliasSymbol check is important - #2468
-    if (typeOrNode.isUnion() &&
-        typeOrNode.origin &&
-        !typeOrNode.origin.isUnion() &&
-        !typeOrNode.aliasSymbol) {
+    if (typeOrNode.isUnion() && typeOrNode.origin && !typeOrNode.aliasSymbol) {
         return convertType(context, typeOrNode.origin);
     }
     // IgnoreErrors is important, without it, we can't assert that we will get a node.

package/dist/lib/models/ReflectionCategory.d.ts

@@ -1,4 +1,4 @@
-import type { DeclarationReflection } from ".";
+import type { CommentDisplayPart, DeclarationReflection } from ".";
 import type { Serializer, JSONOutput, Deserializer } from "../serialization";
 /**
  * A category of reflections.
@@ -12,6 +12,10 @@ export declare class ReflectionCategory {
      * The title, a string representation of this category.
      */
     title: string;
+    /**
+     * The user specified description, if any, set with `@categoryDescription`
+     */
+    description?: CommentDisplayPart[];
     /**
      * All reflections of this category.
      */
@@ -26,6 +30,6 @@ export declare class ReflectionCategory {
      * Do all children of this category have a separate document?
      */
     allChildrenHaveOwnDocument(): boolean;
-    toObject(_serializer: Serializer): JSONOutput.ReflectionCategory;
+    toObject(serializer: Serializer): JSONOutput.ReflectionCategory;
     fromObject(de: Deserializer, obj: JSONOutput.ReflectionCategory): void;
 }

package/dist/lib/models/ReflectionCategory.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectionCategory = void 0;
+const comments_1 = require("./comments");
 /**
  * A category of reflections.
  *
@@ -27,15 +28,21 @@ class ReflectionCategory {
     allChildrenHaveOwnDocument() {
         return this.children.every((child) => child.hasOwnDocument);
     }
-    toObject(_serializer) {
+    toObject(serializer) {
         return {
             title: this.title,
+            description: this.description
+                ? comments_1.Comment.serializeDisplayParts(serializer, this.description)
+                : undefined,
             children: this.children.length > 0
                 ? this.children.map((child) => child.id)
                 : undefined,
         };
     }
     fromObject(de, obj) {
+        if (obj.description) {
+            this.description = comments_1.Comment.deserializeDisplayParts(de, obj.description);
+        }
         if (obj.children) {
             de.defer((project) => {
                 for (const childId of obj.children || []) {

package/dist/lib/models/ReflectionGroup.d.ts

@@ -1,5 +1,5 @@
 import { ReflectionCategory } from "./ReflectionCategory";
-import type { DeclarationReflection, Reflection } from ".";
+import type { CommentDisplayPart, DeclarationReflection, Reflection } from ".";
 import type { Serializer, JSONOutput, Deserializer } from "../serialization";
 /**
  * A group of reflections. All reflections in a group are of the same kind.
@@ -14,6 +14,10 @@ export declare class ReflectionGroup {
      * The title, a string representation of the typescript kind, of this group.
      */
     title: string;
+    /**
+     * User specified description via `@groupDescription`, if specified.
+     */
+    description?: CommentDisplayPart[];
     /**
      * All reflections of this group.
      */

package/dist/lib/models/ReflectionGroup.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectionGroup = void 0;
 const ReflectionCategory_1 = require("./ReflectionCategory");
+const comments_1 = require("./comments");
 /**
  * A group of reflections. All reflections in a group are of the same kind.
  *
@@ -33,6 +34,9 @@ class ReflectionGroup {
     toObject(serializer) {
         return {
             title: this.title,
+            description: this.description
+                ? comments_1.Comment.serializeDisplayParts(serializer, this.description)
+                : undefined,
             children: this.children.length > 0
                 ? this.children.map((child) => child.id)
                 : undefined,
@@ -40,6 +44,9 @@ class ReflectionGroup {
         };
     }
     fromObject(de, obj) {
+        if (obj.description) {
+            this.description = comments_1.Comment.deserializeDisplayParts(de, obj.description);
+        }
         if (obj.categories) {
             this.categories = obj.categories.map((catObj) => {
                 const cat = new ReflectionCategory_1.ReflectionCategory(catObj.title);

package/dist/lib/models/comments/comment.d.ts

@@ -76,7 +76,7 @@ export declare class Comment {
     /**
      * Helper utility to clone {@link Comment.summary} or {@link CommentTag.content}
      */
-    static cloneDisplayParts(parts: CommentDisplayPart[]): ({
+    static cloneDisplayParts(parts: readonly CommentDisplayPart[]): ({
         kind: "text";
         text: string;
     } | {
@@ -93,6 +93,15 @@ export declare class Comment {
     /** @hidden no point in showing this signature in api docs */
     static serializeDisplayParts(serializer: Serializer, parts: CommentDisplayPart[] | undefined): JSONOutput.CommentDisplayPart[] | undefined;
     static deserializeDisplayParts(de: Deserializer, parts: JSONOutput.CommentDisplayPart[]): CommentDisplayPart[];
+    /**
+     * Splits the provided parts into a header (first line, as a string)
+     * and body (remaining lines). If the header line contains inline tags
+     * they will be serialized to a string.
+     */
+    static splitPartsToHeaderAndBody(parts: readonly CommentDisplayPart[]): {
+        header: string;
+        body: CommentDisplayPart[];
+    };
     /**
      * The content of the comment which is not associated with a block tag.
      */