@stll/folio-core 0.25.4 → 0.26.0

package/dist/docx/compatibility.js

@@ -1,4 +1,4 @@
-import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
+import { DOCX_CONFORMANCE_CLASSES, DRAWING_RAW_XML_MODES } from "@stll/docx-core/model";
 //#region src/docx/compatibility.ts
 const resolveCompatibilityContext = (doc, options) => ({
 	host: options.host ?? "unknown",
@@ -146,7 +146,7 @@ function inspectHyperlink(hyperlink, context) {
 	});
 }
 function inspectRun(run, context) {
-	for (const [contentIndex, content] of run.content.entries()) if (content.type === "drawing" && content.rawXml) context.record({
+	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}]`

package/dist/docx/runParser.js

@@ -7,7 +7,7 @@ import { requiresXmlSpacePreserve } from "./textWhitespace.js";
 import { resolveThemeFontRef } from "./themeParser.js";
 import { parseVmlImageContent } from "./vmlImageParser.js";
 import { cloneWithXmlnsDeclarations, elementToXml, findAllDeep, findChild, findChildren, getAttribute, getChildElements, getLocalName, getTextContent, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
-import { normalizeRevisionId } from "@stll/docx-core/model";
+import { DRAWING_RAW_XML_MODES, normalizeRevisionId } from "@stll/docx-core/model";
 //#region src/docx/runParser.ts
 /**
 * Sanity cap on `w:lang` `@w:val`/`@w:eastAsia`/`@w:bidi` tag length. BCP-47
@@ -500,7 +500,8 @@ function parseDrawingContent(element, rels, media) {
 			},
 			wrap: { type: "inline" }
 		},
-		rawXml: elementToXml(element)
+		rawXml: elementToXml(element),
+		rawXmlMode: DRAWING_RAW_XML_MODES.PRESERVE_ONLY
 	};
 	const shape = parseShapeFromDrawing(element);
 	if (shape) return {

package/dist/docx/serializer/paragraphSerializer.js

@@ -215,7 +215,7 @@ function serializeParagraphPropertyChange(change) {
 */
 function serializeHyperlink(hyperlink) {
 	const attrs = [];
-	if (hyperlink.rId) attrs.push(`r:id="${hyperlink.rId}"`);
+	if (hyperlink.rId) attrs.push(`r:id="${escapeXml(hyperlink.rId)}"`);
 	if (hyperlink.anchor) attrs.push(`w:anchor="${escapeXml(hyperlink.anchor)}"`);
 	if (hyperlink.tooltip) attrs.push(`w:tooltip="${escapeXml(hyperlink.tooltip)}"`);
 	if (hyperlink.target) attrs.push(`w:tgtFrame="${escapeXml(hyperlink.target)}"`);

package/dist/docx/serializer/runSerializer.js

@@ -338,7 +338,7 @@ function serializeWrap(wrap) {
 function serializePicGraphic(image, sharedId) {
 	const cx = image.size.width;
 	const cy = image.size.height;
-	const rId = image.rId || "rId1";
+	const rId = escapeXml(image.rId || "rId1");
 	const id = sharedId;
 	const name = image.filename || `image${id}`;
 	let xfrmAttrs = "";
@@ -448,6 +448,10 @@ function serializeDrawingContent(content) {
 function serializeShapeTextBody(blocks) {
 	return blocks.map((block) => block.type === "paragraph" ? serializeParagraph(block) : serializeTable(block, serializeParagraph)).join("");
 }
+function serializeGeometryAdjustments(shape) {
+	if (!shape.geometryAdjustments || shape.geometryAdjustments.length === 0) return "<a:avLst/>";
+	return `<a:avLst>${shape.geometryAdjustments.map(({ name, formula }) => `<a:gd name="${escapeXml(name)}" fmla="${escapeXml(formula)}"/>`).join("")}</a:avLst>`;
+}
 /**
 * Serialize shape content to full DrawingML XML (wps:wsp inside w:drawing)
 */
@@ -470,7 +474,7 @@ function serializeShapeContent(content) {
 		"<a:off x=\"0\" y=\"0\"/>",
 		`<a:ext cx="${intAttr(cx)}" cy="${intAttr(cy)}"/>`,
 		"</a:xfrm>",
-		`<a:prstGeom prst="${shape.shapeType === "textBox" ? "rect" : shape.shapeType}"><a:avLst/></a:prstGeom>`,
+		`<a:prstGeom prst="${shape.shapeType === "textBox" ? "rect" : shape.shapeType}">${serializeGeometryAdjustments(shape)}</a:prstGeom>`,
 		serializeFill(shape.fill),
 		serializeOutline(shape.outline),
 		"</wps:spPr>"

package/dist/docx/serializer/sectionPropertiesSerializer.js

@@ -3,8 +3,8 @@ import { serializeBorder } from "./borderSerializer.js";
 import { escapeXml, intAttr } from "./xmlUtils.js";
 import { normalizeRevisionId } from "@stll/docx-core/model";
 //#region src/docx/serializer/sectionPropertiesSerializer.ts
-const serializeHeaderReference = (ref) => `<w:headerReference w:type="${ref.type}" r:id="${ref.rId}"/>`;
-const serializeFooterReference = (ref) => `<w:footerReference w:type="${ref.type}" r:id="${ref.rId}"/>`;
+const serializeHeaderReference = (ref) => `<w:headerReference w:type="${ref.type}" r:id="${escapeXml(ref.rId)}"/>`;
+const serializeFooterReference = (ref) => `<w:footerReference w:type="${ref.type}" r:id="${escapeXml(ref.rId)}"/>`;
 function serializeFootnoteProperties(props) {
 	if (!props) return "";
 	const parts = [];
@@ -178,7 +178,7 @@ function serializeSectionProperties(props) {
 		serializeOnOffElement(props.noEndnote, "noEndnote"),
 		serializeOnOffElement(props.rtlGutter, "rtlGutter")
 	]) if (xml) parts.push(xml);
-	if (props.printerSettingsRelationshipId) parts.push(`<w:printerSettings r:id="${props.printerSettingsRelationshipId}"/>`);
+	if (props.printerSettingsRelationshipId) parts.push(`<w:printerSettings r:id="${escapeXml(props.printerSettingsRelationshipId)}"/>`);
 	for (const change of props.propertyChanges ?? []) parts.push(serializeSectionPropertyChange(change));
 	const unserializedChildNames = getUnserializedSectionPropertyChildNames(props);
 	if (unserializedChildNames && unserializedChildNames.length > 0) return "";

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

@@ -37,6 +37,11 @@ type CreateBilingualDocumentOptions = {
   targetStyleSuffix: string;
   /** Table borders; legal practice is usually `"none"`. Default `"none"`. */
   borders?: BilingualBorders;
+  /**
+   * Paragraph handles exposed by Folio's canonical AI-edit snapshot for the
+   * source DOCX. Only these paragraphs may become translation rows.
+   */
+  editableParagraphIds: ReadonlySet<string>;
 };
 type CreateBilingualDocumentResult = {
   document: document_d_exports.Document;
@@ -52,11 +57,11 @@ declare class InvalidBilingualDocumentOptionsError extends InvalidBilingualDocum
 declare function createBilingualDocument(source: document_d_exports.Document, options: CreateBilingualDocumentOptions): CreateBilingualDocumentResult;
 /**
  * Re-derive the row manifest from a document produced by
- * {@link createBilingualDocument}. Detection is structural: a top-level table
- * whose rows are all either a left | right pair of single-paragraph cells or
- * one cell spanning both columns. Rows are returned in document order; the
- * right paragraph's `paraId` is the row handle, as at creation.
+ * {@link createBilingualDocument}. A dedicated table-style discriminator keeps
+ * ordinary two-column source tables from being mistaken for bilingual output;
+ * the expected row structure is validated as a second check. Rows are returned
+ * in document order; the right paragraph's `paraId` is the row handle.
  */
-declare function readBilingualDocument(document: document_d_exports.Document): BilingualRow[];
+declare function readBilingualDocument(document: document_d_exports.Document, editableParagraphIds: ReadonlySet<string>): BilingualRow[];
 //#endregion
 export { BilingualBorders, BilingualParagraphRef, BilingualRow, BilingualRowKind, BilingualTableParagraphRef, CreateBilingualDocumentOptions, CreateBilingualDocumentResult, InvalidBilingualDocumentOptionsError, createBilingualDocument, readBilingualDocument };

package/dist/docx/server/createBilingualDocument.js

@@ -17,13 +17,17 @@ import { TaggedError } from "better-result";
 * and the break paragraph stays between the tables. A source table (parties,
 * signature block) is kept once, in a row spanning both columns: it is signed
 * and read once, and its labels are translated inline rather than duplicated.
+* Structural-only paragraphs are also kept once between tables; they have no
+* independently editable text for a translation row to address.
 */
 const STYLE_SUFFIX_PATTERN = /^[A-Za-z0-9-]+$/u;
 var InvalidBilingualDocumentOptionsError = class extends TaggedError("InvalidBilingualDocumentOptionsError") {};
+var UneditableBilingualManifestError = class extends TaggedError("UneditableBilingualManifestError") {};
 const FULL_WIDTH_PCT = 5e3;
 const HALF_WIDTH_PCT = 2500;
 const A4_TEXT_WIDTH_TWIPS = 9072;
 const ROW_ID_NAMESPACE = "folio-bilingual";
+const BILINGUAL_TABLE_STYLE_ID = "FolioBilingualTranslation";
 const GRID_BORDER = {
 	style: "single",
 	size: 4,
@@ -96,6 +100,11 @@ function createBilingualDocument(source, options) {
 		}
 		if (block.type === "paragraph") {
 			if (isEmptyParagraph(block)) continue;
+			if (block.paraId === void 0 || !options.editableParagraphIds.has(block.paraId)) {
+				flushSection();
+				content.push(block);
+				continue;
+			}
 			const { copy, ref } = copyParagraph(block);
 			rows.push({
 				kind: classifyParagraph(block, styleById),
@@ -105,10 +114,15 @@ function createBilingualDocument(source, options) {
 			sectionRows.push(buildRow(block, copy));
 			continue;
 		}
-		const paragraphs = collectTableParagraphs(block).map((paragraph) => ({
+		const paragraphs = collectTableParagraphs(block).filter((paragraph) => paragraph.paraId !== void 0 && options.editableParagraphIds.has(paragraph.paraId)).map((paragraph) => ({
 			paraId: paragraph.paraId,
 			sourceText: getParagraphText(paragraph)
 		}));
+		if (paragraphs.length === 0) {
+			flushSection();
+			content.push(block);
+			continue;
+		}
 		rows.push({
 			kind: "table",
 			rowId: paragraphs.at(0)?.paraId ?? tableRowHandle(rows.length),
@@ -152,7 +166,7 @@ const flattenBlocks = (content) => {
 };
 const isEmptyParagraph = (paragraph) => {
 	if (getParagraphText(paragraph).trim().length > 0) return false;
-	return paragraph.content.every((item) => item.type === "run" && item.content.every((part) => part.type === "text"));
+	return paragraph.content.every((item) => item.type === "run" && item.formatting?.hidden !== true && item.content.every((part) => part.type === "text"));
 };
 /** Heading style families across Word UI languages (en, cs/sk, de, fr, pl). */
 const HEADING_STYLE_PATTERN = /heading|nadpis|berschrift|titre|nag[łl]/iu;
@@ -391,6 +405,7 @@ const buildTable = (rows, borders, textWidth) => ({
 			value: FULL_WIDTH_PCT,
 			type: "pct"
 		},
+		styleId: BILINGUAL_TABLE_STYLE_ID,
 		layout: "fixed",
 		borders: TABLE_BORDERS[borders],
 		look: {
@@ -453,21 +468,22 @@ const createParaIdMinter = (taken) => {
 };
 /**
 * Re-derive the row manifest from a document produced by
-* {@link createBilingualDocument}. Detection is structural: a top-level table
-* whose rows are all either a left | right pair of single-paragraph cells or
-* one cell spanning both columns. Rows are returned in document order; the
-* right paragraph's `paraId` is the row handle, as at creation.
+* {@link createBilingualDocument}. A dedicated table-style discriminator keeps
+* ordinary two-column source tables from being mistaken for bilingual output;
+* the expected row structure is validated as a second check. Rows are returned
+* in document order; the right paragraph's `paraId` is the row handle.
 */
-function readBilingualDocument(document) {
+function readBilingualDocument(document, editableParagraphIds) {
 	const styleById = new Map((document.package.styles?.styles ?? []).map((style) => [style.styleId, style]));
 	const rows = [];
+	let missingHandleCount = 0;
 	for (const block of flattenBlocks(document.package.document.content)) {
 		if (block.type !== "table" || !isBilingualTable(block)) continue;
 		for (const row of block.rows) {
 			const [left, right] = row.cells;
 			if (!left) continue;
 			if (!right) {
-				const paragraphs = left.content.filter((item) => item.type === "table").flatMap(collectTableParagraphs).map((paragraph) => ({
+				const paragraphs = left.content.filter((item) => item.type === "table").flatMap(collectTableParagraphs).filter((paragraph) => paragraph.paraId !== void 0 && editableParagraphIds.has(paragraph.paraId)).map((paragraph) => ({
 					paraId: paragraph.paraId,
 					sourceText: getParagraphText(paragraph)
 				}));
@@ -480,7 +496,16 @@ function readBilingualDocument(document) {
 			}
 			const source = left.content.at(0);
 			const target = right.content.at(0);
-			if (source?.type !== "paragraph" || target?.type !== "paragraph" || !target.paraId) continue;
+			if (source?.type !== "paragraph" || target?.type !== "paragraph") continue;
+			if (target.paraId === void 0) {
+				missingHandleCount += 1;
+				continue;
+			}
+			const sourceMissing = source.paraId === void 0 || !editableParagraphIds.has(source.paraId);
+			const targetMissing = !editableParagraphIds.has(target.paraId);
+			if (sourceMissing) missingHandleCount += 1;
+			if (targetMissing) missingHandleCount += 1;
+			if (sourceMissing || targetMissing) continue;
 			rows.push({
 				kind: classifyParagraph(source, styleById),
 				rowId: target.paraId,
@@ -490,9 +515,14 @@ function readBilingualDocument(document) {
 			});
 		}
 	}
+	if (missingHandleCount > 0) throw new UneditableBilingualManifestError({
+		message: "Bilingual manifest contains handles absent from the Folio AI-edit snapshot.",
+		missingHandleCount
+	});
 	return rows;
 }
 const isBilingualTable = (table) => {
+	if (table.formatting?.styleId !== BILINGUAL_TABLE_STYLE_ID) return false;
 	let pairs = 0;
 	for (const row of table.rows) {
 		const cells = row.cells;

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

@@ -1,5 +1,6 @@
 import { BilingualRow, CreateBilingualDocumentOptions } from "./createBilingualDocument.js";
 //#region src/docx/server/createBilingualDocx.d.ts
+type CreateBilingualDocxOptions = Omit<CreateBilingualDocumentOptions, "editableParagraphIds">;
 type CreateBilingualDocxResult = {
   buffer: ArrayBuffer;
   rows: BilingualRow[];
@@ -12,8 +13,8 @@ type CreateBilingualDocxResult = {
  * as a two-column table, and repack onto the original package so theme, fonts,
  * media, headers and footers carry over untouched.
  */
-declare function createBilingualDocx(input: ArrayBuffer | Uint8Array, options: CreateBilingualDocumentOptions): Promise<CreateBilingualDocxResult>;
+declare function createBilingualDocx(input: ArrayBuffer | Uint8Array, options: CreateBilingualDocxOptions): Promise<CreateBilingualDocxResult>;
 /** Bytes-in form of {@link readBilingualDocument}. */
 declare function readBilingualDocx(input: ArrayBuffer | Uint8Array): Promise<BilingualRow[]>;
 //#endregion
-export { CreateBilingualDocxResult, createBilingualDocx, readBilingualDocx };
+export { CreateBilingualDocxOptions, CreateBilingualDocxResult, createBilingualDocx, readBilingualDocx };

package/dist/docx/server/createBilingualDocx.js

@@ -1,3 +1,5 @@
+import { FolioDocxReviewer } from "../../ai-edits/headless.js";
+import { toArrayBuffer } from "../../utils/docxInput.js";
 import { ensureParaIds } from "../ensureParaIds.js";
 import { parseDocx } from "../parser.js";
 import { createDocx } from "../rezip.js";
@@ -11,16 +13,23 @@ import { createBilingualDocument, readBilingualDocument } from "./createBilingua
 * media, headers and footers carry over untouched.
 */
 async function createBilingualDocx(input, options) {
-	const { document, rows, warnings } = createBilingualDocument(await parseDocx((await ensureParaIds(input)).docx, { preloadFonts: false }), options);
+	const stampedBuffer = await toArrayBuffer((await ensureParaIds(input)).docx);
+	const editableParagraphIds = new Set((await FolioDocxReviewer.fromBuffer(stampedBuffer)).snapshot().blocks.map(({ id }) => id));
+	const { document, warnings } = createBilingualDocument(await parseDocx(stampedBuffer, { preloadFonts: false }), {
+		...options,
+		editableParagraphIds
+	});
+	const buffer = await createDocx(document);
 	return {
-		buffer: await createDocx(document),
-		rows,
+		buffer,
+		rows: await readBilingualDocx(buffer),
 		warnings
 	};
 }
 /** Bytes-in form of {@link readBilingualDocument}. */
 async function readBilingualDocx(input) {
-	return readBilingualDocument(await parseDocx(input, { preloadFonts: false }));
+	const buffer = await toArrayBuffer(input);
+	return readBilingualDocument(await parseDocx(buffer, { preloadFonts: false }), new Set((await FolioDocxReviewer.fromBuffer(buffer)).snapshot().blocks.map(({ id }) => id)));
 }
 //#endregion
 export { createBilingualDocx, readBilingualDocx };

package/dist/docx/shapeParser.js

@@ -1,6 +1,6 @@
 import { parseAnchorPosition, parseAnchorWrap, parseFill, parseOutline } from "./drawingUtils.js";
 import { ShapeTypeSchema, narrowEnum } from "./parserEnums.js";
-import { findAllDeep, findChildByLocalName, getAttribute, parseNumericAttribute } from "./xmlParser.js";
+import { findAllDeep, findChildByLocalName, findChildren, getAttribute, getChildElements, parseNumericAttribute } from "./xmlParser.js";
 //#region src/docx/shapeParser.ts
 /** Convert OOXML rotation (1/60000ths of a degree) to degrees. */
 function rotToDegrees(rot) {
@@ -56,8 +56,29 @@ function hasUnsupportedGeometry(spPr) {
 	if (!spPr) return false;
 	const prstGeom = findChildByLocalName(spPr, "prstGeom");
 	if (!prstGeom) return findChildByLocalName(spPr, "custGeom") !== null;
-	if (findChildByLocalName(prstGeom, "avLst")?.elements?.some((child) => child.type === "element")) return true;
-	return narrowEnum(getAttribute(prstGeom, null, "prst"), ShapeTypeSchema) === void 0;
+	const avLst = findChildByLocalName(prstGeom, "avLst");
+	const prst = getAttribute(prstGeom, null, "prst");
+	if (narrowEnum(prst, ShapeTypeSchema) === void 0) return true;
+	const adjustmentChildren = avLst ? getChildElements(avLst) : [];
+	if (adjustmentChildren.length === 0) return false;
+	const adjustments = findChildren(avLst, "a", "gd");
+	const adjustmentNames = new Set(adjustments.map((adjustment) => getAttribute(adjustment, null, "name")));
+	return !(prst === "rightBrace" && adjustments.length === 2 && adjustmentChildren.length === adjustments.length && adjustmentNames.size === 2 && adjustmentNames.has("adj1") && adjustmentNames.has("adj2") && adjustments.every((adjustment) => /^val\s+-?\d+$/u.test(getAttribute(adjustment, null, "fmla") ?? "")));
+}
+function parseGeometryAdjustments(spPr) {
+	const prstGeom = spPr ? findChildByLocalName(spPr, "prstGeom") : null;
+	const avLst = prstGeom ? findChildByLocalName(prstGeom, "avLst") : null;
+	if (!avLst) return;
+	const adjustments = [];
+	for (const adjustment of findChildren(avLst, "a", "gd")) {
+		const name = getAttribute(adjustment, null, "name");
+		const formula = getAttribute(adjustment, null, "fmla");
+		if (name !== null && formula !== null) adjustments.push({
+			name,
+			formula
+		});
+	}
+	return adjustments.length === 0 ? void 0 : adjustments;
 }
 function hasUnsupportedRgbColorModifiers(spPr) {
 	for (const color of findAllDeep(spPr, "a", "srgbClr")) if (color.elements?.some((child) => child.type === "element")) return true;
@@ -94,6 +115,8 @@ function parseShape(node) {
 		shapeType,
 		size
 	};
+	const geometryAdjustments = parseGeometryAdjustments(spPr);
+	if (geometryAdjustments !== void 0) shape.geometryAdjustments = geometryAdjustments;
 	if (id !== void 0) shape.id = id;
 	if (name !== void 0) shape.name = name;
 	if (fill !== void 0) shape.fill = fill;

package/dist/docx/unzip.js

@@ -147,7 +147,7 @@ async function unzipDocx(buffer, options = {}) {
 		if (lowerPath.endsWith(".xml") || lowerPath.endsWith(".rels")) {
 			assertEntrySize(path, declaredSize, limits.maxXmlBytes);
 			if (options.extractAllXml === false && !shouldExtractXmlPart(lowerPath)) continue;
-			extractionTasks.push(file.async("text").then((xmlContent) => {
+			extractionTasks.push(() => file.async("text").then((xmlContent) => {
 				assertExtractedSize(path, xmlContent.length, limits.maxXmlBytes);
 				return {
 					type: "xml",
@@ -163,7 +163,7 @@ async function unzipDocx(buffer, options = {}) {
 				content.warnings.push(`Skipped oversized media file: ${path}; original entry preserved for round-trip.`);
 				continue;
 			}
-			extractionTasks.push(file.async("arraybuffer").then((binaryContent) => {
+			extractionTasks.push(() => file.async("arraybuffer").then((binaryContent) => {
 				if (binaryContent.byteLength > limits.maxMediaBytes) {
 					content.warnings.push(`Skipped oversized media file: ${path}; original entry preserved for round-trip.`);
 					return null;
@@ -178,7 +178,7 @@ async function unzipDocx(buffer, options = {}) {
 			}));
 		} else if (lowerPath.startsWith("word/fonts/")) {
 			if (isEntryTooLarge(declaredSize, limits.maxFontBytes)) continue;
-			extractionTasks.push(file.async("arraybuffer").then((binaryContent) => {
+			extractionTasks.push(() => file.async("arraybuffer").then((binaryContent) => {
 				if (binaryContent.byteLength > limits.maxFontBytes) return null;
 				return {
 					type: "font",
@@ -188,7 +188,7 @@ async function unzipDocx(buffer, options = {}) {
 			}));
 		}
 	}
-	for (const extracted of await Promise.all(extractionTasks)) {
+	for (const extracted of await Promise.all(extractionTasks.map((extract) => extract()))) {
 		if (!extracted) continue;
 		if (extracted.type === "xml") {
 			assignXmlContent(content, extracted);

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

@@ -15,6 +15,7 @@ import { resolveColor, resolveHighlightToCss } from "../../utils/colorResolver.j
 import { resolveThemeFont } from "../../utils/fontResolver.js";
 import { resolveShadingFill } from "../../utils/formatToStyle.js";
 import { decodeOoxmlSymbolCharacter } from "../../utils/ooxmlSymbol.js";
+import { tableOfContentsStyleLevel } from "../../utils/tableOfContentsStyle.js";
 import { AUTO_PARAGRAPH_SPACING_PX, halfPointsToPixels, halfPointsToPoints, pointsToPixels } from "../../utils/units.js";
 import { getColumns } from "../sectionColumns.js";
 import { groupParagraphFrames } from "./paragraphFrames.js";
@@ -454,12 +455,6 @@ function buildImageRun(attrs, constrained, pmStart, pmEnd, trackedChange) {
 	return run;
 }
 /**
-* Paragraph styleId pattern used by Word for TOC entries (TOC, TOC1, TOC2, …).
-* Hyperlinks inside these paragraphs must render in the paragraph's own colour,
-* not the Hyperlink character style — see {@link stripTocHyperlinkStyle}.
-*/
-const TOC_STYLE_ID = /^TOC\d*$/iu;
-/**
 * In TOC paragraphs, strip the resolved Hyperlink character-style colour and
 * underline so the painter's link fallback doesn't fire. The PM doc keeps the
 * original marks so copy/paste out of a TOC still carries the Hyperlink
@@ -484,7 +479,7 @@ function paragraphToRuns(node, startPos, _options) {
 	const pmAttrs = expectParagraphAttrs(node);
 	const paraDefaults = paragraphRunDefaults(pmAttrs, theme);
 	const paragraphStyleId = pmAttrs.styleId;
-	const inTocParagraph = typeof paragraphStyleId === "string" && TOC_STYLE_ID.test(paragraphStyleId);
+	const inTocParagraph = pmAttrs._tableOfContentsLevel !== void 0 || tableOfContentsStyleLevel({ styleId: paragraphStyleId }) !== void 0;
 	let leadingRenderedPageBreakPending = pmAttrs.renderedPageBreakBefore === true;
 	function pushRunsForChild(child, childPos) {
 		if (child.type.name === "renderedPageBreak") {

package/dist/prosemirror/attrs/index.js

@@ -2,7 +2,7 @@ import { EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FONT_HINT_VALUES, FONT_THEME_V
 import { isParagraphDirection } from "../paragraphDirection.js";
 import { TRACKED_CHANGE_PROVENANCE_VALUES } from "../schema/marks.js";
 import { panic } from "better-result";
-import { isOoxmlSymbolCharacter } from "@stll/docx-core/model";
+import { DRAWING_RAW_XML_MODES, isOoxmlSymbolCharacter } from "@stll/docx-core/model";
 //#region src/prosemirror/attrs/index.ts
 const SECTION_BREAK_TYPES = [
 	"nextPage",
@@ -143,6 +143,7 @@ const readParagraphAttrs = (node) => {
 	optionalString(attrs, "textId", "paragraph.attrs.textId", issues);
 	optionalOneOf(attrs, "alignment", "paragraph.attrs.alignment", issues, PARAGRAPH_ALIGNMENT_VALUES);
 	optionalString(attrs, "styleId", "paragraph.attrs.styleId", issues);
+	optionalNumber(attrs, "_tableOfContentsLevel", "paragraph.attrs._tableOfContentsLevel", issues);
 	optionalBoolean(attrs, "kinsoku", "paragraph.attrs.kinsoku", issues);
 	optionalBoolean(attrs, "overflowPunctuation", "paragraph.attrs.overflowPunctuation", issues);
 	optionalBoolean(attrs, "suppressAutoHyphens", "paragraph.attrs.suppressAutoHyphens", issues);
@@ -357,6 +358,12 @@ const readImageAttrs = (node) => {
 	optionalString(attrs, "hlinkHref", "image.attrs.hlinkHref", issues);
 	optionalString(attrs, "hlinkRId", "image.attrs.hlinkRId", issues);
 	optionalString(attrs, "_docxRawXml", "image.attrs._docxRawXml", issues);
+	optionalOneOf(attrs, "_docxRawXmlMode", "image.attrs._docxRawXmlMode", issues, Object.values(DRAWING_RAW_XML_MODES));
+	const rawXml = attrs["_docxRawXml"];
+	if (attrs["_docxRawXmlMode"] === DRAWING_RAW_XML_MODES.PRESERVE_ONLY && (typeof rawXml !== "string" || rawXml.trim().length === 0)) issues.push({
+		path: "image.attrs._docxRawXml",
+		message: "Preservation-only drawings require raw XML."
+	});
 	optionalBoolean(attrs, "_docxObjectPreview", "image.attrs._docxObjectPreview", issues);
 	return attrsResult(attrs, issues);
 };
@@ -422,6 +429,7 @@ const readShapeAttrs = (node) => {
 	const issues = [];
 	expectNodeType(node, "shape", issues);
 	optionalString(attrs, "shapeType", "shape.attrs.shapeType", issues);
+	optionalString(attrs, "geometryAdjustments", "shape.attrs.geometryAdjustments", issues);
 	optionalString(attrs, "shapeId", "shape.attrs.shapeId", issues);
 	optionalNumber(attrs, "width", "shape.attrs.width", issues);
 	optionalNumber(attrs, "height", "shape.attrs.height", issues);

package/dist/prosemirror/commands/image.js

@@ -105,7 +105,8 @@ const constrainImageSize = (width, height) => {
 };
 const imageNodeAt = (view, pos) => {
 	const node = view.state.doc.nodeAt(pos);
-	return node && node.type.name === "image" ? node : null;
+	if (!node || node.type.name !== "image") return null;
+	return expectImageAttrs(node)._docxRawXmlMode ? null : node;
 };
 /** Change the wrap mode of the image at `pos`. Returns whether it applied. */
 const applyImageWrapType = (view, pos, wrapType) => {

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -7,13 +7,27 @@ import { autospacingMatchesBase, hasAutospacingBaseSide } from "../autospacingBa
 import { applyRunFormattingOverrideAttrs } from "../extensions/marks/RunFormattingOverrideExtension.js";
 import { directionToBidi } from "../paragraphDirection.js";
 import { RUN_FORMATTING_MARK_NAMES } from "../runFormattingMarkNames.js";
+import { parseShapeGeometryAdjustments } from "../shapeGeometryAdjustments.js";
 import { expectTextBoxAnchorAttrs } from "../textBoxAnchorAttrs.js";
 import { assertValidProseMirrorDocument } from "../validation.js";
 import { runShadingAttrsToShading } from "./runShadingMark.js";
 import { decodeSdtListItems, sdtPropertiesFromAttrs, sdtPropertiesMatchAttrs } from "./sdtAttrs.js";
 import { textFormattingToMarks } from "./toProseDoc.js";
+import { panic } from "better-result";
+import { DRAWING_RAW_XML_MODES } from "@stll/docx-core/model";
 import { Fragment } from "prosemirror-model";
 //#region src/prosemirror/conversion/fromProseDoc.ts
+/**
+* ProseMirror to Document Conversion
+*
+* Converts a ProseMirror document back to our Document type.
+* This enables round-trip editing: DOCX -> Document -> PM -> Document -> DOCX
+*
+* Key responsibilities:
+* - Coalesce consecutive text with same marks into single Runs
+* - Preserve paragraph attributes (paraId, textId, formatting)
+* - Handle marks -> TextFormatting conversion
+*/
 function normalizeShapeOutlineStyle(style) {
 	if (!style) return;
 	if (style in OUTLINE_STYLE_CSS_ALIASES) return OUTLINE_STYLE_CSS_ALIASES[style];
@@ -1256,14 +1270,18 @@ function createImageRun(node) {
 		if (cropLeft !== void 0) crop.left = cropLeft;
 		image.crop = crop;
 	}
-	const drawingContent = {
-		type: "drawing",
-		image
-	};
-	if (attrs._docxRawXml) drawingContent.rawXml = attrs._docxRawXml;
 	return {
 		type: "run",
-		content: [drawingContent]
+		content: [attrs._docxRawXmlMode === DRAWING_RAW_XML_MODES.PRESERVE_ONLY ? {
+			type: "drawing",
+			image,
+			rawXml: attrs._docxRawXml ?? panic("Preservation-only ProseMirror image attrs must include raw XML."),
+			rawXmlMode: DRAWING_RAW_XML_MODES.PRESERVE_ONLY
+		} : {
+			type: "drawing",
+			image,
+			...attrs._docxRawXml ? { rawXml: attrs._docxRawXml } : {}
+		}]
 	};
 }
 /**
@@ -1280,6 +1298,8 @@ function createShapeRun(node) {
 		}
 	};
 	if (attrs.shapeId) shape.id = attrs.shapeId;
+	const geometryAdjustments = parseShapeGeometryAdjustments(attrs.geometryAdjustments);
+	if (geometryAdjustments !== void 0) shape.geometryAdjustments = geometryAdjustments;
 	const shapeTransform = parseTransformAttr(attrs.transform);
 	if (shapeTransform) shape.transform = shapeTransform;
 	const wrap = { type: attrs.wrapType || "inline" };

package/dist/prosemirror/conversion/toProseDoc.js

@@ -1,6 +1,7 @@
 import { resolveColorValueToHex } from "../../docx/drawingUtils.js";
 import { createStyleEngine } from "../../style-engine/styleEngine.js";
 import { mergeParagraphFormatting, mergeParagraphTabStops } from "../../utils/paragraphFormattingMerge.js";
+import { tableOfContentsStyleLevel } from "../../utils/tableOfContentsStyle.js";
 import { mergeTextFormatting } from "../../utils/textFormattingMerge.js";
 import { emuToPixels } from "../../utils/units.js";
 import { setAutospacingBaseValue } from "../autospacingBase.js";
@@ -13,8 +14,6 @@ import { marksToTextFormatting } from "./fromProseDoc.js";
 import { shadingToRunShadingAttrs } from "./runShadingMark.js";
 import { sdtAttrsFromProperties } from "./sdtAttrs.js";
 //#region src/prosemirror/conversion/toProseDoc.ts
-const TOC_STYLE_ID = /^TOC\d*$/iu;
-const isTocStyleId = (styleId) => styleId !== void 0 && TOC_STYLE_ID.test(styleId);
 /**
 * Build a `nextTextBoxGroupId()` generator salted with a random per-load
 * nonce, so minted text-box anchor ids (`<salt>:<group>:<index>`) are unique
@@ -128,7 +127,7 @@ function convertBlockSdt(blockSdt, convertBlocks) {
 */
 function convertParagraph(paragraph, styleResolver, nextHyperlinkInstanceIndex, activeCommentIds, extraRunFormatting, tableParagraphOverlay, textBoxAnchors) {
 	const attrs = paragraphFormattingToAttrs(paragraph, styleResolver, tableParagraphOverlay);
-	const isTocParagraph = isTocStyleId(paragraph.formatting?.styleId);
+	const isTocParagraph = attrs._tableOfContentsLevel !== void 0;
 	const inlineNodes = [];
 	let inlineOffset = 0;
 	let bookmarksArr;
@@ -280,10 +279,16 @@ function canCarryTrackedRunMark(node, markType) {
 function paragraphFormattingToAttrs(paragraph, styleResolver, tableParagraphOverlay) {
 	const formatting = paragraph.formatting;
 	const styleId = formatting?.styleId;
+	const styleName = styleId ? styleResolver?.getStyle(styleId)?.name : void 0;
+	const tableOfContentsLevel = tableOfContentsStyleLevel({
+		styleId,
+		...styleName ? { styleName } : {}
+	});
 	const attrs = {};
 	if (paragraph.paraId) attrs.paraId = paragraph.paraId;
 	if (paragraph.textId) attrs.textId = paragraph.textId;
 	if (styleId) attrs.styleId = styleId;
+	if (tableOfContentsLevel !== void 0) attrs._tableOfContentsLevel = tableOfContentsLevel;
 	if (formatting?.numPr) attrs.numPr = formatting.numPr;
 	if (formatting?.numPrFromStyle) attrs.numPrFromStyle = formatting.numPrFromStyle;
 	if (paragraph.listRendering?.numFmt) attrs.listNumFmt = paragraph.listRendering.numFmt;
@@ -350,7 +355,7 @@ function paragraphFormattingToAttrs(paragraph, styleResolver, tableParagraphOver
 		set("runInWithNext", formatting?.runInWithNext ?? stylePpr?.runInWithNext);
 		set("outlineLevel", formatting?.outlineLevel ?? stylePpr?.outlineLevel);
 		set("direction", directionFromBidi(formatting?.bidi ?? stylePpr?.bidi));
-		set("defaultTextFormatting", resolveParagraphDefaultTextFormatting(styleId, formatting, styleResolver, { includeParagraphMarkRunProperties: !isTocStyleId(styleId) }));
+		set("defaultTextFormatting", resolveParagraphDefaultTextFormatting(styleId, formatting, styleResolver, { includeParagraphMarkRunProperties: tableOfContentsLevel === void 0 }));
 		if (!formatting?.numPr && stylePpr?.numPr && stylePpr.numPr.numId !== 0) {
 			attrs.numPr = stylePpr.numPr;
 			attrs.numPrFromStyle = stylePpr.numPr;
@@ -1050,7 +1055,11 @@ function convertRunContent(content, marks, formatting, textBoxAnchors) {
 			return [];
 		case "renderedPageBreak": return [schema.node("renderedPageBreak").mark(marks)];
 		case "tab": return [schema.node("tab", content.positional ? { positional: content.positional } : void 0).mark(marks)];
-		case "drawing": return [withHyperlinkBoundaryMarks(convertImage(content.image, content.rawXml), marks)];
+		case "drawing": return [withHyperlinkBoundaryMarks(convertImage({
+			image: content.image,
+			rawXml: content.rawXml,
+			rawXmlMode: content.rawXmlMode
+		}), marks)];
 		case "shape": {
 			const shp = content.shape;
 			if (shp.textBody) {
@@ -1089,7 +1098,7 @@ function withHyperlinkBoundaryMarks(node, marks) {
 	if (!marks.some((mark) => mark.type.name === "hyperlink")) return node;
 	return node.mark(marks);
 }
-function convertImage(image, rawXml) {
+function convertImage({ image, rawXml, rawXmlMode }) {
 	const imageSize = image.size;
 	const widthPx = imageSize?.width ? emuToPixels(imageSize.width) : void 0;
 	const heightPx = imageSize?.height ? emuToPixels(imageSize.height) : void 0;
@@ -1190,6 +1199,7 @@ function convertImage(image, rawXml) {
 		hlinkHref: image.hlinkHref,
 		hlinkRId: image.hlinkRId,
 		_docxRawXml: rawXml,
+		_docxRawXmlMode: rawXmlMode,
 		_docxObjectPreview: rawXml !== void 0 && /<(?:[A-Za-z_][\w.-]*:)?object(?:\s|>)/u.test(rawXml)
 	});
 }
@@ -1347,6 +1357,7 @@ function convertShape(shape) {
 	};
 	return schema.node("shape", {
 		shapeType: shapeAttrs.shapeType ?? "rect",
+		geometryAdjustments: shape.geometryAdjustments === void 0 ? void 0 : JSON.stringify(shape.geometryAdjustments),
 		shapeId: shape.id,
 		width: widthPx,
 		height: heightPx,

package/dist/prosemirror/extensions/core/ParagraphExtension.d.ts

@@ -6,6 +6,8 @@ import { EditorState } from "prosemirror-state";
 type ResolvedStyleAttrs = {
   paragraphFormatting?: document_d_exports.ParagraphFormatting;
   runFormatting?: document_d_exports.TextFormatting;
+  /** Canonical OOXML style name, used when the document-local style id is localized. */
+  styleName?: string;
   /**
    * Numbering definitions from the document package. When the applied style
    * carries a `w:numPr`, these resolve the numbering level into the list

package/dist/prosemirror/extensions/core/ParagraphExtension.js

@@ -1,5 +1,6 @@
 import { paragraphToStyle } from "../../../utils/formatToStyle.js";
 import { collectHeadings } from "../../../utils/headingCollector.js";
+import { tableOfContentsStyleLevel } from "../../../utils/tableOfContentsStyle.js";
 import { expectParagraphAttrs } from "../../attrs/index.js";
 import { autospacingMatchesBase } from "../../autospacingBase.js";
 import { directionIsRtl } from "../../paragraphDirection.js";
@@ -215,6 +216,7 @@ const paragraphNodeSpec = {
 		listAbstractNumId: { default: null },
 		listStartOverride: { default: null },
 		styleId: { default: null },
+		_tableOfContentsLevel: { default: null },
 		borders: { default: null },
 		shading: { default: null },
 		tabs: { default: null },
@@ -248,11 +250,13 @@ const paragraphNodeSpec = {
 			const paraId = element.dataset["paraId"];
 			const alignment = element.dataset["alignment"];
 			const styleId = element.dataset["styleId"];
+			const tableOfContentsLevel = Number(element.dataset["tableOfContentsLevel"]);
 			const sectionBreakType = element.dataset["sectionBreak"];
 			const attrs = {
 				...paraId ? { paraId } : {},
 				...alignment ? { alignment } : {},
 				...styleId ? { styleId } : {},
+				...Number.isSafeInteger(tableOfContentsLevel) && tableOfContentsLevel > 0 ? { _tableOfContentsLevel: tableOfContentsLevel } : {},
 				...sectionBreakType ? { sectionBreakType } : {}
 			};
 			const styleAttrs = extractParagraphAttrsFromStyle(element);
@@ -291,6 +295,7 @@ const paragraphNodeSpec = {
 		if (attrs.paraId) domAttrs["data-para-id"] = attrs.paraId;
 		if (attrs.alignment) domAttrs["data-alignment"] = attrs.alignment;
 		if (attrs.styleId) domAttrs["data-style-id"] = attrs.styleId;
+		if (typeof attrs._tableOfContentsLevel === "number") domAttrs["data-table-of-contents-level"] = String(attrs._tableOfContentsLevel);
 		if (attrs.listMarker) domAttrs["data-list-marker"] = attrs.listMarker;
 		if (directionIsRtl(attrs.direction)) domAttrs["dir"] = "rtl";
 		if (attrs.sectionBreakType) {
@@ -460,10 +465,14 @@ function makeApplyStyle(schema) {
 				seen.add(pos);
 				const newAttrs = {
 					...node.attrs,
-					styleId
+					styleId,
+					_tableOfContentsLevel: tableOfContentsStyleLevel({ styleId }) ?? null
 				};
 				if (resolvedAttrs) {
-					Object.assign(newAttrs, paragraphAttrsFromResolvedStyle(resolvedAttrs));
+					Object.assign(newAttrs, paragraphAttrsFromResolvedStyle(resolvedAttrs, {
+						styleId,
+						...resolvedAttrs.styleName ? { styleName: resolvedAttrs.styleName } : {}
+					}));
 					const listAttrs = listAttrsFromResolvedStyle(resolvedAttrs, resolvedAttrs.numbering);
 					if (listAttrs) Object.assign(newAttrs, listAttrs);
 				}
@@ -534,7 +543,10 @@ const ParagraphExtension = createNodeExtension({
 				hangingIndent: hanging ?? false
 			}),
 			applyStyle: (styleId, resolvedAttrs) => applyStyleFn(styleId, resolvedAttrs),
-			clearStyle: () => setParagraphAttr("styleId", null),
+			clearStyle: () => setParagraphAttrsCmd({
+				styleId: null,
+				_tableOfContentsLevel: null
+			}),
 			insertSectionBreak: (breakType) => setParagraphAttr("sectionBreakType", breakType),
 			removeSectionBreak: () => setParagraphAttr("sectionBreakType", null),
 			generateTOC: () => (state, dispatch) => {

package/dist/prosemirror/extensions/features/BaseKeymapExtension.js

@@ -53,6 +53,7 @@ const clearIndentOnBackspace = (state, dispatch) => {
 const INHERITED_PARA_ATTRS = [
 	"defaultTextFormatting",
 	"styleId",
+	"_tableOfContentsLevel",
 	"lineSpacing",
 	"lineSpacingRule",
 	"snapToGrid",
@@ -77,11 +78,15 @@ function applyNextParagraphStyle(tr, sourcePara, newPara, resolver) {
 	const nextStyleId = resolver.getNextStyleId(sourcePara.attrs["styleId"]);
 	if (!nextStyleId) return false;
 	const resolved = resolver.resolveParagraphStyle(nextStyleId);
+	const styleName = resolver.getStyle(nextStyleId)?.name;
 	const { $from } = tr.selection;
 	tr.setNodeMarkup($from.before(), void 0, {
 		...newPara.attrs,
 		styleId: nextStyleId,
-		...paragraphAttrsFromResolvedStyle(resolved)
+		...paragraphAttrsFromResolvedStyle(resolved, {
+			styleId: nextStyleId,
+			...styleName ? { styleName } : {}
+		})
 	});
 	tr.setStoredMarks(resolved.runFormatting ? textFormattingToMarks(resolved.runFormatting, tr.doc.type.schema) : []);
 	return true;

package/dist/prosemirror/extensions/nodes/ImageExtension.js

@@ -42,6 +42,7 @@ const ImageExtension = createNodeExtension({
 			hlinkHref: { default: null },
 			hlinkRId: { default: null },
 			_docxRawXml: { default: null },
+			_docxRawXmlMode: { default: null },
 			_docxObjectPreview: { default: null }
 		},
 		parseDOM: [{

package/dist/prosemirror/extensions/nodes/ShapeExtension.d.ts

@@ -1,3 +1,4 @@
+import { document_d_exports } from "../../../types/document.js";
 import { ShapeAttrs as ShapeAttrs$1 } from "../../schema/nodes.js";
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/ShapeExtension.d.ts
@@ -7,6 +8,11 @@ declare function sanitizeTransform(value: string | null | undefined): string | n
 declare function sanitizeSvgId(value: string | null | undefined): string | null;
 declare function sanitizeShapeDimension(value: number | null | undefined, fallback: number): number;
 declare function strokeDashArrayForOutlineStyle(outlineStyle: string | undefined): string | undefined;
+type RightBracePaths = {
+  fill: string;
+  outline: string;
+};
+declare function buildRightBracePaths(w: number, h: number, adjustments: readonly document_d_exports.ShapeGeometryAdjustment[]): RightBracePaths;
 /**
  * Build the `points` string for a polygon-based shape preset.
  *
@@ -26,4 +32,4 @@ type GradientStop = {
 declare function parseGradientStops(raw: string | undefined): GradientStop[];
 declare const ShapeExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion
-export { ShapeAttrs, ShapeExtension, buildShapePolygonPoints, parseGradientStops, sanitizeColor, sanitizeShapeDimension, sanitizeSvgId, sanitizeTransform, strokeDashArrayForOutlineStyle };
+export { ShapeAttrs, ShapeExtension, buildRightBracePaths, buildShapePolygonPoints, parseGradientStops, sanitizeColor, sanitizeShapeDimension, sanitizeSvgId, sanitizeTransform, strokeDashArrayForOutlineStyle };

package/dist/prosemirror/extensions/nodes/ShapeExtension.js

@@ -1,4 +1,5 @@
 import { expectShapeAttrs } from "../../attrs/index.js";
+import { parseShapeGeometryAdjustments } from "../../shapeGeometryAdjustments.js";
 import { createNodeExtension } from "../create.js";
 //#region src/prosemirror/extensions/nodes/ShapeExtension.ts
 /**
@@ -123,6 +124,40 @@ function setNum(el, name, value) {
 function fmt(n) {
 	return Number.isInteger(n) ? String(n) : Number(n.toFixed(3)).toString();
 }
+const RIGHT_BRACE_DEFAULT_THICKNESS = 8333;
+const RIGHT_BRACE_DEFAULT_CUSP = 5e4;
+const GEOMETRY_PERCENT_SCALE = 1e5;
+const geometryAdjustment = (adjustments, name, fallback) => {
+	const authored = adjustments.find((adjustment) => adjustment.name === name);
+	if (!authored) return fallback;
+	const match = /^val\s+(-?\d+)$/u.exec(authored.formula);
+	if (!match) return fallback;
+	return Number(match.at(1));
+};
+function buildRightBracePaths(w, h, adjustments) {
+	const shortSide = Math.min(w, h);
+	const cuspAdjustment = Math.min(GEOMETRY_PERCENT_SCALE, Math.max(0, geometryAdjustment(adjustments, "adj2", RIGHT_BRACE_DEFAULT_CUSP)));
+	const maxThickness = Math.min(cuspAdjustment, GEOMETRY_PERCENT_SCALE - cuspAdjustment) / 2 * h / shortSide;
+	const radius = shortSide * Math.min(maxThickness, Math.max(0, geometryAdjustment(adjustments, "adj1", RIGHT_BRACE_DEFAULT_THICKNESS))) / GEOMETRY_PERCENT_SCALE;
+	const halfWidth = w / 2;
+	const cusp = h * cuspAdjustment / GEOMETRY_PERCENT_SCALE;
+	const upperStemEnd = cusp - radius;
+	const lowerStemStart = cusp + radius;
+	const bottomCurveStart = h - radius;
+	const commands = [
+		"M 0 0",
+		`A ${fmt(halfWidth)} ${fmt(radius)} 0 0 1 ${fmt(halfWidth)} ${fmt(radius)}`,
+		`L ${fmt(halfWidth)} ${fmt(upperStemEnd)}`,
+		`A ${fmt(halfWidth)} ${fmt(radius)} 0 0 0 ${fmt(w)} ${fmt(cusp)}`,
+		`A ${fmt(halfWidth)} ${fmt(radius)} 0 0 0 ${fmt(halfWidth)} ${fmt(lowerStemStart)}`,
+		`L ${fmt(halfWidth)} ${fmt(bottomCurveStart)}`,
+		`A ${fmt(halfWidth)} ${fmt(radius)} 0 0 1 0 ${fmt(h)}`
+	].join(" ");
+	return {
+		fill: `${commands} Z`,
+		outline: commands
+	};
+}
 /**
 * Build the `points` string for a polygon-based shape preset.
 *
@@ -209,7 +244,7 @@ function buildShapePolygonPoints(type, w, h) {
 * displays. The original `<a:prstGeom prst>` value round-trips through the
 * model regardless of what the renderer chooses to draw.
 */
-function createShapeElement(type, w, h) {
+function createShapeElement(type, w, h, adjustments) {
 	switch (type) {
 		case "ellipse":
 		case "oval": {
@@ -238,6 +273,19 @@ function createShapeElement(type, w, h) {
 			setNum(el, "y2", h / 2);
 			return el;
 		}
+		case "rightBrace": {
+			const paths = buildRightBracePaths(w, h, adjustments);
+			const group = document.createElementNS(SVG_NS, "g");
+			const fill = document.createElementNS(SVG_NS, "path");
+			fill.setAttribute("d", paths.fill);
+			fill.setAttribute("stroke", "none");
+			group.append(fill);
+			const outline = document.createElementNS(SVG_NS, "path");
+			outline.setAttribute("d", paths.outline);
+			outline.setAttribute("fill", "none");
+			group.append(outline);
+			return group;
+		}
 		default: {
 			const points = buildShapePolygonPoints(type, w, h);
 			if (points !== null) {
@@ -320,6 +368,7 @@ const ShapeExtension = createNodeExtension({
 		atom: true,
 		attrs: {
 			shapeType: { default: "rect" },
+			geometryAdjustments: { default: null },
 			shapeId: { default: null },
 			width: { default: 100 },
 			height: { default: 80 },
@@ -362,6 +411,7 @@ const ShapeExtension = createNodeExtension({
 				const outlineTailEnd = parseShapeLineEnd(d["outlineTailEnd"]);
 				return {
 					shapeType: d["shapeType"] || "rect",
+					...d["geometryAdjustments"] ? { geometryAdjustments: d["geometryAdjustments"] } : {},
 					...d["shapeId"] ? { shapeId: d["shapeId"] } : {},
 					...d["width"] ? { width: Number(d["width"]) } : {},
 					...d["height"] ? { height: Number(d["height"]) } : {},
@@ -403,6 +453,7 @@ const ShapeExtension = createNodeExtension({
 				class: "docx-shape",
 				"data-shape-type": attrs.shapeType || "rect"
 			};
+			if (attrs.geometryAdjustments) domAttrs["data-geometry-adjustments"] = attrs.geometryAdjustments;
 			if (attrs.shapeId) domAttrs["data-shape-id"] = attrs.shapeId;
 			domAttrs["data-width"] = String(w);
 			domAttrs["data-height"] = String(h);
@@ -489,7 +540,8 @@ const ShapeExtension = createNodeExtension({
 				defs.append(gradient);
 				svg.append(defs);
 			}
-			const shapeEl = createShapeElement(attrs.shapeType || "rect", w, h);
+			const geometryAdjustments = parseShapeGeometryAdjustments(attrs.geometryAdjustments) ?? [];
+			const shapeEl = createShapeElement(attrs.shapeType || "rect", w, h, geometryAdjustments);
 			const strokeDasharray = strokeDashArrayForOutlineStyle(attrs.outlineStyle);
 			if (strokeDasharray) shapeEl.setAttribute("stroke-dasharray", strokeDasharray);
 			svg.append(shapeEl);
@@ -501,4 +553,4 @@ const ShapeExtension = createNodeExtension({
 	}
 });
 //#endregion
-export { ShapeExtension, buildShapePolygonPoints, parseGradientStops, sanitizeColor, sanitizeShapeDimension, sanitizeSvgId, sanitizeTransform, strokeDashArrayForOutlineStyle };
+export { ShapeExtension, buildRightBracePaths, buildShapePolygonPoints, parseGradientStops, sanitizeColor, sanitizeShapeDimension, sanitizeSvgId, sanitizeTransform, strokeDashArrayForOutlineStyle };

package/dist/prosemirror/schema/nodes.d.ts

@@ -102,6 +102,8 @@ type ParagraphAttrs = {
   /** Numbering start override for this numId/level. */
   listStartOverride?: number;
   styleId?: string;
+  /** Imported built-in TOC entry level, resolved from the canonical style name. */
+  _tableOfContentsLevel?: number;
   borders?: {
     top?: document_d_exports.BorderSpec;
     bottom?: document_d_exports.BorderSpec;
@@ -275,6 +277,8 @@ type ImageAttrs = {
   hlinkRId?: string;
   /** Original OOXML for opaque/unsupported DOCX drawings. */
   _docxRawXml?: string;
+  /** Raw XML preserved without an editable image projection. */
+  _docxRawXmlMode?: document_d_exports.DrawingRawXmlMode;
   /** Embedded-object previews use their authored box as the exact line height. */
   _docxObjectPreview?: boolean;
 };
@@ -382,6 +386,8 @@ type BlockSdtAttrs = {
 type ShapeAttrs = {
   /** Shape type preset */
   shapeType?: string;
+  /** Preset geometry adjustments serialized as JSON. */
+  geometryAdjustments?: string;
   /** Unique identifier */
   shapeId?: string;
   /** Width in pixels */

package/dist/prosemirror/shapeGeometryAdjustments.d.ts

@@ -0,0 +1,5 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/prosemirror/shapeGeometryAdjustments.d.ts
+declare const parseShapeGeometryAdjustments: (raw: string | undefined) => document_d_exports.ShapeGeometryAdjustment[] | undefined;
+//#endregion
+export { parseShapeGeometryAdjustments };

package/dist/prosemirror/shapeGeometryAdjustments.js

@@ -0,0 +1,24 @@
+//#region src/prosemirror/shapeGeometryAdjustments.ts
+const MAX_ADJUSTMENT_COUNT = 32;
+const MAX_ADJUSTMENT_NAME_LENGTH = 64;
+const MAX_ADJUSTMENT_FORMULA_LENGTH = 128;
+const parseShapeGeometryAdjustments = (raw) => {
+	if (!raw) return;
+	try {
+		const parsed = JSON.parse(raw);
+		if (!Array.isArray(parsed) || parsed.length > MAX_ADJUSTMENT_COUNT) return;
+		const adjustments = [];
+		for (const item of parsed) {
+			if (typeof item !== "object" || item === null || !("name" in item) || typeof item.name !== "string" || item.name.length === 0 || item.name.length > MAX_ADJUSTMENT_NAME_LENGTH || !("formula" in item) || typeof item.formula !== "string" || item.formula.length === 0 || item.formula.length > MAX_ADJUSTMENT_FORMULA_LENGTH) return;
+			adjustments.push({
+				name: item.name,
+				formula: item.formula
+			});
+		}
+		return adjustments.length === 0 ? void 0 : adjustments;
+	} catch {
+		return;
+	}
+};
+//#endregion
+export { parseShapeGeometryAdjustments };

package/dist/prosemirror/styles/resolvedStyleAttrs.d.ts

@@ -1,13 +1,17 @@
 import { NumberingMap } from "../../docx/numberingParser.js";
 import { ResolvedParagraphStyle } from "./styleResolver.js";
 //#region src/prosemirror/styles/resolvedStyleAttrs.d.ts
+type ResolvedStyleIdentity = {
+  styleId: string;
+  styleName?: string;
+};
 /**
  * The paragraph attrs a style definition controls. Applying a style resets
  * every one of these to the style's value (or `null` to clear), so a prior
  * style's properties (e.g. a heading's spacing) never leak through. Returns
  * a partial attrs object to merge over the paragraph's existing attrs.
  */
-declare function paragraphAttrsFromResolvedStyle(resolved: ResolvedParagraphStyle): Record<string, unknown>;
+declare function paragraphAttrsFromResolvedStyle(resolved: ResolvedParagraphStyle, identity: ResolvedStyleIdentity): Record<string, unknown>;
 /**
  * The list attrs a style's `w:pPr/w:numPr` controls (numbering reference plus
  * the baked marker-rendering attrs that `toProseDoc` normally derives from

package/dist/prosemirror/styles/resolvedStyleAttrs.js

@@ -1,4 +1,5 @@
 import { computeListRendering } from "../../docx/numberingParser.js";
+import { tableOfContentsStyleLevel } from "../../utils/tableOfContentsStyle.js";
 import { setAutospacingBaseValue } from "../autospacingBase.js";
 //#region src/prosemirror/styles/resolvedStyleAttrs.ts
 /**
@@ -17,7 +18,7 @@ import { setAutospacingBaseValue } from "../autospacingBase.js";
 * style's properties (e.g. a heading's spacing) never leak through. Returns
 * a partial attrs object to merge over the paragraph's existing attrs.
 */
-function paragraphAttrsFromResolvedStyle(resolved) {
+function paragraphAttrsFromResolvedStyle(resolved, identity) {
 	const ppr = resolved.paragraphFormatting;
 	const runFormatting = resolved.runFormatting;
 	const hasRunFormatting = !!runFormatting && Object.keys(runFormatting).length > 0;
@@ -40,7 +41,8 @@ function paragraphAttrsFromResolvedStyle(resolved) {
 		outlineLevel: ppr?.outlineLevel ?? null,
 		borders: ppr?.borders ?? null,
 		defaultTextFormatting: hasRunFormatting ? runFormatting : null,
-		_autospacingBase: autospacingBaseFromResolvedParagraphFormatting(ppr)
+		_autospacingBase: autospacingBaseFromResolvedParagraphFormatting(ppr),
+		_tableOfContentsLevel: tableOfContentsStyleLevel(identity) ?? null
 	};
 }
 function autospacingBaseFromResolvedParagraphFormatting(ppr) {

package/dist/redline.js

@@ -3,6 +3,7 @@ import { createFolioAITextRangeHandle } from "./ai-edits/snapshot.js";
 import "./document-operations.js";
 import { pairFolioDocumentStories } from "./document-stories.js";
 import { resolveFolioDocumentPrivacyTransforms, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
+import { GenerateRedlineDocxOperationLimitError } from "./redlineOperationLimit.js";
 import { alignFolioBlocks } from "./version-comparison.js";
 import { TaggedError, panic } from "better-result";
 //#region src/redline.ts
@@ -71,11 +72,14 @@ const formattingSegments = (baseBlock, revisedBlock) => {
 		if (hasInlineFormatting(formatting)) {
 			const previous = segments.at(-1);
 			if (previous && previous.endOffset === textOffset && sameInlineFormatting(previous.formatting, formatting)) previous.endOffset += length;
-			else segments.push({
-				startOffset: textOffset,
-				endOffset: textOffset + length,
-				formatting
-			});
+			else {
+				if (segments.length >= 1e4) throw new GenerateRedlineDocxOperationLimitError({ message: "The document comparison exceeds the generated operation limit." });
+				segments.push({
+					startOffset: textOffset,
+					endOffset: textOffset + length,
+					formatting
+				});
+			}
 		}
 		textOffset += length;
 		baseRunOffset += length;
@@ -199,7 +203,10 @@ const generateRedlineDocx = async (base, revised, options = {}) => {
 	const skipped = [];
 	const unprocessedStories = [];
 	let operationSequence = 0;
-	const nextOperationId = () => `redline-${++operationSequence}`;
+	const nextOperationId = () => {
+		if (operationSequence >= 1e4) throw new GenerateRedlineDocxOperationLimitError({ message: "The document comparison exceeds the generated operation limit." });
+		return `redline-${++operationSequence}`;
+	};
 	for (const pair of pairFolioDocumentStories(baseStories, revisedStories)) {
 		if (!pair.baseStory) {
 			unprocessedStories.push({

package/dist/redlineOperationLimit.d.ts

@@ -0,0 +1,8 @@
+//#region src/redlineOperationLimit.d.ts
+declare const MAX_GENERATED_REDLINE_OPERATIONS = 10000;
+declare const GenerateRedlineDocxOperationLimitError_base: import("better-result").TaggedErrorClass<"GenerateRedlineDocxOperationLimitError">;
+declare class GenerateRedlineDocxOperationLimitError extends GenerateRedlineDocxOperationLimitError_base<{
+  message: string;
+}> {}
+//#endregion
+export { GenerateRedlineDocxOperationLimitError, MAX_GENERATED_REDLINE_OPERATIONS };

package/dist/redlineOperationLimit.js

@@ -0,0 +1,6 @@
+import { TaggedError } from "better-result";
+//#region src/redlineOperationLimit.ts
+const MAX_GENERATED_REDLINE_OPERATIONS = 1e4;
+var GenerateRedlineDocxOperationLimitError = class extends TaggedError("GenerateRedlineDocxOperationLimitError") {};
+//#endregion
+export { GenerateRedlineDocxOperationLimitError, MAX_GENERATED_REDLINE_OPERATIONS };

package/dist/server.d.ts

@@ -20,10 +20,10 @@ import { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLI
 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 { HEADING_LEVELS, HeadingLevel, InvalidFolioReportBuilderOptionsError, TableCellSpec, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table } from "./docx/server/build.js";
 import { BilingualBorders, BilingualParagraphRef, BilingualRow, BilingualRowKind, BilingualTableParagraphRef, CreateBilingualDocumentOptions, CreateBilingualDocumentResult, InvalidBilingualDocumentOptionsError, createBilingualDocument, readBilingualDocument } from "./docx/server/createBilingualDocument.js";
-import { CreateBilingualDocxResult, createBilingualDocx, readBilingualDocx } from "./docx/server/createBilingualDocx.js";
+import { CreateBilingualDocxOptions, CreateBilingualDocxResult, createBilingualDocx, readBilingualDocx } from "./docx/server/createBilingualDocx.js";
 import { docxToMarkdown } from "./docx/server/docxToMarkdown.js";
 import { DocxParagraphSource, DocxTableRowKind, DocxTableRowPosition, ExtractedDocxParagraph, ExtractedDocxTableCell, ExtractedDocxTableCellParagraph, 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 BilingualBorders, type BilingualParagraphRef, type BilingualRow, type BilingualRowKind, type BilingualTableParagraphRef, type CreateBilingualDocumentOptions, type CreateBilingualDocumentResult, type CreateBilingualDocxResult, 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 ExtractedDocxTableCell, type ExtractedDocxTableCellParagraph, 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, HEADING_LEVELS, type HeadingLevel, type InspectDocxPackageOptions, InvalidBilingualDocumentOptionsError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type ParseOptions, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, type TableCellSpec, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createBilingualDocument, createBilingualDocx, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };
+export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type BilingualBorders, type BilingualParagraphRef, type BilingualRow, type BilingualRowKind, type BilingualTableParagraphRef, type CreateBilingualDocumentOptions, type CreateBilingualDocumentResult, type CreateBilingualDocxOptions, type CreateBilingualDocxResult, 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 ExtractedDocxTableCell, type ExtractedDocxTableCellParagraph, 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, HEADING_LEVELS, type HeadingLevel, type InspectDocxPackageOptions, InvalidBilingualDocumentOptionsError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type ParseOptions, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, type TableCellSpec, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createBilingualDocument, createBilingualDocx, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };

package/dist/types/content.d.ts

@@ -1,2 +1,2 @@
-import { BlockContent, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DocumentBody, DrawingContent, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, VerticalAlign } from "@stll/docx-core/model";
-export type { BlockContent, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DocumentBody, DrawingContent, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, VerticalAlign };
+import { BlockContent, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DocumentBody, DrawingContent, DrawingRawXmlMode, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeGeometryAdjustment, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, VerticalAlign } from "@stll/docx-core/model";
+export type { BlockContent, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, ComplexField, Deletion, DocumentBody, DrawingContent, DrawingRawXmlMode, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PositionalTab, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeGeometryAdjustment, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, VerticalAlign };

package/dist/types/index.d.ts

@@ -16,6 +16,7 @@ type DocumentBody = document_d_exports.DocumentBody;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
 type DocxPackage = document_d_exports.DocxPackage;
 type DrawingContent = document_d_exports.DrawingContent;
+type DrawingRawXmlMode = document_d_exports.DrawingRawXmlMode;
 type EmphasisMark = document_d_exports.EmphasisMark;
 type Endnote = document_d_exports.Endnote;
 type EndnotePosition = document_d_exports.EndnotePosition;
@@ -72,6 +73,7 @@ type ShadingProperties = document_d_exports.ShadingProperties;
 type Shape = document_d_exports.Shape;
 type ShapeContent = document_d_exports.ShapeContent;
 type ShapeFill = document_d_exports.ShapeFill;
+type ShapeGeometryAdjustment = document_d_exports.ShapeGeometryAdjustment;
 type ShapeOutline = document_d_exports.ShapeOutline;
 type ShapeTextBody = document_d_exports.ShapeTextBody;
 type ShapeType = document_d_exports.ShapeType;
@@ -106,4 +108,4 @@ type ThemeFont = document_d_exports.ThemeFont;
 type ThemeFontScheme = document_d_exports.ThemeFontScheme;
 type UnderlineStyle = document_d_exports.UnderlineStyle;
 type VerticalAlign = document_d_exports.VerticalAlign;
-export type { AbstractNumbering, BlockContent, BookmarkEnd, BookmarkStart, BorderSpec, BreakContent, CellMargins, ColorValue, Column, ComplexField, ConditionalFormatStyle, DocDefaults, Document, DocumentBody, DocxConformanceClass, DocxPackage, DrawingContent, EmphasisMark, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FloatingTableProperties, FontInfo, FontTable, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InstrTextContent, LevelSuffix, LineNumberRestart, LineSpacingRule, ListLevel, ListRendering, MediaFile, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, NumberFormat, NumberingDefinitions, NumberingInstance, PageOrientation, Paragraph, ParagraphAlignment, ParagraphContent, ParagraphFormatting, PositionalTab, Relationship, RelationshipMap, RelationshipType, Run, RunContent, Section, SectionProperties, SectionStart, ShadingProperties, Shape, ShapeContent, ShapeFill, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, Style, StyleDefinitions, StyleType, SymbolContent, TabContent, TabLeader, TabStop, TabStopAlignment, Table, TableBorders, TableCell, TableCellFormatting, TableFormatting, TableLook, TableMeasurement, TableRow, TableRowFormatting, TableWidthType, TextBox, TextContent, TextEffect, TextFormatting, Theme, ThemeColorScheme, ThemeColorSlot, ThemeFont, ThemeFontScheme, UnderlineStyle, VerticalAlign };
+export type { AbstractNumbering, BlockContent, BookmarkEnd, BookmarkStart, BorderSpec, BreakContent, CellMargins, ColorValue, Column, ComplexField, ConditionalFormatStyle, DocDefaults, Document, DocumentBody, DocxConformanceClass, DocxPackage, DrawingContent, DrawingRawXmlMode, EmphasisMark, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FloatingTableProperties, FontInfo, FontTable, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InstrTextContent, LevelSuffix, LineNumberRestart, LineSpacingRule, ListLevel, ListRendering, MediaFile, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, NumberFormat, NumberingDefinitions, NumberingInstance, PageOrientation, Paragraph, ParagraphAlignment, ParagraphContent, ParagraphFormatting, PositionalTab, Relationship, RelationshipMap, RelationshipType, Run, RunContent, Section, SectionProperties, SectionStart, ShadingProperties, Shape, ShapeContent, ShapeFill, ShapeGeometryAdjustment, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, Style, StyleDefinitions, StyleType, SymbolContent, TabContent, TabLeader, TabStop, TabStopAlignment, Table, TableBorders, TableCell, TableCellFormatting, TableFormatting, TableLook, TableMeasurement, TableRow, TableRowFormatting, TableWidthType, TextBox, TextContent, TextEffect, TextFormatting, Theme, ThemeColorScheme, ThemeColorSlot, ThemeFont, ThemeFontScheme, UnderlineStyle, VerticalAlign };

package/dist/utils/tableOfContentsStyle.d.ts

@@ -0,0 +1,9 @@
+//#region src/utils/tableOfContentsStyle.d.ts
+type TableOfContentsStyleIdentity = {
+  styleId: string | undefined;
+  styleName?: string;
+};
+/** Resolve a built-in TOC entry style without relying on its localized style id. */
+declare const tableOfContentsStyleLevel: ({ styleId, styleName }: TableOfContentsStyleIdentity) => number | undefined;
+//#endregion
+export { tableOfContentsStyleLevel };

package/dist/utils/tableOfContentsStyle.js

@@ -0,0 +1,14 @@
+//#region src/utils/tableOfContentsStyle.ts
+const TABLE_OF_CONTENTS_STYLE_ID = /^TOC(?<level>\d*)$/iu;
+const TABLE_OF_CONTENTS_STYLE_NAME = /^toc\s+(?<level>\d+)$/iu;
+const parsedLevel = (match) => {
+	if (!match) return;
+	const rawLevel = match.groups?.["level"];
+	if (rawLevel === "") return 1;
+	const level = Number(rawLevel);
+	return Number.isSafeInteger(level) && level > 0 ? level : void 0;
+};
+/** Resolve a built-in TOC entry style without relying on its localized style id. */
+const tableOfContentsStyleLevel = ({ styleId, styleName }) => parsedLevel(TABLE_OF_CONTENTS_STYLE_ID.exec(styleId ?? "")) ?? parsedLevel(TABLE_OF_CONTENTS_STYLE_NAME.exec(styleName ?? ""));
+//#endregion
+export { tableOfContentsStyleLevel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.25.4",
+  "version": "0.26.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",
@@ -113,7 +113,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.17.0",
+    "@stll/docx-core": "^0.17.1",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": "^0.1.0",
     "better-result": "3.0.1",