rapier-markdown-kit 1.1.102 → 1.2.3

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 {htmlPlaceholder, mountHtmlBlocks, materializeObjects, objectPosterLabel, htmlImageRecord, htmlLayoutEdit, htmlModeEdit, mergeHtmlObjectBlocks} from '../spec/html-blocks.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,30 @@ 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>';
+	md.renderer.rules.rapier_typography_open = renderTypography;
+	md.renderer.rules.rapier_typography_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.
@@ -128,8 +136,8 @@ function initMarkdownIt() {
 		const asset = globalThis.RapierImageAssets.dataImage(src), reference = token.meta?.mdImage?.reference;
 		// A connected host's own asset; a host without one (the server) supplies no port.
 		if (!env.rapierPage && typeof globalThis.RapierEmbeddedImages?.imageHtml === 'function' &&
-			(_rapierEmbedAssetSource?.(src) || asset && (reference || asset.codec === 'image/jxl' || asset.codec === 'image/svg+xml'))) return globalThis.RapierEmbeddedImages.imageHtml(
-			reference, alt, title, size, layout, rawAlt, token.meta?.mdImage?.source, src);
+			(_rapierEmbedAssetSource?.(src) || asset && (reference || asset.codec === 'image/jxl' || asset.codec === 'image/gif' || asset.codec === 'image/svg+xml'))) return globalThis.RapierEmbeddedImages.imageHtml(
+			reference, alt, title, size, layout, rawAlt, token.meta?.mdImage?.source, src, env.rapierImagePresentation !== false);
 		const drawingAlt = typeof rawAlt === 'string' && alt === '' && asset?.codec === 'image/svg+xml' ? globalThis.RapierImageAssets.drawingImageAlt(src) : null;
 		const shownAlt = drawingAlt ?? alt;
 		let loadable = false;
@@ -148,19 +156,28 @@ function initMarkdownIt() {
 			return html.replace('<span ', '<span data-rapier-markdown-image="" ' +
 				(token.meta?.mdImage?.source ? 'data-rapier-image-source="' + md.utils.escapeHtml(encodeURIComponent(token.meta.mdImage.source)) + '" ' : ''));
 		}
+		let animation = null;
+		try {animation = globalThis.RapierImageAssets.imageAnimation?.(src);} catch (_) {}
 		const attrs = [
 			'data-rapier-markdown-image=""',
-			'src="' + md.utils.escapeHtml(src) + '"',
+			'src="' + md.utils.escapeHtml(animation?.first || src) + '"',
 			'alt="' + md.utils.escapeHtml(shownAlt) + '"',
 			'loading="lazy"',
 			'decoding="async"',
 		];
+		if (animation) attrs.push('data-rapier-animation="' + md.utils.escapeHtml(src) + '"',
+			'data-rapier-natural-width="' + animation.width + '"', 'data-rapier-natural-height="' + animation.height + '"');
 		if (token.meta?.mdImage?.source && token.meta.mdImage.source.length <= 4096)
 			attrs.push('data-rapier-image-source="' + md.utils.escapeHtml(encodeURIComponent(token.meta.mdImage.source)) + '"');
 		if (title) attrs.push('title="' + md.utils.escapeHtml(title) + '"');
 		if (shownAlt !== alt || size && !token.meta?.mdLayout?.layout?.width) attrs.push('data-rapier-image-alt-source="' + md.utils.escapeHtml(rawAlt) + '"');
 		if (layout) attrs.push('data-rapier-image-layout="' + md.utils.escapeHtml(encodeURIComponent(layout)) + '"');
-		return '<img ' + attrs.join(' ') + _rapierImageSizeAttributes(size, layout) + '>';
+		// Portable semantic consumers keep their existing native image attributes. Only
+		// live editor/reader presentation needs provisional geometry and its load consumer.
+		if (env.rapierImagePresentation === false) return '<img ' + attrs.join(' ') + _rapierImageSizeAttributes(size, layout) + '>';
+		const geometry = !env.rapierPage && globalThis.RapierEmbeddedImages?.geometry
+			? globalThis.RapierEmbeddedImages.geometry(src) : globalThis.RapierImageAssets.imagePlaceholderDimensions(src);
+		return '<img ' + attrs.join(' ') + _rapierImageSizeAttributes(size, layout, geometry || {}) + '>';
 	};
 
 	md.renderer.rules.hr = function (tokens, idx) {
@@ -176,7 +193,9 @@ function initMarkdownIt() {
 	// markup reaches DOMPurify: sanitizing each HTML token closes containers before their body.
 	// The harness runs this installer alone for the parser's acceptance; without the page's sanitizer the tokens pass.
 	const inPage = typeof sanitizeRapierHtml === 'function' && typeof _rapierChromeOwnsId === 'function';
-	const rawAttribute = /\s+([A-Za-z_:][A-Za-z0-9_.:-]*)(?:\s*=\s*("[^"]*"|'[^']*'|[^"'=<>`\s]+))?/g;
+	// HTML separates attributes and ends an unquoted value only at ASCII whitespace: JavaScript's \s also takes U+00A0,
+	// which would read a quoted value the browser never sees and keep the attributes hidden inside it.
+	const rawAttribute = /[\t\n\f\r ]+([A-Za-z_:][A-Za-z0-9_.:-]*)(?:[\t\n\f\r ]*=[\t\n\f\r ]*("[^"]*"|'[^']*'|[^"'=<>`\t\n\f\r ]+))?/g;
 	// The id is read as HTML reads it: a numeric character reference (`&#115;ource-textarea` is `source-textarea`,
 	// `&#x73;` the same) and the named references that spell a character an id can hold are decoded before the
 	// chrome's ids are asked; every other name stays literal (no named reference spells a letter, a digit or a
@@ -186,7 +205,7 @@ function initMarkdownIt() {
 		equals: '=', comma: ',', lpar: '(', rpar: ')', lsqb: '[', lbrack: '[', rsqb: ']', rbrack: ']', lcub: '{', lbrace: '{',
 		rcub: '}', rbrace: '}', verbar: '|', vert: '|', VerticalLine: '|', bsol: '\\', Hat: '^', grave: '`', DiacriticalGrave: '`', Tab: '\t', NewLine: '\n' };
 	const attributeText = value => String(value || '').replace(/^["']|["']$/g, '')
-		.replace(/&(?:#(\d{1,7})|#[xX]([0-9a-fA-F]{1,6})|([A-Za-z][A-Za-z0-9]{0,31}));?/g, (whole, dec, hex, name) => {
+		.replace(/&(?:#(\d+)|#[xX]([0-9a-fA-F]+)|([A-Za-z][A-Za-z0-9]{0,31}));?/g, (whole, dec, hex, name) => {
 			const code = dec ? Number(dec) : hex ? parseInt(hex, 16) : -1;
 			if (code >= 0) return code > 0 && code <= 0x10ffff ? String.fromCodePoint(code) : '\ufffd';
 			return Object.hasOwn(RAW_ID_NAMED, name) ? RAW_ID_NAMED[name] : whole;
@@ -195,12 +214,23 @@ 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);
-		md.renderer.rules.html_block = (tokens, idx, _options, env) => _rapierRawHtmlFragment(tokens[idx].content,
-			tag => env?.rapierDocumentSpace ? cleanTag(tag).replace(/^<([A-Za-z][A-Za-z0-9:-]*)(?=[\s/>])/, '<$1 data-md-html-block="' + idx + '"') : cleanTag(tag), md);
+		md.renderer.rules.html_block = (tokens, idx) => _rapierRawHtmlFragment(tokens[idx].content, cleanTag, md);
 	}
+	// A highlight written in one of the picker's colours is that swatch, as `==🟢x==` is, and follows the theme.
+	const inlineHtml = md.renderer.rules.html_inline || ((tokens, idx) => tokens[idx].content);
+	md.renderer.rules.html_inline = (tokens, idx, ...rest) => {
+		const swatch = /^<mark style="background-color:(#[0-9a-f]{6});?">$/i.exec(tokens[idx].content);
+		const colour = swatch && Object.keys(RAPIER_PORTABLE_HIGHLIGHT_HEX).find(name => RAPIER_PORTABLE_HIGHLIGHT_HEX[name] === swatch[1].toLowerCase());
+		return colour ? '<mark data-rapier-highlight="' + colour + '">' : inlineHtml(tokens, idx, ...rest);
+	};
 
 	const _ulOpenDefault = md.renderer.rules.bullet_list_open
 		|| function (tokens, idx, opts, _env, self) { return self.renderToken(tokens, idx, opts); };
@@ -293,8 +323,7 @@ function initMarkdownIt() {
 					'</code> fence. Text below is still inside the block.</p>' + sourceHtml + '</figure>\n';
 			}
 			const provider = env.rapierProviders === false ? null : _rapierProviders.mermaid;
-			const native = globalThis.RapierFlowchart?.parseFlowchart(src).ok === true ||
-				provider?.status === 'ready' && globalThis.RapierDiagrams?.parseDiagram(src).ok === true;
+			const native = globalThis.RapierFlowchart?.parseFlowchart(src).ok === true;
 			const ready = native || !!(provider && provider.status === 'ready' && typeof provider.renderToString === 'function');
 			if (!ready && env.rapierProviders !== false && !_diagramPromptedOnce) {
 				_diagramPromptedOnce = true;
@@ -331,9 +360,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') {
@@ -345,14 +374,36 @@ function initMarkdownIt() {
 						 + literal + '</span>';
 			}
 			try {
-				const rendered = mathProvider.renderToString(src, { displayMode });
+				// The explicit output-only call keeps structured results beside the unchanged SVG
+				// islands. MathML never enters editable text projections or source serialization.
+				let rendered;
+				if (env.rapierMathEquations) {
+					const combined = mathProvider.renderWithMathML(src, {displayMode});
+					if (!combined || typeof combined.svg !== 'string' || !combined.semantics ||
+						typeof combined.semantics !== 'object' || Array.isArray(combined.semantics) || !Array.isArray(combined.errors))
+						throw new TypeError('The Rapier Math shared result is invalid.');
+					rendered = combined.svg;
+					env.rapierMathEquations.push({source, tex: src, displayMode,
+						semantics: combined.semantics, errors: combined.errors});
+				} else rendered = mathProvider.renderToString(src, {displayMode});
+				let encoded;
+				try { encoded = encodeURIComponent(source); }
+				catch (error) {
+					// An ill-formed UTF-16 source cannot enter the URI-encoded edit marker.
+					// Keep the ordinary source-only HTML and the collected refusal diagnostic.
+					if (!(error instanceof URIError)) throw error;
+					return '<span data-rapier-math-source="">' + literal + '</span>';
+				}
 				return '<span class="math-rendered" data-math-src="'
-						 + encodeURIComponent(source) + '">' + rendered + '</span>';
+						 + encoded + '">' + rendered + '</span>';
+			}
+			catch (error) {
+				if (env.rapierMathEquations) throw error;
+				return '<span data-rapier-math-source="">' + literal + '</span>';
 			}
-			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);
@@ -378,9 +429,10 @@ function _rapierRenderSemanticRoot(canonical, metadata, options = {}) {
 	const markdown = _rapierSplitOpeningFrontmatter(canonical).body;
 	// Source-semantic output is independent of installed rendering providers. Complete
 	// artifacts keep the default provider path and materialize their visual content.
-	const env = {...(options.page ? {rapierPage: true} : {}), ...(options.providers === false ? {rapierProviders: false} : {})};
-	env.rapierDocumentSpace = !!globalThis.RapierMarkdownSpec?.readDocumentSettings?.(canonical)?.space;
-	if (env.rapierDocumentSpace) root.setAttribute('data-md-space', '');
+	// A portable projection keeps natural sizing. Live readers opt into the same transient
+	// AUTO policy as the editor; neither a saved page nor its source inherits that choice.
+	const env = {rapierImagePresentation: options.imagePresentation === true, ...(options.page ? {rapierPage: true} : {}), ...(options.providers === false ? {rapierProviders: false} : {})};
+	if (options.mathEquations) env.rapierMathEquations = options.mathEquations;
 	let rendered = md
 		? md.render(markdown, env)
 		: '<pre><code>' + escapeRapierHtmlText(markdown) + '</code></pre>';
@@ -398,7 +450,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 +465,21 @@ 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))));
-	env.rapierDocumentSpace = !!globalThis.RapierMarkdownSpec?.readDocumentSettings?.(canonical)?.space;
+	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))));
+	env = {...env, rapierImagePresentation: options.imagePresentation === true};
+	await pause(work, .3);
 	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 +492,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 +510,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;
 }
 
@@ -630,16 +689,81 @@ function _rapierImageAltText(value, env = {}) {
 	return md.renderer.renderInlineAsText(tokens[0]?.children || [], md.options, env);
 }
 
-function _rapierImageSizeAttributes(size, marker) {
+// Intrinsic facts are a presentation input, never an authored width or a resource admission.
+// Contain both edges within the column, sharing a 1.6-column sum-of-edges budget.
+// Reciprocal portraits/landscapes have equal weight; the native-width cap never enlarges art.
+function _rapierImageGeometryFacts(geometry, automatic) {
+    const w = Number(geometry?.width), h = Number(geometry?.height);
+    const known = Number.isFinite(w) && Number.isFinite(h) && w > 0 && h > 0 && Number.isFinite(w / h) && w / h > 0;
+    const width = known ? w : 0, height = known ? h : 0;
+    const styles = known ? [['aspect-ratio', width + '/' + height]] : automatic ? [['aspect-ratio', '1/1']] : [];
+    if (automatic) {
+        const ratio = known ? width / height : 1;
+        const share = Math.min(1, ratio, 1.6 / (1 + 1 / ratio));
+        styles.push(['--rapier-image-auto-width', Number((share * 100).toFixed(6)) + '%'],
+            ['--rapier-image-natural-width', known ? width + 'px' : '100%']);
+    }
+    return {width, height, styles};
+}
+
+// Native loads supply their current element's dimensions synchronously. Embedded images
+// supply an admitted row only after their existing document/resource ticket checks.
+function _rapierApplyImageGeometry(image, geometry) {
+    if (image?.tagName !== 'IMG' || image.hasAttribute('data-rapier-html')) return false;
+    const mode = image.getAttribute('data-rapier-image-geometry');
+    if (!['auto', 'sized', 'natural'].includes(mode)) return false;
+    const native = geometry === undefined;
+    if (native) {
+        if (!image.isConnected || !image.complete || image.hasAttribute('data-rapier-asset') || image.hasAttribute('data-rapier-image-url')) return false;
+        geometry = {width: image.naturalWidth, height: image.naturalHeight};
+    }
+    const facts = _rapierImageGeometryFacts(geometry, mode === 'auto');
+    if (!facts.width || !facts.height) return false;
+    const attributes = [
+        ['data-rapier-natural-width', String(facts.width)], ['data-rapier-natural-height', String(facts.height)],
+        ...(!image.hasAttribute('data-rapier-image-size') ? [['width', String(facts.width)]] : []), ['height', String(facts.height)],
+    ].filter(([name, value]) => image.getAttribute(name) !== value);
+    const styles = facts.styles.filter(([name, value]) => (name === 'aspect-ratio'
+        ? image.style.getPropertyValue(name).replace(/\s/g, '') : image.style.getPropertyValue(name)) !== value);
+    // Ordinary mutations revisit mounted images. Settled facts need no source-URL
+    // read or parse (which can be the entire inline image), nor any DOM writes.
+    if (!attributes.length && !styles.length) return false;
+    if (native) {
+        const src = image.getAttribute('src'), current = image.currentSrc;
+        if (!src || !current) return false;
+        try { if (src !== current && new URL(src, image.ownerDocument.baseURI).href !== current) return false; }
+        catch (_) { return false; }
+    }
+    for (const [name, value] of attributes) image.setAttribute(name, value);
+    for (const [name, value] of styles) image.style.setProperty(name, value);
+    return true;
+}
+
+function _rapierImageSizeAttributes(size, marker, geometry, automatic = true) {
     const layout = globalThis.RapierMarkdownLayout.parseLayout(marker || '');
     // Plain (rung 0, docs/standard-adoption.md): every picture renders at its natural width, the
     // same as a reader with no layout facts at all -- Obsidian's `![alt|N]` alt-text width (the
     // `size` fallback below) is a different, established convention and is unaffected.
-    const style = layout && !_rapierPlainLayout() ? globalThis.RapierMarkdownLayout.imageStyle(layout) : '';
-    if (layout?.width != null && style) return ' data-md-image-width="' + layout.width + '" style="' + style + '"';
+    let style = layout && !_rapierPlainLayout() ? globalThis.RapierMarkdownLayout.imageStyle(layout) : '';
+    let attributes = '';
+    if (layout?.width != null && style) attributes = ' data-md-image-width="' + layout.width + '"';
     // A fade rides beside any width, the alt-text's own included.
-    return size ? ' width="' + size.width + '" data-rapier-image-size="' + size.width +
-        '" style="--md-image-width:' + size.width + 'px' + (style ? ';' + style : '') + '"' : style ? ' style="' + style + '"' : '';
+    else if (size) {
+        attributes = ' width="' + size.width + '" data-rapier-image-size="' + size.width + '"';
+        style = '--md-image-width:' + size.width + 'px' + (style ? ';' + style : '');
+    }
+    if (geometry !== undefined) {
+        const mode = size || layout?.width != null || layout?.lines != null ? 'sized' : automatic ? 'auto' : 'natural';
+        const facts = _rapierImageGeometryFacts(geometry, mode === 'auto');
+        attributes += ' data-rapier-image-geometry="' + mode + '"';
+        if (facts.width) {
+            attributes += ' data-rapier-natural-width="' + facts.width + '" data-rapier-natural-height="' + facts.height + '"';
+            if (!size || !attributes.includes(' width=')) attributes += ' width="' + facts.width + '"';
+            attributes += ' height="' + facts.height + '"';
+        }
+        style = [...facts.styles.map(([name, value]) => name + ':' + value), ...(style ? [style] : [])].join(';');
+    }
+    return attributes + (style ? ' style="' + style + '"' : '');
 }
 
 function _rapierRawHtmlFragment(source, rewrite, parser) {
@@ -660,13 +784,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 +957,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 +982,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 +1167,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 +1181,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 +1291,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,9 +1311,14 @@ 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;
+					|| name === 'data-md-picture-cap-height' || name === 'data-md-picture-cap-top' || name === 'data-rapier-highlight' || name === 'data-rapier-animation'
+					|| name === 'data-rapier-list-ordinal' || name === 'data-rapier-list-delimiter' || name === 'data-md-layout-tight')) continue;
 			if (name === 'class' || name === 'style' || name.startsWith('data-')
 					|| name === 'contenteditable' || name === 'spellcheck'
 					|| name === 'tabindex' || name === 'disabled' || name === 'aria-disabled') {
@@ -1192,10 +1341,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 +1361,7 @@ function* _rapierProjectPortableRootSteps(semanticRoot, options) {
 		literal.style.setProperty('hanging-punctuation', 'none');
 	}
 
-	return yield* cleanTree(root, sanitizeRapierHtml);
+	return root;
 }
 
 function _rapierPortableHtml(root) {
@@ -1218,6 +1369,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 +1459,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 +1569,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 +1627,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 +1645,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 +1656,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 +1676,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,8 +1729,21 @@ 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};
+// A consuming operation, not an editable DOM mode. Both outputs share one admitted
+// parse per equation; callers decide whether and how to expose the MathML to people.
+function renderWithMathML(source, metadata = {}) {
+	const provider = _rapierProviders.math;
+	if (!provider || provider.status !== 'ready' || typeof provider.renderToString !== 'function' ||
+		typeof provider.renderWithMathML !== 'function')
+		throw new Error('The Rapier Math shared-result renderer is unavailable.');
+	if (!md) initMarkdownIt();
+	const equations = [];
+	const html = _rapierRenderSemanticRoot(source, metadata, {mathEquations: equations}).innerHTML;
+	return {html, equations};
+}
+
+  return {renderWithMathML, _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, _rapierApplyImageGeometry, _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};
 
-export {mountHtmlBlocks, htmlImageRecord, htmlLayoutEdit};
+export {mountHtmlBlocks, materializeObjects, objectPosterLabel, htmlImageRecord, htmlLayoutEdit, htmlModeEdit, mergeHtmlObjectBlocks};