markdown-codec 6.1.6 → 6.2.0

package/README.md

@@ -228,9 +228,9 @@ Emission is the inverse and validates first: a section's markers must pair as ba
 
 | Corpus                                                                                | Examples | Passing round trip | Rate  |
 | ------------------------------------------------------------------------------------- | -------- | ------------------ | ----- |
-| CommonMark 0.31.2 (`assets/commonmark/spec.json`)                                     | 652      | 511                | 78.4% |
+| CommonMark 0.31.2 (`assets/commonmark/spec.json`)                                     | 652      | 516                | 79.1% |
 | GFM tagged extensions (table/strikethrough/autolink/task-list, `assets/gfm/spec.txt`) | 23       | 22                 | 95.7% |
-| Combined                                                                              | 675      | 533                | 79.0% |
+| Combined                                                                              | 675      | 538                | 79.7% |
 
 Every non-passing example is named individually in `src/test-support/conformance-exclusions.ts`, attributed to a closed set of causes (shrink-only — see [Conventions](#conventions)): most commonly a soft line break collapsing to a space, a nested/unresolved image title, an emphasis-span collision, or a blockquote whose heading content skips its container pair.
 

package/dist/codec.d.cts

@@ -595,7 +595,7 @@ declare const markdownCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffer>, Uin
   kind: z.ZodLiteral<"drawing">;
 }, z.core.$strip>, z.ZodObject<{
   children: z.ZodArray<z.ZodObject<{
-    mathml: z.ZodArray<z.ZodCustom<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>;
+    mathml: z.ZodArray<z.ZodType<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode, z.core.$ZodTypeInternals<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>>;
     starMath: z.ZodOptional<z.ZodString>;
     presentation: z.ZodOptional<z.ZodObject<{
       latex: z.ZodString;
@@ -1113,11 +1113,80 @@ declare const markdownContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffe
       }, z.core.$strip>>>;
       colSpan: z.ZodOptional<z.ZodNumber>;
       rowSpan: z.ZodOptional<z.ZodNumber>;
-      background: z.ZodOptional<z.ZodObject<{
-        r: z.ZodNumber;
-        g: z.ZodNumber;
-        b: z.ZodNumber;
-      }, z.core.$strip>>;
+      background: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"solid">;
+        color: z.ZodObject<{
+          r: z.ZodNumber;
+          g: z.ZodNumber;
+          b: z.ZodNumber;
+        }, z.core.$strip>;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"pattern">;
+        patternType: z.ZodEnum<{
+          percent5: "percent5";
+          percent10: "percent10";
+          percent12: "percent12";
+          percent15: "percent15";
+          percent20: "percent20";
+          percent25: "percent25";
+          percent30: "percent30";
+          percent35: "percent35";
+          percent37: "percent37";
+          percent40: "percent40";
+          percent45: "percent45";
+          percent50: "percent50";
+          percent55: "percent55";
+          percent60: "percent60";
+          percent62: "percent62";
+          percent65: "percent65";
+          percent70: "percent70";
+          percent75: "percent75";
+          percent80: "percent80";
+          percent85: "percent85";
+          percent87: "percent87";
+          percent90: "percent90";
+          percent95: "percent95";
+          horizontalStripe: "horizontalStripe";
+          verticalStripe: "verticalStripe";
+          diagonalStripe: "diagonalStripe";
+          reverseDiagonalStripe: "reverseDiagonalStripe";
+          horizontalCross: "horizontalCross";
+          diagonalCross: "diagonalCross";
+          thinHorizontalStripe: "thinHorizontalStripe";
+          thinVerticalStripe: "thinVerticalStripe";
+          thinDiagonalStripe: "thinDiagonalStripe";
+          thinReverseDiagonalStripe: "thinReverseDiagonalStripe";
+          thinHorizontalCross: "thinHorizontalCross";
+          thinDiagonalCross: "thinDiagonalCross";
+          mediumGray: "mediumGray";
+          darkGray: "darkGray";
+          lightGray: "lightGray";
+          darkHorizontal: "darkHorizontal";
+          darkVertical: "darkVertical";
+          darkDown: "darkDown";
+          darkUp: "darkUp";
+          darkGrid: "darkGrid";
+          darkTrellis: "darkTrellis";
+          lightHorizontal: "lightHorizontal";
+          lightVertical: "lightVertical";
+          lightDown: "lightDown";
+          lightUp: "lightUp";
+          lightGrid: "lightGrid";
+          lightTrellis: "lightTrellis";
+          gray125: "gray125";
+          gray0625: "gray0625";
+        }>;
+        foregroundColor: z.ZodOptional<z.ZodObject<{
+          r: z.ZodNumber;
+          g: z.ZodNumber;
+          b: z.ZodNumber;
+        }, z.core.$strip>>;
+        backgroundColor: z.ZodOptional<z.ZodObject<{
+          r: z.ZodNumber;
+          g: z.ZodNumber;
+          b: z.ZodNumber;
+        }, z.core.$strip>>;
+      }, z.core.$strip>], "kind">>;
       borders: z.ZodOptional<z.ZodObject<{
         left: z.ZodOptional<z.ZodObject<{
           color: z.ZodObject<{
@@ -1356,10 +1425,10 @@ declare const markdownContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffe
         endColumn: z.ZodNumber;
       }, z.core.$strip>>;
       type: z.ZodEnum<{
-        decimal: "decimal";
-        list: "list";
         date: "date";
         custom: "custom";
+        decimal: "decimal";
+        list: "list";
         time: "time";
         whole: "whole";
         textLength: "textLength";
@@ -2439,7 +2508,7 @@ declare const markdownContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffe
   }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
   formula: z.ZodObject<{
-    mathml: z.ZodArray<z.ZodCustom<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>;
+    mathml: z.ZodArray<z.ZodType<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode, z.core.$ZodTypeInternals<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>>;
     starMath: z.ZodOptional<z.ZodString>;
     presentation: z.ZodOptional<z.ZodObject<{
       latex: z.ZodString;

package/dist/codec.d.ts

@@ -595,7 +595,7 @@ declare const markdownCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffer>, Uin
   kind: z.ZodLiteral<"drawing">;
 }, z.core.$strip>, z.ZodObject<{
   children: z.ZodArray<z.ZodObject<{
-    mathml: z.ZodArray<z.ZodCustom<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>;
+    mathml: z.ZodArray<z.ZodType<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode, z.core.$ZodTypeInternals<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>>;
     starMath: z.ZodOptional<z.ZodString>;
     presentation: z.ZodOptional<z.ZodObject<{
       latex: z.ZodString;
@@ -1113,11 +1113,80 @@ declare const markdownContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffe
       }, z.core.$strip>>>;
       colSpan: z.ZodOptional<z.ZodNumber>;
       rowSpan: z.ZodOptional<z.ZodNumber>;
-      background: z.ZodOptional<z.ZodObject<{
-        r: z.ZodNumber;
-        g: z.ZodNumber;
-        b: z.ZodNumber;
-      }, z.core.$strip>>;
+      background: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"solid">;
+        color: z.ZodObject<{
+          r: z.ZodNumber;
+          g: z.ZodNumber;
+          b: z.ZodNumber;
+        }, z.core.$strip>;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"pattern">;
+        patternType: z.ZodEnum<{
+          percent5: "percent5";
+          percent10: "percent10";
+          percent12: "percent12";
+          percent15: "percent15";
+          percent20: "percent20";
+          percent25: "percent25";
+          percent30: "percent30";
+          percent35: "percent35";
+          percent37: "percent37";
+          percent40: "percent40";
+          percent45: "percent45";
+          percent50: "percent50";
+          percent55: "percent55";
+          percent60: "percent60";
+          percent62: "percent62";
+          percent65: "percent65";
+          percent70: "percent70";
+          percent75: "percent75";
+          percent80: "percent80";
+          percent85: "percent85";
+          percent87: "percent87";
+          percent90: "percent90";
+          percent95: "percent95";
+          horizontalStripe: "horizontalStripe";
+          verticalStripe: "verticalStripe";
+          diagonalStripe: "diagonalStripe";
+          reverseDiagonalStripe: "reverseDiagonalStripe";
+          horizontalCross: "horizontalCross";
+          diagonalCross: "diagonalCross";
+          thinHorizontalStripe: "thinHorizontalStripe";
+          thinVerticalStripe: "thinVerticalStripe";
+          thinDiagonalStripe: "thinDiagonalStripe";
+          thinReverseDiagonalStripe: "thinReverseDiagonalStripe";
+          thinHorizontalCross: "thinHorizontalCross";
+          thinDiagonalCross: "thinDiagonalCross";
+          mediumGray: "mediumGray";
+          darkGray: "darkGray";
+          lightGray: "lightGray";
+          darkHorizontal: "darkHorizontal";
+          darkVertical: "darkVertical";
+          darkDown: "darkDown";
+          darkUp: "darkUp";
+          darkGrid: "darkGrid";
+          darkTrellis: "darkTrellis";
+          lightHorizontal: "lightHorizontal";
+          lightVertical: "lightVertical";
+          lightDown: "lightDown";
+          lightUp: "lightUp";
+          lightGrid: "lightGrid";
+          lightTrellis: "lightTrellis";
+          gray125: "gray125";
+          gray0625: "gray0625";
+        }>;
+        foregroundColor: z.ZodOptional<z.ZodObject<{
+          r: z.ZodNumber;
+          g: z.ZodNumber;
+          b: z.ZodNumber;
+        }, z.core.$strip>>;
+        backgroundColor: z.ZodOptional<z.ZodObject<{
+          r: z.ZodNumber;
+          g: z.ZodNumber;
+          b: z.ZodNumber;
+        }, z.core.$strip>>;
+      }, z.core.$strip>], "kind">>;
       borders: z.ZodOptional<z.ZodObject<{
         left: z.ZodOptional<z.ZodObject<{
           color: z.ZodObject<{
@@ -1356,10 +1425,10 @@ declare const markdownContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffe
         endColumn: z.ZodNumber;
       }, z.core.$strip>>;
       type: z.ZodEnum<{
-        decimal: "decimal";
-        list: "list";
         date: "date";
         custom: "custom";
+        decimal: "decimal";
+        list: "list";
         time: "time";
         whole: "whole";
         textLength: "textLength";
@@ -2439,7 +2508,7 @@ declare const markdownContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffe
   }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
   formula: z.ZodObject<{
-    mathml: z.ZodArray<z.ZodCustom<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>;
+    mathml: z.ZodArray<z.ZodType<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode, z.core.$ZodTypeInternals<import("document-schema.js").MathMlNode, import("document-schema.js").MathMlNode>>>;
     starMath: z.ZodOptional<z.ZodString>;
     presentation: z.ZodOptional<z.ZodObject<{
       latex: z.ZodString;

package/dist/emit/emit.cjs

@@ -46,6 +46,18 @@ function isQuotableStyle(styleId) {
 	if (styleId === void 0) return false;
 	return QUOTABLE_STYLE_IDS.has(styleId) || require_shared_style_constants.parseHeadingStyleId(styleId) !== void 0;
 }
+function terminatesCleanly(styleId) {
+	if (styleId === void 0 || styleId === "Quote" || styleId === "HTMLPreformatted") return false;
+	return styleId === "CodeBlock" || styleId === "MathBlock" || styleId === "HorizontalRule" || require_shared_style_constants.parseHeadingStyleId(styleId) !== void 0;
+}
+function canInterruptOpenParagraph(styleId, context) {
+	if (styleId === void 0 || styleId === "Quote" || styleId === "HTMLPreformatted") return false;
+	if (styleId === "CodeBlock" || styleId === "MathBlock") return true;
+	if (styleId === "HorizontalRule") return context.thematicBreakChar !== SETEXT_LEVEL_2_CHAR;
+	const headingLevel = require_shared_style_constants.parseHeadingStyleId(styleId);
+	if (headingLevel !== void 0) return !(context.headingStyle === "setext" && headingLevel <= MAX_SETEXT_LEVEL);
+	return false;
+}
 function quoteDepthOf(paragraph) {
 	if (paragraph.indentLeftPt === void 0 || paragraph.indentLeftPt <= 0) return 0;
 	return Math.max(1, Math.round(paragraph.indentLeftPt / 36));
@@ -142,16 +154,19 @@ function stripCheckboxRun(item) {
 		runs
 	};
 }
+function toEmitItem(item) {
+	return item.kind === "paragraph" ? { block: item.block } : item.item;
+}
 function firstBlockCheckbox(first, taskNumId) {
-	if (first.list?.checked !== void 0) return {
+	if (first.list.checked !== void 0) return {
 		checkboxText: first.list.checked ? "[x] " : "[ ] ",
 		stripGlyph: false
 	};
-	if (!taskNumId) return {
+	if (!taskNumId || first.kind !== "paragraph") return {
 		checkboxText: "",
 		stripGlyph: false
 	};
-	const leading = first.runs[0]?.text ?? "";
+	const leading = first.block.runs[0]?.text ?? "";
 	if (leading.startsWith(`☒ `)) return {
 		checkboxText: "[x] ",
 		stripGlyph: true
@@ -181,44 +196,127 @@ function renderListItemMarker(numId, info, checkboxText, context) {
 		bareLength: bare.length
 	};
 }
+function consumeSameItemRun(items, from, level, itemId) {
+	let end = from;
+	while (end < items.length) {
+		const candidate = items[end];
+		if (candidate?.list.level !== level || candidate.list.itemId !== itemId) break;
+		end += 1;
+	}
+	return end;
+}
+function collectListItem(items, start, level, itemId) {
+	const segments = [];
+	let index = start;
+	const ownEnd = itemId === void 0 ? index + 1 : consumeSameItemRun(items, index, level, itemId);
+	segments.push({
+		kind: "own",
+		blocks: items.slice(index, ownEnd)
+	});
+	index = ownEnd;
+	for (;;) {
+		let nestedEnd = index;
+		while (nestedEnd < items.length) {
+			const candidateLevel = items[nestedEnd]?.list.level;
+			if (candidateLevel === void 0 || candidateLevel <= level) break;
+			nestedEnd += 1;
+		}
+		if (nestedEnd === index) break;
+		segments.push({
+			kind: "nested",
+			blocks: items.slice(index, nestedEnd)
+		});
+		index = nestedEnd;
+		if (itemId === void 0) break;
+		const resumedEnd = consumeSameItemRun(items, index, level, itemId);
+		if (resumedEnd === index) break;
+		segments.push({
+			kind: "own",
+			blocks: items.slice(index, resumedEnd)
+		});
+		index = resumedEnd;
+	}
+	return {
+		segments,
+		next: index
+	};
+}
+function emitItemCanInterrupt(item, context) {
+	if (!isConstructItem(item)) return item.block.kind === "paragraph" ? canInterruptOpenParagraph(item.block.styleId, context) : true;
+	if (isMaterialisedDivision(item)) return true;
+	const first = item.children[0];
+	return first === void 0 ? true : emitItemCanInterrupt(first, context);
+}
+function lastStyleIdOf(item) {
+	if (isConstructItem(item)) {
+		const last = item.children[item.children.length - 1];
+		return last === void 0 ? void 0 : lastStyleIdOf(last);
+	}
+	return item.block.kind === "paragraph" ? item.block.styleId : void 0;
+}
+function regionItemCanInterrupt(item, context) {
+	return emitItemCanInterrupt(toEmitItem(item), context);
+}
+function lastStyleIdOfRegionItem(item) {
+	return lastStyleIdOf(toEmitItem(item));
+}
+function listRegionItemBody(item, context, stripGlyph) {
+	if (item.kind === "paragraph") return renderParagraphBody(stripGlyph ? stripCheckboxRun(item.block) : item.block, context);
+	const previousEnclosingItemId = context.enclosingItemId;
+	context.enclosingItemId = item.list.itemId;
+	const body = renderConstruct(item.item, context);
+	context.enclosingItemId = previousEnclosingItemId;
+	return body;
+}
+function requiresBlankLineBefore(next, previousStyleId, context) {
+	if (previousStyleId === "HTMLPreformatted") return true;
+	return !terminatesCleanly(previousStyleId) && !regionItemCanInterrupt(next, context);
+}
 function renderListRegion(items, context) {
 	const parts = [];
 	let index = 0;
 	while (index < items.length) {
 		const item = items[index];
-		if (item?.list === void 0) break;
+		if (item === void 0) break;
 		const { numId, level, itemId } = item.list;
 		const info = listInfoFor(numId, context);
-		let ownEnd = index + 1;
-		if (itemId !== void 0) while (ownEnd < items.length) {
-			const candidate = items[ownEnd];
-			if (candidate?.list?.level !== level || candidate.list.itemId !== itemId) break;
-			ownEnd += 1;
-		}
-		const ownBlocks = items.slice(index, ownEnd);
-		let lookahead = ownEnd;
-		while (lookahead < items.length && (items[lookahead]?.list?.level ?? -1) > level) lookahead += 1;
-		const nestedItems = items.slice(ownEnd, lookahead);
-		const first = ownBlocks[0];
+		const loose = info?.loose === true;
+		const { segments, next } = collectListItem(items, index, level, itemId);
+		const first = segments[0]?.blocks[0];
 		if (first === void 0) break;
 		const { checkboxText, stripGlyph } = firstBlockCheckbox(first, info?.task === true);
 		const marker = renderListItemMarker(numId, info, checkboxText, context);
 		const indent = " ".repeat(marker.bareLength);
-		const [firstLine = "", ...restLines] = renderParagraphBody(stripGlyph ? stripCheckboxRun(first) : first, context).split("\n");
-		let text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
-		for (const extra of ownBlocks.slice(1)) {
-			const rendered = renderParagraphBody(extra, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
-			text += `\n\n${rendered}`;
-		}
-		if (nestedItems.length > 0) {
-			const nested = renderListRegion(nestedItems, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
-			text += `\n${nested}`;
+		let text = "";
+		let renderedFirstLine = false;
+		let previousStyleId;
+		for (const segment of segments) {
+			if (segment.kind === "nested") {
+				const nested = renderListRegion(segment.blocks, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+				text += `\n${nested}`;
+				const lastNested = segment.blocks[segment.blocks.length - 1];
+				previousStyleId = lastNested === void 0 ? void 0 : lastStyleIdOfRegionItem(lastNested);
+				continue;
+			}
+			for (const block of segment.blocks) {
+				if (!renderedFirstLine) {
+					const [firstLine = "", ...restLines] = listRegionItemBody(block, context, stripGlyph).split("\n");
+					text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
+					renderedFirstLine = true;
+					previousStyleId = lastStyleIdOfRegionItem(block);
+					continue;
+				}
+				const rendered = listRegionItemBody(block, context, false).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+				const blank = loose || requiresBlankLineBefore(block, previousStyleId, context);
+				text += blank ? `\n\n${rendered}` : `\n${rendered}`;
+				previousStyleId = lastStyleIdOfRegionItem(block);
+			}
 		}
 		parts.push({
 			numId,
 			text
 		});
-		index = lookahead;
+		index = next;
 	}
 	let out = "";
 	for (const [partIndex, part] of parts.entries()) {
@@ -235,6 +333,12 @@ function renderListRegion(items, context) {
 function isConstructItem(item) {
 	return "descriptor" in item;
 }
+function isMaterialisedDivision(item) {
+	return item.descriptor.kind === "division" && item.children.every((child) => {
+		if (isConstructItem(child)) return true;
+		return child.block.kind !== "paragraph" || child.block.indentLeftPt !== void 0 && child.block.indentLeftPt >= 36;
+	});
+}
 function groupConstructItems(blocks, start) {
 	const items = [];
 	let index = start;
@@ -283,10 +387,7 @@ function renderConstruct(item, context) {
 		return body;
 	}
 	if (descriptor.kind === "division") {
-		if (item.children.every((child) => {
-			if (isConstructItem(child)) return true;
-			return child.block.kind !== "paragraph" || child.block.indentLeftPt !== void 0 && child.block.indentLeftPt >= 36;
-		})) {
+		if (isMaterialisedDivision(item)) {
 			context.divisionDepth += 1;
 			const body = renderItems(item.children, context);
 			context.divisionDepth -= 1;
@@ -307,6 +408,18 @@ function renderConstruct(item, context) {
 	});
 	return body;
 }
+function constructCarriesListItemId(item, itemId) {
+	return item.children.some((child) => {
+		if (isConstructItem(child)) return constructCarriesListItemId(child, itemId);
+		if (child.block.kind !== "paragraph") return false;
+		const list = child.block.list;
+		if (list?.itemId === itemId) return true;
+		return list?.numId !== void 0 && require_shared_list_id.parseListNumId(list.numId)?.ownerItemId === itemId;
+	});
+}
+function isInheritedListMembership(list, context) {
+	return list.itemId !== void 0 && list.itemId === context.enclosingItemId;
+}
 function renderItems(items, context) {
 	const parts = [];
 	let index = 0;
@@ -319,11 +432,40 @@ function renderItems(items, context) {
 			index += 1;
 			continue;
 		}
-		if (item.block.kind === "paragraph" && item.block.list !== void 0) {
+		if (item.block.kind === "paragraph" && item.block.list !== void 0 && !isInheritedListMembership(item.block.list, context)) {
 			const region = [];
 			let end = index;
-			for (let candidate = items[end]; candidate !== void 0 && !isConstructItem(candidate) && candidate.block.kind === "paragraph" && candidate.block.list !== void 0; candidate = items[end]) {
-				region.push(candidate.block);
+			const openMemberships = [];
+			for (;;) {
+				const candidate = items[end];
+				if (candidate === void 0) break;
+				if (isConstructItem(candidate)) {
+					let matched;
+					for (let i = openMemberships.length - 1; i >= 0; i -= 1) {
+						const membership = openMemberships[i];
+						if (membership.itemId !== void 0 && constructCarriesListItemId(candidate, membership.itemId)) {
+							matched = membership;
+							break;
+						}
+					}
+					if (matched === void 0) break;
+					region.push({
+						kind: "construct",
+						item: candidate,
+						list: matched
+					});
+					end += 1;
+					continue;
+				}
+				if (candidate.block.kind !== "paragraph" || candidate.block.list === void 0 || isInheritedListMembership(candidate.block.list, context)) break;
+				const list = candidate.block.list;
+				while (openMemberships.length > 0 && openMemberships[openMemberships.length - 1].level >= list.level) openMemberships.pop();
+				openMemberships.push(list);
+				region.push({
+					kind: "paragraph",
+					block: candidate.block,
+					list
+				});
 				end += 1;
 			}
 			parts.push(renderListRegion(region, context));
@@ -365,7 +507,8 @@ function emitMarkdown(document, options = {}) {
 		orderedCounters: /* @__PURE__ */ new Map(),
 		reportedFallbackNumIds: /* @__PURE__ */ new Set(),
 		reportedAbsentNumIdFallback: false,
-		divisionDepth: 0
+		divisionDepth: 0,
+		enclosingItemId: void 0
 	};
 	const body = document.sections.map((section) => emitBlocks(section.blocks, context)).join("\n\n");
 	const frontMatter = options.frontMatter === true ? require_emit_front_matter.emitFrontMatter(document.metadata) : void 0;

package/dist/emit/emit.js

@@ -45,6 +45,18 @@ function isQuotableStyle(styleId) {
 	if (styleId === void 0) return false;
 	return QUOTABLE_STYLE_IDS.has(styleId) || parseHeadingStyleId(styleId) !== void 0;
 }
+function terminatesCleanly(styleId) {
+	if (styleId === void 0 || styleId === "Quote" || styleId === "HTMLPreformatted") return false;
+	return styleId === "CodeBlock" || styleId === "MathBlock" || styleId === "HorizontalRule" || parseHeadingStyleId(styleId) !== void 0;
+}
+function canInterruptOpenParagraph(styleId, context) {
+	if (styleId === void 0 || styleId === "Quote" || styleId === "HTMLPreformatted") return false;
+	if (styleId === "CodeBlock" || styleId === "MathBlock") return true;
+	if (styleId === "HorizontalRule") return context.thematicBreakChar !== SETEXT_LEVEL_2_CHAR;
+	const headingLevel = parseHeadingStyleId(styleId);
+	if (headingLevel !== void 0) return !(context.headingStyle === "setext" && headingLevel <= MAX_SETEXT_LEVEL);
+	return false;
+}
 function quoteDepthOf(paragraph) {
 	if (paragraph.indentLeftPt === void 0 || paragraph.indentLeftPt <= 0) return 0;
 	return Math.max(1, Math.round(paragraph.indentLeftPt / 36));
@@ -141,16 +153,19 @@ function stripCheckboxRun(item) {
 		runs
 	};
 }
+function toEmitItem(item) {
+	return item.kind === "paragraph" ? { block: item.block } : item.item;
+}
 function firstBlockCheckbox(first, taskNumId) {
-	if (first.list?.checked !== void 0) return {
+	if (first.list.checked !== void 0) return {
 		checkboxText: first.list.checked ? "[x] " : "[ ] ",
 		stripGlyph: false
 	};
-	if (!taskNumId) return {
+	if (!taskNumId || first.kind !== "paragraph") return {
 		checkboxText: "",
 		stripGlyph: false
 	};
-	const leading = first.runs[0]?.text ?? "";
+	const leading = first.block.runs[0]?.text ?? "";
 	if (leading.startsWith(`☒ `)) return {
 		checkboxText: "[x] ",
 		stripGlyph: true
@@ -180,44 +195,127 @@ function renderListItemMarker(numId, info, checkboxText, context) {
 		bareLength: bare.length
 	};
 }
+function consumeSameItemRun(items, from, level, itemId) {
+	let end = from;
+	while (end < items.length) {
+		const candidate = items[end];
+		if (candidate?.list.level !== level || candidate.list.itemId !== itemId) break;
+		end += 1;
+	}
+	return end;
+}
+function collectListItem(items, start, level, itemId) {
+	const segments = [];
+	let index = start;
+	const ownEnd = itemId === void 0 ? index + 1 : consumeSameItemRun(items, index, level, itemId);
+	segments.push({
+		kind: "own",
+		blocks: items.slice(index, ownEnd)
+	});
+	index = ownEnd;
+	for (;;) {
+		let nestedEnd = index;
+		while (nestedEnd < items.length) {
+			const candidateLevel = items[nestedEnd]?.list.level;
+			if (candidateLevel === void 0 || candidateLevel <= level) break;
+			nestedEnd += 1;
+		}
+		if (nestedEnd === index) break;
+		segments.push({
+			kind: "nested",
+			blocks: items.slice(index, nestedEnd)
+		});
+		index = nestedEnd;
+		if (itemId === void 0) break;
+		const resumedEnd = consumeSameItemRun(items, index, level, itemId);
+		if (resumedEnd === index) break;
+		segments.push({
+			kind: "own",
+			blocks: items.slice(index, resumedEnd)
+		});
+		index = resumedEnd;
+	}
+	return {
+		segments,
+		next: index
+	};
+}
+function emitItemCanInterrupt(item, context) {
+	if (!isConstructItem(item)) return item.block.kind === "paragraph" ? canInterruptOpenParagraph(item.block.styleId, context) : true;
+	if (isMaterialisedDivision(item)) return true;
+	const first = item.children[0];
+	return first === void 0 ? true : emitItemCanInterrupt(first, context);
+}
+function lastStyleIdOf(item) {
+	if (isConstructItem(item)) {
+		const last = item.children[item.children.length - 1];
+		return last === void 0 ? void 0 : lastStyleIdOf(last);
+	}
+	return item.block.kind === "paragraph" ? item.block.styleId : void 0;
+}
+function regionItemCanInterrupt(item, context) {
+	return emitItemCanInterrupt(toEmitItem(item), context);
+}
+function lastStyleIdOfRegionItem(item) {
+	return lastStyleIdOf(toEmitItem(item));
+}
+function listRegionItemBody(item, context, stripGlyph) {
+	if (item.kind === "paragraph") return renderParagraphBody(stripGlyph ? stripCheckboxRun(item.block) : item.block, context);
+	const previousEnclosingItemId = context.enclosingItemId;
+	context.enclosingItemId = item.list.itemId;
+	const body = renderConstruct(item.item, context);
+	context.enclosingItemId = previousEnclosingItemId;
+	return body;
+}
+function requiresBlankLineBefore(next, previousStyleId, context) {
+	if (previousStyleId === "HTMLPreformatted") return true;
+	return !terminatesCleanly(previousStyleId) && !regionItemCanInterrupt(next, context);
+}
 function renderListRegion(items, context) {
 	const parts = [];
 	let index = 0;
 	while (index < items.length) {
 		const item = items[index];
-		if (item?.list === void 0) break;
+		if (item === void 0) break;
 		const { numId, level, itemId } = item.list;
 		const info = listInfoFor(numId, context);
-		let ownEnd = index + 1;
-		if (itemId !== void 0) while (ownEnd < items.length) {
-			const candidate = items[ownEnd];
-			if (candidate?.list?.level !== level || candidate.list.itemId !== itemId) break;
-			ownEnd += 1;
-		}
-		const ownBlocks = items.slice(index, ownEnd);
-		let lookahead = ownEnd;
-		while (lookahead < items.length && (items[lookahead]?.list?.level ?? -1) > level) lookahead += 1;
-		const nestedItems = items.slice(ownEnd, lookahead);
-		const first = ownBlocks[0];
+		const loose = info?.loose === true;
+		const { segments, next } = collectListItem(items, index, level, itemId);
+		const first = segments[0]?.blocks[0];
 		if (first === void 0) break;
 		const { checkboxText, stripGlyph } = firstBlockCheckbox(first, info?.task === true);
 		const marker = renderListItemMarker(numId, info, checkboxText, context);
 		const indent = " ".repeat(marker.bareLength);
-		const [firstLine = "", ...restLines] = renderParagraphBody(stripGlyph ? stripCheckboxRun(first) : first, context).split("\n");
-		let text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
-		for (const extra of ownBlocks.slice(1)) {
-			const rendered = renderParagraphBody(extra, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
-			text += `\n\n${rendered}`;
-		}
-		if (nestedItems.length > 0) {
-			const nested = renderListRegion(nestedItems, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
-			text += `\n${nested}`;
+		let text = "";
+		let renderedFirstLine = false;
+		let previousStyleId;
+		for (const segment of segments) {
+			if (segment.kind === "nested") {
+				const nested = renderListRegion(segment.blocks, context).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+				text += `\n${nested}`;
+				const lastNested = segment.blocks[segment.blocks.length - 1];
+				previousStyleId = lastNested === void 0 ? void 0 : lastStyleIdOfRegionItem(lastNested);
+				continue;
+			}
+			for (const block of segment.blocks) {
+				if (!renderedFirstLine) {
+					const [firstLine = "", ...restLines] = listRegionItemBody(block, context, stripGlyph).split("\n");
+					text = [`${marker.full}${firstLine}`, ...restLines.map((line) => `${indent}${line}`)].join("\n");
+					renderedFirstLine = true;
+					previousStyleId = lastStyleIdOfRegionItem(block);
+					continue;
+				}
+				const rendered = listRegionItemBody(block, context, false).split("\n").map((line) => line.length === 0 ? line : `${indent}${line}`).join("\n");
+				const blank = loose || requiresBlankLineBefore(block, previousStyleId, context);
+				text += blank ? `\n\n${rendered}` : `\n${rendered}`;
+				previousStyleId = lastStyleIdOfRegionItem(block);
+			}
 		}
 		parts.push({
 			numId,
 			text
 		});
-		index = lookahead;
+		index = next;
 	}
 	let out = "";
 	for (const [partIndex, part] of parts.entries()) {
@@ -234,6 +332,12 @@ function renderListRegion(items, context) {
 function isConstructItem(item) {
 	return "descriptor" in item;
 }
+function isMaterialisedDivision(item) {
+	return item.descriptor.kind === "division" && item.children.every((child) => {
+		if (isConstructItem(child)) return true;
+		return child.block.kind !== "paragraph" || child.block.indentLeftPt !== void 0 && child.block.indentLeftPt >= 36;
+	});
+}
 function groupConstructItems(blocks, start) {
 	const items = [];
 	let index = start;
@@ -282,10 +386,7 @@ function renderConstruct(item, context) {
 		return body;
 	}
 	if (descriptor.kind === "division") {
-		if (item.children.every((child) => {
-			if (isConstructItem(child)) return true;
-			return child.block.kind !== "paragraph" || child.block.indentLeftPt !== void 0 && child.block.indentLeftPt >= 36;
-		})) {
+		if (isMaterialisedDivision(item)) {
 			context.divisionDepth += 1;
 			const body = renderItems(item.children, context);
 			context.divisionDepth -= 1;
@@ -306,6 +407,18 @@ function renderConstruct(item, context) {
 	});
 	return body;
 }
+function constructCarriesListItemId(item, itemId) {
+	return item.children.some((child) => {
+		if (isConstructItem(child)) return constructCarriesListItemId(child, itemId);
+		if (child.block.kind !== "paragraph") return false;
+		const list = child.block.list;
+		if (list?.itemId === itemId) return true;
+		return list?.numId !== void 0 && parseListNumId(list.numId)?.ownerItemId === itemId;
+	});
+}
+function isInheritedListMembership(list, context) {
+	return list.itemId !== void 0 && list.itemId === context.enclosingItemId;
+}
 function renderItems(items, context) {
 	const parts = [];
 	let index = 0;
@@ -318,11 +431,40 @@ function renderItems(items, context) {
 			index += 1;
 			continue;
 		}
-		if (item.block.kind === "paragraph" && item.block.list !== void 0) {
+		if (item.block.kind === "paragraph" && item.block.list !== void 0 && !isInheritedListMembership(item.block.list, context)) {
 			const region = [];
 			let end = index;
-			for (let candidate = items[end]; candidate !== void 0 && !isConstructItem(candidate) && candidate.block.kind === "paragraph" && candidate.block.list !== void 0; candidate = items[end]) {
-				region.push(candidate.block);
+			const openMemberships = [];
+			for (;;) {
+				const candidate = items[end];
+				if (candidate === void 0) break;
+				if (isConstructItem(candidate)) {
+					let matched;
+					for (let i = openMemberships.length - 1; i >= 0; i -= 1) {
+						const membership = openMemberships[i];
+						if (membership.itemId !== void 0 && constructCarriesListItemId(candidate, membership.itemId)) {
+							matched = membership;
+							break;
+						}
+					}
+					if (matched === void 0) break;
+					region.push({
+						kind: "construct",
+						item: candidate,
+						list: matched
+					});
+					end += 1;
+					continue;
+				}
+				if (candidate.block.kind !== "paragraph" || candidate.block.list === void 0 || isInheritedListMembership(candidate.block.list, context)) break;
+				const list = candidate.block.list;
+				while (openMemberships.length > 0 && openMemberships[openMemberships.length - 1].level >= list.level) openMemberships.pop();
+				openMemberships.push(list);
+				region.push({
+					kind: "paragraph",
+					block: candidate.block,
+					list
+				});
 				end += 1;
 			}
 			parts.push(renderListRegion(region, context));
@@ -364,7 +506,8 @@ function emitMarkdown(document, options = {}) {
 		orderedCounters: /* @__PURE__ */ new Map(),
 		reportedFallbackNumIds: /* @__PURE__ */ new Set(),
 		reportedAbsentNumIdFallback: false,
-		divisionDepth: 0
+		divisionDepth: 0,
+		enclosingItemId: void 0
 	};
 	const body = document.sections.map((section) => emitBlocks(section.blocks, context)).join("\n\n");
 	const frontMatter = options.frontMatter === true ? emitFrontMatter(document.metadata) : void 0;

package/dist/lower/lower.cjs

@@ -276,7 +276,8 @@ function lowerList(node, ancestorNumId, level, context, contentWidthPt) {
 			type: node.markerType,
 			start: node.start,
 			task,
-			loose: !node.tight
+			loose: !node.tight,
+			ownerItemId: context.list?.itemId
 		});
 	} else {
 		numId = ancestorNumId;

package/dist/lower/lower.js

@@ -275,7 +275,8 @@ function lowerList(node, ancestorNumId, level, context, contentWidthPt) {
 			type: node.markerType,
 			start: node.start,
 			task,
-			loose: !node.tight
+			loose: !node.tight,
+			ownerItemId: context.list?.itemId
 		});
 	} else {
 		numId = ancestorNumId;

package/dist/shared/list-id.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/shared/list-id.ts
-const NUMID_PATTERN = /^md(\d+):(bullet|ordered)(?:@(\d+))?(\+task)?(\+loose)?$/;
+const NUMID_PATTERN = /^md(\d+):(bullet|ordered)(?:@(\d+))?(\+task)?(\+loose)?(?:\+owner=(md-i\d+))?$/;
 const DEFAULT_ORDERED_START = 1;
 function createNumIdMintState() {
 	return { next: 1 };
@@ -11,7 +11,8 @@ function mintListNumId(state, options) {
 	const startSuffix = options.type === "ordered" && options.start !== void 0 && options.start !== DEFAULT_ORDERED_START ? `@${String(options.start)}` : "";
 	const taskSuffix = options.task ? "+task" : "";
 	const looseSuffix = options.loose ? "+loose" : "";
-	return `md${String(id)}:${options.type}${startSuffix}${taskSuffix}${looseSuffix}`;
+	const ownerSuffix = options.ownerItemId !== void 0 ? `+owner=${options.ownerItemId}` : "";
+	return `md${String(id)}:${options.type}${startSuffix}${taskSuffix}${looseSuffix}${ownerSuffix}`;
 }
 function parseListNumId(numId) {
 	const match = NUMID_PATTERN.exec(numId);
@@ -23,7 +24,8 @@ function parseListNumId(numId) {
 		type,
 		start: type === "ordered" && startText !== void 0 ? Number.parseInt(startText, 10) : void 0,
 		task: match[4] !== void 0,
-		loose: match[5] !== void 0
+		loose: match[5] !== void 0,
+		ownerItemId: match[6]
 	};
 }
 function mintedListType(numId) {

package/dist/shared/list-id.d.cts

@@ -4,12 +4,14 @@ interface ListNumIdInfo {
   readonly start?: number;
   readonly task: boolean;
   readonly loose: boolean;
+  readonly ownerItemId?: string;
 }
 interface ListNumIdMintOptions {
   readonly type: "bullet" | "ordered";
   readonly start?: number;
   readonly task: boolean;
   readonly loose: boolean;
+  readonly ownerItemId?: string;
 }
 interface NumIdMintState {
   next: number;

package/dist/shared/list-id.d.ts

@@ -4,12 +4,14 @@ interface ListNumIdInfo {
   readonly start?: number;
   readonly task: boolean;
   readonly loose: boolean;
+  readonly ownerItemId?: string;
 }
 interface ListNumIdMintOptions {
   readonly type: "bullet" | "ordered";
   readonly start?: number;
   readonly task: boolean;
   readonly loose: boolean;
+  readonly ownerItemId?: string;
 }
 interface NumIdMintState {
   next: number;

package/dist/shared/list-id.js

@@ -1,5 +1,5 @@
 //#region src/shared/list-id.ts
-const NUMID_PATTERN = /^md(\d+):(bullet|ordered)(?:@(\d+))?(\+task)?(\+loose)?$/;
+const NUMID_PATTERN = /^md(\d+):(bullet|ordered)(?:@(\d+))?(\+task)?(\+loose)?(?:\+owner=(md-i\d+))?$/;
 const DEFAULT_ORDERED_START = 1;
 function createNumIdMintState() {
 	return { next: 1 };
@@ -10,7 +10,8 @@ function mintListNumId(state, options) {
 	const startSuffix = options.type === "ordered" && options.start !== void 0 && options.start !== DEFAULT_ORDERED_START ? `@${String(options.start)}` : "";
 	const taskSuffix = options.task ? "+task" : "";
 	const looseSuffix = options.loose ? "+loose" : "";
-	return `md${String(id)}:${options.type}${startSuffix}${taskSuffix}${looseSuffix}`;
+	const ownerSuffix = options.ownerItemId !== void 0 ? `+owner=${options.ownerItemId}` : "";
+	return `md${String(id)}:${options.type}${startSuffix}${taskSuffix}${looseSuffix}${ownerSuffix}`;
 }
 function parseListNumId(numId) {
 	const match = NUMID_PATTERN.exec(numId);
@@ -22,7 +23,8 @@ function parseListNumId(numId) {
 		type,
 		start: type === "ordered" && startText !== void 0 ? Number.parseInt(startText, 10) : void 0,
 		task: match[4] !== void 0,
-		loose: match[5] !== void 0
+		loose: match[5] !== void 0,
+		ownerItemId: match[6]
 	};
 }
 function mintedListType(numId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdown-codec",
-  "version": "6.1.6",
+  "version": "6.2.0",
   "description": "Hand-written CommonMark+GFM <-> DocumentTree codec, built on document-schema.js",
   "type": "module",
   "repository": {
@@ -62,6 +62,8 @@
     "test:watch": "vitest --project unit",
     "test:coverage": "turbo run _test:coverage",
     "_test:coverage": "vitest run --project unit --coverage",
+    "test:mutation": "turbo run _test:mutation",
+    "_test:mutation": "stryker run stryker.config.mjs",
     "test:corpus": "turbo run _test:corpus",
     "_test:corpus": "vitest run --project corpus",
     "test:smoke": "turbo run _test:smoke",
@@ -81,16 +83,20 @@
   "license": "MIT",
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "document-schema.js": "^5.6.0",
+    "document-schema.js": "^6.1.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@cloudflare/vitest-pool-workers": "^0.21.2",
+    "@stryker-mutator/core": "^10.0.0",
+    "@stryker-mutator/typescript-checker": "^10.0.0",
+    "@stryker-mutator/vitest-runner": "^10.0.0",
     "@types/node": "^26.1.1",
     "@vitest/coverage-v8": "^4.1.10",
     "eslint": "^10.8.0",
     "husky": "^9.1.7",
+    "jiti": "2.7.0",
     "publint": "^0.3.21",
     "semantic-release": "^25.0.8",
     "tsdown": "^0.22.13",