typedoc 0.24.0-beta.4 → 0.24.0-beta.6

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

@@ -10,6 +10,19 @@ const utils_1 = require("../../utils");
 const declaration_1 = require("../../utils/options/declaration");
 const paths_1 = require("../../utils/paths");
 const assert_1 = require("assert");
+const variablePropertyKinds = [
+    typescript_1.default.SyntaxKind.PropertyDeclaration,
+    typescript_1.default.SyntaxKind.PropertySignature,
+    typescript_1.default.SyntaxKind.BinaryExpression,
+    typescript_1.default.SyntaxKind.PropertyAssignment,
+    // class X { constructor(/** Comment */ readonly z: string) }
+    typescript_1.default.SyntaxKind.Parameter,
+    // Variable values
+    typescript_1.default.SyntaxKind.VariableDeclaration,
+    typescript_1.default.SyntaxKind.BindingElement,
+    typescript_1.default.SyntaxKind.ExportAssignment,
+    typescript_1.default.SyntaxKind.PropertyAccessExpression,
+];
 // Note: This does NOT include JSDoc syntax kinds. This is important!
 // Comments from @typedef and @callback tags are handled specially by
 // the JSDoc converter because we only want part of the comment when
@@ -23,6 +36,11 @@ const wantedKinds = {
         typescript_1.default.SyntaxKind.BindingElement,
         typescript_1.default.SyntaxKind.ExportSpecifier,
         typescript_1.default.SyntaxKind.NamespaceExport,
+        // @namespace support
+        typescript_1.default.SyntaxKind.VariableDeclaration,
+        typescript_1.default.SyntaxKind.BindingElement,
+        typescript_1.default.SyntaxKind.ExportAssignment,
+        typescript_1.default.SyntaxKind.PropertyAccessExpression,
     ],
     [models_1.ReflectionKind.Enum]: [
         typescript_1.default.SyntaxKind.EnumDeclaration,
@@ -34,12 +52,7 @@ const wantedKinds = {
         typescript_1.default.SyntaxKind.PropertyAssignment,
         typescript_1.default.SyntaxKind.PropertySignature,
     ],
-    [models_1.ReflectionKind.Variable]: [
-        typescript_1.default.SyntaxKind.VariableDeclaration,
-        typescript_1.default.SyntaxKind.BindingElement,
-        typescript_1.default.SyntaxKind.ExportAssignment,
-        typescript_1.default.SyntaxKind.PropertyAccessExpression,
-    ],
+    [models_1.ReflectionKind.Variable]: variablePropertyKinds,
     [models_1.ReflectionKind.Function]: [
         typescript_1.default.SyntaxKind.FunctionDeclaration,
         typescript_1.default.SyntaxKind.BindingElement,
@@ -51,16 +64,12 @@ const wantedKinds = {
         typescript_1.default.SyntaxKind.ClassDeclaration,
         typescript_1.default.SyntaxKind.BindingElement,
     ],
-    [models_1.ReflectionKind.Interface]: [typescript_1.default.SyntaxKind.InterfaceDeclaration],
-    [models_1.ReflectionKind.Constructor]: [typescript_1.default.SyntaxKind.Constructor],
-    [models_1.ReflectionKind.Property]: [
-        typescript_1.default.SyntaxKind.PropertyDeclaration,
-        typescript_1.default.SyntaxKind.PropertySignature,
-        typescript_1.default.SyntaxKind.BinaryExpression,
-        typescript_1.default.SyntaxKind.PropertyAssignment,
-        // class X { constructor(/** Comment */ readonly z: string) }
-        typescript_1.default.SyntaxKind.Parameter,
+    [models_1.ReflectionKind.Interface]: [
+        typescript_1.default.SyntaxKind.InterfaceDeclaration,
+        typescript_1.default.SyntaxKind.TypeAliasDeclaration,
     ],
+    [models_1.ReflectionKind.Constructor]: [typescript_1.default.SyntaxKind.Constructor],
+    [models_1.ReflectionKind.Property]: variablePropertyKinds,
     [models_1.ReflectionKind.Method]: [
         typescript_1.default.SyntaxKind.FunctionDeclaration,
         typescript_1.default.SyntaxKind.MethodDeclaration,

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

@@ -31,13 +31,9 @@ export declare class Context {
      * The scope or parent reflection that is currently processed.
      */
     readonly scope: Reflection;
-    /** @internal */
-    isConvertingTypeNode(): boolean;
-    /** @internal */
-    setConvertingTypeNode(): void;
-    /** @internal */
+    convertingTypeNode: boolean;
+    convertingClassOrInterface: boolean;
     shouldBeStatic: boolean;
-    private convertingTypeNode;
     /**
      * Create a new Context instance.
      *
@@ -47,10 +43,6 @@ export declare class Context {
     constructor(converter: Converter, programs: readonly ts.Program[], project: ProjectReflection, scope?: Context["scope"]);
     /** @internal */
     get logger(): import("../utils").Logger;
-    /**
-     * Return the compiler options.
-     */
-    getCompilerOptions(): ts.CompilerOptions;
     /**
      * Return the type declaration of the given node.
      *

package/dist/lib/converter/context.js

@@ -30,14 +30,6 @@ class Context {
         (0, assert_1.ok)(this._program, "Tried to access Context.program when not converting a source file");
         return this._program;
     }
-    /** @internal */
-    isConvertingTypeNode() {
-        return this.convertingTypeNode;
-    }
-    /** @internal */
-    setConvertingTypeNode() {
-        this.convertingTypeNode = true;
-    }
     /**
      * Create a new Context instance.
      *
@@ -45,9 +37,9 @@ class Context {
      * @internal
      */
     constructor(converter, programs, project, scope = project) {
-        /** @internal */
-        this.shouldBeStatic = false;
-        this.convertingTypeNode = false;
+        this.convertingTypeNode = false; // Inherited by withScope
+        this.convertingClassOrInterface = false; // Not inherited
+        this.shouldBeStatic = false; // Not inherited
         this.converter = converter;
         this.programs = programs;
         this.project = project;
@@ -57,12 +49,6 @@ class Context {
     get logger() {
         return this.converter.application.logger;
     }
-    /**
-     * Return the compiler options.
-     */
-    getCompilerOptions() {
-        return this.converter.application.options.getCompilerOptions();
-    }
     /**
      * Return the type declaration of the given node.
      *
@@ -112,6 +98,14 @@ class Context {
     // We need this because modules don't always have symbols.
     nameOverride) {
         const name = (0, tsutils_1.getHumanName)(nameOverride ?? exportSymbol?.name ?? symbol?.name ?? "unknown");
+        if (this.convertingClassOrInterface) {
+            if (kind === index_1.ReflectionKind.Function) {
+                kind = index_1.ReflectionKind.Method;
+            }
+            if (kind === index_1.ReflectionKind.Variable) {
+                kind = index_1.ReflectionKind.Property;
+            }
+        }
         const reflection = new index_1.DeclarationReflection(name, kind, this.scope);
         this.postReflectionCreation(reflection, symbol, exportSymbol);
         return reflection;

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

@@ -117,6 +117,12 @@ let CommentPlugin = class CommentPlugin extends components_1.ConverterComponent
      * @param comment  The comment that should be searched for modifiers.
      */
     applyModifiers(reflection, comment) {
+        if (reflection.kindOf(models_1.ReflectionKind.SomeModule)) {
+            comment.removeModifier("@namespace");
+        }
+        if (reflection.kindOf(models_1.ReflectionKind.Interface)) {
+            comment.removeModifier("@interface");
+        }
         if (comment.hasModifier("@private")) {
             reflection.setFlag(models_1.ReflectionFlag.Private);
             if (reflection.kindOf(models_1.ReflectionKind.CallSignature)) {
@@ -267,6 +273,7 @@ let CommentPlugin = class CommentPlugin extends components_1.ConverterComponent
                     `Labels may only contain A-Z, 0-9, and _, and may not start with a number.`);
             }
             mergeSeeTags(reflection.comment);
+            movePropertyTags(reflection.comment, reflection);
         }
         if (!(reflection instanceof models_1.DeclarationReflection)) {
             return;
@@ -445,6 +452,19 @@ function moveNestedParamTags(comment, parameter) {
     };
     parameter.type?.visit(visitor);
 }
+function movePropertyTags(comment, container) {
+    const propTags = comment.blockTags.filter((tag) => tag.tag === "@prop" || tag.tag === "@property");
+    comment.removeTags("@prop");
+    comment.removeTags("@property");
+    for (const prop of propTags) {
+        if (!prop.name)
+            continue;
+        const child = container.getChildByName(prop.name);
+        if (child) {
+            child.comment = new models_1.Comment(models_1.Comment.cloneDisplayParts(prop.content));
+        }
+    }
+}
 function mergeSeeTags(comment) {
     const see = comment.getTags("@see");
     if (see.length < 2)

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

@@ -75,6 +75,9 @@ let SourcePlugin = class SourcePlugin extends components_1.ConverterComponent {
             if ((0, nodes_1.isNamedNode)(node)) {
                 position = typescript_1.default.getLineAndCharacterOfPosition(sourceFile, node.name.getStart());
             }
+            else if (typescript_1.default.isSourceFile(node)) {
+                position = { character: 0, line: 0 };
+            }
             else {
                 position = typescript_1.default.getLineAndCharacterOfPosition(sourceFile, node.getStart());
             }

package/dist/lib/converter/symbols.js

@@ -191,6 +191,9 @@ function convertTypeAlias(context, symbol, exportSymbol) {
         typescript_1.default.isJSDocEnumTag(d));
     (0, assert_1.default)(declaration);
     if (typescript_1.default.isTypeAliasDeclaration(declaration)) {
+        if (symbol.getJsDocTags().some((tag) => tag.name === "interface")) {
+            return convertTypeAliasAsInterface(context, symbol, exportSymbol, declaration);
+        }
         const reflection = context.createDeclarationReflection(models_1.ReflectionKind.TypeAlias, symbol, exportSymbol);
         reflection.type = context.converter.convertType(context.withScope(reflection), declaration.type);
         context.finalizeDeclarationReflection(reflection);
@@ -206,6 +209,30 @@ function convertTypeAlias(context, symbol, exportSymbol) {
         (0, jsdoc_1.convertJsDocCallback)(context, symbol, declaration, exportSymbol);
     }
 }
+function convertTypeAliasAsInterface(context, symbol, exportSymbol, declaration) {
+    const reflection = context.createDeclarationReflection(models_1.ReflectionKind.Interface, symbol, exportSymbol);
+    context.finalizeDeclarationReflection(reflection);
+    const rc = context.withScope(reflection);
+    const type = context.checker.getTypeAtLocation(declaration);
+    // Interfaces have properties
+    convertSymbols(rc, type.getProperties());
+    // And type arguments
+    if (declaration.typeParameters) {
+        reflection.typeParameters = declaration.typeParameters.map((param) => {
+            const declaration = param.symbol?.declarations?.[0];
+            (0, assert_1.default)(declaration && typescript_1.default.isTypeParameterDeclaration(declaration));
+            return (0, signature_1.createTypeParamReflection)(declaration, rc);
+        });
+    }
+    // And maybe call signatures
+    context.checker
+        .getSignaturesOfType(type, typescript_1.default.SignatureKind.Call)
+        .forEach((sig) => (0, signature_1.createSignature)(rc, models_1.ReflectionKind.CallSignature, sig, symbol));
+    // And maybe constructor signatures
+    convertConstructSignatures(rc, symbol);
+    // And finally, index signatures
+    (0, index_signature_1.convertIndexSignature)(rc, symbol);
+}
 function convertFunctionOrMethod(context, symbol, exportSymbol) {
     // Can't just check method flag because this might be called for properties as well
     // This will *NOT* be called for variables that look like functions, they need a special case.
@@ -258,6 +285,7 @@ function convertClassOrInterface(context, symbol, exportSymbol) {
     if (classDeclaration)
         setModifiers(symbol, classDeclaration, reflection);
     const reflectionContext = context.withScope(reflection);
+    reflectionContext.convertingClassOrInterface = true;
     const instanceType = context.checker.getDeclaredTypeOfSymbol(symbol);
     (0, assert_1.default)(instanceType.isClassOrInterface());
     // We might do some inheritance - do this first so that it's set when converting properties
@@ -362,7 +390,7 @@ function convertProperty(context, symbol, exportSymbol) {
         setModifiers(symbol, declaration, reflection);
     }
     reflection.defaultValue = declaration && (0, convert_expression_1.convertDefaultValue)(declaration);
-    reflection.type = context.converter.convertType(context.withScope(reflection), (context.isConvertingTypeNode() ? parameterType : void 0) ??
+    reflection.type = context.converter.convertType(context.withScope(reflection), (context.convertingTypeNode ? parameterType : void 0) ??
         context.checker.getTypeOfSymbol(symbol));
     if (reflection.flags.isOptional) {
         reflection.type = (0, reflections_1.removeUndefined)(reflection.type);
@@ -429,6 +457,9 @@ function convertVariable(context, symbol, exportSymbol) {
         symbol.getJsDocTags().some((tag) => tag.name === "enum")) {
         return convertVariableAsEnum(context, symbol, exportSymbol);
     }
+    if (symbol.getJsDocTags().some((tag) => tag.name === "namespace")) {
+        return convertVariableAsNamespace(context, symbol, exportSymbol);
+    }
     if (type.getCallSignatures().length) {
         return convertVariableAsFunction(context, symbol, exportSymbol);
     }
@@ -471,6 +502,15 @@ function convertVariableAsEnum(context, symbol, exportSymbol) {
     // Skip converting the type alias, if there is one
     return typescript_1.default.SymbolFlags.TypeAlias;
 }
+function convertVariableAsNamespace(context, symbol, exportSymbol) {
+    const reflection = context.createDeclarationReflection(models_1.ReflectionKind.Namespace, symbol, exportSymbol);
+    context.finalizeDeclarationReflection(reflection);
+    const rc = context.withScope(reflection);
+    const declaration = symbol.declarations[0];
+    const type = context.checker.getTypeAtLocation(declaration);
+    convertSymbols(rc, type.getProperties());
+    return typescript_1.default.SymbolFlags.Property;
+}
 function convertVariableAsFunction(context, symbol, exportSymbol) {
     const declaration = symbol
         .getDeclarations()

package/dist/lib/converter/types.js

@@ -143,7 +143,7 @@ const constructorConverter = {
         }
         const reflection = new models_1.DeclarationReflection("__type", models_1.ReflectionKind.Constructor, context.scope);
         const rc = context.withScope(reflection);
-        rc.setConvertingTypeNode();
+        rc.convertingTypeNode = true;
         context.registerReflection(reflection, symbol);
         context.trigger(converter_events_1.ConverterEvents.CREATE_DECLARATION, reflection);
         const signature = new models_1.SignatureReflection("__type", models_1.ReflectionKind.ConstructorSignature, reflection);
@@ -346,7 +346,7 @@ const typeLiteralConverter = {
         }
         const reflection = new models_1.DeclarationReflection("__type", models_1.ReflectionKind.TypeLiteral, context.scope);
         const rc = context.withScope(reflection);
-        rc.setConvertingTypeNode();
+        rc.convertingTypeNode = true;
         context.registerReflection(reflection, symbol);
         context.trigger(converter_events_1.ConverterEvents.CREATE_DECLARATION, reflection);
         for (const prop of context.checker.getPropertiesOfType(type)) {

package/dist/lib/output/renderer.d.ts

@@ -132,9 +132,12 @@ export declare class Renderer extends ChildableComponent<Application, RendererCo
     /** @internal */
     githubPages: boolean;
     /** @internal */
+    cacheBust: boolean;
+    /** @internal */
     lightTheme: ShikiTheme;
     /** @internal */
     darkTheme: ShikiTheme;
+    renderStartTime: number;
     /**
      * Define a new theme that can be used to render output.
      * This API will likely be changing at some point, to allow more easily overriding parts of the theme without

package/dist/lib/output/renderer.js

@@ -117,6 +117,7 @@ let Renderer = class Renderer extends component_1.ChildableComponent {
          * See {@link RendererHooks} for a description of each available hook, and when it will be called.
          */
         this.hooks = new utils_1.EventHooks();
+        this.renderStartTime = -1;
     }
     /**
      * Define a new theme that can be used to render output.
@@ -139,9 +140,9 @@ let Renderer = class Renderer extends component_1.ChildableComponent {
      */
     async render(project, outputDirectory) {
         const momento = this.hooks.saveMomento();
-        const start = Date.now();
+        this.renderStartTime = Date.now();
         await (0, highlighter_1.loadHighlighter)(this.lightTheme, this.darkTheme);
-        this.application.logger.verbose(`Renderer: Loading highlighter took ${Date.now() - start}ms`);
+        this.application.logger.verbose(`Renderer: Loading highlighter took ${Date.now() - this.renderStartTime}ms`);
         if (!this.prepareTheme() ||
             !(await this.prepareOutputDirectory(outputDirectory))) {
             return;
@@ -286,6 +287,9 @@ __decorate([
 __decorate([
     (0, utils_1.BindOption)("githubPages")
 ], Renderer.prototype, "githubPages", void 0);
+__decorate([
+    (0, utils_1.BindOption)("cacheBust")
+], Renderer.prototype, "cacheBust", void 0);
 __decorate([
     (0, utils_1.BindOption)("lightHighlightTheme")
 ], Renderer.prototype, "lightTheme", void 0);

package/dist/lib/output/themes/default/DefaultThemeRenderContext.d.ts

@@ -9,7 +9,7 @@ export declare class DefaultThemeRenderContext {
     icons: Record<"search" | "anchor" | ReflectionKind | "checkbox" | "chevronDown" | "menu" | "chevronSmall", () => import("../../../utils/jsx.elements").JsxElement>;
     hook: (name: keyof RendererHooks) => import("../../../utils/jsx.elements").JsxElement[];
     /** Avoid this in favor of urlTo if possible */
-    relativeURL: (url: string | undefined) => string | undefined;
+    relativeURL: (url: string, cacheBust?: boolean) => string;
     urlTo: (reflection: Reflection) => string;
     markdown: (md: readonly CommentDisplayPart[] | NeverIfInternal<string | undefined>) => string;
     /**

package/dist/lib/output/themes/default/DefaultThemeRenderContext.js

@@ -38,10 +38,16 @@ class DefaultThemeRenderContext {
         this.icons = icon_1.icons;
         this.hook = (name) => this.theme.owner.hooks.emit(name, this);
         /** Avoid this in favor of urlTo if possible */
-        this.relativeURL = (url) => {
-            return url ? this.theme.markedPlugin.getRelativeUrl(url) : url;
+        this.relativeURL = (url, cacheBust = false) => {
+            const result = this.theme.markedPlugin.getRelativeUrl(url);
+            if (cacheBust && this.theme.owner.cacheBust) {
+                return result + `?cache=${this.theme.owner.renderStartTime}`;
+            }
+            return result;
+        };
+        this.urlTo = (reflection) => {
+            return reflection.url ? this.relativeURL(reflection.url) : "";
         };
-        this.urlTo = (reflection) => this.relativeURL(reflection.url);
         this.markdown = (md) => {
             if (md instanceof Array) {
                 return this.theme.markedPlugin.parseMarkdown(models_1.Comment.displayPartsToMarkdown(md, this.urlTo));

package/dist/lib/output/themes/default/layouts/default.js

@@ -12,10 +12,10 @@ const defaultLayout = (context, props) => (utils_1.JSX.createElement("html", { c
             : `${props.model.name} | ${props.project.name}`),
         utils_1.JSX.createElement("meta", { name: "description", content: "Documentation for " + props.project.name }),
         utils_1.JSX.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }),
-        utils_1.JSX.createElement("link", { rel: "stylesheet", href: context.relativeURL("assets/style.css") }),
-        utils_1.JSX.createElement("link", { rel: "stylesheet", href: context.relativeURL("assets/highlight.css") }),
-        context.options.getValue("customCss") && (utils_1.JSX.createElement("link", { rel: "stylesheet", href: context.relativeURL("assets/custom.css") })),
-        utils_1.JSX.createElement("script", { async: true, src: context.relativeURL("assets/search.js"), id: "search-script" }),
+        utils_1.JSX.createElement("link", { rel: "stylesheet", href: context.relativeURL("assets/style.css", true) }),
+        utils_1.JSX.createElement("link", { rel: "stylesheet", href: context.relativeURL("assets/highlight.css", true) }),
+        context.options.getValue("customCss") && (utils_1.JSX.createElement("link", { rel: "stylesheet", href: context.relativeURL("assets/custom.css", true) })),
+        utils_1.JSX.createElement("script", { async: true, src: context.relativeURL("assets/search.js", true), id: "search-script" }),
         context.hook("head.end")),
     utils_1.JSX.createElement("body", null,
         context.hook("body.begin"),
@@ -34,7 +34,7 @@ const defaultLayout = (context, props) => (utils_1.JSX.createElement("html", { c
                 context.hook("content.end"))),
         context.footer(),
         utils_1.JSX.createElement("div", { class: "overlay" }),
-        utils_1.JSX.createElement("script", { src: context.relativeURL("assets/main.js") }),
+        utils_1.JSX.createElement("script", { src: context.relativeURL("assets/main.js", true) }),
         context.analytics(),
         context.hook("body.end"))));
 exports.defaultLayout = defaultLayout;

package/dist/lib/utils/options/declaration.d.ts

@@ -26,6 +26,7 @@ export type CommentStyle = (typeof CommentStyle)[keyof typeof CommentStyle];
  * An interface describing all TypeDoc specific options. Generated from a
  * map which contains more information about each option for better types when
  * defining said options.
+ * @interface
  */
 export type TypeDocOptions = {
     [K in keyof TypeDocOptionMap]: unknown extends TypeDocOptionMap[K] ? unknown : TypeDocOptionMap[K] extends ManuallyValidatedOption<infer ManuallyValidated> ? ManuallyValidated : TypeDocOptionMap[K] extends string | string[] | number | boolean ? TypeDocOptionMap[K] : TypeDocOptionMap[K] extends Record<string, boolean> ? Partial<TypeDocOptionMap[K]> | boolean : keyof TypeDocOptionMap[K] | TypeDocOptionMap[K][keyof TypeDocOptionMap[K]];
@@ -34,6 +35,7 @@ export type TypeDocOptions = {
  * Describes all TypeDoc specific options as returned by {@link Options.getValue}, this is
  * slightly more restrictive than the {@link TypeDocOptions} since it does not allow both
  * keys and values for mapped option types, and does not allow partials of flag values.
+ * @interface
  */
 export type TypeDocOptionValues = {
     [K in keyof TypeDocOptionMap]: unknown extends TypeDocOptionMap[K] ? unknown : TypeDocOptionMap[K] extends ManuallyValidatedOption<infer ManuallyValidated> ? ManuallyValidated : TypeDocOptionMap[K] extends string | string[] | number | boolean | Record<string, boolean> ? TypeDocOptionMap[K] : TypeDocOptionMap[K][keyof TypeDocOptionMap[K]];
@@ -93,6 +95,7 @@ export interface TypeDocOptionMap {
     githubPages: boolean;
     gaID: string;
     hideGenerator: boolean;
+    cacheBust: boolean;
     searchInComments: boolean;
     cleanOutputDir: boolean;
     titleLink: string;

package/dist/lib/utils/options/sources/typedoc.js

@@ -347,6 +347,11 @@ function addTypeDocOptions(options) {
         help: "Do not print the TypeDoc link at the end of the page.",
         type: declaration_1.ParameterType.Boolean,
     });
+    options.addDeclaration({
+        name: "cacheBust",
+        help: "Include the generation time in links to static assets.",
+        type: declaration_1.ParameterType.Boolean,
+    });
     options.addDeclaration({
         name: "searchInComments",
         help: "If set, the search index will also include comments. This will greatly increase the size of the search index.",

package/dist/lib/utils/options/tsdoc-defaults.d.ts

@@ -3,4 +3,4 @@ export declare const blockTags: readonly ["@deprecated", "@param", "@remarks", "
 export declare const tsdocInlineTags: readonly ["@link", "@inheritDoc", "@label"];
 export declare const inlineTags: string[];
 export declare const tsdocModifierTags: readonly ["@public", "@private", "@protected", "@internal", "@readonly", "@packageDocumentation", "@eventProperty", "@alpha", "@beta", "@experimental", "@sealed", "@override", "@virtual"];
-export declare const modifierTags: readonly ["@public", "@private", "@protected", "@internal", "@readonly", "@packageDocumentation", "@eventProperty", "@alpha", "@beta", "@experimental", "@sealed", "@override", "@virtual", "@hidden", "@ignore", "@enum", "@event", "@overload"];
+export declare const modifierTags: readonly ["@public", "@private", "@protected", "@internal", "@readonly", "@packageDocumentation", "@eventProperty", "@alpha", "@beta", "@experimental", "@sealed", "@override", "@virtual", "@hidden", "@ignore", "@enum", "@event", "@overload", "@namespace", "@interface"];

package/dist/lib/utils/options/tsdoc-defaults.js

@@ -52,4 +52,6 @@ exports.modifierTags = [
     "@enum",
     "@event",
     "@overload",
+    "@namespace",
+    "@interface",
 ];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "typedoc",
   "description": "Create api documentation for TypeScript projects.",
-  "version": "0.24.0-beta.4",
+  "version": "0.24.0-beta.6",
   "homepage": "https://typedoc.org",
   "exports": {
     ".": "./dist/index.js",

package/tsdoc.json

@@ -82,6 +82,14 @@
         {
             "tagName": "@overload",
             "syntaxKind": "modifier"
+        },
+        {
+            "tagName": "@namespace",
+            "syntaxKind": "modifier"
+        },
+        {
+            "tagName": "@interface",
+            "syntaxKind": "modifier"
         }
     ]
 }