@stll/folio-core 0.60.0 → 0.62.0

package/dist/controller/canonicalListRendering.js

@@ -1,160 +1,6 @@
-import { foldListNumberFields, planParagraphListNumberFold, unfoldedListNumberContent } from "../docx/foldedListNumberFields.js";
-import { computeListMarker } from "../docx/listMarkerComputation.js";
-import { listRenderingDefinitionsMatch } from "../docx/listRendering.js";
-import { computeListRendering, getCachedNumberingMap } from "../docx/numberingParser.js";
-import { assignParagraphIndentationProjection, cloneParagraphWithPropertySource, paragraphFormattingWithAuthoredIndentation, sameParagraphIndentationProjection } from "../docx/paragraphPropertySource.js";
-import { effectiveParagraphNumberingReference, paragraphNumberingSourcesFromBoundary } from "../prosemirror/numberingAttr.js";
-import { paragraphIndentationFromFormatting } from "../prosemirror/paragraphIndentation.js";
-import { listIndentationProvenancePatch } from "../prosemirror/styles/resolvedStyleAttrs.js";
-import { createStyleResolver } from "../prosemirror/styles/styleResolver.js";
-import { canonicalJson } from "../utils/canonicalJson.js";
-import { panic } from "better-result";
-import { DOCUMENT_OP_TYPES, EMPTY_PROPERTY_SETS, OP_STORIES, registerParagraphPropertySnapshot, withBodyContent } from "@stll/docx-core/ops";
+import { normalizeListModelRendering } from "../docx/listModelNormalization.js";
 //#region src/controller/canonicalListRendering.ts
-/** Canonical edits retain authored fields; list rendering follows the current numbering. */
-const normalizeCanonicalListRendering = (document) => {
-	const inverse = [];
-	const styles = createStyleResolver(document.package.styles);
-	const numbering = document.package.numbering === void 0 ? null : getCachedNumberingMap(document.package.numbering);
-	const normalizeBody = (body, story) => {
-		const counters = {
-			numbering,
-			listCounters: /* @__PURE__ */ new Map(),
-			abstractCounters: /* @__PURE__ */ new Map(),
-			restartedNumIds: /* @__PURE__ */ new Set(),
-			previousList: {
-				abstractNumId: null,
-				fromStyle: false,
-				numId: null
-			}
-		};
-		const content = body.content.map((paragraph) => {
-			if (paragraph.type !== "paragraph") return paragraph;
-			registerParagraphPropertySnapshot({
-				paragraph,
-				snapshot: paragraphFormattingWithAuthoredIndentation(paragraph)
-			});
-			const formatting = paragraph.formatting;
-			const next = cloneParagraphWithPropertySource(paragraph, {});
-			if (formatting?.numPrFromStyle !== void 0 && (formatting.numPr?.kind === "reference" || formatting.numPr?.kind === "none")) {
-				next.formatting = { ...formatting };
-				delete next.formatting.numPrFromStyle;
-				inverse.push({
-					type: DOCUMENT_OP_TYPES.SET_PARAGRAPH_PROPS,
-					story,
-					blockId: paragraph.paraId ?? panic("Canonical numbering normalization requires paragraph identities."),
-					patch: { numPrFromStyle: formatting.numPrFromStyle }
-				});
-			}
-			const numPr = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
-				numPr: next.formatting?.numPr,
-				numPrFromStyle: next.formatting?.numPrFromStyle
-			}));
-			if (paragraph.listRendering === void 0 && formatting?.numPrFromStyle === void 0 && (numPr?.kind !== "reference" || numbering === null)) {
-				computeListMarker(paragraph, counters);
-				return paragraph;
-			}
-			const definition = numPr?.kind === "reference" && numbering !== null ? computeListRendering(numPr, numbering) : null;
-			const cached = paragraph.listRendering;
-			const rendering = definition !== null && cached !== void 0 && listRenderingDefinitionsMatch(cached, definition) ? { ...cached } : definition;
-			const authoredFormatting = paragraphFormattingWithAuthoredIndentation(next);
-			assignParagraphIndentationProjection({
-				paragraph: next,
-				authored: authoredFormatting,
-				inherited: paragraphIndentationFromFormatting(listIndentationProvenancePatch({
-					direct: paragraphIndentationFromFormatting(authoredFormatting),
-					styleFormatting: styles.resolveParagraphStyle(next.formatting?.styleId).paragraphFormatting,
-					numberingSource: next.formatting?.numPr?.kind === "reference" || next.formatting?.numPrFromStyle === void 0 ? "paragraph" : "style",
-					numPr: numPr?.kind === "reference" ? {
-						numId: numPr.numId,
-						ilvl: numPr.ilvl ?? 0
-					} : void 0,
-					numbering
-				})._resolvedFormatting) ?? {}
-			});
-			if (canonicalJson(paragraphIndentationFromFormatting(next.formatting)) !== canonicalJson(paragraphIndentationFromFormatting(formatting))) inverse.unshift({
-				type: DOCUMENT_OP_TYPES.SET_PARAGRAPH_PROPS,
-				story,
-				blockId: paragraph.paraId ?? panic("Canonical numbering normalization requires paragraph identities."),
-				patch: {
-					indentLeft: formatting?.indentLeft ?? null,
-					indentRight: formatting?.indentRight ?? null,
-					indentFirstLine: formatting?.indentFirstLine ?? null,
-					hangingIndent: formatting?.hangingIndent ?? null
-				},
-				whenEmpty: formatting === void 0 ? EMPTY_PROPERTY_SETS.OMIT : EMPTY_PROPERTY_SETS.KEEP
-			});
-			if (rendering === null) delete next.listRendering;
-			else {
-				const fields = foldListNumberFields(paragraph.content.map(unfoldedListNumberContent), () => void 0).fieldCount;
-				if (fields === 0) delete rendering.implicitChildLevelAdvances;
-				else rendering.implicitChildLevelAdvances = fields;
-				const template = rendering.markerTemplate ?? rendering.marker;
-				const fold = planParagraphListNumberFold(paragraph.content, !rendering.isBullet && template !== "" && !template.includes("	"));
-				if (fold.suffix === void 0) delete rendering.foldedMarkerSuffix;
-				else rendering.foldedMarkerSuffix = fold.suffix;
-				const child = numbering?.getLevel(rendering.numId, rendering.level + 1)?.pPr;
-				if (fold.suffix !== void 0 && child?.hangingIndent === true && child.indentFirstLine !== void 0 && child.indentFirstLine < 0) rendering.markerSecondSlotOffsetTwips = -child.indentFirstLine;
-				else delete rendering.markerSecondSlotOffsetTwips;
-				rendering.marker = rendering.foldedMarkerSuffix !== void 0 && !template.includes("	") ? `${template}\t${rendering.foldedMarkerSuffix}` : template;
-				next.listRendering = rendering;
-			}
-			computeListMarker(next, counters);
-			registerParagraphPropertySnapshot({
-				paragraph: next,
-				snapshot: authoredFormatting
-			});
-			if (sameParagraphIndentationProjection({
-				left: next,
-				right: paragraph
-			}) && canonicalJson(next.formatting) === canonicalJson(formatting) && canonicalJson(next.listRendering) === canonicalJson(cached)) return paragraph;
-			return next;
-		});
-		return content.every((paragraph, index) => paragraph === body.content[index]) ? body : {
-			...body,
-			...withBodyContent(body, content)
-		};
-	};
-	const pkg = document.package;
-	const body = normalizeBody(pkg.document, OP_STORIES.MAIN);
-	const normalizeParts = (parts, kind) => {
-		if (parts === void 0) return parts;
-		const normalized = new Map([...parts].map(([id, part]) => [id, normalizeBody(part, {
-			kind,
-			rId: id
-		})]));
-		return [...normalized].every(([id, part]) => part === parts.get(id)) ? parts : normalized;
-	};
-	const normalizeNotes = (notes, kind) => {
-		if (notes === void 0) return notes;
-		const normalized = notes.map((note) => normalizeBody(note, {
-			kind,
-			id: note.id
-		}));
-		return normalized.every((note, index) => note === notes[index]) ? notes : normalized;
-	};
-	const headers = normalizeParts(pkg.headers, "header");
-	const footers = normalizeParts(pkg.footers, "footer");
-	const footnotes = normalizeNotes(pkg.footnotes, "footnote");
-	const endnotes = normalizeNotes(pkg.endnotes, "endnote");
-	if (body === pkg.document && headers === pkg.headers && footers === pkg.footers && footnotes === pkg.footnotes && endnotes === pkg.endnotes) return {
-		document,
-		inverse
-	};
-	return {
-		inverse,
-		document: {
-			...document,
-			package: {
-				...pkg,
-				document: body,
-				...headers === void 0 ? {} : { headers },
-				...footers === void 0 ? {} : { footers },
-				...footnotes === void 0 ? {} : { footnotes },
-				...endnotes === void 0 ? {} : { endnotes }
-			}
-		}
-	};
-};
+/** Canonical edits share list model normalization with the headless projection. */
+const normalizeCanonicalListRendering = normalizeListModelRendering;
 //#endregion
 export { normalizeCanonicalListRendering };

package/dist/controller/headerFooterEditorManager.d.ts

@@ -18,6 +18,7 @@ type HeaderFooterEditorTransaction = {
 type HeaderFooterEditorManagerDeps = {
   createView?: ((mountNode: HTMLElement, props: DirectEditorProps) => EditorView) | undefined;
   getDocument: () => document_d_exports.Document | null;
+  getReadOnly?: (() => boolean) | undefined;
   getCanonicalApi?: (() => HiddenEditorApi | null) | undefined;
   getExperimentalSession?: (() => "canonical" | undefined) | undefined;
   onSessionRefusal?: ((reason: string, gap: CanonicalGap, error?: Error) => void) | undefined;

package/dist/controller/headerFooterEditorManager.js

@@ -91,6 +91,15 @@ const createHeaderFooterEditorManager = (deps) => {
 	const sync = () => {
 		const host = deps.getHost();
 		if (!host) return;
+		const getReadOnly = deps.getReadOnly;
+		if (getReadOnly) {
+			const readOnly = getReadOnly();
+			for (const part of mounted.values()) {
+				const expectedEditable = !readOnly;
+				if (part.view.editable === expectedEditable) continue;
+				part.view.setProps({ editable: () => !getReadOnly() });
+			}
+		}
 		if (usesCanonicalSession(deps.getExperimentalSession?.(), CANONICAL_GAP.authorityRouting) && !deps.getCanonicalApi?.()?.getCanonicalStoryProjection(OP_STORIES.MAIN)) return;
 		const document = getOwnedDocument();
 		const styles = deps.getStyles();
@@ -179,11 +188,13 @@ const createHeaderFooterEditorManager = (deps) => {
 			}
 			const view = (deps.createView ?? createEditorView)(mountNode, {
 				...canonical.props,
+				editable: () => !(deps.getReadOnly?.() ?? false),
 				state: canonicalProjection ? EditorState.create({
 					doc: canonicalProjection,
 					plugins: [createDocumentStyleContextPlugin(styles), createDocumentNumberingPlugin(numbering)]
 				}) : buildInitialState(headerFooter, styles, theme, numbering, manager),
 				dispatchTransaction(transaction) {
+					if ((deps.getReadOnly?.() ?? false) && transaction.docChanged) return;
 					if (canonical.dispatch(transaction)) return;
 					const nextState = view.state.apply(transaction);
 					const docChanged = !nextState.doc.eq(view.state.doc);

package/dist/controller/hiddenEditorManager.d.ts

@@ -1,10 +1,10 @@
 import { document_d_exports } from "../types/document.js";
 import { CanonicalGap } from "../types/canonicalCapabilities.js";
+import { EditorMode } from "../managers/EditorModeManager.js";
 import { HiddenEditorApi } from "./hiddenEditorApi.js";
 import { HiddenEditorStateReason } from "../layout-engine/layoutInstrumentation.js";
 import { ExtensionManager } from "../prosemirror/extensions/ExtensionManager.js";
 import { RemoteSelection } from "../types/remote-selection.js";
-import { EditorMode } from "../managers/EditorModeManager.js";
 import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 import * as Yjs from "yjs";

package/dist/controller/hiddenEditorManager.js

@@ -812,7 +812,9 @@ const createHiddenEditorManager = (deps) => {
 	};
 	const syncEditable = () => {
 		if (!view) return;
-		syncHiddenEditorAccessibility(view, deps.getReadOnly());
+		const readOnly = deps.getReadOnly();
+		if (view.editable !== !readOnly) view.setProps({ editable: () => !deps.getReadOnly() });
+		syncHiddenEditorAccessibility(view, readOnly);
 	};
 	const publishStoryCommit = (storyView, commit) => {
 		if (!view || editorSession.type !== "canonical") return false;

package/dist/controller/layoutPipeline.d.ts

@@ -1,8 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 import { TemplatePreviewEntry, TemplatePreviewHiddenRange } from "../prosemirror/plugins/templatePreviewValues.js";
+import { DisplayMode } from "../managers/EditorModeManager.js";
 import { ColumnLayout, FlowBlock, FootnoteContent, HeaderFooterContent, Layout, Measure, PageHeaderFooterRefs, PageMargins } from "../layout-engine/types.js";
 import { LayoutRunOptions } from "./layoutRunOptions.js";
-import { DisplayMode } from "../managers/EditorModeManager.js";
 import { LayoutSession } from "./layoutSession.js";
 import { HyphenationReadiness } from "./hyphenationReadiness.js";
 import { ConvertHeaderFooterOptions, HeaderFooterMetrics } from "../layout-bridge/convert/headerFooterLayout.js";
@@ -79,6 +79,8 @@ type LayoutPipelineDeps<THfPMs> = {
    * authored text with runs hidden afterwards.
    */
   markupView: DisplayMode;
+  /** Independent highlight visibility in All Markup; resolved views always hide comments. */
+  showCommentHighlights?: boolean;
 };
 declare function runLayoutPipeline<THfPMs>(deps: LayoutPipelineDeps<THfPMs>, state: EditorState, options?: LayoutRunOptions): LayoutOutcome;
 //#endregion

package/dist/controller/layoutPipeline.js

@@ -42,7 +42,7 @@ const formatEndnoteTexts = (numbers, formatNumber) => {
 	for (const [id, displayNumber] of numbers) texts.set(id, formatNumber(displayNumber));
 	return texts;
 };
-const sameMeasureInputs = (left, right) => left.embeddedFontFamilyMap === right.embeddedFontFamilyMap && left.styles === right.styles && left.theme === right.theme && left.defaultTabStop === right.defaultTabStop && left.pageContentHeight === right.pageContentHeight && left.fontSet === right.fontSet && left.fontAlternates.size === right.fontAlternates.size && [...left.fontAlternates].every(([name, alternate]) => right.fontAlternates.get(name) === alternate) && left.markupView === right.markupView;
+const sameMeasureInputs = (left, right) => left.embeddedFontFamilyMap === right.embeddedFontFamilyMap && left.styles === right.styles && left.theme === right.theme && left.defaultTabStop === right.defaultTabStop && left.pageContentHeight === right.pageContentHeight && left.fontSet === right.fontSet && left.fontAlternates.size === right.fontAlternates.size && [...left.fontAlternates].every(([name, alternate]) => right.fontAlternates.get(name) === alternate) && left.markupView === right.markupView && left.showCommentHighlights === right.showCommentHighlights;
 /**
 * The range an incremental pass re-measures, or `null` for a full measure: the
 * committed measures must come from the same measure inputs, and the range is
@@ -136,7 +136,7 @@ function runLayoutPipeline(deps, state, options = {}) {
 	return result;
 }
 function runLayoutPipelineMeasured(deps, state, options) {
-	const { contentWidth, columns, pageSize, margins, pageGap, showMarginGuides, marginGuideColor, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, readFontSetSignature, buildFootnoteRenderItems, describeInvalidHighlightMarks, pageRenderer = PAGE_RENDERER.legacy, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES, emptyTemplatePreviewHidden: EMPTY_TEMPLATE_PREVIEW_HIDDEN, markupView } = deps;
+	const { contentWidth, columns, pageSize, margins, pageGap, showMarginGuides, marginGuideColor, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, readFontSetSignature, buildFootnoteRenderItems, describeInvalidHighlightMarks, pageRenderer = PAGE_RENDERER.legacy, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES, emptyTemplatePreviewHidden: EMPTY_TEMPLATE_PREVIEW_HIDDEN, markupView, showCommentHighlights = true } = deps;
 	let outcome = {};
 	let pendingArtifacts;
 	let pendingTemplatePreview;
@@ -154,6 +154,7 @@ function runLayoutPipelineMeasured(deps, state, options) {
 		let phaseStartedAt = performance.now();
 		const pageContentHeight = pageSize.h - margins.top - margins.bottom;
 		const fontAlternates = buildFontAlternates(document?.package.fontTable);
+		const displayCommentHighlights = showCommentHighlights && markupView !== "no-markup" && markupView !== "original";
 		const embeddedFontFamilies = session.embeddedFontFamilyMap ? { embeddedFontFamilyMap: session.embeddedFontFamilyMap } : {};
 		const measureInputs = {
 			...embeddedFontFamilies,
@@ -163,9 +164,11 @@ function runLayoutPipelineMeasured(deps, state, options) {
 			pageContentHeight,
 			fontSet,
 			fontAlternates,
-			markupView
+			markupView,
+			showCommentHighlights: displayCommentHighlights
 		};
 		const flowOpts = {
+			showCommentHighlights: displayCommentHighlights,
 			...embeddedFontFamilies,
 			pageContentHeight,
 			fontAlternates,
@@ -246,6 +249,8 @@ function runLayoutPipelineMeasured(deps, state, options) {
 		const buildHfOptions = (pageCount, fieldInputs) => {
 			const hfMeasureBlocks = (hfBlocks, hfWidth) => measureBlocks(hfBlocks, hfWidth, void 0, void 0, buildHeaderFooterFieldValues(hfBlocks, pageCount, hfClock, fieldInputs), { allowEndTabOverflow: true });
 			return {
+				markupView,
+				showCommentHighlights: displayCommentHighlights,
 				...flowOpts.styles ? { styles: flowOpts.styles } : {},
 				...document?.package.numbering === void 0 ? {} : { numbering: document.package.numbering },
 				...flowOpts.defaultSize === void 0 ? {} : { defaultSize: flowOpts.defaultSize },
@@ -378,7 +383,11 @@ function runLayoutPipelineMeasured(deps, state, options) {
 		outcome.measures = newMeasures;
 		recordPhaseDuration("measure-blocks", phaseStartedAt);
 		const buildNoteOptions = () => {
-			const noteOptions = { measureBlocks };
+			const noteOptions = {
+				measureBlocks,
+				showCommentHighlights: displayCommentHighlights,
+				markupView
+			};
 			if (flowOpts.styles) noteOptions.styles = flowOpts.styles;
 			if (flowOpts.defaultSize !== void 0) noteOptions.defaultSize = flowOpts.defaultSize;
 			if (_theme !== void 0) noteOptions.theme = _theme;

package/dist/controller/layoutSession.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { TemplatePreviewEntry, TemplatePreviewHiddenRange, TemplatePreviewValues } from "../prosemirror/plugins/templatePreviewValues.js";
-import { FlowBlock, Measure } from "../layout-engine/types.js";
 import { DisplayMode } from "../managers/EditorModeManager.js";
+import { FlowBlock, Measure } from "../layout-engine/types.js";
 import { FontAlternates } from "../fonts/fontAlternates.js";
 import { EditorState } from "prosemirror-state";
 //#region src/controller/layoutSession.d.ts
@@ -36,6 +36,7 @@ type LayoutMeasureInputs = {
   fontAlternates: FontAlternates;
   /** The review view: each lays out different text, so a measure is reusable only within one. */
   markupView: DisplayMode;
+  showCommentHighlights?: boolean;
 };
 type LayoutSession = {
   embeddedFontFamilyMap?: ReadonlyMap<string, string>;

package/dist/controller/noteEditorManager.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { CanonicalGap } from "../types/canonicalCapabilities.js";
-import { HiddenEditorApi } from "./hiddenEditorApi.js";
 import { NoteStoryKey } from "../types/editor-story.js";
+import { HiddenEditorApi } from "./hiddenEditorApi.js";
 import { Plugin } from "prosemirror-state";
 import { DirectEditorProps, EditorView } from "prosemirror-view";
 //#region src/controller/noteEditorManager.d.ts

package/dist/display-list/build/imagePrimitives.js

@@ -1,5 +1,6 @@
 import { parseRotationDegrees } from "../../utils/rotationBoundingBox.js";
 import { sanitizeImageSrc } from "../../utils/sanitizeImageSrc.js";
+import { base64ToBytes, encodeUtf8 } from "../../utils/textEncoding.js";
 import { paintPreview } from "./previewPrimitives.js";
 import { resolveBorderStroke } from "./strokes.js";
 import { UNSUPPORTED_CONSTRUCT } from "./unsupported.js";
@@ -10,23 +11,19 @@ import { Result } from "better-result";
 *
 * The display list carries raw bytes plus the format they are already in, so a
 * backend never owns a codec. This module therefore decodes only far enough to
-* fill `pixelWidth`/`pixelHeight` and to know PNG from JPEG. It transcodes
-* nothing: a WMF, EMF, TIFF, SVG, GIF or BMP source is reported through
-* `unsupported` and paints nothing, because a silently missing picture is worse
-* than a named one.
+* fill `pixelWidth`/`pixelHeight` and identify PNG, JPEG, or a generated SVG
+* preview. It transcodes nothing: WMF, EMF, TIFF, GIF, and BMP are reported
+* through `unsupported` and paint nothing, because a silently missing picture
+* is worse than a named one.
 */
-const DATA_URL_PATTERN = /^data:([^;,]*)(;base64)?,(.*)$/su;
+const DATA_URL_PATTERN = /^data:([^;,]*)(?:;charset=[^;,]*)?(;base64)?,(.*)$/su;
 /**
 * `undefined` for a payload `atob` rejects: a malformed `data:` URL is a
 * document the builder reports, not an exception that aborts the build.
 */
 const decodeBase64 = (encoded) => {
-	const decoded = Result.try(() => atob(encoded));
-	if (decoded.isErr()) return;
-	const binary = decoded.value;
-	const bytes = new Uint8Array(binary.length);
-	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
-	return bytes;
+	const decoded = Result.try(() => base64ToBytes(encoded));
+	return decoded.isOk() ? decoded.value : void 0;
 };
 const readUint32BE = (bytes, offset) => bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3];
 const readUint16BE = (bytes, offset) => bytes[offset] << 8 | bytes[offset + 1];
@@ -164,7 +161,26 @@ var ImageTable = class {
 		if (safeSrc === void 0) return fail("image source is not a data: or blob: URL");
 		const match = DATA_URL_PATTERN.exec(safeSrc);
 		if (!match) return fail("image bytes are not inline (blob: URLs need a fetch the builder cannot do)");
-		if (match[2] === void 0) return fail("only base64 data: URLs carry decodable bytes");
+		if (match[1] === "image/svg+xml" && match[2] === void 0) {
+			const decoded = Result.try(() => decodeURIComponent(match[3]));
+			if (decoded.isErr()) return fail("SVG data: URL payload is not valid percent-encoding");
+			if (!decoded.value.includes("data-folio-preview=\"wpGroup\"")) return fail("SVG is not a supported generated group preview");
+			const width = /<svg\b[^>]*\bwidth="([0-9.]+)"/u.exec(decoded.value)?.at(1);
+			const height = /<svg\b[^>]*\bheight="([0-9.]+)"/u.exec(decoded.value)?.at(1);
+			const pixelWidth = width === void 0 ? 0 : Number(width);
+			const pixelHeight = height === void 0 ? 0 : Number(height);
+			if (!(pixelWidth > 0 && pixelHeight > 0)) return fail("SVG carries no positive numeric width and height");
+			const ref = this.sources.length;
+			this.sources.push({
+				format: "svg",
+				bytes: encodeUtf8(decoded.value),
+				pixelWidth,
+				pixelHeight
+			});
+			this.refBySrc.set(src, ref);
+			return ref;
+		}
+		if (match[2] === void 0) return fail("only base64 data: URLs and SVG previews carry decodable bytes");
 		const bytes = decodeBase64(match[3]);
 		if (bytes === void 0) return fail("image data: URL payload is not valid base64");
 		if (bytes.length === 0) return fail("image data: URL decoded to no bytes");

package/dist/display-list/build/paragraphPrimitives.js

@@ -353,7 +353,7 @@ const smallCapsGlyphRunSegments = (glyphs, fontSizePx) => {
 * first, then the glyphs, then the decorations whose geometry CSS would have
 * derived from the font.
 */
-const emitGlyphRun = ({ sink, context, run, glyphs, style, paintXPx, baselineYPx, lineTopYPx, lineHeightPx, isRtl, pmRange, collapsedEdge }) => {
+const emitGlyphRun = ({ sink, context, run, glyphs, style, paintXPx, baselineYPx, lineTopYPx, lineHeightPx, isRtl, pmRange, decorationRange, collapsedEdge }) => {
 	if (glyphs.text.length === 0) return;
 	const fontSizePx = ptToPx(style.fontSize ?? 11);
 	const color = resolveRunColor(run, context);
@@ -423,6 +423,7 @@ const emitGlyphRun = ({ sink, context, run, glyphs, style, paintXPx, baselineYPx
 		...unicodeBidi === void 0 ? {} : { unicodeBidi },
 		...stroke === void 0 ? {} : { stroke },
 		...pmRange === void 0 ? {} : { pmRange },
+		...decorationRange === void 0 ? {} : { decorationRange },
 		...collapsedEdge === void 0 ? {} : { collapsedEdge }
 	};
 	const smallCapsRuns = style.fontVariant === "small-caps" && direction === "ltr" ? smallCapsGlyphRunSegments(glyphs, fontSizePx) : void 0;
@@ -436,6 +437,7 @@ const emitGlyphRun = ({ sink, context, run, glyphs, style, paintXPx, baselineYPx
 	else {
 		const adjustments = glyphs.adjustments === void 0 ? {} : { adjustments: glyphs.adjustments };
 		let segmentXPx = paintXPx;
+		let segmentTextOffset = 0;
 		for (const segment of smallCapsRuns) {
 			sink.glyphs.push({
 				kind: "glyphRun",
@@ -446,9 +448,14 @@ const emitGlyphRun = ({ sink, context, run, glyphs, style, paintXPx, baselineYPx
 				kerning: glyphs.kerning,
 				smallCaps: true,
 				...adjustments,
-				...commonFields
+				...commonFields,
+				...decorationRange === void 0 ? {} : { decorationRange: {
+					...decorationRange,
+					textOffset: decorationRange.textOffset + segmentTextOffset
+				} }
 			});
 			segmentXPx += segment.widthPx;
+			segmentTextOffset += segment.text.length;
 		}
 	}
 	emitDecorations({
@@ -681,6 +688,12 @@ const paintLine = ({ block, line, geometry, context, alignment, isRtl, isFirstLi
 						kind: "text",
 						text: glyphs.text
 					},
+					...run.pmStart === void 0 || run.pmEnd === void 0 || resolveFieldText(run, context) !== run.fallback ? {} : { decorationRange: {
+						start: run.pmStart,
+						end: run.pmEnd,
+						story: context.story,
+						textOffset: 0
+					} },
 					glyphs,
 					style,
 					paintXPx: paintXOf(),

package/dist/display-list/dom/renderDisplayListToDom.js

@@ -48,7 +48,8 @@ const PAGE_ELEMENT_ID_PREFIX = "page-";
 const DEGREES_PER_RADIAN = 180 / Math.PI;
 const IMAGE_MIME_TYPES = {
 	png: "image/png",
-	jpeg: "image/jpeg"
+	jpeg: "image/jpeg",
+	svg: "image/svg+xml"
 };
 /**
 * The display list does not say whether an embedded face is sfnt or WOFF, so a
@@ -252,11 +253,11 @@ const applyAdjustments = (span, adjustments) => {
 * and in each note, so a surface has to know which one it landed in before it
 * can use the number at all.
 */
-const applyModelRange = (span, range) => {
+const applyModelRange = (span, range, purpose = "editing") => {
 	if (range === void 0) return;
-	span.className = "layout-run-text";
-	span.dataset["pmStart"] = String(range.start);
-	span.dataset["pmEnd"] = String(range.end);
+	if (purpose === "editing") span.className = "layout-run-text";
+	span.dataset[purpose === "editing" ? "pmStart" : "decorationStart"] = String(range.start);
+	span.dataset[purpose === "editing" ? "pmEnd" : "decorationEnd"] = String(range.end);
 	const { story } = range;
 	span.dataset["story"] = story.kind;
 	switch (story.kind) {
@@ -300,6 +301,8 @@ const paintGlyphRun = (run, context) => {
 	applyAdjustments(span, run.adjustments);
 	span.dataset["advanceSum"] = String(advanceSum);
 	applyModelRange(span, run.pmRange);
+	applyModelRange(span, run.decorationRange, "decoration");
+	if (run.decorationRange) span.dataset["decorationTextOffset"] = String(run.decorationRange.textOffset);
 	if (run.collapsedEdge !== void 0) {
 		span.dataset[run.collapsedEdge.side === "leading" ? "collapsedLeadingSpaces" : "collapsedTrailingSpaces"] = "true";
 		span.dataset["collapsedSpaceAdvance"] = String(run.collapsedEdge.spaceAdvancePx);

package/dist/display-list/types.d.ts

@@ -124,11 +124,11 @@ type DisplayFontRef = number;
 type DisplayImageRef = number;
 /**
  * Raw image bytes plus the format they are already in. `png` and `jpeg`
- * pass through to PDF unchanged; every other source format is transcoded by
- * the producer, so a backend never owns a codec.
+ * pass through to PDF unchanged. SVG is retained for vector previews in the
+ * DOM backend; PDF reports it as unsupported rather than silently rasterizing.
  */
 type DisplayImageSource = {
-  readonly format: "png" | "jpeg";
+  readonly format: "png" | "jpeg" | "svg";
   readonly bytes: Uint8Array;
   readonly pixelWidth: number;
   readonly pixelHeight: number;
@@ -278,6 +278,10 @@ type DisplayGlyphRun = {
    * substituted field value, a tab leader.
    */
   readonly pmRange?: DisplayModelRange;
+  /** Source atom for view-only decorations; never used for editing positions. */
+  readonly decorationRange?: DisplayModelRange & {
+    readonly textOffset: number;
+  };
 };
 /** An axis-aligned rectangle, filled and/or stroked. At least one is set. */
 type DisplayRectPrimitive = {

package/dist/docx/canonicalStoryRepack.js

@@ -1,5 +1,6 @@
 import { withTrackedSectionEndpointRemoval } from "../internal/sectionEndpointResolution.js";
 import { withSectionReferenceResolution } from "../internal/sectionReferenceResolution.js";
+import { decodeText, encodeUtf8 } from "../utils/textEncoding.js";
 import { readDocumentSectionFacts } from "./documentSectionFacts.js";
 import { parseDocx } from "./parser.js";
 import { assertSectionCarriersMatchModel } from "./rezip.js";
@@ -9,7 +10,7 @@ import JSZip from "jszip";
 /** Canonical snapshots own explicit section references; the PM projection does not. */
 const referenceKey = ({ element, type, rId }) => `${element}:${type}:${rId}`;
 const xmlFingerprint = async (xml) => {
-	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(xml));
+	const digest = await crypto.subtle.digest("SHA-256", encodeUtf8(xml));
 	let fingerprint = "";
 	for (const byte of new Uint8Array(digest)) fingerprint += byte.toString(16).padStart(2, "0");
 	return fingerprint;
@@ -18,7 +19,7 @@ const xmlFingerprint = async (xml) => {
 const repackWithCanonicalStoryRemovals = async ({ document, repack }) => {
 	const originalBuffer = document.originalBuffer;
 	if (!originalBuffer) return repack();
-	const xml = await (await JSZip.loadAsync(originalBuffer)).file("word/document.xml")?.async("text");
+	const xml = await (await JSZip.loadAsync(originalBuffer)).file("word/document.xml")?.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	if (!xml) return repack();
 	const before = readDocumentSectionFacts(xml);
 	const serializedXml = serializeDocument(document);

package/dist/docx/commentTextParagraph.d.ts

@@ -0,0 +1,6 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/commentTextParagraph.d.ts
+/** Plain comment text has no authored paragraph formatting. */
+declare const commentTextParagraph: (text: string) => document_d_exports.Paragraph;
+//#endregion
+export { commentTextParagraph };

package/dist/docx/commentTextParagraph.js

@@ -0,0 +1,15 @@
+//#region src/docx/commentTextParagraph.ts
+/** Plain comment text has no authored paragraph formatting. */
+const commentTextParagraph = (text) => ({
+	type: "paragraph",
+	content: [{
+		type: "run",
+		formatting: {},
+		content: [{
+			type: "text",
+			text
+		}]
+	}]
+});
+//#endregion
+export { commentTextParagraph };

package/dist/docx/conformance.js

@@ -1,3 +1,4 @@
+import { sliceText } from "../utils/sliceText.js";
 import { getLocalName, getNamespacePrefix, parseXmlDocument } from "./xmlParser.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 //#region src/docx/conformance.ts
@@ -62,7 +63,11 @@ function scanRootStartTag(scanTarget) {
 }
 const detectDocxConformanceClass = (documentXml) => {
 	if (documentXml === null) return DOCX_CONFORMANCE_CLASSES.UNKNOWN;
-	const rootStartTag = scanRootStartTag(documentXml.length <= ROOT_START_TAG_SCAN_LIMIT ? documentXml : documentXml.slice(0, ROOT_START_TAG_SCAN_LIMIT));
+	const rootStartTag = scanRootStartTag(documentXml.length <= ROOT_START_TAG_SCAN_LIMIT ? documentXml : sliceText({
+		text: documentXml,
+		units: "codeUnits",
+		end: ROOT_START_TAG_SCAN_LIMIT
+	}));
 	const root = (rootStartTag === void 0 ? null : parseXmlDocument(rootStartTag.endsWith("/>") ? rootStartTag : `${rootStartTag.slice(0, -1)}/>`)) ?? parseXmlDocument(documentXml);
 	return detectDocxConformanceClassFromRoot(root);
 };

package/dist/docx/diagramPreview.js

@@ -1,3 +1,4 @@
+import { decodeText } from "../utils/textEncoding.js";
 import { resolveRelationshipIdOfType, resolveRelativePath } from "./relsParser.js";
 import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, findChildByNamespaceUri, getAttribute, getAttributeByNamespaceUri, getLocalName, parseNumericAttribute, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/diagramPreview.ts
@@ -31,7 +32,7 @@ const partByRelationshipId = ({ rels, media, rId, type, cache }) => {
 	const cached = cache.get(path);
 	if (cached !== void 0) return cached;
 	const file = media.get(path);
-	const parsed = file?.data ? parseXmlDocument(new TextDecoder().decode(file.data)) : null;
+	const parsed = file?.data ? parseXmlDocument(decodeText(new Uint8Array(file.data))) : null;
 	cache.set(path, parsed);
 	return parsed;
 };

package/dist/docx/documentParser.d.ts

@@ -19,6 +19,18 @@ declare function extractTemplateVariables(text: string): string[];
  * @returns Array of unique variable names
  */
 declare function extractAllTemplateVariables(content: document_d_exports.BlockContent[]): string[];
+/**
+ * Build sections from content based on section properties in paragraphs
+ *
+ * In OOXML, sections are delimited by:
+ * 1. w:pPr/w:sectPr within a paragraph (marks end of a section)
+ * 2. w:body/w:sectPr (final section properties)
+ *
+ * @param content - All block content
+ * @param finalSectPr - Final section properties from body
+ * @returns Array of sections
+ */
+declare function buildSections(content: document_d_exports.BlockContent[], finalSectPr: document_d_exports.SectionProperties | undefined): document_d_exports.Section[];
 /**
  * Parse document.xml body content
  *
@@ -67,4 +79,4 @@ declare function getSectionCount(body: document_d_exports.DocumentBody): number;
  */
 declare function hasTemplateVariables(body: document_d_exports.DocumentBody): boolean;
 //#endregion
-export { extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getParagraphCount, getSectionCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };
+export { buildSections, extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getParagraphCount, getSectionCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };

package/dist/docx/documentParser.js

@@ -257,4 +257,4 @@ function hasTemplateVariables(body) {
 	return extractAllTemplateVariables(body.content).length > 0;
 }
 //#endregion
-export { extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getParagraphCount, getSectionCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };
+export { buildSections, extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getParagraphCount, getSectionCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };