@stll/folio-core 0.15.13 → 0.16.0

package/dist/ai-edits/headless.js

@@ -8,13 +8,15 @@ import { attemptSelectiveSave } from "../docx/selectiveSave.js";
 import { acceptAIEditRevision, acceptAllChanges, rejectAIEditRevision, rejectAllChanges } from "../prosemirror/commands/comments.js";
 import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
 import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
-import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
+import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
+import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { schema, singletonManager } from "../prosemirror/schema/index.js";
 import { deterministicHexId } from "../utils/hexId.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
 import { TaggedError } from "better-result";
+import { Fragment } from "prosemirror-model";
 import { EditorState } from "prosemirror-state";
 //#region src/ai-edits/headless.ts
 /**
@@ -80,39 +82,48 @@ const createReviewerComment = (text, author) => ({
 *
 * The shared `ParaIdAllocatorExtension` mints RANDOM ids (correct for freshly
 * typed paragraphs in the live editor); this load-time pass is deterministic so
-* a paraId-less corpus document anchors reproducibly. The transaction is marked
-* ignore-tracked so the change baseline stays clean.
+* a paraId-less corpus document anchors reproducibly.
+*
+* Rebuilding only the changed branches, like {@link ensureParaIdsInDoc}, keeps
+* the pass linear in paragraph count. Seeding through a transaction instead
+* costs one `setNodeMarkup` step per paragraph, and both halves of that are
+* quadratic: every step rebuilds the containing fragment, and the plugin
+* `appendTransaction` chain rescans the accumulated step maps. Because the pass
+* runs before the state exists, no history, mapping, or change-tracking
+* semantics depend on it.
 */
-const ensureDeterministicParaIdsInState = (state) => {
+const ensureDeterministicParaIdsInDoc = (doc) => {
 	const seen = /* @__PURE__ */ new Set();
-	const updates = [];
 	let ordinal = 0;
-	state.doc.descendants((node, pos) => {
-		if (node.type.name !== "paragraph") return;
-		ordinal += 1;
-		const existing = node.attrs["paraId"];
-		if (typeof existing === "string" && existing.length > 0 && !seen.has(existing)) {
-			seen.add(existing);
-			return false;
-		}
-		let paraId = deterministicHexId(`${node.textContent}:${ordinal}`);
-		for (let salt = 1; seen.has(paraId); salt++) paraId = deterministicHexId(`${node.textContent}:${ordinal}:${salt}`);
-		seen.add(paraId);
-		updates.push({
-			pos,
-			attrs: {
-				...node.attrs,
-				paraId
+	const rewrite = (parent) => {
+		let changed = false;
+		const children = [];
+		parent.forEach((child) => {
+			let next = child;
+			if (child.type.name === "paragraph") {
+				ordinal += 1;
+				const existing = child.attrs["paraId"];
+				if (typeof existing === "string" && existing.length > 0 && !seen.has(existing)) seen.add(existing);
+				else {
+					let paraId = deterministicHexId(`${child.textContent}:${ordinal}`);
+					for (let salt = 1; seen.has(paraId); salt++) paraId = deterministicHexId(`${child.textContent}:${ordinal}:${salt}`);
+					seen.add(paraId);
+					next = child.type.create({
+						...child.attrs,
+						paraId
+					}, child.content, child.marks);
+				}
+			} else if (child.childCount > 0) {
+				const content = rewrite(child);
+				if (content !== child.content) next = child.copy(content);
 			}
+			if (next !== child) changed = true;
+			children.push(next);
 		});
-		return false;
-	});
-	if (updates.length === 0) return state;
-	const tr = state.tr;
-	for (const update of updates) tr.setNodeMarkup(update.pos, void 0, update.attrs);
-	ignoreTrackedChanges(tr);
-	tr.setMeta("addToHistory", false);
-	return state.apply(tr);
+		return changed ? Fragment.fromArray(children) : parent.content;
+	};
+	const content = rewrite(doc);
+	return content === doc.content ? doc : doc.copy(content);
 };
 const FOLIO_REVIEWED_VIEWS = Object.freeze([
 	"original",
@@ -225,9 +236,9 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			password: options.password
 		});
 		const plugins = singletonManager.getPlugins();
-		const state = ensureDeterministicParaIdsInState(EditorState.create({
+		const state = ensureBaseDirectionInState(EditorState.create({
 			schema,
-			doc: toProseDoc(baseDocument),
+			doc: ensureDeterministicParaIdsInDoc(toProseDoc(baseDocument)),
 			plugins
 		}));
 		return new FolioDocxReviewer({
@@ -711,9 +722,10 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			...this.baseDocument.package.styles !== void 0 && { styles: this.baseDocument.package.styles },
 			...this.baseDocument.package.theme !== void 0 && { theme: this.baseDocument.package.theme }
 		};
-		const state = ensureDeterministicParaIdsInState(EditorState.create({
+		const storyDoc = story.type === "header" || story.type === "footer" ? headerFooterToProseDoc(source.content, conversionOptions) : footnoteToProseDoc(source.content, conversionOptions);
+		const state = ensureBaseDirectionInState(EditorState.create({
 			schema,
-			doc: story.type === "header" || story.type === "footer" ? headerFooterToProseDoc(source.content, conversionOptions) : footnoteToProseDoc(source.content, conversionOptions),
+			doc: ensureDeterministicParaIdsInDoc(storyDoc),
 			plugins: singletonManager.getPlugins()
 		}));
 		this.secondaryStoryStates.set(key, {

package/dist/docx/server/extractDocxText.d.ts

@@ -1,6 +1,22 @@
 //#region src/docx/server/extractDocxText.d.ts
 /** Document part containing an extracted paragraph. */
 type DocxParagraphSource = "header" | "body" | "footer";
+/**
+ * Role of an emitted markdown table row.
+ *
+ * - `cells` — a `w:tr` rendered as a pipe row, including the first row when the
+ *   table declares it as its header.
+ * - `syntheticHeader` — the empty header row emitted for a table that declares
+ *   no header row; GFM has no headerless table.
+ * - `delimiter` — the `| --- |` line GFM requires under the header.
+ */
+type DocxTableRowKind = "cells" | "syntheticHeader" | "delimiter";
+/** Table membership of a paragraph whose `text` is a markdown table row. */
+type DocxTableRowPosition = {
+  /** 0-based index of the source `w:tbl`, in extraction order across all parts. */
+  table: number;
+  kind: DocxTableRowKind;
+};
 /** Paragraph text and lightweight formatting metadata from a DOCX archive. */
 type ExtractedDocxParagraph = {
   index: number;
@@ -10,6 +26,13 @@ type ExtractedDocxParagraph = {
   bold?: boolean;
   fontSize?: number;
   alignment?: "left" | "center" | "right" | "both";
+  /**
+   * Present only when `text` is a markdown table row rendered from a `w:tbl`,
+   * absent for ordinary prose paragraphs. Consumers that join `text` across
+   * paragraphs need no change; consumers that want to regroup a table's rows,
+   * or drop the rows GFM forced into existence, can key off this.
+   */
+  tableRow?: DocxTableRowPosition;
 };
 /** Accepted-revision paragraph text extracted in deterministic part order. */
 type ExtractedDocxText = {
@@ -20,4 +43,4 @@ type ExtractedDocxText = {
 /** Extract paragraph text and formatting metadata from a DOCX archive. */
 declare const extractDocxText: (bytes: ArrayBuffer | Uint8Array) => Promise<ExtractedDocxText>;
 //#endregion
-export { DocxParagraphSource, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText };
+export { DocxParagraphSource, DocxTableRowKind, DocxTableRowPosition, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText };

package/dist/docx/server/extractDocxText.js

@@ -1,3 +1,4 @@
+import { escapeTableCell } from "../../markdown/escape.js";
 import { RELATIONSHIP_TYPES, parseRelationships } from "../relsParser.js";
 import { findAllDeep, findChild, findDeep, getAttribute, getAttributeAnyPrefix, getLocalName, getTextContent, parseXml } from "../xmlParser.js";
 import { loadDocxArchive } from "./boundedArchive.js";
@@ -59,13 +60,159 @@ const readRunMetrics = (paragraph) => {
 	}
 	return metrics;
 };
-const extractContainer = ({ container, source, startIndex }) => {
+const TABLE_DELIMITER_CELL = "---";
+/** GFM cannot nest tables; an inner table joins its cells inside the outer cell. */
+const NESTED_TABLE_CELL_SEPARATOR = " / ";
+/** Word supports 63 table columns; cap well above that so a hostile `w:gridSpan` cannot balloon a row. */
+const MAX_TABLE_COLUMNS = 256;
+/** Bound the mutual recursion between a cell and the tables nested inside it. */
+const MAX_NESTED_TABLE_DEPTH = 8;
+/**
+* Collect a table's `w:tr`, or a row's `w:tc`, seeing through the wrappers Word
+* puts around them (`w:sdt` / `w:sdtContent` content controls, `w:customXml`).
+* The walk stops at `w:tbl` and `w:p` so a nested table's rows and cells never
+* leak into the grid of the table that contains them.
+*/
+const collectTableParts = (parent, localName) => {
+	const parts = [];
+	const walk = (node) => {
+		for (const child of childElements(node)) {
+			const childName = getLocalName(child.name ?? "");
+			if (childName === localName) {
+				parts.push(child);
+				continue;
+			}
+			if (childName === "tbl" || childName === "p") continue;
+			walk(child);
+		}
+	};
+	walk(parent);
+	return parts;
+};
+/**
+* Raw (unescaped) text of one cell: its paragraphs in order, one per line.
+* Blank paragraphs are dropped so a cell padded with empty paragraphs does not
+* render as a run of `<br>`. A nested table contributes one line per inner row.
+*/
+const readCellText = (cell, depth) => {
+	const lines = [];
+	const walk = (node) => {
+		for (const child of childElements(node)) {
+			const childName = getLocalName(child.name ?? "");
+			if (childName === "p") {
+				const text = collectText(child);
+				if (text.length > 0) lines.push(text);
+				continue;
+			}
+			if (childName === "tbl") {
+				if (depth >= MAX_NESTED_TABLE_DEPTH) continue;
+				for (const line of flattenNestedTable(child, depth + 1)) lines.push(line);
+				continue;
+			}
+			walk(child);
+		}
+	};
+	walk(cell);
+	return lines.join("\n");
+};
+const flattenNestedTable = (table, depth) => {
+	const lines = [];
+	for (const row of collectTableParts(table, "tr")) {
+		const cells = collectTableParts(row, "tc").map((cell) => readCellText(cell, depth));
+		if (cells.some((text) => text.length > 0)) lines.push(cells.join(NESTED_TABLE_CELL_SEPARATOR));
+	}
+	return lines;
+};
+const readTableCell = (cell, depth) => {
+	const properties = findChild(cell, "w", "tcPr");
+	const gridSpanValue = getAttributeAnyPrefix(findChild(properties, "w", "gridSpan"), "val");
+	const parsedGridSpan = gridSpanValue === null ? 1 : Number.parseInt(gridSpanValue, 10);
+	const gridSpan = Number.isFinite(parsedGridSpan) && parsedGridSpan > 1 ? parsedGridSpan : 1;
+	const vMerge = findChild(properties, "w", "vMerge");
+	if (vMerge !== null && getAttributeAnyPrefix(vMerge, "val") !== "restart") return {
+		text: "",
+		gridSpan
+	};
+	return {
+		text: readCellText(cell, depth),
+		gridSpan
+	};
+};
+/**
+* Does the row declare itself a header? `w:tblHeader` is the only OOXML signal
+* that says so: it marks the row Word repeats at the top of each page. The
+* neighbouring `w:tblLook/@w:firstRow` is conditional *formatting* that Word
+* writes on essentially every table (its default `w:val="04A0"`), so keying off
+* it would promote the first data row of almost every document.
+*
+* Without the flag the table is headerless and GFM gets a synthetic empty header
+* row: a table's first row is data until the document says otherwise, and column
+* names invented here would be read back as facts about the document.
+*/
+const declaresHeaderRow = (row) => {
+	const header = findChild(findChild(row, "w", "trPr"), "w", "tblHeader");
+	if (header === null) return false;
+	const value = getAttributeAnyPrefix(header, "val");
+	return value !== "0" && value !== "false";
+};
+const readTableGrid = (table) => {
+	const rows = [];
+	let columnCount = 0;
+	let firstRowIsHeader = false;
+	for (const [rowIndex, row] of collectTableParts(table, "tr").entries()) {
+		if (rowIndex === 0) firstRowIsHeader = declaresHeaderRow(row);
+		const columns = [];
+		for (const cell of collectTableParts(row, "tc")) {
+			if (columns.length >= MAX_TABLE_COLUMNS) break;
+			const { text, gridSpan } = readTableCell(cell, 0);
+			columns.push(text);
+			const padding = Math.min(gridSpan - 1, MAX_TABLE_COLUMNS - columns.length);
+			for (let index = 0; index < padding; index++) columns.push("");
+		}
+		if (columns.length > columnCount) columnCount = columns.length;
+		rows.push(columns);
+	}
+	return {
+		rows,
+		columnCount,
+		firstRowIsHeader
+	};
+};
+/** Pad a row to the table's column count and escape each cell into a pipe row. */
+const toRowLine = (columns, columnCount) => {
+	const cells = [];
+	for (let column = 0; column < columnCount; column++) cells.push(escapeTableCell(columns[column] ?? ""));
+	return `| ${cells.join(" | ")} |`;
+};
+/** Render a `w:tbl` as GFM rows. A table with no cell at all renders nothing. */
+const renderTableRows = (table, tableIndex) => {
+	const { rows, columnCount, firstRowIsHeader } = readTableGrid(table);
+	const [firstRow, ...remainingRows] = rows;
+	if (columnCount === 0 || firstRow === void 0) return [];
+	const rendered = [];
+	const push = (text, kind) => {
+		rendered.push({
+			text,
+			position: {
+				table: tableIndex,
+				kind
+			}
+		});
+	};
+	if (firstRowIsHeader) push(toRowLine(firstRow, columnCount), "cells");
+	else push(toRowLine([], columnCount), "syntheticHeader");
+	push(toRowLine(Array.from({ length: columnCount }, () => TABLE_DELIMITER_CELL), columnCount), "delimiter");
+	for (const row of firstRowIsHeader ? remainingRows : rows) push(toRowLine(row, columnCount), "cells");
+	return rendered;
+};
+const extractContainer = ({ container, source, startIndex, startTableIndex }) => {
 	const paragraphs = [];
 	let charCount = 0;
-	for (const [offset, paragraph] of findAllDeep(container, "w", "p").entries()) {
+	let tableCount = 0;
+	const pushProse = (paragraph) => {
 		const text = collectText(paragraph);
 		const entry = {
-			index: startIndex + offset,
+			index: startIndex + paragraphs.length,
 			text,
 			source
 		};
@@ -81,15 +228,45 @@ const extractContainer = ({ container, source, startIndex }) => {
 		}
 		paragraphs.push(entry);
 		charCount += text.length;
-	}
+	};
+	const pushTableRow = ({ text, position }) => {
+		paragraphs.push({
+			index: startIndex + paragraphs.length,
+			text,
+			source,
+			tableRow: position
+		});
+		charCount += text.length;
+	};
+	/**
+	* Walk block content in document order. Descent mirrors the previous
+	* `findAllDeep(container, "w", "p")` — every wrapper (`w:sdt`, textboxes) is
+	* still entered — except that a `w:tbl` is consumed as a table instead of
+	* having its cell paragraphs emitted individually.
+	*/
+	const walkBlocks = (node) => {
+		for (const child of childElements(node)) {
+			const childName = getLocalName(child.name ?? "");
+			if (childName === "tbl") {
+				for (const row of renderTableRows(child, startTableIndex + tableCount)) pushTableRow(row);
+				tableCount += 1;
+				continue;
+			}
+			if (childName === "p") pushProse(child);
+			walkBlocks(child);
+		}
+	};
+	walkBlocks(container);
 	return {
 		paragraphs,
-		charCount
+		charCount,
+		tableCount
 	};
 };
-const extractParts = async ({ archive, source, rootName, startIndex, paths }) => {
+const extractParts = async ({ archive, source, rootName, startIndex, startTableIndex, paths }) => {
 	const paragraphs = [];
 	let charCount = 0;
+	let tableCount = 0;
 	let nextIndex = startIndex;
 	for (const path of paths) {
 		const xml = await archive.readEntryString(path);
@@ -99,15 +276,18 @@ const extractParts = async ({ archive, source, rootName, startIndex, paths }) =>
 		const result = extractContainer({
 			container,
 			source,
-			startIndex: nextIndex
+			startIndex: nextIndex,
+			startTableIndex: startTableIndex + tableCount
 		});
 		paragraphs.push(...result.paragraphs);
 		charCount += result.charCount;
+		tableCount += result.tableCount;
 		nextIndex += result.paragraphs.length;
 	}
 	return {
 		paragraphs,
-		charCount
+		charCount,
+		tableCount
 	};
 };
 /** A `word/_rels/document.xml.rels` `Target` is relative to `word/`; resolve it to a full archive-entry path. */
@@ -173,18 +353,21 @@ const extractDocxText = async (bytes) => {
 		source: "header",
 		rootName: "hdr",
 		startIndex: 0,
+		startTableIndex: 0,
 		paths: referencedParts.headers
 	});
 	const bodyResult = extractContainer({
 		container: body,
 		source: "body",
-		startIndex: headers.paragraphs.length
+		startIndex: headers.paragraphs.length,
+		startTableIndex: headers.tableCount
 	});
 	const footers = await extractParts({
 		archive,
 		source: "footer",
 		rootName: "ftr",
 		startIndex: headers.paragraphs.length + bodyResult.paragraphs.length,
+		startTableIndex: headers.tableCount + bodyResult.tableCount,
 		paths: referencedParts.footers
 	});
 	return {

package/dist/server.d.ts

@@ -18,8 +18,8 @@ import { EvaluateDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULT
 import { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FolioDocxConformanceCheck, FolioDocxConformanceCheckId, FolioDocxConformanceCheckStatus, FolioDocxConformanceIssue, FolioDocxConformanceIssueCode, FolioDocxConformanceReport, FolioDocxConformanceStatus, ValidateDocxConformanceOptions, validateDocxConformance } from "./docx/server/validateDocxConformance.js";
 import { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal } from "./docx/server/applyDocxXmlPatchProposal.js";
 import { docxToMarkdown } from "./docx/server/docxToMarkdown.js";
-import { DocxParagraphSource, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText } from "./docx/server/extractDocxText.js";
+import { DocxParagraphSource, DocxTableRowKind, DocxTableRowPosition, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText } from "./docx/server/extractDocxText.js";
 import { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxInspectedXmlPart, FolioDocxPackageInspection, FolioDocxPackageInspectionError, FolioDocxPackageInspectionErrorCode, FolioDocxPackageInspectionLimits, FolioDocxPackagePart, FolioDocxPackagePartKind, InspectDocxPackageOptions, inspectDocxPackage } from "./docx/server/inspectDocxPackage.js";
 import { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx } from "./redline.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioBlockDiff, FolioCompareDocxVersionsOptions, FolioDocumentMetadataValue, FolioFormatProperty, FolioMetadataDiff, FolioStoryDiff, FolioVersionBlockHandle, FolioVersionComparisonPrivacyTransform, FolioVersionComparisonScope, FolioVersionDiff, FolioVersionDiffPrivacyOptions, FolioVersionDiffPrivacyReport, FolioVersionDiffSegment, FolioVersionDiffSummaryCounts, InvalidFolioVersionComparisonOptionsError, applyFolioVersionDiffPrivacy, compareDocxVersions, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope } from "./version-comparison.js";
-export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, DocxArchiveError, type DocxArchiveOptions, type DocxParagraphSource, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, type ExtractedDocxText, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioDocxConformanceCheck, type FolioDocxConformanceCheckId, type FolioDocxConformanceCheckStatus, type FolioDocxConformanceIssue, type FolioDocxConformanceIssueCode, type FolioDocxConformanceReport, type FolioDocxConformanceStatus, type FolioDocxInspectedXmlPart, type FolioDocxPackageInspection, FolioDocxPackageInspectionError, type FolioDocxPackageInspectionErrorCode, type FolioDocxPackageInspectionLimits, type FolioDocxPackagePart, type FolioDocxPackagePartKind, type FolioDocxPreparedXmlReplacement, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, type FolioDocxXmlPatchApplicationReceipt, type FolioDocxXmlPatchProposal, type FolioDocxXmlPatchProposalEvaluation, type FolioDocxXmlPatchProposalIssue, type FolioDocxXmlPatchProposalIssueCode, type FolioDocxXmlPatchProposalLimits, type FolioDocxXmlReplacement, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, type InspectDocxPackageOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, docxToMarkdown, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };
+export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, DocxArchiveError, type DocxArchiveOptions, type DocxParagraphSource, type DocxTableRowKind, type DocxTableRowPosition, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, type ExtractedDocxText, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioDocxConformanceCheck, type FolioDocxConformanceCheckId, type FolioDocxConformanceCheckStatus, type FolioDocxConformanceIssue, type FolioDocxConformanceIssueCode, type FolioDocxConformanceReport, type FolioDocxConformanceStatus, type FolioDocxInspectedXmlPart, type FolioDocxPackageInspection, FolioDocxPackageInspectionError, type FolioDocxPackageInspectionErrorCode, type FolioDocxPackageInspectionLimits, type FolioDocxPackagePart, type FolioDocxPackagePartKind, type FolioDocxPreparedXmlReplacement, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, type FolioDocxXmlPatchApplicationReceipt, type FolioDocxXmlPatchProposal, type FolioDocxXmlPatchProposalEvaluation, type FolioDocxXmlPatchProposalIssue, type FolioDocxXmlPatchProposalIssueCode, type FolioDocxXmlPatchProposalLimits, type FolioDocxXmlReplacement, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, type InspectDocxPackageOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, docxToMarkdown, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.15.13",
+  "version": "0.16.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -112,7 +112,7 @@
     "@stll/template-conditions": "^0.1.0",
     "better-result": "2.10.0",
     "csstype": "^3.1.3",
-    "dompurify": "^3.4.12",
+    "dompurify": "^3.4.13",
     "fast-xml-parser": "^5.9.3",
     "hyphen": "1.14.1",
     "jszip": "3.10.1",