UNPKG

4.69 kBTypeScriptView Raw
1/**
2 * Describes the options declared by the plugin.
3 */
4export interface PluginOptions {
5 /**
6 * Custom anchor prefix when anchoring to in-page symbols.
7 */
8 anchorPrefix: string;
9 /**
10 * Specifies comment block tags that should preserve their position in relation to the comment summary.
11 */
12 blockTagsPreserveOrder: string[];
13 /**
14 * Sets the format of property groups for classes.
15 */
16 classPropertiesFormat: 'list' | 'table' | 'htmlTable';
17 /**
18 * The file name of the entry page.
19 */
20 entryFileName: string;
21 /**
22 * The name of a module that should act as the root page for the documentation.
23 */
24 entryModule: string;
25 /**
26 * Sets the format of enumeration members.
27 */
28 enumMembersFormat: 'list' | 'table' | 'htmlTable';
29 /**
30 * @deprecated This option has been renamed hideGroupHeadings to better reflect its purpose.
31 */
32 excludeGroups: boolean;
33 /**
34 * Exclude writing @ scope directories in paths.
35 */
36 excludeScopesInPaths: boolean;
37 /**
38 * Expand objects inside declarations.
39 */
40 expandObjects: boolean;
41 /**
42 * Expand parameters in signature parentheses to display type information.
43 */
44 expandParameters: boolean;
45 /**
46 * Specify the file extension for generated output files.
47 */
48 fileExtension: string;
49 /**
50 * Flatten output files to a single directory.
51 */
52 flattenOutputFiles: boolean;
53 /**
54 * Do not print breadcrumbs.
55 */
56 hideBreadcrumbs: boolean;
57 /**
58 * Excludes grouping by kind so all members are rendered and sorted at the same level.
59 */
60 hideGroupHeadings: boolean;
61 /**
62 * Do not print page header.
63 */
64 hidePageHeader: boolean;
65 /**
66 * Do not print page title.
67 */
68 hidePageTitle: boolean;
69 /**
70 * Sets the format of index items.
71 */
72 indexFormat: 'list' | 'table' | 'htmlTable';
73 /**
74 * Sets the format of property groups for interfaces.
75 */
76 interfacePropertiesFormat: 'list' | 'table' | 'htmlTable';
77 /**
78 * Determines which members are exported to their own file when `outputFileStrategy` equals `members`.
79 */
80 membersWithOwnFile: ('Enum' | 'Variable' | 'Function' | 'Class' | 'Interface' | 'TypeAlias')[];
81 /**
82 * Merges the resolved readme into the project index page.
83 */
84 mergeReadme: boolean;
85 /**
86 * The file name of the separate modules / index page.
87 */
88 modulesFileName: string;
89 /**
90 * @deprecated This option has been deprecated in favour of TypeDoc `navigation` option.
91 */
92 navigationModel: {
93 excludeGroups: boolean;
94 excludeCategories: boolean;
95 excludeFolders: boolean;
96 };
97 /**
98 * Determines how output files are generated.
99 */
100 outputFileStrategy: 'members' | 'modules';
101 /**
102 * Sets the format of parameter and type parameter groups.
103 */
104 parametersFormat: 'list' | 'table' | 'htmlTable';
105 /**
106 * Preserve anchor casing when generating link to symbols.
107 */
108 preserveAnchorCasing: boolean;
109 /**
110 * Sets the format of property groups for interfaces and classes.
111 */
112 propertiesFormat: 'list' | 'table' | 'htmlTable';
113 /**
114 * Sets the format of style for property members for interfaces and classes.
115 */
116 propertyMembersFormat: 'list' | 'table' | 'htmlTable';
117 /**
118 * Specify the base path for all urls.
119 */
120 publicPath: string;
121 /**
122 * Sanitize HTML and JSX inside JsDoc comments.
123 */
124 sanitizeComments: boolean;
125 /**
126 * Control how table columns are configured and displayed.
127 */
128 tableColumnSettings: {
129 hideDefaults: boolean;
130 hideInherited: boolean;
131 hideModifiers: boolean;
132 hideOverrides: boolean;
133 hideSources: boolean;
134 hideValues: boolean;
135 leftAlignHeaders: boolean;
136 };
137 /**
138 * Change specific text placeholders in the template.
139 */
140 textContentMappings: {
141 'header.title': string;
142 'header.docs': string;
143 'breadcrumbs.home': string;
144 'title.indexPage': string;
145 'title.memberPage': string;
146 'footer.text': string;
147 };
148 /**
149 * Sets the format of style for type declaration members.
150 */
151 typeDeclarationFormat: 'list' | 'table' | 'htmlTable';
152 /**
153 * Wraps signatures and declarations in code blocks.
154 */
155 useCodeBlocks: boolean;
156 /**
157 * Add HTML named anchors to headings and table rows.
158 */
159 useHTMLAnchors: boolean;
160 /**
161 * Use HTML encoded entities for angle brackets.
162 */
163 useHTMLEncodedBrackets: boolean;
164}