([])
/**
* Strip wrapper tags from the top level of the document. Shorthand for
* `options.unwrap`. `true` unwraps ``; a space-separated string or array
* unwraps the listed tags.
*/
readonly unwrap = input()
/** Custom component mappings for element tags */
readonly components = input>>({})
/** Enable streaming mode */
readonly streaming = input(false)
/** If document has a comment, only render content before it */
readonly summary = input(false)
/** Append a caret to the last text node (for streaming UIs) */
readonly caret = input(false)
/** Additional data to pass to the renderer for :binding resolution */
readonly data = input>({})
/** Change the tag or props of element nodes just before they render */
readonly transformNode = input()
/** Config-level and instance-level components merged, instance wins. */
protected readonly mergedComponents = computed(() => ({ ...(this.config?.components ?? {}), ...this.components() }))
/** Config-level transforms run before the instance's own transforms. */
protected readonly mergedTransforms = computed(() =>
mergeNodeTransforms(this.config?.transformNode, this.transformNode())
)
document: MarkdownDocumentType | null = null
private cdr = inject(ChangeDetectorRef)
/**
* Compose the parse options consumed by the serialized parser.
*
* Config defaults are merged under the instance inputs so instance values
* win without mutating the input signals. Instance plugins replace config
* plugins with the same name. An omitted `unwrap` inherits the config
* default, while an explicit `false` overrides it.
*/
protected getParserOptions(): ParserOptions {
const plugins = new Map[number]>()
for (const plugin of this.config?.plugins ?? []) {
plugins.set(plugin.name, plugin)
}
for (const plugin of this.plugins() ?? []) {
plugins.delete(plugin.name)
plugins.set(plugin.name, plugin)
}
const unwrap = this.unwrap()
return {
...(this.config?.options ?? {}),
...this.options(),
...(unwrap === undefined ? {} : { unwrap }),
plugins: [...plugins.values()],
}
}
/**
* Serialized parser derived from the parser options. Recomputed whenever
* `options`, `plugins`, `unwrap` (or any signal read by a subclass's
* `getParserOptions()` override) changes.
*/
private readonly serializedParse = computed(() => createSerializedMarkdownParser(this.getParserOptions()))
/** Incremented on each parse so stale async results can be discarded. */
private parseId = 0
private readonly parseMarkdownEffect = effect(() => {
const value = this.value()
const id = ++this.parseId
if (value === undefined || value === null) {
this.document = null
return
}
if (isMarkdownDocument(value)) {
this.document = value
this.cdr.markForCheck()
return
}
let source = value
if (this.summary()) {
source = source.split('')[0] || ''
}
source = source.trim()
const parse = this.serializedParse()
parse(source, { streaming: this.streaming() }).then((result) => {
if (id !== this.parseId) return
this.document = result
this.cdr.markForCheck()
})
})
}