markdown-codec 4.0.15 → 4.1.0

package/dist/emit/table.js

@@ -53,7 +53,7 @@ function renderCellText(cell, context) {
 			});
 			continue;
 		}
-		const text = emitRunsSingleLine(block.runs, context);
+		const text = emitRunsSingleLine(block.runs, context, block.constructs);
 		if (text.length > 0) parts.push(text);
 	}
 	return escapeUnescapedPipes(parts.join(" "));

package/dist/index.cjs

@@ -14,6 +14,7 @@ exports.MONOSPACE_FONT_FAMILY = require_shared_style_constants.MONOSPACE_FONT_FA
 exports.MarkdownBytesSchema = require_codec.MarkdownBytesSchema;
 exports.MarkdownDiagnosticCodes = require_diagnostics_diagnostics.MarkdownDiagnosticCodes;
 exports.MarkdownInputTooLargeError = require_diagnostics_diagnostics.MarkdownInputTooLargeError;
+exports.MarkdownInvalidRunConstructExtentError = require_diagnostics_diagnostics.MarkdownInvalidRunConstructExtentError;
 exports.MarkdownInvalidUtf8Error = require_diagnostics_diagnostics.MarkdownInvalidUtf8Error;
 exports.MarkdownNestingLimitExceededError = require_diagnostics_diagnostics.MarkdownNestingLimitExceededError;
 exports.MarkdownParseError = require_diagnostics_diagnostics.MarkdownParseError;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as MarkdownInputTooLargeError, d as MarkdownUnsupportedDocumentKindError, f as MarkdownWriteError, i as MarkdownDiagnosticSink, l as MarkdownParseError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, p as NOOP_MARKDOWN_DIAGNOSTIC_SINK, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnbalancedConstructMarkersError } from "./diagnostics-BWK1iGy7.cjs";
+import { a as MarkdownInputTooLargeError, c as MarkdownNestingLimitExceededError, d as MarkdownUnbalancedConstructMarkersError, f as MarkdownUnsupportedDocumentKindError, i as MarkdownDiagnosticSink, m as NOOP_MARKDOWN_DIAGNOSTIC_SINK, n as MarkdownDiagnosticCodes, o as MarkdownInvalidRunConstructExtentError, p as MarkdownWriteError, r as MarkdownDiagnosticSeverity, s as MarkdownInvalidUtf8Error, t as MarkdownDiagnostic, u as MarkdownParseError } from "./diagnostics-CUMLtGHJ.cjs";
 import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } from "./codec.cjs";
 import { n as MarkdownImageResolver, r as MarkdownResolvedImageBytes, t as MarkdownImageResolveContext } from "./image-C4KYmz_L.cjs";
 import { MarkdownBulletListMarker, MarkdownCodeFenceChar, MarkdownEmphasisMarker, MarkdownHeadingStyle, MarkdownLineEnding, MarkdownOrderedListDelimiter, MarkdownThematicBreakChar, ReadMarkdownOptions, WriteMarkdownOptions, WriteMarkdownStyleOptions } from "./options/options.cjs";
@@ -6,4 +6,4 @@ import { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdo
 import { writeMarkdown, writeMarkdownContent } from "./write.cjs";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.cjs";
 import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.cjs";
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidRunConstructExtentError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as MarkdownInputTooLargeError, d as MarkdownUnsupportedDocumentKindError, f as MarkdownWriteError, i as MarkdownDiagnosticSink, l as MarkdownParseError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, p as NOOP_MARKDOWN_DIAGNOSTIC_SINK, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnbalancedConstructMarkersError } from "./diagnostics-BWK1iGy7.js";
+import { a as MarkdownInputTooLargeError, c as MarkdownNestingLimitExceededError, d as MarkdownUnbalancedConstructMarkersError, f as MarkdownUnsupportedDocumentKindError, i as MarkdownDiagnosticSink, m as NOOP_MARKDOWN_DIAGNOSTIC_SINK, n as MarkdownDiagnosticCodes, o as MarkdownInvalidRunConstructExtentError, p as MarkdownWriteError, r as MarkdownDiagnosticSeverity, s as MarkdownInvalidUtf8Error, t as MarkdownDiagnostic, u as MarkdownParseError } from "./diagnostics-CUMLtGHJ.js";
 import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } from "./codec.js";
 import { n as MarkdownImageResolver, r as MarkdownResolvedImageBytes, t as MarkdownImageResolveContext } from "./image-Cm3hT5PS.js";
 import { MarkdownBulletListMarker, MarkdownCodeFenceChar, MarkdownEmphasisMarker, MarkdownHeadingStyle, MarkdownLineEnding, MarkdownOrderedListDelimiter, MarkdownThematicBreakChar, ReadMarkdownOptions, WriteMarkdownOptions, WriteMarkdownStyleOptions } from "./options/options.js";
@@ -6,4 +6,4 @@ import { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdo
 import { writeMarkdown, writeMarkdownContent } from "./write.js";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.js";
 import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidRunConstructExtentError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/index.js

@@ -1,7 +1,7 @@
-import { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "./diagnostics/diagnostics.js";
+import { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidRunConstructExtentError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "./diagnostics/diagnostics.js";
 import { createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.js";
 import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
 import { readMarkdown, readMarkdownContent } from "./read.js";
 import { writeMarkdown, writeMarkdownContent } from "./write.js";
 import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } from "./codec.js";
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, MarkdownBytesSchema, MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, MarkdownBytesSchema, MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidRunConstructExtentError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/inline/inline.d.cts

@@ -1,2 +1,2 @@
-import { n as parseInlines, t as InlineParseOptions } from "../inline-CXVQWQnW.cjs";
+import { n as parseInlines, t as InlineParseOptions } from "../inline-CoS1JzxI.cjs";
 export { InlineParseOptions, parseInlines };

package/dist/inline/inline.d.ts

@@ -1,2 +1,2 @@
-import { n as parseInlines, t as InlineParseOptions } from "../inline-B_V7bs5j.js";
+import { n as parseInlines, t as InlineParseOptions } from "../inline-OGXVE6hB.js";
 export { InlineParseOptions, parseInlines };

package/dist/inline/link.d.cts

@@ -1,2 +1,18 @@
-import { a as matchLinkLabel, c as parseLinkTitle, i as isBlankRemainderOfLine, l as skipInlineWhitespace, n as LinkReferenceMap, o as normalizeLinkLabel, r as ParsedSpan, s as parseLinkDestination, t as LinkReferenceDefinition } from "../link-Dv4kxVjk.cjs";
+//#region src/inline/link.d.ts
+interface LinkReferenceDefinition {
+  readonly destination: string;
+  readonly title?: string;
+}
+type LinkReferenceMap = ReadonlyMap<string, LinkReferenceDefinition>;
+declare function normalizeLinkLabel(labelWithBrackets: string): string;
+declare function matchLinkLabel(text: string, start: number): number;
+interface ParsedSpan {
+  readonly value: string;
+  readonly end: number;
+}
+declare function parseLinkDestination(text: string, start: number): ParsedSpan | undefined;
+declare function parseLinkTitle(text: string, start: number): ParsedSpan | undefined;
+declare function skipInlineWhitespace(text: string, start: number): number;
+declare function isBlankRemainderOfLine(text: string, start: number): boolean;
+//#endregion
 export { LinkReferenceDefinition, LinkReferenceMap, ParsedSpan, isBlankRemainderOfLine, matchLinkLabel, normalizeLinkLabel, parseLinkDestination, parseLinkTitle, skipInlineWhitespace };

package/dist/inline/link.d.ts

@@ -1,2 +1,18 @@
-import { a as matchLinkLabel, c as parseLinkTitle, i as isBlankRemainderOfLine, l as skipInlineWhitespace, n as LinkReferenceMap, o as normalizeLinkLabel, r as ParsedSpan, s as parseLinkDestination, t as LinkReferenceDefinition } from "../link-Dv4kxVjk.js";
+//#region src/inline/link.d.ts
+interface LinkReferenceDefinition {
+  readonly destination: string;
+  readonly title?: string;
+}
+type LinkReferenceMap = ReadonlyMap<string, LinkReferenceDefinition>;
+declare function normalizeLinkLabel(labelWithBrackets: string): string;
+declare function matchLinkLabel(text: string, start: number): number;
+interface ParsedSpan {
+  readonly value: string;
+  readonly end: number;
+}
+declare function parseLinkDestination(text: string, start: number): ParsedSpan | undefined;
+declare function parseLinkTitle(text: string, start: number): ParsedSpan | undefined;
+declare function skipInlineWhitespace(text: string, start: number): number;
+declare function isBlankRemainderOfLine(text: string, start: number): boolean;
+//#endregion
 export { LinkReferenceDefinition, LinkReferenceMap, ParsedSpan, isBlankRemainderOfLine, matchLinkLabel, normalizeLinkLabel, parseLinkDestination, parseLinkTitle, skipInlineWhitespace };

package/dist/{inline-CXVQWQnW.d.cts → inline-CoS1JzxI.d.cts}

@@ -1,6 +1,6 @@
 import { v as MarkdownInlineNode } from "./ast-8XCbjRQT.cjs";
 import { r as FootnoteLabelSet } from "./footnote-CKk4JbLk.cjs";
-import { n as LinkReferenceMap } from "./link-Dv4kxVjk.cjs";
+import { LinkReferenceMap } from "./inline/link.cjs";
 //#region src/inline/inline.d.ts
 interface InlineParseOptions {
   readonly gfmAutolinks?: boolean;

package/dist/{inline-B_V7bs5j.d.ts → inline-OGXVE6hB.d.ts}

@@ -1,6 +1,6 @@
 import { v as MarkdownInlineNode } from "./ast-8XCbjRQT.js";
 import { r as FootnoteLabelSet } from "./footnote-CKk4JbLk.js";
-import { n as LinkReferenceMap } from "./link-Dv4kxVjk.js";
+import { LinkReferenceMap } from "./inline/link.js";
 //#region src/inline/inline.d.ts
 interface InlineParseOptions {
   readonly gfmAutolinks?: boolean;

package/dist/lower/front-matter.cjs

@@ -20,7 +20,8 @@ function extractFrontMatter(source, sink = require_diagnostics_diagnostics.NOOP_
 	const firstLine = lines[0];
 	if (firstLine === void 0 || !LEADING_DELIMITER_PATTERN.test(firstLine)) return {
 		metadata: {},
-		rest: source
+		rest: source,
+		source: void 0
 	};
 	let closingIndex = -1;
 	for (let index = 1; index < lines.length; index += 1) if (CLOSING_DELIMITER_PATTERN.test(lines[index] ?? "")) {
@@ -29,7 +30,8 @@ function extractFrontMatter(source, sink = require_diagnostics_diagnostics.NOOP_
 	}
 	if (closingIndex === -1) return {
 		metadata: {},
-		rest: source
+		rest: source,
+		source: void 0
 	};
 	const metadata = {};
 	for (let index = 1; index < closingIndex; index += 1) {
@@ -61,14 +63,15 @@ function extractFrontMatter(source, sink = require_diagnostics_diagnostics.NOOP_
 			default: sink({
 				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.FRONT_MATTER_KEY_UNMAPPED,
 				severity: "info",
-				message: `front matter key "${key}" has no LayoutMetadata equivalent and was dropped`,
+				message: `front matter key "${key}" has no LayoutMetadata equivalent and was dropped from the metadata; its original spelling survives in the verbatim front-matter block this package's own writer can re-emit`,
 				line: index + 1
 			});
 		}
 	}
 	return {
 		metadata,
-		rest: lines.slice(closingIndex + 1).join("\n")
+		rest: lines.slice(closingIndex + 1).join("\n"),
+		source: lines.slice(0, closingIndex + 1).join("\n")
 	};
 }
 //#endregion

package/dist/lower/front-matter.d.cts

@@ -1,9 +1,10 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/lower/front-matter.d.ts
 interface FrontMatterResult {
   readonly metadata: LayoutMetadata;
   readonly rest: string;
+  readonly source: string | undefined;
 }
 declare function extractFrontMatter(source: string, sink?: MarkdownDiagnosticSink): FrontMatterResult;
 //#endregion

package/dist/lower/front-matter.d.ts

@@ -1,9 +1,10 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/lower/front-matter.d.ts
 interface FrontMatterResult {
   readonly metadata: LayoutMetadata;
   readonly rest: string;
+  readonly source: string | undefined;
 }
 declare function extractFrontMatter(source: string, sink?: MarkdownDiagnosticSink): FrontMatterResult;
 //#endregion

package/dist/lower/front-matter.js

@@ -19,7 +19,8 @@ function extractFrontMatter(source, sink = NOOP_MARKDOWN_DIAGNOSTIC_SINK) {
 	const firstLine = lines[0];
 	if (firstLine === void 0 || !LEADING_DELIMITER_PATTERN.test(firstLine)) return {
 		metadata: {},
-		rest: source
+		rest: source,
+		source: void 0
 	};
 	let closingIndex = -1;
 	for (let index = 1; index < lines.length; index += 1) if (CLOSING_DELIMITER_PATTERN.test(lines[index] ?? "")) {
@@ -28,7 +29,8 @@ function extractFrontMatter(source, sink = NOOP_MARKDOWN_DIAGNOSTIC_SINK) {
 	}
 	if (closingIndex === -1) return {
 		metadata: {},
-		rest: source
+		rest: source,
+		source: void 0
 	};
 	const metadata = {};
 	for (let index = 1; index < closingIndex; index += 1) {
@@ -60,14 +62,15 @@ function extractFrontMatter(source, sink = NOOP_MARKDOWN_DIAGNOSTIC_SINK) {
 			default: sink({
 				code: MarkdownDiagnosticCodes.FRONT_MATTER_KEY_UNMAPPED,
 				severity: "info",
-				message: `front matter key "${key}" has no LayoutMetadata equivalent and was dropped`,
+				message: `front matter key "${key}" has no LayoutMetadata equivalent and was dropped from the metadata; its original spelling survives in the verbatim front-matter block this package's own writer can re-emit`,
 				line: index + 1
 			});
 		}
 	}
 	return {
 		metadata,
-		rest: lines.slice(closingIndex + 1).join("\n")
+		rest: lines.slice(closingIndex + 1).join("\n"),
+		source: lines.slice(0, closingIndex + 1).join("\n")
 	};
 }
 //#endregion

package/dist/lower/inline.cjs

@@ -12,7 +12,7 @@ function buildRun(text, style, fontFamily) {
 		...fontFamily !== void 0 ? { fontFamily } : {}
 	};
 }
-function lowerNestedEmphasisLike(kind, node, style, context) {
+function lowerNestedEmphasisLike(kind, node, style, context, runs, extents) {
 	if (style[kind] === true) context.sink({
 		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.NESTED_EMPHASIS_FLATTENED,
 		severity: "info",
@@ -22,15 +22,25 @@ function lowerNestedEmphasisLike(kind, node, style, context) {
 		...style,
 		[kind]: true
 	};
-	return node.children.flatMap((child) => lowerInlineNode(child, childStyle, context));
+	lowerNodesInto(node.children, childStyle, context, runs, extents);
 }
-function lowerInlineNode(node, style, context) {
+function lowerInlineNodeInto(node, style, context, runs, extents) {
 	switch (node.type) {
-		case "text": return node.value.length === 0 ? [] : [buildRun(node.value, style)];
-		case "entity": return node.value.length === 0 ? [] : [buildRun(node.value, style)];
-		case "softBreak": return [buildRun(" ", style)];
-		case "hardBreak": return [buildRun("\n", style)];
-		case "codeSpan": return [buildRun(node.literal, style, require_shared_style_constants.MONOSPACE_FONT_FAMILY)];
+		case "text":
+			if (node.value.length > 0) runs.push(buildRun(node.value, style));
+			return;
+		case "entity":
+			if (node.value.length > 0) runs.push(buildRun(node.value, style));
+			return;
+		case "softBreak":
+			runs.push(buildRun(" ", style));
+			return;
+		case "hardBreak":
+			runs.push(buildRun("\n", style));
+			return;
+		case "codeSpan":
+			runs.push(buildRun(node.literal, style, require_shared_style_constants.MONOSPACE_FONT_FAMILY));
+			return;
 		case "rawHtml":
 			if (context.rawHtml === "drop") {
 				context.sink({
@@ -38,47 +48,66 @@ function lowerInlineNode(node, style, context) {
 					severity: "info",
 					message: "inline raw HTML was dropped per the rawHtml: \"drop\" option"
 				});
-				return [];
+				return;
 			}
 			context.sink({
 				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.RAW_HTML_PRESERVED_AS_TEXT,
 				severity: "info",
-				message: "inline raw HTML was preserved as literal text; it will not be rendered as HTML by any consumer of the resulting ContentDocument"
+				message: "inline raw HTML was preserved as literal text; it will not be rendered as HTML by any consumer of the resulting ContentDocument, and its verbatim original rides the run's own markdown residue for this package's writer to re-emit as-is"
 			});
-			return node.literal.length === 0 ? [] : [buildRun(node.literal, style)];
+			if (node.literal.length > 0) runs.push({
+				...buildRun(node.literal, style),
+				source: {
+					format: "markdown",
+					xml: node.literal
+				}
+			});
+			return;
 		case "mathInline":
 			context.sink({
 				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.MATH_INLINE_PRESERVED_AS_TEXT,
 				severity: "info",
 				message: "inline math (\\( \\)) was preserved as literal raw LaTeX text; it is not parsed as LaTeX or converted to MathML by this package"
 			});
-			return [buildRun(node.literal, style, require_shared_style_constants.MATH_INLINE_FONT_MARKER)];
+			runs.push(buildRun(node.literal, style, require_shared_style_constants.MATH_INLINE_FONT_MARKER));
+			return;
 		case "footnoteReference":
 			context.sink({
 				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT,
 				severity: "info",
 				message: `footnote reference "[^${node.label}]" is preserved as a marked text run rather than an anchor construct: a construct's extent is block-scoped, and a reference site sits between two runs inside a paragraph, which no block-level boundary marker can bracket`
 			});
-			return [buildRun(`[^${node.label}]`, style, require_shared_style_constants.FOOTNOTE_REFERENCE_FONT_MARKER)];
+			runs.push(buildRun(`[^${node.label}]`, style, require_shared_style_constants.FOOTNOTE_REFERENCE_FONT_MARKER));
+			return;
 		case "autolink": {
 			const destination = node.email ? `mailto:${node.destination}` : node.destination;
-			return [buildRun(node.destination, {
+			runs.push(buildRun(node.destination, {
 				...style,
 				hyperlink: destination
-			})];
+			}));
+			return;
 		}
 		case "link": {
-			if (node.title !== void 0) context.sink({
-				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.LINK_TITLE_DROPPED,
-				severity: "info",
-				message: `link title "${node.title}" has no ContentRun equivalent and was dropped`
-			});
 			const childStyle = {
 				...style,
 				hyperlink: node.destination
 			};
-			const runs = node.children.flatMap((child) => lowerInlineNode(child, childStyle, context));
-			return runs.length > 0 ? runs : [buildRun("", childStyle)];
+			const startRun = runs.length;
+			lowerNodesInto(node.children, childStyle, context, runs, extents);
+			if (runs.length === startRun) runs.push(buildRun("", childStyle));
+			if (node.title !== void 0) extents.push({
+				descriptor: {
+					kind: "link",
+					target: {
+						kind: "external",
+						uri: node.destination
+					},
+					title: node.title
+				},
+				startRun,
+				endRun: runs.length
+			});
+			return;
 		}
 		case "image":
 			if (node.title !== void 0) context.sink({
@@ -86,17 +115,33 @@ function lowerInlineNode(node, style, context) {
 				severity: "info",
 				message: `image title "${node.title}" has no ContentRun equivalent and was dropped`
 			});
-			return [buildRun(node.alt, {
+			runs.push(buildRun(node.alt, {
 				...style,
 				hyperlink: node.destination
-			})];
-		case "emphasis": return lowerNestedEmphasisLike("italic", node, style, context);
-		case "strong": return lowerNestedEmphasisLike("bold", node, style, context);
-		case "strikethrough": return lowerNestedEmphasisLike("strike", node, style, context);
+			}));
+			return;
+		case "emphasis":
+			lowerNestedEmphasisLike("italic", node, style, context, runs, extents);
+			return;
+		case "strong":
+			lowerNestedEmphasisLike("bold", node, style, context, runs, extents);
+			return;
+		case "strikethrough":
+			lowerNestedEmphasisLike("strike", node, style, context, runs, extents);
+			return;
 	}
 }
+function lowerNodesInto(nodes, style, context, runs, extents) {
+	for (const node of nodes) lowerInlineNodeInto(node, style, context, runs, extents);
+}
 function lowerInlineNodes(nodes, context) {
-	return nodes.flatMap((node) => lowerInlineNode(node, {}, context));
+	const runs = [];
+	const extents = [];
+	lowerNodesInto(nodes, {}, context, runs, extents);
+	return {
+		runs,
+		linkTitleExtents: extents
+	};
 }
 function lowerCodeBlockRun(literal) {
 	return {
@@ -106,5 +151,4 @@ function lowerCodeBlockRun(literal) {
 }
 //#endregion
 exports.lowerCodeBlockRun = lowerCodeBlockRun;
-exports.lowerInlineNode = lowerInlineNode;
 exports.lowerInlineNodes = lowerInlineNodes;

package/dist/lower/inline.d.cts

@@ -1,19 +1,16 @@
 import { v as MarkdownInlineNode } from "../ast-8XCbjRQT.cjs";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
-import { ContentRun } from "document-schema.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { ContentRun, RunConstructExtent } from "document-schema.js";
 //#region src/lower/inline.d.ts
 interface InlineLowerContext {
   readonly sink: MarkdownDiagnosticSink;
   readonly rawHtml: 'preserve' | 'drop';
 }
-interface RunStyle {
-  readonly bold?: boolean;
-  readonly italic?: boolean;
-  readonly strike?: boolean;
-  readonly hyperlink?: string;
+interface InlineLowerResult {
+  readonly runs: ContentRun[];
+  readonly linkTitleExtents: readonly RunConstructExtent[];
 }
-declare function lowerInlineNode(node: MarkdownInlineNode, style: RunStyle, context: InlineLowerContext): ContentRun[];
-declare function lowerInlineNodes(nodes: readonly MarkdownInlineNode[], context: InlineLowerContext): ContentRun[];
+declare function lowerInlineNodes(nodes: readonly MarkdownInlineNode[], context: InlineLowerContext): InlineLowerResult;
 declare function lowerCodeBlockRun(literal: string): ContentRun;
 //#endregion
-export { InlineLowerContext, lowerCodeBlockRun, lowerInlineNode, lowerInlineNodes };
+export { InlineLowerContext, InlineLowerResult, lowerCodeBlockRun, lowerInlineNodes };

package/dist/lower/inline.d.ts

@@ -1,19 +1,16 @@
 import { v as MarkdownInlineNode } from "../ast-8XCbjRQT.js";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
-import { ContentRun } from "document-schema.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
+import { ContentRun, RunConstructExtent } from "document-schema.js";
 //#region src/lower/inline.d.ts
 interface InlineLowerContext {
   readonly sink: MarkdownDiagnosticSink;
   readonly rawHtml: 'preserve' | 'drop';
 }
-interface RunStyle {
-  readonly bold?: boolean;
-  readonly italic?: boolean;
-  readonly strike?: boolean;
-  readonly hyperlink?: string;
+interface InlineLowerResult {
+  readonly runs: ContentRun[];
+  readonly linkTitleExtents: readonly RunConstructExtent[];
 }
-declare function lowerInlineNode(node: MarkdownInlineNode, style: RunStyle, context: InlineLowerContext): ContentRun[];
-declare function lowerInlineNodes(nodes: readonly MarkdownInlineNode[], context: InlineLowerContext): ContentRun[];
+declare function lowerInlineNodes(nodes: readonly MarkdownInlineNode[], context: InlineLowerContext): InlineLowerResult;
 declare function lowerCodeBlockRun(literal: string): ContentRun;
 //#endregion
-export { InlineLowerContext, lowerCodeBlockRun, lowerInlineNode, lowerInlineNodes };
+export { InlineLowerContext, InlineLowerResult, lowerCodeBlockRun, lowerInlineNodes };

package/dist/lower/inline.js

@@ -11,7 +11,7 @@ function buildRun(text, style, fontFamily) {
 		...fontFamily !== void 0 ? { fontFamily } : {}
 	};
 }
-function lowerNestedEmphasisLike(kind, node, style, context) {
+function lowerNestedEmphasisLike(kind, node, style, context, runs, extents) {
 	if (style[kind] === true) context.sink({
 		code: MarkdownDiagnosticCodes.NESTED_EMPHASIS_FLATTENED,
 		severity: "info",
@@ -21,15 +21,25 @@ function lowerNestedEmphasisLike(kind, node, style, context) {
 		...style,
 		[kind]: true
 	};
-	return node.children.flatMap((child) => lowerInlineNode(child, childStyle, context));
+	lowerNodesInto(node.children, childStyle, context, runs, extents);
 }
-function lowerInlineNode(node, style, context) {
+function lowerInlineNodeInto(node, style, context, runs, extents) {
 	switch (node.type) {
-		case "text": return node.value.length === 0 ? [] : [buildRun(node.value, style)];
-		case "entity": return node.value.length === 0 ? [] : [buildRun(node.value, style)];
-		case "softBreak": return [buildRun(" ", style)];
-		case "hardBreak": return [buildRun("\n", style)];
-		case "codeSpan": return [buildRun(node.literal, style, MONOSPACE_FONT_FAMILY)];
+		case "text":
+			if (node.value.length > 0) runs.push(buildRun(node.value, style));
+			return;
+		case "entity":
+			if (node.value.length > 0) runs.push(buildRun(node.value, style));
+			return;
+		case "softBreak":
+			runs.push(buildRun(" ", style));
+			return;
+		case "hardBreak":
+			runs.push(buildRun("\n", style));
+			return;
+		case "codeSpan":
+			runs.push(buildRun(node.literal, style, MONOSPACE_FONT_FAMILY));
+			return;
 		case "rawHtml":
 			if (context.rawHtml === "drop") {
 				context.sink({
@@ -37,47 +47,66 @@ function lowerInlineNode(node, style, context) {
 					severity: "info",
 					message: "inline raw HTML was dropped per the rawHtml: \"drop\" option"
 				});
-				return [];
+				return;
 			}
 			context.sink({
 				code: MarkdownDiagnosticCodes.RAW_HTML_PRESERVED_AS_TEXT,
 				severity: "info",
-				message: "inline raw HTML was preserved as literal text; it will not be rendered as HTML by any consumer of the resulting ContentDocument"
+				message: "inline raw HTML was preserved as literal text; it will not be rendered as HTML by any consumer of the resulting ContentDocument, and its verbatim original rides the run's own markdown residue for this package's writer to re-emit as-is"
 			});
-			return node.literal.length === 0 ? [] : [buildRun(node.literal, style)];
+			if (node.literal.length > 0) runs.push({
+				...buildRun(node.literal, style),
+				source: {
+					format: "markdown",
+					xml: node.literal
+				}
+			});
+			return;
 		case "mathInline":
 			context.sink({
 				code: MarkdownDiagnosticCodes.MATH_INLINE_PRESERVED_AS_TEXT,
 				severity: "info",
 				message: "inline math (\\( \\)) was preserved as literal raw LaTeX text; it is not parsed as LaTeX or converted to MathML by this package"
 			});
-			return [buildRun(node.literal, style, MATH_INLINE_FONT_MARKER)];
+			runs.push(buildRun(node.literal, style, MATH_INLINE_FONT_MARKER));
+			return;
 		case "footnoteReference":
 			context.sink({
 				code: MarkdownDiagnosticCodes.FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT,
 				severity: "info",
 				message: `footnote reference "[^${node.label}]" is preserved as a marked text run rather than an anchor construct: a construct's extent is block-scoped, and a reference site sits between two runs inside a paragraph, which no block-level boundary marker can bracket`
 			});
-			return [buildRun(`[^${node.label}]`, style, FOOTNOTE_REFERENCE_FONT_MARKER)];
+			runs.push(buildRun(`[^${node.label}]`, style, FOOTNOTE_REFERENCE_FONT_MARKER));
+			return;
 		case "autolink": {
 			const destination = node.email ? `mailto:${node.destination}` : node.destination;
-			return [buildRun(node.destination, {
+			runs.push(buildRun(node.destination, {
 				...style,
 				hyperlink: destination
-			})];
+			}));
+			return;
 		}
 		case "link": {
-			if (node.title !== void 0) context.sink({
-				code: MarkdownDiagnosticCodes.LINK_TITLE_DROPPED,
-				severity: "info",
-				message: `link title "${node.title}" has no ContentRun equivalent and was dropped`
-			});
 			const childStyle = {
 				...style,
 				hyperlink: node.destination
 			};
-			const runs = node.children.flatMap((child) => lowerInlineNode(child, childStyle, context));
-			return runs.length > 0 ? runs : [buildRun("", childStyle)];
+			const startRun = runs.length;
+			lowerNodesInto(node.children, childStyle, context, runs, extents);
+			if (runs.length === startRun) runs.push(buildRun("", childStyle));
+			if (node.title !== void 0) extents.push({
+				descriptor: {
+					kind: "link",
+					target: {
+						kind: "external",
+						uri: node.destination
+					},
+					title: node.title
+				},
+				startRun,
+				endRun: runs.length
+			});
+			return;
 		}
 		case "image":
 			if (node.title !== void 0) context.sink({
@@ -85,17 +114,33 @@ function lowerInlineNode(node, style, context) {
 				severity: "info",
 				message: `image title "${node.title}" has no ContentRun equivalent and was dropped`
 			});
-			return [buildRun(node.alt, {
+			runs.push(buildRun(node.alt, {
 				...style,
 				hyperlink: node.destination
-			})];
-		case "emphasis": return lowerNestedEmphasisLike("italic", node, style, context);
-		case "strong": return lowerNestedEmphasisLike("bold", node, style, context);
-		case "strikethrough": return lowerNestedEmphasisLike("strike", node, style, context);
+			}));
+			return;
+		case "emphasis":
+			lowerNestedEmphasisLike("italic", node, style, context, runs, extents);
+			return;
+		case "strong":
+			lowerNestedEmphasisLike("bold", node, style, context, runs, extents);
+			return;
+		case "strikethrough":
+			lowerNestedEmphasisLike("strike", node, style, context, runs, extents);
+			return;
 	}
 }
+function lowerNodesInto(nodes, style, context, runs, extents) {
+	for (const node of nodes) lowerInlineNodeInto(node, style, context, runs, extents);
+}
 function lowerInlineNodes(nodes, context) {
-	return nodes.flatMap((node) => lowerInlineNode(node, {}, context));
+	const runs = [];
+	const extents = [];
+	lowerNodesInto(nodes, {}, context, runs, extents);
+	return {
+		runs,
+		linkTitleExtents: extents
+	};
 }
 function lowerCodeBlockRun(literal) {
 	return {
@@ -104,4 +149,4 @@ function lowerCodeBlockRun(literal) {
 	};
 }
 //#endregion
-export { lowerCodeBlockRun, lowerInlineNode, lowerInlineNodes };
+export { lowerCodeBlockRun, lowerInlineNodes };