typedoc 0.24.8 → 0.25.1

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

@@ -40,7 +40,7 @@ const parameter = (context, props) => (utils_1.JSX.createElement(utils_1.JSX.Fra
             context.memberSignatures(item))) : item.type ? (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
             utils_1.JSX.createElement("li", { class: "tsd-parameter" },
                 utils_1.JSX.createElement("h5", null,
-                    (0, lib_1.renderFlags)(item.flags, item.comment),
+                    context.reflectionFlags(item),
                     !!item.flags.isRest && utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "..."),
                     utils_1.JSX.createElement("span", { class: (0, lib_1.getKindClass)(item) }, (0, lib_1.wbr)(item.name)),
                     utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" },
@@ -54,7 +54,7 @@ const parameter = (context, props) => (utils_1.JSX.createElement(utils_1.JSX.Fra
             item.getSignature && (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
                 utils_1.JSX.createElement("li", { class: "tsd-parameter" },
                     utils_1.JSX.createElement("h5", null,
-                        (0, lib_1.renderFlags)(item.getSignature.flags, item.getSignature.comment),
+                        context.reflectionFlags(item.getSignature),
                         utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "get "),
                         utils_1.JSX.createElement("span", { class: (0, lib_1.getKindClass)(item) }, (0, lib_1.wbr)(item.name)),
                         utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "(): "),
@@ -64,7 +64,7 @@ const parameter = (context, props) => (utils_1.JSX.createElement(utils_1.JSX.Fra
             item.setSignature && (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
                 utils_1.JSX.createElement("li", { class: "tsd-parameter" },
                     utils_1.JSX.createElement("h5", null,
-                        (0, lib_1.renderFlags)(item.setSignature.flags, item.setSignature.comment),
+                        context.reflectionFlags(item.setSignature),
                         utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "set "),
                         utils_1.JSX.createElement("span", { class: (0, lib_1.getKindClass)(item) }, (0, lib_1.wbr)(item.name)),
                         utils_1.JSX.createElement("span", { class: "tsd-signature-symbol" }, "("),

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

@@ -1,5 +1,5 @@
 import type { DefaultThemeRenderContext } from "..";
-import { Comment, Reflection, ReflectionFlags, TypeParameterReflection } from "../../models";
+import { Reflection, TypeParameterReflection } from "../../models";
 import { JSX } from "../../utils";
 export declare function stringify(data: unknown): string;
 export declare function getDisplayName(refl: Reflection): string;
@@ -15,7 +15,6 @@ export declare function getKindClass(refl: Reflection): string;
  */
 export declare function wbr(str: string): (string | JSX.Element)[];
 export declare function join<T>(joiner: JSX.Children, list: readonly T[], cb: (x: T) => JSX.Children): JSX.Element;
-export declare function renderFlags(flags: ReflectionFlags, comment: Comment | undefined): JSX.Element;
 export declare function classNames(names: Record<string, boolean | null | undefined>, extraCss?: string): string | undefined;
 export declare function hasTypeParameters(reflection: Reflection): reflection is Reflection & {
     typeParameters: TypeParameterReflection[];

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderName = exports.camelToTitleCase = exports.renderTypeParametersSignature = exports.hasTypeParameters = exports.classNames = exports.renderFlags = exports.join = exports.wbr = exports.getKindClass = exports.toStyleClass = exports.getDisplayName = exports.stringify = void 0;
+exports.renderName = exports.camelToTitleCase = exports.renderTypeParametersSignature = exports.hasTypeParameters = exports.classNames = exports.join = exports.wbr = exports.getKindClass = exports.toStyleClass = exports.getDisplayName = exports.stringify = void 0;
 const models_1 = require("../../models");
 const utils_1 = require("../../utils");
 function stringify(data) {
@@ -62,16 +62,6 @@ function join(joiner, list, cb) {
     return utils_1.JSX.createElement(utils_1.JSX.Fragment, null, result);
 }
 exports.join = join;
-function renderFlags(flags, comment) {
-    const allFlags = [...flags];
-    if (comment) {
-        allFlags.push(...Array.from(comment.modifierTags, (tag) => tag.replace(/@([a-z])/, (x) => x[1].toUpperCase())));
-    }
-    return (utils_1.JSX.createElement(utils_1.JSX.Fragment, null, allFlags.map((item) => (utils_1.JSX.createElement(utils_1.JSX.Fragment, null,
-        utils_1.JSX.createElement("code", { class: "tsd-tag ts-flag" + item }, item),
-        " ")))));
-}
-exports.renderFlags = renderFlags;
 function classNames(names, extraCss) {
     const css = Object.keys(names)
         .filter((key) => names[key])

package/dist/lib/serialization/schema.d.ts

@@ -57,9 +57,11 @@ export interface ReflectionGroup extends S<M.ReflectionGroup, "title" | "categor
 export interface ReflectionCategory extends S<M.ReflectionCategory, "title"> {
     children?: M.ReflectionCategory["children"][number]["id"][];
 }
+/** @category Reflections */
 export type SomeReflection = {
     [K in keyof M.ReflectionVariant]: ModelToObject<M.ReflectionVariant[K]>;
 }[keyof M.ReflectionVariant];
+/** @category Reflections */
 export interface ReferenceReflection extends Omit<DeclarationReflection, "variant">, S<M.ReferenceReflection, "variant"> {
     /**
      * -1 if the reference refers to a symbol that does not exist in the documentation.
@@ -67,25 +69,34 @@ export interface ReferenceReflection extends Omit<DeclarationReflection, "varian
      */
     target: number;
 }
+/** @category Reflections */
 export interface SignatureReflection extends Omit<Reflection, "variant">, S<M.SignatureReflection, "variant" | "sources" | "parameters" | "type" | "overwrites" | "inheritedFrom" | "implementationOf"> {
     typeParameter?: ModelToObject<M.SignatureReflection["typeParameters"]>;
 }
+/** @category Reflections */
 export interface ParameterReflection extends Omit<Reflection, "variant">, S<M.ParameterReflection, "variant" | "type" | "defaultValue"> {
     variant: "param";
 }
+/** @category Reflections */
 export interface DeclarationReflection extends Omit<ContainerReflection, "variant">, S<M.DeclarationReflection, "variant" | "packageVersion" | "sources" | "relevanceBoost" | "type" | "signatures" | "indexSignature" | "defaultValue" | "overwrites" | "inheritedFrom" | "implementationOf" | "extendedTypes" | "extendedBy" | "implementedTypes" | "implementedBy" | "getSignature" | "setSignature" | "typeParameters"> {
 }
+/** @category Reflections */
 export interface TypeParameterReflection extends Omit<Reflection, "variant">, S<M.TypeParameterReflection, "variant" | "type" | "default" | "varianceModifier"> {
 }
+/** @category Reflections */
 export interface ProjectReflection extends Omit<ContainerReflection, "variant">, S<M.ProjectReflection, "variant" | "packageName" | "packageVersion" | "readme"> {
     symbolIdMap: Record<number, ReflectionSymbolId>;
 }
+/** @category Reflections */
 export interface ContainerReflection extends Reflection, S<M.ContainerReflection, "children" | "groups" | "categories"> {
 }
+/** @category Reflections */
 export interface Reflection extends S<M.Reflection, "id" | "variant" | "name" | "kind" | "comment"> {
     flags: ReflectionFlags;
 }
+/** @category Types */
 export type SomeType = ModelToObject<M.SomeType>;
+/** @category Types */
 export type TypeKindMap = {
     array: ArrayType;
     conditional: ConditionalType;
@@ -108,51 +119,72 @@ export type TypeKindMap = {
     union: UnionType;
     unknown: UnknownType;
 };
+/** @category Types */
 export interface ArrayType extends Type, S<M.ArrayType, "type" | "elementType"> {
 }
+/** @category Types */
 export interface ConditionalType extends Type, S<M.ConditionalType, "type" | "checkType" | "extendsType" | "trueType" | "falseType"> {
 }
+/** @category Types */
 export interface IndexedAccessType extends Type, S<M.IndexedAccessType, "type" | "indexType" | "objectType"> {
 }
+/** @category Types */
 export interface InferredType extends Type, S<M.InferredType, "type" | "name" | "constraint"> {
 }
+/** @category Types */
 export interface IntersectionType extends Type, S<M.IntersectionType, "type" | "types"> {
 }
+/** @category Types */
 export interface IntrinsicType extends Type, S<M.IntrinsicType, "type" | "name"> {
 }
+/** @category Types */
 export interface OptionalType extends Type, S<M.OptionalType, "type" | "elementType"> {
 }
+/** @category Types */
 export interface PredicateType extends Type, S<M.PredicateType, "type" | "name" | "asserts" | "targetType"> {
 }
+/** @category Types */
 export interface QueryType extends Type, S<M.QueryType, "type" | "queryType"> {
 }
+/** @category Types */
 export interface ReferenceType extends Type, S<M.ReferenceType, "type" | "name" | "typeArguments" | "package" | "externalUrl"> {
     target: number | ReflectionSymbolId;
     qualifiedName?: string;
     refersToTypeParameter?: boolean;
 }
+/** @category Types */
 export interface ReflectionType extends Type, S<M.ReflectionType, "type" | "declaration"> {
 }
+/** @category Types */
 export interface RestType extends Type, S<M.RestType, "type" | "elementType"> {
 }
+/** @category Types */
 export interface LiteralType extends Type, S<M.LiteralType, "type" | "value"> {
 }
+/** @category Types */
 export interface TupleType extends Type, S<M.TupleType, "type"> {
     elements?: ModelToObject<M.TupleType["elements"]>;
 }
+/** @category Types */
 export interface NamedTupleMemberType extends Type, S<M.NamedTupleMember, "type" | "name" | "isOptional" | "element"> {
 }
+/** @category Types */
 export interface TemplateLiteralType extends Type, S<M.TemplateLiteralType, "type" | "head"> {
     tail: [SomeType, string][];
 }
+/** @category Types */
 export interface MappedType extends Type, S<M.MappedType, "type" | "parameter" | "parameterType" | "templateType" | "readonlyModifier" | "optionalModifier" | "nameType"> {
 }
+/** @category Types */
 export interface TypeOperatorType extends Type, S<M.TypeOperatorType, "type" | "operator" | "target"> {
 }
+/** @category Types */
 export interface UnionType extends Type, S<M.UnionType, "type" | "types"> {
 }
+/** @category Types */
 export interface UnknownType extends Type, S<M.UnknownType, "type" | "name"> {
 }
+/** @category Types */
 export interface Type {
 }
 type BoolKeys<T> = {
@@ -160,13 +192,16 @@ type BoolKeys<T> = {
 }[keyof T];
 export interface ReflectionFlags extends Partial<S<M.ReflectionFlags, BoolKeys<M.ReflectionFlags>>> {
 }
+/** @category Comments */
 export interface Comment extends Partial<S<M.Comment, "blockTags" | "label">> {
     summary: CommentDisplayPart[];
-    modifierTags?: string[];
+    modifierTags?: `@${string}`[];
 }
+/** @category Comments */
 export interface CommentTag extends S<M.CommentTag, "tag" | "name"> {
     content: CommentDisplayPart[];
 }
+/** @category Comments */
 export type CommentDisplayPart = {
     kind: "text";
     text: string;
@@ -177,6 +212,7 @@ export type CommentDisplayPart = {
 /**
  * If `target` is a number, it is a reflection ID. If a string, it is a URL.
  * `target` will only be set for `@link`, `@linkcode`, and `@linkplain` tags.
+ * @category Comments
  */
 export interface InlineTagDisplayPart {
     kind: "inline-tag";

package/dist/lib/utils/component.d.ts

@@ -23,7 +23,7 @@ export interface ComponentOptions {
 /**
  * Class decorator applied to Components
  */
-export declare function Component(options: ComponentOptions): ClassDecorator;
+export declare function Component(options: ComponentOptions): (target: Function, _context: unknown) => void;
 export declare class ComponentEvent extends Event {
     owner: ComponentHost;
     component: AbstractComponent<ComponentHost>;

package/dist/lib/utils/component.js

@@ -7,7 +7,9 @@ const childMappings = [];
  * Class decorator applied to Components
  */
 function Component(options) {
-    return (target) => {
+    // _context is ClassDecoratorContext, but that then requires a public constructor
+    // which Application does not have.
+    return (target, _context) => {
         const proto = target.prototype;
         if (!(proto instanceof AbstractComponent)) {
             throw new Error("The `Component` decorator can only be used with a subclass of `AbstractComponent`.");

package/dist/lib/utils/entry-point.d.ts

@@ -21,12 +21,6 @@ export declare const EntryPointStrategy: {
      * use the merge option to produce final output.
      */
     readonly Packages: "packages";
-    /**
-     * Will be removed in 0.25, this was called packages mode in 0.24.
-     * Alternative resolution mode useful for monorepos. With this mode, TypeDoc will look for a package.json
-     * and tsconfig.json under each provided entry point. The `main` field of each package will be documented.
-     */
-    readonly LegacyPackages: "legacy-packages";
     /**
      * Merges multiple previously generated output from TypeDoc's --json output together into a single project.
      */

package/dist/lib/utils/entry-point.js

@@ -30,7 +30,6 @@ exports.getExpandedEntryPointsForPaths = exports.getPackageDirectories = exports
 const path_1 = require("path");
 const typescript_1 = __importDefault(require("typescript"));
 const FS = __importStar(require("fs"));
-const Path = __importStar(require("path"));
 const package_manifest_1 = require("./package-manifest");
 const paths_1 = require("./paths");
 const fs_1 = require("./fs");
@@ -55,12 +54,6 @@ exports.EntryPointStrategy = {
      * use the merge option to produce final output.
      */
     Packages: "packages",
-    /**
-     * Will be removed in 0.25, this was called packages mode in 0.24.
-     * Alternative resolution mode useful for monorepos. With this mode, TypeDoc will look for a package.json
-     * and tsconfig.json under each provided entry point. The `main` field of each package will be documented.
-     */
-    LegacyPackages: "legacy-packages",
     /**
      * Merges multiple previously generated output from TypeDoc's --json output together into a single project.
      */
@@ -72,6 +65,7 @@ function getEntryPoints(logger, options) {
         return [];
     }
     const entryPoints = options.getValue("entryPoints");
+    const exclude = options.getValue("exclude");
     // May be set explicitly to be an empty array to only include a readme for a package
     // See #2264
     if (entryPoints.length === 0) {
@@ -81,13 +75,10 @@ function getEntryPoints(logger, options) {
     const strategy = options.getValue("entryPointStrategy");
     switch (strategy) {
         case exports.EntryPointStrategy.Resolve:
-            result = getEntryPointsForPaths(logger, expandGlobs(entryPoints, logger), options);
+            result = getEntryPointsForPaths(logger, expandGlobs(entryPoints, exclude, logger), options);
             break;
         case exports.EntryPointStrategy.Expand:
-            result = getExpandedEntryPointsForPaths(logger, expandGlobs(entryPoints, logger), options);
-            break;
-        case exports.EntryPointStrategy.LegacyPackages:
-            result = getEntryPointsForLegacyPackages(logger, entryPoints, options);
+            result = getExpandedEntryPointsForPaths(logger, expandGlobs(entryPoints, exclude, logger), options);
             break;
         case exports.EntryPointStrategy.Merge:
         case exports.EntryPointStrategy.Packages:
@@ -106,18 +97,23 @@ exports.getEntryPoints = getEntryPoints;
 function getWatchEntryPoints(logger, options, program) {
     let result;
     const entryPoints = options.getValue("entryPoints");
-    switch (options.getValue("entryPointStrategy")) {
+    const exclude = options.getValue("exclude");
+    const strategy = options.getValue("entryPointStrategy");
+    switch (strategy) {
         case exports.EntryPointStrategy.Resolve:
-            result = getEntryPointsForPaths(logger, entryPoints, options, [
-                program,
-            ]);
+            result = getEntryPointsForPaths(logger, expandGlobs(entryPoints, exclude, logger), options, [program]);
             break;
         case exports.EntryPointStrategy.Expand:
-            result = getExpandedEntryPointsForPaths(logger, entryPoints, options, [program]);
+            result = getExpandedEntryPointsForPaths(logger, expandGlobs(entryPoints, exclude, logger), options, [program]);
             break;
         case exports.EntryPointStrategy.Packages:
             logger.error("Watch mode does not support 'packages' style entry points.");
             break;
+        case exports.EntryPointStrategy.Merge:
+            logger.error("Watch mode does not support 'merge' style entry points.");
+            break;
+        default:
+            (0, general_1.assertNever)(strategy);
     }
     if (result && result.length === 0) {
         logger.error("Unable to find any entry points.");
@@ -141,7 +137,7 @@ function getModuleName(fileName, baseDir) {
  * Converts a list of file-oriented paths in to DocumentationEntryPoints for conversion.
  * This is in contrast with the package-oriented `getEntryPointsForPackages`
  */
-function getEntryPointsForPaths(logger, inputFiles, options, programs = getEntryPrograms(logger, options)) {
+function getEntryPointsForPaths(logger, inputFiles, options, programs = getEntryPrograms(inputFiles, logger, options)) {
     const baseDir = options.getValue("basePath") || (0, fs_1.deriveRootDir)(inputFiles);
     const entryPoints = [];
     entryLoop: for (const fileOrDir of inputFiles.map(paths_1.normalizePath)) {
@@ -169,32 +165,39 @@ function getEntryPointsForPaths(logger, inputFiles, options, programs = getEntry
     }
     return entryPoints;
 }
-function getExpandedEntryPointsForPaths(logger, inputFiles, options, programs = getEntryPrograms(logger, options)) {
+function getExpandedEntryPointsForPaths(logger, inputFiles, options, programs = getEntryPrograms(inputFiles, logger, options)) {
     return getEntryPointsForPaths(logger, expandInputFiles(logger, inputFiles, options), options, programs);
 }
 exports.getExpandedEntryPointsForPaths = getExpandedEntryPointsForPaths;
-function expandGlobs(inputFiles, logger) {
+function expandGlobs(inputFiles, exclude, logger) {
+    const excludePatterns = (0, paths_1.createMinimatch)(exclude);
     const base = (0, fs_1.deriveRootDir)(inputFiles);
     const result = inputFiles.flatMap((entry) => {
         const result = (0, fs_1.glob)(entry, base, {
             includeDirectories: true,
             followSymlinks: true,
         });
+        const filtered = result.filter((file) => file === entry || !(0, paths_1.matchesAny)(excludePatterns, file));
         if (result.length === 0) {
             logger.warn(`The entrypoint glob ${(0, paths_1.nicePath)(entry)} did not match any files.`);
         }
+        else if (filtered.length === 0) {
+            logger.warn(`The entrypoint glob ${(0, paths_1.nicePath)(entry)} did not match any files after applying exclude patterns.`);
+        }
         else {
-            logger.verbose(`Expanded ${(0, paths_1.nicePath)(entry)} to:\n\t${result
+            logger.verbose(`Expanded ${(0, paths_1.nicePath)(entry)} to:\n\t${filtered
                 .map(paths_1.nicePath)
                 .join("\n\t")}`);
         }
-        return result;
+        return filtered;
     });
     return result;
 }
-function getEntryPrograms(logger, options) {
+function getEntryPrograms(inputFiles, logger, options) {
     const rootProgram = typescript_1.default.createProgram({
-        rootNames: options.getFileNames(),
+        rootNames: options.getFileNames().length
+            ? options.getFileNames()
+            : inputFiles,
         options: options.getCompilerOptions(),
         projectReferences: options.getProjectReferences(),
     });
@@ -268,92 +271,3 @@ function expandInputFiles(logger, entryPoints, options) {
     });
     return files;
 }
-/**
- * Expand the provided packages configuration paths, determining the entry points
- * and creating the ts.Programs for any which are found.
- * @param logger
- * @param packageGlobPaths
- * @returns The information about the discovered programs, undefined if an error occurs.
- */
-function getEntryPointsForLegacyPackages(logger, packageGlobPaths, options) {
-    const results = [];
-    for (const packagePath of getPackageDirectories(logger, options, packageGlobPaths)) {
-        const packageJsonPath = (0, path_1.resolve)(packagePath, "package.json");
-        const packageJson = (0, package_manifest_1.loadPackageManifest)(logger, packageJsonPath);
-        const includeVersion = options.getValue("includeVersion");
-        const typedocPackageConfig = packageJson
-            ? (0, package_manifest_1.extractTypedocConfigFromPackageManifest)(logger, packageJsonPath)
-            : undefined;
-        if (packageJson === undefined) {
-            logger.error(`Could not load package manifest ${packageJsonPath}`);
-            return;
-        }
-        const packageEntryPoint = (0, package_manifest_1.getTsEntryPointForPackage)(logger, packageJsonPath, packageJson);
-        if (packageEntryPoint === undefined) {
-            logger.error(`Could not determine TS entry point for package ${packageJsonPath}`);
-            return;
-        }
-        if (packageEntryPoint === package_manifest_1.ignorePackage) {
-            continue;
-        }
-        const tsconfigFile = typescript_1.default.findConfigFile(packageEntryPoint, typescript_1.default.sys.fileExists, typedocPackageConfig?.tsconfig);
-        if (tsconfigFile === undefined) {
-            logger.error(`Could not determine tsconfig.json for source file ${packageEntryPoint} (it must be on an ancestor path)`);
-            return;
-        }
-        // Consider deduplicating this with similar code in src/lib/utils/options/readers/tsconfig.ts
-        let fatalError = false;
-        const parsedCommandLine = typescript_1.default.getParsedCommandLineOfConfigFile(tsconfigFile, {}, {
-            ...typescript_1.default.sys,
-            onUnRecoverableConfigFileDiagnostic: (error) => {
-                logger.diagnostic(error);
-                fatalError = true;
-            },
-        });
-        if (!parsedCommandLine) {
-            return;
-        }
-        logger.diagnostics(parsedCommandLine.errors);
-        if (fatalError) {
-            return;
-        }
-        const program = typescript_1.default.createProgram({
-            rootNames: parsedCommandLine.fileNames,
-            options: options.fixCompilerOptions(parsedCommandLine.options),
-            projectReferences: parsedCommandLine.projectReferences,
-        });
-        const sourceFile = program.getSourceFile(packageEntryPoint);
-        if (sourceFile === undefined) {
-            logger.error(`Entry point "${packageEntryPoint}" does not appear to be built by/included in the tsconfig found at "${tsconfigFile}"`);
-            return;
-        }
-        const packageName = packageJson["name"];
-        results.push({
-            displayName: typedocPackageConfig?.displayName ?? packageName,
-            version: includeVersion
-                ? packageJson["version"]?.replace(/^v/, "")
-                : void 0,
-            readmeFile: discoverReadmeFile(logger, Path.join(packageJsonPath, ".."), typedocPackageConfig?.readmeFile),
-            program,
-            sourceFile,
-        });
-    }
-    return results;
-}
-function discoverReadmeFile(logger, packageDir, userReadme) {
-    if (userReadme?.endsWith("none")) {
-        return;
-    }
-    if (userReadme) {
-        if (!FS.existsSync(Path.join(packageDir, userReadme))) {
-            logger.warn(`Failed to find ${userReadme} in ${(0, paths_1.nicePath)(packageDir)}`);
-            return;
-        }
-        return Path.resolve(Path.join(packageDir, userReadme));
-    }
-    for (const file of FS.readdirSync(packageDir)) {
-        if (file.toLowerCase() === "readme.md") {
-            return Path.resolve(Path.join(packageDir, file));
-        }
-    }
-}

package/dist/lib/utils/events.js

@@ -66,7 +66,7 @@ function eventsApi(iteratee, events, name, callback, options) {
  */
 function onApi(events, name, callback, options) {
     if (callback) {
-        const handlers = (events[name] || (events[name] = []));
+        const handlers = (events[name] ||= []);
         const context = options.context, ctx = options.ctx, listening = options.listening, priority = options.priority;
         if (listening) {
             listening.count++;

package/dist/lib/utils/general.js

@@ -42,7 +42,7 @@ const loadSymbol = Symbol.for("typedoc_loads");
 const pathSymbol = Symbol.for("typedoc_paths");
 const g = globalThis;
 g[loadSymbol] = (g[loadSymbol] || 0) + 1;
-g[pathSymbol] || (g[pathSymbol] = []);
+g[pathSymbol] ||= [];
 // transform /abs/path/to/typedoc/dist/lib/utils/general -> /abs/path/to/typedoc
 g[pathSymbol].push((0, path_1.dirname)((0, path_1.dirname)((0, path_1.dirname)(__dirname))));
 function hasBeenLoadedMultipleTimes() {

package/dist/lib/utils/index.d.ts

@@ -8,7 +8,7 @@ export type { IfInternal, NeverIfInternal, Chars } from "./general";
 export { assertNever } from "./general";
 export { ConsoleLogger, Logger, LogLevel } from "./loggers";
 export { DefaultMap } from "./map";
-export { ArgumentsReader, BindOption, CommentStyle, Options, PackageJsonReader, ParameterHint, ParameterType, TSConfigReader, TypeDocReader, } from "./options";
+export { ArgumentsReader, Option, BindOption, CommentStyle, Options, PackageJsonReader, ParameterHint, ParameterType, TSConfigReader, TypeDocReader, } from "./options";
 export type { ArrayDeclarationOption, BooleanDeclarationOption, DeclarationOption, DeclarationOptionBase, DeclarationOptionToOptionType, KeyToDeclaration, MapDeclarationOption, MixedDeclarationOption, NumberDeclarationOption, FlagsDeclarationOption, ObjectDeclarationOption, OptionsReader, StringDeclarationOption, TypeDocOptionMap, TypeDocOptions, ValidationOptions, TypeDocOptionValues, ParameterTypeToOptionTypeMap, ManuallyValidatedOption, JsDocCompatibility, } from "./options";
 export { loadPlugins } from "./plugins";
 export { getSortFunction } from "./sort";

package/dist/lib/utils/index.js

@@ -26,7 +26,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MinimalSourceFile = exports.Validation = exports.renderElement = exports.Raw = exports.Fragment = exports.JSX = exports.EventHooks = exports.getSortFunction = exports.loadPlugins = exports.TypeDocReader = exports.TSConfigReader = exports.ParameterType = exports.ParameterHint = exports.PackageJsonReader = exports.Options = exports.CommentStyle = exports.BindOption = exports.ArgumentsReader = exports.DefaultMap = exports.LogLevel = exports.Logger = exports.ConsoleLogger = exports.assertNever = exports.normalizePath = exports.discoverPackageJson = exports.discoverInParentDir = exports.writeFileSync = exports.writeFile = exports.readFile = exports.getCommonDirectory = exports.copySync = exports.copy = exports.isFile = exports.EventDispatcher = exports.Event = exports.Component = exports.ChildableComponent = exports.AbstractComponent = exports.unique = exports.removeIfPresent = exports.removeIf = exports.partition = exports.insertPrioritySorted = exports.filterMap = void 0;
+exports.MinimalSourceFile = exports.Validation = exports.renderElement = exports.Raw = exports.Fragment = exports.JSX = exports.EventHooks = exports.getSortFunction = exports.loadPlugins = exports.TypeDocReader = exports.TSConfigReader = exports.ParameterType = exports.ParameterHint = exports.PackageJsonReader = exports.Options = exports.CommentStyle = exports.BindOption = exports.Option = exports.ArgumentsReader = exports.DefaultMap = exports.LogLevel = exports.Logger = exports.ConsoleLogger = exports.assertNever = exports.normalizePath = exports.discoverPackageJson = exports.discoverInParentDir = exports.writeFileSync = exports.writeFile = exports.readFile = exports.getCommonDirectory = exports.copySync = exports.copy = exports.isFile = exports.EventDispatcher = exports.Event = exports.Component = exports.ChildableComponent = exports.AbstractComponent = exports.unique = exports.removeIfPresent = exports.removeIf = exports.partition = exports.insertPrioritySorted = exports.filterMap = void 0;
 var array_1 = require("./array");
 Object.defineProperty(exports, "filterMap", { enumerable: true, get: function () { return array_1.filterMap; } });
 Object.defineProperty(exports, "insertPrioritySorted", { enumerable: true, get: function () { return array_1.insertPrioritySorted; } });
@@ -64,6 +64,7 @@ var map_1 = require("./map");
 Object.defineProperty(exports, "DefaultMap", { enumerable: true, get: function () { return map_1.DefaultMap; } });
 var options_1 = require("./options");
 Object.defineProperty(exports, "ArgumentsReader", { enumerable: true, get: function () { return options_1.ArgumentsReader; } });
+Object.defineProperty(exports, "Option", { enumerable: true, get: function () { return options_1.Option; } });
 Object.defineProperty(exports, "BindOption", { enumerable: true, get: function () { return options_1.BindOption; } });
 Object.defineProperty(exports, "CommentStyle", { enumerable: true, get: function () { return options_1.CommentStyle; } });
 Object.defineProperty(exports, "Options", { enumerable: true, get: function () { return options_1.Options; } });

package/dist/lib/utils/jsx.d.ts

@@ -44,4 +44,4 @@ export declare function createElement(tag: typeof Fragment | string | JsxCompone
 export declare function setRenderSettings(options: {
     pretty: boolean;
 }): void;
-export declare function renderElement(element: JsxElement | null | undefined): string;
+export declare const renderElement: (element: JsxElement | null | undefined) => string;

package/dist/lib/utils/jsx.js

@@ -76,8 +76,8 @@ function setRenderSettings(options) {
     renderPretty = options.pretty;
 }
 exports.setRenderSettings = setRenderSettings;
-function renderElement(element) {
-    if (!element) {
+const renderElement = function renderElement(element) {
+    if (!element || typeof element === "boolean") {
         return "";
     }
     const { tag, props, children } = element;
@@ -87,22 +87,27 @@ function renderElement(element) {
         }
         return renderElement(tag(Object.assign({ children }, props)));
     }
-    const html = [];
+    let html = "";
     if (tag !== jsx_elements_1.JsxFragment) {
         if (blockElements.has(tag) && renderPretty) {
-            html.push("\n");
+            html += "\n";
         }
-        html.push("<", tag);
+        html += "<";
+        html += tag;
         for (const [key, val] of Object.entries(props ?? {})) {
             if (val == null)
                 continue;
             if (typeof val == "boolean") {
                 if (val) {
-                    html.push(" ", key);
+                    html += " ";
+                    html += key;
                 }
             }
             else {
-                html.push(" ", key, "=", JSON.stringify(val));
+                html += " ";
+                html += key;
+                html += "=";
+                html += JSON.stringify(val);
             }
         }
     }
@@ -110,23 +115,27 @@ function renderElement(element) {
     if (children.length) {
         hasChildren = true;
         if (tag !== jsx_elements_1.JsxFragment)
-            html.push(">");
+            html += ">";
         renderChildren(children);
     }
     if (tag !== jsx_elements_1.JsxFragment) {
         if (!hasChildren) {
             if (voidElements.has(tag)) {
-                html.push("/>");
+                html += "/>";
             }
             else {
-                html.push("></", tag, ">");
+                html += "></";
+                html += tag;
+                html += ">";
             }
         }
         else {
-            html.push("</", tag, ">");
+            html += "</";
+            html += tag;
+            html += ">";
         }
     }
-    return html.join("");
+    return html;
     function renderChildren(children) {
         for (const child of children) {
             if (!child)
@@ -135,12 +144,12 @@ function renderElement(element) {
                 renderChildren(child);
             }
             else if (typeof child === "string" || typeof child === "number") {
-                html.push((0, html_1.escapeHtml)(child.toString()));
+                html += (0, html_1.escapeHtml)(child.toString());
             }
             else {
-                html.push(renderElement(child));
+                html += renderElement(child);
             }
         }
     }
-}
+};
 exports.renderElement = renderElement;