@isdk/mdast-plus 0.1.3 → 0.2.1

package/dist/index.d.mts

@@ -22,7 +22,7 @@ import { VFileCompatible, VFile } from 'vfile';
  * }
  * ```
  */
-interface Data$1 {}
+interface Data$2 {}
 
 /**
  * One place in a source file.
@@ -70,7 +70,7 @@ interface Position {
  * But for example in markdown, a `thematicBreak` (`***`), is neither literal
  * nor parent, but still a node.
  */
-interface Node$1 {
+interface Node$2 {
     /**
      * Node type.
      */
@@ -79,7 +79,7 @@ interface Node$1 {
     /**
      * Info from the ecosystem.
      */
-    data?: Data$1 | undefined;
+    data?: Data$2 | undefined;
 
     /**
      * Position of a node in a source document.
@@ -98,11 +98,11 @@ interface Node$1 {
  * For example, in XML, an element is a parent of different things, such as
  * comments, text, and further elements.
  */
-interface Parent$1 extends Node$1 {
+interface Parent$2 extends Node$2 {
     /**
      * List of children.
      */
-    children: Node$1[];
+    children: Node$2[];
 }
 
 // ## Enumeration
@@ -232,7 +232,7 @@ interface Resource {
  * }
  * ```
  */
-interface Data extends Data$1 {}
+interface Data$1 extends Data$2 {}
 
 // ## Content maps
 
@@ -370,7 +370,7 @@ interface PhrasingContentMap {
     link: Link;
     linkReference: LinkReference;
     strong: Strong;
-    text: Text;
+    text: Text$1;
 }
 
 /**
@@ -379,7 +379,7 @@ interface PhrasingContentMap {
  * To register custom mdast nodes, add them to {@link RootContentMap}.
  * They will be automatically added here.
  */
-type RootContent = RootContentMap[keyof RootContentMap];
+type RootContent$1 = RootContentMap$1[keyof RootContentMap$1];
 
 /**
  * Registry of all mdast nodes that can occur as children of {@link Root}.
@@ -400,7 +400,7 @@ type RootContent = RootContentMap[keyof RootContentMap];
  *
  * For a union of all {@link Root} children, see {@link RootContent}.
  */
-interface RootContentMap {
+interface RootContentMap$1 {
     blockquote: Blockquote;
     break: Break;
     code: Code;
@@ -423,7 +423,7 @@ interface RootContentMap {
     table: Table;
     tableCell: TableCell;
     tableRow: TableRow;
-    text: Text;
+    text: Text$1;
     thematicBreak: ThematicBreak;
     yaml: Yaml;
 }
@@ -495,7 +495,7 @@ interface TableContentMap {
  *
  * For a union of all registered mdast literals, see {@link Literals}.
  */
-interface Literal extends Node {
+interface Literal$1 extends Node$1 {
     /**
      * Plain-text value.
      */
@@ -515,11 +515,11 @@ interface Literal extends Node {
  *
  * For a union of all registered mdast nodes, see {@link Nodes}.
  */
-interface Node extends Node$1 {
+interface Node$1 extends Node$2 {
     /**
      * Info from the ecosystem.
      */
-    data?: Data | undefined;
+    data?: Data$1 | undefined;
 }
 
 /**
@@ -529,11 +529,11 @@ interface Node extends Node$1 {
  *
  * For a union of all registered mdast parents, see {@link Parents}.
  */
-interface Parent extends Node {
+interface Parent$1 extends Node$1 {
     /**
      * List of children.
      */
-    children: RootContent[];
+    children: RootContent$1[];
 }
 
 // ## Concrete nodes
@@ -541,7 +541,7 @@ interface Parent extends Node {
 /**
  * Markdown block quote.
  */
-interface Blockquote extends Parent {
+interface Blockquote extends Parent$1 {
     /**
      * Node type of mdast block quote.
      */
@@ -559,12 +559,12 @@ interface Blockquote extends Parent {
 /**
  * Info associated with mdast block quote nodes by the ecosystem.
  */
-interface BlockquoteData extends Data {}
+interface BlockquoteData extends Data$1 {}
 
 /**
  * Markdown break.
  */
-interface Break extends Node {
+interface Break extends Node$1 {
     /**
      * Node type of mdast break.
      */
@@ -578,12 +578,12 @@ interface Break extends Node {
 /**
  * Info associated with mdast break nodes by the ecosystem.
  */
-interface BreakData extends Data {}
+interface BreakData extends Data$1 {}
 
 /**
  * Markdown code (flow) (block).
  */
-interface Code extends Literal {
+interface Code extends Literal$1 {
     /**
      * Node type of mdast code (flow).
      */
@@ -607,12 +607,12 @@ interface Code extends Literal {
 /**
  * Info associated with mdast code (flow) (block) nodes by the ecosystem.
  */
-interface CodeData extends Data {}
+interface CodeData extends Data$1 {}
 
 /**
  * Markdown definition.
  */
-interface Definition extends Node, Association, Resource {
+interface Definition extends Node$1, Association, Resource {
     /**
      * Node type of mdast definition.
      */
@@ -626,12 +626,12 @@ interface Definition extends Node, Association, Resource {
 /**
  * Info associated with mdast definition nodes by the ecosystem.
  */
-interface DefinitionData extends Data {}
+interface DefinitionData extends Data$1 {}
 
 /**
  * Markdown GFM delete (strikethrough).
  */
-interface Delete extends Parent {
+interface Delete extends Parent$1 {
     /**
      * Node type of mdast GFM delete.
      */
@@ -649,12 +649,12 @@ interface Delete extends Parent {
 /**
  * Info associated with mdast GFM delete nodes by the ecosystem.
  */
-interface DeleteData extends Data {}
+interface DeleteData extends Data$1 {}
 
 /**
  * Markdown emphasis.
  */
-interface Emphasis extends Parent {
+interface Emphasis extends Parent$1 {
     /**
      * Node type of mdast emphasis.
      */
@@ -672,12 +672,12 @@ interface Emphasis extends Parent {
 /**
  * Info associated with mdast emphasis nodes by the ecosystem.
  */
-interface EmphasisData extends Data {}
+interface EmphasisData extends Data$1 {}
 
 /**
  * Markdown GFM footnote definition.
  */
-interface FootnoteDefinition extends Parent, Association {
+interface FootnoteDefinition extends Parent$1, Association {
     /**
      * Node type of mdast GFM footnote definition.
      */
@@ -695,12 +695,12 @@ interface FootnoteDefinition extends Parent, Association {
 /**
  * Info associated with mdast GFM footnote definition nodes by the ecosystem.
  */
-interface FootnoteDefinitionData extends Data {}
+interface FootnoteDefinitionData extends Data$1 {}
 
 /**
  * Markdown GFM footnote reference.
  */
-interface FootnoteReference extends Association, Node {
+interface FootnoteReference extends Association, Node$1 {
     /**
      * Node type of mdast GFM footnote reference.
      */
@@ -714,12 +714,12 @@ interface FootnoteReference extends Association, Node {
 /**
  * Info associated with mdast GFM footnote reference nodes by the ecosystem.
  */
-interface FootnoteReferenceData extends Data {}
+interface FootnoteReferenceData extends Data$1 {}
 
 /**
  * Markdown heading.
  */
-interface Heading extends Parent {
+interface Heading extends Parent$1 {
     /**
      * Node type of mdast heading.
      */
@@ -743,12 +743,12 @@ interface Heading extends Parent {
 /**
  * Info associated with mdast heading nodes by the ecosystem.
  */
-interface HeadingData extends Data {}
+interface HeadingData extends Data$1 {}
 
 /**
  * Markdown HTML.
  */
-interface Html extends Literal {
+interface Html extends Literal$1 {
     /**
      * Node type of mdast HTML.
      */
@@ -762,12 +762,12 @@ interface Html extends Literal {
 /**
  * Info associated with mdast HTML nodes by the ecosystem.
  */
-interface HtmlData extends Data {}
+interface HtmlData extends Data$1 {}
 
 /**
  * Markdown image.
  */
-interface Image extends Alternative, Node, Resource {
+interface Image extends Alternative, Node$1, Resource {
     /**
      * Node type of mdast image.
      */
@@ -781,12 +781,12 @@ interface Image extends Alternative, Node, Resource {
 /**
  * Info associated with mdast image nodes by the ecosystem.
  */
-interface ImageData extends Data {}
+interface ImageData extends Data$1 {}
 
 /**
  * Markdown image reference.
  */
-interface ImageReference extends Alternative, Node, Reference {
+interface ImageReference extends Alternative, Node$1, Reference {
     /**
      * Node type of mdast image reference.
      */
@@ -800,12 +800,12 @@ interface ImageReference extends Alternative, Node, Reference {
 /**
  * Info associated with mdast image reference nodes by the ecosystem.
  */
-interface ImageReferenceData extends Data {}
+interface ImageReferenceData extends Data$1 {}
 
 /**
  * Markdown code (text) (inline).
  */
-interface InlineCode extends Literal {
+interface InlineCode extends Literal$1 {
     /**
      * Node type of mdast code (text).
      */
@@ -819,12 +819,12 @@ interface InlineCode extends Literal {
 /**
  * Info associated with mdast code (text) (inline) nodes by the ecosystem.
  */
-interface InlineCodeData extends Data {}
+interface InlineCodeData extends Data$1 {}
 
 /**
  * Markdown link.
  */
-interface Link extends Parent, Resource {
+interface Link extends Parent$1, Resource {
     /**
      * Node type of mdast link.
      */
@@ -842,12 +842,12 @@ interface Link extends Parent, Resource {
 /**
  * Info associated with mdast link nodes by the ecosystem.
  */
-interface LinkData extends Data {}
+interface LinkData extends Data$1 {}
 
 /**
  * Markdown link reference.
  */
-interface LinkReference extends Parent, Reference {
+interface LinkReference extends Parent$1, Reference {
     /**
      * Node type of mdast link reference.
      */
@@ -865,12 +865,12 @@ interface LinkReference extends Parent, Reference {
 /**
  * Info associated with mdast link reference nodes by the ecosystem.
  */
-interface LinkReferenceData extends Data {}
+interface LinkReferenceData extends Data$1 {}
 
 /**
  * Markdown list.
  */
-interface List extends Parent {
+interface List extends Parent$1 {
     /**
      * Node type of mdast list.
      */
@@ -902,12 +902,12 @@ interface List extends Parent {
 /**
  * Info associated with mdast list nodes by the ecosystem.
  */
-interface ListData extends Data {}
+interface ListData extends Data$1 {}
 
 /**
  * Markdown list item.
  */
-interface ListItem extends Parent {
+interface ListItem extends Parent$1 {
     /**
      * Node type of mdast list item.
      */
@@ -937,12 +937,12 @@ interface ListItem extends Parent {
 /**
  * Info associated with mdast list item nodes by the ecosystem.
  */
-interface ListItemData extends Data {}
+interface ListItemData extends Data$1 {}
 
 /**
  * Markdown paragraph.
  */
-interface Paragraph extends Parent {
+interface Paragraph extends Parent$1 {
     /**
      * Node type of mdast paragraph.
      */
@@ -960,14 +960,14 @@ interface Paragraph extends Parent {
 /**
  * Info associated with mdast paragraph nodes by the ecosystem.
  */
-interface ParagraphData extends Data {}
+interface ParagraphData extends Data$1 {}
 
 /**
  * Document fragment or a whole document.
  *
  * Should be used as the root of a tree and must not be used as a child.
  */
-interface Root extends Parent {
+interface Root$1 extends Parent$1 {
     /**
      * Node type of mdast root.
      */
@@ -975,18 +975,18 @@ interface Root extends Parent {
     /**
      * Data associated with the mdast root.
      */
-    data?: RootData | undefined;
+    data?: RootData$1 | undefined;
 }
 
 /**
  * Info associated with mdast root nodes by the ecosystem.
  */
-interface RootData extends Data {}
+interface RootData$1 extends Data$1 {}
 
 /**
  * Markdown strong.
  */
-interface Strong extends Parent {
+interface Strong extends Parent$1 {
     /**
      * Node type of mdast strong.
      */
@@ -1004,12 +1004,12 @@ interface Strong extends Parent {
 /**
  * Info associated with mdast strong nodes by the ecosystem.
  */
-interface StrongData extends Data {}
+interface StrongData extends Data$1 {}
 
 /**
  * Markdown GFM table.
  */
-interface Table extends Parent {
+interface Table extends Parent$1 {
     /**
      * Node type of mdast GFM table.
      */
@@ -1031,12 +1031,12 @@ interface Table extends Parent {
 /**
  * Info associated with mdast GFM table nodes by the ecosystem.
  */
-interface TableData extends Data {}
+interface TableData extends Data$1 {}
 
 /**
  * Markdown GFM table row.
  */
-interface TableRow extends Parent {
+interface TableRow extends Parent$1 {
     /**
      * Node type of mdast GFM table row.
      */
@@ -1054,12 +1054,12 @@ interface TableRow extends Parent {
 /**
  * Info associated with mdast GFM table row nodes by the ecosystem.
  */
-interface TableRowData extends Data {}
+interface TableRowData extends Data$1 {}
 
 /**
  * Markdown GFM table cell.
  */
-interface TableCell extends Parent {
+interface TableCell extends Parent$1 {
     /**
      * Node type of mdast GFM table cell.
      */
@@ -1077,12 +1077,12 @@ interface TableCell extends Parent {
 /**
  * Info associated with mdast GFM table cell nodes by the ecosystem.
  */
-interface TableCellData extends Data {}
+interface TableCellData extends Data$1 {}
 
 /**
  * Markdown text.
  */
-interface Text extends Literal {
+interface Text$1 extends Literal$1 {
     /**
      * Node type of mdast text.
      */
@@ -1090,18 +1090,18 @@ interface Text extends Literal {
     /**
      * Data associated with the mdast text.
      */
-    data?: TextData | undefined;
+    data?: TextData$1 | undefined;
 }
 
 /**
  * Info associated with mdast text nodes by the ecosystem.
  */
-interface TextData extends Data {}
+interface TextData$1 extends Data$1 {}
 
 /**
  * Markdown thematic break (horizontal rule).
  */
-interface ThematicBreak extends Node {
+interface ThematicBreak extends Node$1 {
     /**
      * Node type of mdast thematic break.
      */
@@ -1115,12 +1115,12 @@ interface ThematicBreak extends Node {
 /**
  * Info associated with mdast thematic break nodes by the ecosystem.
  */
-interface ThematicBreakData extends Data {}
+interface ThematicBreakData extends Data$1 {}
 
 /**
  * Markdown YAML.
  */
-interface Yaml extends Literal {
+interface Yaml extends Literal$1 {
     /**
      * Node type of mdast YAML.
      */
@@ -1134,7 +1134,29 @@ interface Yaml extends Literal {
 /**
  * Info associated with mdast YAML nodes by the ecosystem.
  */
-interface YamlData extends Data {}
+interface YamlData extends Data$1 {}
+
+// ## Interfaces
+
+/**
+ * Info associated with hast nodes by the ecosystem.
+ *
+ * This space is guaranteed to never be specified by unist or hast.
+ * But you can use it in utilities and plugins to store data.
+ *
+ * This type can be augmented to register custom data.
+ * For example:
+ *
+ * ```ts
+ * declare module 'hast' {
+ *   interface Data {
+ *     // `someNode.data.myId` is typed as `number | undefined`
+ *     myId?: number | undefined
+ *   }
+ * }
+ * ```
+ */
+interface Data extends Data$2 {}
 
 /**
  * Info associated with an element.
@@ -1143,6 +1165,222 @@ interface Properties {
     [PropertyName: string]: boolean | number | string | null | undefined | Array<string | number>;
 }
 
+// ## Content maps
+
+/**
+ * Union of registered hast nodes that can occur in {@link Element}.
+ *
+ * To register mote custom hast nodes, add them to {@link ElementContentMap}.
+ * They will be automatically added here.
+ */
+type ElementContent = ElementContentMap[keyof ElementContentMap];
+
+/**
+ * Registry of all hast nodes that can occur as children of {@link Element}.
+ *
+ * For a union of all {@link Element} children, see {@link ElementContent}.
+ */
+interface ElementContentMap {
+    comment: Comment;
+    element: Element;
+    text: Text;
+}
+
+/**
+ * Union of registered hast nodes that can occur in {@link Root}.
+ *
+ * To register custom hast nodes, add them to {@link RootContentMap}.
+ * They will be automatically added here.
+ */
+type RootContent = RootContentMap[keyof RootContentMap];
+
+/**
+ * Registry of all hast nodes that can occur as children of {@link Root}.
+ *
+ * > 👉 **Note**: {@link Root} does not need to be an entire document.
+ * > it can also be a fragment.
+ *
+ * For a union of all {@link Root} children, see {@link RootContent}.
+ */
+interface RootContentMap {
+    comment: Comment;
+    doctype: Doctype;
+    element: Element;
+    text: Text;
+}
+
+// ## Abstract nodes
+
+/**
+ * Abstract hast node.
+ *
+ * This interface is supposed to be extended.
+ * If you can use {@link Literal} or {@link Parent}, you should.
+ * But for example in HTML, a `Doctype` is neither literal nor parent, but
+ * still a node.
+ *
+ * To register custom hast nodes, add them to {@link RootContentMap} and other
+ * places where relevant (such as {@link ElementContentMap}).
+ *
+ * For a union of all registered hast nodes, see {@link Nodes}.
+ */
+interface Node extends Node$2 {
+    /**
+     * Info from the ecosystem.
+     */
+    data?: Data | undefined;
+}
+
+/**
+ * Abstract hast node that contains the smallest possible value.
+ *
+ * This interface is supposed to be extended if you make custom hast nodes.
+ *
+ * For a union of all registered hast literals, see {@link Literals}.
+ */
+interface Literal extends Node {
+    /**
+     * Plain-text value.
+     */
+    value: string;
+}
+
+/**
+ * Abstract hast node that contains other hast nodes (*children*).
+ *
+ * This interface is supposed to be extended if you make custom hast nodes.
+ *
+ * For a union of all registered hast parents, see {@link Parents}.
+ */
+interface Parent extends Node {
+    /**
+     * List of children.
+     */
+    children: RootContent[];
+}
+
+// ## Concrete nodes
+
+/**
+ * HTML comment.
+ */
+interface Comment extends Literal {
+    /**
+     * Node type of HTML comments in hast.
+     */
+    type: "comment";
+    /**
+     * Data associated with the comment.
+     */
+    data?: CommentData | undefined;
+}
+
+/**
+ * Info associated with hast comments by the ecosystem.
+ */
+interface CommentData extends Data {}
+
+/**
+ * HTML document type.
+ */
+interface Doctype extends Node$2 {
+    /**
+     * Node type of HTML document types in hast.
+     */
+    type: "doctype";
+    /**
+     * Data associated with the doctype.
+     */
+    data?: DoctypeData | undefined;
+}
+
+/**
+ * Info associated with hast doctypes by the ecosystem.
+ */
+interface DoctypeData extends Data {}
+
+/**
+ * HTML element.
+ */
+interface Element extends Parent {
+    /**
+     * Node type of elements.
+     */
+    type: "element";
+    /**
+     * Tag name (such as `'body'`) of the element.
+     */
+    tagName: string;
+    /**
+     * Info associated with the element.
+     */
+    properties: Properties;
+    /**
+     * Children of element.
+     */
+    children: ElementContent[];
+    /**
+     * When the `tagName` field is `'template'`, a `content` field can be
+     * present.
+     */
+    content?: Root | undefined;
+    /**
+     * Data associated with the element.
+     */
+    data?: ElementData | undefined;
+}
+
+/**
+ * Info associated with hast elements by the ecosystem.
+ */
+interface ElementData extends Data {}
+
+/**
+ * Document fragment or a whole document.
+ *
+ * Should be used as the root of a tree and must not be used as a child.
+ *
+ * Can also be used as the value for the content field on a `'template'` element.
+ */
+interface Root extends Parent {
+    /**
+     * Node type of hast root.
+     */
+    type: "root";
+    /**
+     * Children of root.
+     */
+    children: RootContent[];
+    /**
+     * Data associated with the hast root.
+     */
+    data?: RootData | undefined;
+}
+
+/**
+ * Info associated with hast root nodes by the ecosystem.
+ */
+interface RootData extends Data {}
+
+/**
+ * HTML character data (plain text).
+ */
+interface Text extends Literal {
+    /**
+     * Node type of HTML character data (plain text) in hast.
+     */
+    type: "text";
+    /**
+     * Data associated with the text.
+     */
+    data?: TextData | undefined;
+}
+
+/**
+ * Info associated with hast texts by the ecosystem.
+ */
+interface TextData extends Data {}
+
 /**
  * PipelineStage defines the execution order of plugins in the processing pipeline.
  * Plugins are sorted and executed in ascending order based on these stage values.
@@ -1185,6 +1423,16 @@ interface MdastPlugin {
     stage?: PipelineStage | PipelineStageName;
     /** Execution priority within the same stage. Lower values run earlier. */
     order?: number;
+    /**
+     * If true, this plugin is considered the "main" plugin for its stage.
+     * When multiple plugins exist in the same stage, a 'main' plugin will
+     * replace the default (first) plugin of that stage.
+     */
+    main?: boolean;
+    /** Run this plugin before the named plugin (within the same stage). */
+    before?: string;
+    /** Run this plugin after the named plugin (within the same stage). */
+    after?: string;
 }
 /**
  * Defines a document format, encompassing its input (parsing) and output (serialization) strategies.
@@ -1216,17 +1464,17 @@ interface MdastDataOrigin {
     [k: string]: unknown;
 }
 /** Represents a highlighted text (mark) node in mdast. */
-interface MdastMark extends Parent$1 {
+interface MdastMark extends Parent$2 {
     type: 'mark';
     children: PhrasingContent[];
 }
 /** Represents a subscript text node in mdast. */
-interface MdastSub extends Parent$1 {
+interface MdastSub extends Parent$2 {
     type: 'sub';
     children: PhrasingContent[];
 }
 /** Represents a superscript text node in mdast. */
-interface MdastSup extends Parent$1 {
+interface MdastSup extends Parent$2 {
     type: 'sup';
     children: PhrasingContent[];
 }
@@ -1238,6 +1486,14 @@ declare module 'mdast' {
         hProperties?: Properties;
         /** Source origin information */
         _origin?: MdastDataOrigin;
+        readability?: {
+            title: string;
+            byline: string;
+            excerpt: string;
+            siteName: string;
+            lang: string;
+        };
+        [k: string]: any;
     }
     interface CodeData extends Data {
         /** Title of the code block */
@@ -1279,11 +1535,19 @@ declare class MdastBasePipeline {
     static getFormat(id: string): MdastFormat | undefined;
     protected input: VFileCompatible;
     protected queue: MdastPlugin[];
+    protected _data: Record<string, any>;
     /**
      * Initializes a new pipeline instance with the given input.
      * @param input - Content to process (string, Buffer, VFile, or AST Node).
      */
     constructor(input: VFileCompatible);
+    /**
+     * Configures global data for the pipeline, which will be available to all plugins via this.data().
+     * @param key - Data key or a record of multiple data entries.
+     * @param value - Value to set (if key is a string).
+     * @returns The pipeline instance for chaining.
+     */
+    data(key: string | Record<string, any>, value?: any): this;
     /**
      * Instance-level access to the global format registry.
      */
@@ -1321,20 +1585,27 @@ declare class MdastBasePipeline {
      */
     to(fmt: string | MdastFormat, overrides?: Record<string, any>): Promise<VFile>;
     /**
-     * Adds a plugin to the pipeline's compile stage.
-     * @param plugin - The unified plugin function.
-     * @param options - Arguments for the plugin.
+     * Adds a plugin or an array of plugins to the pipeline's compile stage.
+     * @param plugin - The unified plugin function, a MdastPlugin object, or an array of them.
+     * @param options - Arguments for the plugin(s).
      * @returns The pipeline instance for chaining.
      */
-    use(plugin: any, ...options: any[]): this;
+    use(plugin: Plugin | MdastPlugin | (Plugin | MdastPlugin)[], ...options: any[]): this;
     /**
-     * Adds a plugin to the pipeline at a specific stage.
+     * Adds a plugin or an array of plugins to the pipeline at a specific stage.
      * @param stage - The stage name or numeric value.
-     * @param plugin - The unified plugin function.
-     * @param options - Arguments for the plugin.
+     * @param plugin - The unified plugin function, a MdastPlugin object, or an array of them.
+     * @param options - Arguments for the plugin(s).
+     * @returns The pipeline instance for chaining.
+     */
+    useAt(stage: PipelineStage | PipelineStageName, plugin: Plugin | MdastPlugin | (Plugin | MdastPlugin)[], ...options: any[]): this;
+    /**
+     * Adds a plugin or an array of plugins to the pipeline. The stage is taken from the plugin object(s).
+     * @param plugin - The MdastPlugin object or an array of them.
+     * @param options - Arguments for the plugin(s) (overrides plugin.options if provided).
      * @returns The pipeline instance for chaining.
      */
-    useAt(stage: PipelineStageName, plugin: any, ...options: any[]): this;
+    useAt(plugin: MdastPlugin | MdastPlugin[], ...options: any[]): this;
     /**
      * Sets the priority order for the most recently added plugin.
      * Plugins with lower order run earlier within the same stage.
@@ -1342,6 +1613,16 @@ declare class MdastBasePipeline {
      * @returns The pipeline instance for chaining.
      */
     priority(order: number): this;
+    /**
+     * Modifies the options of a plugin that is already in the pipeline queue.
+     * Searches from the end of the queue and updates the first match found.
+     *
+     * @param pluginName - The name of the plugin to modify.
+     *                     Matches against explicit plugin name or function name.
+     * @param options - The new options to pass to the plugin (replaces existing options).
+     * @returns The pipeline instance for chaining.
+     */
+    configure(pluginName: string, ...options: any[]): this;
     /**
      * Assembles a unified processor based on the sorted plugin queue.
      * @protected
@@ -1375,16 +1656,16 @@ declare class MdastPipeline extends MdastBasePipeline {
      * @param options.overrides - Map for plugin option overrides.
      */
     toAst(options?: {
-        stage?: PipelineStageName;
+        stage?: PipelineStage | PipelineStageName;
         overrides?: Record<string, any>;
-    }): Promise<Root>;
+    }): Promise<Root$1>;
     /** Alias for toHtml() */
     toHTML(): Promise<string>;
     /** Alias for toAst() */
     toAST(options?: {
-        stage?: PipelineStageName;
+        stage?: PipelineStage | PipelineStageName;
         overrides?: Record<string, any>;
-    }): Promise<Root>;
+    }): Promise<Root$1>;
 }
 /**
  * Entry point for the fluent mdast-plus API.
@@ -1427,4 +1708,47 @@ declare function jsonParser(this: any): void;
  */
 declare const astFormat: MdastFormat;
 
-export { DefaultPipelineStage, MdastBasePipeline, type MdastDataOrigin, type MdastFormat, type MdastMark, MdastPipeline, type MdastPlugin, type MdastSub, type MdastSup, PipelineStage, type PipelineStageName, astCompiler, astFormat, htmlFormat, jsonParser, markdownFormat, mdast };
+interface ReadabilityOptions {
+    url?: string;
+    readability?: Record<string, any> | false;
+    jsdom?: Record<string, any>;
+    'rehype-parse'?: Record<string, any>;
+}
+/**
+ * A unified/rehype plugin that uses Mozilla's Readability to parse the input HTML.
+ */
+declare const htmlReadability: Plugin<[ReadabilityOptions?], string, Root>;
+/**
+ * Pre-configured MdastPlugin for html-readability.
+ */
+declare const htmlReadabilityPlugin: {
+    name: string;
+    plugin: Plugin<[(ReadabilityOptions | undefined)?], string, Root>;
+    stage: PipelineStage;
+    main: boolean;
+};
+/**
+ * Plugin to restore readability metadata after HAST to MDAST conversion.
+ */
+declare const restoreReadabilityMetaPlugin: {
+    name: string;
+    plugin: () => (tree: any, file: any) => void;
+    stage: PipelineStage;
+    after: string;
+};
+/**
+ * Combined plugins for HTML readability.
+ */
+declare const htmlReadabilityPlugins: ({
+    name: string;
+    plugin: Plugin<[(ReadabilityOptions | undefined)?], string, Root>;
+    stage: PipelineStage;
+    main: boolean;
+} | {
+    name: string;
+    plugin: () => (tree: any, file: any) => void;
+    stage: PipelineStage;
+    after: string;
+})[];
+
+export { DefaultPipelineStage, MdastBasePipeline, type MdastDataOrigin, type MdastFormat, type MdastMark, MdastPipeline, type MdastPlugin, type MdastSub, type MdastSup, PipelineStage, type PipelineStageName, type ReadabilityOptions, astCompiler, astFormat, htmlFormat, htmlReadability, htmlReadabilityPlugin, htmlReadabilityPlugins, jsonParser, markdownFormat, mdast, restoreReadabilityMetaPlugin };