@isdk/mdast-plus 0.1.2 → 0.2.0

package/docs/functions/mdast.md

@@ -6,9 +6,9 @@
 
 # Function: mdast()
 
-> **mdast**(`input`): [`FluentProcessor`](../classes/FluentProcessor.md)
+> **mdast**(`input`): [`MdastPipeline`](../classes/MdastPipeline.md)
 
-Defined in: [packages/mdast-plus/src/pipeline.ts:191](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/pipeline.ts#L191)
+Defined in: [packages/mdast-plus/src/pipeline.ts:486](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/pipeline.ts#L486)
 
 Entry point for the fluent mdast-plus API.
 
@@ -16,12 +16,12 @@ Entry point for the fluent mdast-plus API.
 
 ### input
 
-`any`
+`Compatible`
 
 The input content (string or mdast tree)
 
 ## Returns
 
-[`FluentProcessor`](../classes/FluentProcessor.md)
+[`MdastPipeline`](../classes/MdastPipeline.md)
 
 A FluentProcessor instance

package/docs/globals.md

@@ -4,35 +4,42 @@
 
 # @isdk/mdast-plus
 
+## Enumerations
+
+- [PipelineStage](enumerations/PipelineStage.md)
+
 ## Classes
 
-- [FluentProcessor](classes/FluentProcessor.md)
+- [MdastBasePipeline](classes/MdastBasePipeline.md)
+- [MdastPipeline](classes/MdastPipeline.md)
 
 ## Interfaces
 
-- [ConvertResult](interfaces/ConvertResult.md)
-- [MdastAsset](interfaces/MdastAsset.md)
 - [MdastDataOrigin](interfaces/MdastDataOrigin.md)
-- [MdastFormatDefinition](interfaces/MdastFormatDefinition.md)
+- [MdastFormat](interfaces/MdastFormat.md)
 - [MdastMark](interfaces/MdastMark.md)
 - [MdastPlugin](interfaces/MdastPlugin.md)
-- [MdastReader](interfaces/MdastReader.md)
 - [MdastSub](interfaces/MdastSub.md)
 - [MdastSup](interfaces/MdastSup.md)
-- [MdastTransformer](interfaces/MdastTransformer.md)
-- [MdastWriter](interfaces/MdastWriter.md)
+- [ReadabilityOptions](interfaces/ReadabilityOptions.md)
 
 ## Type Aliases
 
-- [Stage](type-aliases/Stage.md)
+- [PipelineStageName](type-aliases/PipelineStageName.md)
 
 ## Variables
 
+- [astFormat](variables/astFormat.md)
+- [DefaultPipelineStage](variables/DefaultPipelineStage.md)
 - [htmlFormat](variables/htmlFormat.md)
+- [htmlReadability](variables/htmlReadability.md)
+- [htmlReadabilityPlugin](variables/htmlReadabilityPlugin.md)
+- [htmlReadabilityPlugins](variables/htmlReadabilityPlugins.md)
 - [markdownFormat](variables/markdownFormat.md)
+- [restoreReadabilityMetaPlugin](variables/restoreReadabilityMetaPlugin.md)
 
 ## Functions
 
-- [htmlStringify](functions/htmlStringify.md)
-- [markdownCommon](functions/markdownCommon.md)
+- [astCompiler](functions/astCompiler.md)
+- [jsonParser](functions/jsonParser.md)
 - [mdast](functions/mdast.md)

package/docs/interfaces/MdastDataOrigin.md

@@ -6,9 +6,9 @@
 
 # Interface: MdastDataOrigin
 
-Defined in: [packages/mdast-plus/src/types.ts:60](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L60)
+Defined in: [packages/mdast-plus/src/types.ts:86](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L86)
 
-Original metadata for a node.
+Metadata capturing the origin of a node during conversion.
 
 ## Indexable
 
@@ -20,9 +20,9 @@ Original metadata for a node.
 
 > **format**: `string`
 
-Defined in: [packages/mdast-plus/src/types.ts:62](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L62)
+Defined in: [packages/mdast-plus/src/types.ts:88](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L88)
 
-Source format
+The original source format.
 
 ***
 
@@ -30,9 +30,9 @@ Source format
 
 > `optional` **hash**: `string`
 
-Defined in: [packages/mdast-plus/src/types.ts:66](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L66)
+Defined in: [packages/mdast-plus/src/types.ts:92](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L92)
 
-Hash of the source content
+Hash used for caching or change detection.
 
 ***
 
@@ -40,6 +40,6 @@ Hash of the source content
 
 > `optional` **raw**: `unknown`
 
-Defined in: [packages/mdast-plus/src/types.ts:64](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L64)
+Defined in: [packages/mdast-plus/src/types.ts:90](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L90)
 
-Raw data from the source
+The raw content from the source before conversion.

package/docs/interfaces/MdastFormat.md

@@ -0,0 +1,71 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / MdastFormat
+
+# Interface: MdastFormat
+
+Defined in: [packages/mdast-plus/src/types.ts:66](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L66)
+
+Defines a document format, encompassing its input (parsing) and output (serialization) strategies.
+
+## Properties
+
+### extensions?
+
+> `optional` **extensions**: `string`[]
+
+Defined in: [packages/mdast-plus/src/types.ts:72](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L72)
+
+File extensions associated with this format.
+
+***
+
+### id
+
+> **id**: `string`
+
+Defined in: [packages/mdast-plus/src/types.ts:68](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L68)
+
+Unique identifier for the format (e.g., 'markdown', 'html').
+
+***
+
+### input?
+
+> `optional` **input**: [`MdastPlugin`](MdastPlugin.md)[]
+
+Defined in: [packages/mdast-plus/src/types.ts:77](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L77)
+
+Plugins used for reading this format into a standard AST (Parser + Normalizer).
+
+***
+
+### mediaTypes?
+
+> `optional` **mediaTypes**: `string`[]
+
+Defined in: [packages/mdast-plus/src/types.ts:74](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L74)
+
+MIME types associated with this format.
+
+***
+
+### output?
+
+> `optional` **output**: [`MdastPlugin`](MdastPlugin.md)[]
+
+Defined in: [packages/mdast-plus/src/types.ts:80](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L80)
+
+Plugins used for serializing the AST into this format (Finalizer + Stringifier).
+
+***
+
+### title?
+
+> `optional` **title**: `string`
+
+Defined in: [packages/mdast-plus/src/types.ts:70](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L70)
+
+Human-readable title.

package/docs/interfaces/MdastMark.md

@@ -6,9 +6,9 @@
 
 # Interface: MdastMark
 
-Defined in: [packages/mdast-plus/src/types.ts:73](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L73)
+Defined in: [packages/mdast-plus/src/types.ts:97](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L97)
 
-mdast node for highlighted text (mark).
+Represents a highlighted text (mark) node in mdast.
 
 ## Extends
 
@@ -20,7 +20,7 @@ mdast node for highlighted text (mark).
 
 > **children**: `PhrasingContent`[]
 
-Defined in: [packages/mdast-plus/src/types.ts:75](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L75)
+Defined in: [packages/mdast-plus/src/types.ts:99](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L99)
 
 List of children.
 
@@ -65,7 +65,7 @@ have a position.
 
 > **type**: `"mark"`
 
-Defined in: [packages/mdast-plus/src/types.ts:74](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L74)
+Defined in: [packages/mdast-plus/src/types.ts:98](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L98)
 
 Node type.
 

package/docs/interfaces/MdastPlugin.md

@@ -6,60 +6,92 @@
 
 # Interface: MdastPlugin
 
-Defined in: [packages/mdast-plus/src/types.ts:13](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L13)
+Defined in: [packages/mdast-plus/src/types.ts:33](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L33)
 
-Definition for an mdast plugin.
+Configuration for a plugin within the mdast-plus pipeline.
+It wraps a standard unified plugin with execution metadata.
 
 ## Properties
 
-### name
+### after?
 
-> **name**: `string`
+> `optional` **after**: `string`
 
-Defined in: [packages/mdast-plus/src/types.ts:15](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L15)
+Defined in: [packages/mdast-plus/src/types.ts:60](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L60)
 
-Plugin name
+Run this plugin after the named plugin (within the same stage).
 
 ***
 
-### order?
+### before?
 
-> `optional` **order**: `number`
+> `optional` **before**: `string`
 
-Defined in: [packages/mdast-plus/src/types.ts:19](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L19)
+Defined in: [packages/mdast-plus/src/types.ts:58](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L58)
 
-Execution order within the stage (lower numbers run first)
+Run this plugin before the named plugin (within the same stage).
 
 ***
 
-### stage?
+### main?
+
+> `optional` **main**: `boolean`
+
+Defined in: [packages/mdast-plus/src/types.ts:56](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L56)
+
+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.
 
-> `optional` **stage**: [`Stage`](../type-aliases/Stage.md)
+***
+
+### name?
+
+> `optional` **name**: `string`
 
-Defined in: [packages/mdast-plus/src/types.ts:17](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L17)
+Defined in: [packages/mdast-plus/src/types.ts:39](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L39)
 
-Processing stage the plugin belongs to
+Optional name for the plugin.
+Used for identification in overrides and logging.
+If not provided, defaults to the plugin function's name.
 
 ***
 
-### transform()
+### options?
 
-> **transform**: (`tree`, `ctx`) => `void` \| `Promise`\<`void`\>
+> `optional` **options**: `any`[]
 
-Defined in: [packages/mdast-plus/src/types.ts:21](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L21)
+Defined in: [packages/mdast-plus/src/types.ts:46](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L46)
 
-Transformation function
+Arguments passed to the plugin.
+MUST be an array of arguments (e.g., [optionsObject]).
 
-#### Parameters
+***
 
-##### tree
+### order?
 
-`Root`
+> `optional` **order**: `number`
 
-##### ctx
+Defined in: [packages/mdast-plus/src/types.ts:50](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L50)
+
+Execution priority within the same stage. Lower values run earlier.
+
+***
+
+### plugin
+
+> **plugin**: `Plugin`\<`any`[], `any`, `any`\>
+
+Defined in: [packages/mdast-plus/src/types.ts:41](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L41)
+
+The standard unified plugin (attacher) function.
+
+***
+
+### stage?
 
-`any`
+> `optional` **stage**: [`PipelineStage`](../enumerations/PipelineStage.md) \| `"parse"` \| `"normalize"` \| `"compile"` \| `"finalize"` \| `"stringify"`
 
-#### Returns
+Defined in: [packages/mdast-plus/src/types.ts:48](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L48)
 
-`void` \| `Promise`\<`void`\>
+The stage in which this plugin should run.

package/docs/interfaces/MdastSub.md

@@ -6,9 +6,9 @@
 
 # Interface: MdastSub
 
-Defined in: [packages/mdast-plus/src/types.ts:81](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L81)
+Defined in: [packages/mdast-plus/src/types.ts:103](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L103)
 
-mdast node for subscript text.
+Represents a subscript text node in mdast.
 
 ## Extends
 
@@ -20,7 +20,7 @@ mdast node for subscript text.
 
 > **children**: `PhrasingContent`[]
 
-Defined in: [packages/mdast-plus/src/types.ts:83](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L83)
+Defined in: [packages/mdast-plus/src/types.ts:105](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L105)
 
 List of children.
 
@@ -65,7 +65,7 @@ have a position.
 
 > **type**: `"sub"`
 
-Defined in: [packages/mdast-plus/src/types.ts:82](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L82)
+Defined in: [packages/mdast-plus/src/types.ts:104](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L104)
 
 Node type.
 

package/docs/interfaces/MdastSup.md

@@ -6,9 +6,9 @@
 
 # Interface: MdastSup
 
-Defined in: [packages/mdast-plus/src/types.ts:89](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L89)
+Defined in: [packages/mdast-plus/src/types.ts:109](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L109)
 
-mdast node for superscript text.
+Represents a superscript text node in mdast.
 
 ## Extends
 
@@ -20,7 +20,7 @@ mdast node for superscript text.
 
 > **children**: `PhrasingContent`[]
 
-Defined in: [packages/mdast-plus/src/types.ts:91](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L91)
+Defined in: [packages/mdast-plus/src/types.ts:111](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L111)
 
 List of children.
 
@@ -65,7 +65,7 @@ have a position.
 
 > **type**: `"sup"`
 
-Defined in: [packages/mdast-plus/src/types.ts:90](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/types.ts#L90)
+Defined in: [packages/mdast-plus/src/types.ts:110](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L110)
 
 Node type.
 

package/docs/interfaces/ReadabilityOptions.md

@@ -0,0 +1,33 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / ReadabilityOptions
+
+# Interface: ReadabilityOptions
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:6](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L6)
+
+## Properties
+
+### enable?
+
+> `optional` **enable**: `boolean`
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:7](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L7)
+
+***
+
+### jsdom?
+
+> `optional` **jsdom**: `Record`\<`string`, `any`\>
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:9](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L9)
+
+***
+
+### readability?
+
+> `optional` **readability**: `Record`\<`string`, `any`\>
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:8](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L8)

package/docs/type-aliases/PipelineStageName.md

@@ -0,0 +1,13 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / PipelineStageName
+
+# Type Alias: PipelineStageName
+
+> **PipelineStageName** = keyof *typeof* [`PipelineStage`](../enumerations/PipelineStage.md)
+
+Defined in: [packages/mdast-plus/src/types.ts:27](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L27)
+
+String names corresponding to the PipelineStage levels.

package/docs/variables/DefaultPipelineStage.md

@@ -0,0 +1,13 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / DefaultPipelineStage
+
+# Variable: DefaultPipelineStage
+
+> `const` **DefaultPipelineStage**: [`compile`](../enumerations/PipelineStage.md#compile) = `PipelineStage.compile`
+
+Defined in: [packages/mdast-plus/src/types.ts:24](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/types.ts#L24)
+
+The default stage assigned to a plugin if none is specified.

package/docs/variables/astFormat.md

@@ -0,0 +1,15 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / astFormat
+
+# Variable: astFormat
+
+> `const` **astFormat**: [`MdastFormat`](../interfaces/MdastFormat.md)
+
+Defined in: [packages/mdast-plus/src/formats/ast.ts:35](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/formats/ast.ts#L35)
+
+AST (MDAST) format definition.
+Supports reading from JSON strings and provides full normalization
+through the standard mdast-plus plugin set.

package/docs/variables/htmlFormat.md

@@ -6,9 +6,11 @@
 
 # Variable: htmlFormat
 
-> `const` **htmlFormat**: [`MdastFormatDefinition`](../interfaces/MdastFormatDefinition.md)
+> `const` **htmlFormat**: [`MdastFormat`](../interfaces/MdastFormat.md)
 
-Defined in: [packages/mdast-plus/src/formats/html.ts:33](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/formats/html.ts#L33)
+Defined in: [packages/mdast-plus/src/formats/html.ts:71](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/formats/html.ts#L71)
 
-HTML format definition for FluentProcessor.
-Handles both parsing (HTML -> MDAST) and stringifying (MDAST -> HTML).
+HTML format definition.
+
+Provides a bidirectional mapping between HTML strings and mdast-plus ASTs.
+Includes built-in sanitization and support for table spans and image dimensions.

package/docs/variables/htmlReadability.md

@@ -0,0 +1,13 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / htmlReadability
+
+# Variable: htmlReadability
+
+> `const` **htmlReadability**: `Plugin`\<\[([`ReadabilityOptions`](../interfaces/ReadabilityOptions.md) \| `boolean`)?\], `string`, `Root`\>
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:15](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L15)
+
+A unified/rehype plugin that uses Mozilla's Readability to parse the input HTML.

package/docs/variables/htmlReadabilityPlugin.md

@@ -0,0 +1,27 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / htmlReadabilityPlugin
+
+# Variable: htmlReadabilityPlugin
+
+> `const` **htmlReadabilityPlugin**: `object`
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:77](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L77)
+
+Pre-configured MdastPlugin for html-readability.
+
+## Type Declaration
+
+### name
+
+> **name**: `string` = `'readability'`
+
+### plugin
+
+> **plugin**: `Plugin`\<\[(`boolean` \| [`ReadabilityOptions`](../interfaces/ReadabilityOptions.md))?\], `string`, `Root`\> = `htmlReadability`
+
+### stage
+
+> **stage**: [`PipelineStage`](../enumerations/PipelineStage.md) = `PipelineStage.parse`

package/docs/variables/htmlReadabilityPlugins.md

@@ -0,0 +1,13 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / htmlReadabilityPlugins
+
+# Variable: htmlReadabilityPlugins
+
+> `const` **htmlReadabilityPlugins**: (\{ `name`: `string`; `plugin`: `Plugin`\<\[(`boolean` \| [`ReadabilityOptions`](../interfaces/ReadabilityOptions.md))?\], `string`, `Root`\>; `stage`: [`PipelineStage`](../enumerations/PipelineStage.md); \} \| \{ `after`: `string`; `name`: `string`; `plugin`: () => (`tree`, `file`) => `void`; `stage`: [`PipelineStage`](../enumerations/PipelineStage.md); \})[]
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:103](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L103)
+
+Combined plugins for HTML readability.

package/docs/variables/markdownFormat.md

@@ -6,9 +6,11 @@
 
 # Variable: markdownFormat
 
-> `const` **markdownFormat**: [`MdastFormatDefinition`](../interfaces/MdastFormatDefinition.md)
+> `const` **markdownFormat**: [`MdastFormat`](../interfaces/MdastFormat.md)
 
-Defined in: [packages/mdast-plus/src/formats/markdown.ts:39](https://github.com/isdk/mdast-plus.js/blob/75ee549d3fb31ef4bc1b4a6b3307f6368072874e/src/formats/markdown.ts#L39)
+Defined in: [packages/mdast-plus/src/formats/markdown.ts:103](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/formats/markdown.ts#L103)
 
-Markdown format definition for FluentProcessor.
-Handles both parsing (Markdown -> MDAST) and stringifying (MDAST -> Markdown).
+Markdown format definition.
+
+Supports GFM, Directives, Math, and Frontmatter. 
+Provides a bidirectional mapping between Markdown strings and mdast-plus ASTs.

package/docs/variables/restoreReadabilityMetaPlugin.md

@@ -0,0 +1,49 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / restoreReadabilityMetaPlugin
+
+# Variable: restoreReadabilityMetaPlugin
+
+> `const` **restoreReadabilityMetaPlugin**: `object`
+
+Defined in: [packages/mdast-plus/src/plugins/html-readability.ts:88](https://github.com/isdk/mdast-plus.js/blob/8870eec4ef97dd48bead818813d06479ceff9450/src/plugins/html-readability.ts#L88)
+
+Plugin to restore readability metadata after HAST to MDAST conversion.
+
+## Type Declaration
+
+### after
+
+> **after**: `string` = `'rehype-remark'`
+
+### name
+
+> **name**: `string` = `'restore-readability-meta'`
+
+### plugin()
+
+> **plugin**: () => (`tree`, `file`) => `void`
+
+#### Returns
+
+> (`tree`, `file`): `void`
+
+##### Parameters
+
+###### tree
+
+`any`
+
+###### file
+
+`any`
+
+##### Returns
+
+`void`
+
+### stage
+
+> **stage**: [`PipelineStage`](../enumerations/PipelineStage.md) = `PipelineStage.parse`