@stll/folio-core 0.39.1 → 0.41.0

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"];
@@ -95,27 +96,27 @@ type FolioDocumentOperationBatch = {
  * guessing, and so tool schemas can be derived from the contract.
  */
 declare const FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE: Readonly<{
-  readonly replaceInBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "find", "replace", "comment"];
-  readonly replaceRange: readonly ["id", "type", "range", "severity", "area", "precondition", "suggestionId", "replace", "comment"];
-  readonly commentOnRange: readonly ["id", "type", "range", "severity", "area", "precondition", "comment"];
-  readonly formatRange: readonly ["id", "type", "range", "severity", "area", "precondition", "suggestionId", "formatting"];
-  readonly insertAfterBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "inheritFormatting", "alignment", "spacing", "indentation", "lineBreakMode", "listLevel", "numbering", "moveId", "pageBreakBefore", "hardPageBreak", "styleId", "comment"];
-  readonly insertBeforeBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "inheritFormatting", "alignment", "spacing", "indentation", "lineBreakMode", "listLevel", "numbering", "moveId", "pageBreakBefore", "hardPageBreak", "styleId", "comment"];
-  readonly replaceBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "preserveFormatting", "styleId", "comment"];
-  readonly deleteBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "moveId", "comment"];
-  readonly splitBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "offset", "separator", "firstParagraphProperties", "secondParagraphProperties"];
-  readonly mergeBlockWithNext: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "separator", "mergedParagraphProperties"];
-  readonly setBlockParagraphProperties: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "properties"];
-  readonly insertTable: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "rows"];
-  readonly deleteTable: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
-  readonly commentOnBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "quote", "comment"];
-  readonly insertSignatureTable: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "parties", "comment"];
-  readonly insertTableRow: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "cellTexts"];
-  readonly deleteTableRow: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
-  readonly insertTableColumn: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "cellTexts"];
-  readonly deleteTableColumn: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
-  readonly mergeTableCells: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "endBlockId", "rowCount"];
-  readonly splitTableCell: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
+  readonly replaceInBlock: readonly string[];
+  readonly replaceRange: readonly string[];
+  readonly commentOnRange: readonly string[];
+  readonly formatRange: readonly string[];
+  readonly insertAfterBlock: readonly string[];
+  readonly insertBeforeBlock: readonly string[];
+  readonly replaceBlock: readonly string[];
+  readonly deleteBlock: readonly string[];
+  readonly splitBlock: readonly string[];
+  readonly mergeBlockWithNext: readonly string[];
+  readonly setBlockParagraphProperties: readonly string[];
+  readonly insertTable: readonly string[];
+  readonly deleteTable: readonly string[];
+  readonly commentOnBlock: readonly string[];
+  readonly insertSignatureTable: readonly string[];
+  readonly insertTableRow: readonly string[];
+  readonly deleteTableRow: readonly string[];
+  readonly insertTableColumn: readonly string[];
+  readonly deleteTableColumn: readonly string[];
+  readonly mergeTableCells: readonly string[];
+  readonly splitTableCell: readonly string[];
 }>;
 declare const parseFolioDocumentOperationBatch: (value: unknown) => FolioDocumentOperationBatch;
 /**

package/dist/document-operations.js

@@ -448,23 +448,145 @@ const readReviewMeta = (value, path) => {
 		...area !== void 0 && { area }
 	};
 };
-const COMMON_OPERATION_KEYS = [
-	"id",
-	"type",
-	"blockId",
-	"severity",
-	"area",
-	"precondition",
-	"suggestionId"
-];
-const RANGE_OPERATION_KEYS = [
-	"id",
-	"type",
-	"range",
-	"severity",
-	"area",
-	"precondition"
-];
+const COMMON_OPERATION_KEY_DECISIONS = {
+	id: true,
+	type: true,
+	blockId: true,
+	severity: true,
+	area: true,
+	precondition: true,
+	suggestionId: true
+};
+const RANGE_OPERATION_KEY_DECISIONS = {
+	id: true,
+	type: true,
+	range: true,
+	severity: true,
+	area: true,
+	precondition: true
+};
+const OPERATION_KEY_DECISIONS = {
+	replaceInBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		find: true,
+		replace: true,
+		comment: true
+	},
+	replaceRange: {
+		...RANGE_OPERATION_KEY_DECISIONS,
+		suggestionId: true,
+		replace: true,
+		comment: true
+	},
+	commentOnRange: {
+		...RANGE_OPERATION_KEY_DECISIONS,
+		suggestionId: false,
+		comment: true
+	},
+	formatRange: {
+		...RANGE_OPERATION_KEY_DECISIONS,
+		suggestionId: true,
+		formatting: true
+	},
+	insertAfterBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		text: true,
+		inheritFormatting: true,
+		alignment: true,
+		spacing: true,
+		indentation: true,
+		lineBreakMode: true,
+		formattingScope: true,
+		listLevel: true,
+		numbering: true,
+		moveId: true,
+		pageBreakBefore: true,
+		hardPageBreak: true,
+		styleId: true,
+		comment: true
+	},
+	insertBeforeBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		text: true,
+		inheritFormatting: true,
+		alignment: true,
+		spacing: true,
+		indentation: true,
+		lineBreakMode: true,
+		formattingScope: true,
+		listLevel: true,
+		numbering: true,
+		moveId: true,
+		pageBreakBefore: true,
+		hardPageBreak: true,
+		styleId: true,
+		comment: true
+	},
+	replaceBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		text: true,
+		preserveFormatting: true,
+		styleId: true,
+		comment: true
+	},
+	deleteBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		moveId: true,
+		comment: true
+	},
+	splitBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		offset: true,
+		separator: true,
+		firstParagraphProperties: true,
+		secondParagraphProperties: true
+	},
+	mergeBlockWithNext: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		separator: true,
+		mergedParagraphProperties: true
+	},
+	setBlockParagraphProperties: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		properties: true
+	},
+	insertTable: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		rows: true
+	},
+	deleteTable: COMMON_OPERATION_KEY_DECISIONS,
+	commentOnBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		quote: true,
+		comment: true
+	},
+	insertSignatureTable: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		parties: true,
+		comment: true
+	},
+	insertTableRow: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		cellTexts: true
+	},
+	deleteTableRow: COMMON_OPERATION_KEY_DECISIONS,
+	insertTableColumn: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		cellTexts: true
+	},
+	deleteTableColumn: COMMON_OPERATION_KEY_DECISIONS,
+	mergeTableCells: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		endBlockId: true,
+		rowCount: true
+	},
+	splitTableCell: COMMON_OPERATION_KEY_DECISIONS
+};
+const acceptedKeys = (decisions) => Object.keys(decisions).filter((key) => decisions[key] === true);
 /**
 * Every property each operation type accepts on the wire; the parser
 * rejects any other key. Exported so a lenient front door (an LLM tool
@@ -472,116 +594,27 @@ const RANGE_OPERATION_KEYS = [
 * guessing, and so tool schemas can be derived from the contract.
 */
 const FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE = Object.freeze({
-	replaceInBlock: [
-		...COMMON_OPERATION_KEYS,
-		"find",
-		"replace",
-		"comment"
-	],
-	replaceRange: [
-		...RANGE_OPERATION_KEYS,
-		"suggestionId",
-		"replace",
-		"comment"
-	],
-	commentOnRange: [...RANGE_OPERATION_KEYS, "comment"],
-	formatRange: [
-		...RANGE_OPERATION_KEYS,
-		"suggestionId",
-		"formatting"
-	],
-	insertAfterBlock: [
-		...COMMON_OPERATION_KEYS,
-		"text",
-		"inheritFormatting",
-		"alignment",
-		"spacing",
-		"indentation",
-		"lineBreakMode",
-		"listLevel",
-		"numbering",
-		"moveId",
-		"pageBreakBefore",
-		"hardPageBreak",
-		"styleId",
-		"comment"
-	],
-	insertBeforeBlock: [
-		...COMMON_OPERATION_KEYS,
-		"text",
-		"inheritFormatting",
-		"alignment",
-		"spacing",
-		"indentation",
-		"lineBreakMode",
-		"listLevel",
-		"numbering",
-		"moveId",
-		"pageBreakBefore",
-		"hardPageBreak",
-		"styleId",
-		"comment"
-	],
-	replaceBlock: [
-		...COMMON_OPERATION_KEYS,
-		"text",
-		"preserveFormatting",
-		"styleId",
-		"comment"
-	],
-	deleteBlock: [
-		...COMMON_OPERATION_KEYS,
-		"moveId",
-		"comment"
-	],
-	splitBlock: [
-		...COMMON_OPERATION_KEYS,
-		"offset",
-		"separator",
-		"firstParagraphProperties",
-		"secondParagraphProperties"
-	],
-	mergeBlockWithNext: [
-		...COMMON_OPERATION_KEYS,
-		"separator",
-		"mergedParagraphProperties"
-	],
-	setBlockParagraphProperties: [...COMMON_OPERATION_KEYS, "properties"],
-	insertTable: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"rows"
-	],
-	deleteTable: COMMON_OPERATION_KEYS,
-	commentOnBlock: [
-		...COMMON_OPERATION_KEYS,
-		"quote",
-		"comment"
-	],
-	insertSignatureTable: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"parties",
-		"comment"
-	],
-	insertTableRow: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"cellTexts"
-	],
-	deleteTableRow: COMMON_OPERATION_KEYS,
-	insertTableColumn: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"cellTexts"
-	],
-	deleteTableColumn: COMMON_OPERATION_KEYS,
-	mergeTableCells: [
-		...COMMON_OPERATION_KEYS,
-		"endBlockId",
-		"rowCount"
-	],
-	splitTableCell: COMMON_OPERATION_KEYS
+	replaceInBlock: acceptedKeys(OPERATION_KEY_DECISIONS.replaceInBlock),
+	replaceRange: acceptedKeys(OPERATION_KEY_DECISIONS.replaceRange),
+	commentOnRange: acceptedKeys(OPERATION_KEY_DECISIONS.commentOnRange),
+	formatRange: acceptedKeys(OPERATION_KEY_DECISIONS.formatRange),
+	insertAfterBlock: acceptedKeys(OPERATION_KEY_DECISIONS.insertAfterBlock),
+	insertBeforeBlock: acceptedKeys(OPERATION_KEY_DECISIONS.insertBeforeBlock),
+	replaceBlock: acceptedKeys(OPERATION_KEY_DECISIONS.replaceBlock),
+	deleteBlock: acceptedKeys(OPERATION_KEY_DECISIONS.deleteBlock),
+	splitBlock: acceptedKeys(OPERATION_KEY_DECISIONS.splitBlock),
+	mergeBlockWithNext: acceptedKeys(OPERATION_KEY_DECISIONS.mergeBlockWithNext),
+	setBlockParagraphProperties: acceptedKeys(OPERATION_KEY_DECISIONS.setBlockParagraphProperties),
+	insertTable: acceptedKeys(OPERATION_KEY_DECISIONS.insertTable),
+	deleteTable: acceptedKeys(OPERATION_KEY_DECISIONS.deleteTable),
+	commentOnBlock: acceptedKeys(OPERATION_KEY_DECISIONS.commentOnBlock),
+	insertSignatureTable: acceptedKeys(OPERATION_KEY_DECISIONS.insertSignatureTable),
+	insertTableRow: acceptedKeys(OPERATION_KEY_DECISIONS.insertTableRow),
+	deleteTableRow: acceptedKeys(OPERATION_KEY_DECISIONS.deleteTableRow),
+	insertTableColumn: acceptedKeys(OPERATION_KEY_DECISIONS.insertTableColumn),
+	deleteTableColumn: acceptedKeys(OPERATION_KEY_DECISIONS.deleteTableColumn),
+	mergeTableCells: acceptedKeys(OPERATION_KEY_DECISIONS.mergeTableCells),
+	splitTableCell: acceptedKeys(OPERATION_KEY_DECISIONS.splitTableCell)
 });
 const isFolioDocumentOperationType = (value) => Object.hasOwn(FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, value);
 const parseSignatureParties = (value, path) => {
@@ -762,6 +795,8 @@ const parseDocumentOperation = (value, index) => {
 		});
 		const lineBreakMode = value["lineBreakMode"];
 		if (lineBreakMode !== void 0 && lineBreakMode !== "paragraph" && lineBreakMode !== "inline") return invalidBatch(`${path}.lineBreakMode`, "expected \"paragraph\" or \"inline\" when provided");
+		const formattingScope = value["formattingScope"];
+		if (formattingScope !== void 0 && formattingScope !== "firstParagraph" && formattingScope !== "allParagraphs") return invalidBatch(`${path}.formattingScope`, "expected \"firstParagraph\" or \"allParagraphs\" when provided");
 		const text = readString(value, "text", path);
 		if (hardPageBreak !== void 0 && text.length > 0) return invalidBatch(`${path}.text`, "expected empty text with hardPageBreak");
 		if (hardPageBreak !== void 0 && pageBreakBefore !== void 0) return invalidBatch(`${path}.pageBreakBefore`, "cannot combine hardPageBreak with pageBreakBefore");
@@ -777,6 +812,7 @@ const parseDocumentOperation = (value, index) => {
 			...spacing !== void 0 && { spacing },
 			...indentation !== void 0 && { indentation },
 			...lineBreakMode !== void 0 && { lineBreakMode },
+			...formattingScope !== void 0 && { formattingScope },
 			...listLevel !== void 0 && { listLevel },
 			...numbering !== void 0 && { numbering },
 			...moveId !== void 0 && { moveId },

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/commentRangeIntegrity.js

@@ -107,7 +107,6 @@ const withoutOrphanBlockMarkers = (blocks, validCommentIds) => {
 const withoutOrphanBlockMarker = (block, validCommentIds) => {
 	if (block.type === "paragraph") return withoutOrphanParagraphMarkers(block, validCommentIds);
 	if (block.type === "table") return withoutOrphanTableMarkers(block, validCommentIds);
-	if (!("content" in block) || !block.content) return block;
 	const content = withoutOrphanBlockMarkers(block.content, validCommentIds);
 	if (!content) return block;
 	return {

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 };

package/dist/docx/footnoteParser.js

@@ -1,9 +1,9 @@
+import { blockPlainText } from "./blockPlainText.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
-import { getParagraphText, parseParagraph } from "./paragraphParser.js";
+import { parseParagraph } from "./paragraphParser.js";
 import { parseSdtProperties } from "./sdtProperties.js";
 import { parseTable } from "./tableParser.js";
 import { findChild, findChildren, getAttributes, getChildElements, getLocalName, parseXml } from "./xmlParser.js";
-import { panic } from "better-result";
 //#region src/docx/footnoteParser.ts
 /**
 * Parse note type attribute
@@ -173,32 +173,13 @@ function createEndnoteMap(byId, endnotes) {
 * Uses the accepted tracked-change view and recurses through every note block.
 */
 function getFootnoteText(footnote) {
-	return collectNoteBlockTexts(footnote.content).join("\n");
+	return blockPlainText(footnote.content);
 }
 /**
 * Get plain text content of an endnote.
 */
 function getEndnoteText(endnote) {
-	return collectNoteBlockTexts(endnote.content).join("\n");
-}
-function collectNoteBlockTexts(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) => collectNoteBlockTexts(cell.content).join("\n")).join("	"));
-			}
-			break;
-		case "blockSdt":
-			texts.push(...collectNoteBlockTexts(block.content));
-			break;
-		default: panic(`Unsupported note block in plain-text extraction: ${JSON.stringify(block)}`);
-	}
-	return texts;
+	return blockPlainText(endnote.content);
 }
 /**
 * Check if a footnote is a separator (not regular content)

package/dist/docx/graphicFrameLocks.d.ts

@@ -0,0 +1,22 @@
+import { document_d_exports } from "../types/document.js";
+import { XmlElement } from "./xmlParser.js";
+//#region src/docx/graphicFrameLocks.d.ts
+/** Every modeled lock, in schema order: the total map above keeps it exhaustive. */
+declare const GRAPHIC_FRAME_LOCK_KEYS: ("noGrp" | "noDrilldown" | "noSelect" | "noChangeAspect" | "noMove" | "noResize")[];
+/**
+ * Read the locks off a `wp:inline` or `wp:anchor` element.
+ *
+ * Returns undefined when the element is absent or carries no recognized
+ * attribute: an authored `<a:graphicFrameLocks/>` with nothing on it means the
+ * same as no element at all, so both stay "spec defaults" on the model.
+ */
+declare const parseGraphicFrameLocks: (parent: XmlElement) => document_d_exports.ImageFrameLocks | undefined;
+/**
+ * Emit the whole `wp:cNvGraphicFramePr` element for regenerated DrawingML.
+ *
+ * Absent locks mean no authored frame was ever parsed (a Folio-created
+ * picture), which keeps the historical `noChangeAspect="1"`.
+ */
+declare const serializeGraphicFrameLocks: (locks: document_d_exports.ImageFrameLocks | undefined) => string;
+//#endregion
+export { GRAPHIC_FRAME_LOCK_KEYS, parseGraphicFrameLocks, serializeGraphicFrameLocks };