Interface OptionsReader

Describes an option reader that discovers user configuration and converts it to the TypeDoc format.

interface OptionsReader {
    name: string;
    order: number;
    supportsPackages: boolean;
    read(container: Options, logger: Logger, cwd: string): void | Promise<void>;
}

Implemented by

Properties

Methods

Properties

name: string

The name of this reader so that it may be removed by plugins without the plugin accessing the instance performing the read. Multiple readers may have the same name.

order: number

Readers will be processed according to their orders. A higher order indicates that the reader should be called later.

Note that to preserve expected behavior, the argv reader must have both the lowest order so that it may set the location of config files used by other readers and the highest order so that it can override settings from lower order readers.

supportsPackages: boolean

Flag to indicate that this reader should be included in sub-options objects created to read options for packages mode.

Methods

  • Read options from the reader's source and place them in the options parameter. Options without a declared name may be treated as if they were declared with type ParameterType.Mixed. Options which have been declared must be converted to the correct type. As an alternative to doing this conversion in the reader, the reader may use Options.setValue, which will correctly convert values.

    Parameters

    • container: Options

      the options container that provides declarations

    • logger: Logger

      logger to be used to report errors

    • cwd: string

      the directory which should be treated as the current working directory for option file discovery

    Returns void | Promise<void>