typedoc 0.27.1 → 0.27.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,3 @@
1
- import type * as ts from "typescript";
1
+ import type ts from "typescript";
2
2
  import { type Token } from "./lexer.js";
3
3
  export declare function lexLineComments(file: string, ranges: ts.CommentRange[]): Generator<Token, undefined, undefined>;
@@ -1,4 +1,4 @@
1
- import type * as ts from "typescript";
1
+ import type ts from "typescript";
2
2
  import { type ReferenceType, type SomeType } from "../types.js";
3
3
  import { type TraverseCallback } from "./abstract.js";
4
4
  import { ContainerReflection } from "./container.js";
@@ -1,4 +1,4 @@
1
- import type * as ts from "typescript";
1
+ import type ts from "typescript";
2
2
  import { type Reflection } from "./abstract.js";
3
3
  import { ContainerReflection } from "./container.js";
4
4
  import type { DeclarationReflection } from "./declaration.js";
@@ -1,4 +1,4 @@
1
- import * as ts from "typescript";
1
+ import ts from "typescript";
2
2
  import type { Context } from "../converter/index.js";
3
3
  import type { Reflection } from "./reflections/abstract.js";
4
4
  import type { DeclarationReflection } from "./reflections/declaration.js";
@@ -1,4 +1,4 @@
1
- import * as ts from "typescript";
1
+ import ts from "typescript";
2
2
  import { getQualifiedName } from "../utils/tsutils.js";
3
3
  import { ReflectionSymbolId } from "./reflections/ReflectionSymbolId.js";
4
4
  import { findPackageForPath } from "../utils/fs.js";
@@ -1,24 +1,18 @@
1
+ /**
2
+ * Defaults values for TypeDoc options
3
+ * @module
4
+ */
1
5
  import type { BundledLanguage } from "@gerrit0/mini-shiki";
2
6
  import type { EnumKeys } from "../enum.js";
3
7
  import type { ReflectionKind } from "../../models/index.js";
4
- /**
5
- * Default values for TypeDoc options. This object should not be modified.
6
- *
7
- * @privateRemarks
8
- * These are declared here, rather than within the option declaration, so that
9
- * they can be exposed as a part of the public API. The unfortunate type declaration
10
- * is to control the type which appears in the generated documentation.
11
- */
12
- export declare const OptionDefaults: {
13
- excludeNotDocumentedKinds: readonly EnumKeys<typeof ReflectionKind>[];
14
- excludeTags: readonly `@${string}`[];
15
- blockTags: readonly `@${string}`[];
16
- inlineTags: readonly `@${string}`[];
17
- modifierTags: readonly `@${string}`[];
18
- cascadedModifierTags: readonly `@${string}`[];
19
- notRenderedTags: readonly `@${string}`[];
20
- highlightLanguages: readonly BundledLanguage[];
21
- sort: readonly string[];
22
- kindSortOrder: readonly EnumKeys<typeof ReflectionKind>[];
23
- requiredToBeDocumented: readonly EnumKeys<typeof ReflectionKind>[];
24
- };
8
+ export declare const excludeNotDocumentedKinds: readonly EnumKeys<typeof ReflectionKind>[];
9
+ export declare const excludeTags: readonly `@${string}`[];
10
+ export declare const blockTags: readonly `@${string}`[];
11
+ export declare const inlineTags: readonly `@${string}`[];
12
+ export declare const modifierTags: readonly `@${string}`[];
13
+ export declare const cascadedModifierTags: readonly `@${string}`[];
14
+ export declare const notRenderedTags: readonly `@${string}`[];
15
+ export declare const highlightLanguages: readonly BundledLanguage[];
16
+ export declare const sort: readonly string[];
17
+ export declare const kindSortOrder: readonly EnumKeys<typeof ReflectionKind>[];
18
+ export declare const requiredToBeDocumented: readonly EnumKeys<typeof ReflectionKind>[];
@@ -1,100 +1,98 @@
1
1
  import * as TagDefaults from "./tsdoc-defaults.js";
2
- /**
3
- * Default values for TypeDoc options. This object should not be modified.
4
- *
5
- * @privateRemarks
6
- * These are declared here, rather than within the option declaration, so that
7
- * they can be exposed as a part of the public API. The unfortunate type declaration
8
- * is to control the type which appears in the generated documentation.
9
- */
10
- export const OptionDefaults = {
11
- excludeNotDocumentedKinds: [
12
- "Module",
13
- "Namespace",
14
- "Enum",
15
- // Not including enum member here by default
16
- "Variable",
17
- "Function",
18
- "Class",
19
- "Interface",
20
- "Constructor",
21
- "Property",
22
- "Method",
23
- "CallSignature",
24
- "IndexSignature",
25
- "ConstructorSignature",
26
- "Accessor",
27
- "GetSignature",
28
- "SetSignature",
29
- "TypeAlias",
30
- "Reference",
31
- ],
32
- excludeTags: [
33
- "@override",
34
- "@virtual",
35
- "@privateRemarks",
36
- "@satisfies",
37
- "@overload",
38
- "@inline",
39
- ],
40
- blockTags: TagDefaults.blockTags,
41
- inlineTags: TagDefaults.inlineTags,
42
- modifierTags: TagDefaults.modifierTags,
43
- cascadedModifierTags: ["@alpha", "@beta", "@experimental"],
44
- notRenderedTags: [
45
- "@showCategories",
46
- "@showGroups",
47
- "@hideCategories",
48
- "@hideGroups",
49
- "@expand",
50
- "@summary",
51
- "@group",
52
- "@groupDescription",
53
- "@category",
54
- "@categoryDescription",
55
- ],
56
- highlightLanguages: [
57
- "bash",
58
- "console",
59
- "css",
60
- "html",
61
- "javascript",
62
- "json",
63
- "jsonc",
64
- "json5",
65
- "yaml",
66
- "tsx",
67
- "typescript",
68
- ],
69
- sort: ["kind", "instance-first", "alphabetical-ignoring-documents"],
70
- kindSortOrder: [
71
- "Document",
72
- "Project",
73
- "Module",
74
- "Namespace",
75
- "Enum",
76
- "EnumMember",
77
- "Class",
78
- "Interface",
79
- "TypeAlias",
80
- "Constructor",
81
- "Property",
82
- "Variable",
83
- "Function",
84
- "Accessor",
85
- "Method",
86
- "Reference",
87
- ],
88
- requiredToBeDocumented: [
89
- "Enum",
90
- "EnumMember",
91
- "Variable",
92
- "Function",
93
- "Class",
94
- "Interface",
95
- "Property",
96
- "Method",
97
- "Accessor",
98
- "TypeAlias",
99
- ],
100
- };
2
+ export const excludeNotDocumentedKinds = [
3
+ "Module",
4
+ "Namespace",
5
+ "Enum",
6
+ // Not including enum member here by default
7
+ "Variable",
8
+ "Function",
9
+ "Class",
10
+ "Interface",
11
+ "Constructor",
12
+ "Property",
13
+ "Method",
14
+ "CallSignature",
15
+ "IndexSignature",
16
+ "ConstructorSignature",
17
+ "Accessor",
18
+ "GetSignature",
19
+ "SetSignature",
20
+ "TypeAlias",
21
+ "Reference",
22
+ ];
23
+ export const excludeTags = [
24
+ "@override",
25
+ "@virtual",
26
+ "@privateRemarks",
27
+ "@satisfies",
28
+ "@overload",
29
+ "@inline",
30
+ ];
31
+ export const blockTags = TagDefaults.blockTags;
32
+ export const inlineTags = TagDefaults.inlineTags;
33
+ export const modifierTags = TagDefaults.modifierTags;
34
+ export const cascadedModifierTags = [
35
+ "@alpha",
36
+ "@beta",
37
+ "@experimental",
38
+ ];
39
+ export const notRenderedTags = [
40
+ "@showCategories",
41
+ "@showGroups",
42
+ "@hideCategories",
43
+ "@hideGroups",
44
+ "@expand",
45
+ "@summary",
46
+ "@group",
47
+ "@groupDescription",
48
+ "@category",
49
+ "@categoryDescription",
50
+ ];
51
+ export const highlightLanguages = [
52
+ "bash",
53
+ "console",
54
+ "css",
55
+ "html",
56
+ "javascript",
57
+ "json",
58
+ "jsonc",
59
+ "json5",
60
+ "yaml",
61
+ "tsx",
62
+ "typescript",
63
+ ];
64
+ export const sort = [
65
+ "kind",
66
+ "instance-first",
67
+ "alphabetical-ignoring-documents",
68
+ ];
69
+ export const kindSortOrder = [
70
+ "Document",
71
+ "Project",
72
+ "Module",
73
+ "Namespace",
74
+ "Enum",
75
+ "EnumMember",
76
+ "Class",
77
+ "Interface",
78
+ "TypeAlias",
79
+ "Constructor",
80
+ "Property",
81
+ "Variable",
82
+ "Function",
83
+ "Accessor",
84
+ "Method",
85
+ "Reference",
86
+ ];
87
+ export const requiredToBeDocumented = [
88
+ "Enum",
89
+ "EnumMember",
90
+ "Variable",
91
+ "Function",
92
+ "Class",
93
+ "Interface",
94
+ "Property",
95
+ "Method",
96
+ "Accessor",
97
+ "TypeAlias",
98
+ ];
@@ -3,4 +3,4 @@ export type { OptionsReader } from "./options.js";
3
3
  export { ArgumentsReader, PackageJsonReader, TypeDocReader, TSConfigReader, } from "./readers/index.js";
4
4
  export { CommentStyle, EmitStrategy, ParameterType, ParameterHint, } from "./declaration.js";
5
5
  export type { TypeDocOptions, TypeDocOptionMap, ValidationOptions, KeyToDeclaration, DeclarationOption, DeclarationOptionBase, StringDeclarationOption, NumberDeclarationOption, BooleanDeclarationOption, ArrayDeclarationOption, MixedDeclarationOption, ObjectDeclarationOption, MapDeclarationOption, FlagsDeclarationOption, DeclarationOptionToOptionType, TypeDocOptionValues, ParameterTypeToOptionTypeMap, ManuallyValidatedOption, JsDocCompatibility, OutputSpecification, } from "./declaration.js";
6
- export { OptionDefaults } from "./defaults.js";
6
+ export * as OptionDefaults from "./defaults.js";
@@ -1,4 +1,4 @@
1
1
  export { Options, Option } from "./options.js";
2
2
  export { ArgumentsReader, PackageJsonReader, TypeDocReader, TSConfigReader, } from "./readers/index.js";
3
3
  export { CommentStyle, EmitStrategy, ParameterType, ParameterHint, } from "./declaration.js";
4
- export { OptionDefaults } from "./defaults.js";
4
+ export * as OptionDefaults from "./defaults.js";
@@ -1,4 +1,4 @@
1
- import type * as ts from "typescript";
1
+ import type ts from "typescript";
2
2
  import type { NeverIfInternal } from "../index.js";
3
3
  import type { Application } from "../../../index.js";
4
4
  import type { Logger } from "../loggers.js";
@@ -1,6 +1,6 @@
1
1
  import { LogLevel } from "../../loggers.js";
2
2
  import { ParameterType, ParameterHint, EmitStrategy, CommentStyle, } from "../declaration.js";
3
- import { OptionDefaults } from "../defaults.js";
3
+ import * as OptionDefaults from "../defaults.js";
4
4
  import { SORT_STRATEGIES } from "../../sort.js";
5
5
  import { EntryPointStrategy } from "../../entry-point.js";
6
6
  import { ReflectionKind } from "../../../models/reflections/kind.js";
@@ -3,7 +3,7 @@
3
3
  * @module
4
4
  */
5
5
  import { ReflectionKind } from "../models/reflections/kind.js";
6
- import { OptionDefaults } from "./options/defaults.js";
6
+ import * as OptionDefaults from "./options/defaults.js";
7
7
  export const SORT_STRATEGIES = [
8
8
  "source-order",
9
9
  "alphabetical",
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "typedoc",
3
3
  "description": "Create api documentation for TypeScript projects.",
4
- "version": "0.27.1",
4
+ "version": "0.27.2",
5
5
  "homepage": "https://typedoc.org",
6
6
  "type": "module",
7
7
  "exports": {
@@ -25,7 +25,7 @@
25
25
  "node": ">= 18"
26
26
  },
27
27
  "dependencies": {
28
- "@gerrit0/mini-shiki": "^1.23.2",
28
+ "@gerrit0/mini-shiki": "^1.24.0",
29
29
  "lunr": "^2.3.9",
30
30
  "markdown-it": "^14.1.0",
31
31
  "minimatch": "^9.0.5",