rapier-markdown-kit 1.2.7 → 1.2.9

package/dist/spec/md-layout.mjs

@@ -1,16 +1,7 @@
 // SPDX-License-Identifier: MIT
 
-// `rotate`: degrees in (-180, 180], one decimal, omitted when 0; never written for a Rapier drawing (its turn lives in its SVG).
-// `opacity`: a picture's fade, a whole percent from 5 to 100, omitted at 100; the picture's bytes never change.
-// `lines`: a picture or paragraph's initial letter spans 1 to 12 lines, from the first line's cap height to the Nth
-// baseline. A picture keeps its aspect ratio; never with `width`.
-// `first`/`indent`: signed levels of 2em, at most six decimals, in [-64,64], omitted at zero. `marker` moves a list
-// item's marker independently of its words, on the same scale; only the item's leading paragraph carries it.
-// `lock=on`: a picture locked in place: a tap goes to the words, never the picture; a hold takes it to unlock it. Omitted when off.
-// `hyphens=auto`, `caps=small`, `hanging=on`: paragraph typography; absence preserves ordinary text.
 export const fields = new Set(['align', 'width', 'lines', 'wrap', 'x', 'y', 'rotate', 'opacity', 'first', 'indent', 'marker', 'lock', 'hyphens', 'caps', 'hanging']);
 export const alignments = new Set(['left', 'center', 'right', 'justify']);
-// `behind`/`front`: out of flow; the paragraph lays out as though the picture were absent.
 export const wraps = new Set(['around', 'box', 'behind', 'front']);
 const has = (value, key) => Object.hasOwn(value, key);
 const percent = value => typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 100;
@@ -18,7 +9,6 @@ const lineCount = value => Number.isInteger(value) && value >= 1 && value <= 12;
 export const INDENT_LIMIT = 64;
 export const indentLevel = value => typeof value === 'number' && Number.isFinite(value) && value !== 0 &&
   Math.abs(value) <= INDENT_LIMIT && Number(value.toFixed(6)) === value;
-// A key press advances an imported measure by one level without truncating its fraction or jumping across zero.
 export function stepIndent(value, step) {
   const next = Number(((value || 0) + step).toFixed(6));
   if (Math.abs(next) > INDENT_LIMIT) return value || 0;
@@ -27,7 +17,6 @@ export function stepIndent(value, step) {
 const oneDecimalDegrees = value => typeof value === 'number' && Number.isFinite(value) &&
   value > -180 && value <= 180 && Math.abs(value * 10 - Math.round(value * 10)) < 1e-9;
 
-/** Validate values independently of their Markdown attachment context. */
 export function validLayout(value) {
   if (!value || typeof value !== 'object' || Array.isArray(value) ||
       Object.keys(value).some(key => !fields.has(key))) return false;
@@ -48,7 +37,6 @@ export function validLayout(value) {
     !(has(value, 'align') && (has(value, 'wrap') || has(value, 'x')));
 }
 
-/** Parse the closed v1 grammar. Geometry values are returned as numbers. */
 export function parseLayout(comment) {
   if (typeof comment !== 'string' || /[^\t\x20-\x7e]/.test(comment)) return null;
   const match = /^<!--md-layout:v1[ \t]+([^\r\n]*?)[ \t]*-->$/.exec(comment);
@@ -65,12 +53,10 @@ export function parseLayout(comment) {
           number[1] === '100' && /[1-9]/.test(number[2] || '')) return null;
       value[key] = Number(raw.slice(0, -1));
     } else if (key === 'y') {
-      // Negative allowed; signed like rotate, never "-0em".
       const number = /^(-)?(0|[1-9]\d*)(?:\.\d+)?em$/.exec(raw);
       if (!number || (number[1] && Number(raw.slice(1, -2)) === 0)) return null;
       value.y = Number(raw.slice(0, -2));
     } else if (key === 'rotate') {
-      // No '+', exponent, '°' or "-0deg"; 0 is unsigned.
       const number = /^(-)?(0|[1-9]\d*)(?:\.(\d))?deg$/.exec(raw);
       if (!number) return null;
       const magnitude = Number(number[2] + (number[3] ? '.' + number[3] : ''));
@@ -90,16 +76,12 @@ export function parseLayout(comment) {
   return validLayout(value) ? value : null;
 }
 
-// Comment delimiters are unsafe in sanitized attributes. Markdown stays literal;
-// rendered attributes carry encodeURIComponent(marker), including its '%' signs.
 export function decodeLayoutAttribute(value) {
   try { return decodeURIComponent(value || ''); } catch (_) { return ''; }
 }
 
 export const parseLayoutAttribute = value => parseLayout(decodeLayoutAttribute(value));
 
-// Indentation uses the document's body type, including on headings. Native table measurements
-// become ordinary CSS points; an item's margin is compensated by its paragraph and nested list.
 export function textStyle(value, {portable = false, pointSize, indentOffset = 0} = {}) {
   if (!validLayout(value)) return '';
   const property = {first: 'text-indent', indent: 'margin-inline-start'};
@@ -115,9 +97,6 @@ export function textStyle(value, {portable = false, pointSize, indentOffset = 0}
   return css.join(';');
 }
 
-// Raw HTML tables carry ordinary paragraph CSS. Read the browser's parsed declarations on the same
-// admitted scale; the native caller supplies the body's point size. A list marker belongs to its own li,
-// never to a paragraph or a picture.
 export function textLayout(style, {listMarker = false, pointSize, offset = 0} = {}) {
   const value = {};
   for (const [key, property] of (listMarker ? [['marker', 'margin-inline-start']] : [['first', 'text-indent'], ['indent', 'margin-inline-start']])) {
@@ -125,16 +104,12 @@ export function textLayout(style, {listMarker = false, pointSize, offset = 0} =
     const match = /^(-?(?:0|[1-9]\d*)(?:\.\d{1,6})?)(em|pt)$/.exec(raw);
     const level = Number(((match ? Number(match[1]) / (match[2] === 'pt' ? pointSize : 1) / 2 : 0) +
       (key === 'first' ? 0 : offset)).toFixed(6));
-    // Public CSS may compensate an enclosing item's margin; the resolved native coordinate,
-    // rather than each intermediate declaration, is the measurement the writer must keep.
     if (Number.isFinite(level) && level) value[key] = level;
   }
   if (!listMarker && style?.getPropertyValue('hyphens').trim() === 'auto') value.hyphens = 'auto';
   return value;
 }
 
-// The picture's own CSS: its normal-flow width and x, its height in lines, and its fade. `1cap` is the cap height of the
-// picture's own text; a renderer that sets the picture beside its anchor measures that paragraph's line and cap instead.
 export function imageStyle(value) {
   if (!validLayout(value)) return '';
   const parts = [];
@@ -144,7 +119,6 @@ export function imageStyle(value) {
       decimal(Number(Math.max(0, Math.min(100 - width, value.x - width / 2)).toFixed(6))) + '%;margin-right:0';
     parts.push('width:' + decimal(width) + '%;height:auto' + left);
   }
-  // Wider than the column at its own aspect, it is contained in the N-line box, never stretched.
   if (value.lines != null) parts.push('width:auto;max-width:100%;height:' + linesHeightCss(value.lines) + ';object-fit:contain');
   if (value.opacity != null && value.opacity < 100) parts.push('opacity:' + decimal(value.opacity / 100));
   return parts.join(';');
@@ -152,23 +126,17 @@ export function imageStyle(value) {
 
 export const linesHeightCss = lines => lines === 1 ? '1cap' : 'calc(' + (lines - 1) + ' * var(--md-line, 1.6em) + 1cap)';
 
-// An HTML object has an outer clip box and an independent browser viewport.
-// SCALE keeps that authored viewport; REFLOW keeps measured content height.
 export function objectHeight(width, naturalHeight, attrs, line) {
   if (attrs.height && attrs.height !== 'auto') return Math.min(4096, Number(attrs.height) * line);
   const [w, h] = (attrs.viewport || '640x360').split('x').map(Number);
   return attrs.resize === 'scale' ? Math.min(4096, width * h / w) : naturalHeight;
 }
 
-// Controls remain real DOM nodes while their surrounding text flows. A checkbox, link or
-// disclosure is not a reason to exclude its entire block from picture placement.
 export function wrapTextBlock(element) {
   return element && /^(P|H[1-6]|UL|OL|BLOCKQUOTE|DETAILS|DL)$/.test(element.tagName) &&
     element.textContent.trim() && !element.querySelector('img,table,pre,figure,math,.math-rendered') ? element : null;
 }
 
-// The one wrap-owner rule (layout/browser.js, kit/render.mjs, editor/share.js): text after, else before, skipping pictures,
-// metadata and empty paragraphs; any other block is a barrier in that direction.
 export function wrapNeighbour(node, classify, step = (n, direction) => n && n[direction > 0 ? 'nextElementSibling' : 'previousElementSibling']) {
   for (const direction of [1, -1]) {
     for (let sibling = step(node, direction); sibling; sibling = step(sibling, direction)) {
@@ -182,7 +150,6 @@ export function wrapNeighbour(node, classify, step = (n, direction) => n && n[di
   return null;
 }
 
-// Narrower than this, a line breaker splits words letter by letter.
 export function wrapColumnFloor(fontSize) {
   return Math.max(40, 3.5 * (fontSize || 16));
 }
@@ -199,7 +166,6 @@ function decimal(value) {
   return digits.slice(0, point) + '.' + digits.slice(point);
 }
 
-/** Write only the supplied facts; no alignment is implied by absence. */
 export function formatLayout(value) {
   if (!validLayout(value)) throw new TypeError('invalid_markdown_layout');
   const pairs = [];

package/dist/spec/md-marks.mjs

@@ -1,8 +1,6 @@
 // SPDX-License-Identifier: MIT
-// The one owner of inline typography, ink and page breaks.
 import {markdownSourcePositions} from './md-source.mjs';
 
-// The exported page retains this reader alone. The editor uses the same closure, then adds its writers and scans.
 const inkReader = () => {
 	// SPDX-License-Identifier: MIT
 	const TEXT_COLOR_NAMES = Object.freeze({ green: '#1c7547', red: '#b32034', blue: '#175dc4', gold: '#865818', purple: '#7924d7' });
@@ -10,16 +8,6 @@ const inkReader = () => {
 	const COLOR_NAME_ALT = Object.keys(TEXT_COLOR_NAMES).join('|');
 	const COLOR_VALUE = '(?:#[0-9a-f]{6}|' + COLOR_NAME_ALT + ')';
 
-	// Ink (docs/markdown-standard.md, "Ink"): a pen stroke that stays with the words it marks, a paired comment with the color span's shape. The
-	// opener holds the stroke:
-	//   <!--ink KIND [NUMBER] [COLOUR] [w=N] [box=W,H] [at=X,Y] [PATH]-->words<!--/ink-->
-	// KIND is the stroke's kind, decided once when it was lifted; COLOUR is exactly the color span's value, red when absent; box is the frame's
-	// size when the stroke was drawn and at the frame's offset from the words' box, both in hundredths of an em; w is the pen's width as Draw
-	// counts a nib (2 to 24; 9 is the default and is never written): the stroke is drawn 0.11 em wide at 9 and in proportion to w otherwise; PATH
-	// is the stroke, its first point absolute in the frame and the rest as moves, hundredths of an em. One spelling: the fields in this order,
-	// one space between, integers only. A comment that does not read this way is ordinary comment text and marks nothing. Ink pairs nest:
-	// each closer takes the innermost open ink opener. Arrow/end alone take a pairing number, an end takes no other data; under, strike and arrow may omit a path for a line
-	// derived from their words.
 	const INK_KINDS = Object.freeze(['under', 'strike', 'ring', 'bracket', 'free', 'arrow', 'end']);
 
 	const INK_PATH_MAX = 160;
@@ -88,7 +76,6 @@ export const FONT_STACKS = Object.freeze({
 	hand: Object.freeze({stack: 'hand', css: 'cursive', word: 'Segoe Print'}),
 });
 
-// A family is one font-table name, never a CSS list or an HTML fragment.
 export function normalizeFontFamily(value) {
 	if (typeof value !== 'string') return null;
 	const family = value.trim();
@@ -106,8 +93,6 @@ export function formatFontRun(family, content) {
 	return typography.wrap({family}, content);
 }
 
-// One typed interpretation for source, DOM and native-file adapters. The worker carries this
-// exact factory and its explicit grammar inputs; no DOM, CSS evaluator or resource loader.
 export function createTypography({normalizeFontFamily, fontFamilyCss, FONT_STACKS}) {
 	const LIMIT = 4096, DEPTH = 64;
 	const generics = {serif: 'serif', 'sans-serif': 'sans', monospace: 'mono', cursive: 'hand',
@@ -127,7 +112,6 @@ export function createTypography({normalizeFontFamily, fontFamilyCss, FONT_STACK
 	function color(value) {
 		if (typeof value !== 'string') return null;
 		if (/^#[0-9a-f]{6}$/i.test(value.trim())) return value.trim().toLowerCase();
-		// CSSOM serializes admitted hex to opaque rgb(). Native HTML import uses this same boundary.
 		const rgb = /^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*1\s*)?\)$/i.exec(value.trim());
 		return rgb && rgb.slice(1).every(channel => Number(channel) <= 255)
 			? '#' + rgb.slice(1).map(channel => Number(channel).toString(16).padStart(2, '0')).join('') : null;
@@ -154,7 +138,6 @@ export function createTypography({normalizeFontFamily, fontFamilyCss, FONT_STACK
 			}
 		} else if (!/^[\p{L}_-][\p{L}\p{N}_ -]*$/u.test(css) || /^(?:inherit|initial|unset|revert|revert-layer)$/i.test(css)) return null;
 		name = normalizeFontFamily(name);
-		// These five names are the existing family-choice aliases, not custom font identities.
 		if (name && Object.hasOwn(FONT_STACKS, name.toLowerCase())) return null;
 		return name ? Object.freeze({name, css: '"' + name.replace(/[\\"]/g, '\\$&') + '"', custom: true}) : null;
 	}
@@ -178,8 +161,6 @@ export function createTypography({normalizeFontFamily, fontFamilyCss, FONT_STACK
 		}
 		return Object.freeze(result);
 	}
-	// Rendering drops unsupported declarations; rich editing admits only wholly owned
-	// spans so unrelated HTML and rejected attributes keep their exact-source editor.
 	function parseStyle(value, editable = false) {
 		if (typeof value !== 'string' || value.length > LIMIT) return editable ? null : Object.freeze({});
 		const parts = []; let quote = '', start = 0;
@@ -212,15 +193,11 @@ export function createTypography({normalizeFontFamily, fontFamilyCss, FONT_STACK
 	const wrap = (value, content) => {
 		const start = open(value);
 		if (!start || !content) return content;
-		// Importers can supply a styled break by itself, or before/after words. Keep
-		// those exact line-edge bytes outside the new span so its opener has words.
 		const prefix = /^(?:[ \t]*(?:\r\n|\r(?!\n)|\n))+/.exec(content)?.[0] || '';
 		let body = content.slice(prefix.length);
 		const suffix = /(?:[ \t]*(?:\r\n|\r(?!\n)|\n))+[ \t]*$/.exec(body)?.[0] || '';
 		body = body.slice(0, body.length - suffix.length);
 		if (!body) return content;
-		// Soft/hard line breaks can belong to one Markdown paragraph. A blank line or
-		// an opener on a line of its own would instead change the block grammar.
 		if (/^\s*\n|\n[ \t]*\n/.test(body.replace(/\r\n?/g, '\n')))
 			throw new TypeError('Typography wraps one inline paragraph at a time.');
 		return prefix + start + body + '</span>' + suffix;
@@ -323,8 +300,6 @@ const inkPair = (value, name, nonNegative = false) => {
 	return pair;
 };
 
-// {kind, id?, hex?, width?, box?, at?, path?} to the opener; the path's points are absolute in the frame and become moves after the
-// first. Refuses with a TypeError rather than writing a spelling the reader would not read.
 export function formatInkOpen(mark) {
 	if (!mark || typeof mark !== 'object') throw new TypeError('ink: a mark is an object');
 	if (!INK_KINDS.includes(mark.kind)) throw new TypeError('ink: the kind is one of ' + INK_KINDS.join(', '));
@@ -358,7 +333,6 @@ export function formatInkRun(mark, content) {
 	return formatInkOpen(mark) + content + INK_CLOSE;
 }
 
-// Returns {mark, length in UTF-16 units} or null; not end-anchored.
 export function matchInkOpen(text) {
 	if (typeof text !== 'string') return null;
 	const match = new RegExp('^' + INK_OPEN_PATTERN).exec(text);
@@ -367,10 +341,6 @@ export function matchInkOpen(text) {
 	return mark && { mark, length: match[0].length };
 }
 
-// The opener's body is what a rendered span carries (a renderer's sanitizer drops an attribute whose value holds the
-// comment's own close): the opener after `<!--ink ` and before `-->`, so the attribute reads `under red box=… 0,95 …`,
-// and only a body that reads as a mark goes back. Read and write through the same grammar, so an invalid body cannot
-// invent a mark.
 export function inkOpenBody(opener) {
 	if (typeof opener !== 'string') return null;
 	const match = new RegExp('^' + INK_OPEN_PATTERN + '$').exec(opener);
@@ -384,10 +354,6 @@ export function isInkClose(comment) {
 	return comment === INK_CLOSE;
 }
 
-// Every ink marker in order: {start, end, mark} for an opener (mark null for a closer, and an opener whose path
-// overflows is not a marker at all).
-// Without a prior arrow or adjacent marker bytes, only an edit boundary can empty a span.
-// Read those boundaries through the planned rows before asking the full grammar to retire ink.
 export function mayRetireInk(source, rows) {
   if (source.contains('<!--ink arrow ') || source.contains('<!--ink end ') || source.contains('--><!--')) return true;
   let pieces = [{from: 0, length: source.length}], length = source.length;
@@ -430,20 +396,14 @@ export function scanInkMarkers(source) {
 	return markers;
 }
 
-// Ink nests so independent strokes can share the same words. A marker that pairs with nothing is text
-// (it shows nothing and marks nothing) and is listed under strays.
 export function pairInkMarkers(source, markers = null) {
 	return pairMarkers(source, 'ink', markers);
 }
 
-// A document parser may supply its semantic markers, leaving literal code comments untouched.
-// Local inline parsing and source planners need an endpoint's span even when its mate is in another block.
 export function pairInkSpans(source, markers = null) {
 	return pairSpanMarkers(source, 'ink', markers);
 }
 
-// Color keeps its first opener; ink pairs each closer with the innermost opener. The shared range
-// shape lets custody owners keep every independent stroke, including strokes on identical words.
 export function pairMarkers(source, kind, markers = null) {
 	const paired = pairSpanMarkers(source, kind, markers);
 	if (kind !== 'ink') return paired;
@@ -470,9 +430,6 @@ export function pairMarkers(source, kind, markers = null) {
 	return { runs, strays, arrows };
 }
 
-// Where a Will marker may stand (docs/will.md, Conversion). A pair inside a fence, a raw HTML block
-// (until its blank line) or the opening front matter is text: the line is quoted,
-// and a Word or PDF writer that met it as a marker would govern the wrong region. The same frame
 // as spec/frontmatter.mjs, copied here so this grammar stays inside the MIT kit's closure.
 const WILL_BLOCK_TAGS = new Set('address article aside base basefont blockquote body caption center col colgroup dd details dialog dir div dl dt fieldset figcaption figure footer form frame frameset h1 h2 h3 h4 h5 h6 head header hr html iframe legend li link main menu menuitem nav noframes ol optgroup option p param search section summary table tbody td tfoot th thead title tr track ul'.split(' '));
 const WILL_VOID_TAGS = new Set('area base br col embed hr img input link meta param source track wbr'.split(' '));
@@ -620,9 +577,6 @@ function willLeaf(stack) {
 	return kind === 'fence' || kind === 'pre' || kind === 'html' || kind === 'raw';
 }
 
-// `spans` are [start, end) of marker lines in `source` (the Will reader's own offsets).
-// Returns the first quoted span, {start, end, where}, or null when every span may stand.
-// `where` is `fence`, `raw-pre`, `raw-div`, `raw-table`, `raw-html` (any other raw HTML block) or `frontmatter`.
 export function quotedWillSpan(source, spans) {
 	const text = String(source ?? '');
 	const marks = Array.isArray(spans) ? spans : [];
@@ -703,8 +657,6 @@ function pairSpanMarkers(source, kind, markers = null) {
 	return { runs, strays };
 }
 
-// Copy carries an arrow only when both complete anchor words are selected. A partial selection removes just
-// its endpoint comments from the copied slice, including a comment clipped at the selection's boundary.
 export function sliceInkArrows(source, start = 0, end = String(source ?? '').length, markers = null) {
 	const text = String(source ?? '');
 	if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start < 0 || end < start || end > text.length) throw new RangeError('ink: invalid source slice');
@@ -728,8 +680,6 @@ export function sliceInkArrows(source, start = 0, end = String(source ?? '').len
 	return result + text.slice(at, end);
 }
 
-// The paste owns only its incoming markers: an orphan cannot adopt an existing document's endpoint, and a
-// complete pair with an occupied number gets a new number in both openers without rewriting its stroke bytes.
 export function prepareInkPaste(source, existing = '', markers = null) {
 	const text = String(source ?? ''), paired = pairInkMarkers(text, markers), edits = [];
 	for (const marker of paired.strays) if (marker.mark?.id != null || marker.arrowId != null) edits.push({ start: marker.start, end: marker.end, text: '' });
@@ -767,7 +717,6 @@ export function hasInkMarker(text) {
 	return scanInkMarkers(text).length > 0;
 }
 
-// The only spelling.
 export function formatPageBreak() {
 	return PAGE_BREAK_MARKER;
 }

package/dist/spec/md-source.mjs

@@ -1,9 +1,6 @@
 // SPDX-License-Identifier: MIT
 import {splitOpeningFrontmatter} from './frontmatter.mjs';
 
-// The standard parser owns literal regions and comment boundaries. Offsets are original UTF-16,
-// including BOM/CRLF and list/quote prefixes. A private parser view observes rules; it changes no
-// live rule or token. Call once per source, then ask isText(position) or isComment(start, end).
 export function markdownSourcePositions(source, parser) {
   if (typeof source !== 'string' || !parser) throw new TypeError('Source positions require text and its Markdown parser');
   const {body, bodyOffset} = splitOpeningFrontmatter(source), lines = [bodyOffset];
@@ -17,8 +14,6 @@ export function markdownSourcePositions(source, parser) {
   ruler.getRules = chain => parser.inline.ruler.getRules(chain).map(rule => (state, silent) => {
     const start = state.pos, first = state.tokens.length;
     const matched = rule(state, silent), token = state.tokens.at(-1);
-    // A pending text token may flush before this token. Never overwrite a nested rule's span
-    // with its enclosing link's range.
     if (matched && !silent && state.tokens.length > first && !observed.has(token) &&
         ['code_inline', 'html_inline', 'image', 'footnote_ref'].includes(token?.type)) {
       observed.set(token, {start, end: state.pos, source: state.src,
@@ -28,8 +23,6 @@ export function markdownSourcePositions(source, parser) {
     }
     return matched;
   });
-  // A core rule may rewrite an inline token's content after its children were parsed (a task item drops
-  // its `[ ] `). Map rows from the text the inline rules read.
   const read = new WeakMap();
   inline.parse = function (text, md, env, children) { read.set(children, text); return parser.inline.parse.call(this, text, md, env, children); };
   const {tokens, cells} = markdownTableSources(body, owner, {}, lines);
@@ -37,8 +30,6 @@ export function markdownSourcePositions(source, parser) {
     for (const child of children || []) {
       const span = observed.get(child);
       if (!span || span.source !== content) continue;
-      // Inline footnotes are moved to a generated footer without line maps. Their parser-owned
-      // child tokens still stand inside the original ^[...] carrier, not in that footer.
       if (span.footnote?.tokens) {
         readInline(span.footnote.tokens, span.footnote.content, pos => rawOffset(span.start + 2 + pos));
       } else if (child.type !== 'footnote_ref') {
@@ -58,9 +49,6 @@ export function markdownSourcePositions(source, parser) {
     if (token.map && ['fence', 'code_block', 'html_block', 'reference_definition'].includes(token.type)) {
       const start = lineAt(token.map[0]), end = lineAt(token.map[1]);
       add(start, end);
-      // A comment-carrier block can contain several adjacent comments. Keep each carrier,
-      // including a closer surviving damage to its opener. Never promote nested comments or
-      // comment-shaped text in a raw tagged HTML block (pre, script, div, ...).
       if (token.type === 'html_block' && /^\s*<!--/.test(token.content)) {
         let at = source.indexOf('<!--', start);
         while (at >= start && at < end) {
@@ -81,8 +69,6 @@ export function markdownSourcePositions(source, parser) {
       for (let i = 0; i < rows.length; i++) {
         const start = lineAt(token.map[0] + i), end = lineAt(token.map[0] + i + 1), line = source.slice(start, end).replace(/\0/g, '\ufffd');
         let at = line.indexOf(rows[i]), lead = 0;
-        // A container that consumes part of a tab leaves the rest as spaces the source does not hold.
-        // They all stand for that tab.
         if (at < 0) { const rest = rows[i].replace(/^ +/, ''); lead = rows[i].length - rest.length; at = line.indexOf(rest); if (!lead || line[at - 1] !== '\t') at = -1; }
         if (at < 0) throw new Error('Markdown inline source mapping failed');
         starts.push(local); spaces.push(lead); offsets.push(start + at - lead); local += rows[i].length + 1;
@@ -113,8 +99,6 @@ export function markdownSourcePositions(source, parser) {
   return {isText, isComment: (start, end) => comments.get(start) === end, typography: typography.sort((a, b) => a.start - b.start)};
 }
 
-// Capture only table-cell provenance while the parser still owns container-adjusted row
-// bounds. Looking for cell text in a whole row aliases literal pipes and quote/list markers.
 export function markdownTableSources(source, parser, environment, lineStarts = null, parse = null) {
   const cells = new WeakMap();
   const read = owner => {

package/dist/spec/word-sidecar.mjs

@@ -1,6 +1,4 @@
 // SPDX-License-Identifier: MIT
-// An inert document asset, kept in Source and excluded from the reading surface.
-// This is recognition only: interchange/docx.mjs admits the bounded JSON and native XML.
 export const WORD_SIDECAR_OPEN = '<!-- rapier-word:v1\n';
 export function isWordSidecarBlock(raw) {
   return typeof raw === 'string' && /^<!-- rapier-word:v1\r?\n[^\r\n]*\r?\n-->[ \t\r\n]*$/.test(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapier-markdown-kit",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "Read, render and write Self-contained Markdown: one .md file that carries its pictures, drawings and layout, and that any Markdown app can read. HTML renderer, stylesheet, text layout, Will/1 agent permissions, and an edit history with authorship and offline merge. MIT, no dependencies.",
   "keywords": [
     "markdown",
@@ -40,17 +40,34 @@
   "main": "./dist/kit/index.mjs",
   "exports": {
     ".": "./dist/kit/index.mjs",
+    "./markdown-it": {
+      "types": "./dist/kit/markdown-it.d.mts",
+      "default": "./dist/kit/markdown-it.mjs"
+    },
     "./layout": "./dist/kit/layout.mjs",
     "./marks": "./dist/kit/marks.mjs",
     "./model": "./dist/kit/model.mjs",
     "./typography": "./dist/kit/typography.mjs",
-    "./will": "./dist/kit/will.mjs",
+    "./will": {
+      "types": "./dist/kit/will.d.mts",
+      "default": "./dist/kit/will.mjs"
+    },
     "./assets": "./dist/kit/assets.mjs",
     "./style.css": "./style.css",
     "./package.json": "./package.json",
     "./render": "./dist/kit/render-entry.mjs",
-    "./rapier-ledger": "./dist/kit/rapier-ledger.mjs",
-    "./ledger/carried": "./dist/kit/ledger/carried.mjs"
+    "./rapier-ledger": {
+      "types": "./dist/kit/ledger.d.mts",
+      "default": "./dist/kit/ledger.mjs"
+    },
+    "./pdf": {
+      "types": "./dist/kit/pdf-source.d.mts",
+      "default": "./dist/kit/pdf-source.mjs"
+    },
+    "./ledger/carried": {
+      "types": "./dist/kit/ledger/carried.d.mts",
+      "default": "./dist/kit/ledger/carried.mjs"
+    }
   },
   "repository": {
     "type": "git",

package/style.css

@@ -6,6 +6,7 @@
 /* The reference scale's unit (docs/markdown-standard.md, "The reference scale"): 16 px at M, a length every reader can read
    back as pixels (a planner scales its own lengths by it). */
 @property --md-unit{syntax:'<length>';inherits:true;initial-value:16px}
+@property --md-item-line{syntax:'<length>';inherits:true;initial-value:0px}
 :root,.md-render{
 	--md-unit:1rem;
 	--md-hair:calc(var(--md-unit) / 16);
@@ -251,8 +252,9 @@
 	max-height: 9rem;
 }
 
-/* Type keeps the reference line model: body 17.6/28 px at M; headings occupy two, one and a
-   half, or one body line. Compact margins use the body's size: 8 px after prose, 12 after other
+/* Type keeps the reference line model: body 17.6/28 px at M; h1 (2.2 times the body) occupies one
+   and three quarter body lines, h2 (1.75) and h3 (1.5) one and a half, h4 to h6 one, so a wrapped
+   heading sets about 1.3 of its size. Compact margins use the body's size: 8 px after prose, 12 after other
    blocks, 20 before headings and 4 after them at M. Sibling margins collapse to their maximum;
    the editor's derived neighbor gap carries the same boundary inside its measured wrapper. */
 .md-render{
@@ -263,8 +265,8 @@
 .md-render h1,.md-render h2,.md-render h3,.md-render h4,.md-render h5,.md-render h6{
 	font-family:var(--md-font-sans);letter-spacing:-0.01em;
 	line-height:var(--md-line);margin:var(--md-gap-heading-before) 0 var(--md-gap-heading-after);color:var(--md-heading-color);text-wrap:balance}
-.md-render h1{font-size:calc(var(--md-text-body) * 2.6);line-height:calc(var(--md-line) * 2);font-weight:var(--md-fw-semibold)}
-.md-render h2{font-size:calc(var(--md-text-body) * 1.9);line-height:calc(var(--md-line) * 1.5);font-weight:var(--md-fw-semibold)}
+.md-render h1{font-size:calc(var(--md-text-body) * 2.2);line-height:calc(var(--md-line) * 1.75);font-weight:var(--md-fw-semibold)}
+.md-render h2{font-size:calc(var(--md-text-body) * 1.75);line-height:calc(var(--md-line) * 1.5);font-weight:var(--md-fw-semibold)}
 .md-render h3{font-size:calc(var(--md-text-body) * 1.5);line-height:calc(var(--md-line) * 1.5);font-weight:var(--md-fw-semibold)}
 .md-render h4{font-size:calc(var(--md-text-body) * 1.25);font-weight:var(--md-fw-semibold)}
 /* h5/h6 complete the six-level hierarchy: modest but owned (explicit size/weight/color), never
@@ -361,21 +363,28 @@
 	position:relative;
 	--md-marker:0px;
 	counter-increment:rapier-ol;
-	min-height:0;
-	padding-top:0;
+	/* The circle's size follows the item's own line (--md-item-line is registered, so 1lh resolves here on the li,
+	   not in the marker's font): 2 units from the house line of 1.75 units up, never taller than the line at 1.48 units
+	   or less, growing in between. The li makes room for it: at the house line exactly 0.15 units above
+	   and 2 units' height, none once the circle fits the line. */
+	--md-item-line:1lh;
+	--md-ol-circle:min(2 * var(--md-unit), max(var(--md-item-line), 2 * var(--md-item-line) - 1.48 * var(--md-unit)));
+	--md-ol-top:calc(min(0.15 * var(--md-unit), 0.6 * max(0px, var(--md-ol-circle) - var(--md-item-line))) - min(0.125 * var(--md-unit), max(0px, var(--md-ol-circle) - var(--md-item-line)) / 2) + max(0px, var(--md-item-line) - var(--md-ol-circle)) / 2);
+	min-height:var(--md-ol-circle);
+	padding-top:min(0.15 * var(--md-unit), 0.6 * max(0px, var(--md-ol-circle) - var(--md-item-line)));
 }
 .md-render ol>li::before{
 	content:counter(rapier-ol);
 	position:absolute;
-	/* The circle is centered on the item's first line: the li's own padding, plus half of what the 2rem circle is taller than one line. */
-	inset-inline-start:calc(-2.75 * var(--md-unit) + var(--md-marker, 0px)); top:0;
-	width:min(2 * var(--md-unit), 1lh); height:min(2 * var(--md-unit), 1lh);
+	/* Centered on the item's first line and on the dotted line's axis, 1.75 units before the item's text. */
+	inset-inline-start:calc(-1.75 * var(--md-unit) - var(--md-ol-circle) / 2 + var(--md-marker, 0px)); top:var(--md-ol-top);
+	width:var(--md-ol-circle); height:var(--md-ol-circle);
 	display:flex; align-items:center; justify-content:center;
 	border:2px solid var(--md-color-line);
 	border-radius:999px;
 	background:var(--md-color-bg);
 	color:var(--md-color-line);
-	font:var(--md-fw-semibold) calc(0.95 * var(--md-unit))/1 var(--md-font-sans);
+	font:var(--md-fw-semibold) min(0.95 * var(--md-unit), 0.55 * var(--md-ol-circle))/1 var(--md-font-sans);
 	font-variant-numeric:tabular-nums;
 	box-sizing:border-box;
 	z-index:1;
@@ -386,8 +395,10 @@
 	position:absolute;
 
 	inset-inline-start:calc(calc(-1.75 * var(--md-unit)) - 1.5px + var(--md-marker, 0px));
-	top:calc(2.2 * var(--md-unit));
-	bottom:calc(var(--md-line) / -4);
+	/* From just below this circle into the next one: at least to the next item's top (--md-item-gap is the gap between
+	   items the spacing settings give), and at least a quarter line, which the next circle covers. */
+	top:calc(var(--md-ol-top) + 1.0875 * var(--md-ol-circle));
+	bottom:calc(-1 * max(var(--md-item-gap, 0px), var(--md-line) / 4));
 	border-inline-start:3px dotted var(--md-color-line);
 	z-index:0;
 }
@@ -411,7 +422,7 @@
 .md-render li{margin:0 0 calc(var(--md-line) / 4)}
 .md-render li:last-child{margin-bottom:0}
 .md-render li>ul,.md-render li>ol{margin:calc(var(--md-line) / 4) 0 0}
-.md-render a{color:var(--md-color-accent-text);text-decoration:underline;text-underline-offset:2px}
+.md-render a{color:var(--md-color-accent-text);text-decoration:underline;text-underline-offset:2px;unicode-bidi:isolate}
 /* The house focus (rapier-app.css) in the document and on the exported page: the underline thickens, no ring. */
 .md-render a:focus-visible,.md-render ul.rapier-jump-list>li>a:focus-visible,.md-render .footnote-ref a:focus-visible,.md-render summary:focus-visible{outline:none;text-decoration:underline;text-decoration-thickness:3px;text-underline-offset:.2em}
 
@@ -425,37 +436,43 @@
 .md-render .rapier-jump-label strong{font:inherit}
 .md-render ul.rapier-jump-list{
 	--md-jump-gap:calc(.9 * var(--md-unit));
+	--md-jump-pad:calc(.18 * var(--md-unit));
+	--md-jump-circle:10px;
 	--md-jump-marker-inline-start:calc(-1.18 * var(--md-unit));
-	--md-jump-marker-center:1em;
 	list-style:none;
 	padding-inline-start:calc(1.85 * var(--md-unit));
 	margin:0 0 var(--md-gap-block);
 }
 .md-render ul.rapier-jump-list>li{
 	position:relative;
+	/* The circle sits on the first line's center: --md-item-line is registered, so 1lh resolves here on the li. */
+	--md-item-line:1lh;
+	--md-jump-circle-top:calc(var(--md-jump-pad) + (var(--md-item-line) - var(--md-jump-circle)) / 2);
 	margin:0 0 var(--md-jump-gap);
-	padding:calc(.18 * var(--md-unit)) 0 calc(.18 * var(--md-unit)) calc(.15 * var(--md-unit));
+	padding:var(--md-jump-pad) 0 var(--md-jump-pad) calc(.15 * var(--md-unit));
 }
 .md-render ul.rapier-jump-list>li:last-child{margin-bottom:0}
 .md-render ul.rapier-jump-list>li::before{
 	content:'';
 	position:absolute;
 	inset-inline-start:var(--md-jump-marker-inline-start);
-	top:calc(var(--md-jump-marker-center) - 5px);
-	width:10px;height:10px;
+	top:var(--md-jump-circle-top);
+	width:var(--md-jump-circle);height:var(--md-jump-circle);
 	box-sizing:border-box;
 	border:2px solid var(--md-color-accent-text);
 	background:var(--md-color-bg);
 	border-radius:50%;
 	z-index:1;
 }
+/* The dotted line is a numbered list's (3px, the text's black or white): from below this circle to the next circle's
+   center, which covers its end; none after the last item. --md-item-gap is the gap the spacing settings give. */
 .md-render ul.rapier-jump-list>li:not(:last-child)::after{
 	content:'';
 	position:absolute;
-	inset-inline-start:calc(var(--md-jump-marker-inline-start) + 4px);
-	top:var(--md-jump-marker-center);
-	bottom:calc(0px - var(--md-jump-gap) - var(--md-jump-marker-center));
-	border-inline-start:2px dotted color-mix(in srgb,var(--md-color-accent-text) 42%,transparent);
+	inset-inline-start:calc(var(--md-jump-marker-inline-start) + var(--md-jump-circle) / 2 - 1.5px);
+	top:calc(var(--md-jump-circle-top) + var(--md-jump-circle));
+	bottom:calc(-1 * (var(--md-item-gap, var(--md-jump-gap)) + var(--md-jump-circle-top) + var(--md-jump-circle) / 2));
+	border-inline-start:3px dotted var(--md-color-line);
 	z-index:0;
 }
 .md-render ul.rapier-jump-list>li>a{