@stll/folio-core 0.40.0 → 0.41.0

package/dist/ai-edits/clean-text.d.ts

@@ -44,6 +44,18 @@ type CleanTextStructuralBoundary = {
   clear?: PageBreakRunAttrs["clear"];
   /** Whether the post-tracked-changes projection retains this carrier. */
   presentInCleanView: boolean;
+} | {
+  /**
+   * A field result: several clean-text characters over a single PM
+   * position. Only the whole span is addressable, so a text range may
+   * start or end at its edges but never inside it.
+   */
+  type: "field";
+  offset: number;
+  /** Characters the result contributes; always greater than one. */
+  length: number;
+  from: number;
+  to: number;
 };
 type ResolveCleanTextRangeOptions = {
   cleanBlock: CleanBlockText;
@@ -51,17 +63,27 @@ type ResolveCleanTextRangeOptions = {
   endOffset: number;
 };
 /**
- * Resolve clean-text offsets without selecting a zero-width structural atom.
+ * Resolve clean-text offsets without selecting a structural atom.
  *
- * A range wholly on one side of a boundary is biased away from the atom. A
- * range spanning both sides is unrepresentable as a generic text selection
- * and returns `null`; a structural operation must own that mutation instead.
+ * A range wholly on one side of a zero-width boundary is biased away from the
+ * atom. A range spanning both sides, or cutting into a field result, is
+ * unrepresentable as a generic text selection and returns `null`; a structural
+ * operation must own that mutation instead.
  */
 declare const resolveCleanTextRange: ({ cleanBlock, startOffset, endOffset }: ResolveCleanTextRangeOptions) => {
   from: number;
   to: number;
 } | null;
-declare const buildCleanBlockText: (blockNode: Node, blockFrom: number) => CleanBlockText;
+type BuildCleanBlockTextOptions = {
+  /**
+   * `"text"` reads a field as the result Word shows, which is the view a reader
+   * and the AI reason against. `"omitted"` drops it, which is what an alignment
+   * coordinate needs: an atom present on only one side must not shift the
+   * offsets that locate it.
+   */
+  fieldResults: "text" | "omitted";
+};
+declare const buildCleanBlockText: (blockNode: Node, blockFrom: number, { fieldResults }?: BuildCleanBlockTextOptions) => CleanBlockText;
 /**
  * A "redline-aware" view of a textblock: the same left-to-right traversal as
  * {@link buildCleanBlockText}, but every tracked change and comment anchor is
@@ -83,4 +105,4 @@ declare const buildCleanBlockText: (blockNode: Node, blockFrom: number) => Clean
  */
 declare const buildAnnotatedBlockText: (blockNode: Node) => string;
 //#endregion
-export { CleanBlockText, CleanTextStructuralBoundary, buildAnnotatedBlockText, buildCleanBlockText, resolveCleanTextRange };
+export { BuildCleanBlockTextOptions, CleanBlockText, CleanTextStructuralBoundary, buildAnnotatedBlockText, buildCleanBlockText, resolveCleanTextRange };

package/dist/ai-edits/clean-text.js

@@ -1,13 +1,15 @@
 import { expectPageBreakRunAttrs } from "../prosemirror/attrs/index.js";
-import { runFormattingInlineControlCharacter } from "../prosemirror/runFormattingInlineCarriers.js";
+import { runFormattingInlineAtomCleanText, runFormattingInlineControlCharacter } from "../prosemirror/runFormattingInlineCarriers.js";
 //#region src/ai-edits/clean-text.ts
 const EMPTY_CLEAN_TEXT_STRUCTURAL_BOUNDARIES = Object.freeze([]);
+const cutsIntoSpan = ({ offset, length }, boundaryOffset) => boundaryOffset > offset && boundaryOffset < offset + length;
 /**
-* Resolve clean-text offsets without selecting a zero-width structural atom.
+* Resolve clean-text offsets without selecting a structural atom.
 *
-* A range wholly on one side of a boundary is biased away from the atom. A
-* range spanning both sides is unrepresentable as a generic text selection
-* and returns `null`; a structural operation must own that mutation instead.
+* A range wholly on one side of a zero-width boundary is biased away from the
+* atom. A range spanning both sides, or cutting into a field result, is
+* unrepresentable as a generic text selection and returns `null`; a structural
+* operation must own that mutation instead.
 */
 const resolveCleanTextRange = ({ cleanBlock, startOffset, endOffset }) => {
 	if (!Number.isInteger(startOffset) || !Number.isInteger(endOffset) || startOffset < 0 || endOffset < startOffset || endOffset > cleanBlock.text.length) return null;
@@ -22,6 +24,10 @@ const resolveCleanTextRange = ({ cleanBlock, startOffset, endOffset }) => {
 	let from = baseFrom;
 	let to = baseTo;
 	for (const boundary of structuralBoundaries) {
+		if (boundary.type === "field") {
+			if (cutsIntoSpan(boundary, startOffset) || cutsIntoSpan(boundary, endOffset)) return null;
+			continue;
+		}
 		if (boundary.offset > startOffset && boundary.offset < endOffset) return null;
 		if (boundary.offset === startOffset) from = Math.max(from, boundary.to);
 		if (startOffset !== endOffset && boundary.offset === endOffset) to = Math.min(to, boundary.from);
@@ -40,7 +46,8 @@ const INSERTION_MARK = "insertion";
 const COMMENT_MARK = "comment";
 const HIDDEN_MARK = "hidden";
 const isOmittedFromCleanView = (node) => node.marks.some((mark) => mark.type.name === DELETION_MARK || mark.type.name === HIDDEN_MARK);
-const buildCleanBlockText = (blockNode, blockFrom) => {
+const DEFAULT_BUILD_CLEAN_BLOCK_TEXT_OPTIONS = { fieldResults: "text" };
+const buildCleanBlockText = (blockNode, blockFrom, { fieldResults } = DEFAULT_BUILD_CLEAN_BLOCK_TEXT_OPTIONS) => {
 	let text = "";
 	const offsets = [];
 	let structuralBoundaries;
@@ -59,12 +66,19 @@ const buildCleanBlockText = (blockNode, blockFrom) => {
 			});
 			return false;
 		}
-		const controlCharacter = runFormattingInlineControlCharacter(node);
-		if (controlCharacter !== null) {
+		const atomText = fieldResults === "omitted" ? runFormattingInlineControlCharacter(node) : runFormattingInlineAtomCleanText(node);
+		if (atomText !== null) {
 			if (isOmittedFromCleanView(node)) return false;
 			const startPos = blockFrom + 1 + pos;
-			offsets.push(startPos);
-			text += controlCharacter;
+			if (atomText.length > 1) (structuralBoundaries ??= []).push({
+				type: "field",
+				offset: text.length,
+				length: atomText.length,
+				from: startPos,
+				to: startPos + node.nodeSize
+			});
+			for (let index = 0; index < atomText.length; index++) offsets.push(startPos);
+			text += atomText;
 			lastEnd = startPos + node.nodeSize;
 			return false;
 		}
@@ -105,16 +119,17 @@ const buildCleanBlockText = (blockNode, blockFrom) => {
 const buildAnnotatedBlockText = (blockNode) => {
 	const segments = [];
 	blockNode.descendants((node) => {
-		if (!node.isText || node.text === void 0) return true;
+		const text = node.isText ? node.text : runFormattingInlineAtomCleanText(node);
+		if (text === void 0 || text === null) return true;
 		const annotation = annotationOf(node.marks);
 		const previous = segments.at(-1);
 		if (previous && sameAnnotation(previous.annotation, annotation)) {
-			previous.text += node.text;
+			previous.text += text;
 			return false;
 		}
 		segments.push({
 			annotation,
-			text: node.text
+			text
 		});
 		return false;
 	});

package/dist/ai-edits/headless.d.ts

@@ -514,6 +514,18 @@ declare class FolioDocxReviewer {
   private createComparisonHeaderFooter;
   private canImportHeaderFooterContent;
   private getNoteStory;
+  /**
+   * A loaded story's blocks, so its text comes from the same walk an unloaded
+   * one uses.
+   *
+   * The two used to be separate walks and disagreed: the model walk separates
+   * paragraphs, joins table cells with a tab and reads the accepted
+   * tracked-change view, while the editor walk concatenated text nodes and saw
+   * none of that. The same note therefore read one way before it was loaded and
+   * another after. This is the conversion the save path already performs on the
+   * same states, so the text now describes exactly what a save would write.
+   */
+  private storyBlocks;
   private getHeaderFooterStoryText;
   private getNoteStoryText;
   private getStoryText;

package/dist/ai-edits/headless.js

@@ -1530,14 +1530,37 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		if (story.type === "footnote") return this.baseDocument.package.footnotes?.find((note) => note.id === story.noteId && !isSeparatorFootnote(note));
 		return this.baseDocument.package.endnotes?.find((note) => note.id === story.noteId && !isSeparatorEndnote(note));
 	}
+	/**
+	* A loaded story's blocks, so its text comes from the same walk an unloaded
+	* one uses.
+	*
+	* The two used to be separate walks and disagreed: the model walk separates
+	* paragraphs, joins table cells with a tab and reads the accepted
+	* tracked-change view, while the editor walk concatenated text nodes and saw
+	* none of that. The same note therefore read one way before it was loaded and
+	* another after. This is the conversion the save path already performs on the
+	* same states, so the text now describes exactly what a save would write.
+	*/
+	storyBlocks(state, source) {
+		return state ? proseDocToBlocks(state.doc, source.content, this.baseDocument.package.styles, { emptyFieldResult: "authored" }) : source.content;
+	}
 	getHeaderFooterStoryText(story, source) {
 		const state = this.secondaryStoryStates.get(headerFooterStoryKey(story))?.state;
-		return normalizeFolioAIBlockText(state?.doc.textContent ?? getHeaderFooterText(source));
+		return normalizeFolioAIBlockText(getHeaderFooterText({
+			...source,
+			content: this.storyBlocks(state, source)
+		}));
 	}
 	getNoteStoryText(story, source) {
 		const state = this.secondaryStoryStates.get(noteStoryKey(story))?.state;
-		const sourceText = source.type === "footnote" ? getFootnoteText(source) : getEndnoteText(source);
-		return normalizeFolioAIBlockText(state?.doc.textContent ?? sourceText);
+		const content = this.storyBlocks(state, source);
+		return normalizeFolioAIBlockText(source.type === "footnote" ? getFootnoteText({
+			...source,
+			content
+		}) : getEndnoteText({
+			...source,
+			content
+		}));
 	}
 	getStoryText(story) {
 		if (story.type === "main") return this.getContentAsText();

package/dist/ai-edits/snapshot.d.ts

@@ -66,7 +66,12 @@ declare const isFolioAIContentBlock: ({ text }: Pick<FolioAIBlock, "text">) => b
  */
 declare const trailingBodyBlockId: ({ blocks }: FolioAIEditSnapshot) => string | null;
 declare const hashFolioAIBlockText: (text: string) => string;
-/** Canonical public projection of the clean view's zero-width structure. */
+/**
+ * Canonical public projection of the clean view's zero-width structure.
+ *
+ * A field boundary stays internal: it marks text the reader already sees, so it
+ * belongs to range resolution rather than to a block's published structure.
+ */
 declare const projectFolioAIBlockStructuralBoundaries: ({ structuralBoundaries }: Pick<CleanBlockText, "structuralBoundaries">) => readonly FolioAIBlockStructuralBoundary[];
 /** Stable precondition fingerprint for a block's zero-width structure. */
 declare const hashFolioAIBlockStructuralBoundaries: (cleanBlock: Pick<CleanBlockText, "structuralBoundaries">) => string;

package/dist/ai-edits/snapshot.js

@@ -4,7 +4,7 @@ import { marksToTextFormatting } from "../prosemirror/conversion/fromProseDoc.js
 import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { directParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
 import { directParagraphSpacing } from "../prosemirror/paragraphSpacing.js";
-import { runFormattingInlineControlCharacter } from "../prosemirror/runFormattingInlineCarriers.js";
+import { runFormattingInlineAtomCleanText } from "../prosemirror/runFormattingInlineCarriers.js";
 import { authoredRunFormattingFromAttrs } from "../prosemirror/runFormattingProvenance.js";
 import { readAuthoredRunFormatting, reconcileRunFormattingMarks } from "../prosemirror/runFormattingReconciliation.js";
 import { paragraphRunStyleContext } from "../prosemirror/runStyleFormatting.js";
@@ -231,15 +231,20 @@ const hashFolioAIBlockText = (text) => {
 };
 const EMPTY_FOLIO_AI_BLOCK_STRUCTURAL_BOUNDARIES = Object.freeze([]);
 const EMPTY_FOLIO_AI_BLOCK_STRUCTURAL_BOUNDARY_HASH = hashFolioAIBlockText(JSON.stringify(EMPTY_FOLIO_AI_BLOCK_STRUCTURAL_BOUNDARIES));
-/** Canonical public projection of the clean view's zero-width structure. */
+/**
+* Canonical public projection of the clean view's zero-width structure.
+*
+* A field boundary stays internal: it marks text the reader already sees, so it
+* belongs to range resolution rather than to a block's published structure.
+*/
 const projectFolioAIBlockStructuralBoundaries = ({ structuralBoundaries }) => {
 	let projected;
-	for (const { clear, offset, presentInCleanView } of structuralBoundaries) {
-		if (!presentInCleanView) continue;
+	for (const boundary of structuralBoundaries) {
+		if (boundary.type !== "pageBreakRun" || !boundary.presentInCleanView) continue;
 		(projected ??= []).push({
 			type: "pageBreak",
-			offset,
-			...clear !== void 0 ? { clear } : {}
+			offset: boundary.offset,
+			...boundary.clear !== void 0 ? { clear: boundary.clear } : {}
 		});
 	}
 	return projected ?? EMPTY_FOLIO_AI_BLOCK_STRUCTURAL_BOUNDARIES;
@@ -531,13 +536,13 @@ const getPreviewRuns = ({ node, nodeFrom, cleanBlock, styleResolver }) => {
 	let paragraphStyleContext;
 	let cleanOffset = 0;
 	node.descendants((child, relativePosition) => {
-		const text = child.isText ? child.text : runFormattingInlineControlCharacter(child);
-		if (text === void 0 || text === null) return true;
+		const text = child.isText ? child.text : runFormattingInlineAtomCleanText(child);
+		if (text === void 0 || text === null || text.length === 0) return true;
 		if (child.marks.some((mark) => mark.type.name === DELETION_MARK || mark.type.name === HIDDEN_MARK)) return false;
 		const start = nodeFrom + 1 + relativePosition;
 		while ((cleanBlock.offsets[cleanOffset] ?? Number.POSITIVE_INFINITY) < start) cleanOffset++;
-		const endOffset = cleanOffset + text.length - 1;
-		if (cleanBlock.offsets[cleanOffset] !== start || cleanBlock.offsets[endOffset] !== start + text.length - 1) return false;
+		const lastCharacterPosition = child.isText ? start + text.length - 1 : start;
+		if (cleanBlock.offsets[cleanOffset] !== start || cleanBlock.offsets[cleanOffset + text.length - 1] !== lastCharacterPosition) return false;
 		cleanOffset += text.length;
 		const style = getPreviewRunStyle(child.marks, defaultStyle);
 		const hasAuthorshipCarrier = child.marks.some(({ type }) => type.name === RUN_FORMATTING_OVERRIDE_MARK || type.name === CHARACTER_STYLE_MARK);

package/dist/ai-suggestions/text-positions.js

@@ -1,3 +1,4 @@
+import { runFormattingInlineAtomResultText } from "../prosemirror/runFormattingInlineCarriers.js";
 //#region src/ai-suggestions/text-positions.ts
 const BLOCK_SEPARATOR = "\n";
 /**
@@ -15,11 +16,22 @@ function buildPositionalText(doc, from = 0, to = doc.content.size) {
 		if (node.type.name === "pageBreakRun") {
 			structuralBoundaries.push({
 				textOffset: textLength,
-				from: pos,
-				to: pos + node.nodeSize
+				length: 0
 			});
 			return false;
 		}
+		const resultText = runFormattingInlineAtomResultText(node);
+		if (resultText !== null) {
+			if (resultText.length === 0 || pos < from || pos + node.nodeSize > to) return false;
+			structuralBoundaries.push({
+				textOffset: textLength,
+				length: resultText.length
+			});
+			chunks.push(resultText);
+			for (let index = 0; index < resultText.length; index++) offsets.push(pos);
+			textLength += resultText.length;
+			return false;
+		}
 		if (node.isText) {
 			const text = node.text ?? "";
 			const startInNode = Math.max(from, pos);
@@ -54,7 +66,7 @@ function buildPositionalText(doc, from = 0, to = doc.content.size) {
 		text,
 		pmPositionAt,
 		pmRangeAt: (startTextIndex, endTextIndex) => {
-			if (!Number.isInteger(startTextIndex) || !Number.isInteger(endTextIndex) || startTextIndex < 0 || endTextIndex <= startTextIndex || endTextIndex > text.length || structuralBoundaries.some(({ textOffset }) => textOffset > startTextIndex && textOffset < endTextIndex)) return null;
+			if (!Number.isInteger(startTextIndex) || !Number.isInteger(endTextIndex) || startTextIndex < 0 || endTextIndex <= startTextIndex || endTextIndex > text.length || structuralBoundaries.some(({ textOffset, length }) => length === 0 ? textOffset > startTextIndex && textOffset < endTextIndex : startTextIndex > textOffset && startTextIndex < textOffset + length || endTextIndex > textOffset && endTextIndex < textOffset + length)) return null;
 			const rangeFrom = pmPositionAt(startTextIndex);
 			const finalCharacter = offsets[endTextIndex - 1];
 			if (finalCharacter === void 0) return null;

package/dist/compare/inline-atoms.js

@@ -46,7 +46,7 @@ const atomKey = (node) => canonicalJson({
 	content: node.content.toJSON()
 });
 const atomBlockOf = ({ node, from }) => {
-	const clean = buildCleanBlockText(node, from);
+	const clean = buildCleanBlockText(node, from, { fieldResults: "omitted" });
 	const supported = [];
 	const unsupportedTopology = [];
 	let unalignable = false;
@@ -237,7 +237,7 @@ const sameParagraphSourcePosition = ({ sourceBlocks, reviewed, offset }) => {
 	if (typeof paraId !== "string" || paraId.length === 0) return null;
 	const source = sourceBlocks.get(paraId);
 	if (!source || source.node.type !== reviewed.node.type) return null;
-	const clean = buildCleanBlockText(source.node, source.from);
+	const clean = buildCleanBlockText(source.node, source.from, { fieldResults: "omitted" });
 	return clean.text === reviewed.cleanText ? clean.offsets[offset] ?? null : null;
 };
 /**

package/dist/compat/eigenpal.d.ts

@@ -20,7 +20,8 @@ import { mergeDocumentContent } from "../utils/mergeDocumentContent.js";
 import { DocumentStyleCatalog, DocumentStyleCatalogEntry, ExtractDocumentStyleSetOptions, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "../style-sets/extract.js";
 import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "../style-sets/stellaStyle.js";
 import { createDocx } from "../docx/rezip.js";
-import { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility } from "../docx/compatibility.js";
+import { DRAWING_SAFETY_CLASSES, DrawingSafetyClass } from "../docx/imageRawXml.js";
+import { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, DocxDrawingClassification, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility } from "../docx/compatibility.js";
 import { BlockRect } from "../paged-layout/blockGeometry.js";
 import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
 import { scrollFolioPositionIntoView } from "../paged-layout/scrollToPmPosition.js";
@@ -39,4 +40,4 @@ import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled
 import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type DocxDrawingClassification, type DrawingSafetyClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/compat/eigenpal.js

@@ -11,6 +11,7 @@ import { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareDocxApply
 import { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS } from "../compare/verification.js";
 import { 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { inspectDocxCompatibility } from "../docx/compatibility.js";
+import { DRAWING_SAFETY_CLASSES } from "../docx/imageRawXml.js";
 import { createDocx } from "../docx/rezip.js";
 import { buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "../fonts/embeddedFonts.js";
 import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
@@ -32,4 +33,4 @@ import { currentFolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioB
 import { createEmptyDocument } from "../utils/createDocument.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 import { mergeDocumentContent } from "../utils/mergeDocumentContent.js";
-export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioContentComparisonLimitError, FolioContentInlinePresentationProjectionError, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, FOLIO_CONTENT_COMPARISON_LIMITS, 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_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioContentComparisonLimitError, FolioContentInlinePresentationProjectionError, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

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

@@ -2,6 +2,7 @@ import { DisplayColor, DisplayGlyphRun, DisplayHitRegion, DisplayPrimitive } fro
 import { hasCursiveLetter, joinsAcrossBoundary } from "../utils/cursiveJoining.js";
 import { hasComplexScript, isComplexScriptCodePoint } from "../utils/scriptSegments.js";
 //#region src/display-list/primitives.d.ts
+type PrimitiveKind = DisplayPrimitive["kind"];
 /**
  * Left edge of every code point of a run, as an offset from the run's `xPx`.
  *
@@ -15,7 +16,7 @@ import { hasComplexScript, isComplexScriptCodePoint } from "../utils/scriptSegme
  * advances rightward from its origin whatever the paragraph does.
  */
 declare const glyphCellOffsetsPx: (run: DisplayGlyphRun) => readonly number[];
-declare const DISPLAY_PRIMITIVE_KINDS: ("glyphRun" | "rect" | "line" | "image" | "clipGroup" | "rotateGroup" | "opacityGroup")[];
+declare const DISPLAY_PRIMITIVE_KINDS: readonly PrimitiveKind[];
 /**
  * Dash geometry of each stroke pattern, as multiples of the stroke thickness.
  *

package/dist/document-operations.d.ts

@@ -1,12 +1,13 @@
+import { document_d_exports } from "./types/document.js";
 import { FolioTableTemplates } from "./ai-edits/table-template.js";
 import { FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditNormalization, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./ai-edits/types.js";
 import { FolioAIEditView, FolioRevisionStamp, FolioWordDiffOptions } from "./ai-edits/apply.js";
 //#region src/document-operations.d.ts
 declare const FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION: 1;
 /** Direct paragraph-alignment values accepted by the operation contract. */
-declare const FOLIO_PARAGRAPH_ALIGNMENT_VALUES: readonly ("left" | "center" | "right" | "both" | "distribute" | "mediumKashida" | "highKashida" | "lowKashida" | "thaiDistribute")[];
+declare const FOLIO_PARAGRAPH_ALIGNMENT_VALUES: readonly document_d_exports.ParagraphAlignment[];
 /** `w:spacing/@w:lineRule` values accepted by the operation contract. */
-declare const FOLIO_LINE_SPACING_RULE_VALUES: readonly ("auto" | "exact" | "atLeast")[];
+declare const FOLIO_LINE_SPACING_RULE_VALUES: readonly document_d_exports.LineSpacingRule[];
 /** `w:br/@w:clear` values accepted on an authored hard page break. */
 declare const FOLIO_PAGE_BREAK_CLEAR_VALUES: readonly ["none", "left", "right", "all"];
 declare const FOLIO_DOCUMENT_OPERATION_TYPES: readonly ["replaceInBlock", "replaceRange", "commentOnRange", "formatRange", "insertAfterBlock", "insertBeforeBlock", "replaceBlock", "deleteBlock", "splitBlock", "mergeBlockWithNext", "setBlockParagraphProperties", "insertTable", "deleteTable", "commentOnBlock", "insertSignatureTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "mergeTableCells", "splitTableCell"];

package/dist/docx/blockPlainText.d.ts

@@ -0,0 +1,8 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/blockPlainText.d.ts
+type PlainTextBlock = document_d_exports.Paragraph | document_d_exports.Table | document_d_exports.BlockSdt;
+/** One entry per block, so callers can join or count lines as they need. */
+declare const collectBlockTexts: (blocks: readonly PlainTextBlock[]) => string[];
+declare const blockPlainText: (blocks: readonly PlainTextBlock[]) => string;
+//#endregion
+export { PlainTextBlock, blockPlainText, collectBlockTexts };

package/dist/docx/blockPlainText.js

@@ -0,0 +1,40 @@
+import { getParagraphText } from "./paragraphParser.js";
+import { panic } from "better-result";
+//#region src/docx/blockPlainText.ts
+/**
+* The one plain-text projection of a block sequence.
+*
+* Every story — body, header, footer, footnote, endnote — reads through here,
+* so a reader, a hash and a comparison all see the same string for the same
+* content. Header and footer text used to come from a separate walk that
+* handled only text runs, silently dropping fields, hyperlinks, tabs, breaks
+* and tracked changes, so the same paragraph read one way in a note and another
+* in a header.
+*
+* Separators carry the structure a reader needs: paragraphs and table rows are
+* newline-separated, cells within a row tab-separated. `getParagraphText` owns
+* everything below block level and reads the accepted tracked-change view.
+*/
+/** One entry per block, so callers can join or count lines as they need. */
+const collectBlockTexts = (blocks) => {
+	const texts = [];
+	for (const block of blocks) switch (block.type) {
+		case "paragraph":
+			texts.push(getParagraphText(block));
+			break;
+		case "table":
+			for (const row of block.rows) {
+				if (row.formatting?.hidden === true) continue;
+				texts.push(row.cells.map((cell) => collectBlockTexts(cell.content).join("\n")).join("	"));
+			}
+			break;
+		case "blockSdt":
+			texts.push(...collectBlockTexts(block.content));
+			break;
+		default: panic(`Unsupported block in plain-text extraction: ${JSON.stringify(block)}`);
+	}
+	return texts;
+};
+const blockPlainText = (blocks) => collectBlockTexts(blocks).join("\n");
+//#endregion
+export { blockPlainText, collectBlockTexts };

package/dist/docx/compatibility.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../types/document.js";
+import { DrawingSafetyClass } from "./imageRawXml.js";
 //#region src/docx/compatibility.d.ts
 type DocxCompatibilityReason = "opaqueDrawing";
 type FolioDocxCompatibilityHost = "browser" | "server" | "unknown";
@@ -26,14 +27,27 @@ type DocxCompatibilityIssue = {
   code: DocxCompatibilityReason;
   location: DocxCompatibilityLocation;
 };
+/** A drawing and the fate the run serializer holds for it. */
+type DocxDrawingClassification = {
+  class: DrawingSafetyClass;
+  location: DocxCompatibilityLocation;
+};
+/**
+ * Schema 2 replaced the per-drawing boolean judgement with
+ * {@link DocxDrawingClassification} and stopped reporting a replayable drawing
+ * as an issue; `issues` now holds opaque drawings only.
+ */
 type DocxCompatibility = {
-  schemaVersion: 1;
+  schemaVersion: 2;
   context: DocxCompatibilityContext;
   canSafelyEdit: boolean;
+  /** Every drawing the walk reached, classified. */
+  drawings: DocxDrawingClassification[];
+  /** The blocking subset: drawings a save can neither replay nor regenerate. */
   issues: DocxCompatibilityIssue[];
   reasons: DocxCompatibilityReason[];
   unsupportedContentCount: number;
 };
 declare const inspectDocxCompatibility: (doc: document_d_exports.Document, options?: InspectDocxCompatibilityOptions) => DocxCompatibility;
 //#endregion
-export { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, DocxCompatibilityReason, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility };
+export { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, DocxCompatibilityReason, DocxDrawingClassification, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility };

package/dist/docx/compatibility.js

@@ -1,5 +1,16 @@
-import { DOCX_CONFORMANCE_CLASSES, DRAWING_RAW_XML_MODES } from "@stll/docx-core/model";
+import { DRAWING_SAFETY_CLASSES, classifyDrawingSafety } from "./imageRawXml.js";
+import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 //#region src/docx/compatibility.ts
+/**
+* Whether a parsed package can be edited without losing content on save.
+*
+* Every part walked here is re-serialized from the model at some point: the
+* repack always rebuilds `word/document.xml`, headers and footers replay their
+* captured bytes only while their content fingerprint is unchanged, and note
+* parts are preserved except for edited paragraphs spliced back by `w:paraId`.
+* So an opaque drawing anywhere in this walk is a real risk, while a drawing the
+* serializer replays verbatim is not, whichever part holds it.
+*/
 const resolveCompatibilityContext = (doc, options) => ({
 	host: options.host ?? "unknown",
 	profile: options.profile ?? doc.package.conformanceClass ?? DOCX_CONFORMANCE_CLASSES.UNKNOWN
@@ -7,13 +18,16 @@ const resolveCompatibilityContext = (doc, options) => ({
 const inspectDocxCompatibility = (doc, options = {}) => {
 	const context = resolveCompatibilityContext(doc, options);
 	const reasons = /* @__PURE__ */ new Set();
+	const drawings = [];
 	const issues = [];
-	const record = (location) => {
+	const record = (drawing) => {
+		drawings.push(drawing);
+		if (drawing.class !== DRAWING_SAFETY_CLASSES.OPAQUE) return;
 		const code = "opaqueDrawing";
 		reasons.add(code);
 		issues.push({
 			code,
-			location
+			location: drawing.location
 		});
 	};
 	inspectBlocks(doc.package.document.content, {
@@ -54,9 +68,10 @@ const inspectDocxCompatibility = (doc, options = {}) => {
 		record
 	});
 	return {
-		schemaVersion: 1,
+		schemaVersion: 2,
 		context,
 		canSafelyEdit: issues.length === 0,
+		drawings,
 		issues,
 		reasons: Array.from(reasons),
 		unsupportedContentCount: issues.length
@@ -146,11 +161,17 @@ function inspectHyperlink(hyperlink, context) {
 	});
 }
 function inspectRun(run, context) {
-	for (const [contentIndex, content] of run.content.entries()) if (content.type === "drawing" && content.rawXml && content.rawXmlMode !== DRAWING_RAW_XML_MODES.PRESERVE_ONLY) context.record({
-		...context.blockId === void 0 ? {} : { blockId: context.blockId },
-		part: context.part,
-		path: `${context.path}.content[${contentIndex}]`
-	});
+	for (const [contentIndex, content] of run.content.entries()) {
+		if (content.type !== "drawing") continue;
+		context.record({
+			class: classifyDrawingSafety(content),
+			location: {
+				...context.blockId === void 0 ? {} : { blockId: context.blockId },
+				part: context.part,
+				path: `${context.path}.content[${contentIndex}]`
+			}
+		});
+	}
 }
 //#endregion
 export { inspectDocxCompatibility };