@microsoft/api-extractor
Version:
Analyze the exported API for a TypeScript library and generate reviews, documentation, and .d.ts rollups
37 lines • 1.76 kB
TypeScript
import { Collector } from '../collector/Collector';
import type { ApiReportVariant } from '../api/IConfigFile';
export declare class ApiReportGenerator {
private static _trimSpacesRegExp;
/**
* Compares the contents of two API files that were created using ApiFileGenerator,
* and returns true if they are equivalent. Note that these files are not normally edited
* by a human; the "equivalence" comparison here is intended to ignore spurious changes that
* might be introduced by a tool, e.g. Git newline normalization or an editor that strips
* whitespace when saving.
*/
static areEquivalentApiFileContents(actualFileContent: string, expectedFileContent: string): boolean;
/**
* Generates and returns the API report contents as a string.
*
* @param reportVariant - The release level with which the report is associated.
* Can also be viewed as the minimal release level of items that should be included in the report.
*/
static generateReviewFileContent(collector: Collector, reportVariant: ApiReportVariant): string;
/**
* Before writing out a declaration, _modifySpan() applies various fixups to make it nice.
*/
private static _modifySpan;
private static _shouldIncludeInReport;
/**
* For declarations marked as `@preapproved`, this is used instead of _modifySpan().
*/
private static _modifySpanForPreapproved;
/**
* Writes a synopsis of the AEDoc comments, which indicates the release tag,
* whether the item has been documented, and any warnings that were detected
* by the analysis.
*/
private static _getAedocSynopsis;
private static _writeLineAsComments;
}
//# sourceMappingURL=ApiReportGenerator.d.ts.map