UNPKG

2.36 kBTypeScriptView Raw
1import { type ApiModel } from '@microsoft/api-extractor-model';
2import type { DocumenterConfig } from './DocumenterConfig';
3export interface IMarkdownDocumenterOptions {
4 apiModel: ApiModel;
5 documenterConfig: DocumenterConfig | undefined;
6 outputFolder: string;
7}
8/**
9 * Renders API documentation in the Markdown file format.
10 * For more info: https://en.wikipedia.org/wiki/Markdown
11 */
12export declare class MarkdownDocumenter {
13 private readonly _apiModel;
14 private readonly _documenterConfig;
15 private readonly _tsdocConfiguration;
16 private readonly _markdownEmitter;
17 private readonly _outputFolder;
18 private readonly _pluginLoader;
19 constructor(options: IMarkdownDocumenterOptions);
20 generateFiles(): void;
21 private _writeApiItemPage;
22 private _writeHeritageTypes;
23 private _writeRemarksSection;
24 private _writeThrowsSection;
25 /**
26 * GENERATE PAGE: MODEL
27 */
28 private _writeModelTable;
29 /**
30 * GENERATE PAGE: PACKAGE or NAMESPACE
31 */
32 private _writePackageOrNamespaceTables;
33 /**
34 * GENERATE PAGE: CLASS
35 */
36 private _writeClassTables;
37 /**
38 * GENERATE PAGE: ENUM
39 */
40 private _writeEnumTables;
41 /**
42 * GENERATE PAGE: INTERFACE
43 */
44 private _writeInterfaceTables;
45 /**
46 * GENERATE PAGE: FUNCTION-LIKE
47 */
48 private _writeParameterTables;
49 private _createParagraphForTypeExcerpt;
50 private _appendExcerptWithHyperlinks;
51 private _appendExcerptTokenWithHyperlinks;
52 private _createTitleCell;
53 /**
54 * This generates a DocTableCell for an ApiItem including the summary section and "(BETA)" annotation.
55 *
56 * @remarks
57 * We mostly assume that the input is an ApiDocumentedItem, but it's easier to perform this as a runtime
58 * check than to have each caller perform a type cast.
59 */
60 private _createDescriptionCell;
61 private _createModifiersCell;
62 private _createPropertyTypeCell;
63 private _createInitializerCell;
64 private _writeBreadcrumb;
65 private _writeAlphaWarning;
66 private _writeBetaWarning;
67 private _appendSection;
68 private _appendAndMergeSection;
69 private _getMembersAndWriteIncompleteWarning;
70 private _getFilenameForApiItem;
71 private _getLinkFilenameForApiItem;
72 private _deleteOldOutputFiles;
73}
74//# sourceMappingURL=MarkdownDocumenter.d.ts.map
\No newline at end of file