rapier-markdown-kit 1.1.101 → 1.1.104

package/dist/kit/render-markdown.mjs

@@ -1,6 +1,6 @@
 import {htmlPlaceholder, mountHtmlBlocks, htmlImageRecord, htmlLayoutEdit} from '../spec/html-blocks.mjs';
 // SPDX-License-Identifier: MIT
-import {finish, finishAsync, cloneTree, cleanTree, serializeTree, htmlBoundary, pause, check} from './render-work.mjs';
+import {finish, finishAsync, cloneTree, cleanTree, serializeTree, htmlParts, admitHtml, htmlBoundary, pause, check} from './render-work.mjs';
 const RAPIER_TABLE_CAPTION_PREFIX_RE = /^(?:Table:|:) /;
 const RAPIER_PORTABLE_HIGHLIGHT_HEX = Object.freeze({
 	green: '#35c57a', red: '#f05a62', blue: '#4f91f7', yellow: '#e6b91e', purple: '#9b6dea',
@@ -50,22 +50,32 @@ function initMarkdownIt() {
 		return markOpenDefault(tokens, idx, opts, env, self);
 	};
 
-	md.renderer.rules.rapier_color_open = (tokens, idx) => {
-		const hex = String(tokens[idx].attrGet('data-md-color') || '').toLowerCase();
-		if (!/^#[0-9a-f]{6}$/.test(hex)) return '<span>';
-		const dark = _rapierDeriveDarkColor(hex);
-		return '<span data-md-color="' + hex + '" style="--md-color:' + hex + ';--md-color-dark:' + dark + '">';
-	};
-	md.renderer.rules.rapier_color_close = () => '</span>';
-	md.renderer.rules.rapier_font_open = (tokens, idx) => {
-		const token = tokens[idx], family = token.attrGet('data-md-font'), css = globalThis.RapierMarkdownSpec.fontFamilyCss(family);
-		if (!css) return '<span>';
-		const original = token.attrGet('data-md-font-open');
-		return '<span data-md-font="' + md.utils.escapeHtml(family) + '"'
-			+ (original ? ' data-md-font-open="' + md.utils.escapeHtml(original) + '"' : '')
-			+ ' style="font-family:' + md.utils.escapeHtml(css) + '">';
+	// Every authored spelling lowers to the same admitted style facts. Original delimiters are
+	// transient edit-projection data; only the source owner can write them back.
+	const renderTypography = (tokens, index) => {
+		const typed = globalThis.RapierMarkdownSpec.typography, held = tokens[index].meta?.typography;
+		if (!held) return '<span>';
+		const facts = held.style, attrs = [], css = [];
+		if (facts.size) {
+			attrs.push('data-md-size="' + facts.size + '"');
+			css.push('font-size:calc(' + typed.size(facts.size).points / 12 + ' * var(--md-unit))');
+		}
+		if (facts.color) {
+			attrs.push('data-md-color="' + facts.color + '"');
+			css.push('--md-color:' + facts.color, '--md-color-dark:' + _rapierDeriveDarkColor(facts.color));
+		}
+		if (facts.family) {
+			attrs.push('data-md-font="' + md.utils.escapeHtml(facts.family.name) + '"');
+			css.push('font-family:' + facts.family.css);
+		}
+		attrs.push('data-md-typography-open="' + md.utils.escapeHtml(encodeURIComponent(held.open)) + '"',
+			'data-md-typography-close="' + md.utils.escapeHtml(encodeURIComponent(held.close)) + '"');
+		return '<span ' + attrs.join(' ') + ' style="' + md.utils.escapeHtml(css.join(';')) + '">';
 	};
-	md.renderer.rules.rapier_font_close = () => '</span>';
+	for (const kind of ['typography', 'color', 'font']) {
+		md.renderer.rules['rapier_' + kind + '_open'] = renderTypography;
+		md.renderer.rules['rapier_' + kind + '_close'] = () => '</span>';
+	}
 	// Ink: the span carries its opener's body (the grammar's inkOpenBody: a sanitizer drops an attribute holding the
 	// comment's close); the ink layer reads it back through the one grammar and draws the stroke over the words' own boxes.
 	// The span itself shows nothing.
@@ -195,6 +205,11 @@ function initMarkdownIt() {
 		_rapierChromeOwnsId('');
 		const cleanTag = tag => /^<[A-Za-z]/.test(tag) ? tag.replace(rawAttribute, (whole, name, value) => {
 			const key = name.toLowerCase();
+			if (key === 'style' && /^<span(?=[\s>])/i.test(tag)) {
+				const typed = globalThis.RapierMarkdownSpec.typography;
+				const css = typed.style(typed.parseStyle(md.utils.unescapeAll(String(value || '').replace(/^["']|["']$/g, '').replace(/\\/g, '\\\\'))));
+				return css ? ' style="' + md.utils.escapeHtml(css) + '"' : '';
+			}
 			return key.startsWith('data-') || key === 'for' || key === 'id' && _rapierChromeOwnsId(attributeText(value)) ? '' : whole;
 		}) : tag;
 		md.renderer.rules.html_inline = (tokens, idx) => cleanTag(tokens[idx].content);
@@ -331,9 +346,9 @@ function initMarkdownIt() {
 
 	{
 		let _mathPromptedOnce = false;
-		const _renderMath = (src, displayMode, env) => {
+		const _renderMath = (src, displayMode, env, authored) => {
 			const marker = displayMode ? '$$' : '$';
-			const source = marker + src + marker, literal = md.utils.escapeHtml(source);
+			const source = authored || marker + src + marker, literal = md.utils.escapeHtml(source);
 			if (env.rapierPage) return '<span data-rapier-math-source="">' + literal + '</span>';
 			const mathProvider = env.rapierProviders === false ? null : _rapierProviders.math;
 			if (!mathProvider || mathProvider.status !== 'ready' || typeof mathProvider.renderToString !== 'function') {
@@ -351,8 +366,8 @@ function initMarkdownIt() {
 			}
 			catch (_) { return '<span data-rapier-math-source="">' + literal + '</span>'; }
 		};
-		md.renderer.rules.math_inline = (tokens, idx, _opts, env) => _renderMath(tokens[idx].content, false, env);
-		md.renderer.rules.math_block  = (tokens, idx, _opts, env) => wrapDisplayMath(_renderMath(tokens[idx].content, true, env)) + '\n';
+		md.renderer.rules.math_inline = (tokens, idx, _opts, env) => _renderMath(tokens[idx].content, false, env, tokens[idx].meta?.mathSource);
+		md.renderer.rules.math_block  = (tokens, idx, _opts, env) => wrapDisplayMath(_renderMath(tokens[idx].content, true, env, tokens[idx].meta?.mathSource)) + '\n';
 	}
 	globalThis.RapierMarkdownLayout.installMarkdownLayout(md);
 	globalThis.RapierImageAssets.configureParser(md, _rapierSplitOpeningFrontmatter);
@@ -398,7 +413,7 @@ function _rapierRenderSemanticRoot(canonical, metadata, options = {}) {
 	root.querySelectorAll('pre > code').forEach(_rapierNormalizeCodeElement);
 	_rapierMarkTableCaptions(root);
 	_rapierMarkFigureCaptions(root);
-	_rapierMarkListContinuations(Array.from(root.children));
+	_rapierMarkListContinuations(_rapierChildElements(root));
 	_rapierDecorateJumpLists(root);
 	return root;
 }
@@ -413,20 +428,22 @@ async function _rapierRenderSemanticRootAsync(canonical, metadata, options = {})
 	}
 	const markdown = _rapierSplitOpeningFrontmatter(canonical).body;
 	const fallbackEnv = options.page ? {rapierPage: true} : {};
-	const parsed = options.parsed || (runtime.parseAsync ? await runtime.parseAsync(markdown, options) : {tokens: md.parse(markdown, fallbackEnv), env: fallbackEnv});
-	const {tokens, env} = parsed, labels = env.footnotes?.list?.map((item, index) => String(item?.label || ('inline-' + (index + 1))));
+	let parsed = options.parsed || (runtime.parseAsync ? await runtime.parseAsync(markdown, options) : {tokens: md.parse(markdown, fallbackEnv), env: fallbackEnv});
+	let {tokens, env} = parsed, labels = env.footnotes?.list?.map((item, index) => String(item?.label || ('inline-' + (index + 1))));
+	await pause(work, .3);
 	env.rapierDocumentSpace = !!globalThis.RapierMarkdownSpec?.readDocumentSettings?.(canonical)?.space;
 	const root = document.createElement('div'), part = document.createElement('div'), boundary = htmlBoundary();
 	root.setAttribute('data-rapier-semantic-root', 'true');
 	if (env.rapierDocumentSpace) root.setAttribute('data-md-space', '');
-	let html = '', began = performance.now();
+	let html = '', began = performance.now(), complete = false;
 	const append = () => {
 		if (md.renderer.rapierTransformHtml) html = md.renderer.rapierTransformHtml(html);
 		if (labels?.length) html = _relabelFootnoteHtml(html, labels);
-		part.innerHTML = sanitizeRapierHtml(html, options.page ? 'source' : 'export');
+		admitHtml(part, html, sanitizeRapierHtml, runtime.sanitizeRapierFragment, options.page ? 'source' : 'export');
 		while (part.firstChild) root.appendChild(part.firstChild);
 		html = '';
 	};
+	try {
 		for (let index = 0; index < tokens.length; index++) {
 			const token = tokens[index], rule = md.renderer.rules[token.type];
 			let rendered = token.type === 'inline' ? md.renderer.renderInline(token.children, md.options, env)
@@ -439,9 +456,15 @@ async function _rapierRenderSemanticRootAsync(canonical, metadata, options = {})
 			}
 		}
 		if (html) append();
+		// Token/environment objects are no longer inputs once their complete HTML
+		// is admitted. Drop our references before the document-wide DOM passes;
+		// never mutate an optional parsed result retained by another caller.
+		parsed = tokens = env = labels = null;
 		await finishAsync(_rapierSemanticDecorations(root), work);
 		await pause(work, .6);
+		complete = true;
 		return root;
+	} finally { if (!complete) { root.replaceChildren(); part.replaceChildren(); } }
 }
 
 function* _rapierSemanticDecorations(root) {
@@ -451,7 +474,7 @@ function* _rapierSemanticDecorations(root) {
 	for (const code of root.querySelectorAll('pre > code')) { _rapierNormalizeCodeElement(code); yield; }
 	yield* _rapierMarkTableCaptionsSteps(root); yield;
 	yield* _rapierMarkFigureCaptionsSteps(root); yield;
-	yield* _rapierMarkListContinuationsSteps(Array.from(root.children)); yield;
+	yield* _rapierMarkListContinuationsSteps(_rapierChildElements(root)); yield;
 	yield* _rapierDecorateJumpListsSteps(root); yield;
 }
 
@@ -660,13 +683,20 @@ function _rapierApplyBlockDirection(root) { return finish(_rapierApplyBlockDirec
 
 function* _rapierApplyBlockDirectionSteps(root) {
 	if (!root || typeof root.querySelectorAll !== 'function') return;
-	for (const el of root.querySelectorAll(_RAPIER_DIR_BLOCKS)) {
+	const blocks = new Set(_RAPIER_DIR_BLOCKS.split(',')), elements = root.ownerDocument.createTreeWalker(root, 1);
+	for (let el = elements.nextNode(); el; el = elements.nextNode()) {
 		yield;
-		if (el.closest('pre, code')) continue;
+		if (!blocks.has(el.localName)) continue;
+		let literal = false;
+		for (let parent = el.parentElement; parent; parent = parent.parentElement)
+			if (parent.localName === 'pre' || parent.localName === 'code') { literal = true; break; }
+		if (literal) continue;
 		let dir = 'ltr', found = false;
 		const walker = el.ownerDocument.createTreeWalker(el, 4);
+		let scanned = 0;
 		for (let text = walker.nextNode(); text && !found; text = walker.nextNode()) {
 			for (const character of text.nodeValue || '') {
+				if (++scanned % 1024 === 0) yield;
 				const strong = _rapierBidiStrong(character.codePointAt(0));
 				if (strong) { dir = strong === 'R' ? 'rtl' : 'ltr'; found = true; break; }
 			}
@@ -826,7 +856,9 @@ function* _rapierDecorateJumpListsSteps(root) {
 		}
 	}
 
-	const only = root.children && root.children.length === 1 ? root.firstElementChild : null;
+	// Do not retain a live collection on the root that Copy will consume. Some
+	// DOM hosts eagerly refresh it on every later removal of a complete unit.
+	const first = root.firstElementChild, only = first && !first.nextElementSibling ? first : null;
 	if (only && only.tagName === 'P' && /^jump\s+to:?$/i.test(String(only.textContent || '').trim())) {
 		only.classList.add('rapier-jump-label-candidate');
 	}
@@ -849,20 +881,23 @@ function* _rapierMarkFigureCaptionsSteps(root) {
 
 function _rapierMarkListContinuations(blocks) { return finish(_rapierMarkListContinuationsSteps(blocks)); }
 
+function* _rapierChildElements(root) {
+	for (let child = root.firstElementChild; child; child = child.nextElementSibling) yield child;
+}
+
 function* _rapierMarkListContinuationsSteps(blocks) {
 	const isHeading = element => !!element && /^H[1-6]$/.test(element.tagName);
-	for (const [index, element] of blocks.entries()) { yield;
-		if (!element || element.tagName !== 'OL') continue;
+	let previous = null, headings = [], last = 0;
+	for (const element of blocks) { yield;
+		if (previous && isHeading(element)) {headings.push(element); continue;}
+		if (!element || element.tagName !== 'OL') {previous = null; headings = []; continue;}
 		const start = parseInt(element.getAttribute('start'), 10);
-		const last = (Number.isFinite(start) ? start : 1) + element.querySelectorAll(':scope > li').length - 1;
-		const headings = [];
-		let next = index + 1;
-		while (isHeading(blocks[next])) headings.push(blocks[next++]);
-		const following = blocks[next];
-		if (!headings.length || !following || following.tagName !== 'OL') continue;
-		if (parseInt(following.getAttribute('start'), 10) !== last + 1) continue;
-		element.setAttribute('data-rapier-list-continues', '');
-		for (const heading of headings) { yield;heading.setAttribute('data-rapier-list-through', '');}
+		if (previous && headings.length && start === last + 1) {
+			previous.setAttribute('data-rapier-list-continues', '');
+			for (const heading of headings) { yield;heading.setAttribute('data-rapier-list-through', '');}
+		}
+		previous = element; headings = [];
+		last = (Number.isFinite(start) ? start : 1) + element.querySelectorAll(':scope > li').length - 1;
 	}
 }
 
@@ -1031,6 +1066,11 @@ function _rapierProjectPortableRoot(semanticRoot, options) { return finish(_rapi
 async function _rapierProjectPortableRootAsync(semanticRoot, options = {}) { return finishAsync(_rapierProjectPortableRootSteps(semanticRoot, options), options.work); }
 
 function* _rapierProjectPortableRootSteps(semanticRoot, options) {
+	const root = yield* _rapierProjectPortableNodesSteps(semanticRoot, options);
+	return yield* cleanTree(root, sanitizeRapierHtml, 'export', runtime.sanitizeRapierFragment);
+}
+
+function* _rapierProjectPortableNodesSteps(semanticRoot, options) {
 	const opts = options || {};
 	// This projection is HTML-shaped (width baked into a CSS `style`, `data-*` stripped) for the
 	// consumers that read HTML -- publishing/fragment export, TXT. DOCX is not an HTML consumer: its
@@ -1040,7 +1080,9 @@ function* _rapierProjectPortableRootSteps(semanticRoot, options) {
 	// the semantic root carries them. Ordinary paragraph/list CSS measurements also reach their
 	// native reader; no derived private CSS is needed.
 	const keepLayoutData = !!opts.keepLayoutData;
-	const root = yield* cloneTree(semanticRoot), nativeElements = new Set();
+	// Copy owns its freshly rendered, detached root. Other callers retain their
+	// semantic tree and receive the usual independent portable projection.
+	const root = opts.inPlace ? semanticRoot : yield* cloneTree(semanticRoot), nativeElements = new Set();
 	// A source soft break is a reading space, never the editor's invisible token.
 	yield* _rapierResolveSoftBreakTokensSteps(root);
 	// Word consumes these source-bearing islands as pictures with TeX alternatives. Keep
@@ -1148,15 +1190,16 @@ function* _rapierProjectPortableRootSteps(semanticRoot, options) {
 		const imageLayout = element.tagName === 'IMG' ? globalThis.RapierMarkdownLayout.parseLayoutAttribute(element.getAttribute('data-rapier-image-layout')) : null;
 		const measurements = keepLayoutData && /^(?:P|H[1-6]|LI|OL|UL)$/.test(element.tagName)
 			? ['text-indent', 'margin-inline-start'].map(property => [property, element.style.getPropertyValue(property)]) : [];
+		// The native table reader admits automatic hyphenation from ordinary paragraph CSS.
+		if (keepLayoutData && element.tagName === 'P' && element.closest('table') && element.style.getPropertyValue('hyphens').trim() === 'auto')
+			measurements.push(['hyphens', 'auto']);
 		if (keepLayoutData && element.closest('pre')) for (const property of ['color', 'font-weight', 'font-style'])
 			measurements.push([property, element.style.getPropertyValue(property)]);
 		if (keepLayoutData && element.tagName === 'BLOCKQUOTE')
 			measurements.push(['border-inline-start-color', element.style.borderInlineStartColor]);
 		const runTypography = keepLayoutData ? ['font-family', 'font-variant-caps'].map(property => [property, element.style.getPropertyValue(property)]) : [];
 
-		const colorHex = element.tagName === 'SPAN' ? element.getAttribute('data-md-color') : null;
-		const fontFamily = element.tagName === 'SPAN' ? element.getAttribute('data-md-font') : null;
-		const fontCss = fontFamily ? globalThis.RapierMarkdownSpec.fontFamilyCss(fontFamily) : '';
+		const typed = globalThis.RapierMarkdownSpec.typography, typography = typed.nodeStyle(element);
 
 		const highlightHex = element.tagName === 'MARK'
 			? (RAPIER_PORTABLE_HIGHLIGHT_HEX[String(element.getAttribute('data-rapier-highlight') || '').toLowerCase()] || RAPIER_PORTABLE_HIGHLIGHT_HEX.yellow)
@@ -1167,6 +1210,10 @@ function* _rapierProjectPortableRootSteps(semanticRoot, options) {
 		const isPageBreak = element.hasAttribute('data-md-break');
 		for (const attribute of Array.from(element.attributes)) { yield;
 			const name = attribute.name.toLowerCase();
+			// Copy reads these inert words from the final admitted nodes, then removes
+			// them before emitting HTML. They grant no rendering or resource authority.
+			if (opts.heldPictures && /^(?:SPAN|IMG)$/.test(element.tagName) &&
+					(name === 'data-rapier-remote-src' || name === 'data-rapier-remote-alt')) continue;
 			if (keepLayoutData && (name === 'data-rapier-image-layout' || name === 'data-md-layout' || name === 'data-md-align' || name === 'data-rapier-ink'
 					|| name === 'data-md-first-line-end' || name === 'data-md-initial-font' || name === 'data-md-initial-size'
 					|| name === 'data-md-picture-cap-height' || name === 'data-md-picture-cap-top')) continue;
@@ -1192,10 +1239,12 @@ function* _rapierProjectPortableRootSteps(semanticRoot, options) {
 			if (imageLayout.width != null) element.removeAttribute('width');
 			if (pictureStyle) element.style.cssText = pictureStyle;
 		}
-		if (colorHex && /^#[0-9a-f]{6}$/i.test(colorHex)) element.style.color = colorHex.toLowerCase();
-		if (fontCss) element.style.fontFamily = fontCss;
 		if (highlightHex) element.style.backgroundColor = highlightHex;
 		if (isTableCaption) { element.style.fontStyle = 'italic'; element.style.color = '#555555'; }
+		// Already validated facts serialize directly. An inert host's partial CSSOM must
+		// not silently discard a quoted family or round an authored decimal.
+		const css = typed.style(typography);
+		if (css) element.setAttribute('style', (element.getAttribute('style') ? element.getAttribute('style') + ';' : '') + css);
 
 		if (isPageBreak) {
 			const p = document.createElement('p');
@@ -1210,7 +1259,7 @@ function* _rapierProjectPortableRootSteps(semanticRoot, options) {
 		literal.style.setProperty('hanging-punctuation', 'none');
 	}
 
-	return yield* cleanTree(root, sanitizeRapierHtml);
+	return root;
 }
 
 function _rapierPortableHtml(root) {
@@ -1218,6 +1267,69 @@ function _rapierPortableHtml(root) {
 }
 async function _rapierPortableHtmlAsync(root, work) { return finishAsync(serializeTree(root, sanitizeRapierHtml, true), work); }
 
+// One captured document owns this pipeline and its detached nodes. Global semantic
+// facts are resolved before projection. Final admission consumes the old tree a
+// complete fragment at a time; HTML and words then share that admitted tree.
+async function _rapierClipboardPayloadAsync(canonical, metadata, options = {}) {
+	const work = options.work;
+	let semantic;
+	const part = document.createElement('div');
+	try {
+		semantic = await _rapierRenderSemanticRootAsync(canonical, metadata, {work});
+		if (options.formatted && options.materialize && await options.materialize(semantic) === false) return null;
+		check(work);
+		await finishAsync(_rapierProjectPortableNodesSteps(semantic,
+			{baseName: options.baseName, inPlace: true, heldPictures: true}), work);
+		const words = metadata.docKind === 'markdown' ? _rapierPortableTextWriter({heldPictures: true}) : null;
+		const parts = [];
+		let pictures = false;
+		const plain = await finishAsync((function* () {
+			for (const html of htmlParts(semantic, 16384, true)) {
+				if (html === null) { yield; continue; }
+				// Reparse the complete transformed unit at the existing final export
+				// boundary. Both formats consume these admitted nodes before release.
+				admitHtml(part, html, sanitizeRapierHtml, runtime.sanitizeRapierFragment);
+				yield;
+				if (words) yield* words.write(part);
+				if (options.formatted) {
+					for (const node of part.querySelectorAll('[data-rapier-remote-src],[data-rapier-remote-alt]')) {
+						node.removeAttribute('data-rapier-remote-src'); node.removeAttribute('data-rapier-remote-alt'); yield;
+					}
+					pictures ||= !!part.querySelector('img[src^="data:"]');
+					parts.push(yield* serializeTree(part));
+				}
+				part.replaceChildren(); yield;
+			}
+			return words ? yield* words.finish() : canonical;
+		})(), work);
+		check(work);
+		if (!options.formatted) return {plain};
+		return {plain, html: parts.join('').trim(), withoutPictures: pictures ? async () => {
+			// Only this writer's finished HTML reaches this closure. On refusal,
+			// reconstruct one complete fragment, change pictures to text and admit
+			// that changed output. No full fallback DOM survives the operation.
+			return finishAsync((function* () {
+				const output = [], part = document.createElement('div');
+				try {
+					for (const html of parts) {
+						if (!html.includes('<img')) { output.push(html); yield; continue; }
+						part.innerHTML = html;
+						let changed = false;
+						for (const image of part.querySelectorAll('img[src^="data:"]')) {
+							const replacement = document.createElement('span');
+							replacement.textContent = '[image: ' + (String(image.getAttribute('alt') || 'image').trim() || 'image') + ']';
+							image.replaceWith(replacement); changed = true; yield;
+						}
+						output.push(changed ? yield* serializeTree(part, sanitizeRapierHtml) : html);
+						part.replaceChildren(); yield;
+					}
+					return output.join('').trim();
+				} finally { part.replaceChildren(); }
+			})(), work);
+		} : null};
+	} finally { semantic?.replaceChildren(); part.replaceChildren(); }
+}
+
 function _rapierNormalizeInlineText(value) {
 	return String(value || '')
 		.replace(/\u00a0/g, ' ')
@@ -1245,79 +1357,102 @@ function* _rapierHeldPicturesAsWordsSteps(root) {
 	return copy;
 }
 
-function _rapierPortableInlineText(node, options) {
+function _rapierPortableInlineText(node, options) { return finish(_rapierPortableInlineTextSteps(node, options)); }
+
+function* _rapierPortableInlineTextSteps(node, options) {
 	const opts = options || {};
 	if (!node) return '';
+	yield;
 	if (node.nodeType === Node.TEXT_NODE) return node.nodeValue || '';
 	if (node.nodeType !== Node.ELEMENT_NODE) return '';
 	const tag = node.tagName;
+	if (opts.heldPictures && /^(?:SPAN|IMG)$/.test(tag) && node.hasAttribute('data-rapier-remote-src'))
+		return _rapierPictureWords(String(node.getAttribute('data-rapier-remote-alt') || '').trim(),
+			String(node.getAttribute('data-rapier-remote-src') || '').trim());
 	if (tag === 'BR') return '\n';
 	// A task's box is what the person sees of it.
 	if (tag === 'INPUT') return /^checkbox$/i.test(node.type || '') ? (node.checked || node.hasAttribute('checked') ? '☑ ' : '☐ ') : '';
 	if (tag === 'IMG') {
 		if (opts.visible) return '';
-		const alt = String(node.getAttribute('alt') || '').trim();
-		const src = String(node.getAttribute('src') || '').trim();
-		return _rapierPictureWords(alt, src);
+		return _rapierPictureWords(String(node.getAttribute('alt') || '').trim(), String(node.getAttribute('src') || '').trim());
+	}
+	if (tag === 'CODE' && !opts.inPre) {
+		const source = String(node.textContent || '');
+		return opts.visible ? source : source ? '`' + source + '`' : '';
 	}
+	const parts = [];
+	for (let child = node.firstChild; child; child = child.nextSibling) parts.push(yield* _rapierPortableInlineTextSteps(child, opts));
+	const text = parts.join('');
 	if (tag === 'A') {
-		const label = _rapierNormalizeInlineText(Array.from(node.childNodes)
-			.map(child => _rapierPortableInlineText(child, opts)).join(''));
-		const href = String(node.getAttribute('href') || '').trim();
+		const label = _rapierNormalizeInlineText(text), href = String(node.getAttribute('href') || '').trim();
 		if (opts.visible || !href || href.charAt(0) === '#') return label;
 		if (!label || label === href) return href;
 		return label + ' (' + href + ')';
 	}
-	if (tag === 'CODE' && !opts.inPre) {
-		const source = String(node.textContent || '');
-		return opts.visible ? source : source ? '`' + source + '`' : '';
-	}
-	return Array.from(node.childNodes)
-		.map(child => _rapierPortableInlineText(child, opts)).join('');
+	return text;
 }
 
-function _rapierPortableListText(list, depth, options) {
-	const opts = options || {};
-	const level = Math.max(0, depth | 0);
-	const ordered = list.tagName === 'OL';
+function _rapierPortableListText(list, depth, options) { return finish(_rapierPortableListTextSteps(list, depth, options)); }
+
+function* _rapierPortableListTextSteps(list, depth, options) {
+	const opts = options || {}, level = Math.max(0, depth | 0), ordered = list.tagName === 'OL';
 	let counter = ordered ? (parseInt(list.getAttribute('start'), 10) || 1) : 0;
 	const lines = [];
-	Array.from(list.children).filter(child => child.tagName === 'LI').forEach(item => {
-		const nested = Array.from(item.children).filter(child => child.tagName === 'UL' || child.tagName === 'OL');
-		const content = Array.from(item.childNodes)
-			.filter(child => !(child.nodeType === Node.ELEMENT_NODE && (child.tagName === 'UL' || child.tagName === 'OL')))
-			.map(child => _rapierPortableInlineText(child, opts)).join('');
-		const normalized = _rapierNormalizeInlineText(content);
-		const indent = '  '.repeat(level);
+	for (let item = list.firstElementChild; item; item = item.nextElementSibling) {
+		yield;
+		if (item.tagName !== 'LI') continue;
+		const nested = [], content = [];
+		for (let child = item.firstChild; child; child = child.nextSibling) {
+			if (child.nodeType === Node.ELEMENT_NODE && (child.tagName === 'UL' || child.tagName === 'OL')) nested.push(child);
+			else content.push(yield* _rapierPortableInlineTextSteps(child, opts));
+		}
+		const normalized = _rapierNormalizeInlineText(content.join('')), indent = '  '.repeat(level);
 		// A task shows its box where a bullet would be.
 		const marker = /^[☐☑☒]/.test(normalized) ? '' : ordered ? (counter++) + '. ' : '• ';
-		const parts = (normalized || '').split('\n');
+		const parts = normalized.split('\n');
 		lines.push(indent + marker + (parts.shift() || ''));
-		parts.forEach(part => lines.push(indent + '  ' + part));
-		nested.forEach(child => {
-			const nestedText = _rapierPortableListText(child, level + 1, opts);
-			if (nestedText) lines.push(nestedText);
-		});
-	});
+		for (const part of parts) { lines.push(indent + '  ' + part); yield; }
+		for (const child of nested) {
+			const text = yield* _rapierPortableListTextSteps(child, level + 1, opts);
+			if (text) lines.push(text);
+		}
+	}
 	return lines.join('\n');
 }
 
 // A table, or a part of one a selection clipped out (a head, a body, a row): its rows.
-function _rapierPortableTableText(table, options) {
-	const opts = options || {};
-	const rows = table.tagName === 'TR' ? [table] : Array.from(table.querySelectorAll('tr'));
-	return rows.map(row => {
-		return Array.from(row.children)
-			.filter(cell => cell.tagName === 'TH' || cell.tagName === 'TD')
-			.map(cell => _rapierNormalizeInlineText(_rapierPortableInlineText(cell, opts)))
-			.join(opts.visible ? '\t' : ' | ');
-	}).filter(Boolean).join('\n');
+function _rapierPortableTableText(table, options) { return finish(_rapierPortableTableTextSteps(table, options)); }
+
+function* _rapierPortableTableTextSteps(table, options) {
+	const opts = options || {}, rows = [];
+	const walker = document.createTreeWalker(table, 1 /* SHOW_ELEMENT */);
+	let row = table.tagName === 'TR' ? table : walker.nextNode();
+	while (row) {
+		yield;
+		if (row.tagName === 'TR') {
+			const cells = [];
+			for (let cell = row.firstElementChild; cell; cell = cell.nextElementSibling) {
+				if (cell.tagName === 'TH' || cell.tagName === 'TD')
+					cells.push(_rapierNormalizeInlineText(yield* _rapierPortableInlineTextSteps(cell, opts)));
+			}
+			const text = cells.join(opts.visible ? '\t' : ' | ');
+			if (text) rows.push(text);
+		}
+		row = table.tagName === 'TR' ? null : walker.nextNode();
+	}
+	return rows.join('\n');
 }
 
 function _rapierPortablePlainText(root, options) { return finish(_rapierPortablePlainTextSteps(root, options)); }
 async function _rapierPortablePlainTextAsync(root, options = {}) { return finishAsync(_rapierPortablePlainTextSteps(root, options), options.work); }
 
 function* _rapierPortablePlainTextSteps(root, options) {
+	const writer = _rapierPortableTextWriter(options);
+	yield* writer.write(root);
+	return yield* writer.finish();
+}
+
+function _rapierPortableTextWriter(options) {
 	const opts = options || {};
 	const blocks = [];
 	const blockTags = new Set([
@@ -1332,49 +1467,48 @@ function* _rapierPortablePlainTextSteps(root, options) {
 		if (value) blocks.push({ text: value, preserve: !!preserve });
 	};
 
-	const collectChildren = function* (parent) {
-		let inline = [];
-		const flush = () => {
-			if (!inline.length) return;
-			pushBlock(_rapierNormalizeInlineText(inline.map(node => _rapierPortableInlineText(node, opts)).join('')), false);
-			inline = [];
-		};
+	const state = () => ({inline: [], table: null});
+	const flush = current => {
+		if (current.inline.length) {
+			pushBlock(_rapierNormalizeInlineText(current.inline.join('')), false);
+			current.inline = [];
+		}
+		if (current.table) {
+			pushBlock(current.table.filter(Boolean).join('\n'), false);
+			current.table = null;
+		}
+	};
+	const collectChildren = function* (parent, current = state(), complete = true) {
 		const tablePart = node => node.nodeType === Node.ELEMENT_NODE && /^(THEAD|TBODY|TFOOT|TR)$/.test(node.tagName);
 		const blankText = node => node.nodeType === Node.TEXT_NODE && !String(node.nodeValue || '').trim();
-		const children = Array.from(parent.childNodes);
-		const inTableRun = index => { for (let at = index - 1; at >= 0; at--) { if (!blankText(children[at])) return tablePart(children[at]); } return false; };
-		for (const [index, child] of children.entries()) {
+		for (let child = parent.firstChild; child; child = child.nextSibling) {
 			yield;
 			if (tablePart(child)) {
-				// The parts of a table a selection clipped out of it: one block of rows, whichever parts arrived.
-				if (inTableRun(index)) continue;
-				flush();
-				const parts = [];
-				for (let at = index; at < children.length && (tablePart(children[at]) || blankText(children[at])); at++) {
-					if (tablePart(children[at])) parts.push(_rapierPortableTableText(children[at], opts));
-				}
-				pushBlock(parts.filter(Boolean).join('\n'), false);
-			} else if (blankText(child) && inTableRun(index)) {
+				// A clipped table can cross an output fragment. Retain its words,
+				// not detached rows, until the next non-table node closes the block.
+				if (!current.table) { flush(current); current.table = []; }
+				current.table.push(yield* _rapierPortableTableTextSteps(child, opts));
 				continue;
-			} else if (child.nodeType === Node.ELEMENT_NODE && blockTags.has(child.tagName)) {
-				flush();
+			}
+			if (current.table && blankText(child)) continue;
+			if (current.table) flush(current);
+			if (child.nodeType === Node.ELEMENT_NODE && blockTags.has(child.tagName)) {
+				flush(current);
 				yield* collectBlock(child);
 			} else if (opts.visible && child.nodeType === Node.ELEMENT_NODE && child.tagName === 'CODE' && String(child.textContent || '').includes('\n')) {
-				// Lines of a code block taken without their block: the code as shown, every space kept.
-				flush();
+				// Lines clipped from a code block retain every authored space.
+				flush(current);
 				pushBlock(String(child.textContent || ''), true);
-			} else {
-				inline.push(child);
-			}
+			} else current.inline.push(yield* _rapierPortableInlineTextSteps(child, opts));
 		}
-		flush();
+		if (complete) flush(current);
 	};
 
 	const collectBlock = function* (node) {
 		if (!node || node.nodeType !== Node.ELEMENT_NODE) return;
 		const tag = node.tagName;
 		if (/^H[1-6]$/.test(tag) || tag === 'P') {
-			const text = _rapierNormalizeInlineText(_rapierPortableInlineText(node, opts));
+			const text = _rapierNormalizeInlineText(yield* _rapierPortableInlineTextSteps(node, opts));
 			// An empty paragraph (the line Enter makes) is a line of its own, as it is in Word's plain text: one newline more between its neighbours.
 			if (tag === 'P' && !text && node.childNodes.length && !node.hasAttribute('data-md-break')) blocks.push({ text: '', blank: true });
 			else pushBlock(text, false);
@@ -1391,11 +1525,11 @@ function* _rapierPortablePlainTextSteps(root, options) {
 			return;
 		}
 		if (tag === 'UL' || tag === 'OL') {
-			pushBlock(_rapierPortableListText(node, 0, opts), false);
+			pushBlock(yield* _rapierPortableListTextSteps(node, 0, opts), false);
 			return;
 		}
 		if (tag === 'TABLE') {
-			pushBlock(_rapierPortableTableText(node, opts), false);
+			pushBlock(yield* _rapierPortableTableTextSteps(node, opts), false);
 			return;
 		}
 		if (tag === 'BLOCKQUOTE') {
@@ -1409,10 +1543,10 @@ function* _rapierPortablePlainTextSteps(root, options) {
 			const children = Array.from(node.children);
 			for (let i = 0; i < children.length; i++) {
 				if (children[i].tagName !== 'DT') continue;
-				const term = _rapierNormalizeInlineText(_rapierPortableInlineText(children[i], opts));
+				const term = _rapierNormalizeInlineText(yield* _rapierPortableInlineTextSteps(children[i], opts));
 				const defs = [];
 				while (children[i + 1] && children[i + 1].tagName === 'DD') {
-					defs.push(_rapierNormalizeInlineText(_rapierPortableInlineText(children[++i], opts)));
+					defs.push(_rapierNormalizeInlineText(yield* _rapierPortableInlineTextSteps(children[++i], opts)));
 				}
 				pushBlock(term + (defs.length ? ' — ' + defs.join('\n  ') : ''), false);
 			}
@@ -1420,14 +1554,16 @@ function* _rapierPortablePlainTextSteps(root, options) {
 		}
 		if (tag === 'DETAILS') {
 			const summary = node.querySelector(':scope > summary');
-			if (summary) pushBlock(_rapierNormalizeInlineText(_rapierPortableInlineText(summary, opts)), false);
+			if (summary) pushBlock(_rapierNormalizeInlineText(yield* _rapierPortableInlineTextSteps(summary, opts)), false);
 			for (const child of node.children) if (child !== summary) { yield; yield* collectBlock(child); }
 			return;
 		}
 		yield* collectChildren(node);
 	};
 
-	yield* collectChildren(root);
+	const pending = state();
+	return {write: root => collectChildren(root, pending, false), finish: function* () {
+	flush(pending);
 	// Each block stands a blank line from the next, and each empty paragraph between them adds one newline more.
 	let joined = '', blanks = 0;
 	for (const block of blocks) {
@@ -1438,6 +1574,7 @@ function* _rapierPortablePlainTextSteps(root, options) {
 	}
 	const text = joined.trim();
 	return opts.finalNewline && text ? text + '\n' : text;
+	}};
 }
 
 // The text file Export writes: a Markdown document's portable words and one final newline, any other document's own text.
@@ -1490,7 +1627,7 @@ function _rapierBidiStrong(cp) {
 	return null;
 }
 
-  return {_rapierPlainTextFileAsync, _rapierCloneRootAsync, _rapierPortablePlainTextAsync, _rapierHeldPicturesAsWordsAsync, _rapierRenderSemanticRootAsync, _rapierProjectPortableRootAsync, _rapierPortableHtmlAsync, _rapierCalloutInfo, _rapierRemoveCalloutMarker, _rapierMathSource, _rapierFlattenPortableDetails, _rapierProjectPortableRoot, _rapierPortableHtml, _rapierNormalizeInlineText, _rapierPortableInlineText, _rapierPortableListText, _rapierPortableTableText, _rapierPortablePlainText, _rapierPlainTextFile, _rapierHeldPicturesAsWords, _rapierSourceTokenValue, _rapierResolveSoftBreakTokens, _rapierUnwrapElement, _rapierBidiStrong, render: (source, metadata = {}) => { if (!md) initMarkdownIt(); return _rapierRenderSemanticRoot(source, metadata).innerHTML; }, initMarkdownIt, _rapierRenderSemanticRoot, _rapierInstallSemanticProbe, _rapierImageAltSize, _rapierImageAltSourceParts, _rapierImageAltText, _rapierImageSizeAttributes, _rapierRawHtmlFragment, _rapierApplyBlockDirection, _rapierFirstStrongDir, _rapierAssignHeadingSlugs, _rapierDisambiguateRenderedAnchors, _rapierDecodeHash, _rapierDecorateJumpLists, _rapierMarkFigureCaptions, _rapierMarkListContinuations, _rapierMarkTableCaptions, _rapierNormalizeCodeElement, _rapierLanguageClass, _relabelFootnoteHtml, _footnoteIdFromLabel, wrapDisplayMath, parser: () => md};
+  return {_rapierClipboardPayloadAsync, _rapierPlainTextFileAsync, _rapierCloneRootAsync, _rapierPortablePlainTextAsync, _rapierHeldPicturesAsWordsAsync, _rapierRenderSemanticRootAsync, _rapierProjectPortableRootAsync, _rapierPortableHtmlAsync, _rapierCalloutInfo, _rapierRemoveCalloutMarker, _rapierMathSource, _rapierFlattenPortableDetails, _rapierProjectPortableRoot, _rapierPortableHtml, _rapierNormalizeInlineText, _rapierPortableInlineText, _rapierPortableListText, _rapierPortableTableText, _rapierPortablePlainText, _rapierPlainTextFile, _rapierHeldPicturesAsWords, _rapierSourceTokenValue, _rapierResolveSoftBreakTokens, _rapierUnwrapElement, _rapierBidiStrong, render: (source, metadata = {}) => { if (!md) initMarkdownIt(); return _rapierRenderSemanticRoot(source, metadata).innerHTML; }, initMarkdownIt, _rapierRenderSemanticRoot, _rapierInstallSemanticProbe, _rapierImageAltSize, _rapierImageAltSourceParts, _rapierImageAltText, _rapierImageSizeAttributes, _rapierRawHtmlFragment, _rapierApplyBlockDirection, _rapierFirstStrongDir, _rapierAssignHeadingSlugs, _rapierDisambiguateRenderedAnchors, _rapierDecodeHash, _rapierDecorateJumpLists, _rapierMarkFigureCaptions, _rapierMarkListContinuations, _rapierMarkTableCaptions, _rapierNormalizeCodeElement, _rapierLanguageClass, _relabelFootnoteHtml, _footnoteIdFromLabel, wrapDisplayMath, parser: () => md};
 }
 export {RAPIER_TABLE_CAPTION_PREFIX_RE as tableCaptionPrefix, RAPIER_PORTABLE_HIGHLIGHT_HEX as portableHighlightHex, _RAPIER_RTL_SCRIPT as rtlScripts, createMarkdownRenderer};