remark-mdat 1.1.2 → 1.2.0

package/dist/index.js

@@ -1820,6 +1820,211 @@ function color(d) {
 
 //#endregion
 //#region node_modules/.pnpm/unist-util-visit-parents@6.0.2/node_modules/unist-util-visit-parents/lib/index.js
+/**
+* @import {Node as UnistNode, Parent as UnistParent} from 'unist'
+*/
+/**
+* @typedef {Exclude<import('unist-util-is').Test, undefined> | undefined} Test
+*   Test from `unist-util-is`.
+*
+*   Note: we have remove and add `undefined`, because otherwise when generating
+*   automatic `.d.ts` files, TS tries to flatten paths from a local perspective,
+*   which doesn’t work when publishing on npm.
+*/
+/**
+* @typedef {(
+*   Fn extends (value: any) => value is infer Thing
+*   ? Thing
+*   : Fallback
+* )} Predicate
+*   Get the value of a type guard `Fn`.
+* @template Fn
+*   Value; typically function that is a type guard (such as `(x): x is Y`).
+* @template Fallback
+*   Value to yield if `Fn` is not a type guard.
+*/
+/**
+* @typedef {(
+*   Check extends null | undefined // No test.
+*   ? Value
+*   : Value extends {type: Check} // String (type) test.
+*   ? Value
+*   : Value extends Check // Partial test.
+*   ? Value
+*   : Check extends Function // Function test.
+*   ? Predicate<Check, Value> extends Value
+*     ? Predicate<Check, Value>
+*     : never
+*   : never // Some other test?
+* )} MatchesOne
+*   Check whether a node matches a primitive check in the type system.
+* @template Value
+*   Value; typically unist `Node`.
+* @template Check
+*   Value; typically `unist-util-is`-compatible test, but not arrays.
+*/
+/**
+* @typedef {(
+*   Check extends ReadonlyArray<infer T>
+*   ? MatchesOne<Value, T>
+*   : Check extends Array<infer T>
+*   ? MatchesOne<Value, T>
+*   : MatchesOne<Value, Check>
+* )} Matches
+*   Check whether a node matches a check in the type system.
+* @template Value
+*   Value; typically unist `Node`.
+* @template Check
+*   Value; typically `unist-util-is`-compatible test.
+*/
+/**
+* @typedef {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10} Uint
+*   Number; capped reasonably.
+*/
+/**
+* @typedef {I extends 0 ? 1 : I extends 1 ? 2 : I extends 2 ? 3 : I extends 3 ? 4 : I extends 4 ? 5 : I extends 5 ? 6 : I extends 6 ? 7 : I extends 7 ? 8 : I extends 8 ? 9 : 10} Increment
+*   Increment a number in the type system.
+* @template {Uint} [I=0]
+*   Index.
+*/
+/**
+* @typedef {(
+*   Node extends UnistParent
+*   ? Node extends {children: Array<infer Children>}
+*     ? Child extends Children ? Node : never
+*     : never
+*   : never
+* )} InternalParent
+*   Collect nodes that can be parents of `Child`.
+* @template {UnistNode} Node
+*   All node types in a tree.
+* @template {UnistNode} Child
+*   Node to search for.
+*/
+/**
+* @typedef {InternalParent<InclusiveDescendant<Tree>, Child>} Parent
+*   Collect nodes in `Tree` that can be parents of `Child`.
+* @template {UnistNode} Tree
+*   All node types in a tree.
+* @template {UnistNode} Child
+*   Node to search for.
+*/
+/**
+* @typedef {(
+*   Depth extends Max
+*   ? never
+*   :
+*     | InternalParent<Node, Child>
+*     | InternalAncestor<Node, InternalParent<Node, Child>, Max, Increment<Depth>>
+* )} InternalAncestor
+*   Collect nodes in `Tree` that can be ancestors of `Child`.
+* @template {UnistNode} Node
+*   All node types in a tree.
+* @template {UnistNode} Child
+*   Node to search for.
+* @template {Uint} [Max=10]
+*   Max; searches up to this depth.
+* @template {Uint} [Depth=0]
+*   Current depth.
+*/
+/**
+* @typedef {InternalAncestor<InclusiveDescendant<Tree>, Child>} Ancestor
+*   Collect nodes in `Tree` that can be ancestors of `Child`.
+* @template {UnistNode} Tree
+*   All node types in a tree.
+* @template {UnistNode} Child
+*   Node to search for.
+*/
+/**
+* @typedef {(
+*   Tree extends UnistParent
+*     ? Depth extends Max
+*       ? Tree
+*       : Tree | InclusiveDescendant<Tree['children'][number], Max, Increment<Depth>>
+*     : Tree
+* )} InclusiveDescendant
+*   Collect all (inclusive) descendants of `Tree`.
+*
+*   > 👉 **Note**: for performance reasons, this seems to be the fastest way to
+*   > recurse without actually running into an infinite loop, which the
+*   > previous version did.
+*   >
+*   > Practically, a max of `2` is typically enough assuming a `Root` is
+*   > passed, but it doesn’t improve performance.
+*   > It gets higher with `List > ListItem > Table > TableRow > TableCell`.
+*   > Using up to `10` doesn’t hurt or help either.
+* @template {UnistNode} Tree
+*   Tree type.
+* @template {Uint} [Max=10]
+*   Max; searches up to this depth.
+* @template {Uint} [Depth=0]
+*   Current depth.
+*/
+/**
+* @typedef {'skip' | boolean} Action
+*   Union of the action types.
+*
+* @typedef {number} Index
+*   Move to the sibling at `index` next (after node itself is completely
+*   traversed).
+*
+*   Useful if mutating the tree, such as removing the node the visitor is
+*   currently on, or any of its previous siblings.
+*   Results less than 0 or greater than or equal to `children.length` stop
+*   traversing the parent.
+*
+* @typedef {[(Action | null | undefined | void)?, (Index | null | undefined)?]} ActionTuple
+*   List with one or two values, the first an action, the second an index.
+*
+* @typedef {Action | ActionTuple | Index | null | undefined | void} VisitorResult
+*   Any value that can be returned from a visitor.
+*/
+/**
+* @callback Visitor
+*   Handle a node (matching `test`, if given).
+*
+*   Visitors are free to transform `node`.
+*   They can also transform the parent of node (the last of `ancestors`).
+*
+*   Replacing `node` itself, if `SKIP` is not returned, still causes its
+*   descendants to be walked (which is a bug).
+*
+*   When adding or removing previous siblings of `node` (or next siblings, in
+*   case of reverse), the `Visitor` should return a new `Index` to specify the
+*   sibling to traverse after `node` is traversed.
+*   Adding or removing next siblings of `node` (or previous siblings, in case
+*   of reverse) is handled as expected without needing to return a new `Index`.
+*
+*   Removing the children property of an ancestor still results in them being
+*   traversed.
+* @param {Visited} node
+*   Found node.
+* @param {Array<VisitedParents>} ancestors
+*   Ancestors of `node`.
+* @returns {VisitorResult}
+*   What to do next.
+*
+*   An `Index` is treated as a tuple of `[CONTINUE, Index]`.
+*   An `Action` is treated as a tuple of `[Action]`.
+*
+*   Passing a tuple back only makes sense if the `Action` is `SKIP`.
+*   When the `Action` is `EXIT`, that action can be returned.
+*   When the `Action` is `CONTINUE`, `Index` can be returned.
+* @template {UnistNode} [Visited=UnistNode]
+*   Visited node type.
+* @template {UnistParent} [VisitedParents=UnistParent]
+*   Ancestor type.
+*/
+/**
+* @typedef {Visitor<Matches<InclusiveDescendant<Tree>, Check>, Ancestor<Tree, Matches<InclusiveDescendant<Tree>, Check>>>} BuildVisitor
+*   Build a typed `Visitor` function from a tree and a test.
+*
+*   It will infer which values are passed as `node` and which as `parents`.
+* @template {UnistNode} [Tree=UnistNode]
+*   Tree type.
+* @template {Test} [Check=Test]
+*   Test type.
+*/
 /** @type {Readonly<ActionTuple>} */
 const empty = [];
 /**
@@ -1950,6 +2155,216 @@ function toResult(value) {
 //#endregion
 //#region node_modules/.pnpm/unist-util-visit@5.0.0/node_modules/unist-util-visit/lib/index.js
 /**
+* @typedef {import('unist').Node} UnistNode
+* @typedef {import('unist').Parent} UnistParent
+* @typedef {import('unist-util-visit-parents').VisitorResult} VisitorResult
+*/
+/**
+* @typedef {Exclude<import('unist-util-is').Test, undefined> | undefined} Test
+*   Test from `unist-util-is`.
+*
+*   Note: we have remove and add `undefined`, because otherwise when generating
+*   automatic `.d.ts` files, TS tries to flatten paths from a local perspective,
+*   which doesn’t work when publishing on npm.
+*/
+/**
+* @typedef {(
+*   Fn extends (value: any) => value is infer Thing
+*   ? Thing
+*   : Fallback
+* )} Predicate
+*   Get the value of a type guard `Fn`.
+* @template Fn
+*   Value; typically function that is a type guard (such as `(x): x is Y`).
+* @template Fallback
+*   Value to yield if `Fn` is not a type guard.
+*/
+/**
+* @typedef {(
+*   Check extends null | undefined // No test.
+*   ? Value
+*   : Value extends {type: Check} // String (type) test.
+*   ? Value
+*   : Value extends Check // Partial test.
+*   ? Value
+*   : Check extends Function // Function test.
+*   ? Predicate<Check, Value> extends Value
+*     ? Predicate<Check, Value>
+*     : never
+*   : never // Some other test?
+* )} MatchesOne
+*   Check whether a node matches a primitive check in the type system.
+* @template Value
+*   Value; typically unist `Node`.
+* @template Check
+*   Value; typically `unist-util-is`-compatible test, but not arrays.
+*/
+/**
+* @typedef {(
+*   Check extends Array<any>
+*   ? MatchesOne<Value, Check[keyof Check]>
+*   : MatchesOne<Value, Check>
+* )} Matches
+*   Check whether a node matches a check in the type system.
+* @template Value
+*   Value; typically unist `Node`.
+* @template Check
+*   Value; typically `unist-util-is`-compatible test.
+*/
+/**
+* @typedef {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10} Uint
+*   Number; capped reasonably.
+*/
+/**
+* @typedef {I extends 0 ? 1 : I extends 1 ? 2 : I extends 2 ? 3 : I extends 3 ? 4 : I extends 4 ? 5 : I extends 5 ? 6 : I extends 6 ? 7 : I extends 7 ? 8 : I extends 8 ? 9 : 10} Increment
+*   Increment a number in the type system.
+* @template {Uint} [I=0]
+*   Index.
+*/
+/**
+* @typedef {(
+*   Node extends UnistParent
+*   ? Node extends {children: Array<infer Children>}
+*     ? Child extends Children ? Node : never
+*     : never
+*   : never
+* )} InternalParent
+*   Collect nodes that can be parents of `Child`.
+* @template {UnistNode} Node
+*   All node types in a tree.
+* @template {UnistNode} Child
+*   Node to search for.
+*/
+/**
+* @typedef {InternalParent<InclusiveDescendant<Tree>, Child>} Parent
+*   Collect nodes in `Tree` that can be parents of `Child`.
+* @template {UnistNode} Tree
+*   All node types in a tree.
+* @template {UnistNode} Child
+*   Node to search for.
+*/
+/**
+* @typedef {(
+*   Depth extends Max
+*   ? never
+*   :
+*     | InternalParent<Node, Child>
+*     | InternalAncestor<Node, InternalParent<Node, Child>, Max, Increment<Depth>>
+* )} InternalAncestor
+*   Collect nodes in `Tree` that can be ancestors of `Child`.
+* @template {UnistNode} Node
+*   All node types in a tree.
+* @template {UnistNode} Child
+*   Node to search for.
+* @template {Uint} [Max=10]
+*   Max; searches up to this depth.
+* @template {Uint} [Depth=0]
+*   Current depth.
+*/
+/**
+* @typedef {(
+*   Tree extends UnistParent
+*     ? Depth extends Max
+*       ? Tree
+*       : Tree | InclusiveDescendant<Tree['children'][number], Max, Increment<Depth>>
+*     : Tree
+* )} InclusiveDescendant
+*   Collect all (inclusive) descendants of `Tree`.
+*
+*   > 👉 **Note**: for performance reasons, this seems to be the fastest way to
+*   > recurse without actually running into an infinite loop, which the
+*   > previous version did.
+*   >
+*   > Practically, a max of `2` is typically enough assuming a `Root` is
+*   > passed, but it doesn’t improve performance.
+*   > It gets higher with `List > ListItem > Table > TableRow > TableCell`.
+*   > Using up to `10` doesn’t hurt or help either.
+* @template {UnistNode} Tree
+*   Tree type.
+* @template {Uint} [Max=10]
+*   Max; searches up to this depth.
+* @template {Uint} [Depth=0]
+*   Current depth.
+*/
+/**
+* @callback Visitor
+*   Handle a node (matching `test`, if given).
+*
+*   Visitors are free to transform `node`.
+*   They can also transform `parent`.
+*
+*   Replacing `node` itself, if `SKIP` is not returned, still causes its
+*   descendants to be walked (which is a bug).
+*
+*   When adding or removing previous siblings of `node` (or next siblings, in
+*   case of reverse), the `Visitor` should return a new `Index` to specify the
+*   sibling to traverse after `node` is traversed.
+*   Adding or removing next siblings of `node` (or previous siblings, in case
+*   of reverse) is handled as expected without needing to return a new `Index`.
+*
+*   Removing the children property of `parent` still results in them being
+*   traversed.
+* @param {Visited} node
+*   Found node.
+* @param {Visited extends UnistNode ? number | undefined : never} index
+*   Index of `node` in `parent`.
+* @param {Ancestor extends UnistParent ? Ancestor | undefined : never} parent
+*   Parent of `node`.
+* @returns {VisitorResult}
+*   What to do next.
+*
+*   An `Index` is treated as a tuple of `[CONTINUE, Index]`.
+*   An `Action` is treated as a tuple of `[Action]`.
+*
+*   Passing a tuple back only makes sense if the `Action` is `SKIP`.
+*   When the `Action` is `EXIT`, that action can be returned.
+*   When the `Action` is `CONTINUE`, `Index` can be returned.
+* @template {UnistNode} [Visited=UnistNode]
+*   Visited node type.
+* @template {UnistParent} [Ancestor=UnistParent]
+*   Ancestor type.
+*/
+/**
+* @typedef {Visitor<Visited, Parent<Ancestor, Visited>>} BuildVisitorFromMatch
+*   Build a typed `Visitor` function from a node and all possible parents.
+*
+*   It will infer which values are passed as `node` and which as `parent`.
+* @template {UnistNode} Visited
+*   Node type.
+* @template {UnistParent} Ancestor
+*   Parent type.
+*/
+/**
+* @typedef {(
+*   BuildVisitorFromMatch<
+*     Matches<Descendant, Check>,
+*     Extract<Descendant, UnistParent>
+*   >
+* )} BuildVisitorFromDescendants
+*   Build a typed `Visitor` function from a list of descendants and a test.
+*
+*   It will infer which values are passed as `node` and which as `parent`.
+* @template {UnistNode} Descendant
+*   Node type.
+* @template {Test} Check
+*   Test type.
+*/
+/**
+* @typedef {(
+*   BuildVisitorFromDescendants<
+*     InclusiveDescendant<Tree>,
+*     Check
+*   >
+* )} BuildVisitor
+*   Build a typed `Visitor` function from a tree and a test.
+*
+*   It will infer which values are passed as `node` and which as `parent`.
+* @template {UnistNode} [Tree=UnistNode]
+*   Node type.
+* @template {Test} [Check=Test]
+*   Test type.
+*/
+/**
 * Visit nodes.
 *
 * This algorithm performs *depth-first* *tree traversal* in *preorder*
@@ -3167,6 +3582,25 @@ function index(value) {
 //#endregion
 //#region node_modules/.pnpm/vfile-message@4.0.3/node_modules/vfile-message/lib/index.js
 /**
+* @import {Node, Point, Position} from 'unist'
+*/
+/**
+* @typedef {object & {type: string, position?: Position | undefined}} NodeLike
+*
+* @typedef Options
+*   Configuration.
+* @property {Array<Node> | null | undefined} [ancestors]
+*   Stack of (inclusive) ancestor nodes surrounding the message (optional).
+* @property {Error | null | undefined} [cause]
+*   Original error cause of the message (optional).
+* @property {Point | Position | null | undefined} [place]
+*   Place of message (optional).
+* @property {string | null | undefined} [ruleId]
+*   Category of message (optional, example: `'my-rule'`).
+* @property {string | null | undefined} [source]
+*   Namespace of who sent the message (optional, example: `'my-package'`).
+*/
+/**
 * Message.
 */
 var VFileMessage = class extends Error {
@@ -3736,8 +4170,9 @@ function checkCommentOrder(file, comments) {
 function checkMetaCommentPresence(file, comments, options) {
 	const { addMetaComment } = options;
 	const metaCommentCount = comments.filter((comment) => comment.type === "meta").length;
-	if (addMetaComment && metaCommentCount !== 1) saveLog(file, "error", "check", `Missing meta comment`);
-	if (!addMetaComment && metaCommentCount !== 0) saveLog(file, "error", "check", `Unexpected meta comment`);
+	const shouldHaveMetaComment = typeof addMetaComment === "string" ? true : addMetaComment;
+	if (shouldHaveMetaComment && metaCommentCount !== 1) saveLog(file, "error", "check", `Missing meta comment`);
+	if (!shouldHaveMetaComment && metaCommentCount !== 0) saveLog(file, "error", "check", `Unexpected meta comment`);
 	if (metaCommentCount > 1) saveLog(file, "error", "check", `Multiple meta comments`);
 }
 function commentOrderList(comments) {
@@ -6099,6 +6534,14 @@ function push(list$3, items) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-util-combine-extensions@2.0.1/node_modules/micromark-util-combine-extensions/index.js
+/**
+* @import {
+*   Extension,
+*   Handles,
+*   HtmlExtension,
+*   NormalizedExtension
+* } from 'micromark-util-types'
+*/
 const hasOwnProperty = {}.hasOwnProperty;
 /**
 * Combine multiple syntax extensions into one.
@@ -6440,6 +6883,9 @@ function regexCheck(regex) {
 //#endregion
 //#region node_modules/.pnpm/micromark-factory-space@2.0.1/node_modules/micromark-factory-space/index.js
 /**
+* @import {Effects, State, TokenType} from 'micromark-util-types'
+*/
+/**
 * Parse spaces and tabs.
 *
 * There is no `nok` parameter:
@@ -6496,6 +6942,15 @@ function factorySpace(effects, ok$2, type, max) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/initialize/content.js
+/**
+* @import {
+*   InitialConstruct,
+*   Initializer,
+*   State,
+*   TokenizeContext,
+*   Token
+* } from 'micromark-util-types'
+*/
 /** @type {InitialConstruct} */
 const content = { tokenize: initializeContent };
 /**
@@ -6555,6 +7010,23 @@ function initializeContent(effects) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/initialize/document.js
+/**
+* @import {
+*   Construct,
+*   ContainerState,
+*   InitialConstruct,
+*   Initializer,
+*   Point,
+*   State,
+*   TokenizeContext,
+*   Tokenizer,
+*   Token
+* } from 'micromark-util-types'
+*/
+/**
+* @typedef {[Construct, ContainerState]} StackItem
+*   Construct and its state.
+*/
 /** @type {InitialConstruct} */
 const document = { tokenize: initializeDocument };
 /** @type {Construct} */
@@ -6756,6 +7228,9 @@ function tokenizeContainer(effects, ok$2, nok) {
 //#endregion
 //#region node_modules/.pnpm/micromark-util-classify-character@2.0.1/node_modules/micromark-util-classify-character/index.js
 /**
+* @import {Code} from 'micromark-util-types'
+*/
+/**
 * Classify whether a code represents whitespace, punctuation, or something
 * else.
 *
@@ -6807,6 +7282,19 @@ function resolveAll(constructs$1, events, context) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/attention.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   Event,
+*   Point,
+*   Resolver,
+*   State,
+*   TokenizeContext,
+*   Tokenizer,
+*   Token
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const attention = {
 	name: "attention",
@@ -7015,6 +7503,14 @@ function movePoint(point$3, offset) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/autolink.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const autolink = {
 	name: "autolink",
@@ -7219,6 +7715,14 @@ function tokenizeAutolink(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/blank-line.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const blankLine = {
 	partial: true,
@@ -7269,6 +7773,15 @@ function tokenizeBlankLine(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/block-quote.js
+/**
+* @import {
+*   Construct,
+*   Exiter,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const blockQuote = {
 	continuation: { tokenize: tokenizeBlockQuoteContinuation },
@@ -7388,6 +7901,14 @@ function exit$1(effects) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/character-escape.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const characterEscape = {
 	name: "characterEscape",
@@ -7441,6 +7962,15 @@ function tokenizeCharacterEscape(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/character-reference.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const characterReference = {
 	name: "characterReference",
@@ -7571,6 +8101,15 @@ function tokenizeCharacterReference(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/code-fenced.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const nonLazyContinuation = {
 	partial: true,
@@ -7978,6 +8517,14 @@ function tokenizeNonLazyContinuation(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/code-indented.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const codeIndented = {
 	name: "codeIndented",
@@ -8115,6 +8662,17 @@ function tokenizeFurtherStart(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/code-text.js
+/**
+* @import {
+*   Construct,
+*   Previous,
+*   Resolver,
+*   State,
+*   TokenizeContext,
+*   Tokenizer,
+*   Token
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const codeText = {
 	name: "codeText",
@@ -8522,6 +9080,9 @@ function chunkedPush(list$3, right) {
 //#endregion
 //#region node_modules/.pnpm/micromark-util-subtokenize@2.1.0/node_modules/micromark-util-subtokenize/index.js
 /**
+* @import {Chunk, Event, Token} from 'micromark-util-types'
+*/
+/**
 * Tokenize subcontent.
 *
 * @param {Array<Event>} eventsArray
@@ -8675,6 +9236,16 @@ function subcontent(events, eventIndex) {
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/content.js
 /**
+* @import {
+*   Construct,
+*   Resolver,
+*   State,
+*   TokenizeContext,
+*   Tokenizer,
+*   Token
+* } from 'micromark-util-types'
+*/
+/**
 * No name because it must not be turned off.
 * @type {Construct}
 */
@@ -8799,6 +9370,9 @@ function tokenizeContinuation(effects, ok$2, nok) {
 //#endregion
 //#region node_modules/.pnpm/micromark-factory-destination@2.0.1/node_modules/micromark-factory-destination/index.js
 /**
+* @import {Effects, State, TokenType} from 'micromark-util-types'
+*/
+/**
 * Parse destinations.
 *
 * ###### Examples
@@ -8981,6 +9555,14 @@ function factoryDestination(effects, ok$2, nok, type, literalType, literalMarker
 //#endregion
 //#region node_modules/.pnpm/micromark-factory-label@2.0.1/node_modules/micromark-factory-label/index.js
 /**
+* @import {
+*   Effects,
+*   State,
+*   TokenizeContext,
+*   TokenType
+* } from 'micromark-util-types'
+*/
+/**
 * Parse labels.
 *
 * > 👉 **Note**: labels in markdown are capped at 999 characters in the string.
@@ -9106,6 +9688,14 @@ function factoryLabel(effects, ok$2, nok, type, markerType, stringType) {
 //#endregion
 //#region node_modules/.pnpm/micromark-factory-title@2.0.1/node_modules/micromark-factory-title/index.js
 /**
+* @import {
+*   Code,
+*   Effects,
+*   State,
+*   TokenType
+* } from 'micromark-util-types'
+*/
+/**
 * Parse titles.
 *
 * ###### Examples
@@ -9244,6 +9834,9 @@ function factoryTitle(effects, ok$2, nok, type, markerType, stringType) {
 //#endregion
 //#region node_modules/.pnpm/micromark-factory-whitespace@2.0.1/node_modules/micromark-factory-whitespace/index.js
 /**
+* @import {Effects, State} from 'micromark-util-types'
+*/
+/**
 * Parse spaces and tabs.
 *
 * There is no `nok` parameter:
@@ -9281,6 +9874,14 @@ function factoryWhitespace(effects, ok$2) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/definition.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const definition$1 = {
 	name: "definition",
@@ -9489,6 +10090,14 @@ function tokenizeTitleBefore(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/hard-break-escape.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const hardBreakEscape = {
 	name: "hardBreakEscape",
@@ -9539,6 +10148,16 @@ function tokenizeHardBreakEscape(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/heading-atx.js
+/**
+* @import {
+*   Construct,
+*   Resolver,
+*   State,
+*   TokenizeContext,
+*   Tokenizer,
+*   Token
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const headingAtx = {
 	name: "headingAtx",
@@ -9815,6 +10434,16 @@ const htmlRawNames = [
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/html-flow.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   Resolver,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const htmlFlow = {
 	concrete: true,
@@ -10579,6 +11208,15 @@ function tokenizeBlankLineBefore(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/html-text.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const htmlText = {
 	name: "htmlText",
@@ -11185,6 +11823,17 @@ function tokenizeHtmlText(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/label-end.js
+/**
+* @import {
+*   Construct,
+*   Event,
+*   Resolver,
+*   State,
+*   TokenizeContext,
+*   Tokenizer,
+*   Token
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const labelEnd = {
 	name: "labelEnd",
@@ -11645,6 +12294,14 @@ function tokenizeReferenceCollapsed(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/label-start-image.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const labelStartImage = {
 	name: "labelStartImage",
@@ -11731,6 +12388,14 @@ function tokenizeLabelStartImage(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/label-start-link.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const labelStartLink = {
 	name: "labelStartLink",
@@ -11772,6 +12437,14 @@ function tokenizeLabelStartLink(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/line-ending.js
+/**
+* @import {
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const lineEnding = {
 	name: "lineEnding",
@@ -11795,6 +12468,15 @@ function tokenizeLineEnding(effects, ok$2) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/thematic-break.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const thematicBreak$1 = {
 	name: "thematicBreak",
@@ -11882,6 +12564,16 @@ function tokenizeThematicBreak(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/list.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   Exiter,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const list$2 = {
 	continuation: { tokenize: tokenizeListContinuation },
@@ -12045,6 +12737,16 @@ function tokenizeListItemPrefixWhitespace(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-core-commonmark@2.0.3/node_modules/micromark-core-commonmark/lib/setext-underline.js
+/**
+* @import {
+*   Code,
+*   Construct,
+*   Resolver,
+*   State,
+*   TokenizeContext,
+*   Tokenizer
+* } from 'micromark-util-types'
+*/
 /** @type {Construct} */
 const setextUnderline = {
 	name: "setextUnderline",
@@ -12188,6 +12890,14 @@ function tokenizeSetextUnderline(effects, ok$2, nok) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/initialize/flow.js
+/**
+* @import {
+*   InitialConstruct,
+*   Initializer,
+*   State,
+*   TokenizeContext
+* } from 'micromark-util-types'
+*/
 /** @type {InitialConstruct} */
 const flow = { tokenize: initializeFlow };
 /**
@@ -12406,6 +13116,9 @@ function resolveAllLineSuffixes(events, context) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/constructs.js
+/**
+* @import {Extension} from 'micromark-util-types'
+*/
 var constructs_exports = /* @__PURE__ */ __export({
 	attentionMarkers: () => attentionMarkers,
 	contentInitial: () => contentInitial,
@@ -12483,6 +13196,43 @@ const disable = { null: [] };
 //#endregion
 //#region node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/create-tokenizer.js
 /**
+* @import {
+*   Chunk,
+*   Code,
+*   ConstructRecord,
+*   Construct,
+*   Effects,
+*   InitialConstruct,
+*   ParseContext,
+*   Point,
+*   State,
+*   TokenizeContext,
+*   Token
+* } from 'micromark-util-types'
+*/
+/**
+* @callback Restore
+*   Restore the state.
+* @returns {undefined}
+*   Nothing.
+*
+* @typedef Info
+*   Info.
+* @property {Restore} restore
+*   Restore.
+* @property {number} from
+*   From.
+*
+* @callback ReturnHandle
+*   Handle a successful run.
+* @param {Construct} construct
+*   Construct.
+* @param {Info} info
+*   Info.
+* @returns {undefined}
+*   Nothing.
+*/
+/**
 * Create a tokenizer.
 * Tokenizers deal with one type of data (e.g., containers, flow, text).
 * The parser is the object dealing with it all.
@@ -12916,6 +13666,15 @@ function serializeChunks(chunks, expandTabs) {
 //#endregion
 //#region node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/parse.js
 /**
+* @import {
+*   Create,
+*   FullNormalizedExtension,
+*   InitialConstruct,
+*   ParseContext,
+*   ParseOptions
+* } from 'micromark-util-types'
+*/
+/**
 * @param {ParseOptions | null | undefined} [options]
 *   Configuration (optional).
 * @returns {ParseContext}
@@ -12952,6 +13711,9 @@ function parse$3(options) {
 //#endregion
 //#region node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/postprocess.js
 /**
+* @import {Event} from 'micromark-util-types'
+*/
+/**
 * @param {Array<Event>} events
 *   Events.
 * @returns {Array<Event>}
@@ -13104,6 +13866,46 @@ function decode($0, $1, $2) {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-from-markdown@2.0.2/node_modules/mdast-util-from-markdown/lib/index.js
+/**
+* @import {
+*   Break,
+*   Blockquote,
+*   Code,
+*   Definition,
+*   Emphasis,
+*   Heading,
+*   Html,
+*   Image,
+*   InlineCode,
+*   Link,
+*   ListItem,
+*   List,
+*   Nodes,
+*   Paragraph,
+*   PhrasingContent,
+*   ReferenceType,
+*   Root,
+*   Strong,
+*   Text,
+*   ThematicBreak
+* } from 'mdast'
+* @import {
+*   Encoding,
+*   Event,
+*   Token,
+*   Value
+* } from 'micromark-util-types'
+* @import {Point} from 'unist'
+* @import {
+*   CompileContext,
+*   CompileData,
+*   Config,
+*   Extension,
+*   Handle,
+*   OnEnterError,
+*   Options
+* } from './types.js'
+*/
 const own$3 = {}.hasOwnProperty;
 /**
 * Turn markdown into a syntax tree.
@@ -14032,6 +14834,15 @@ function defaultOnError(left, right) {
 //#endregion
 //#region node_modules/.pnpm/remark-parse@11.0.0/node_modules/remark-parse/lib/index.js
 /**
+* @typedef {import('mdast').Root} Root
+* @typedef {import('mdast-util-from-markdown').Options} FromMarkdownOptions
+* @typedef {import('unified').Parser<Root>} Parser
+* @typedef {import('unified').Processor<Root>} Processor
+*/
+/**
+* @typedef {Omit<FromMarkdownOptions, 'extensions' | 'mdastExtensions'>} Options
+*/
+/**
 * Aadd support for parsing from markdown.
 *
 * @param {Readonly<Options> | null | undefined} [options]
@@ -14267,6 +15078,10 @@ function listInScope(stack$1, list$3, none) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/break.js
 /**
+* @import {Break, Parents} from 'mdast'
+* @import {Info, State} from 'mdast-util-to-markdown'
+*/
+/**
 * @param {Break} _
 * @param {Parents | undefined} _1
 * @param {State} state
@@ -14341,6 +15156,10 @@ function checkFence(state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/code.js
 /**
+* @import {Info, Map, State} from 'mdast-util-to-markdown'
+* @import {Code, Parents} from 'mdast'
+*/
+/**
 * @param {Code} node
 * @param {Parents | undefined} _
 * @param {State} state
@@ -14411,6 +15230,10 @@ function checkQuote(state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/definition.js
 /**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {Definition, Parents} from 'mdast'
+*/
+/**
 * @param {Definition} node
 * @param {Parents | undefined} _
 * @param {State} state
@@ -14496,6 +15319,9 @@ function encodeCharacterReference(code$2) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/util/encode-info.js
 /**
+* @import {EncodeSides} from '../types.js'
+*/
+/**
 * Check whether to encode (as a character reference) the characters
 * surrounding an attention run.
 *
@@ -14565,6 +15391,10 @@ function encodeInfo(outside, inside, marker) {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/emphasis.js
+/**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {Emphasis, Parents} from 'mdast'
+*/
 emphasis.peek = emphasisPeek;
 /**
 * @param {Emphasis} node
@@ -14610,6 +15440,10 @@ function emphasisPeek(_, _1, state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/util/format-heading-as-setext.js
 /**
+* @import {State} from 'mdast-util-to-markdown'
+* @import {Heading} from 'mdast'
+*/
+/**
 * @param {Heading} node
 * @param {State} state
 * @returns {boolean}
@@ -14628,6 +15462,10 @@ function formatHeadingAsSetext(node$1, state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/heading.js
 /**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {Heading, Parents} from 'mdast'
+*/
+/**
 * @param {Heading} node
 * @param {Parents | undefined} _
 * @param {State} state
@@ -14688,6 +15526,10 @@ function htmlPeek() {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/image.js
+/**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {Image, Parents} from 'mdast'
+*/
 image.peek = imagePeek;
 /**
 * @param {Image} node
@@ -14843,6 +15685,10 @@ function inlineCodePeek() {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/util/format-link-as-autolink.js
 /**
+* @import {State} from 'mdast-util-to-markdown'
+* @import {Link} from 'mdast'
+*/
+/**
 * @param {Link} node
 * @param {State} state
 * @returns {boolean}
@@ -14854,6 +15700,11 @@ function formatLinkAsAutolink(node$1, state) {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/link.js
+/**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {Link, Parents} from 'mdast'
+* @import {Exit} from '../types.js'
+*/
 link.peek = linkPeek;
 /**
 * @param {Link} node
@@ -15006,6 +15857,9 @@ function checkBullet(state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/util/check-bullet-other.js
 /**
+* @import {Options, State} from 'mdast-util-to-markdown'
+*/
+/**
 * @param {State} state
 * @returns {Exclude<Options['bullet'], null | undefined>}
 */
@@ -15051,6 +15905,10 @@ function checkRule(state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/list.js
 /**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {List, Parents} from 'mdast'
+*/
+/**
 * @param {List} node
 * @param {Parents | undefined} parent
 * @param {State} state
@@ -15106,6 +15964,10 @@ function checkListItemIndent(state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/list-item.js
 /**
+* @import {Info, Map, State} from 'mdast-util-to-markdown'
+* @import {ListItem, Parents} from 'mdast'
+*/
+/**
 * @param {ListItem} node
 * @param {Parents | undefined} parent
 * @param {State} state
@@ -15157,6 +16019,10 @@ function paragraph(node$1, _, state, info$1) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-phrasing@4.1.0/node_modules/mdast-util-phrasing/lib/index.js
 /**
+* @typedef {import('mdast').Html} Html
+* @typedef {import('mdast').PhrasingContent} PhrasingContent
+*/
+/**
 * Check if the given value is *phrasing content*.
 *
 * > 👉 **Note**: Excludes `html`, which can be both phrasing or flow.
@@ -15188,6 +16054,10 @@ const phrasing = convert([
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/root.js
 /**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {Parents, Root} from 'mdast'
+*/
+/**
 * @param {Root} node
 * @param {Parents | undefined} _
 * @param {State} state
@@ -15217,6 +16087,10 @@ function checkStrong(state) {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/strong.js
+/**
+* @import {Info, State} from 'mdast-util-to-markdown'
+* @import {Parents, Strong} from 'mdast'
+*/
 strong.peek = strongPeek;
 /**
 * @param {Strong} node
@@ -15294,6 +16168,10 @@ function checkRuleRepetition(state) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/handle/thematic-break.js
 /**
+* @import {State} from 'mdast-util-to-markdown'
+* @import {Parents, ThematicBreak} from 'mdast'
+*/
+/**
 * @param {ThematicBreak} _
 * @param {Parents | undefined} _1
 * @param {State} state
@@ -15334,6 +16212,9 @@ const handle = {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/join.js
+/**
+* @import {Join} from 'mdast-util-to-markdown'
+*/
 /** @type {Array<Join>} */
 const join = [joinDefaults];
 /** @type {Join} */
@@ -15571,6 +16452,9 @@ const unsafe = [
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/util/association.js
 /**
+* @import {AssociationId} from '../types.js'
+*/
+/**
 * Get an identifier from an association to match it to others.
 *
 * Associations are nodes that match to something else through an ID:
@@ -15614,6 +16498,10 @@ function compilePattern(pattern) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/util/container-phrasing.js
 /**
+* @import {Handle, Info, State} from 'mdast-util-to-markdown'
+* @import {PhrasingParents} from '../types.js'
+*/
+/**
 * Serialize the children of a parent that contains phrasing children.
 *
 * These children will be joined flush together.
@@ -15772,6 +16660,9 @@ function indentLines(value, map$4) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/util/safe.js
 /**
+* @import {SafeConfig, State} from 'mdast-util-to-markdown'
+*/
+/**
 * Make a string safe for embedding in markdown constructs.
 *
 * In markdown, almost all punctuation characters can, in certain cases,
@@ -15942,6 +16833,11 @@ function track(config) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-to-markdown@2.1.2/node_modules/mdast-util-to-markdown/lib/index.js
 /**
+* @import {Info, Join, Options, SafeConfig, State} from 'mdast-util-to-markdown'
+* @import {Nodes} from 'mdast'
+* @import {Enter, FlowParents, PhrasingParents, TrackFields} from './types.js'
+*/
+/**
 * Turn an mdast syntax tree into markdown.
 *
 * @param {Nodes} tree
@@ -16087,6 +16983,15 @@ function safeBound(value, config) {
 //#endregion
 //#region node_modules/.pnpm/remark-stringify@11.0.0/node_modules/remark-stringify/lib/index.js
 /**
+* @typedef {import('mdast').Root} Root
+* @typedef {import('mdast-util-to-markdown').Options} ToMarkdownOptions
+* @typedef {import('unified').Compiler<Root, string>} Compiler
+* @typedef {import('unified').Processor<undefined, undefined, undefined, Root, string>} Processor
+*/
+/**
+* @typedef {Omit<ToMarkdownOptions, 'extensions'>} Options
+*/
+/**
 * Add support for serializing to markdown.
 *
 * @param {Readonly<Options> | null | undefined} [options]
@@ -16156,6 +17061,61 @@ function escapeStringRegexp(string$2) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-find-and-replace@3.0.2/node_modules/mdast-util-find-and-replace/lib/index.js
 /**
+* @import {Nodes, Parents, PhrasingContent, Root, Text} from 'mdast'
+* @import {BuildVisitor, Test, VisitorResult} from 'unist-util-visit-parents'
+*/
+/**
+* @typedef RegExpMatchObject
+*   Info on the match.
+* @property {number} index
+*   The index of the search at which the result was found.
+* @property {string} input
+*   A copy of the search string in the text node.
+* @property {[...Array<Parents>, Text]} stack
+*   All ancestors of the text node, where the last node is the text itself.
+*
+* @typedef {RegExp | string} Find
+*   Pattern to find.
+*
+*   Strings are escaped and then turned into global expressions.
+*
+* @typedef {Array<FindAndReplaceTuple>} FindAndReplaceList
+*   Several find and replaces, in array form.
+*
+* @typedef {[Find, Replace?]} FindAndReplaceTuple
+*   Find and replace in tuple form.
+*
+* @typedef {ReplaceFunction | string | null | undefined} Replace
+*   Thing to replace with.
+*
+* @callback ReplaceFunction
+*   Callback called when a search matches.
+* @param {...any} parameters
+*   The parameters are the result of corresponding search expression:
+*
+*   * `value` (`string`) — whole match
+*   * `...capture` (`Array<string>`) — matches from regex capture groups
+*   * `match` (`RegExpMatchObject`) — info on the match
+* @returns {Array<PhrasingContent> | PhrasingContent | string | false | null | undefined}
+*   Thing to replace with.
+*
+*   * when `null`, `undefined`, `''`, remove the match
+*   * …or when `false`, do not replace at all
+*   * …or when `string`, replace with a text node of that value
+*   * …or when `Node` or `Array<Node>`, replace with those nodes
+*
+* @typedef {[RegExp, ReplaceFunction]} Pair
+*   Normalized find and replace.
+*
+* @typedef {Array<Pair>} Pairs
+*   All find and replaced.
+*
+* @typedef Options
+*   Configuration.
+* @property {Test | null | undefined} [ignore]
+*   Test for which nodes to ignore (optional).
+*/
+/**
 * Find patterns in a tree and replace them.
 *
 * The algorithm searches the tree in *preorder* for complete values in `Text`
@@ -16296,6 +17256,12 @@ function toFunction(replace$1) {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-gfm-autolink-literal@2.0.1/node_modules/mdast-util-gfm-autolink-literal/lib/index.js
+/**
+* @import {RegExpMatchObject, ReplaceFunction} from 'mdast-util-find-and-replace'
+* @import {CompileContext, Extension as FromMarkdownExtension, Handle as FromMarkdownHandle, Transform as FromMarkdownTransform} from 'mdast-util-from-markdown'
+* @import {ConstructName, Options as ToMarkdownExtension} from 'mdast-util-to-markdown'
+* @import {Link, PhrasingContent} from 'mdast'
+*/
 /** @type {ConstructName} */
 const inConstruct = "phrasing";
 /** @type {Array<ConstructName>} */
@@ -16512,6 +17478,20 @@ function previous(match, email) {
 
 //#endregion
 //#region node_modules/.pnpm/mdast-util-gfm-footnote@2.1.0/node_modules/mdast-util-gfm-footnote/lib/index.js
+/**
+* @import {
+*   CompileContext,
+*   Extension as FromMarkdownExtension,
+*   Handle as FromMarkdownHandle
+* } from 'mdast-util-from-markdown'
+* @import {ToMarkdownOptions} from 'mdast-util-gfm-footnote'
+* @import {
+*   Handle as ToMarkdownHandle,
+*   Map,
+*   Options as ToMarkdownExtension
+* } from 'mdast-util-to-markdown'
+* @import {FootnoteDefinition, FootnoteReference} from 'mdast'
+*/
 footnoteReference.peek = footnoteReferencePeek;
 /**
 * @this {CompileContext}
@@ -17083,6 +18063,35 @@ function toAlignment(value) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-gfm-table@2.0.0/node_modules/mdast-util-gfm-table/lib/index.js
 /**
+* @typedef {import('mdast').InlineCode} InlineCode
+* @typedef {import('mdast').Table} Table
+* @typedef {import('mdast').TableCell} TableCell
+* @typedef {import('mdast').TableRow} TableRow
+*
+* @typedef {import('markdown-table').Options} MarkdownTableOptions
+*
+* @typedef {import('mdast-util-from-markdown').CompileContext} CompileContext
+* @typedef {import('mdast-util-from-markdown').Extension} FromMarkdownExtension
+* @typedef {import('mdast-util-from-markdown').Handle} FromMarkdownHandle
+*
+* @typedef {import('mdast-util-to-markdown').Options} ToMarkdownExtension
+* @typedef {import('mdast-util-to-markdown').Handle} ToMarkdownHandle
+* @typedef {import('mdast-util-to-markdown').State} State
+* @typedef {import('mdast-util-to-markdown').Info} Info
+*/
+/**
+* @typedef Options
+*   Configuration.
+* @property {boolean | null | undefined} [tableCellPadding=true]
+*   Whether to add a space of padding between delimiters and cells (default:
+*   `true`).
+* @property {boolean | null | undefined} [tablePipeAlign=true]
+*   Whether to align the delimiters (default: `true`).
+* @property {MarkdownTableOptions['stringLength'] | null | undefined} [stringLength]
+*   Function to detect the length of table cell content, used when aligning
+*   the delimiters between cells (optional).
+*/
+/**
 * Create an extension for `mdast-util-from-markdown` to enable GFM tables in
 * markdown.
 *
@@ -17320,6 +18329,15 @@ function gfmTableToMarkdown(options) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-gfm-task-list-item@2.0.0/node_modules/mdast-util-gfm-task-list-item/lib/index.js
 /**
+* @typedef {import('mdast').ListItem} ListItem
+* @typedef {import('mdast').Paragraph} Paragraph
+* @typedef {import('mdast-util-from-markdown').CompileContext} CompileContext
+* @typedef {import('mdast-util-from-markdown').Extension} FromMarkdownExtension
+* @typedef {import('mdast-util-from-markdown').Handle} FromMarkdownHandle
+* @typedef {import('mdast-util-to-markdown').Options} ToMarkdownExtension
+* @typedef {import('mdast-util-to-markdown').Handle} ToMarkdownHandle
+*/
+/**
 * Create an extension for `mdast-util-from-markdown` to enable GFM task
 * list items in markdown.
 *
@@ -17422,6 +18440,11 @@ function listItemWithTaskListItem(node$1, parent, state, info$1) {
 //#endregion
 //#region node_modules/.pnpm/mdast-util-gfm@3.1.0/node_modules/mdast-util-gfm/lib/index.js
 /**
+* @import {Extension as FromMarkdownExtension} from 'mdast-util-from-markdown'
+* @import {Options} from 'mdast-util-gfm'
+* @import {Options as ToMarkdownExtension} from 'mdast-util-to-markdown'
+*/
+/**
 * Create an extension for `mdast-util-from-markdown` to enable GFM (autolink
 * literals, footnotes, strikethrough, tables, tasklists).
 *
@@ -17460,6 +18483,9 @@ function gfmToMarkdown(options) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-extension-gfm-autolink-literal@2.1.0/node_modules/micromark-extension-gfm-autolink-literal/lib/syntax.js
+/**
+* @import {Code, ConstructRecord, Event, Extension, Previous, State, TokenizeContext, Tokenizer} from 'micromark-util-types'
+*/
 const wwwPrefix = {
 	tokenize: tokenizeWwwPrefix,
 	partial: true
@@ -18159,6 +19185,9 @@ function previousUnbalanced(events) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-extension-gfm-footnote@2.1.0/node_modules/micromark-extension-gfm-footnote/lib/syntax.js
+/**
+* @import {Event, Exiter, Extension, Resolver, State, Token, TokenizeContext, Tokenizer} from 'micromark-util-types'
+*/
 const indent = {
 	tokenize: tokenizeIndent,
 	partial: true
@@ -18577,6 +19606,10 @@ function tokenizeIndent(effects, ok$2, nok) {
 //#endregion
 //#region node_modules/.pnpm/micromark-extension-gfm-strikethrough@2.1.0/node_modules/micromark-extension-gfm-strikethrough/lib/syntax.js
 /**
+* @import {Options} from 'micromark-extension-gfm-strikethrough'
+* @import {Event, Extension, Resolver, State, Token, TokenizeContext, Tokenizer} from 'micromark-util-types'
+*/
+/**
 * Create an extension for `micromark` to enable GFM strikethrough syntax.
 *
 * @param {Options | null | undefined} [options={}]
@@ -18847,6 +19880,16 @@ function gfmTableAlign(events, index$1) {
 //#endregion
 //#region node_modules/.pnpm/micromark-extension-gfm-table@2.1.1/node_modules/micromark-extension-gfm-table/lib/syntax.js
 /**
+* @import {Event, Extension, Point, Resolver, State, Token, TokenizeContext, Tokenizer} from 'micromark-util-types'
+*/
+/**
+* @typedef {[number, number, number, number]} Range
+*   Cell info.
+*
+* @typedef {0 | 1 | 2 | 3} RowKind
+*   Where we are: `1` for head row, `2` for delimiter row, `3` for body row.
+*/
+/**
 * Create an HTML extension for `micromark` to support GitHub tables syntax.
 *
 * @returns {Extension}
@@ -19531,6 +20574,9 @@ function getPoint(events, index$1) {
 
 //#endregion
 //#region node_modules/.pnpm/micromark-extension-gfm-task-list-item@2.1.0/node_modules/micromark-extension-gfm-task-list-item/lib/syntax.js
+/**
+* @import {Extension, State, TokenizeContext, Tokenizer} from 'micromark-util-types'
+*/
 const tasklistCheck = {
 	name: "tasklistCheck",
 	tokenize: tokenizeTasklistCheck
@@ -19649,6 +20695,12 @@ function spaceThenNonSpace(effects, ok$2, nok) {
 //#endregion
 //#region node_modules/.pnpm/micromark-extension-gfm@3.0.0/node_modules/micromark-extension-gfm/index.js
 /**
+* @typedef {import('micromark-extension-gfm-footnote').HtmlOptions} HtmlOptions
+* @typedef {import('micromark-extension-gfm-strikethrough').Options} Options
+* @typedef {import('micromark-util-types').Extension} Extension
+* @typedef {import('micromark-util-types').HtmlExtension} HtmlExtension
+*/
+/**
 * Create an extension for `micromark` to enable GFM syntax.
 *
 * @param {Options | null | undefined} [options]
@@ -19671,6 +20723,13 @@ function gfm(options) {
 
 //#endregion
 //#region node_modules/.pnpm/remark-gfm@4.0.1/node_modules/remark-gfm/lib/index.js
+/**
+* @import {Root} from 'mdast'
+* @import {Options} from 'remark-gfm'
+* @import {} from 'remark-parse'
+* @import {} from 'remark-stringify'
+* @import {Processor} from 'unified'
+*/
 /** @type {Options} */
 const emptyOptions$1 = {};
 /**
@@ -19734,7 +20793,7 @@ async function mdatExpand(tree, file, options) {
 	if (addMetaComment) {
 		const metaComment = {
 			type: "html",
-			value: `<!--${metaCommentIdentifier} Warning: Content inside HTML comment blocks was generated by mdat and may be overwritten. ${metaCommentIdentifier}-->`
+			value: `<!--${metaCommentIdentifier} ${typeof addMetaComment === "string" ? addMetaComment : "Warning: Content inside HTML comment blocks was generated by mdat and may be overwritten."} ${metaCommentIdentifier}-->`
 		};
 		tree.children.unshift(metaComment);
 	}
@@ -19770,6 +20829,9 @@ Schema.prototype.space = void 0;
 //#endregion
 //#region node_modules/.pnpm/property-information@7.1.0/node_modules/property-information/lib/util/merge.js
 /**
+* @import {Info, Space} from 'property-information'
+*/
+/**
 * @param {ReadonlyArray<Schema>} definitions
 *   Definitions.
 * @param {Space | undefined} [space]
@@ -19862,6 +20924,9 @@ function increment() {
 
 //#endregion
 //#region node_modules/.pnpm/property-information@7.1.0/node_modules/property-information/lib/util/defined-info.js
+/**
+* @import {Space} from 'property-information'
+*/
 const checks = Object.keys(types_exports);
 var DefinedInfo = class extends Info {
 	/**
@@ -19907,6 +20972,33 @@ function mark(values, key$1, value) {
 //#endregion
 //#region node_modules/.pnpm/property-information@7.1.0/node_modules/property-information/lib/util/create.js
 /**
+* @import {Info, Space} from 'property-information'
+*/
+/**
+* @typedef Definition
+*   Definition of a schema.
+* @property {Record<string, string> | undefined} [attributes]
+*   Normalzed names to special attribute case.
+* @property {ReadonlyArray<string> | undefined} [mustUseProperty]
+*   Normalized names that must be set as properties.
+* @property {Record<string, number | null>} properties
+*   Property names to their types.
+* @property {Space | undefined} [space]
+*   Space.
+* @property {Transform} transform
+*   Transform a property name.
+*/
+/**
+* @callback Transform
+*   Transform.
+* @param {Record<string, string>} attributes
+*   Attributes.
+* @param {string} property
+*   Property.
+* @returns {string}
+*   Attribute.
+*/
+/**
 * @param {Definition} definition
 *   Definition.
 * @returns {Schema}
@@ -20932,6 +22024,9 @@ const xml = create({
 
 //#endregion
 //#region node_modules/.pnpm/property-information@7.1.0/node_modules/property-information/lib/find.js
+/**
+* @import {Schema} from 'property-information'
+*/
 const cap = /[A-Z]/g;
 const dash = /-[a-z]/g;
 const valid = /^data[-\w.:]+$/i;
@@ -21159,6 +22254,54 @@ function parse$2(value) {
 //#endregion
 //#region node_modules/.pnpm/hastscript@9.0.1/node_modules/hastscript/lib/create-h.js
 /**
+* @import {Element, Nodes, RootContent, Root} from 'hast'
+* @import {Info, Schema} from 'property-information'
+*/
+/**
+* @typedef {Array<Nodes | PrimitiveChild>} ArrayChildNested
+*   List of children (deep).
+*/
+/**
+* @typedef {Array<ArrayChildNested | Nodes | PrimitiveChild>} ArrayChild
+*   List of children.
+*/
+/**
+* @typedef {Array<number | string>} ArrayValue
+*   List of property values for space- or comma separated values (such as `className`).
+*/
+/**
+* @typedef {ArrayChild | Nodes | PrimitiveChild} Child
+*   Acceptable child value.
+*/
+/**
+* @typedef {number | string | null | undefined} PrimitiveChild
+*   Primitive children, either ignored (nullish), or turned into text nodes.
+*/
+/**
+* @typedef {boolean | number | string | null | undefined} PrimitiveValue
+*   Primitive property value.
+*/
+/**
+* @typedef {Record<string, PropertyValue | Style>} Properties
+*   Acceptable value for element properties.
+*/
+/**
+* @typedef {ArrayValue | PrimitiveValue} PropertyValue
+*   Primitive value or list value.
+*/
+/**
+* @typedef {Element | Root} Result
+*   Result from a `h` (or `s`) call.
+*/
+/**
+* @typedef {number | string} StyleValue
+*   Value for a CSS style field.
+*/
+/**
+* @typedef {Record<string, StyleValue>} Style
+*   Supported value of a `style` prop.
+*/
+/**
 * @param {Schema} schema
 *   Schema to use.
 * @param {string} defaultTagName
@@ -21404,6 +22547,18 @@ const svgCaseSensitiveTagNames = [
 
 //#endregion
 //#region node_modules/.pnpm/hastscript@9.0.1/node_modules/hastscript/lib/index.js
+/**
+* @typedef {import('./jsx-classic.js').Element} h.JSX.Element
+* @typedef {import('./jsx-classic.js').ElementChildrenAttribute} h.JSX.ElementChildrenAttribute
+* @typedef {import('./jsx-classic.js').IntrinsicAttributes} h.JSX.IntrinsicAttributes
+* @typedef {import('./jsx-classic.js').IntrinsicElements} h.JSX.IntrinsicElements
+*/
+/**
+* @typedef {import('./jsx-classic.js').Element} s.JSX.Element
+* @typedef {import('./jsx-classic.js').ElementChildrenAttribute} s.JSX.ElementChildrenAttribute
+* @typedef {import('./jsx-classic.js').IntrinsicAttributes} s.JSX.IntrinsicAttributes
+* @typedef {import('./jsx-classic.js').IntrinsicElements} s.JSX.IntrinsicElements
+*/
 /** @type {ReturnType<createH>} */
 const h = createH(html, "div");
 /** @type {ReturnType<createH>} */
@@ -21506,6 +22661,26 @@ const webNamespaces = {
 
 //#endregion
 //#region node_modules/.pnpm/hast-util-from-parse5@8.0.3/node_modules/hast-util-from-parse5/lib/index.js
+/**
+* @import {ElementData, Element, Nodes, RootContent, Root} from 'hast'
+* @import {DefaultTreeAdapterMap, Token} from 'parse5'
+* @import {Schema} from 'property-information'
+* @import {Point, Position} from 'unist'
+* @import {VFile} from 'vfile'
+* @import {Options} from 'hast-util-from-parse5'
+*/
+/**
+* @typedef State
+*   Info passed around about the current state.
+* @property {VFile | undefined} file
+*   Corresponding file.
+* @property {boolean} location
+*   Whether location info was found.
+* @property {Schema} schema
+*   Current schema.
+* @property {boolean | undefined} verbose
+*   Add extra positional info.
+*/
 const own = {}.hasOwnProperty;
 /** @type {unknown} */
 const proto = Object.prototype;
@@ -28825,6 +30000,12 @@ const errors = {
 
 //#endregion
 //#region node_modules/.pnpm/hast-util-from-html@2.0.3/node_modules/hast-util-from-html/lib/index.js
+/**
+* @import {Root} from 'hast'
+* @import {ParserError} from 'parse5'
+* @import {Value} from 'vfile'
+* @import {ErrorCode, Options} from './types.js'
+*/
 const base = "https://html.spec.whatwg.org/multipage/parsing.html#parse-error-";
 const dashToCamelRe = /-[a-z]/g;
 const formatCRe = /%c(?:([-+])(\d+))?/g;
@@ -29384,7 +30565,7 @@ const defaultOptions = {
 	rules: { mdat: `Powered by the Markdown Autophagic Template system: [mdat](https://github.com/kitschpatrol/mdat).` }
 };
 const optionsSchema = z.object({
-	addMetaComment: z.boolean().optional(),
+	addMetaComment: z.union([z.boolean(), z.string()]).optional(),
 	closingPrefix: z.string().optional(),
 	keywordPrefix: z.string().optional(),
 	metaCommentIdentifier: z.string().optional(),