rapier-markdown-kit 1.1.99 → 1.1.102

package/dist/kit/render-print.mjs

@@ -1,4 +1,10 @@
 // SPDX-License-Identifier: MIT
+import {collectPdfVectors} from './pdf-vectors.mjs';
+import {collectPdfGlyphs} from './pdf-glyphs.mjs';
+import {fontRequests, waitForFonts} from './export-fonts.mjs';
+import {apply as applyTypography} from '../layout/typography.mjs';
+import {documentLanguage} from '../spec/document-settings.mjs';
+import {applyPrintCapitals} from './print-capitals.mjs';
 const RAPIER_WILL_SENTINEL_MARK = '⁣';
 // SPDX-License-Identifier: MIT
 // The document's renderer. DOM, codecs and host state are explicit inputs.
@@ -64,7 +70,10 @@ function _rapierPrintWillFont(markers) {
 	const cmap = narrow.length <= 0xffff
 		? cat(u16(0), u16(2), u16(3), u16(1), u32(20), u16(3), u16(10), u32(20 + narrow.length), narrow, full)
 		: cat(u16(0), u16(1), u16(3), u16(10), u32(12), full);
-	const outline = cat(u16(1), u16(0), u16(-2), u16(10), u16(2), u16(2), u16(0), [1, 1, 1], u16(0), u16(10), u16(-5), u16(-2), u16(4), u16(-2), [0]);
+	// The collinear contour has zero area and enough bounds for native print at 2px.
+	// Keep it below the baseline so a carrier at a page break does not straddle both page clips.
+	const bounds = [0, -400, 10, 0];
+	const outline = cat(u16(1), bounds.map(u16), u16(2), u16(0), [1, 1, 1], u16(0), u16(10), u16(-5), u16(bounds[1]), u16(bounds[3] - bounds[1]), u16((bounds[1] - bounds[3]) / 2), [0]);
 	const utf16 = text => Array.from(text, ch => u16(ch.charCodeAt(0)));
 	const names = [[1, 'RapierWill'], [2, 'Regular'], [4, 'RapierWill Regular'], [6, 'RapierWill-Regular']];
 	let offset = 0;
@@ -75,7 +84,7 @@ function _rapierPrintWillFont(markers) {
 			u16(500), u16(500), u32(1), u32(0), u16(500), u16(700), u16(0), u16(32), u16(0)),
 		cmap,
 		glyf: Array.from({ length: count }, () => outline).flat(),
-		head: cat(u32(0x00010000), u32(0x00010000), u32(0), u32(0x5f0f3cf5), u16(1), u16(1000), new Array(16).fill(0), u16(0), u16(-2), u16(10), u16(2),
+		head: cat(u32(0x00010000), u32(0x00010000), u32(0), u32(0x5f0f3cf5), u16(1), u16(1000), new Array(16).fill(0), bounds.map(u16),
 			u16(0), u16(8), u16(2), u16(1), u16(0)),
 		hhea: cat(u32(0x00010000), u16(500), u16(-500), u16(0), u16(advance), u16(0), u16(advance - 10), u16(10), u16(1), u16(0), u16(0), new Array(8).fill(0), u16(0), u16(count)),
 		hmtx: Array.from({ length: count }, () => cat(u16(advance), u16(0))).flat(),
@@ -96,7 +105,7 @@ function _rapierPrintWillFont(markers) {
 	const file = cat(u32(0x00010000), u16(tags.length), u16((1 << tableSelect) * 16), u16(tableSelect), u16(tags.length * 16 - (1 << tableSelect) * 16), directory, tags.map(tag => padded(tables[tag])));
 	const headAt = 12 + tags.length * 16 + tags.slice(0, tags.indexOf('head')).reduce((total, tag) => total + padded(tables[tag]).length, 0);
 	file.splice(headAt + 8, 4, ...u32((0xb1b0afba - sum(file)) >>> 0));
-	return { family: 'RapierWillCarrier', bytes: Uint8Array.from(file), size, codes: order };
+	return { family: 'RapierWillCarrier', bytes: Uint8Array.from(file), size, codes: order, bounds };
 }
 
 function _rapierPrintWillMetrics(markers) {
@@ -125,7 +134,7 @@ function _rapierPrintWillPlace(root, plan) {
 		else runs.push([row]);
 	}
 	const line = 'display:block;position:static;float:none;box-sizing:content-box;width:auto;height:0;min-height:0;margin:0;padding:0;border:0;overflow:visible;'
-		+ 'white-space:pre;text-align:left;text-indent:0;text-transform:none;text-shadow:none;letter-spacing:0;word-spacing:0;hyphens:none;'
+		+ 'white-space:pre;text-align:left;text-indent:0;text-transform:none;text-shadow:none;text-rendering:geometricPrecision;letter-spacing:0;word-spacing:0;hyphens:none;'
 		+ 'font:' + measure.size + 'px/0 RapierWillCarrier,sans-serif;font-variant-ligatures:none;font-kerning:none;font-feature-settings:normal;'
 		+ 'direction:ltr;unicode-bidi:normal;color:rgba(0,0,0,.0039);break-after:avoid;break-inside:avoid;user-select:none;pointer-events:none;';
 	for (const run of runs) {
@@ -166,7 +175,7 @@ function _rapierPrintWillPageCss() {
 // The capture's own limits (agent/visual.mjs VISUAL_LIMITS): the longest edge and the most pixels one capture returns.
 const CAPTURE_EDGE = 4096, CAPTURE_PIXELS = 4 * 1024 * 1024;
 
-async function _rapierWritePrintPdf({root, css, canonical, filename, title, settings}, {capture, signal, current, maxBytes = 8 * 1024 * 1024} = {}) {
+async function _rapierWritePrintPdf({root, css, fontCss = '', canonical, bom = false, filename, title, settings}, {capture, signal, current, maxBytes = 8 * 1024 * 1024} = {}) {
 	const refuse = code => { throw Object.assign(new Error(code), {code}); };
 	const check = () => {
 		if (signal?.aborted) refuse('cancelled');
@@ -184,6 +193,7 @@ async function _rapierWritePrintPdf({root, css, canonical, filename, title, sett
 	const bodyHeight = Math.floor((height - margins.top - margins.bottom) * 4 / 3);
 	if (bodyWidth < 1 || bodyHeight < 1 || bodyWidth * bodyHeight > 4 * 1024 * 1024) refuse('pdf_page_geometry_invalid');
 	const frame = document.createElement('iframe');
+	let vectors, nativeGlyphs;
 	let rejectAbort;
 	const aborted = new Promise((_, reject) => { rejectAbort = reject; });
 	aborted.catch(() => {});
@@ -206,7 +216,11 @@ async function _rapierWritePrintPdf({root, css, canonical, filename, title, sett
 		check();
 		const into = frame.contentDocument;
 		if (!into?.body) refuse('pdf_render_unavailable');
+		// The capture and native printer use standards layout. An initial blank
+		// iframe otherwise measures preformatted inline struts in quirks mode.
+		into.open(); into.write('<!doctype html><html><head></head><body></body></html>'); into.close();
 		into.documentElement.setAttribute('data-rapier-theme', 'light');
+		into.documentElement.setAttribute('lang', documentLanguage(settings, document.defaultView?.navigator?.language));
 		into.documentElement.setAttribute('data-highlights', document.documentElement.getAttribute('data-highlights') || 'standard');
 		into.body.className = 'light';
 		const sheet = into.createElement('style'); sheet.textContent = String(css || ''); into.head.append(sheet);
@@ -231,6 +245,7 @@ async function _rapierWritePrintPdf({root, css, canonical, filename, title, sett
 		main.setAttribute('data-md-theme', 'light');
 		for (const details of main.querySelectorAll('details')) details.open = true;
 		main.getBoundingClientRect();
+		if (fontCss) await step(waitForFonts(main, {fontCss, css, settings}));
 		await step(into.fonts.ready);
 		for (const image of main.querySelectorAll('img')) { image.loading = 'eager'; await step(image.decode()); }
 		check();
@@ -238,6 +253,14 @@ async function _rapierWritePrintPdf({root, css, canonical, filename, title, sett
 		// pages without a print dialog; its break constraints become column constraints here.
 		for (const node of [main, ...main.querySelectorAll('*')]) {
 			const style = into.defaultView.getComputedStyle(node);
+			// Clipped, out-of-flow source has no page ink. Leaving it in a multicolumn
+			// container can still create blank columns and expose its text to PDF search.
+			if (!node.closest('.rapier-will-carrier') && ['absolute', 'fixed'].includes(style.position) && /^rect\(/.test(style.clip)) {
+				const box = style.clip.slice(5, -1).trim().split(/[,\s]+/).map(Number.parseFloat);
+				if (box.length === 4 && box.every(Number.isFinite) && (box[1] <= box[3] || box[2] <= box[0])) {
+					node.style.setProperty('display', 'none', 'important'); continue;
+				}
+			}
 			for (const name of ['break-before', 'break-after', 'break-inside']) {
 				const value = style.getPropertyValue(name);
 				if (value.includes('page')) node.style.setProperty(name, value.replace('page', 'column'), 'important');
@@ -248,9 +271,23 @@ async function _rapierWritePrintPdf({root, css, canonical, filename, title, sett
 			'column-width': bodyWidth + 'px', 'column-gap': '0', 'column-count': 'auto', 'column-fill': 'auto'}))
 			main.style.setProperty(name, value, 'important');
 		globalThis.RapierMath?.fit(main);
+		applyPrintCapitals(main);
+		applyTypography(main, {all: true});
 		const count = Math.max(1, Math.ceil((main.scrollWidth - 1) / bodyWidth));
 		if (!Number.isSafeInteger(count)) refuse('pdf_page_geometry_invalid');
-		const textPages = await _rapierPrintTextPages(main, bodyWidth, count, check);
+		// Captured document font bytes own a same-name family; factory glyphs must
+		// never replace their page paint. This uses the artifact, not a live catalog.
+		const customFamilies = new Set(fontCss ? fontRequests(main, {fontCss, css, settings}).map(face => face.family.toLowerCase()) : []);
+		nativeGlyphs = await collectPdfGlyphs(main, {width: bodyWidth, check,
+			faces: globalThis.RapierDocxFonts?.DOCX_FONTS?.filter(face => !customFamilies.has(face.family.toLowerCase()))});
+		const textPages = await _rapierPrintTextPages(main, bodyWidth, count, check, undefined, nativeGlyphs.nodes);
+		const linkPages = _rapierPrintLinkPages(main, bodyWidth, bodyHeight, count);
+		vectors = await collectPdfVectors(main, {width: bodyWidth, height: bodyHeight, count, capture, signal, current, check, maxBytes,
+			sanitizeSvg: globalThis.RapierImageAssets?.sanitizeSvgText});
+		for (const root of vectors.textRoots) {
+			const held = await _rapierPrintTextPages(root, bodyWidth, count, check, main.getBoundingClientRect());
+			for (const [page, runs] of held.entries()) textPages[page].push(...runs);
+		}
 		const text = textPages.flatMap(page => page.map(run => run.text));
 		const glyphs = new Set();
 		for (const line of text) for (const character of line) {
@@ -289,80 +326,92 @@ async function _rapierWritePrintPdf({root, css, canonical, filename, title, sett
 						if (!context) refuse('pdf_render_unavailable');
 						context.fillStyle = '#fff'; context.fillRect(0, 0, bodyWidth, bodyHeight);
 						context.drawImage(image, offset * bodyWidth, 0, bodyWidth, bodyHeight, 0, 0, bodyWidth, bodyHeight);
-						const blob = await step(new Promise(resolve => canvas.toBlob(resolve, 'image/jpeg', 0.95)));
-						if (!blob) refuse('pdf_render_unavailable');
-						imageBytes += blob.size;
+						// Preserve the capture's exact pixels. A JPEG re-encode changes
+						// glyph edges, pictures and paint even at its highest quality.
+						const rgba = context.getImageData(0, 0, bodyWidth, bodyHeight).data;
+						const rgb = new Uint8Array(bodyWidth * bodyHeight * 3);
+						for (let at = 0, to = 0; at < rgba.length; at += 4) {rgb[to++] = rgba[at]; rgb[to++] = rgba[at + 1]; rgb[to++] = rgba[at + 2];}
+						const packed = new Uint8Array(await step(new Response(new Blob([rgb]).stream().pipeThrough(new CompressionStream('deflate'))).arrayBuffer()));
+						imageBytes += packed.byteLength;
 						if (imageBytes > maxBytes) refuse('export_too_large');
-						pages.push(new Uint8Array(await blob.arrayBuffer()));
+						pages.push({rgb: packed});
 					} finally { canvas.width = canvas.height = 0; }
 				}
 			} finally { image.src = ''; }
 			first += span;
 		}
 		check();
-		const bytes = await writeRasterPdf({pages, textPages, canonical, filename, title, font, width, height, margins,
+		const bytes = await writeRasterPdf({pages, textPages, linkPages, vectorPages: vectors.pages, canonical, bom, filename, title, font, width, height, margins,
 			pixelWidth: bodyWidth, pixelHeight: bodyHeight, pageNumbers: settings?.pagestyle === 'plain', maxBytes, check});
 		check();
 		return {bytes, pages: count};
-	} finally { signal?.removeEventListener('abort', abort); frame.remove(); }
+	} finally { nativeGlyphs?.restore(); vectors?.restore(); signal?.removeEventListener('abort', abort); frame.remove(); }
 }
 
 // Ranges locate the actual text fragments after column layout. Splitting a text node at
 // its line and page boundaries keeps a PDF search on the page that carries those words.
-async function _rapierPrintTextPages(main, pageWidth, count, check) {
-	const into = main.ownerDocument, origin = main.getBoundingClientRect();
-	const pages = Array.from({length: count}, () => []);
-	// The renderer's outlines have no text ranges. Read each equation's exact TeX
-	// alternative at its SVG box, and reject its subtree so titles cannot duplicate it.
-	const walker = into.createTreeWalker(main, 5, {acceptNode(node) {
-		if (node.parentElement?.closest('.math-rendered svg[aria-label]')) return 2;
-		return node.nodeType === 3 || node.matches('.math-rendered svg[aria-label]') ? 1 : 3;
-	}});
+async function _rapierPrintTextPages(main, pageWidth, count, check, origin = main.getBoundingClientRect(), nativeNodes = null) {
+	const into = main.ownerDocument;
+	const pages = Array.from({length: count}, () => []), walker = into.createTreeWalker(main, 5);
+	const markerMetrics = _rapierPrintWillMetrics(Array.from(main.querySelectorAll('.rapier-will-carrier'), node => node.textContent));
+	const markerLost = () => { throw _rapierPrintWillLost('a marker has no readable position on the page', 'Try another browser'); };
 	const range = into.createRange();
-	const pageOf = x => Math.max(0, Math.min(count - 1, Math.floor((x - origin.left + .01) / pageWidth)));
 	let nodes = 0, operations = 0;
 	for (let node; (node = walker.nextNode());) {
 		if (++nodes % 128 === 0) { await new Promise(resolve => setTimeout(resolve, 0)); check(); }
-		const math = node.nodeType === 1;
-		const style = into.defaultView.getComputedStyle(math ? node : node.parentElement);
-		if (style.visibility === 'hidden' || style.visibility === 'collapse') continue;
-		if (math) {
-			const rect = node.getBoundingClientRect(), text = node.getAttribute('aria-label');
-			if (rect.width > 0 && rect.height > 0 && text) {
-				const page = pageOf(rect.left);
-				pages[page].push({text, x: rect.left - origin.left - page * pageWidth, y: rect.top - origin.top,
-					width: rect.width, height: rect.height, math: true});
-			}
-			continue;
-		}
+		const element = node.nodeType === 1 ? node : node.parentElement;
+		const formula = node.nodeType === 1 && node.matches('.math-rendered[data-math-src]') && node.querySelector('svg');
+		if (node.nodeType === 1 && !formula || node.nodeType === 3 && element.closest('.math-rendered[data-math-src]')) continue;
+		let value;
+		if (formula) {
+			// The math owner paints SVG paths and retains the equation's exact TeX alternative.
+			// Carry that semantic text at the SVG's measured position for search and copy.
+			value = formula.getAttribute('aria-label') || '';
+		} else value = node.data;
+		const style = into.defaultView.getComputedStyle(element);
+		const carrier = element.closest('.rapier-will-carrier');
+		if (style.visibility === 'hidden' || style.visibility === 'collapse') { if (carrier) markerLost(); continue; }
 		const preserve = /pre|break-spaces/.test(style.whiteSpace);
-		const block = node.parentElement.closest('p,h1,h2,h3,h4,h5,h6,li,pre,td,th,figcaption,blockquote,.rapier-will-carrier') || node.parentElement;
-		const carrier = node.parentElement.closest('.rapier-will-carrier');
-		const value = node.data;
+		const block = element.closest('p,h1,h2,h3,h4,h5,h6,li,pre,td,th,figcaption,blockquote,.rapier-will-carrier') || element;
+		const native = nativeNodes?.get(node);
+		const pageOf = x => Math.max(0, Math.min(count - 1, Math.floor((x - origin.left + .01) / pageWidth)));
 		const visit = (start, end) => {
 			if (++operations % 128 === 0) check();
-			range.setStart(node, start); range.setEnd(node, end);
-			const rects = Array.from(range.getClientRects()).filter(rect => rect.width > 0 && rect.height > 0);
-			if (!rects.length) return;
+			if (!formula) { range.setStart(node, start); range.setEnd(node, end); }
+			// A tiny carrier font can have its advance rounded to zero by a browser. Its
+			// measured baseline still locates the marker; the font's authored metrics keep its text width.
+			const rects = Array.from(formula ? [formula.getBoundingClientRect()] : range.getClientRects()).filter(rect => rect.height > 0 && (rect.width > 0 || carrier));
+			if (!rects.length) { if (carrier) markerLost(); return; }
 			const first = rects[0], page = pageOf(first.left);
-			const oneLine = rects.every(rect => pageOf(rect.left) === page && pageOf(rect.right - .02) === page && Math.abs(rect.top - first.top) < .5);
-			let middle = Math.floor((start + end) / 2);
+			const oneLine = rects.every(rect => pageOf(rect.left) === page && pageOf(rect.width ? rect.right - .02 : rect.left) === page && Math.abs(rect.top - first.top) < .5);
+			let middle = formula ? start : Math.floor((start + end) / 2);
 			if (middle > start && /[\uD800-\uDBFF]/.test(value[middle - 1]) && /[\uDC00-\uDFFF]/.test(value[middle])) middle--;
+			const cluster = native?.find(item => item.start < middle && item.end > middle);
+			if (cluster) middle = cluster.start > start ? cluster.start : cluster.end;
 			if (!oneLine && middle > start && middle < end) { visit(start, middle); visit(middle, end); return; }
 			let text = value.slice(start, end);
-			text = preserve ? text.replace(/\r\n?|\n/g, '') : text.replace(/[ \t\r\n\f]+/g, ' ');
+			if (!formula) text = preserve ? text.replace(/\r\n?|\n/g, '') : text.replace(/[ \t\r\n\f]+/g, ' ');
 			if (!text) return;
 			const x = Math.min(...rects.map(rect => rect.left)) - origin.left - page * pageWidth;
 			const y = Math.min(...rects.map(rect => rect.top)) - origin.top;
-			const right = Math.max(...rects.map(rect => rect.right)) - origin.left - page * pageWidth;
+			let right = Math.max(...rects.map(rect => rect.right)) - origin.left - page * pageWidth;
+			if (carrier && right === x) right += Array.from(text).length * markerMetrics.advance * markerMetrics.size / 1000;
 			const bottom = Math.max(...rects.map(rect => rect.bottom)) - origin.top;
+			const parts = native ? native.filter(item => item.start >= start && item.end <= end && item.text).map(item => ({...item}))
+				: [{text, x, y, width: right - x, height: bottom - y}];
 			const last = pages[page].at(-1);
-			if (last && !last.math && last.block === block && last.carrier === carrier && Math.abs(last.y - y) < Math.max(2, Math.min(last.height, bottom - y) * .2)) {
+			if (last && !formula && !last.math && last.block === block && last.carrier === carrier && Math.abs(last.y - y) < Math.max(2, Math.min(last.height, bottom - y) * .2)) {
+				if (!preserve && last.text.endsWith(' ') && text.startsWith(' ') && parts.length) {
+					const first = parts[0];
+					if (first.text === ' ') parts.shift();
+					else {const advance = first.width / Array.from(first.text).length; first.text = first.text.slice(1); first.x += advance; first.width -= advance;}
+				}
 				last.text = preserve ? last.text + text : (last.text + text).replace(/[ \t\r\n\f]+/g, ' ');
+				last.parts.push(...parts);
 				last.width = Math.max(last.x + last.width, right) - Math.min(last.x, x);
 				last.height = Math.max(last.y + last.height, bottom) - Math.min(last.y, y);
 				last.x = Math.min(last.x, x); last.y = Math.min(last.y, y);
-			} else pages[page].push({text, x, y, width: right - x, height: bottom - y, block, carrier});
+			} else pages[page].push({text, x, y, width: right - x, height: bottom - y, block, carrier, math: !!formula, parts});
 		};
 		visit(0, value.length);
 	}
@@ -370,12 +419,40 @@ async function _rapierPrintTextPages(main, pageWidth, count, check) {
 	return pages.map(page => page.map(({block, carrier, ...run}) => run));
 }
 
+function _rapierPrintLinkPages(main, width, height, count) {
+	const origin = main.getBoundingClientRect(), pages = Array.from({length: count}, () => []);
+	for (const anchor of main.querySelectorAll('a[href]')) {
+		const href = anchor.getAttribute('href');
+		if (!href || /^(?:javascript|vbscript|data):/i.test(href)) continue;
+		let target;
+		if (href.startsWith('#')) {
+			let id; try { id = decodeURIComponent(href.slice(1)); } catch (_) { continue; }
+			const node = main.ownerDocument.getElementById(id);
+			if (!node || !main.contains(node)) continue;
+			const box = node.getBoundingClientRect(), page = Math.floor((box.left - origin.left + .01) / width);
+			if (page < 0 || page >= count) continue;
+			target = {page, x: box.left - origin.left - page * width, y: box.top - origin.top};
+		} else target = {uri: encodeURI(href).replace(/%25([a-f0-9]{2})/gi, '%$1')};
+		for (const box of anchor.getClientRects()) {
+			if (!(box.width > 0 && box.height > 0)) continue;
+			const first = Math.max(0, Math.floor((box.left - origin.left + .01) / width));
+			const last = Math.min(count - 1, Math.floor((box.right - origin.left - .01) / width));
+			for (let page = first; page <= last; page++) {
+				const x = Math.max(0, box.left - origin.left - page * width), y = Math.max(0, box.top - origin.top);
+				const right = Math.min(width, box.right - origin.left - page * width), bottom = Math.min(height, box.bottom - origin.top);
+				if (right > x && bottom > y) pages[page].push({x, y, width: right - x, height: bottom - y, target});
+			}
+		}
+	}
+	return pages;
+}
+
   return {_rapierWillSentinelPlan, _rapierPrintWillAdmit, _rapierPrintWillFont, _rapierPrintWillMetrics, _rapierPrintWillPlace, _rapierPrintWillLost, _rapierPrintWillPageCss, _rapierWritePrintPdf};
 }
 
 // A standard PDF page tree, image streams, Unicode text and an associated source file.
 // It accepts already-rendered pages, so there is no second document grammar or layout engine.
-async function writeRasterPdf({pages, textPages, canonical, filename, title, font, width, height, margins, pixelWidth, pixelHeight, pageNumbers, maxBytes, check}) {
+async function writeRasterPdf({pages, textPages, linkPages = [], vectorPages = [], canonical, bom = false, filename, title, font, width, height, margins, pixelWidth, pixelHeight, pageNumbers, maxBytes, check}) {
 	const encoder = new TextEncoder(), encode = value => encoder.encode(value);
 	const fail = code => { throw Object.assign(new Error(code), {code}); };
 	const concat = parts => {
@@ -397,7 +474,7 @@ async function writeRasterPdf({pages, textPages, canonical, filename, title, fon
 	const stream = (dict, bytes) => add(concat([encode('<<' + dict + ' /Length ' + bytes.length + '>>\nstream\n'), bytes, encode('\nendstream')]));
 	const hex = value => Array.from({length: value.length}, (_, index) => value.charCodeAt(index).toString(16).padStart(4, '0')).join('');
 	const literal = value => '(' + String(value).replace(/[\\()\r\n]/g, character => ({'\\': '\\\\', '(': '\\(', ')': '\\)', '\r': '\\r', '\n': '\\n'}[character])) + ')';
-	const source = encoder.encode(canonical);
+	const source = encoder.encode((bom ? '\uFEFF' : '') + canonical);
 	const embedded = stream('/Type /EmbeddedFile /Subtype /text#2Fplain /Params <</Size ' + source.length + '>> /Filter /FlateDecode', await compressed(source));
 	const file = add('<< /Type /Filespec /F ' + literal(String(filename).replace(/[^\x20-\x7e]/g, '_')) + ' /UF <feff' + hex(filename) + '> /AFRelationship /Source /EF << /F ' + embedded + ' 0 R /UF ' + embedded + ' 0 R >> >>');
 	const codes = new Map(font.codes.map((code, index) => [code, index + 1]));
@@ -407,27 +484,98 @@ async function writeRasterPdf({pages, textPages, canonical, filename, title, fon
 	cmap += 'endcmap\nCMapName currentdict /CMap defineresource pop\nend\nend';
 	const mapping = stream('/Filter /FlateDecode', await compressed(encode(cmap)));
 	const fontFile = stream('/Length1 ' + font.bytes.length + ' /Filter /FlateDecode', await compressed(font.bytes));
-	const descriptor = add('<< /Type /FontDescriptor /FontName /RapierText /Flags 4 /FontBBox [0 -2 10 2] /ItalicAngle 0 /Ascent 500 /Descent -500 /CapHeight 500 /StemV 80 /FontFile2 ' + fontFile + ' 0 R >>');
+	const descriptor = add('<< /Type /FontDescriptor /FontName /RapierText /Flags 4 /FontBBox [' + font.bounds.join(' ') + '] /ItalicAngle 0 /Ascent 500 /Descent -500 /CapHeight 500 /StemV 80 /FontFile2 ' + fontFile + ' 0 R >>');
 	const descendant = add('<< /Type /Font /Subtype /CIDFontType2 /BaseFont /RapierText /CIDSystemInfo << /Registry (Adobe) /Ordering (Identity) /Supplement 0 >> /FontDescriptor ' + descriptor + ' 0 R /DW 500 /CIDToGIDMap /Identity >>');
 	const type = add('<< /Type /Font /Subtype /Type0 /BaseFont /RapierText /Encoding /Identity-H /DescendantFonts [' + descendant + ' 0 R] /ToUnicode ' + mapping + ' 0 R >>');
 	const numberFont = pageNumbers ? add('<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>') : null;
-	const kids = [], decimal = value => Number(value.toFixed(4));
+	const kids = pages.map(() => { objects.push(null); return objects.length - 1; }), decimal = value => Number(value.toFixed(4));
+	const nativeFonts = new Map();
+	const glyphKey = part => part.glyph + ':' + part.text;
+	for (const page of textPages) for (const run of page) for (const part of run.parts || []) if (part.font) {
+		let entry = nativeFonts.get(part.font);
+		if (!entry) {entry = {font: part.font, name: '/Fn' + nativeFonts.size, codes: new Map(), rows: []}; nativeFonts.set(part.font, entry);}
+		const key = glyphKey(part);
+		if (!entry.codes.has(key)) {const code = entry.rows.length + 1; if (code > 65000) fail('pdf_text_glyph_limit'); entry.codes.set(key, code); entry.rows.push({...part, code});}
+	}
+	const nativeResources = [];
+	for (const entry of nativeFonts.values()) {
+		check();
+		const face = entry.font, name = face.asset.family.replace(/\s/g, '') + '-' + face.asset.style, scale = 1000 / face.units;
+		const file = stream('/Length1 ' + face.bytes.length + ' /Filter /FlateDecode', await compressed(face.bytes));
+		const descriptor = add('<< /Type /FontDescriptor /FontName /' + name + ' /Flags 32 /FontBBox [' + face.bbox.map(value => decimal(value * scale)).join(' ') + '] /ItalicAngle 0 /Ascent ' + decimal(face.ascent * scale)
+			+ ' /Descent ' + decimal(face.descent * scale) + ' /CapHeight ' + decimal(face.capHeight * scale) + ' /StemV 80 /FontFile2 ' + file + ' 0 R >>');
+		const ids = new Uint8Array((entry.rows.length + 1) * 2);
+		for (const row of entry.rows) {ids[row.code * 2] = row.glyph >> 8; ids[row.code * 2 + 1] = row.glyph & 255;}
+		const glyphMap = stream('/Filter /FlateDecode', await compressed(ids));
+		let unicode = '/CIDInit /ProcSet findresource begin\n12 dict begin\nbegincmap\n/CIDSystemInfo << /Registry (Adobe) /Ordering (UCS) /Supplement 0 >> def\n/CMapName /' + name + 'Unicode def\n/CMapType 2 def\n1 begincodespacerange\n<0000> <ffff>\nendcodespacerange\n';
+		for (let at = 0; at < entry.rows.length; at += 100) {const rows = entry.rows.slice(at, at + 100); unicode += rows.length + ' beginbfchar\n' + rows.map(row => '<' + row.code.toString(16).padStart(4, '0') + '> <' + hex(row.text) + '>').join('\n') + '\nendbfchar\n';}
+		unicode += 'endcmap\nCMapName currentdict /CMap defineresource pop\nend\nend';
+		const mapping = stream('/Filter /FlateDecode', await compressed(encode(unicode)));
+		const descendant = add('<< /Type /Font /Subtype /CIDFontType2 /BaseFont /' + name + ' /CIDSystemInfo << /Registry (Adobe) /Ordering (Identity) /Supplement 0 >> /FontDescriptor ' + descriptor + ' 0 R /CIDToGIDMap ' + glyphMap + ' 0 R /W [1 [' + entry.rows.map(row => decimal(face.advance(row.glyph) * scale)).join(' ') + ']] >>');
+		const type = add('<< /Type /Font /Subtype /Type0 /BaseFont /' + name + ' /Encoding /Identity-H /DescendantFonts [' + descendant + ' 0 R] /ToUnicode ' + mapping + ' 0 R >>');
+		nativeResources.push(entry.name + ' ' + type + ' 0 R');
+	}
 	for (let index = 0; index < pages.length; index++) {
 		check();
-		const picture = stream('/Type /XObject /Subtype /Image /Width ' + pixelWidth + ' /Height ' + pixelHeight + ' /ColorSpace /DeviceRGB /BitsPerComponent 8 /Filter /DCTDecode', pages[index]);
+		const picture = stream('/Type /XObject /Subtype /Image /Width ' + pixelWidth + ' /Height ' + pixelHeight + ' /ColorSpace /DeviceRGB /BitsPerComponent 8 /Filter /' + (pages[index].rgb ? 'FlateDecode' : 'DCTDecode'), pages[index].rgb || pages[index]);
 		let commands = 'q\n' + [decimal(pixelWidth * .75), 0, 0, decimal(pixelHeight * .75), decimal(margins.left), decimal(height - margins.top - pixelHeight * .75)].join(' ') + ' cm\n/Im0 Do\nQ\n';
+		const pictures = ['/Im0 ' + picture + ' 0 R'], states = [], rasterCache = new Map();
+		for (const drawing of vectorPages[index] || []) {
+			commands += `q\n.75 0 0 -.75 ${decimal(margins.left)} ${decimal(height - margins.top)} cm\n0 0 ${pixelWidth} ${pixelHeight} re W n\n1 0 0 1 ${decimal(drawing.x)} 0 cm\n`;
+			commands += [drawing.clip.x, drawing.clip.y, drawing.clip.width, drawing.clip.height].map(decimal).join(' ') + ' re W n\n';
+			for (const piece of drawing.sequence) {
+				if (piece.image) {
+					let name = rasterCache.get(piece.image);
+					if (!name) {
+						const image = piece.image;
+						const mask = stream('/Type /XObject /Subtype /Image /Width ' + image.width + ' /Height ' + image.height + ' /ColorSpace /DeviceGray /BitsPerComponent 8 /Filter /FlateDecode', image.alpha);
+						const object = stream('/Type /XObject /Subtype /Image /Width ' + image.width + ' /Height ' + image.height + ' /ColorSpace /DeviceRGB /BitsPerComponent 8 /SMask ' + mask + ' 0 R /Filter /FlateDecode', image.rgb);
+						name = '/Im' + pictures.length; pictures.push(name + ' ' + object + ' 0 R'); rasterCache.set(image, name);
+					}
+					commands += `q\n${[piece.width, 0, 0, -piece.height, piece.x, piece.y + piece.height].map(decimal).join(' ')} cm\n${name} Do\nQ\n`;
+				} else {
+					const state = '/Gs' + states.length;
+					states.push(state + ' ' + add('<< /Type /ExtGState /ca ' + decimal(piece.fillAlpha) + ' /CA ' + decimal(piece.strokeAlpha) + ' >>') + ' 0 R');
+					commands += 'q\n' + state + ' gs\n' + piece.commands + 'Q\n';
+				}
+			}
+			commands += 'Q\n';
+		}
+		const textAlphas = new Map();
 		for (const run of textPages[index]) {
-			const characters = Array.from(run.text);
-			const value = characters.map(character => codes.get(character.codePointAt(0)).toString(16).padStart(4, '0')).join('');
-			const size = Math.max(.1, run.height * .75);
-			const scale = run.width * .75 / (characters.length * size * .5) * 100;
-			if (run.math) commands += '/Span << /ActualText <feff' + hex(run.text) + '> >> BDC\n';
-			commands += `BT\n/F1 ${decimal(size)} Tf\n${decimal(scale)} Tz\n3 Tr\n1 0 0 1 ${decimal(margins.left + run.x * .75)} ${decimal(height - margins.top - (run.y + run.height * .8) * .75)} Tm\n<${value}> Tj\nET\n`;
-			if (run.math) commands += 'EMC\n';
+			if (!run.text) continue;
+			// Keep one logical Unicode text object, resetting its font before each scalar's direction
+			// can change. Readers that ignore ActualText otherwise discard earlier words in mixed RTL/LTR.
+			// Express width in the font size: some readers ignore horizontal text scaling when joining.
+			commands += `q\n/Span << /ActualText <feff${hex(run.text)}> >> BDC\nBT\n100 Tz\n`;
+			for (const part of run.parts || [run]) {
+				if (part.font) {
+					const entry = nativeFonts.get(part.font), value = entry.codes.get(glyphKey(part)).toString(16).padStart(4, '0'), alpha = decimal(part.rgba[3]);
+					let state = textAlphas.get(alpha);
+					if (!state) {state = '/Gs' + states.length; states.push(state + ' ' + add('<< /Type /ExtGState /ca ' + alpha + ' >>') + ' 0 R'); textAlphas.set(alpha, state);}
+					commands += `${state} gs\n${part.rgba.slice(0, 3).map(decimal).join(' ')} rg\n${entry.name} ${decimal(part.size * .75)} Tf\n0 Tr\n1 0 0 1 ${decimal(margins.left + part.x * .75)} ${decimal(height - margins.top - part.baseline * .75)} Tm\n<${value}> Tj\n`;
+				} else {
+					const characters = Array.from(part.text); if (!characters.length) continue;
+					const advance = part.width * .75 / characters.length, size = Math.max(.1, advance * 2), scaleY = Math.max(.1, part.height * .75) / size;
+					const baseline = decimal(height - margins.top - (part.y + part.height * .8) * .75);
+					for (let letter = 0; letter < characters.length; letter++) {
+						const value = codes.get(characters[letter].codePointAt(0)).toString(16).padStart(4, '0');
+						commands += `/F1 ${decimal(size)} Tf\n3 Tr\n1 0 0 ${decimal(scaleY)} ${decimal(margins.left + part.x * .75 + letter * advance)} ${baseline} Tm\n<${value}> Tj\n`;
+					}
+				}
+			}
+			commands += 'ET\nEMC\nQ\n';
 		}
 		if (numberFont) commands += `BT\n/F2 9 Tf\n0 Tr\n1 0 0 1 ${decimal(width / 2 - String(index + 1).length * 2.5)} ${decimal(margins.bottom / 2)} Tm\n(${index + 1}) Tj\nET\n`;
 		const content = stream('/Filter /FlateDecode', await compressed(encode(commands)));
-		kids.push(add('<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ' + decimal(width) + ' ' + decimal(height) + '] /Resources << /XObject << /Im0 ' + picture + ' 0 R >> /Font << /F1 ' + type + ' 0 R' + (numberFont ? ' /F2 ' + numberFont + ' 0 R' : '') + ' >> >> /Contents ' + content + ' 0 R >>'));
+		const annotations = (linkPages[index] || []).map(link => {
+			const rect = [margins.left + link.x * .75, height - margins.top - (link.y + link.height) * .75,
+				margins.left + (link.x + link.width) * .75, height - margins.top - link.y * .75].map(decimal);
+			const target = link.target.uri ? '/A << /S /URI /URI ' + literal(link.target.uri) + ' >>'
+				: '/Dest [' + kids[link.target.page] + ' 0 R /XYZ ' + decimal(margins.left + link.target.x * .75) + ' ' + decimal(height - margins.top - link.target.y * .75) + ' null]';
+			return add('<< /Type /Annot /Subtype /Link /Border [0 0 0] /Rect [' + rect.join(' ') + '] ' + target + ' >>');
+		});
+		put(kids[index], '<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ' + decimal(width) + ' ' + decimal(height) + '] /Resources << /XObject << ' + pictures.join(' ') + ' >> /ExtGState << ' + states.join(' ') + ' >> /Font << /F1 ' + type + ' 0 R' + (numberFont ? ' /F2 ' + numberFont + ' 0 R' : '') + ' ' + nativeResources.join(' ') + ' >> >> /Contents ' + content + ' 0 R' + (annotations.length ? ' /Annots [' + annotations.map(id => id + ' 0 R').join(' ') + ']' : '') + ' >>');
 	}
 	put(2, '<< /Type /Pages /Count ' + kids.length + ' /Kids [' + kids.map(id => id + ' 0 R').join(' ') + '] >>');
 	put(1, '<< /Type /Catalog /Pages 2 0 R /Names << /EmbeddedFiles << /Names [<feff' + hex(filename) + '> ' + file + ' 0 R] >> >> /AF [' + file + ' 0 R] >>');
@@ -442,4 +590,4 @@ async function writeRasterPdf({pages, textPages, canonical, filename, title, fon
 	parts.push(encode('xref\n0 ' + objects.length + '\n0000000000 65535 f \n' + offsets.slice(1).map(at => String(at).padStart(10, '0') + ' 00000 n \n').join('') + 'trailer\n<< /Size ' + objects.length + ' /Root 1 0 R /Info ' + info + ' 0 R >>\nstartxref\n' + xref + '\n%%EOF\n'));
 	const bytes = concat(parts); if (bytes.length > maxBytes) fail('export_too_large'); return bytes;
 }
-export {createPrintRenderer, RAPIER_WILL_SENTINEL_MARK as sentinel};
+export {createPrintRenderer, applyPrintCapitals, RAPIER_WILL_SENTINEL_MARK as sentinel};

package/dist/kit/render-sanitize.mjs

@@ -58,6 +58,11 @@ const DIAGRAM_LABEL_SVG_NAMESPACE = 'http://www.w3.org/2000/svg';
 const DIAGRAM_LABEL_HTML_NAMESPACE = 'http://www.w3.org/1999/xhtml';
 const DIAGRAM_LABEL_MATH_NAMESPACE = 'http://www.w3.org/1998/Math/MathML';
 
+function _rapierImageDataAttributeAllowed(tag, attribute, value, verify) {
+	return (tag === 'img' && attribute === 'src' || tag === 'image' && /^(?:href|xlink:href)$/.test(attribute)
+		&& /^data:image\/(?:png|jpeg|webp|jxl);base64,/i.test(value)) && verify(value);
+}
+
 // Snapshot current math text before a Markdown writer collapses whitespace. Rendered SVG
 // glyphs have no textContent: put their retained source in this inert copy so the writer's
 // blank-node rule cannot discard an equation or its containing paragraph/list item.
@@ -140,7 +145,7 @@ function createInertHtmlSanitizer({parseFragment, serialize, sanitizeHtml, safeR
 		const cleaned = sanitizeHtml(serialize(tree), {
 			allowedTags: [...tags], allowedAttributes: false,
 			disallowedTagsMode: 'discard', nonTextTags: RAPIER_SANITIZE_DROP_CONTENTS,
-			allowedSchemes: schemes, allowedSchemesByTag: {img: [...schemes, 'data']},
+			allowedSchemes: schemes, allowedSchemesByTag: {img: [...schemes, 'data'], image: [...schemes, 'data']},
 			allowedSchemesAppliedToAttributes: ['href', 'src', 'xlink:href', 'cite', 'background', 'poster'],
 			parseStyleAttributes: false,
 			parser: {lowerCaseTags: false, lowerCaseAttributeNames: false, decodeEntities: true},
@@ -158,7 +163,7 @@ function createInertHtmlSanitizer({parseFragment, serialize, sanitizeHtml, safeR
 					const compact = value.replace(/[\u0000-\u0020\u00a0\u1680\u180e\u2000-\u2029\u205f\u3000]/g, '');
 					if (!data && !aria && !pageBreak && !uriSafe.has(key) && compact) {
 						if (/^data:/i.test(compact)) {
-							if (key !== 'src' || tag !== 'img' || !safeRasterDataUrl(compact)) continue;
+							if (!_rapierImageDataAttributeAllowed(tag, key, compact, safeRasterDataUrl)) continue;
 						} else if (!uri.test(compact)) continue;
 					}
 					attribs[name] = value;
@@ -264,10 +269,11 @@ function _rapierInstallSanitizeHooks() {
 		if (!/^(?:src|href|xlink:href)$/i.test(data.attrName || '')) return;
 		const compact = String(data.attrValue || '').replace(/[\u0000-\u0020\u00a0]+/g, '');
 		if (!/^data:/i.test(compact)) return;
-		const rasterAllowed = /^(?:render|export|raw|source)$/.test(_rapierSanitizeRuntime.context)
-			&& data.attrName.toLowerCase() === 'src'
-			&& node && node.nodeName === 'IMG'
-			&& _rapierSafeRasterDataUrl(compact);
+		const tag = node?.nodeName === 'IMG' ? 'img'
+			: node?.namespaceURI === DIAGRAM_LABEL_SVG_NAMESPACE && node.localName === 'image' ? 'image' : '';
+		const rasterAllowed = (/^(?:render|export|raw|source)$/.test(_rapierSanitizeRuntime.context)
+			|| _rapierSanitizeRuntime.context === 'diagram' && tag === 'image')
+			&& _rapierImageDataAttributeAllowed(tag, data.attrName.toLowerCase(), compact, _rapierSafeRasterDataUrl);
 		if (!rasterAllowed) data.keepAttr = false;
 	});
 	// Paste, render and export sanitise: a remote <img src> would fetch the instant its markup lands in the page,
@@ -290,6 +296,15 @@ function _rapierInstallSanitizeHooks() {
 		const title = node.getAttribute('title');
 		if (title != null) node.setAttribute('data-rapier-remote-title', title);
 	});
+	DOMPurify.addHook('uponSanitizeElement', node => {
+		if (_rapierRemoteContent.allowed || !/^(?:diagram|export)$/.test(_rapierSanitizeRuntime.context) ||
+				node?.namespaceURI !== DIAGRAM_LABEL_SVG_NAMESPACE || node.localName?.toLowerCase() !== 'image') return;
+		const href = node.getAttribute('href') || node.getAttribute('xlink:href') || '';
+		if (href && _rapierRemoteSubresourceOrigin(href)) {
+			node._rapierHeldBack = true;
+			node.setAttribute('data-rapier-remote-src', href);
+		}
+	});
 	// A list from Word is named by the style of its paragraph and of the span that holds its marker (mso-list,
 	// spec/html-reading.mjs), and the CSS pass below empties a style of every property the browser does not
 	// know: a marker's style is only `mso-list:Ignore`. The paste carries both as data-* first, where they stay,
@@ -362,12 +377,13 @@ function sanitizeRapierHtml(value, context = 'render') {
 	// profile's admission, and the block on remote content stays the reader's (a remote picture's URL is the person's words).
 	const selected = context === 'raw' || context === 'export' || context === 'source' || RAPIER_SANITIZE_OPTIONS[context] ? context : 'render';
 	let options = selected === 'raw' ? { ...RAPIER_SANITIZE_OPTIONS.render, ALLOW_DATA_ATTR: false } : RAPIER_SANITIZE_OPTIONS[selected] || RAPIER_SANITIZE_OPTIONS.render;
+	if (selected === 'source') options = {...options, ADD_DATA_URI_TAGS: ['image']};
 	const labels = selected === 'diagram' || selected === 'export';
 	if (labels) {
 		// DOMPurify's USE_PROFILES replaces explicit allowlists. Add MathML to the
 		// selected profile without discarding its admitted HTML and SVG vocabulary.
 		options = {...options, ALLOWED_TAGS: [...new Set([...options.ALLOWED_TAGS, ...RAPIER_SANITIZE_PROFILES.mathTags])],
-			ALLOWED_ATTR: [...new Set([...options.ALLOWED_ATTR, ...RAPIER_SANITIZE_PROFILES.mathAttributes])], ADD_TAGS: ['foreignobject'],
+			ALLOWED_ATTR: [...new Set([...options.ALLOWED_ATTR, ...RAPIER_SANITIZE_PROFILES.mathAttributes])], ADD_TAGS: ['foreignobject'], ADD_DATA_URI_TAGS: ['image'],
 			HTML_INTEGRATION_POINTS: {foreignobject: true}, FORBID_TAGS: options.FORBID_TAGS.filter(tag => tag !== 'foreignobject')};
 		DOMPurify.addHook('uponSanitizeElement', diagramLabelElement);
 		DOMPurify.addHook('uponSanitizeAttribute', diagramLabelAttribute);

package/dist/kit/render-styles.mjs

@@ -5,6 +5,8 @@ function createRenderStyles(runtime) {
 function _rapierArtifactThemeCss(houseDefaults = false) {
 	// Geometry and the selected accent belong to this page; palette and type belong to the
 	// MIT reference sheet. Static code highlighting reads the app token names.
+	// The live editor resolves System to Light before applying the reference heading tokens;
+	// a carried System page keeps following the reader's device, including those light tokens.
 	const accent = houseDefaults ? '' : ':root,.md-render{--md-color-accent:' + _rapierArtifactAccent() + '}';
 	return `
 ${accent}
@@ -18,12 +20,14 @@ body{
 	--color-text-subtle:var(--md-color-text-subtle);--color-accent-text:var(--md-color-accent-text);
 	margin:0;background:var(--md-color-bg);color:var(--md-color-text);font-family:var(--md-font-sans);-webkit-font-smoothing:antialiased
 }
-.rapier-page{width:min(100%,calc(var(--md-measure,39.6rem) + 48px));margin:0 auto;padding:48px 24px 72px}
+.rapier-page{width:min(100%,calc(var(--md-measure,39.6rem) + 32px));margin:0 auto;padding:48px 16px 72px}
 .rapier-page [id]{scroll-margin-top:var(--md-space-8)}
 .artifact-flat{margin:0;white-space:pre-wrap;overflow-wrap:anywhere;tab-size:2}
 .artifact-flat--text{font:var(--md-fw-regular) 1rem/1.7 var(--md-font-sans)}
 .artifact-flat--code{font:var(--md-fw-regular) .875rem/1.6 var(--md-font-mono);overflow-x:auto;white-space:pre}
-@media (max-width:600px){.rapier-page{padding:32px 18px 56px}}
+@media screen{html{scrollbar-width:none}html::-webkit-scrollbar{width:0;height:0;display:none}}
+@media (max-width:600px){.rapier-page{padding:32px 16px 56px}}
+@media (prefers-color-scheme:light){.rapier-page[data-md-theme="system"]{--md-heading-color:var(--md-color-line);--md-heading-muted-color:var(--md-color-line)}}
 `;
 }
 
@@ -54,6 +58,7 @@ function _rapierDocumentPrintCss(hostSelector) {
 	${list('.md-render p','.md-render li','.md-render blockquote')}{orphans:3;widows:3}
 	${p('.md-render img')}{max-width:100%!important;height:auto!important;break-inside:avoid-page}
 	${list('.md-render pre','.artifact-flat')}{white-space:pre-wrap!important;overflow-wrap:anywhere!important;word-break:break-word!important;overflow:visible!important;max-height:none!important}
+	${p('.diagram-block[data-diagram-state="ready"] .diagram-source')}{display:none!important}
 	${p('.artifact-flat')}{margin:0;font:400 12pt/1.55 var(--md-font-sans);tab-size:2}
 	${p('.artifact-flat--code')}{font:400 10pt/1.5 var(--md-font-mono)}
 	${list('.table-scroll-wrap','.math-display-wrap')}{overflow:visible!important;padding:0!important}
@@ -77,16 +82,7 @@ function _rapierArtifactStyles(theme, includeFonts, printMode, houseDefaults = f
 	else if (includeFonts) parts.push(_rapierStyleText('rapier-font-style'));
 	parts.push(_rapierStyleText('rapier-content-style'));
 	parts.push(_rapierArtifactThemeCss(houseDefaults));
-	// Where the faces do not ride (the written page's policy carries no font-src), the reader's own sans is
-	// matched to Geist's metrics: one family per system face, src:local() only (fetched by nothing, so the
-	// policy is untouched), size-adjust from Geist's weighted average advance over the face's own (Geist 467
-	// per 1000, measured from repo/shell/fonts; the system faces from their tables), the ascent and descent
-	// overrides divided by that size-adjust so the used metrics are Geist's 1005/295 per 1000, the line gap
-	// Geist's zero. Bold weights take the face's own bold; 500 the regular. Proved in Chromium against the
-	// installed Liberation Sans: widths 1.057 as computed, regular and bold loaded, the stack resolving to it.
-	// The family list walks the platforms: Roboto (Android), Helvetica Neue (Apple), Segoe UI (Windows),
-	// Arial, then Linux's Noto Sans, Ubuntu, Liberation Sans, DejaVu Sans; a face that is not installed fails
-	// to load and the browser moves to the next family. font-size-adjust was tried and rescaled Geist itself.
+	// Local faces keep an offline fallback. The HTML writer may append a small factory Sans subset.
 	if (!includeFonts && fontCss === null) parts.push(`@font-face{font-family:'Geist/Roboto';src:local('Roboto');font-weight:400 500;size-adjust:105%;ascent-override:95.7%;descent-override:28.1%;line-gap-override:0%}
 @font-face{font-family:'Geist/Roboto';src:local('Roboto Bold');font-weight:600 700;size-adjust:105%;ascent-override:95.7%;descent-override:28.1%;line-gap-override:0%}
 @font-face{font-family:'Geist/Helvetica Neue';src:local('Helvetica Neue');font-weight:400 500;size-adjust:103.8%;ascent-override:96.8%;descent-override:28.4%;line-gap-override:0%}