typedoc 0.28.10 → 0.28.12

package/dist/index.d.ts

@@ -41,7 +41,7 @@ export type { Icons, NavigationElement, PageDefinition, PageHeading, RendererEve
 export { Outputs } from "./lib/output/output.js";
 export { ArgumentsReader, CommentStyle, EntryPointStrategy, normalizePath, Option, OptionDefaults, Options, PackageJsonReader, ParameterHint, ParameterType, TSConfigReader, TypeDocReader, ValidatingFileRegistry, } from "./lib/utils/index.js";
 export type { ArrayDeclarationOption, BooleanDeclarationOption, DeclarationOption, DeclarationOptionBase, DeclarationOptionToOptionType, DocumentationEntryPoint, FancyConsoleLogger, FlagsDeclarationOption, JsDocCompatibility, KeyToDeclaration, ManuallyValidatedOption, MapDeclarationOption, MixedDeclarationOption, NumberDeclarationOption, ObjectDeclarationOption, OptionsReader, OutputSpecification, ParameterTypeToOptionTypeMap, SortStrategy, StringDeclarationOption, TypeDocOptionMap, TypeDocOptions, TypeDocOptionValues, ValidationOptions, } from "./lib/utils/index.js";
-export { type ComponentPath, ConsoleLogger, type DeclarationReference, type EnumKeys, EventDispatcher, EventHooks, type GlobString, i18n, JSX, Logger, LogLevel, type Meaning, type MeaningKeyword, type MinimalNode, MinimalSourceFile, type NormalizedPath, type NormalizedPathOrModule, type NormalizedPathOrModuleOrFunction, type SymbolReference, type TranslatedString, translateTagName, } from "#utils";
+export { type ComponentPath, ConsoleLogger, type DeclarationReference, type EnumKeys, EventDispatcher, EventHooks, type GlobString, i18n, JSX, Logger, LogLevel, type Meaning, type MeaningKeyword, type MinimalNode, MinimalSourceFile, type NormalizedPath, type NormalizedPathOrModule, type NormalizedPathOrModuleOrFunction, type SymbolReference, type TagString, type TranslatedString, translateTagName, } from "#utils";
 export { type Deserializable, Deserializer, type DeserializerComponent, JSONOutput, SerializeEvent, Serializer, type SerializerComponent, type SerializerEvents, } from "./lib/serialization/index.js";
 export * as Internationalization from "./lib/internationalization/index.js";
 export type { TranslatableStrings } from "./lib/internationalization/internationalization.js";

package/dist/lib/application.js

@@ -409,7 +409,7 @@ let Application = (() => {
             if (!supportedVersionMajorMinor.some((version) => version == ts.versionMajorMinor)) {
                 this.logger.warn(i18n.unsupported_ts_version_0(supportedVersionMajorMinor.join(", ")));
             }
-            if (Object.keys(this.options.getCompilerOptions()).length === 0) {
+            if (Object.keys(this.options.getCompilerOptions(this.logger)).length === 0) {
                 this.logger.warn(i18n.no_compiler_options_set());
             }
             // Doing this is considerably more complicated, we'd need to manage an array of programs, not convert until all programs
@@ -429,7 +429,7 @@ let Application = (() => {
             // We don't want to do it the first time to preserve initial debug status messages. They'll be lost
             // after the user saves a file, but better than nothing...
             let firstStatusReport = true;
-            const host = ts.createWatchCompilerHost(tsconfigFile, this.options.fixCompilerOptions({}), ts.sys, ts.createEmitAndSemanticDiagnosticsBuilderProgram, (d) => diagnostic(this.logger, d), (status, newLine, _options, errorCount) => {
+            const host = ts.createWatchCompilerHost(tsconfigFile, this.options.fixCompilerOptions({}, this.logger), ts.sys, ts.createEmitAndSemanticDiagnosticsBuilderProgram, (d) => diagnostic(this.logger, d), (status, newLine, _options, errorCount) => {
                 if (!firstStatusReport &&
                     errorCount === void 0 &&
                     !this.options.getValue("preserveWatchOutput") &&

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

@@ -4,6 +4,7 @@ import { CommentStyle } from "../../utils/options/declaration.js";
 import { nicePath } from "../../utils/paths.js";
 import { ok } from "assert";
 import { assertNever, filter, firstDefined, i18n } from "#utils";
+import { resolveAliasedSymbol } from "../utils/symbols.js";
 const variablePropertyKinds = [
     ts.SyntaxKind.PropertyDeclaration,
     ts.SyntaxKind.PropertySignature,
@@ -263,9 +264,7 @@ function findJsDocForComment(node, ranges) {
             .map((doc) => ts.findAncestor(doc, ts.isJSDoc));
         if (ts.isSourceFile(node)) {
             if (node.statements.length) {
-                jsDocs.push(...ts
-                    .getJSDocCommentsAndTags(node.statements[0])
-                    .map((doc) => ts.findAncestor(doc, ts.isJSDoc)));
+                jsDocs.push(...node.statements[0].getChildren().filter(ts.isJSDoc));
             }
         }
         return jsDocs.find((doc) => doc.pos === ranges[0].pos);
@@ -405,6 +404,30 @@ function declarationToCommentNodes(node, checker) {
             inheritedFromParentDeclaration: true,
         });
     }
+    // #2999 automatically pick up comments from the value symbol for shorthand assignments
+    if (ts.isShorthandPropertyAssignment(node)) {
+        const sourceSymbol = checker.getShorthandAssignmentValueSymbol(node);
+        if (sourceSymbol?.valueDeclaration) {
+            const commentNode = declarationToCommentNodeIgnoringParents(sourceSymbol.valueDeclaration);
+            if (commentNode) {
+                result.push({
+                    node: commentNode,
+                    inheritedFromParentDeclaration: true,
+                });
+            }
+        }
+        // #3003 even more magic for handling an imported symbol which appears in a shorthand property assignment
+        const originalSymbol = sourceSymbol && resolveAliasedSymbol(sourceSymbol, checker);
+        if (originalSymbol !== sourceSymbol && originalSymbol?.valueDeclaration) {
+            const commentNode = declarationToCommentNodeIgnoringParents(originalSymbol?.valueDeclaration);
+            if (commentNode) {
+                result.push({
+                    node: commentNode,
+                    inheritedFromParentDeclaration: true,
+                });
+            }
+        }
+    }
     // With overloaded functions/methods, TypeScript will use the comment on the first signature
     // declaration
     if ((ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) &&

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

@@ -166,8 +166,9 @@ function checkMarkdownLink(data, reentry) {
     if (link.ok) {
         // Only make a relative-link display part if it's actually a relative link.
         // Discard protocol:// links, unix style absolute paths, and windows style absolute paths.
-        if (isRelativePath(link.str)) {
-            const { target, anchor } = files.register(sourcePath, link.str) || { target: undefined, anchor: undefined };
+        const decoded = decodeURI(link.str);
+        if (isRelativePath(decoded)) {
+            const { target, anchor } = files.register(sourcePath, decoded) || { target: undefined, anchor: undefined };
             return {
                 pos: lookahead,
                 end: link.pos,
@@ -213,8 +214,9 @@ function checkReference(data) {
                 }
                 const link = MdHelpers.parseLinkDestination(token.text, lookahead, token.text.length);
                 if (link.ok) {
-                    if (isRelativePath(link.str)) {
-                        const { target, anchor } = files.register(sourcePath, link.str) || { target: undefined, anchor: undefined };
+                    const decoded = decodeURI(link.str);
+                    if (isRelativePath(decoded)) {
+                        const { target, anchor } = files.register(sourcePath, decoded) || { target: undefined, anchor: undefined };
                         return {
                             pos: lookahead,
                             end: link.pos,
@@ -273,8 +275,9 @@ function checkAttributes(data, attributes) {
     return links;
 }
 function checkAttributeDirectPath(data, text, pos, end) {
-    if (isRelativePath(text.trim())) {
-        const { target, anchor } = data.files.register(data.sourcePath, text.trim()) || { target: undefined, anchor: undefined };
+    const decoded = decodeURI(text.trim());
+    if (isRelativePath(decoded)) {
+        const { target, anchor } = data.files.register(data.sourcePath, decoded) || { target: undefined, anchor: undefined };
         return [{
                 pos,
                 end,
@@ -302,8 +305,9 @@ function checkAttributeSrcSet(data, text, pos, _end) {
         // TypeDoc: We don't exactly match this, PR welcome! For now, just permit anything
         // that's not whitespace or a comma
         const url = text.slice(textPos).match(/^[^\t\r\f\n ,]+/);
-        if (url && isRelativePath(url[0])) {
-            const { target, anchor } = data.files.register(data.sourcePath, url[0]) || { target: undefined, anchor: undefined };
+        const decoded = url && decodeURI(url[0]);
+        if (decoded && isRelativePath(decoded)) {
+            const { target, anchor } = data.files.register(data.sourcePath, decoded) || { target: undefined, anchor: undefined };
             result.push({
                 pos: pos + textPos,
                 end: pos + textPos + url[0].length,

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

@@ -1,3 +1,4 @@
+import { type TagString } from "#utils";
 import { ConverterComponent } from "../components.js";
 import type { Converter } from "../converter.js";
 /**
@@ -56,8 +57,8 @@ import type { Converter } from "../converter.js";
  * - Resolve `@link` tags to point to target reflections
  */
 export declare class CommentPlugin extends ConverterComponent {
-    accessor excludeTags: `@${string}`[];
-    accessor cascadedModifierTags: `@${string}`[];
+    accessor excludeTags: TagString[];
+    accessor cascadedModifierTags: TagString[];
     accessor excludeInternal: boolean;
     accessor excludePrivate: boolean;
     accessor excludeProtected: boolean;

package/dist/lib/converter/symbols.js

@@ -631,7 +631,11 @@ function convertVariableAsEnum(context, symbol, exportSymbol) {
     const reflection = context.createDeclarationReflection(ReflectionKind.Enum, symbol, exportSymbol);
     context.finalizeDeclarationReflection(reflection);
     const rc = context.withScope(reflection);
-    const declaration = symbol.declarations.find(ts.isVariableDeclaration);
+    const declaration = symbol.valueDeclaration;
+    if (!declaration) {
+        context.logger.error(i18n.converting_0_as_enum_requires_value_declaration(symbol.name), symbol.declarations?.[0]);
+        return;
+    }
     const type = context.checker.getTypeAtLocation(declaration);
     for (const prop of type.getProperties()) {
         const reflection = rc.createDeclarationReflection(ReflectionKind.EnumMember, prop, void 0);

package/dist/lib/internationalization/locales/en.cjs

@@ -31,6 +31,7 @@ module.exports = {
     converting_union_as_interface: `Using @interface on a union type will discard properties not present on all branches of the union. TypeDoc's output may not accurately describe your source code`,
     converting_0_as_class_requires_value_declaration: `Converting {0} as a class requires a declaration which represents a non-type value`,
     converting_0_as_class_without_construct_signatures: `{0} is being converted as a class, but does not have any construct signatures`,
+    converting_0_as_enum_requires_value_declaration: `Converting {0} as an enum requires a declaration which represents a non-type value`,
     comment_for_0_should_not_contain_block_or_modifier_tags: `The comment for {0} should not contain any block or modifier tags`,
     symbol_0_has_multiple_declarations_with_comment: `{0} has multiple declarations with a comment. An arbitrary comment will be used`,
     comments_for_0_are_declared_at_1: `The comments for {0} are declared at:\n\t{1}`,
@@ -144,6 +145,7 @@ module.exports = {
     invalid_tsdoc_json_0: `The file {0} is not a valid tsdoc.json file`,
     options_file_0_does_not_exist: `The options file {0} does not exist`,
     failed_read_options_file_0: `Failed to parse {0}, ensure it exists and exports an object`,
+    failed_to_apply_compilerOptions_overrides_0: "Failed to apply compilerOptions overrides: {0}",
     // plugins
     invalid_plugin_0_missing_load_function: `Invalid structure in plugin {0}, no load function found`,
     plugin_0_could_not_be_loaded: `The plugin {0} could not be loaded`,
@@ -360,7 +362,7 @@ module.exports = {
     // Page headings/labels
     theme_implements: "Implements",
     theme_indexable: "Indexable",
-    theme_type_declaration: "Type declaration",
+    theme_type_declaration: "Type Declaration",
     theme_index: "Index",
     theme_hierarchy: "Hierarchy",
     theme_hierarchy_summary: "Hierarchy Summary",

package/dist/lib/internationalization/locales/en.d.cts

@@ -28,6 +28,7 @@ declare const _default: {
     readonly converting_union_as_interface: "Using @interface on a union type will discard properties not present on all branches of the union. TypeDoc's output may not accurately describe your source code";
     readonly converting_0_as_class_requires_value_declaration: "Converting {0} as a class requires a declaration which represents a non-type value";
     readonly converting_0_as_class_without_construct_signatures: "{0} is being converted as a class, but does not have any construct signatures";
+    readonly converting_0_as_enum_requires_value_declaration: "Converting {0} as an enum requires a declaration which represents a non-type value";
     readonly comment_for_0_should_not_contain_block_or_modifier_tags: "The comment for {0} should not contain any block or modifier tags";
     readonly symbol_0_has_multiple_declarations_with_comment: "{0} has multiple declarations with a comment. An arbitrary comment will be used";
     readonly comments_for_0_are_declared_at_1: "The comments for {0} are declared at:\n\t{1}";
@@ -133,6 +134,7 @@ declare const _default: {
     readonly invalid_tsdoc_json_0: "The file {0} is not a valid tsdoc.json file";
     readonly options_file_0_does_not_exist: "The options file {0} does not exist";
     readonly failed_read_options_file_0: "Failed to parse {0}, ensure it exists and exports an object";
+    readonly failed_to_apply_compilerOptions_overrides_0: "Failed to apply compilerOptions overrides: {0}";
     readonly invalid_plugin_0_missing_load_function: "Invalid structure in plugin {0}, no load function found";
     readonly plugin_0_could_not_be_loaded: "The plugin {0} could not be loaded";
     readonly help_options: "Specify a json option file that should be loaded. If not specified TypeDoc will look for 'typedoc.json' in the current directory";
@@ -336,7 +338,7 @@ declare const _default: {
     readonly flag_inherited: "Inherited";
     readonly theme_implements: "Implements";
     readonly theme_indexable: "Indexable";
-    readonly theme_type_declaration: "Type declaration";
+    readonly theme_type_declaration: "Type Declaration";
     readonly theme_index: "Index";
     readonly theme_hierarchy: "Hierarchy";
     readonly theme_hierarchy_summary: "Hierarchy Summary";

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

@@ -1,4 +1,4 @@
-import { type NormalizedPath } from "#utils";
+import { type NormalizedPath, type TagString } from "#utils";
 import type { Reflection } from "./Reflection.js";
 import { ReflectionSymbolId } from "./ReflectionSymbolId.js";
 import type { Deserializer, JSONOutput, Serializer } from "#serialization";
@@ -36,7 +36,7 @@ export type CommentDisplayPart =
  */
 export interface InlineTagDisplayPart {
     kind: "inline-tag";
-    tag: `@${string}`;
+    tag: TagString;
     text: string;
     target?: Reflection | string | ReflectionSymbolId;
     tsLinkText?: string;
@@ -79,7 +79,7 @@ export declare class CommentTag {
     /**
      * The name of this tag, e.g. `@returns`, `@example`
      */
-    tag: `@${string}`;
+    tag: TagString;
     /**
      * Some tags, (`@typedef`, `@param`, `@property`, etc.) may have a user defined identifier associated with them.
      * If this tag is one of those, it will be parsed out and included here.
@@ -98,7 +98,7 @@ export declare class CommentTag {
     /**
      * Create a new CommentTag instance.
      */
-    constructor(tag: `@${string}`, text: CommentDisplayPart[]);
+    constructor(tag: TagString, text: CommentDisplayPart[]);
     /**
      * Checks if this block tag is roughly equal to the other tag.
      * This isn't exactly equal, but just "roughly equal" by the tag
@@ -150,7 +150,7 @@ export declare class Comment {
     /**
      * All modifier tags present on the comment, e.g. `@alpha`, `@beta`.
      */
-    modifierTags: Set<`@${string}`>;
+    modifierTags: Set<TagString>;
     /**
      * Label associated with this reflection, if any (https://tsdoc.org/pages/tags/label/)
      */
@@ -179,7 +179,7 @@ export declare class Comment {
     /**
      * Creates a new Comment instance.
      */
-    constructor(summary?: CommentDisplayPart[], blockTags?: CommentTag[], modifierTags?: Set<`@${string}`>);
+    constructor(summary?: CommentDisplayPart[], blockTags?: CommentTag[], modifierTags?: Set<TagString>);
     /**
      * Gets either the `@summary` tag, or a short version of the comment summary
      * section for rendering in module/namespace pages.
@@ -201,36 +201,36 @@ export declare class Comment {
      */
     isEmpty(): boolean;
     /**
-     * Has this comment a visible component?
+     * Checks if this comment contains any visible text.
      *
-     * @returns TRUE when this comment has a visible component.
+     * @returns TRUE when this reflection has a visible comment.
      */
-    hasVisibleComponent(): boolean;
+    hasVisibleComponent(notRenderedTags?: readonly TagString[]): boolean;
     /**
      * Test whether this comment contains a tag with the given name.
      *
      * @param tagName  The name of the tag to look for.
      * @returns TRUE when this comment contains a tag with the given name, otherwise FALSE.
      */
-    hasModifier(tagName: `@${string}`): boolean;
-    removeModifier(tagName: `@${string}`): void;
+    hasModifier(tagName: TagString): boolean;
+    removeModifier(tagName: TagString): void;
     /**
      * Return the first tag with the given name.
      *
      * @param tagName  The name of the tag to look for.
      * @returns The found tag or undefined.
      */
-    getTag(tagName: `@${string}`): CommentTag | undefined;
+    getTag(tagName: TagString): CommentTag | undefined;
     /**
      * Get all tags with the given tag name.
      */
-    getTags(tagName: `@${string}`): CommentTag[];
-    getIdentifiedTag(identifier: string, tagName: `@${string}`): CommentTag | undefined;
+    getTags(tagName: TagString): CommentTag[];
+    getIdentifiedTag(identifier: string, tagName: TagString): CommentTag | undefined;
     /**
      * Removes all block tags with the given tag name from the comment.
      * @param tagName
      */
-    removeTags(tagName: `@${string}`): void;
+    removeTags(tagName: TagString): void;
     toObject(serializer: Serializer): JSONOutput.Comment;
     fromObject(de: Deserializer, obj: JSONOutput.Comment): void;
 }

package/dist/lib/models/Comment.js

@@ -441,13 +441,20 @@ let Comment = (() => {
             return !this.hasVisibleComponent() && this.modifierTags.size === 0;
         }
         /**
-         * Has this comment a visible component?
+         * Checks if this comment contains any visible text.
          *
-         * @returns TRUE when this comment has a visible component.
+         * @returns TRUE when this reflection has a visible comment.
          */
-        hasVisibleComponent() {
-            return (this.summary.some((x) => x.kind !== "text" || x.text !== "") ||
-                this.blockTags.length > 0);
+        hasVisibleComponent(notRenderedTags) {
+            if (this.summary.some((x) => x.kind !== "text" || x.text !== "")) {
+                return true;
+            }
+            if (notRenderedTags) {
+                return this.blockTags.some(tag => !notRenderedTags.includes(tag.tag));
+            }
+            else {
+                return this.blockTags.length > 0;
+            }
         }
         /**
          * Test whether this comment contains a tag with the given name.

package/dist/lib/models/DeclarationReflection.js

@@ -252,7 +252,7 @@ export class DeclarationReflection extends ContainerReflection {
                         this.project.registerSymbolId(refl, new ReflectionSymbolId(sid));
                     }
                     else {
-                        de.logger.warn(i18n.serialized_project_referenced_0_not_part_of_project(id.toString()));
+                        de.logger.warn(i18n.serialized_project_referenced_0_not_part_of_project(id));
                     }
                 }
             });

package/dist/lib/models/FileRegistry.js

@@ -55,7 +55,7 @@ export class FileRegistry {
     }
     resolve(id, project) {
         const reflId = this.mediaToReflection.get(id);
-        if (reflId) {
+        if (typeof reflId === "number") {
             return project.getReflectionById(reflId);
         }
         return this.mediaToPath.get(id);

package/dist/lib/models/ProjectReflection.js

@@ -342,7 +342,7 @@ let ProjectReflection = (() => {
             this.removedSymbolIds.delete(id);
             this.reflectionIdToSymbolIdMap.set(reflection.id, id);
             const previous = this.symbolToReflectionIdMap.get(id);
-            if (previous) {
+            if (typeof previous !== "undefined") {
                 if (typeof previous === "number") {
                     this.symbolToReflectionIdMap.set(id, [previous, reflection.id]);
                 }
@@ -407,7 +407,7 @@ let ProjectReflection = (() => {
                         this.registerSymbolId(refl, new ReflectionSymbolId(sid));
                     }
                     else {
-                        de.logger.warn(i18n.serialized_project_referenced_0_not_part_of_project(id.toString()));
+                        de.logger.warn(i18n.serialized_project_referenced_0_not_part_of_project(id));
                     }
                 }
             });

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

@@ -1,6 +1,6 @@
 import { Comment } from "./Comment.js";
 import type { ProjectReflection } from "./ProjectReflection.js";
-import { type NeverIfInternal, type TranslatedString } from "#utils";
+import { type NeverIfInternal, type TagString, type TranslatedString } from "#utils";
 import { ReflectionKind } from "./kind.js";
 import type { Deserializer, JSONOutput, Serializer } from "#serialization";
 import type { ReflectionVariant } from "./variant.js";
@@ -171,11 +171,11 @@ export declare abstract class Reflection {
      */
     setFlag(flag: ReflectionFlag, value?: boolean): void;
     /**
-     * Has this reflection a visible comment?
+     * Checks if this reflection has a comment which contains any visible text.
      *
      * @returns TRUE when this reflection has a visible comment.
      */
-    hasComment(): boolean;
+    hasComment(notRenderedTags?: readonly TagString[]): boolean;
     hasGetterOrSetter(): boolean;
     /**
      * Return a child by its name.

package/dist/lib/models/Reflection.js

@@ -359,12 +359,12 @@ let Reflection = (() => {
             this.flags.setFlag(flag, value);
         }
         /**
-         * Has this reflection a visible comment?
+         * Checks if this reflection has a comment which contains any visible text.
          *
          * @returns TRUE when this reflection has a visible comment.
          */
-        hasComment() {
-            return this.comment ? this.comment.hasVisibleComponent() : false;
+        hasComment(notRenderedTags) {
+            return this.comment ? this.comment.hasVisibleComponent(notRenderedTags) : false;
         }
         hasGetterOrSetter() {
             return false;

package/dist/lib/output/formatter.js

@@ -566,6 +566,7 @@ export class FormattedCodeBuilder {
         const id = this.newId();
         return group(id, [
             name,
+            sig.parent.flags.isOptional ? simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, "?")) : emptyNode,
             this.typeParameters(sig),
             ...this.parameters(sig, id),
             nodes(options.arrowStyle ? space() : emptyNode, simpleElement(JSX.createElement("span", { class: "tsd-signature-symbol" }, options.arrowStyle ? "=>" : ":")), space(), this.type(sig.type, TypeContext.none)),

package/dist/lib/output/themes/MarkedPlugin.js

@@ -240,7 +240,17 @@ let MarkedPlugin = (() => {
                                 const refl = page.project.files.resolve(part.target, page.model.project);
                                 let url;
                                 if (typeof refl === "object") {
-                                    url = context.urlTo(refl);
+                                    // #3006, this is an unfortunate heuristic. If there is a relative link to the project
+                                    // the user probably created it by linking to the directory of the project or to
+                                    // the project's readme. Since the readme doesn't get its own reflection, we can't
+                                    // reliably disambiguate this and instead will arbitrarily decide to reference the
+                                    // root index page in this case.
+                                    if (refl.isProject()) {
+                                        url = context.relativeURL("./");
+                                    }
+                                    else {
+                                        url = context.urlTo(refl);
+                                    }
                                 }
                                 else {
                                     const fileName = page.project.files.getName(part.target);

package/dist/lib/output/themes/default/partials/comment.js

@@ -48,20 +48,21 @@ export function commentTags(context, props) {
         ? props.comment.blockTags.filter((tag) => tag.tag !== "@returns" && !tag.skipRendering && !skippedTags.includes(tag.tag))
         : props.comment.blockTags.filter((tag) => !tag.skipRendering && !skippedTags.includes(tag.tag));
     skipSave.forEach((skip, i) => (props.comment.blockTags[i].skipRendering = skip));
+    const tagsContents = tags.map((item) => {
+        const name = item.name
+            ? `${translateTagName(item.tag)}: ${item.name}`
+            : translateTagName(item.tag);
+        const anchor = context.slugger.slug(name);
+        return (JSX.createElement(JSX.Fragment, null,
+            JSX.createElement("div", { class: `tsd-tag-${item.tag.substring(1)}` },
+                JSX.createElement("h4", { class: "tsd-anchor-link", id: anchor },
+                    name,
+                    anchorIcon(context, anchor)),
+                JSX.createElement(JSX.Raw, { html: context.markdown(item.content) }))));
+    });
     return (JSX.createElement(JSX.Fragment, null,
         beforeTags,
-        JSX.createElement("div", { class: "tsd-comment tsd-typography" }, tags.map((item) => {
-            const name = item.name
-                ? `${translateTagName(item.tag)}: ${item.name}`
-                : translateTagName(item.tag);
-            const anchor = context.slugger.slug(name);
-            return (JSX.createElement(JSX.Fragment, null,
-                JSX.createElement("div", { class: `tsd-tag-${item.tag.substring(1)}` },
-                    JSX.createElement("h4", { class: "tsd-anchor-link", id: anchor },
-                        name,
-                        anchorIcon(context, anchor)),
-                    JSX.createElement(JSX.Raw, { html: context.markdown(item.content) }))));
-        })),
+        tagsContents.length > 0 && (JSX.createElement("div", { class: "tsd-comment tsd-typography" }, tagsContents)),
         afterTags));
 }
 export function reflectionFlags(context, props) {

package/dist/lib/output/themes/default/partials/member.declaration.d.ts

@@ -1,4 +1,4 @@
-import type { DeclarationReflection } from "../../../../models/index.js";
+import type { DeclarationReflection } from "#models";
 import { JSX } from "#utils";
 import type { DefaultThemeRenderContext } from "../DefaultThemeRenderContext.js";
 export declare function memberDeclaration(context: DefaultThemeRenderContext, props: DeclarationReflection): JSX.Element;

package/dist/lib/output/themes/default/partials/member.declaration.js

@@ -1,30 +1,32 @@
 import { JSX } from "#utils";
 import { FormattedCodeBuilder, FormattedCodeGenerator, Wrap } from "../../../formatter.js";
 import { hasTypeParameters } from "../../lib.js";
+function shouldRenderDefaultValue(props) {
+    const defaultValue = props.defaultValue;
+    if (defaultValue === undefined) {
+        return false;
+    }
+    /** Fix for #2717. If type is the same as value the default value is omitted */
+    if (props.type && props.type.type === "literal") {
+        const reflectionTypeString = props.type.toString();
+        if (reflectionTypeString === defaultValue) {
+            return false;
+        }
+    }
+    return true;
+}
 export function memberDeclaration(context, props) {
     const builder = new FormattedCodeBuilder(context.router, context.model);
     const content = [];
     builder.member(content, props, { topLevelLinks: false });
     const generator = new FormattedCodeGenerator(context.options.getValue("typePrintWidth"));
     generator.node({ type: "nodes", content }, Wrap.Detect);
-    /** Fix for #2717. If type is the same as value the default value is omitted */
-    function shouldRenderDefaultValue() {
-        if (props.type && props.type.type === "literal") {
-            const reflectionTypeString = props.type.toString();
-            const defaultValue = props.defaultValue;
-            if (defaultValue === undefined || reflectionTypeString === defaultValue.toString()) {
-                return false;
-            }
-        }
-        return true;
-    }
     return (JSX.createElement(JSX.Fragment, null,
         JSX.createElement("div", { class: "tsd-signature" },
             generator.toElement(),
-            !!props.defaultValue && shouldRenderDefaultValue() && (JSX.createElement(JSX.Fragment, null,
-                JSX.createElement("span", { class: "tsd-signature-symbol" },
-                    " = ",
-                    props.defaultValue)))),
+            shouldRenderDefaultValue(props) && (JSX.createElement("span", { class: "tsd-signature-symbol" },
+                " = ",
+                props.defaultValue))),
         context.commentSummary(props),
         hasTypeParameters(props) && context.typeParameters(props.typeParameters),
         props.type && context.typeDeclaration(props, props.type),

package/dist/lib/output/themes/default/partials/member.signature.body.js

@@ -11,7 +11,7 @@ export function memberSignatureBody(context, props, { hideSources = false } = {}
             JSX.createElement("ul", { class: "tsd-parameter-list" }, props.parameters.map((item) => (JSX.createElement("li", null,
                 JSX.createElement("span", null,
                     context.reflectionFlags(item),
-                    !!item.flags.isRest && JSX.createElement("span", { class: "tsd-signature-symbol" }, "..."),
+                    item.flags.isRest && JSX.createElement("span", { class: "tsd-signature-symbol" }, "..."),
                     JSX.createElement("span", { class: "tsd-kind-parameter" }, item.name),
                     ": ",
                     context.type(item.type),

package/dist/lib/output/themes/default/partials/moduleReflection.js

@@ -5,7 +5,7 @@ import { anchorIcon } from "./anchor-icon.js";
 export function moduleReflection(context, mod) {
     const sections = getMemberSections(mod);
     return (JSX.createElement(JSX.Fragment, null,
-        mod.hasComment() && (JSX.createElement("section", { class: "tsd-panel tsd-comment" },
+        mod.hasComment(context.options.getValue("notRenderedTags")) && (JSX.createElement("section", { class: "tsd-panel tsd-comment" },
             context.commentSummary(mod),
             context.commentTags(mod))),
         mod.isDeclaration() && mod.kind === ReflectionKind.Module && !!mod.readme?.length && (JSX.createElement("section", { class: "tsd-panel tsd-typography" },