@isdk/mdast-plus 0.1.2 → 0.1.3

package/docs/classes/MdastPipeline.md

@@ -0,0 +1,531 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / MdastPipeline
+
+# Class: MdastPipeline
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:275](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L275)
+
+Extended pipeline with convenience methods for common formats.
+
+## Extends
+
+- [`MdastBasePipeline`](MdastBasePipeline.md)
+
+## Constructors
+
+### Constructor
+
+> **new MdastPipeline**(`input`): `MdastPipeline`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:53](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L53)
+
+Initializes a new pipeline instance with the given input.
+
+#### Parameters
+
+##### input
+
+`Compatible`
+
+Content to process (string, Buffer, VFile, or AST Node).
+
+#### Returns
+
+`MdastPipeline`
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`constructor`](MdastBasePipeline.md#constructor)
+
+## Properties
+
+### input
+
+> `protected` **input**: `Compatible`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:46](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L46)
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`input`](MdastBasePipeline.md#input)
+
+***
+
+### queue
+
+> `protected` **queue**: [`MdastPlugin`](../interfaces/MdastPlugin.md)[] = `[]`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:47](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L47)
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`queue`](MdastBasePipeline.md#queue)
+
+## Methods
+
+### assembleProcessor()
+
+> `protected` **assembleProcessor**(`queue`): `Processor`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:254](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L254)
+
+Assembles a unified processor based on the sorted plugin queue.
+
+#### Parameters
+
+##### queue
+
+[`MdastPlugin`](../interfaces/MdastPlugin.md)[]
+
+#### Returns
+
+`Processor`
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`assembleProcessor`](MdastBasePipeline.md#assembleprocessor)
+
+***
+
+### ensureInputPlugins()
+
+> `protected` **ensureInputPlugins**(`queue`, `overrides?`, `maxStage?`): `void`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:123](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L123)
+
+Ensures that input plugins (parser, normalizers) are present in the queue.
+Adds implicit plugins if no parser is detected.
+
+#### Parameters
+
+##### queue
+
+[`MdastPlugin`](../interfaces/MdastPlugin.md)[]
+
+##### overrides?
+
+`Record`\<`string`, `any`\>
+
+##### maxStage?
+
+[`PipelineStage`](../enumerations/PipelineStage.md) = `PipelineStage.stringify`
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`ensureInputPlugins`](MdastBasePipeline.md#ensureinputplugins)
+
+***
+
+### from()
+
+> **from**(`fmt`, `overrides?`): `this`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:152](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L152)
+
+Configures the input format and adds its associated plugins to the pipeline.
+
+#### Parameters
+
+##### fmt
+
+Format ID or definition.
+
+`string` | [`MdastFormat`](../interfaces/MdastFormat.md)
+
+##### overrides?
+
+`Record`\<`string`, `any`\>
+
+Optional map to override plugin options by plugin name.
+
+#### Returns
+
+`this`
+
+The pipeline instance for chaining.
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`from`](MdastBasePipeline.md#from)
+
+***
+
+### getFormat()
+
+> **getFormat**(`id`): `undefined` \| [`MdastFormat`](../interfaces/MdastFormat.md)
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:60](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L60)
+
+Instance-level access to the global format registry.
+
+#### Parameters
+
+##### id
+
+`string`
+
+#### Returns
+
+`undefined` \| [`MdastFormat`](../interfaces/MdastFormat.md)
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`getFormat`](MdastBasePipeline.md#getformat)
+
+***
+
+### priority()
+
+> **priority**(`order`): `this`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:242](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L242)
+
+Sets the priority order for the most recently added plugin.
+Plugins with lower order run earlier within the same stage.
+
+#### Parameters
+
+##### order
+
+`number`
+
+Numeric priority.
+
+#### Returns
+
+`this`
+
+The pipeline instance for chaining.
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`priority`](MdastBasePipeline.md#priority)
+
+***
+
+### to()
+
+> **to**(`fmt`, `overrides?`): `Promise`\<`VFile`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:172](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L172)
+
+Processes the pipeline and serializes the result into the specified format.
+
+#### Parameters
+
+##### fmt
+
+Target format ID or definition.
+
+`string` | [`MdastFormat`](../interfaces/MdastFormat.md)
+
+##### overrides?
+
+`Record`\<`string`, `any`\>
+
+Optional map to override plugin options.
+
+#### Returns
+
+`Promise`\<`VFile`\>
+
+A promise resolving to a VFile containing the result.
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`to`](MdastBasePipeline.md#to)
+
+***
+
+### toAst()
+
+> **toAst**(`options?`): `Promise`\<`Root`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:312](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L312)
+
+Finalizes the pipeline and returns the resulting AST (Root node).
+
+#### Parameters
+
+##### options?
+
+Configuration for the extraction.
+
+###### overrides?
+
+`Record`\<`string`, `any`\>
+
+Map for plugin option overrides.
+
+###### stage?
+
+`"parse"` \| `"normalize"` \| `"compile"` \| `"finalize"` \| `"stringify"`
+
+Run the pipeline up to this stage only.
+
+#### Returns
+
+`Promise`\<`Root`\>
+
+***
+
+### toAST()
+
+> **toAST**(`options?`): `Promise`\<`Root`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:350](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L350)
+
+Alias for toAst()
+
+#### Parameters
+
+##### options?
+
+###### overrides?
+
+`Record`\<`string`, `any`\>
+
+###### stage?
+
+`"parse"` \| `"normalize"` \| `"compile"` \| `"finalize"` \| `"stringify"`
+
+#### Returns
+
+`Promise`\<`Root`\>
+
+***
+
+### toHtml()
+
+> **toHtml**(): `Promise`\<`string`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:294](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L294)
+
+Finalizes the pipeline and returns the result as an HTML string.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
+### toHTML()
+
+> **toHTML**(): `Promise`\<`string`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:348](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L348)
+
+Alias for toHtml()
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
+### toHtmlVFile()
+
+> **toHtmlVFile**(): `Promise`\<`VFile`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:302](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L302)
+
+Finalizes the pipeline and returns a VFile containing the HTML result.
+
+#### Returns
+
+`Promise`\<`VFile`\>
+
+***
+
+### toMarkdown()
+
+> **toMarkdown**(): `Promise`\<`string`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:279](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L279)
+
+Finalizes the pipeline and returns the result as a Markdown string.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
+### toMarkdownVFile()
+
+> **toMarkdownVFile**(): `Promise`\<`VFile`\>
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:287](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L287)
+
+Finalizes the pipeline and returns a VFile containing the Markdown result.
+
+#### Returns
+
+`Promise`\<`VFile`\>
+
+***
+
+### toRuntimeEntry()
+
+> `protected` **toRuntimeEntry**(`entry`, `defaultStage`, `overrides?`): [`MdastPlugin`](../interfaces/MdastPlugin.md) & `object`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:84](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L84)
+
+Normalizes a plugin entry for runtime execution.
+
+#### Parameters
+
+##### entry
+
+[`MdastPlugin`](../interfaces/MdastPlugin.md)
+
+##### defaultStage
+
+[`PipelineStage`](../enumerations/PipelineStage.md)
+
+##### overrides?
+
+`Record`\<`string`, `any`\>
+
+#### Returns
+
+[`MdastPlugin`](../interfaces/MdastPlugin.md) & `object`
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`toRuntimeEntry`](MdastBasePipeline.md#toruntimeentry)
+
+***
+
+### use()
+
+> **use**(`plugin`, ...`options`): `this`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:215](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L215)
+
+Adds a plugin to the pipeline's compile stage.
+
+#### Parameters
+
+##### plugin
+
+`any`
+
+The unified plugin function.
+
+##### options
+
+...`any`[]
+
+Arguments for the plugin.
+
+#### Returns
+
+`this`
+
+The pipeline instance for chaining.
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`use`](MdastBasePipeline.md#use)
+
+***
+
+### useAt()
+
+> **useAt**(`stage`, `plugin`, ...`options`): `this`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:226](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L226)
+
+Adds a plugin to the pipeline at a specific stage.
+
+#### Parameters
+
+##### stage
+
+The stage name or numeric value.
+
+`"parse"` | `"normalize"` | `"compile"` | `"finalize"` | `"stringify"`
+
+##### plugin
+
+`any`
+
+The unified plugin function.
+
+##### options
+
+...`any`[]
+
+Arguments for the plugin.
+
+#### Returns
+
+`this`
+
+The pipeline instance for chaining.
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`useAt`](MdastBasePipeline.md#useat)
+
+***
+
+### getFormat()
+
+> `static` **getFormat**(`id`): `undefined` \| [`MdastFormat`](../interfaces/MdastFormat.md)
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:42](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L42)
+
+Retrieves a registered format by its ID.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The format identifier.
+
+#### Returns
+
+`undefined` \| [`MdastFormat`](../interfaces/MdastFormat.md)
+
+The format definition or undefined if not found.
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`getFormat`](MdastBasePipeline.md#getformat-2)
+
+***
+
+### register()
+
+> `static` **register**(`format`): `void`
+
+Defined in: [packages/mdast-plus/src/pipeline.ts:33](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L33)
+
+Registers a global document format.
+
+#### Parameters
+
+##### format
+
+[`MdastFormat`](../interfaces/MdastFormat.md)
+
+The format definition to register.
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`MdastBasePipeline`](MdastBasePipeline.md).[`register`](MdastBasePipeline.md#register)

package/docs/enumerations/PipelineStage.md

@@ -0,0 +1,62 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / PipelineStage
+
+# Enumeration: PipelineStage
+
+Defined in: [packages/mdast-plus/src/types.ts:10](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/types.ts#L10)
+
+PipelineStage defines the execution order of plugins in the processing pipeline.
+Plugins are sorted and executed in ascending order based on these stage values.
+
+## Enumeration Members
+
+### compile
+
+> **compile**: `200`
+
+Defined in: [packages/mdast-plus/src/types.ts:16](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/types.ts#L16)
+
+Transformation stage for semantic changes and custom high-level logic.
+
+***
+
+### finalize
+
+> **finalize**: `300`
+
+Defined in: [packages/mdast-plus/src/types.ts:18](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/types.ts#L18)
+
+Finalization stage for preparing the AST for output (e.g., Sanitize, bridge to HAST).
+
+***
+
+### normalize
+
+> **normalize**: `100`
+
+Defined in: [packages/mdast-plus/src/types.ts:14](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/types.ts#L14)
+
+Normalization stage for cleaning up and canonicalizing the AST (e.g., GFM, Directives).
+
+***
+
+### parse
+
+> **parse**: `0`
+
+Defined in: [packages/mdast-plus/src/types.ts:12](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/types.ts#L12)
+
+Initial stage for parsing raw input (e.g., string to AST).
+
+***
+
+### stringify
+
+> **stringify**: `400`
+
+Defined in: [packages/mdast-plus/src/types.ts:20](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/types.ts#L20)
+
+Final stage for serializing the AST to the target format result.

package/docs/functions/astCompiler.md

@@ -0,0 +1,25 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / astCompiler
+
+# Function: astCompiler()
+
+> **astCompiler**(`this`): `void`
+
+Defined in: [packages/mdast-plus/src/formats/ast.ts:16](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/formats/ast.ts#L16)
+
+Pass-through compiler that returns the AST as-is.
+Essential for unified processes that should output an object (the AST) 
+instead of a serialized string.
+
+## Parameters
+
+### this
+
+`any`
+
+## Returns
+
+`void`

package/docs/functions/jsonParser.md

@@ -0,0 +1,24 @@
+[**@isdk/mdast-plus**](../README.md)
+
+***
+
+[@isdk/mdast-plus](../globals.md) / jsonParser
+
+# Function: jsonParser()
+
+> **jsonParser**(`this`): `void`
+
+Defined in: [packages/mdast-plus/src/formats/ast.ts:24](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/formats/ast.ts#L24)
+
+Parser for stringified JSON AST input.
+Allows the pipeline to accept a JSON string and treat it as a unist tree.
+
+## Parameters
+
+### this
+
+`any`
+
+## Returns
+
+`void`

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:362](https://github.com/isdk/mdast-plus.js/blob/bacb4922529058fef775e3f4b4e71c98ac1cab17/src/pipeline.ts#L362)
 
 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,37 @@
 
 # @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)
 
 ## 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)
 - [markdownFormat](variables/markdownFormat.md)
 
 ## Functions
 
-- [htmlStringify](functions/htmlStringify.md)
-- [markdownCommon](functions/markdownCommon.md)
+- [astCompiler](functions/astCompiler.md)
+- [jsonParser](functions/jsonParser.md)
 - [mdast](functions/mdast.md)