@textlint/types/lib/src/Plugin/TextlintPluginModule.d.ts

Type definition package for textlint

import type { TxtDocumentNode } from "@textlint/ast-node-types";
import type { TextlintMessage } from "../Message/TextlintResult.js";
/**
 * textlint plugin option values is object or boolean.
 * if this option value is false, disable the plugin.
 */
export declare type TextlintPluginOptions = {
    [index: string]: unknown;
};
/**
 * Result with transformed text that differs from the input.
 * Used when the plugin handles binary or other intermediate formats.
 * The text property contains the transformed text, and ast corresponds to that transformed text.
 * @see https://github.com/textlint/textlint/issues/649
 */
export type TextlintPluginPreProcessWithTransformedText = {
    text: string;
    ast: TxtDocumentNode;
};
/**
 * PreProcess result.
 * Usually returns TxtDocumentNode as the parsed result where the AST corresponds to the input text.
 * For special cases (binary or intermediate formats), returns TextlintPluginPreProcessWithTransformedText.
 */
export type TextlintPluginPreProcessResult = TxtDocumentNode | TextlintPluginPreProcessWithTransformedText;
export type TextlintPluginPostProcessResult = {
    messages: Array<TextlintMessage>;
    filePath: string;
};
export interface TextlintPluginProcessorConstructor {
    new (options?: TextlintPluginOptions): TextlintPluginProcessor;
    /**
     * Should defined `availableExtensions()` as instance method instead of static method.
     * @deprecated textlint@11+
     * @see https://github.com/textlint/textlint/issues/531
     */
    availableExtensions?(): Array<string>;
}
export declare class TextlintPluginProcessor {
    constructor(options?: TextlintPluginOptions);
    /**
     * Return available extensions for this plugin.
     * This extension should start with `.`(dot).
     * Example is [".md", ".mkd"]
     */
    availableExtensions(): Array<string>;
    processor(extension: string): {
        /**
         * plugin's `preProcess` return a TxtParentNode or text and AST.
         * If your plugin use different text for original file, the plugin should return the text and an AST for the text.
         * For example, a plugin for binary format.
         * textlint can not handle binary and the plugin should return Pseudo-text for original binary file.
         * @see https://github.com/textlint/textlint/issues/649
         * @param text original text
         * @param filePath optional file path
         */
        preProcess(text: string, filePath?: string): TextlintPluginPreProcessResult | Promise<TextlintPluginPreProcessResult>;
        /**
         * postProcess return messages and the filePath for the result.
         * @param messages
         * @param filePath
         */
        postProcess(messages: Array<TextlintMessage>, filePath?: string): TextlintPluginPostProcessResult | Promise<TextlintPluginPostProcessResult>;
    };
}
export interface TextlintPluginCreator {
    Processor: TextlintPluginProcessorConstructor;
}
//# sourceMappingURL=TextlintPluginModule.d.ts.map