@stll/folio-core 0.60.0 → 0.62.0

package/dist/layout-bridge/convert/endnoteLayout.js

@@ -58,7 +58,6 @@ function prepareEndnoteAreas(input) {
 		notesBySection.set(section, noteIds);
 	}
 	const separatorBlockIds = /* @__PURE__ */ new Map();
-	const contentBlockIds = /* @__PURE__ */ new Set();
 	const noteStoryByBlockId = /* @__PURE__ */ new Map();
 	const areas = [];
 	for (const [section, noteIds] of [...notesBySection].sort(([left], [right]) => left - right)) {
@@ -82,7 +81,6 @@ function prepareEndnoteAreas(input) {
 				const id = `endnote-${String(noteId)}-${String(index)}`;
 				blocks.push(withId(stripFlowBlockPmAnchors(block), id));
 				measures.push(content.measures[index]);
-				contentBlockIds.add(id);
 				noteStoryByBlockId.set(id, {
 					kind: "endnote",
 					noteId
@@ -101,7 +99,7 @@ function prepareEndnoteAreas(input) {
 		areas,
 		noteAreas: {
 			separatorBlockIds,
-			contentBlockIds,
+			noteStoryByBlockId,
 			continuationSeparator
 		},
 		noteStoryByBlockId

package/dist/layout-bridge/convert/flowConversionShared.d.ts

@@ -9,6 +9,8 @@ import { Node } from "prosemirror-model";
  * Options for the conversion.
  */
 type ToFlowBlocksOptions = {
+  /** Paint comment anchors and highlights; false leaves authored marks intact. */
+  showCommentHighlights?: boolean;
   /** Embedded families owned by this editor, never ambient process state. */
   embeddedFontFamilyMap?: ReadonlyMap<string, string>;
   /** Default font family. */

package/dist/layout-bridge/convert/footnoteLayout.d.ts

@@ -1,10 +1,14 @@
 import { document_d_exports } from "../../types/document.js";
+import { DisplayMode } from "../../managers/EditorModeManager.js";
 import { FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FlowBlock, FootnoteContent, Measure, Page } from "../../layout-engine/types.js";
 import { ToFlowBlocksOptions } from "./flowConversionShared.js";
 import "./toFlowBlocks.js";
 //#region src/layout-bridge/convert/footnoteLayout.d.ts
 type MeasureBlocksFn = (blocks: FlowBlock[], contentWidth: number) => Measure[];
 type ConvertFootnoteOptions = Pick<ToFlowBlocksOptions, "embeddedFontFamilyMap"> & {
+  /** Whether comment highlights are painted. Defaults to true. */
+  showCommentHighlights?: boolean;
+  markupView?: DisplayMode;
   styles?: document_d_exports.StyleDefinitions | null;
   numbering?: document_d_exports.NumberingDefinitions;
   theme?: document_d_exports.Theme | null;

package/dist/layout-bridge/convert/footnoteLayout.js

@@ -2,6 +2,8 @@ import { measureParagraph } from "../../layout-engine/measure/measureParagraph.j
 import { layoutTextBoxContent } from "../../layout-engine/measure/textBoxParagraphLayout.js";
 import { DEFAULT_TEXTBOX_MARGINS, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, isFloatingImageRun, resolveTableWidthPx } from "../../layout-engine/types.js";
 import { footnoteToProseDoc } from "../../prosemirror/conversion/toProseDoc.js";
+import { projectStoryMarkupView } from "../../prosemirror/markupViewProjection.js";
+import { remapMarkupViewBlocks } from "./markupViewFlow.js";
 import { collectNoteRefs } from "./noteReferences.js";
 import { toFlowBlocks } from "./toFlowBlocks.js";
 //#region src/layout-bridge/convert/footnoteLayout.ts
@@ -204,7 +206,7 @@ function convertNoteStoryToFlowBlocks(content, options, referenceMarkText) {
 	if (options.theme !== void 0) proseOptions.theme = options.theme;
 	if (options.numbering !== void 0) proseOptions.numbering = options.numbering;
 	const pmDoc = footnoteToProseDoc(content, proseOptions);
-	const flowOptions = {};
+	const flowOptions = { showCommentHighlights: options.showCommentHighlights !== false && options.markupView !== "no-markup" && options.markupView !== "original" };
 	if (options.defaultSize !== void 0) flowOptions.defaultSize = options.defaultSize;
 	if (options.styles) flowOptions.styles = options.styles;
 	if (options.theme !== void 0) flowOptions.theme = options.theme;
@@ -215,10 +217,18 @@ function convertNoteStoryToFlowBlocks(content, options, referenceMarkText) {
 	if (options.justificationCompatibility) flowOptions.justificationCompatibility = options.justificationCompatibility;
 	if (options.tableIndentCompatibility) flowOptions.tableIndentCompatibility = options.tableIndentCompatibility;
 	if (options.automaticHyphenation) flowOptions.automaticHyphenation = options.automaticHyphenation;
-	const hasReferenceMark = containsNoteReferenceMark(pmDoc);
+	const projection = projectStoryMarkupView({
+		doc: pmDoc,
+		markupView: options.markupView ?? "all-markup",
+		styles: options.styles,
+		numbering: options.numbering
+	});
+	const viewDoc = projection.type === "resolved" ? projection.doc : pmDoc;
+	const hasReferenceMark = containsNoteReferenceMark(viewDoc);
 	if (hasReferenceMark && referenceMarkText !== void 0) flowOptions.noteReferenceMarkText = referenceMarkText;
+	const converted = toFlowBlocks(viewDoc, flowOptions);
 	return {
-		flowBlocks: preserveAuthoredFootnoteTerminalParagraph(toFlowBlocks(pmDoc, flowOptions)),
+		flowBlocks: preserveAuthoredFootnoteTerminalParagraph(projection.type === "resolved" ? remapMarkupViewBlocks(converted, projection) : converted),
 		hasReferenceMark
 	};
 }

package/dist/layout-bridge/convert/headerFooterLayout.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
+import { DisplayMode } from "../../managers/EditorModeManager.js";
 import { FlowBlock, HeaderFooterContent, ImageRun, ImageRunPosition, Measure, PageMargins } from "../../layout-engine/types.js";
 import { ToFlowBlocksOptions } from "./flowConversionShared.js";
 import "./toFlowBlocks.js";
@@ -40,6 +41,10 @@ declare function calculateHeaderFooterMarginPushBounds(blocks: FlowBlock[], meas
  */
 declare function calculateHeaderFooterBodyTopClearance(blocks: FlowBlock[], flowHeight: number, metrics: HeaderFooterMetrics): number | undefined;
 type ConvertHeaderFooterOptions = {
+  /** Review projection applied before header/footer measurement. Defaults to All Markup. */
+  markupView?: DisplayMode;
+  /** Whether comment highlights are painted. Defaults to true. */
+  showCommentHighlights?: boolean;
   styles?: document_d_exports.StyleDefinitions | null;
   numbering?: document_d_exports.NumberingDefinitions;
   theme?: document_d_exports.Theme | null;

package/dist/layout-bridge/convert/headerFooterLayout.js

@@ -1,7 +1,9 @@
 import { cloneParagraphWithPropertySource } from "../../docx/paragraphPropertySource.js";
 import { isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun } from "../../layout-engine/types.js";
 import { headerFooterToProseDoc } from "../../prosemirror/conversion/toProseDoc.js";
+import { projectStoryMarkupView } from "../../prosemirror/markupViewProjection.js";
 import { emuToPixels } from "../../utils/units.js";
+import { remapMarkupViewBlocks } from "./markupViewFlow.js";
 import { toFlowBlocks } from "./toFlowBlocks.js";
 //#region src/layout-bridge/convert/headerFooterLayout.ts
 const DETACHED_WATERMARK_HOST = Symbol.for("stll.detachedWatermarkHost");
@@ -341,19 +343,7 @@ function convertHeaderFooterToContent(headerFooter, contentWidth, metrics, optio
 	if (options.styles) proseDocOptions.styles = options.styles;
 	if (options.theme !== void 0) proseDocOptions.theme = options.theme;
 	if (options.numbering !== void 0) proseDocOptions.numbering = options.numbering;
-	const pmDoc = headerFooter.watermarkBlockIndex === void 0 ? headerFooterToProseDoc(headerFooter.content, proseDocOptions) : headerFooterToProseDocWithDetachedWatermarkHost(headerFooter, proseDocOptions);
-	const flowOptions = {};
-	if (options.defaultSize !== void 0) flowOptions.defaultSize = options.defaultSize;
-	if (options.styles) flowOptions.styles = options.styles;
-	if (options.theme !== void 0) flowOptions.theme = options.theme;
-	if (options.embeddedFontFamilyMap !== void 0) flowOptions.embeddedFontFamilyMap = options.embeddedFontFamilyMap;
-	if (options.fontAlternates !== void 0) flowOptions.fontAlternates = options.fontAlternates;
-	if (options.defaultTabStopTwips !== void 0) flowOptions.defaultTabStopTwips = options.defaultTabStopTwips;
-	if (options.lineBreakRules) flowOptions.lineBreakRules = options.lineBreakRules;
-	if (options.justificationCompatibility) flowOptions.justificationCompatibility = options.justificationCompatibility;
-	if (options.tableIndentCompatibility) flowOptions.tableIndentCompatibility = options.tableIndentCompatibility;
-	if (options.automaticHyphenation) flowOptions.automaticHyphenation = options.automaticHyphenation;
-	return finalizeHeaderFooterContent(toFlowBlocks(pmDoc, flowOptions), contentWidth, metrics, options);
+	return convertHeaderFooterPmDocToContent(headerFooter.watermarkBlockIndex === void 0 ? headerFooterToProseDoc(headerFooter.content, proseDocOptions) : headerFooterToProseDocWithDetachedWatermarkHost(headerFooter, proseDocOptions), contentWidth, metrics, options);
 }
 /**
 * Same as {@link convertHeaderFooterToContent}, but sourced from a live
@@ -368,7 +358,7 @@ function convertHeaderFooterToContent(headerFooter, contentWidth, metrics, optio
 */
 function convertHeaderFooterPmDocToContent(pmDoc, contentWidth, metrics, options) {
 	if (!pmDoc || pmDoc.content.size === 0) return;
-	const flowOptions = {};
+	const flowOptions = { showCommentHighlights: options.showCommentHighlights !== false && options.markupView !== "no-markup" && options.markupView !== "original" };
 	if (options.defaultSize !== void 0) flowOptions.defaultSize = options.defaultSize;
 	if (options.styles) flowOptions.styles = options.styles;
 	if (options.theme !== void 0) flowOptions.theme = options.theme;
@@ -379,7 +369,14 @@ function convertHeaderFooterPmDocToContent(pmDoc, contentWidth, metrics, options
 	if (options.justificationCompatibility) flowOptions.justificationCompatibility = options.justificationCompatibility;
 	if (options.tableIndentCompatibility) flowOptions.tableIndentCompatibility = options.tableIndentCompatibility;
 	if (options.automaticHyphenation) flowOptions.automaticHyphenation = options.automaticHyphenation;
-	return finalizeHeaderFooterContent(toFlowBlocks(pmDoc, flowOptions), contentWidth, metrics, options);
+	const projection = projectStoryMarkupView({
+		doc: pmDoc,
+		markupView: options.markupView ?? "all-markup",
+		styles: options.styles,
+		numbering: options.numbering
+	});
+	const flowBlocks = toFlowBlocks(projection.type === "resolved" ? projection.doc : pmDoc, flowOptions);
+	return finalizeHeaderFooterContent(projection.type === "resolved" ? remapMarkupViewBlocks(flowBlocks, projection) : flowBlocks, contentWidth, metrics, options);
 }
 function horizontalImageLeft({ run, contentWidth, metrics }) {
 	const horizontal = run.position?.horizontal;

package/dist/layout-bridge/convert/paragraphRuns.js

@@ -58,7 +58,8 @@ function paragraphToRuns(node, startPos, _options, pageBreaks) {
 			});
 			return;
 		}
-		const effectiveMarks = mergeProjectedInlineMarks(inheritedMarks, child.marks);
+		const projectedMarks = mergeProjectedInlineMarks(inheritedMarks, child.marks);
+		const effectiveMarks = _options.showCommentHighlights === false ? projectedMarks.filter((mark) => mark.type.name !== "comment") : projectedMarks;
 		if (child.type.name === "pageBreakRun") {
 			const trackedChange = extractRunFormatting(effectiveMarks, theme, fontAlternates);
 			if (trackedChange.isDeletion) {

package/dist/layout-engine/index.js

@@ -4,7 +4,7 @@ import { layoutImage } from "./imageLayout.js";
 import { calculateChainHeight, computeKeepNextChains, getMidChainIndices, hasKeepLines, hasPageBreakBefore } from "./keep-together.js";
 import "./layoutFlowShared.js";
 import { measuredLineAdvance } from "./lineFlow.js";
-import { annotateNoteSeparators, continuesNoteArea, createNoteAreaContinuation } from "./noteAreaFlow.js";
+import { annotateNoteAreas, continuesNoteArea, createNoteAreaContinuation } from "./noteAreaFlow.js";
 import { createPaginator } from "./paginator.js";
 import { layoutParagraph } from "./paragraphLayout.js";
 import { paragraphsShareStyle, resolveEffectiveParagraphSpacingTree } from "./paragraphSpacing.js";
@@ -63,7 +63,7 @@ function applyContextualSpacing(blocks) {
 */
 function layoutDocument(blocks, measures, options) {
 	const initialLayout = layoutDocumentPass(blocks, measures, options);
-	return annotateNoteSeparators(applySectionVerticalAlignment(options.footnoteHeightById ? reflowFootnoteColumns({
+	return annotateNoteAreas(applySectionVerticalAlignment(options.footnoteHeightById ? reflowFootnoteColumns({
 		initialLayout,
 		...options.footnoteReservedHeights ? { initialReserveFloors: options.footnoteReservedHeights } : {},
 		runLayout: (reserveFloors) => layoutDocumentPass(blocks, measures, {

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

@@ -1,3 +1,4 @@
+import { sliceText } from "../../utils/sliceText.js";
 import { splitTrailingToken } from "../../utils/trailingText.js";
 import { resolveEffectiveLineBreakPolicy } from "./effectiveLineBreakPolicy.js";
 import "./lineBreakProvider.js";
@@ -47,7 +48,11 @@ function computeFollowingTextLeads(block) {
 		leads[index] = lead;
 		const run = block.runs[index];
 		if (!run || !isTextRun(run)) lead = void 0;
-		else if (run.text) lead = run.text[0];
+		else if (run.text) lead = sliceText({
+			text: run.text,
+			units: "codePoints",
+			end: 1
+		});
 	}
 	return leads;
 }
@@ -101,6 +106,7 @@ function computeProtectedCrossRunGlueWidths(block) {
 * invoked from, without the per-word text-length budget ever kicking in.
 */
 const MAX_CROSS_RUN_SEGMENTS = 64;
+const MAX_SCALAR_CODE_UNITS = 2;
 /** Collect one lexical word continued through adjacent formatting runs. */
 function collectCrossRunWord({ block, startRunIndex, startChar }) {
 	const segments = [];
@@ -115,7 +121,11 @@ function collectCrossRunWord({ block, startRunIndex, startChar }) {
 		if (remainder.length === 0) continue;
 		if (runIndex !== startRunIndex && isSpaceOrTab(remainder[0])) break;
 		const remainingBudget = 256 - text.length;
-		const boundedRemainder = remainder.slice(0, remainingBudget + 1);
+		const boundedRemainder = sliceText({
+			text: remainder,
+			units: "codeUnits",
+			end: remainingBudget + MAX_SCALAR_CODE_UNITS
+		});
 		const firstBreak = findWordBreaks(boundedRemainder, resolveEffectiveLineBreakPolicy({
 			attrs: block.attrs,
 			run

package/dist/layout-engine/noteAreaFlow.d.ts

@@ -10,10 +10,10 @@ declare function createNoteAreaContinuation(noteAreas: NoteAreaLayout | undefine
 /** Whether laying out `block` continues a note area onto any page it opens. */
 declare function continuesNoteArea(noteAreas: NoteAreaLayout | undefined, block: FlowBlock): boolean;
 /**
- * Record where each separator mark landed. A rule is centred on the first line
- * of the separator paragraph: a `w:separator` spans part of the column and a
+ * Record note identities and where each separator mark landed. A rule is centred
+ * on the first line of the separator paragraph: a `w:separator` spans part of the column and a
  * `w:continuationSeparator` all of it.
  */
-declare function annotateNoteSeparators(layout: Layout, blocks: readonly FlowBlock[], measures: readonly Measure[], noteAreas: NoteAreaLayout | undefined): Layout;
+declare function annotateNoteAreas(layout: Layout, blocks: readonly FlowBlock[], measures: readonly Measure[], noteAreas: NoteAreaLayout | undefined): Layout;
 //#endregion
-export { annotateNoteSeparators, continuesNoteArea, createNoteAreaContinuation };
+export { annotateNoteAreas, continuesNoteArea, createNoteAreaContinuation };

package/dist/layout-engine/noteAreaFlow.js

@@ -39,15 +39,15 @@ function createNoteAreaContinuation(noteAreas, paginator) {
 }
 /** Whether laying out `block` continues a note area onto any page it opens. */
 function continuesNoteArea(noteAreas, block) {
-	return noteAreas?.contentBlockIds.has(String(block.id)) === true;
+	return noteAreas?.noteStoryByBlockId.has(String(block.id)) === true;
 }
 /**
-* Record where each separator mark landed. A rule is centred on the first line
-* of the separator paragraph: a `w:separator` spans part of the column and a
+* Record note identities and where each separator mark landed. A rule is centred
+* on the first line of the separator paragraph: a `w:separator` spans part of the column and a
 * `w:continuationSeparator` all of it.
 */
-function annotateNoteSeparators(layout, blocks, measures, noteAreas) {
-	if (noteAreas === void 0 || noteAreas.separatorBlockIds.size === 0) return layout;
+function annotateNoteAreas(layout, blocks, measures, noteAreas) {
+	if (noteAreas === void 0) return layout;
 	const measureById = /* @__PURE__ */ new Map();
 	for (const [index, block] of blocks.entries()) {
 		const measure = measures[index];
@@ -56,6 +56,12 @@ function annotateNoteSeparators(layout, blocks, measures, noteAreas) {
 	const continuation = noteAreas.continuationSeparator;
 	if (continuation !== void 0) measureById.set(String(continuation.block.id), continuation.measure);
 	for (const page of layout.pages) {
+		const endnoteIds = /* @__PURE__ */ new Set();
+		for (const fragment of page.fragments) {
+			const story = noteAreas.noteStoryByBlockId.get(String(fragment.blockId));
+			if (story?.kind === "endnote") endnoteIds.add(story.noteId);
+		}
+		if (endnoteIds.size > 0) page.endnoteIds = [...endnoteIds];
 		const rules = [];
 		for (const fragment of page.fragments) {
 			if (fragment.kind !== "paragraph" || fragment.fromLine !== 0) continue;
@@ -80,4 +86,4 @@ function separatorWidthFraction(kind) {
 	}
 }
 //#endregion
-export { annotateNoteSeparators, continuesNoteArea, createNoteAreaContinuation };
+export { annotateNoteAreas, continuesNoteArea, createNoteAreaContinuation };

package/dist/layout-engine/types.d.ts

@@ -1,4 +1,5 @@
 import { OutlineStyleAttr } from "../types/documentEnumValues.js";
+import { NoteStoryKey } from "../types/editor-story.js";
 import { CssBorderStyle } from "../utils/borderCss.js";
 import { ImagePosition, ImageWrap, InlineWrapper, NumberFormat, OutlineLevel, ParagraphNumberingOverride, PreviewDescriptor, SdtProperties, SdtType, SectionStart, ShapeTextBody, TableCellFormatting, TableWidthType, UnderlineStyle, VerticalAlign } from "@stll/docx-core/model";
 declare namespace types_d_exports {
@@ -1268,6 +1269,8 @@ type Page = {
   headerFooterRefs?: PageHeaderFooterRefs;
   /** Footnote IDs that appear on this page (for rendering). */
   footnoteIds?: number[];
+  /** Endnote IDs whose content fragments appear on this page. */
+  endnoteIds?: number[];
   /** Height reserved for the footnote area at page bottom (pixels). */
   footnoteReservedHeight?: number;
   /**
@@ -1436,10 +1439,10 @@ type NoteAreaLayout = {
    */
   separatorBlockIds: ReadonlyMap<string, NoteSeparatorKind>;
   /**
-   * Note content blocks. A page opened while one of them is laid out
+   * Note identities keyed by content block. A page opened while one is laid out
    * continues the area, so it starts with the continuation separator.
    */
-  contentBlockIds: ReadonlySet<string>;
+  noteStoryByBlockId: ReadonlyMap<string, NoteStoryKey>;
   /** The `w:continuationSeparator` story's first paragraph, already measured. */
   continuationSeparator?: {
     block: ParagraphBlock;

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

@@ -1,5 +1,5 @@
-import { FlowBlock, Layout, Measure } from "../layout-engine/types.js";
 import { NoteStoryKey } from "../types/editor-story.js";
+import { FlowBlock, Layout, Measure } from "../layout-engine/types.js";
 import { RenderContext } from "./renderUtils.js";
 import { BlockFor, FeatureDispatchInput, FeatureFallback, FeatureModule, FeatureRenderInput, FragmentFor, MeasureFor } from "./registry/types.js";
 import { FeatureRegistry, createFeatureRegistry } from "./registry/registry.js";

package/dist/managers/AutoSaveManager.js

@@ -1,3 +1,4 @@
+import { encodeUtf8 } from "../utils/textEncoding.js";
 import { Subscribable } from "./Subscribable.js";
 import { decodeAutoSaveEnvelope, encodeAutoSaveDocument, encodeAutoSaveEnvelopeFromDocument } from "./autoSaveCodec.js";
 //#region src/managers/AutoSaveManager.ts
@@ -228,7 +229,7 @@ function getAutoSaveStorageSize(storageKey = DEFAULT_STORAGE_KEY) {
 	try {
 		const data = localStorage.getItem(storageKey);
 		if (!data) return 0;
-		return new Blob([data]).size;
+		return encodeUtf8(data).byteLength;
 	} catch {
 		return 0;
 	}

package/dist/managers/EditorModeManager.d.ts

@@ -5,6 +5,15 @@ type EditorMode = "editing" | "suggesting" | "viewing";
 /** How tracked changes render. Drives the display mode dropdown. */
 declare const DISPLAY_MODES: readonly ["all-markup", "simple-markup", "no-markup", "original"];
 type DisplayMode = (typeof DISPLAY_MODES)[number];
+/** Why a user action cannot edit the displayed document. */
+type EditorReadOnlyReason = "host-read-only" | "viewing-mode" | "review-display-mode";
+declare const getReviewViewReadOnlyReason: (displayMode: DisplayMode) => EditorReadOnlyReason | null;
+type EditorReadOnlyReasonOptions = {
+  editingMode: EditorMode;
+  readOnlyProp: boolean;
+  displayMode: DisplayMode;
+};
+declare const getEditorReadOnlyReason: ({ editingMode, readOnlyProp, displayMode }: EditorReadOnlyReasonOptions) => EditorReadOnlyReason | null;
 /** EditorModeManager snapshot. */
 type EditorModeSnapshot = {
   /** Uncontrolled internal editing mode (the host's controlled prop wins over this). */
@@ -26,4 +35,4 @@ declare class EditorModeManager extends Subscribable<EditorModeSnapshot> {
   setDisplayMode(mode: DisplayMode): void;
 }
 //#endregion
-export { DISPLAY_MODES, DisplayMode, EditorMode, EditorModeManager, EditorModeSnapshot, isReadOnlyMode, isTrackChangesMode, toggledTrackChangesMode };
+export { DISPLAY_MODES, DisplayMode, EditorMode, EditorModeManager, EditorModeSnapshot, EditorReadOnlyReason, getEditorReadOnlyReason, getReviewViewReadOnlyReason, isReadOnlyMode, isTrackChangesMode, toggledTrackChangesMode };

package/dist/managers/EditorModeManager.js

@@ -18,6 +18,20 @@ const DISPLAY_MODES = [
 	"no-markup",
 	"original"
 ];
+const REVIEW_VIEW_ACCESS = {
+	"all-markup": "editable",
+	"simple-markup": "read-only",
+	"no-markup": "read-only",
+	original: "read-only"
+};
+const getReviewViewReadOnlyReason = (displayMode) => REVIEW_VIEW_ACCESS[displayMode] === "read-only" ? "review-display-mode" : null;
+const getEditorReadOnlyReason = ({ editingMode, readOnlyProp, displayMode }) => {
+	const viewReason = getReviewViewReadOnlyReason(displayMode);
+	if (viewReason) return viewReason;
+	if (readOnlyProp) return "host-read-only";
+	if (editingMode === "viewing") return "viewing-mode";
+	return null;
+};
 /** True when the host opts into read-only OR the mode is `"viewing"`. */
 const isReadOnlyMode = (editingMode, readOnlyProp) => readOnlyProp || editingMode === "viewing";
 /** True when the mode is `"suggesting"`. */
@@ -47,4 +61,4 @@ var EditorModeManager = class extends Subscribable {
 	}
 };
 //#endregion
-export { DISPLAY_MODES, EditorModeManager, isReadOnlyMode, isTrackChangesMode, toggledTrackChangesMode };
+export { DISPLAY_MODES, EditorModeManager, getEditorReadOnlyReason, getReviewViewReadOnlyReason, isReadOnlyMode, isTrackChangesMode, toggledTrackChangesMode };

package/dist/managers/FindReplaceManager.d.ts

@@ -1,5 +1,7 @@
 import { document_d_exports } from "../types/document.js";
+import { ReplaceAllSummary, ReplaceEligibility } from "../utils/findReplace.js";
 import { FindMatchPosition } from "../prosemirror/findReplaceSelection.js";
+import { OpStory } from "@stll/docx-core/ops";
 //#region src/managers/FindReplaceManager.d.ts
 type FindDirection = "next" | "previous";
 type FindReplaceResult<TMatch> = {
@@ -7,16 +9,21 @@ type FindReplaceResult<TMatch> = {
   totalCount: number;
   currentIndex: number;
 };
-type ReplaceAllOutcome = {
+type ReplaceAllOutcome = ReplaceAllSummary & {
   document: document_d_exports.Document;
-  replacedCount: number;
 };
 /**
  * The cursor index after stepping `direction` over `totalCount` matches,
  * wrapping at both ends. Returns 0 when there are no matches.
  */
 declare const getAdjacentFindIndex: (currentIndex: number, totalCount: number, direction: FindDirection) => number;
-declare class FindReplaceManager<TMatch extends FindMatchPosition> {
+type ReplaceableFindPosition = FindMatchPosition & {
+  story?: OpStory;
+  textBoxIndex?: number;
+  commentId?: number;
+  replacement: ReplaceEligibility;
+};
+declare class FindReplaceManager<TMatch extends ReplaceableFindPosition> {
   private result;
   /** The active find result, or null when there is no active search. */
   getResult(): FindReplaceResult<TMatch> | null;
@@ -27,7 +34,7 @@ declare class FindReplaceManager<TMatch extends FindMatchPosition> {
    * first match. The result is kept even when `matches` is empty so callers can
    * surface a "no results" state.
    */
-  setMatches(matches: TMatch[]): FindReplaceResult<TMatch>;
+  setMatches(matches: TMatch[], currentIndex?: number): FindReplaceResult<TMatch>;
   /**
    * Step the cursor and return the now-current match with its index, or null
    * when there are no matches to navigate.
@@ -51,8 +58,8 @@ declare class FindReplaceManager<TMatch extends FindMatchPosition> {
   replaceCurrent(document: document_d_exports.Document, replaceText: string): document_d_exports.Document | null;
   /**
    * Replace every match. Matches are replaced from the end of the document
-   * backwards so earlier offsets stay valid as the text shifts. Clears the
-   * active result and returns the new document plus the match count, or null
+   * backwards so earlier offsets stay valid as the text shifts. Ineligible
+   * matches are skipped and counted. Clears the active result, or returns null
    * when there is nothing to replace.
    */
   replaceAll(document: document_d_exports.Document, matches: readonly TMatch[], replaceText: string): ReplaceAllOutcome | null;

package/dist/managers/FindReplaceManager.js

@@ -1,3 +1,4 @@
+import { replaceEligibility } from "../utils/findReplace.js";
 import { replaceTextInDocument } from "../utils/replaceText.js";
 //#region src/managers/FindReplaceManager.ts
 /**
@@ -34,11 +35,11 @@ var FindReplaceManager = class {
 	* first match. The result is kept even when `matches` is empty so callers can
 	* surface a "no results" state.
 	*/
-	setMatches(matches) {
+	setMatches(matches, currentIndex = 0) {
 		this.result = {
 			matches,
 			totalCount: matches.length,
-			currentIndex: 0
+			currentIndex: Math.max(0, Math.min(currentIndex, matches.length - 1))
 		};
 		return this.result;
 	}
@@ -86,7 +87,7 @@ var FindReplaceManager = class {
 		const result = this.result;
 		if (!result || result.matches.length === 0) return null;
 		const match = result.matches[result.currentIndex];
-		if (!match) return null;
+		if (!match || replaceEligibility(match).status === "blocked") return null;
 		try {
 			return replaceTextInDocument(document, toReplaceRange(match), replaceText);
 		} catch {
@@ -95,26 +96,31 @@ var FindReplaceManager = class {
 	}
 	/**
 	* Replace every match. Matches are replaced from the end of the document
-	* backwards so earlier offsets stay valid as the text shifts. Clears the
-	* active result and returns the new document plus the match count, or null
+	* backwards so earlier offsets stay valid as the text shifts. Ineligible
+	* matches are skipped and counted. Clears the active result, or returns null
 	* when there is nothing to replace.
 	*/
 	replaceAll(document, matches, replaceText) {
 		if (matches.length === 0) return null;
-		const sortedMatches = [...matches].toSorted((a, b) => {
+		const eligibleMatches = matches.filter((match) => replaceEligibility(match).status === "allowed");
+		let skippedCount = matches.length - eligibleMatches.length;
+		let replacedCount = 0;
+		const sortedMatches = [...eligibleMatches].toSorted((a, b) => {
 			if (a.paragraphIndex !== b.paragraphIndex) return b.paragraphIndex - a.paragraphIndex;
 			return b.startOffset - a.startOffset;
 		});
 		let nextDocument = document;
 		for (const match of sortedMatches) try {
 			nextDocument = replaceTextInDocument(nextDocument, toReplaceRange(match), replaceText);
+			replacedCount++;
 		} catch {
-			continue;
+			skippedCount++;
 		}
-		this.result = null;
+		if (replacedCount > 0) this.result = null;
 		return {
 			document: nextDocument,
-			replacedCount: matches.length
+			replacedCount,
+			skippedCount
 		};
 	}
 };

package/dist/managers/TableSelectionManager.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../types/document.js";
-import { TableAction, TableContext } from "../utils/tableOperations.js";
 import { Subscribable } from "./Subscribable.js";
+import { TableAction, TableContext } from "../utils/tableOperations.js";
 import { CellCoordinates } from "./types.js";
 //#region src/managers/TableSelectionManager.d.ts
 /** Data attributes for table elements in the rendered DOM */

package/dist/managers/autoSaveCodec.js

@@ -1,5 +1,6 @@
 import { validateFolioDocumentModel } from "../docx/modelValidation.js";
 import { bytesToBase64 } from "../utils/base64.js";
+import { base64ToBytes } from "../utils/textEncoding.js";
 //#region src/managers/autoSaveCodec.ts
 /**
 * Version 3 renamed the model's `bidiWrapper` to `inlineWrapper` and gave it a
@@ -10,12 +11,7 @@ import { bytesToBase64 } from "../utils/base64.js";
 * re-taken rather than migrated.
 */
 const AUTOSAVE_FORMAT_VERSION = 3;
-const decodeBase64 = (value) => {
-	const binary = atob(value);
-	const bytes = new Uint8Array(binary.length);
-	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
-	return bytes.buffer;
-};
+const decodeBase64 = (value) => base64ToBytes(value).buffer;
 const encodeValue = (value) => {
 	if (value === void 0) return { type: "undefined" };
 	if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;

package/dist/managers/reviewDisplayMode.d.ts

@@ -0,0 +1,8 @@
+import { DisplayMode } from "./EditorModeManager.js";
+//#region src/managers/reviewDisplayMode.d.ts
+/** The host's reading of pending revisions; it never changes the saved document. */
+declare const REVIEW_DISPLAY_MODES: readonly ["all-markup", "final", "original"];
+type ReviewDisplayMode = (typeof REVIEW_DISPLAY_MODES)[number];
+declare const reviewDisplayModeToDisplayMode: (mode: ReviewDisplayMode) => DisplayMode;
+//#endregion
+export { REVIEW_DISPLAY_MODES, ReviewDisplayMode, reviewDisplayModeToDisplayMode };

package/dist/managers/reviewDisplayMode.js

@@ -0,0 +1,15 @@
+//#region src/managers/reviewDisplayMode.ts
+/** The host's reading of pending revisions; it never changes the saved document. */
+const REVIEW_DISPLAY_MODES = [
+	"all-markup",
+	"final",
+	"original"
+];
+const REVIEW_DISPLAY_MODE_VIEWS = {
+	"all-markup": "all-markup",
+	final: "no-markup",
+	original: "original"
+};
+const reviewDisplayModeToDisplayMode = (mode) => REVIEW_DISPLAY_MODE_VIEWS[mode];
+//#endregion
+export { REVIEW_DISPLAY_MODES, reviewDisplayModeToDisplayMode };

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

@@ -8,8 +8,10 @@ type ScrollEditorElementOptions = {
   behavior?: ScrollBehavior;
   /** Space to leave between the target and the visible root edge. */
   margin?: number;
+  /** Measured target range when only part of the element should be revealed. */
+  rect?: DOMRectReadOnly;
 };
 /** Scroll only the marked root, including when the target is inside a scaled viewport. */
-declare const scrollEditorElementIntoView: (element: HTMLElement | null, { block, behavior, margin }?: ScrollEditorElementOptions) => void;
+declare const scrollEditorElementIntoView: (element: HTMLElement | null, { block, behavior, margin, rect }?: ScrollEditorElementOptions) => void;
 //#endregion
 export { getEditorScrollRoot, scrollEditorBy, scrollEditorElementIntoView, scrollEditorTo };

package/dist/paged-layout/editorScrollRoot.js

@@ -25,10 +25,10 @@ const nearestScrollOffset = ({ targetStart, targetEnd, viewportStart, viewportEn
 	return 0;
 };
 /** Scroll only the marked root, including when the target is inside a scaled viewport. */
-const scrollEditorElementIntoView = (element, { block = "center", behavior = prefersReducedMotionBehavior(), margin = 0 } = {}) => {
+const scrollEditorElementIntoView = (element, { block = "center", behavior = prefersReducedMotionBehavior(), margin = 0, rect } = {}) => {
 	const root = getEditorScrollRoot(element);
 	if (!root || !element) return;
-	const targetRect = element.getBoundingClientRect();
+	const targetRect = rect ?? element.getBoundingClientRect();
 	const rootRect = root.getBoundingClientRect();
 	const visibleTop = rootRect.top + root.clientTop;
 	const targetTop = targetRect.top - visibleTop + root.scrollTop;

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

@@ -1,14 +1,23 @@
 import { Layout } from "../layout-engine/types.js";
 import "../layout-engine/index.js";
+import { MarkupViewProjection } from "../prosemirror/markupViewProjection.js";
 import { Node } from "prosemirror-model";
 //#region src/paged-layout/pageText.d.ts
+type PageTextOptions = {
+  layout: Layout | null;
+  doc: Node;
+  page: number;
+  projection?: MarkupViewProjection;
+};
 /**
  * The plain text of a single rendered page (1-based), read by joining each of
  * the page's layout fragments' `[pmStart, pmEnd)` document text with a
- * newline. Fragments with no `pmStart`/`pmEnd` (e.g. a page-shell placeholder)
+ * newline. A review projection maps those authored ranges to the displayed
+ * document, excluding text the view hides. Fragments with no `pmStart`/`pmEnd`
+ * (e.g. a page-shell placeholder)
  * are skipped. Returns `null` when the layout hasn't been computed yet or the
  * page number is out of range.
  */
-declare const getPageTextFromLayout: (layout: Layout | null, doc: Node, page: number) => string | null;
+declare const getPageTextFromLayout: ({ layout, doc, page, projection }: PageTextOptions) => string | null;
 //#endregion
 export { getPageTextFromLayout };