@stll/folio-core 0.63.0 → 0.64.0

package/dist/fonts/sfnt/woff.js

@@ -12,7 +12,8 @@ import { inflateSync } from "node:zlib";
 * `glyf`/`loca` transform has to be reversed and Brotli decoded), so it is
 * rejected here rather than half-supported.
 */
-var WoffDecodeError = class extends TaggedError("WoffDecodeError") {};
+const WoffDecodeErrorBase = TaggedError("WoffDecodeError");
+var WoffDecodeError = class extends WoffDecodeErrorBase {};
 const fail = (message) => Result.err(new WoffDecodeError({ message }));
 /** Byte offsets inside the WOFF header. */
 const WOFF_HEADER = {

package/dist/headless-layout.d.ts

@@ -6,7 +6,7 @@ import { BlockLookup } from "./layout-painter/index.js";
 import { PageFurnitureInputs } from "./display-list/build/furniture.js";
 import { DocumentFeatures } from "./display-list/build/buildDisplayList.js";
 import { Node } from "prosemirror-model";
-import { Result } from "better-result";
+import { Result, TaggedErrorClass } from "better-result";
 //#region src/headless-layout.d.ts
 /**
  * Constructs the painter takes from render options rather than from `Layout`.
@@ -26,8 +26,8 @@ export type HeadlessLayoutGap = {
   readonly story: never;
   readonly detail: string;
 };
-declare const HeadlessLayoutError_base: import("better-result").TaggedErrorClass<"HeadlessLayoutError">;
-export declare class HeadlessLayoutError extends HeadlessLayoutError_base<{
+declare const HeadlessLayoutErrorBase: TaggedErrorClass<"HeadlessLayoutError">;
+export declare class HeadlessLayoutError extends HeadlessLayoutErrorBase<{
   message: string;
   cause?: unknown;
 }> {}

package/dist/headless-layout.js

@@ -64,7 +64,8 @@ const formatEndnoteTexts = (numbers, formatNumber) => {
 	for (const [id, displayNumber] of numbers) texts.set(id, formatNumber(displayNumber));
 	return texts;
 };
-var HeadlessLayoutError = class extends TaggedError("HeadlessLayoutError") {};
+const HeadlessLayoutErrorBase = TaggedError("HeadlessLayoutError");
+var HeadlessLayoutError = class extends HeadlessLayoutErrorBase {};
 /**
 * Stories this entry still does not lay out, keyed by story so the map is total
 * over the union. `satisfies Record<…>` is what makes it total in both

package/dist/layout-engine/measure/font-metrics.worker.js

@@ -17,7 +17,8 @@ import { TaggedError } from "better-result";
 * that touches `document`, `window`, or React. The protocol module is
 * deliberately dependency-free.
 */
-var WorkerInitError = class extends TaggedError("WorkerInitError") {};
+const WorkerInitErrorBase = TaggedError("WorkerInitError");
+var WorkerInitError = class extends WorkerInitErrorBase {};
 let ctx = null;
 let initError = null;
 const FONT_FINGERPRINT_EPSILON = .01;

package/dist/layout-engine/measure/hyphenationDictionaries.d.ts

@@ -1,28 +1,11 @@
+import { TaggedErrorClass } from "better-result";
 //#region src/layout-engine/measure/hyphenationDictionaries.d.ts
-/**
- * On-demand hyphenation dictionaries for automatic hyphenation.
- *
- * Each `hyphen` pattern set is tens to hundreds of kilobytes of source whose
- * evaluation builds a pattern trie, and most documents never enable
- * `w:autoHyphenation`. A dictionary is therefore imported only once measurement
- * asks to hyphenate a word in its language. Measurement is synchronous, so the
- * first request starts the import and hyphenates nothing. A layout run wrapped
- * in {@link collectRequestedHyphenationDictionaries} learns which dictionaries
- * it lacked, so its own editor can re-run layout on load or report the failure
- * (`controller/hyphenationReadiness`). Hosts that must lay out correctly on the
- * first pass (headless layout, tests) await `preloadHyphenationDictionaries`
- * (`./hyphenationPreload`) before measuring.
- *
- * This module sits on every editor's import graph, so it speaks in its own
- * settled-state union rather than `Result`, keeping the `Result` API out of
- * adapters' type checks; the preload boundary converts.
- */
 export type HyphenateWord = (text: string) => string;
 declare const HYPHENATION_DICTIONARY_IDS: readonly ["cs", "en-gb", "en-us", "sk"];
 export type HyphenationDictionaryId = (typeof HYPHENATION_DICTIONARY_IDS)[number];
 export type HyphenationDictionaryLoaders = Readonly<Record<HyphenationDictionaryId, () => Promise<HyphenateWord>>>;
-declare const HyphenationDictionaryError_base: import("better-result").TaggedErrorClass<"HyphenationDictionaryError">;
-export declare class HyphenationDictionaryError extends HyphenationDictionaryError_base<{
+declare const HyphenationDictionaryErrorBase: TaggedErrorClass<"HyphenationDictionaryError">;
+export declare class HyphenationDictionaryError extends HyphenationDictionaryErrorBase<{
   message: string;
   dictionary: HyphenationDictionaryId;
   cause: unknown;

package/dist/layout-engine/measure/hyphenationDictionaries.js

@@ -32,7 +32,8 @@ const HYPHENATION_DICTIONARY_LOADERS = {
 	sk: async () => (await import("hyphen/sk")).default.hyphenateSync
 };
 let dictionaryLoaders = HYPHENATION_DICTIONARY_LOADERS;
-var HyphenationDictionaryError = class extends TaggedError("HyphenationDictionaryError") {};
+const HyphenationDictionaryErrorBase = TaggedError("HyphenationDictionaryError");
+var HyphenationDictionaryError = class extends HyphenationDictionaryErrorBase {};
 const createInitialStates = () => ({
 	cs: { status: "unloaded" },
 	"en-gb": { status: "unloaded" },

package/dist/layout-engine/section-breaks.d.ts

@@ -55,7 +55,7 @@ export type BreakDecision = {
   requiredParity?: "even" | "odd";
 };
 /** `w:sectPr` may omit `w:type`; §17.6.22's omitted value is `nextPage`. */
-export declare const DEFAULT_SECTION_BREAK_TYPE = "nextPage";
+export declare const DEFAULT_SECTION_BREAK_TYPE: "nextPage";
 /**
  * The section start a boundary states, with the omitted value resolved.
  *

package/dist/layout-painter/renderPage.d.ts

@@ -301,6 +301,12 @@ export type PainterPaintedDetail = {
   container: HTMLElement;
   pageCount: number;
 };
+/**
+ * Paint `shell` and its buffer neighbours now, ahead of the observer, so a
+ * navigation can scroll straight onto painted content instead of passing blank
+ * shells. No-op for containers `renderPages` did not virtualize.
+ */
+export declare function renderPagesAround(container: HTMLElement, shell: HTMLElement): void;
 /**
  * Force every virtualized page shell in `container` to be fully rendered.
  *

package/dist/layout-painter/renderPage.js

@@ -8,6 +8,7 @@ import { DEFAULT_FONT_FAMILY } from "../layout-engine/measure/measureHelpers.js"
 import { measureParagraph } from "../layout-engine/measure/measureParagraph.js";
 import { resolveTableInlineOffset } from "../layout-engine/measure/tableInlinePlacement.js";
 import { NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, floatingTextBoxReservesBand, floatingTextBoxWrapsText, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, stripFlowBlockPmAnchors } from "../layout-engine/types.js";
+import { getEditorScrollRoot } from "../paged-layout/editorScrollRoot.js";
 import { cssBorderStyle } from "../utils/borderCss.js";
 import { resolveFontFamily } from "../utils/fontResolver.js";
 import { borderToStyle } from "../utils/formatToStyle.js";
@@ -1527,6 +1528,8 @@ function applyContainerStyles(container, pageGap) {
 */
 const VIRTUALIZATION_BUFFER = 1;
 const VIRTUALIZATION_ROOT_MARGIN_PX = 1e3;
+/** Painted pages stay painted within three viewport heights of the viewport. */
+const VIRTUALIZATION_RETAIN_MARGIN_PERCENT = 300;
 const INITIAL_EAGER_RENDER_PAGES = 3;
 /**
 * Minimum page count before virtualization kicks in.
@@ -1555,7 +1558,7 @@ function renderPages(pages, container, options = {}) {
 	if (prevState && prevState.optionsHash === currentOptionsHash && useVirtualization) {
 		const prevShells = prevState.pageStates;
 		const prevDataMap = prevState.pageDataMap;
-		const observer = pc.__pageObserver;
+		const observers = pc.__pageObservers;
 		const totalPagesChanged = prevState.totalPages !== totalPages;
 		const fieldContextChanged = prevState.fieldContextHash !== currentFieldContextHash;
 		const commonCount = Math.min(prevShells.length, pages.length);
@@ -1619,13 +1622,16 @@ function renderPages(pages, container, options = {}) {
 					index: i,
 					rendered: false
 				});
-				if (observer) observer.observe(pageEl);
+				observers?.populate.observe(pageEl);
+				observers?.retain.observe(pageEl);
 			}
 		}
 		if (pages.length < prevShells.length) {
 			for (let i = prevShells.length - 1; i >= pages.length; i--) {
 				const shell = prevShells[i].element;
-				if (observer) observer.unobserve(shell);
+				observers?.populate.unobserve(shell);
+				observers?.retain.unobserve(shell);
+				prevState.retainedShells.delete(shell);
 				prevDataMap.delete(shell);
 				removeRenderedPage(shell);
 			}
@@ -1641,10 +1647,11 @@ function renderPages(pages, container, options = {}) {
 		emitPainterPainted(container);
 		return;
 	}
-	const prevObserver = pc.__pageObserver;
-	if (prevObserver) {
-		prevObserver.disconnect();
-		delete pc.__pageObserver;
+	const prevObservers = pc.__pageObservers;
+	if (prevObservers) {
+		prevObservers.populate.disconnect();
+		prevObservers.retain.disconnect();
+		delete pc.__pageObservers;
 	}
 	const pageShellClass = options.pageClassName ?? PAGE_CLASS_NAMES.page;
 	const isPageShell = (el) => el.className.split(/\s+/u).includes(pageShellClass);
@@ -1683,52 +1690,42 @@ function renderPages(pages, container, options = {}) {
 		index: i,
 		rendered: false
 	});
-	const observer = new IntersectionObserver((entries) => {
+	const observerRoot = getEditorScrollRoot(container);
+	const populate = new IntersectionObserver((entries) => {
 		const renderState = pc.__pageRenderState;
 		if (!renderState) return;
-		const { currentOptions: liveOptions, totalPages: liveTotalPages, pageDataMap: liveDataMap } = renderState;
 		for (const entry of entries) {
-			if (!(entry.target instanceof HTMLElement)) continue;
-			const shell = entry.target;
-			const data = liveDataMap.get(shell);
-			if (!data) continue;
-			if (entry.isIntersecting) {
-				populatePageShell(shell, liveDataMap, liveTotalPages, liveOptions);
-				for (let offset = -1; offset <= VIRTUALIZATION_BUFFER; offset++) {
-					const neighborIdx = data.index + offset;
-					if (neighborIdx >= 0 && neighborIdx < renderState.pageStates.length && neighborIdx !== data.index) populatePageShell(renderState.pageStates[neighborIdx].element, liveDataMap, liveTotalPages, liveOptions);
-				}
-			}
-		}
-		const viewportHeight = window.innerHeight;
-		const nearThreshold = viewportHeight * 3;
-		const nearIndices = /* @__PURE__ */ new Set();
-		let depopulated = false;
-		for (const [el, data] of liveDataMap) {
-			if (!data.rendered) continue;
-			const rect = el.getBoundingClientRect();
-			if (rect.bottom > -nearThreshold && rect.top < viewportHeight + nearThreshold) nearIndices.add(data.index);
-		}
-		for (const [el, data] of liveDataMap) {
-			if (!data.rendered) continue;
-			let keepRendered = false;
-			for (const nearIdx of nearIndices) if (Math.abs(data.index - nearIdx) <= 2) {
-				keepRendered = true;
-				break;
-			}
-			if (!keepRendered && nearIndices.size > 0) {
-				depopulatePageShell(el, liveDataMap);
-				depopulated = true;
-			}
+			if (!(entry.target instanceof HTMLElement) || !entry.isIntersecting) continue;
+			const data = renderState.pageDataMap.get(entry.target);
+			if (data) populatePageRange(renderState, data.index);
 		}
-		if (depopulated) emitPainterPainted(container);
 	}, {
-		root: null,
+		root: observerRoot,
 		rootMargin: `${VIRTUALIZATION_ROOT_MARGIN_PX}px 0px ${VIRTUALIZATION_ROOT_MARGIN_PX}px 0px`
 	});
-	for (const shell of pageShells) observer.observe(shell);
-	pc.__pageObserver = observer;
+	const retain = new IntersectionObserver((entries) => {
+		const renderState = pc.__pageRenderState;
+		if (!renderState) return;
+		for (const entry of entries) {
+			if (!(entry.target instanceof HTMLElement)) continue;
+			if (entry.isIntersecting) renderState.retainedShells.add(entry.target);
+			else renderState.retainedShells.delete(entry.target);
+		}
+		sweepUnretainedPages(container, renderState);
+	}, {
+		root: observerRoot,
+		rootMargin: `${VIRTUALIZATION_RETAIN_MARGIN_PERCENT}% 0px ${VIRTUALIZATION_RETAIN_MARGIN_PERCENT}% 0px`
+	});
+	for (const shell of pageShells) {
+		populate.observe(shell);
+		retain.observe(shell);
+	}
+	pc.__pageObservers = {
+		populate,
+		retain
+	};
 	pc.__pageRenderState = {
+		retainedShells: /* @__PURE__ */ new Set(),
 		pageStates: pageShells.map((el) => ({
 			element: el,
 			fingerprint: null,
@@ -1775,6 +1772,45 @@ function populatePageShell(shell, pageDataMap, totalPages, options) {
 	const container = shell.parentElement;
 	if (container instanceof HTMLElement) emitPainterPainted(container);
 }
+/** Paint the page at `index` and its buffer neighbours. */
+function populatePageRange(state, index) {
+	const first = Math.max(0, index - VIRTUALIZATION_BUFFER);
+	const last = Math.min(state.pageStates.length - 1, index + VIRTUALIZATION_BUFFER);
+	for (let i = first; i <= last; i++) populatePageShell(state.pageStates[i].element, state.pageDataMap, state.totalPages, state.currentOptions);
+}
+/**
+* Depopulate painted pages more than one page beyond the buffer of every
+* retained shell. Reads the retention observer's last report, so it forces no
+* layout.
+*/
+function sweepUnretainedPages(container, state) {
+	const retainedIndices = [];
+	for (const shell of state.retainedShells) {
+		const data = state.pageDataMap.get(shell);
+		if (data) retainedIndices.push(data.index);
+	}
+	if (retainedIndices.length === 0) return;
+	let depopulated = false;
+	for (const [el, data] of state.pageDataMap) {
+		if (!data.rendered) continue;
+		if (!retainedIndices.some((retainedIndex) => Math.abs(data.index - retainedIndex) <= 2)) {
+			depopulatePageShell(el, state.pageDataMap);
+			depopulated = true;
+		}
+	}
+	if (depopulated) emitPainterPainted(container);
+}
+/**
+* Paint `shell` and its buffer neighbours now, ahead of the observer, so a
+* navigation can scroll straight onto painted content instead of passing blank
+* shells. No-op for containers `renderPages` did not virtualize.
+*/
+function renderPagesAround(container, shell) {
+	const state = container.__pageRenderState;
+	const data = state?.pageDataMap.get(shell);
+	if (!state || !data) return;
+	populatePageRange(state, data.index);
+}
 /**
 * Force every virtualized page shell in `container` to be fully rendered.
 *
@@ -1918,7 +1954,7 @@ function findPageShellForPmPos(container, pmPos) {
 			if (fragment.pmEnd !== void 0 && fragment.pmEnd > pageEnd) pageEnd = fragment.pmEnd;
 		}
 		if (pageStart === Number.POSITIVE_INFINITY) continue;
-		if (pageStart <= pmPos && pmPos <= pageEnd) return {
+		if (pageStart <= pmPos && pmPos < pageEnd) return {
 			element: shell,
 			isExact: true
 		};
@@ -1947,4 +1983,4 @@ function depopulatePageShell(shell, pageDataMap) {
 	}
 }
 //#endregion
-export { PAGE_CLASS_NAMES, PAINTER_PAINTED_EVENT, applySectionHeaderFooterOptions, calculateFootnoteAreaRenderHeight, computePageFingerprint, emuToPixels, findPageShellForPmPos, floatingTableReservesBand, getDefaultPageFontFamily, isFloatingImageRun, renderAllPagesNow, renderFloatingImagesLayer, renderFootnoteArea, renderPage, renderPages, resolveAnchoredImagePosition, resolveHeaderFooterFloatLeft, resolveHeaderFooterIntrinsicFrameHorizontalPosition, selectSectionHeaderFooterRIds };
+export { PAGE_CLASS_NAMES, PAINTER_PAINTED_EVENT, applySectionHeaderFooterOptions, calculateFootnoteAreaRenderHeight, computePageFingerprint, emuToPixels, findPageShellForPmPos, floatingTableReservesBand, getDefaultPageFontFamily, isFloatingImageRun, renderAllPagesNow, renderFloatingImagesLayer, renderFootnoteArea, renderPage, renderPages, renderPagesAround, resolveAnchoredImagePosition, resolveHeaderFooterFloatLeft, resolveHeaderFooterIntrinsicFrameHorizontalPosition, selectSectionHeaderFooterRIds };

package/dist/paged-layout/editorScrollRoot.d.ts

@@ -5,6 +5,10 @@ export declare const scrollEditorTo: (element: HTMLElement | null, options: Scro
 export declare const scrollEditorBy: (element: HTMLElement | null, delta: number) => void;
 type ScrollEditorElementOptions = {
   block?: "start" | "center" | "end" | "nearest";
+  /**
+   * Omitted: smooth (instant under `prefers-reduced-motion`) within two
+   * viewport heights, instant beyond.
+   */
   behavior?: ScrollBehavior;
   /** Space to leave between the target and the visible root edge. */
   margin?: number;

package/dist/paged-layout/editorScrollRoot.js

@@ -24,8 +24,15 @@ const nearestScrollOffset = ({ targetStart, targetEnd, viewportStart, viewportEn
 	if (below && targetSize <= viewportSize || above && targetSize > viewportSize) return targetEnd - viewportEnd;
 	return 0;
 };
+/**
+* Farthest move, in viewport heights, that the default behavior animates. A
+* longer smooth scroll passes page shells that virtualization paints one by
+* one before discarding them, and shows blank shells until it arrives.
+*/
+const SMOOTH_SCROLL_MAX_VIEWPORTS = 2;
+const navigationScrollBehavior = (distance, viewportHeight) => Math.abs(distance) > viewportHeight * SMOOTH_SCROLL_MAX_VIEWPORTS ? "instant" : prefersReducedMotionBehavior();
 /** Scroll only the marked root, including when the target is inside a scaled viewport. */
-const scrollEditorElementIntoView = (element, { block = "center", behavior = prefersReducedMotionBehavior(), margin = 0, rect } = {}) => {
+const scrollEditorElementIntoView = (element, { block = "center", behavior, margin = 0, rect } = {}) => {
 	const root = getEditorScrollRoot(element);
 	if (!root || !element) return;
 	const targetRect = rect ?? element.getBoundingClientRect();
@@ -62,10 +69,11 @@ const scrollEditorElementIntoView = (element, { block = "center", behavior = pre
 		viewportEnd: visibleLeft + root.clientWidth
 	});
 	if (top === root.scrollTop && left === root.scrollLeft) return;
+	const clampedTop = Math.max(0, top);
 	scrollEditorTo(root, {
-		top: Math.max(0, top),
+		top: clampedTop,
 		left: Math.max(0, left),
-		behavior
+		behavior: behavior ?? navigationScrollBehavior(clampedTop - root.scrollTop, root.clientHeight)
 	});
 };
 //#endregion

package/dist/paged-layout/scrollToPmPosition.js

@@ -1,5 +1,5 @@
 import { findBodyPmAnchor, findBodyPmAnchors } from "../layout-bridge/dom/findBodyPmSpans.js";
-import { findPageShellForPmPos } from "../layout-painter/renderPage.js";
+import { findPageShellForPmPos, renderPagesAround } from "../layout-painter/renderPage.js";
 import { getEditorScrollRoot, scrollEditorElementIntoView } from "./editorScrollRoot.js";
 import { isValidPmScrollPosition } from "./scrollNavigation.js";
 //#region src/paged-layout/scrollToPmPosition.ts
@@ -8,61 +8,51 @@ const PAGES_CONTAINER_CLASS = "paged-editor__pages";
 /** Scroll visible pages to a ProseMirror position. */
 const scrollPagesToPmPosition = (pageContainer, pmPos) => {
 	if (!isValidPmScrollPosition(pmPos)) return;
-	const exact = findBodyPmAnchor(pageContainer, pmPos);
-	if (exact) {
-		scrollEditorElementIntoView(exact);
-		return;
-	}
-	let runMatch = null;
-	for (const el of findBodyPmAnchors(pageContainer)) {
-		const start = Number(el.dataset["pmStart"]);
-		if (Number.isNaN(start)) continue;
-		const endAttr = el.dataset["pmEnd"];
-		const end = endAttr === void 0 ? start : Number(endAttr);
-		if (start <= pmPos && pmPos <= end) {
-			runMatch = el;
-			break;
-		}
-	}
-	if (runMatch) {
-		scrollEditorElementIntoView(runMatch);
+	const rendered = findBodyPmAnchor(pageContainer, pmPos) ?? findAnchorContaining(pageContainer, pmPos);
+	if (rendered) {
+		scrollEditorElementIntoView(rendered);
 		return;
 	}
 	const shellHit = findPageShellForPmPos(pageContainer, pmPos);
 	if (!shellHit) return;
 	const { element: shell } = shellHit;
-	scrollEditorElementIntoView(shell);
-	let attempts = 0;
-	const refine = () => {
-		attempts++;
-		const exactInShell = findBodyPmAnchor(shell, pmPos);
-		if (exactInShell) {
-			scrollEditorElementIntoView(exactInShell);
-			return;
-		}
-		let bestEl = null;
-		let bestStart = Number.NEGATIVE_INFINITY;
-		for (const el of findBodyPmAnchors(shell)) {
-			const start = Number(el.dataset["pmStart"]);
-			if (Number.isNaN(start)) continue;
-			const endAttr = el.dataset["pmEnd"];
-			const end = endAttr === void 0 ? start : Number(endAttr);
-			if (start <= pmPos && pmPos <= end) {
-				bestEl = el;
-				break;
-			}
-			if (start <= pmPos && start > bestStart) {
-				bestStart = start;
-				bestEl = el;
-			}
-		}
-		if (bestEl) {
-			scrollEditorElementIntoView(bestEl);
-			return;
-		}
-		if (attempts < 20) requestAnimationFrame(refine);
-	};
-	requestAnimationFrame(refine);
+	renderPagesAround(pageContainer, shell);
+	scrollEditorElementIntoView(findBodyPmAnchor(shell, pmPos) ?? findAnchorContaining(shell, pmPos) ?? findAnchorBefore(shell, pmPos) ?? shell);
+};
+const anchorRanges = (root) => {
+	const ranges = [];
+	for (const element of findBodyPmAnchors(root)) {
+		const start = Number(element.dataset["pmStart"]);
+		if (Number.isNaN(start)) continue;
+		const endAttr = element.dataset["pmEnd"];
+		ranges.push({
+			element,
+			start,
+			end: endAttr === void 0 ? start : Number(endAttr)
+		});
+	}
+	return ranges;
+};
+/**
+* First painted run whose range holds `pmPos` (block positions rarely match a
+* run start). Ranges are half-open, as page lookups are: a run ending where a
+* block starts belongs before it, so the end of a painted page never stands in
+* for the unpainted page that block opens. A run without an end holds only its
+* start.
+*/
+const findAnchorContaining = (root, pmPos) => {
+	for (const { element, start, end } of anchorRanges(root)) if (start <= pmPos && (pmPos < end || pmPos === start)) return element;
+	return null;
+};
+/** The painted run starting closest before `pmPos`. */
+const findAnchorBefore = (root, pmPos) => {
+	let best = null;
+	let bestStart = Number.NEGATIVE_INFINITY;
+	for (const { element, start } of anchorRanges(root)) if (start <= pmPos && start > bestStart) {
+		bestStart = start;
+		best = element;
+	}
+	return best;
 };
 /**
 * Scroll the paged layout that mirrors `view` so `pmPos` is centered

package/dist/pdf/fonts.js

@@ -6,7 +6,8 @@ import { bytesToHex, decodeText, encodeUtf16BE, encodeUtf8 } from "../utils/text
 import { pdfArray, pdfAsciiString, pdfDict, pdfFlateStream, pdfName, pdfNumber, pdfNumberArray } from "./objects.js";
 import { Result, TaggedError, panic } from "better-result";
 //#region src/pdf/fonts.ts
-var PdfFontError = class extends TaggedError("PdfFontError") {};
+const PdfFontErrorBase = TaggedError("PdfFontError");
+var PdfFontError = class extends PdfFontErrorBase {};
 /** Text space is 1000 units to the em whatever the font's own head is. */
 const TEXT_SPACE_UNITS_PER_EM = 1e3;
 /** `fsType` bit 1: the vendor forbids embedding this face outright. */

package/dist/pdf/images.d.ts

@@ -1,9 +1,9 @@
 import { DisplayImageSource } from "../display-list/types.js";
 import { PdfValue } from "./objects.js";
-import { Result } from "better-result";
+import { Result, TaggedErrorClass } from "better-result";
 //#region src/pdf/images.d.ts
-declare const PdfImageError_base: import("better-result").TaggedErrorClass<"PdfImageError">;
-export declare class PdfImageError extends PdfImageError_base<{
+declare const PdfImageErrorBase: TaggedErrorClass<"PdfImageError">;
+export declare class PdfImageError extends PdfImageErrorBase<{
   message: string;
 }> {}
 /** A soft mask: one alpha sample per pixel, matching the image's dimensions. */

package/dist/pdf/images.js

@@ -18,7 +18,8 @@ import { inflateSync } from "node:zlib";
 * refusing the page. Adam7 interlacing is not such a form — it is seven
 * ordinary rasters of the same samples — so it is decoded rather than refused.
 */
-var PdfImageError = class extends TaggedError("PdfImageError") {};
+const PdfImageErrorBase = TaggedError("PdfImageError");
+var PdfImageError = class extends PdfImageErrorBase {};
 const PNG_SIGNATURE = [
 	137,
 	80,

package/dist/pdf/paint.d.ts

@@ -1,10 +1,10 @@
 import { DisplayPage } from "../display-list/types.js";
 import { PreparedFont, ShapedRunRequest } from "./fonts.js";
 import { ContentPart } from "./contentStream.js";
-import { Result } from "better-result";
+import { Result, TaggedErrorClass } from "better-result";
 //#region src/pdf/paint.d.ts
-declare const PaintError_base: import("better-result").TaggedErrorClass<"PaintError">;
-export declare class PaintError extends PaintError_base<{
+declare const PaintErrorBase: TaggedErrorClass<"PaintError">;
+export declare class PaintError extends PaintErrorBase<{
   message: string;
 }> {}
 export type PaintPageOptions = {

package/dist/pdf/paint.js

@@ -12,7 +12,8 @@ import { Result, TaggedError, panic } from "better-result";
 * converts once, at the stream's first operator, which is why no primitive
 * below does any arithmetic on the page height.
 */
-var PaintError = class extends TaggedError("PaintError") {};
+const PaintErrorBase = TaggedError("PaintError");
+var PaintError = class extends PaintErrorBase {};
 /** Thousandths of an em, the unit of a `TJ` adjustment. */
 const TEXT_SPACE_UNITS_PER_EM = 1e3;
 const OPAQUE = 1;

package/dist/pdf/writePdf.d.ts

@@ -1,6 +1,6 @@
 import { DisplayList } from "../display-list/types.js";
 import { PdfFontSource, PdfSubstitution } from "./fonts.js";
-import { Result } from "better-result";
+import { Result, TaggedErrorClass } from "better-result";
 //#region src/pdf/writePdf.d.ts
 export type WritePdfOptions = {
   readonly fonts: PdfFontSource;
@@ -38,8 +38,8 @@ export type WritePdfResult = {
   /** Code points painted as `.notdef` because no supplied face covers them. */
   readonly unencodable: readonly PdfUnencodable[];
 };
-declare const WritePdfError_base: import("better-result").TaggedErrorClass<"WritePdfError">;
-export declare class WritePdfError extends WritePdfError_base<{
+declare const WritePdfErrorBase: TaggedErrorClass<"WritePdfError">;
+export declare class WritePdfError extends WritePdfErrorBase<{
   message: string;
   cause?: unknown;
 }> {}

package/dist/pdf/writePdf.js

@@ -20,7 +20,8 @@ import { createHash } from "node:crypto";
 * deflate level) exists to keep it true. Nothing here reads a clock or a
 * random source.
 */
-var WritePdfError = class extends TaggedError("WritePdfError") {};
+const WritePdfErrorBase = TaggedError("WritePdfError");
+var WritePdfError = class extends WritePdfErrorBase {};
 const DEFAULT_PRODUCER = "folio";
 /** How many code points the strict-coverage refusal names before counting. */
 const UNENCODABLE_SAMPLE = 5;

package/dist/prosemirror/canonicalCommands.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { Node } from "prosemirror-model";
 import { Command, EditorState } from "prosemirror-state";
-import { ParagraphPropsPatch, RunPropsPatch } from "@stll/docx-core/ops";
+import { FormattingPatch, ParagraphPropsPatch, RunPropsPatch } from "@stll/docx-core/ops";
 //#region src/prosemirror/canonicalCommands.d.ts
 /** Command meaning before canonical positions are resolved by the session. */
 export type CanonicalCommandIntent = {
@@ -78,14 +78,14 @@ export declare const canonicalRunFormatting: (state: EditorState, patch: RunProp
   type: "formatRun";
   from: number;
   to: number;
-  patch: import("@stll/docx-core/ops").FormattingPatch<{
+  patch: FormattingPatch<{
     bold?: boolean | undefined;
     boldCs?: boolean | undefined;
     italic?: boolean | undefined;
     italicCs?: boolean | undefined;
     underline?: {
-      style: import("@stll/docx-core/model").UnderlineStyle;
-      color?: import("@stll/docx-core/model").ColorValue;
+      style: document_d_exports.UnderlineStyle;
+      color?: document_d_exports.ColorValue;
     } | undefined;
     strike?: boolean | undefined;
     doubleStrike?: boolean | undefined;
@@ -94,9 +94,9 @@ export declare const canonicalRunFormatting: (state: EditorState, patch: RunProp
     allCaps?: boolean | undefined;
     hidden?: boolean | undefined;
     noProof?: boolean | undefined;
-    color?: import("@stll/docx-core/model").ColorValue | undefined;
+    color?: document_d_exports.ColorValue | undefined;
     highlight?: "black" | "blue" | "cyan" | "darkBlue" | "darkCyan" | "darkGray" | "darkGreen" | "darkMagenta" | "darkRed" | "darkYellow" | "green" | "lightGray" | "magenta" | "none" | "red" | "white" | "yellow" | undefined;
-    shading?: import("@stll/docx-core/model").ShadingProperties | undefined;
+    shading?: document_d_exports.ShadingProperties | undefined;
     fontSize?: number | undefined;
     fontSizeCs?: number | undefined;
     fontFamily?: {
@@ -119,8 +119,8 @@ export declare const canonicalRunFormatting: (state: EditorState, patch: RunProp
     position?: number | undefined;
     scale?: number | undefined;
     kerning?: number | undefined;
-    effect?: import("@stll/docx-core/model").TextEffect | undefined;
-    emphasisMark?: import("@stll/docx-core/model").EmphasisMark | undefined;
+    effect?: document_d_exports.TextEffect | undefined;
+    emphasisMark?: document_d_exports.EmphasisMark | undefined;
     emboss?: boolean | undefined;
     imprint?: boolean | undefined;
     outline?: boolean | undefined;
@@ -128,7 +128,7 @@ export declare const canonicalRunFormatting: (state: EditorState, patch: RunProp
     rtl?: boolean | undefined;
     cs?: boolean | undefined;
     styleId?: string | undefined;
-    preserved?: import("@stll/docx-core/model").PreservedMarkup | undefined;
+    preserved?: document_d_exports.PreservedMarkup | undefined;
   }>;
 }[];
 export declare const withCanonicalParagraphFormatting: (command: Command, patch: ParagraphPropsPatch | ((paragraph: Node) => ParagraphPropsPatch)) => Command;