@stll/folio-core 0.43.0 → 0.44.0

package/dist/docx/xmlParser.js

@@ -1,7 +1,8 @@
-import { transitionalSlotEncoding } from "./transitionalSpelling.js";
+import { NUMBERS_PER_PERCENT, percentageSpelling, transitionalSlotEncoding } from "./transitionalSpelling.js";
 import { universalMeasureAs } from "./universalMeasure.js";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 import { OOXML_NS } from "@stll/docx-utils";
+import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 //#region src/docx/xmlParser.ts
 /**
 * XML Parser Utilities for OOXML
@@ -481,17 +482,19 @@ function getTextContent(element) {
 	return text;
 }
 /**
-* Check if an element has a specific attribute with value "true" or "1"
+* Read an `ST_OnOff` attribute.
 *
-* @param element - Element to check
-* @param namespace - Attribute namespace
-* @param name - Attribute name
-* @returns true if attribute exists and is truthy
+* The type has three spellings per polarity — `1`/`true`/`on` and
+* `0`/`false`/`off` — and producers use all of them. `undefined` means the
+* author said nothing (absent, or a value outside the type), so the caller
+* still owns what absence means for its own slot.
+*
+* Every on/off attribute goes through here: a hand-rolled `=== "1"` reads
+* `w:beforeAutospacing="on"` as false, and the save path then writes `"0"`,
+* inverting what the document said.
 */
-function hasFlag(element, namespace, name) {
-	const value = getAttribute(element, namespace, name);
-	if (value === null) return false;
-	return parseOnOffValue(value) ?? true;
+function parseOnOffAttribute(element, namespace, name, context) {
+	return parseOnOffValue(getAttribute(element, namespace, name), context, element?.name ?? name);
 }
 /**
 * Check if a child element exists (used for boolean flags in OOXML)
@@ -554,17 +557,19 @@ function parseNumberingLevelAttribute(element) {
 	return level !== void 0 && level >= 0 ? level : void 0;
 }
 /**
-* Parse `w:w` on a table width/height element. For `w:type="pct"`, producers
-* sometimes emit human-readable percentages (`100%`) instead of 50ths-of-percent
-* (`5000`); normalize those to the ECMA-376 unit the layout engine expects.
+* Parse `w:w` on a table width/height element. A percentage may be spelled the
+* way it reads (`100%`) or as the number its slot counts in
+* (50ths-of-percent, `5000`); the generated slot table says which unit that
+* is, so the two spellings are not decided here.
 */
 function parseTableMeasurementValue(element, widthType) {
 	const raw = getAttribute(element, "w", "w");
 	if (raw === null) return;
 	const trimmed = raw.trim();
-	if (widthType === "pct" && trimmed.endsWith("%")) {
-		const pct = Number.parseFloat(trimmed.slice(0, -1));
-		if (!Number.isNaN(pct)) return Math.round(pct * 50);
+	if (widthType === "pct") {
+		const percent = percentageSpelling(trimmed);
+		const unit = element === null || element === void 0 ? void 0 : transitionalSlotEncoding(element.namespaceUri, getLocalName(element.name), "w")?.percent;
+		if (percent !== void 0 && unit !== void 0) return Math.round(percent * NUMBERS_PER_PERCENT[unit]);
 	}
 	const measure = universalMeasureAs(trimmed, "twips");
 	if (measure !== void 0) return measure;
@@ -573,8 +578,12 @@ function parseTableMeasurementValue(element, widthType) {
 }
 /**
 * Parse an OOXML `ST_OnOff` lexical value.
+*
+* `context` is optional and trailing on purpose: every call site that has one
+* reports the value folio declined to read, and the hundred that do not yet
+* thread one keep compiling and keep their behaviour.
 */
-function parseOnOffValue(value) {
+function parseOnOffValue(value, context, element) {
 	if (value === null || value === void 0) return;
 	switch (value) {
 		case "1":
@@ -583,7 +592,13 @@ function parseOnOffValue(value) {
 		case "0":
 		case "false":
 		case "off": return false;
-		default: return;
+		default:
+			context?.warn({
+				code: PARSE_WARNING_CODES.unrecognisedOnOffValue,
+				value,
+				...element === void 0 ? {} : { element }
+			});
+			return;
 	}
 }
 /**
@@ -598,7 +613,7 @@ function parseOnOffValue(value) {
 * @param namespace - Namespace for val attribute
 * @returns boolean value
 */
-function parseBooleanElement(element, namespace = "w") {
+function parseBooleanElement(element, namespace = "w", context) {
 	if (!element) return false;
 	let val = null;
 	const elementName = element.name ?? "";
@@ -613,7 +628,7 @@ function parseBooleanElement(element, namespace = "w") {
 		}
 	}
 	if (val === null) return true;
-	return parseOnOffValue(val) ?? true;
+	return parseOnOffValue(val, context, elementName) ?? false;
 }
 /**
 * Deep find - search recursively for an element
@@ -810,4 +825,4 @@ function cloneElement(element, overrides) {
 	return clone;
 }
 //#endregion
-export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, selectAlternateContentBranch };
+export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, selectAlternateContentBranch };

package/dist/internal/pageBreakRunSourceDescendantIndex.js

@@ -59,7 +59,8 @@ const buildPageBreakRunSourceDescendantIndex = (rootContent) => {
 				case "deletion":
 				case "moveFrom":
 				case "moveTo":
-				case "inlineSdt": return inspectMany(content.content, inspectParagraphContent);
+				case "inlineSdt":
+				case "bidiWrapper": return inspectMany(content.content, inspectParagraphContent);
 				case "simpleField": {
 					const fieldResultFlags = inspectMany(content.content, inspectParagraphContent);
 					if (hasFlag(fieldResultFlags, SOURCE_FLAGS.paragraphPageBreak) && hasFlag(fieldResultFlags, SOURCE_FLAGS.paragraphTextBoxShape)) return fieldResultFlags | SOURCE_FLAGS.pageBreakSharesTextBoxShape;

package/dist/internal/paragraphFormattingSerialization.d.ts

@@ -1,9 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/internal/paragraphFormattingSerialization.d.ts
-type ExhaustiveFields<Source, Classified extends keyof Source> = Exclude<keyof Source, Classified> extends never ? Source : never;
 type ParagraphNumberingReference = document_d_exports.ParagraphFormatting["numPr"] | null;
-type ClassifiedParagraphFormattingField = "alignment" | "bidi" | "kinsoku" | "overflowPunctuation" | "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "snapToGrid" | "beforeAutospacing" | "afterAutospacing" | "spacingExplicit" | "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent" | "borders" | "shading" | "tabs" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "contextualSpacing" | "numPr" | "numPrFromStyle" | "outlineLevel" | "styleId" | "frame" | "suppressLineNumbers" | "suppressAutoHyphens" | "runProperties" | "runInWithNext";
-type ExhaustiveParagraphFormatting = ExhaustiveFields<document_d_exports.ParagraphFormatting, ClassifiedParagraphFormattingField>;
+type ClassifiedParagraphFormattingField = "alignment" | "bidi" | "kinsoku" | "overflowPunctuation" | "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "snapToGrid" | "beforeAutospacing" | "afterAutospacing" | "spacingExplicit" | "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent" | "borders" | "shading" | "tabs" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "contextualSpacing" | "numPr" | "numPrFromStyle" | "numberingChangeXml" | "outlineLevel" | "styleId" | "frame" | "suppressLineNumbers" | "suppressAutoHyphens" | "runProperties" | "runInWithNext";
+type ExhaustiveParagraphFormatting = document_d_exports.ExhaustiveFields<document_d_exports.ParagraphFormatting, ClassifiedParagraphFormattingField>;
 /** Compare numbering references by their emitted id and effective level. */
 declare const paragraphNumberingReferencesEqual: (left: ParagraphNumberingReference, right: ParagraphNumberingReference) => boolean;
 /** Compare the authored `w:numPr` attributes, including an absent `w:ilvl`. */

package/dist/internal/paragraphFormattingSerialization.js

@@ -1,6 +1,8 @@
 import { serializeBorder } from "../docx/serializer/borderSerializer.js";
 import { serializeShading, serializeTextFormatting } from "../docx/serializer/textFormattingSerializer.js";
 import { escapeXml, intAttr } from "../docx/serializer/xmlUtils.js";
+import { sanitizeCapturedXmlElement } from "../docx/verbatimCapture.js";
+import { NAMESPACES, OOXML_NAMESPACE_SCOPE } from "../docx/xmlParser.js";
 //#region src/internal/paragraphFormattingSerialization.ts
 const modelParagraphNumberingReference = (reference) => {
 	if (!reference) return null;
@@ -74,14 +76,32 @@ const serializeIndentation = (formatting) => {
 	}
 	return attrs.length === 0 ? "" : `<w:ind ${attrs.join(" ")}/>`;
 };
-const serializeNumbering = (numPr) => {
+/**
+* `w:numPr`, with the tracked record of the numbering it replaced.
+*
+* `w:numberingChange` is the revision a reviewer's numbering change left
+* behind. It is history: nothing in the model derives it, and a rebuilt
+* `w:numPr` that drops it discards the revision silently. It is written even
+* when the paragraph's own numbering reference is gone, because a change
+* record with nothing left to describe is still a record — the schema declares
+* it last in `CT_NumPr`, after `w:ilvl` and `w:numId`.
+*/
+const serializeNumbering = (numPr, numberingChangeXml) => {
 	const modeled = modelParagraphNumberingReference(numPr ?? null);
-	if (!modeled) return "";
 	const parts = [];
-	if (modeled.ilvl !== void 0) parts.push(`<w:ilvl w:val="${intAttr(modeled.ilvl)}"/>`);
-	if (modeled.numId !== void 0) parts.push(`<w:numId w:val="${intAttr(modeled.numId)}"/>`);
+	if (modeled?.ilvl !== void 0) parts.push(`<w:ilvl w:val="${intAttr(modeled.ilvl)}"/>`);
+	if (modeled?.numId !== void 0) parts.push(`<w:numId w:val="${intAttr(modeled.numId)}"/>`);
+	const change = replayableNumberingChangeXml(numberingChangeXml);
+	if (change !== null) parts.push(change);
 	return parts.length === 0 ? "" : `<w:numPr>${parts.join("")}</w:numPr>`;
 };
+const NUMBERING_CHANGE_ROOT_NAME = /* @__PURE__ */ new Set(["numberingChange"]);
+const WORDPROCESSINGML_NAMESPACE = /* @__PURE__ */ new Set([NAMESPACES.w]);
+const replayableNumberingChangeXml = (numberingChangeXml) => sanitizeCapturedXmlElement(numberingChangeXml, {
+	allowedLocalNames: NUMBERING_CHANGE_ROOT_NAME,
+	allowedNamespaceUris: WORDPROCESSINGML_NAMESPACE,
+	inheritedNamespaceScope: OOXML_NAMESPACE_SCOPE
+});
 const serializeFrameProperties = (frame) => {
 	if (!frame) return "";
 	const { dropCap, lines, width, height, hSpace, vSpace, hAnchor, vAnchor, x, y, xAlign, yAlign, wrap } = frame;
@@ -117,7 +137,7 @@ const extractRunPropertiesInnerXml = (runPropertiesXml) => {
 */
 const modelParagraphFormattingEmission = (input) => {
 	if (!input) return {};
-	const { alignment, bidi, kinsoku, overflowPunctuation, spaceBefore, spaceAfter, lineSpacing, lineSpacingRule, snapToGrid, beforeAutospacing, afterAutospacing, spacingExplicit, indentLeft, indentRight, indentFirstLine, hangingIndent, borders, shading, tabs, keepNext, keepLines, widowControl, pageBreakBefore, contextualSpacing, numPr, numPrFromStyle, outlineLevel, styleId, frame, suppressLineNumbers, suppressAutoHyphens, runProperties, runInWithNext } = input;
+	const { alignment, bidi, kinsoku, overflowPunctuation, spaceBefore, spaceAfter, lineSpacing, lineSpacingRule, snapToGrid, beforeAutospacing, afterAutospacing, spacingExplicit, indentLeft, indentRight, indentFirstLine, hangingIndent, borders, shading, tabs, keepNext, keepLines, widowControl, pageBreakBefore, contextualSpacing, numPr, numPrFromStyle, numberingChangeXml, outlineLevel, styleId, frame, suppressLineNumbers, suppressAutoHyphens, runProperties, runInWithNext } = input;
 	modelSpacingProvenance(spacingExplicit);
 	const propertiesXml = [
 		styleId ? `<w:pStyle w:val="${escapeXml(styleId)}"/>` : "",
@@ -126,7 +146,7 @@ const modelParagraphFormattingEmission = (input) => {
 		serializeToggle("pageBreakBefore", pageBreakBefore),
 		serializeFrameProperties(frame),
 		serializeToggle("widowControl", widowControl),
-		isStyleSourcedParagraphNumbering(numPr, numPrFromStyle) ? "" : serializeNumbering(numPr),
+		isStyleSourcedParagraphNumbering(numPr, numPrFromStyle) ? serializeNumbering(void 0, numberingChangeXml) : serializeNumbering(numPr, numberingChangeXml),
 		serializeToggle("suppressLineNumbers", suppressLineNumbers),
 		serializeParagraphBorders(borders),
 		serializeShading(shading),

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

@@ -1,6 +1,6 @@
 import { measureParagraph } from "../../layout-engine/measure/measureParagraph.js";
 import { layoutTextBoxContent } from "../../layout-engine/measure/textBoxParagraphLayout.js";
-import { DEFAULT_TEXTBOX_MARGINS, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, isFloatingImageRun } from "../../layout-engine/types.js";
+import { DEFAULT_TEXTBOX_MARGINS, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, isFloatingImageRun, resolveTableWidthPx } from "../../layout-engine/types.js";
 import { footnoteToProseDoc } from "../../prosemirror/conversion/toProseDoc.js";
 import { toFlowBlocks } from "./toFlowBlocks.js";
 //#region src/layout-bridge/convert/footnoteLayout.ts
@@ -264,14 +264,9 @@ function measureFootnoteBlock(block, contentWidth) {
 		default: return block;
 	}
 }
-function resolveFootnoteTableWidth(width, widthType, contentWidth) {
-	if (!width) return;
-	if (widthType === "pct") return contentWidth * width / 5e3;
-	if (widthType === "dxa" || !widthType || widthType === "auto") return width / 1440 * 96;
-}
 function measureFootnoteTable(tableBlock, contentWidth) {
 	let columnWidths = tableBlock.columnWidths ?? [];
-	const explicitWidth = resolveFootnoteTableWidth(tableBlock.width, tableBlock.widthType, contentWidth);
+	const explicitWidth = resolveTableWidthPx(tableBlock.width, tableBlock.widthType, contentWidth);
 	if (columnWidths.length === 0) {
 		const firstRow = tableBlock.rows.at(0);
 		let colCount = 0;

package/dist/layout-engine/index.d.ts

@@ -1,4 +1,4 @@
-import { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned } from "./types.js";
+import { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned } from "./types.js";
 import { PageState, Paginator, PaginatorOptions, createPaginator } from "./paginator.js";
 import { KeepNextChain, calculateChainHeight, computeKeepNextChains, getMidChainIndices, hasKeepLines, hasPageBreakBefore } from "./keep-together.js";
 import { resolveSectionHeaderFooterRefs } from "./headerFooterRefs.js";
@@ -42,4 +42,4 @@ declare function layoutDocument(blocks: FlowBlock[], measures: Measure[], option
  */
 declare function getHeaderRowsHeight(measure: TableMeasure, headerRowCount: number): number;
 //#endregion
-export { BlockId, BorderStyle, type BreakDecision, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, type KeepNextChain, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, SectionPageNumbering, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, scheduleSectionBreak, tableColumnsArePinned };
+export { BlockId, BorderStyle, type BreakDecision, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, type KeepNextChain, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, SectionPageNumbering, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, resolveTableWidthPx, scheduleSectionBreak, tableColumnsArePinned };

package/dist/layout-engine/index.js

@@ -14,7 +14,7 @@ import { applyPendingToActive, createInitialSectionState, getEffectiveColumns, g
 import { applySectionVerticalAlignment } from "./sectionVerticalAlignment.js";
 import { buildTableRowBreakInfo, getRowContinuationSkip, snapRowBreak } from "./tableRowBreak.js";
 import { bandFragmentX, bandTopContentY, isPageFrameRelativeAnchor } from "./textBoxFlow.js";
-import { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned } from "./types.js";
+import { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned } from "./types.js";
 import { panic } from "better-result";
 //#region src/layout-engine/index.ts
 /**
@@ -1036,4 +1036,4 @@ function handleSectionBreak(_block, paginator, nextSectionConfig, nextSectionTyp
 	paginator.updateColumns(nextSectionConfig.columns ?? DEFAULT_COLUMNS);
 }
 //#endregion
-export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, scheduleSectionBreak, tableColumnsArePinned };
+export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, resolveTableWidthPx, scheduleSectionBreak, tableColumnsArePinned };

package/dist/layout-engine/measure/measureBlocks.js

@@ -4,7 +4,7 @@ import { isParagraphFrameTextBox } from "../paragraphFrame.js";
 import { normalizeSectionBreakType } from "../section-breaks.js";
 import { bandFragmentX, bandTopContentY, isPageFrameRelativeAnchor } from "../textBoxFlow.js";
 import { getTextBoxGroupId } from "../textBoxGroup.js";
-import { DEFAULT_TEXTBOX_MARGINS, floatingTextBoxReservesBand, floatingTextBoxWrapsText, resolveTableCellPadding, tableColumnsArePinned } from "../types.js";
+import { DEFAULT_TEXTBOX_MARGINS, floatingTextBoxReservesBand, floatingTextBoxWrapsText, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned } from "../types.js";
 import { getCachedParagraphMeasure, setCachedParagraphMeasure } from "./cache.js";
 import { resolveFloatingTablePageX } from "./floatingTablePosition.js";
 import { findClearLineY, measureParagraph } from "./measureParagraph.js";
@@ -59,11 +59,6 @@ function emuToPixels(emu) {
 	if (emu === void 0) return 0;
 	return Math.round(emu * 96 / 914400);
 }
-function resolveTableWidthPx(width, widthType, contentWidth) {
-	if (!width) return;
-	if (widthType === "pct") return contentWidth * width / 5e3;
-	if (widthType === "dxa" || !widthType || widthType === "auto") return Math.round(width / 20 * 1.333);
-}
 function measureTableBlock(tableBlock, contentWidth, fieldValues) {
 	let columnWidths = tableBlock.columnWidths ?? [];
 	const explicitWidthPx = resolveTableWidthPx(tableBlock.width, tableBlock.widthType, contentWidth);

package/dist/layout-engine/types.d.ts

@@ -1,7 +1,7 @@
 import { OutlineStyleAttr } from "../types/documentEnumValues.js";
 import { ImagePosition, ImageWrap, NumberFormat, SdtProperties, SdtType, ShapeTextBody, TableCellFormatting, TableWidthType, VerticalAlign } from "@stll/docx-core/model";
 declare namespace types_d_exports {
-  export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned };
+  export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned };
 }
 /**
  * Unique identifier for a block in the document.
@@ -1429,7 +1429,13 @@ declare function floatingTextBoxReservesBand(block: TextBoxFlowAttrs): boolean;
  * and the painter both consult this so their line count and `white-space` agree.
  */
 declare function tableColumnsArePinned(table: TableBlock): boolean;
+/**
+ * Resolve a `w:tblW`/`w:tcW` pair to pixels. The single reader: measurement and
+ * the footnote layout bridge both go through it so a table cannot be pinned in
+ * one and autofitted in the other.
+ */
+declare function resolveTableWidthPx(width: number | undefined, widthType: TableWidthType | undefined, containerWidth: number): number | undefined;
 /** Return the leading visual offset for a row with omitted grid columns. */
 declare const getTableRowLeadingWidth: (row: TableRow, columnWidths: readonly number[]) => number;
 //#endregion
-export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned, types_d_exports };
+export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned, types_d_exports };

package/dist/layout-engine/types.js

@@ -14,6 +14,7 @@ var types_exports = /* @__PURE__ */ __exportAll({
 	isFloatingTextBoxBlock: () => isFloatingTextBoxBlock,
 	isTextWrappingFloatingImageRun: () => isTextWrappingFloatingImageRun,
 	resolveTableCellPadding: () => resolveTableCellPadding,
+	resolveTableWidthPx: () => resolveTableWidthPx,
 	tableColumnsArePinned: () => tableColumnsArePinned
 });
 const DEFAULT_TABLE_CELL_PADDING = {
@@ -129,7 +130,39 @@ function floatingTextBoxReservesBand(block) {
 */
 function tableColumnsArePinned(table) {
 	if (table.layout === "fixed") return true;
-	return table.widthType === "dxa" || table.widthType === "pct";
+	return hasMeasuredTableWidth(table.widthType);
+}
+/**
+* Whether `w:tblW`/`w:tcW`'s `w:w` is a measurement at all.
+*
+* Under `w:type="auto"` or `"nil"` (§17.18.87) the number is meaningless:
+* `auto` asks the consumer to size the table to its content and `nil` declares
+* no width, so both ignore `w:w` entirely. Word still writes a leftover value
+* there, and reading it as twips pins a table that should autofit.
+*/
+function hasMeasuredTableWidth(widthType) {
+	switch (widthType) {
+		case "dxa":
+		case "pct": return true;
+		case "auto":
+		case "nil":
+		case void 0: return false;
+		default: return widthType;
+	}
+}
+const TWIPS_PER_INCH = 1440;
+const PIXELS_PER_INCH = 96;
+/** `w:type="pct"` measures in fiftieths of a percent, so 5000 is 100 %. */
+const PERCENT_DENOMINATOR = 5e3;
+/**
+* Resolve a `w:tblW`/`w:tcW` pair to pixels. The single reader: measurement and
+* the footnote layout bridge both go through it so a table cannot be pinned in
+* one and autofitted in the other.
+*/
+function resolveTableWidthPx(width, widthType, containerWidth) {
+	if (width === void 0 || width <= 0 || !hasMeasuredTableWidth(widthType)) return;
+	if (widthType === "pct") return width / PERCENT_DENOMINATOR * containerWidth;
+	return width / TWIPS_PER_INCH * PIXELS_PER_INCH;
 }
 const tableRowOwnsNestedGrid = (row) => {
 	const cell = row.cells.length === 1 ? row.cells.at(0) : void 0;
@@ -142,4 +175,4 @@ const getTableRowLeadingWidth = (row, columnWidths) => {
 	return columnWidths.slice(0, row.gridBefore ?? 0).reduce((sum, columnWidth) => sum + columnWidth, 0);
 };
 //#endregion
-export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned, types_exports };
+export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned, types_exports };

package/dist/markdown/index.js

@@ -19,7 +19,7 @@ function toMarkdownResult(doc, opts) {
 	return renderDocument(doc, opts);
 }
 function renderDocument(doc, opts = {}) {
-	const ctx = newContext(opts);
+	const ctx = newContext(opts, doc.package.styles);
 	const markdown = appendTrailers(ctx, doc, renderBlocks(ctx, doc.package, doc.package.document.content));
 	if (doc.warnings) ctx.warnings.unshift(...doc.warnings);
 	if (!markdown.trim()) ctx.warnings.push("document has no content");

package/dist/markdown/internals.d.ts

@@ -1,10 +1,15 @@
+import { document_d_exports } from "../types/document.js";
 import { MarkdownOptions, RenderContext } from "./types.js";
 //#region src/markdown/internals.d.ts
 /**
  * Build a fresh `RenderContext` from caller options, applying defaults. The
  * `footnotes` default is `"keep"` (folio addition over upstream #595).
+ *
+ * The document's styles are indexed once here: every paragraph asks the index
+ * whether it is a heading or a quote, so rebuilding it per paragraph would
+ * make the render quadratic.
  */
-declare function newContext(opts?: MarkdownOptions): RenderContext;
+declare function newContext(opts?: MarkdownOptions, styles?: document_d_exports.StyleDefinitions | undefined): RenderContext;
 /**
  * Push a warning into the context, deduplicating against existing entries so
  * recurring messages appear at most once.

package/dist/markdown/internals.js

@@ -1,10 +1,23 @@
+import { createBuiltInStyleIndex } from "../docx/builtInStyles.js";
 //#region src/markdown/internals.ts
 /**
+* Internal helpers shared by the markdown converter: context construction and
+* warning dedupe. Kept free of renderer imports so the renderers can import
+* `pushWarning` without forming an import cycle (trailer emission, which needs
+* `renderBlock`, lives in `trailers.ts`). Ported from eigenpal/docx-editor
+* PR #595, trimmed to the sync continuous path.
+*/
+/**
 * Build a fresh `RenderContext` from caller options, applying defaults. The
 * `footnotes` default is `"keep"` (folio addition over upstream #595).
+*
+* The document's styles are indexed once here: every paragraph asks the index
+* whether it is a heading or a quote, so rebuilding it per paragraph would
+* make the render quadratic.
 */
-function newContext(opts = {}) {
+function newContext(opts = {}, styles) {
 	return {
+		builtInStyles: createBuiltInStyleIndex(styles?.styles ?? [], styles?.docDefaults),
 		opts: {
 			annotations: opts.annotations ?? "html",
 			trackedChanges: opts.trackedChanges ?? "annotate",

package/dist/markdown/renderBlock.js

@@ -1,8 +1,14 @@
 import { cloneParagraphWithoutPropertySource } from "../docx/paragraphPropertySource.js";
 import { renderParagraph } from "./renderParagraph.js";
 import { renderTable } from "./renderTable.js";
+import { panic } from "better-result";
 //#region src/markdown/renderBlock.ts
 /**
+* Block-level dispatcher. Walks `BlockContent[]` and joins the rendered
+* markdown for each block, suppressing redundant blank lines between list items
+* of the same list. Ported from eigenpal/docx-editor PR #595.
+*/
+/**
 * In `trackedChanges: "clean"` mode every change is accepted. A paragraph whose
 * end-of-paragraph mark is a pending deletion (`pPrMark.kind === "del"`) loses
 * its break on accept and merges with the following paragraph. Word's join
@@ -34,30 +40,38 @@ function renderBlocks(ctx, pkg, blocks) {
 	const out = [];
 	let prevWasListItem = false;
 	const ordered = ctx.opts.trackedChanges === "clean" ? mergeAcceptedParagraphBreaks(blocks) : blocks;
-	for (const block of ordered) if (block.type === "paragraph") {
-		const isListItem = !!block.listRendering && !block.listRendering.markerHidden;
-		const md = renderParagraph(ctx, pkg, block);
-		if (!md) {
-			prevWasListItem = false;
-			continue;
+	for (const block of ordered) switch (block.type) {
+		case "paragraph": {
+			const isListItem = !!block.listRendering && !block.listRendering.markerHidden;
+			const md = renderParagraph(ctx, pkg, block);
+			if (!md) {
+				prevWasListItem = false;
+				continue;
+			}
+			if (isListItem && prevWasListItem) out.push(md);
+			else if (out.length) out.push("", md);
+			else out.push(md);
+			prevWasListItem = isListItem;
+			break;
 		}
-		if (isListItem && prevWasListItem) out.push(md);
-		else if (out.length) out.push("", md);
-		else out.push(md);
-		prevWasListItem = isListItem;
-	} else if (block.type === "table") {
-		const md = renderTable(ctx, pkg, block);
-		if (md) {
-			if (out.length) out.push("");
-			out.push(md);
+		case "table": {
+			const md = renderTable(ctx, pkg, block);
+			if (md) {
+				if (out.length) out.push("");
+				out.push(md);
+			}
+			prevWasListItem = false;
+			break;
 		}
-		prevWasListItem = false;
-	} else {
-		const nested = renderBlocks(ctx, pkg, block.content);
-		if (nested) {
-			if (out.length) out.push("");
-			out.push(nested);
+		case "blockSdt": {
+			const nested = renderBlocks(ctx, pkg, block.content);
+			if (nested) {
+				if (out.length) out.push("");
+				out.push(nested);
+			}
+			break;
 		}
+		default: panic(`Unsupported block content in markdown: ${JSON.stringify(block)}`);
 	}
 	return out.join("\n");
 }

package/dist/markdown/renderParagraph.js

@@ -1,5 +1,5 @@
+import { isQuoteStyle, resolveHeadingLevel } from "../docx/builtInStyles.js";
 import { resolveListTemplate } from "../prosemirror/listMarker.js";
-import { isHeadingStyle, parseHeadingLevel } from "./headings.js";
 import { renderParagraphInline } from "./renderRuns.js";
 //#region src/markdown/renderParagraph.ts
 /**
@@ -8,7 +8,13 @@ import { renderParagraphInline } from "./renderRuns.js";
 * marker preserved); plain prose → escaped inline content. Word's `Quote` /
 * `IntenseQuote` styles become blockquotes. Ported from eigenpal/docx-editor
 * PR #595.
+*
+* Which paragraphs those are is `builtInStyles`' decision, not this file's: the
+* id `Nadpis1` and the id `Heading1` are the same heading, and `ClauseHeading1`
+* is not one at all.
 */
+/** Markdown has six heading levels; Word has nine. */
+const MAX_MARKDOWN_HEADING_LEVEL = 6;
 /**
 * Render a paragraph and return the block text. No surrounding blank line: the
 * caller joins blocks.
@@ -16,13 +22,16 @@ import { renderParagraphInline } from "./renderRuns.js";
 function renderParagraph(ctx, pkg, para) {
 	const inline = renderParagraphInline(ctx, pkg, para.content, para.paraId);
 	const styleId = para.formatting?.styleId;
-	if (isHeadingStyle(styleId)) {
+	const headingLevel = resolveHeadingLevel({
+		outlineLevel: para.formatting?.outlineLevel,
+		styleId
+	}, ctx.builtInStyles);
+	if (headingLevel !== void 0) {
 		if (!inline) return "";
-		const level = parseHeadingLevel(styleId) ?? 1;
-		return `${"#".repeat(Math.max(1, Math.min(6, level)))} ${inline}`;
+		return `${"#".repeat(Math.min(MAX_MARKDOWN_HEADING_LEVEL, headingLevel + 1))} ${inline}`;
 	}
 	if (para.listRendering && !para.listRendering.markerHidden) return renderListItem(ctx, para.listRendering, inline);
-	if (styleId === "Quote" || styleId === "IntenseQuote") return inline.split("\n").map((line) => `> ${line}`).join("\n");
+	if (isQuoteStyle(styleId, ctx.builtInStyles)) return inline.split("\n").map((line) => `> ${line}`).join("\n");
 	return escapeLeadingBlockMarker(inline);
 }
 /**

package/dist/markdown/renderRuns.js

@@ -1,3 +1,4 @@
+import { RELATIONSHIP_TYPES, resolveRelationshipIdOfType } from "../docx/relsParser.js";
 import { decodeOoxmlSymbolCharacter } from "../utils/ooxmlSymbol.js";
 import { wrapComment, wrapDeletion, wrapInsertion, wrapMoveFrom, wrapMoveTo } from "./annotations.js";
 import { escapeAltText, escapeInline, escapeLinkUrl } from "./escape.js";
@@ -88,8 +89,8 @@ function renderRunContent(ctx, pkg, content, paraId) {
 			break;
 		}
 		case "drawing": {
-			const ref = pkg?.relationships?.get(item.image.rId);
-			const media = ref ? pkg?.media?.get(ref.target) : void 0;
+			const ref = resolveRelationshipIdOfType(pkg?.relationships, item.image.rId, RELATIONSHIP_TYPES.image);
+			const media = ref.status === "resolved" ? pkg?.media?.get(ref.relationship.target) : void 0;
 			if (media) {
 				const reg = registerImage(ctx, media, item.image, paraId);
 				const alt = reg.alt ? escapeAltText(reg.alt) : "";
@@ -101,7 +102,7 @@ function renderRunContent(ctx, pkg, content, paraId) {
 				out += `![${escapeAltText(alt)}](${item.image.src})`;
 				break;
 			}
-			pushWarning(ctx, `image rId=${item.image.rId} not resolvable`);
+			pushWarning(ctx, `image rId=${item.image.rId ?? "(absent)"} not resolvable`);
 			break;
 		}
 		case "shape":

package/dist/markdown/renderTable.js

@@ -1,3 +1,4 @@
+import { RELATIONSHIP_TYPES, resolveRelationshipIdOfType } from "../docx/relsParser.js";
 import { decodeOoxmlSymbolCharacter } from "../utils/ooxmlSymbol.js";
 import { escapeTableCell } from "./escape.js";
 import { registerImage } from "./images.js";
@@ -185,8 +186,8 @@ function renderHtmlRun(ctx, pkg, run, paraId) {
 			break;
 		case "softHyphen": break;
 		case "drawing": {
-			const ref = pkg?.relationships?.get(item.image.rId);
-			const media = ref ? pkg?.media?.get(ref.target) : void 0;
+			const ref = resolveRelationshipIdOfType(pkg?.relationships, item.image.rId, RELATIONSHIP_TYPES.image);
+			const media = ref.status === "resolved" ? pkg?.media?.get(ref.relationship.target) : void 0;
 			if (media) {
 				const reg = registerImage(ctx, media, item.image, paraId);
 				const alt = reg.alt ? escapeHtml(reg.alt) : "";
@@ -198,7 +199,7 @@ function renderHtmlRun(ctx, pkg, run, paraId) {
 				text += `<img src="${escapeHtml(item.image.src)}" alt="${alt}">`;
 				break;
 			}
-			pushWarning(ctx, `image rId=${item.image.rId} not resolvable`);
+			pushWarning(ctx, `image rId=${item.image.rId ?? "(absent)"} not resolvable`);
 			break;
 		}
 		case "footnoteRef":