@stll/folio-core 0.45.0 → 0.47.0

package/dist/docx/styleParser.js

@@ -1,341 +1,15 @@
-import { parseHorizontalScalePercent } from "../utils/horizontalScale.js";
 import { mergeParagraphFormatting } from "../utils/paragraphFormattingMerge.js";
 import { mergeStyleTextFormatting } from "../utils/textFormattingMerge.js";
 import { parseBorderSpec } from "./borderParser.js";
 import { resolveDefaultParagraphStyle } from "./defaultParagraphStyle.js";
-import { ConditionalStyleTypeSchema, EmphasisMarkSchema, FontHintSchema, FontThemeSchema, HighlightColorSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
+import { parseParagraphProperties } from "./paragraphProperties.js";
+import { ConditionalStyleTypeSchema, StyleTypeSchema, TableAlignmentSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextDirectionSchema, narrowEnum } from "./parserEnums.js";
+import { RUN_PROPERTY_OWNERS, parseRunProperties } from "./runParser.js";
 import { parseShading } from "./shadingParser.js";
+import { findChildAnySpelling } from "./strictNames.js";
 import { parseTableLook } from "./tableParser.js";
-import { resolveThemeFontRef } from "./themeParser.js";
-import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
+import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/styleParser.ts
-const findLastRunToggle = (rPr, localName) => findChildren(rPr, "w", localName).at(-1) ?? null;
-/**
-* Parse text formatting properties (w:rPr)
-*/
-function parseRunProperties(rPr, theme) {
-	if (!rPr) return;
-	const formatting = {};
-	const b = findLastRunToggle(rPr, "b");
-	if (b) formatting.bold = parseBooleanElement(b);
-	const bCs = findLastRunToggle(rPr, "bCs");
-	if (bCs) formatting.boldCs = parseBooleanElement(bCs);
-	const i = findLastRunToggle(rPr, "i");
-	if (i) formatting.italic = parseBooleanElement(i);
-	const iCs = findLastRunToggle(rPr, "iCs");
-	if (iCs) formatting.italicCs = parseBooleanElement(iCs);
-	const u = findChild(rPr, "w", "u");
-	if (u) {
-		const style = narrowEnum(getAttribute(u, "w", "val"), UnderlineStyleSchema);
-		if (style) {
-			formatting.underline = { style };
-			const colorVal = getAttribute(u, "w", "color");
-			const themeColor = getAttribute(u, "w", "themeColor");
-			if (colorVal || themeColor) formatting.underline.color = parseColorValue(colorVal, themeColor, getAttribute(u, "w", "themeTint"), getAttribute(u, "w", "themeShade"));
-		}
-	}
-	const strike = findLastRunToggle(rPr, "strike");
-	if (strike) formatting.strike = parseBooleanElement(strike);
-	const dstrike = findChild(rPr, "w", "dstrike");
-	if (dstrike) formatting.doubleStrike = parseBooleanElement(dstrike);
-	const vertAlign = findChild(rPr, "w", "vertAlign");
-	if (vertAlign) {
-		const val = getAttribute(vertAlign, "w", "val");
-		if (val === "superscript" || val === "subscript" || val === "baseline") formatting.vertAlign = val;
-	}
-	const smallCaps = findLastRunToggle(rPr, "smallCaps");
-	if (smallCaps) formatting.smallCaps = parseBooleanElement(smallCaps);
-	const caps = findLastRunToggle(rPr, "caps");
-	if (caps) formatting.allCaps = parseBooleanElement(caps);
-	const vanish = findLastRunToggle(rPr, "vanish");
-	if (vanish) formatting.hidden = parseBooleanElement(vanish);
-	const color = findChild(rPr, "w", "color");
-	if (color) formatting.color = parseColorValue(getAttribute(color, "w", "val"), getAttribute(color, "w", "themeColor"), getAttribute(color, "w", "themeTint"), getAttribute(color, "w", "themeShade"));
-	const highlight = findChild(rPr, "w", "highlight");
-	if (highlight) {
-		const val = narrowEnum(getAttribute(highlight, "w", "val"), HighlightColorSchema);
-		if (val) formatting.highlight = val;
-	}
-	const shd = findChild(rPr, "w", "shd");
-	if (shd) {
-		const shadingResult = parseShading(shd);
-		if (shadingResult) formatting.shading = shadingResult;
-	}
-	const sz = findChild(rPr, "w", "sz");
-	if (sz) {
-		const val = parseNumericAttribute(sz, "w", "val");
-		if (val !== void 0) formatting.fontSize = val;
-	}
-	const szCs = findChild(rPr, "w", "szCs");
-	if (szCs) {
-		const val = parseNumericAttribute(szCs, "w", "val");
-		if (val !== void 0) formatting.fontSizeCs = val;
-	}
-	const rFonts = findChild(rPr, "w", "rFonts");
-	if (rFonts) {
-		const fontFamily = {};
-		const ascii = getAttribute(rFonts, "w", "ascii");
-		if (ascii) fontFamily.ascii = ascii;
-		const hAnsi = getAttribute(rFonts, "w", "hAnsi");
-		if (hAnsi) fontFamily.hAnsi = hAnsi;
-		const eastAsia = getAttribute(rFonts, "w", "eastAsia");
-		if (eastAsia) fontFamily.eastAsia = eastAsia;
-		const csFont = getAttribute(rFonts, "w", "cs");
-		if (csFont) fontFamily.cs = csFont;
-		const hint = narrowEnum(getAttribute(rFonts, "w", "hint"), FontHintSchema);
-		if (hint) fontFamily.hint = hint;
-		const asciiTheme = narrowEnum(getAttribute(rFonts, "w", "asciiTheme"), FontThemeSchema);
-		if (asciiTheme) {
-			fontFamily.asciiTheme = asciiTheme;
-			if (theme && !fontFamily.ascii) {
-				const resolved = resolveThemeFontRef(theme, asciiTheme);
-				if (resolved) fontFamily.ascii = resolved;
-			}
-		}
-		const hAnsiTheme = narrowEnum(getAttribute(rFonts, "w", "hAnsiTheme"), FontThemeSchema);
-		if (hAnsiTheme) {
-			fontFamily.hAnsiTheme = hAnsiTheme;
-			if (theme && !fontFamily.hAnsi) {
-				const resolved = resolveThemeFontRef(theme, hAnsiTheme);
-				if (resolved) fontFamily.hAnsi = resolved;
-			}
-		}
-		const eastAsiaTheme = narrowEnum(getAttribute(rFonts, "w", "eastAsiaTheme"), FontThemeSchema);
-		if (eastAsiaTheme) {
-			fontFamily.eastAsiaTheme = eastAsiaTheme;
-			if (theme && !fontFamily.eastAsia) {
-				const resolved = resolveThemeFontRef(theme, eastAsiaTheme);
-				if (resolved) fontFamily.eastAsia = resolved;
-			}
-		}
-		const csTheme = narrowEnum(getAttribute(rFonts, "w", "cstheme"), FontThemeSchema);
-		if (csTheme) {
-			fontFamily.csTheme = csTheme;
-			if (theme && !fontFamily.cs) {
-				const resolved = resolveThemeFontRef(theme, csTheme);
-				if (resolved) fontFamily.cs = resolved;
-			}
-		}
-		formatting.fontFamily = fontFamily;
-	}
-	const lang = findChild(rPr, "w", "lang");
-	if (lang) {
-		const val = getAttribute(lang, "w", "val") || void 0;
-		const eastAsia = getAttribute(lang, "w", "eastAsia") || void 0;
-		const bidi = getAttribute(lang, "w", "bidi") || void 0;
-		if (val || eastAsia || bidi) formatting.language = {
-			...val ? { val } : {},
-			...eastAsia ? { eastAsia } : {},
-			...bidi ? { bidi } : {}
-		};
-	}
-	const spacing = findChild(rPr, "w", "spacing");
-	if (spacing) {
-		const val = parseNumericAttribute(spacing, "w", "val");
-		if (val !== void 0) formatting.spacing = val;
-	}
-	const position = findChild(rPr, "w", "position");
-	if (position) {
-		const val = parseNumericAttribute(position, "w", "val");
-		if (val !== void 0) formatting.position = val;
-	}
-	const w = findChild(rPr, "w", "w");
-	if (w) {
-		const val = parseHorizontalScalePercent(getAttribute(w, "w", "val"));
-		if (val !== void 0) formatting.scale = val;
-	}
-	const kern = findChild(rPr, "w", "kern");
-	if (kern) {
-		const val = parseNumericAttribute(kern, "w", "val");
-		if (val !== void 0) formatting.kerning = val;
-	}
-	const effect = findChild(rPr, "w", "effect");
-	if (effect) {
-		const val = narrowEnum(getAttribute(effect, "w", "val"), TextEffectSchema);
-		if (val) formatting.effect = val;
-	}
-	const em = findChild(rPr, "w", "em");
-	if (em) {
-		const val = narrowEnum(getAttribute(em, "w", "val"), EmphasisMarkSchema);
-		if (val) formatting.emphasisMark = val;
-	}
-	const emboss = findLastRunToggle(rPr, "emboss");
-	if (emboss) formatting.emboss = parseBooleanElement(emboss);
-	const imprint = findLastRunToggle(rPr, "imprint");
-	if (imprint) formatting.imprint = parseBooleanElement(imprint);
-	const outline = findLastRunToggle(rPr, "outline");
-	if (outline) formatting.outline = parseBooleanElement(outline);
-	const shadow = findLastRunToggle(rPr, "shadow");
-	if (shadow) formatting.shadow = parseBooleanElement(shadow);
-	const rtl = findChild(rPr, "w", "rtl");
-	if (rtl) formatting.rtl = parseBooleanElement(rtl);
-	const cs = findChild(rPr, "w", "cs");
-	if (cs) formatting.cs = parseBooleanElement(cs);
-	const rStyle = findChild(rPr, "w", "rStyle");
-	if (rStyle) {
-		const val = getAttribute(rStyle, "w", "val");
-		if (val) formatting.styleId = val;
-	}
-	return Object.keys(formatting).length > 0 ? formatting : void 0;
-}
-/**
-* Parse color value from attributes
-*/
-function parseColorValue(rgb, themeColor, themeTint, themeShade) {
-	const color = {};
-	if (rgb && rgb !== "auto") color.rgb = rgb;
-	else if (rgb === "auto") color.auto = true;
-	const validatedThemeColor = narrowEnum(themeColor, ThemeColorSlotSchema);
-	if (validatedThemeColor) color.themeColor = validatedThemeColor;
-	if (themeTint) color.themeTint = themeTint;
-	if (themeShade) color.themeShade = themeShade;
-	return color;
-}
-/**
-* Parse tab stops (w:tabs)
-*/
-function parseTabStops(tabs) {
-	if (!tabs) return;
-	const tabElements = findChildren(tabs, "w", "tab");
-	if (tabElements.length === 0) return;
-	const result = [];
-	for (const tab of tabElements) {
-		const pos = parseNumericAttribute(tab, "w", "pos");
-		const alignment = narrowEnum(getAttribute(tab, "w", "val"), TabStopAlignmentSchema);
-		if (pos !== void 0 && alignment) {
-			const tabStop = {
-				position: pos,
-				alignment
-			};
-			const leader = narrowEnum(getAttribute(tab, "w", "leader"), TabLeaderSchema);
-			if (leader && leader !== "none") tabStop.leader = leader;
-			result.push(tabStop);
-		}
-	}
-	return result.length > 0 ? result : void 0;
-}
-/**
-* Parse paragraph formatting properties (w:pPr)
-*/
-function parseParagraphProperties(pPr, theme) {
-	if (!pPr) return;
-	const formatting = {};
-	const jc = findChild(pPr, "w", "jc");
-	if (jc) {
-		const val = narrowEnum(getAttribute(jc, "w", "val"), ParagraphAlignmentSchema);
-		if (val) formatting.alignment = val;
-	}
-	const bidi = findChild(pPr, "w", "bidi");
-	if (bidi) formatting.bidi = parseBooleanElement(bidi);
-	const snapToGrid = findChild(pPr, "w", "snapToGrid");
-	if (snapToGrid) formatting.snapToGrid = parseBooleanElement(snapToGrid);
-	const spacing = findChild(pPr, "w", "spacing");
-	if (spacing) {
-		const before = parseNumericAttribute(spacing, "w", "before");
-		if (before !== void 0) formatting.spaceBefore = before;
-		const after = parseNumericAttribute(spacing, "w", "after");
-		if (after !== void 0) formatting.spaceAfter = after;
-		const line = parseNumericAttribute(spacing, "w", "line");
-		if (line !== void 0) formatting.lineSpacing = line;
-		const lineRule = narrowEnum(getAttribute(spacing, "w", "lineRule"), LineSpacingRuleSchema);
-		if (lineRule) formatting.lineSpacingRule = lineRule;
-		const beforeAutospacing = parseOnOffAttribute(spacing, "w", "beforeAutospacing");
-		if (beforeAutospacing !== void 0) formatting.beforeAutospacing = beforeAutospacing;
-		const afterAutospacing = parseOnOffAttribute(spacing, "w", "afterAutospacing");
-		if (afterAutospacing !== void 0) formatting.afterAutospacing = afterAutospacing;
-	}
-	const ind = findChild(pPr, "w", "ind");
-	if (ind) {
-		const left = parseNumericAttribute(ind, "w", "left");
-		if (left !== void 0) formatting.indentLeft = left;
-		const right = parseNumericAttribute(ind, "w", "right");
-		if (right !== void 0) formatting.indentRight = right;
-		const firstLine = parseNumericAttribute(ind, "w", "firstLine");
-		if (firstLine !== void 0) formatting.indentFirstLine = firstLine;
-		const hanging = parseNumericAttribute(ind, "w", "hanging");
-		if (hanging !== void 0) {
-			formatting.indentFirstLine = -hanging;
-			formatting.hangingIndent = true;
-		}
-	}
-	const pBdr = findChild(pPr, "w", "pBdr");
-	if (pBdr) {
-		const borders = {};
-		const top = parseBorderSpec(findChild(pBdr, "w", "top"));
-		if (top) borders.top = top;
-		const bottom = parseBorderSpec(findChild(pBdr, "w", "bottom"));
-		if (bottom) borders.bottom = bottom;
-		const left = parseBorderSpec(findChild(pBdr, "w", "left"));
-		if (left) borders.left = left;
-		const right = parseBorderSpec(findChild(pBdr, "w", "right"));
-		if (right) borders.right = right;
-		const between = parseBorderSpec(findChild(pBdr, "w", "between"));
-		if (between) borders.between = between;
-		const bar = parseBorderSpec(findChild(pBdr, "w", "bar"));
-		if (bar) borders.bar = bar;
-		if (Object.keys(borders).length > 0) formatting.borders = borders;
-	}
-	const shd = findChild(pPr, "w", "shd");
-	if (shd) {
-		const shadingResult = parseShading(shd);
-		if (shadingResult) formatting.shading = shadingResult;
-	}
-	const tabs = findChild(pPr, "w", "tabs");
-	if (tabs) {
-		const tabStops = parseTabStops(tabs);
-		if (tabStops) formatting.tabs = tabStops;
-	}
-	const keepNext = findChild(pPr, "w", "keepNext");
-	if (keepNext) formatting.keepNext = parseBooleanElement(keepNext);
-	const keepLines = findChild(pPr, "w", "keepLines");
-	if (keepLines) formatting.keepLines = parseBooleanElement(keepLines);
-	const widowControl = findChild(pPr, "w", "widowControl");
-	if (widowControl) formatting.widowControl = parseBooleanElement(widowControl);
-	const pageBreakBefore = findChild(pPr, "w", "pageBreakBefore");
-	if (pageBreakBefore) formatting.pageBreakBefore = parseBooleanElement(pageBreakBefore);
-	const contextualSpacing = findChild(pPr, "w", "contextualSpacing");
-	if (contextualSpacing) formatting.contextualSpacing = parseBooleanElement(contextualSpacing);
-	const numPr = findChild(pPr, "w", "numPr");
-	if (numPr) {
-		const numId = findChild(numPr, "w", "numId");
-		const ilvl = findChild(numPr, "w", "ilvl");
-		if (numId || ilvl) {
-			formatting.numPr = {};
-			if (numId) {
-				const val = parseNumericAttribute(numId, "w", "val");
-				if (val !== void 0) formatting.numPr.numId = val;
-			}
-			if (ilvl) {
-				const val = parseNumberingLevelAttribute(ilvl);
-				if (val !== void 0) formatting.numPr.ilvl = val;
-			}
-		}
-	}
-	const outlineLvl = findChild(pPr, "w", "outlineLvl");
-	if (outlineLvl) {
-		const val = parseNumericAttribute(outlineLvl, "w", "val");
-		if (val !== void 0) formatting.outlineLevel = val;
-	}
-	const pStyle = findChild(pPr, "w", "pStyle");
-	if (pStyle) {
-		const val = getAttribute(pStyle, "w", "val");
-		if (val) formatting.styleId = val;
-	}
-	const suppressLineNumbers = findChild(pPr, "w", "suppressLineNumbers");
-	if (suppressLineNumbers) formatting.suppressLineNumbers = parseBooleanElement(suppressLineNumbers);
-	const suppressAutoHyphens = findChild(pPr, "w", "suppressAutoHyphens");
-	if (suppressAutoHyphens) formatting.suppressAutoHyphens = parseBooleanElement(suppressAutoHyphens);
-	const kinsoku = findChild(pPr, "w", "kinsoku");
-	if (kinsoku) formatting.kinsoku = parseBooleanElement(kinsoku);
-	const overflowPunct = findChild(pPr, "w", "overflowPunct");
-	if (overflowPunct) formatting.overflowPunctuation = parseBooleanElement(overflowPunct);
-	const rPr = findChild(pPr, "w", "rPr");
-	if (rPr) {
-		const runProps = parseRunProperties(rPr, theme);
-		if (runProps) formatting.runProperties = runProps;
-	}
-	return Object.keys(formatting).length > 0 ? formatting : void 0;
-}
 /**
 * Parse table measurement (width/height with type)
 */
@@ -359,9 +33,9 @@ function parseTableBorders(tblBorders) {
 	if (top) borders.top = top;
 	const bottom = parseBorderSpec(findChild(tblBorders, "w", "bottom"));
 	if (bottom) borders.bottom = bottom;
-	const left = parseBorderSpec(findChild(tblBorders, "w", "left") ?? findChild(tblBorders, "w", "start"));
+	const left = parseBorderSpec(findChildAnySpelling(tblBorders, "CT_Border left"));
 	if (left) borders.left = left;
-	const right = parseBorderSpec(findChild(tblBorders, "w", "right") ?? findChild(tblBorders, "w", "end"));
+	const right = parseBorderSpec(findChildAnySpelling(tblBorders, "CT_Border right"));
 	if (right) borders.right = right;
 	const insideH = parseBorderSpec(findChild(tblBorders, "w", "insideH"));
 	if (insideH) borders.insideH = insideH;
@@ -389,9 +63,9 @@ function parseCellMargins(tblCellMar) {
 	if (top) margins.top = top;
 	const bottom = parseTableMeasurement(findChild(tblCellMar, "w", "bottom"));
 	if (bottom) margins.bottom = bottom;
-	const left = parseTableMeasurement(findChild(tblCellMar, "w", "left"));
+	const left = parseTableMeasurement(findChildAnySpelling(tblCellMar, "CT_TblWidth left"));
 	if (left) margins.left = left;
-	const right = parseTableMeasurement(findChild(tblCellMar, "w", "right"));
+	const right = parseTableMeasurement(findChildAnySpelling(tblCellMar, "CT_TblWidth right"));
 	if (right) margins.right = right;
 	return Object.keys(margins).length > 0 ? margins : void 0;
 }
@@ -406,11 +80,8 @@ function parseTableProperties(tblPr, _theme) {
 		const widthResult = parseTableMeasurement(tblW);
 		if (widthResult) formatting.width = widthResult;
 	}
-	const jc = findChild(tblPr, "w", "jc");
-	if (jc) {
-		const val = getAttribute(jc, "w", "val");
-		if (val === "left" || val === "center" || val === "right") formatting.justification = val;
-	}
+	const justification = narrowEnum(getAttribute(findChild(tblPr, "w", "jc"), "w", "val"), TableAlignmentSchema);
+	if (justification) formatting.justification = justification;
 	const tblCellSpacing = findChild(tblPr, "w", "tblCellSpacing");
 	if (tblCellSpacing) {
 		const cellSpacingResult = parseTableMeasurement(tblCellSpacing);
@@ -472,11 +143,8 @@ function parseTableRowProperties(trPr) {
 	if (tblHeader) formatting.header = parseBooleanElement(tblHeader);
 	const cantSplit = findChild(trPr, "w", "cantSplit");
 	if (cantSplit) formatting.cantSplit = parseBooleanElement(cantSplit);
-	const jc = findChild(trPr, "w", "jc");
-	if (jc) {
-		const val = getAttribute(jc, "w", "val");
-		if (val === "left" || val === "center" || val === "right") formatting.justification = val;
-	}
+	const justification = narrowEnum(getAttribute(findChild(trPr, "w", "jc"), "w", "val"), TableAlignmentSchema);
+	if (justification) formatting.justification = justification;
 	const hidden = findChild(trPr, "w", "hidden");
 	if (hidden) formatting.hidden = parseBooleanElement(hidden);
 	return Object.keys(formatting).length > 0 ? formatting : void 0;
@@ -514,7 +182,7 @@ function parseTableCellProperties(tcPr, _theme) {
 	}
 	const textDirection = findChild(tcPr, "w", "textDirection");
 	if (textDirection) {
-		const val = narrowEnum(getAttribute(textDirection, "w", "val"), TableCellTextDirectionSchema);
+		const val = narrowEnum(getAttribute(textDirection, "w", "val"), TextDirectionSchema);
 		if (val) formatting.textDirection = val;
 	}
 	const gridSpan = findChild(tcPr, "w", "gridSpan");
@@ -643,7 +311,7 @@ function parseStyle(styleEl, theme) {
 	}
 	const rPr = children.rPr;
 	if (rPr) {
-		const rPrResult = parseRunProperties(rPr, theme);
+		const rPrResult = parseRunProperties(rPr, theme, RUN_PROPERTY_OWNERS.standalone);
 		if (rPrResult) style.rPr = rPrResult;
 	}
 	const tblPr = children.tblPr;
@@ -675,7 +343,7 @@ function parseStyle(styleEl, theme) {
 				}
 				const condRPr = findChild(tblStylePr, "w", "rPr");
 				if (condRPr) {
-					const condRPrResult = parseRunProperties(condRPr, theme);
+					const condRPrResult = parseRunProperties(condRPr, theme, RUN_PROPERTY_OWNERS.standalone);
 					if (condRPrResult) conditionalStyle.rPr = condRPrResult;
 				}
 				const condTblPr = findChild(tblStylePr, "w", "tblPr");
@@ -709,7 +377,7 @@ function parseDocDefaults(docDefaults, theme) {
 	if (rPrDefault) {
 		const rPr = findChild(rPrDefault, "w", "rPr");
 		if (rPr) {
-			const rPrResult = parseRunProperties(rPr, theme);
+			const rPrResult = parseRunProperties(rPr, theme, RUN_PROPERTY_OWNERS.standalone);
 			if (rPrResult) result.rPr = rPrResult;
 		}
 	}

package/dist/docx/tableParser.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
-import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
+import { StyleMap } from "./styleParser.js";
 //#region src/docx/tableParser.d.ts
 /**
  * Sanity cap on `w:gridSpan` (and the derived table column count). Word's
@@ -58,6 +58,15 @@ declare function parseTableLook(lookElement: XmlElement | null): document_d_expo
  */
 declare function parseFloatingTableProperties(tblpPrElement: XmlElement | null): document_d_exports.FloatingTableProperties | undefined;
 declare function parseTableProperties(tblPrElement: XmlElement | null): document_d_exports.TableFormatting | undefined;
+/**
+ * Parse a row's table property exceptions (`w:tblPrEx`).
+ *
+ * The nine children are the table's own, read by the same handlers, so an
+ * exception and the property it overrides can never be read into two different
+ * shapes. `w:tblPrExChange` is a revision rather than a property and is read by
+ * {@link parseTablePropertyExceptionChanges}.
+ */
+declare function parseTablePropertyExceptions(tblPrExElement: XmlElement | null): document_d_exports.TablePropertyExceptionFormatting | undefined;
 /**
  * Parse table row properties (w:trPr)
  *
@@ -197,4 +206,4 @@ declare function getHeaderRows(table: document_d_exports.Table): document_d_expo
  */
 declare function isFloatingTable(table: document_d_exports.Table): boolean;
 //#endregion
-export { MAX_TABLE_COLUMNS, getHeaderRows, getTableColumnCount, getTableRowCount, getTableText, hasHeaderRow, isCellHorizontallyMerged, isCellMergeContinuation, isCellMergeStart, isFloatingTable, parseCellMargins, parseConditionalFormatStyle, parseFloatingTableProperties, parseTable, parseTableBorders, parseTableCell, parseTableCellProperties, parseTableGrid, parseTableLook, parseTableMeasurement, parseTableProperties, parseTableRow, parseTableRowProperties };
+export { MAX_TABLE_COLUMNS, getHeaderRows, getTableColumnCount, getTableRowCount, getTableText, hasHeaderRow, isCellHorizontallyMerged, isCellMergeContinuation, isCellMergeStart, isFloatingTable, parseCellMargins, parseConditionalFormatStyle, parseFloatingTableProperties, parseTable, parseTableBorders, parseTableCell, parseTableCellProperties, parseTableGrid, parseTableLook, parseTableMeasurement, parseTableProperties, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };