@stll/folio-core 0.45.0 → 0.47.0

package/dist/docx/imageParser.js

@@ -1,34 +1,67 @@
+import { normalizeImageLuminancePercent } from "../utils/imageLuminance.js";
 import { sanitizeImageSrc } from "../utils/sanitizeImageSrc.js";
 import { emuToPixels } from "../utils/units.js";
 import { sanitizeExternalUrl } from "../utils/urlSecurity.js";
-import { WRAP_ELEMENT_NAMES, parseAnchorBehindDoc, parsePositionH, parsePositionV, parseWrapElement } from "./drawingUtils.js";
+import { WORDPROCESSING_DRAWING_NAMESPACE_URIS, parseDrawingAnchor } from "./drawingAnchor.js";
+import { findWrapElement, parseAnchorBehindDoc, parseDrawingEffectExtent, parseInlineWrap, parsePositionH, parsePositionV, parseWrapElement } from "./drawingUtils.js";
 import { parseGraphicFrameLocks } from "./graphicFrameLocks.js";
 import { parseNonVisualDrawingNames } from "./nonVisualDrawingProps.js";
 import { RELATIONSHIP_TYPES, resolveRelationshipIdOfType } from "./relsParser.js";
 import { isTextBoxDrawing } from "./textBoxParser.js";
+import { percentageSpelling } from "./transitionalSpelling.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
-import { findByFullName, findChild, findChildByNamespaceUri, findChildrenByNamespaceUri, getAttribute, getChildElements, getLocalName, getNamespaceUri, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue } from "./xmlParser.js";
+import { findByFullName, findChildByNamespaceUri, findChildrenByNamespaceUri, getAttribute, getChildElements, getLocalName, getNamespaceUri, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue } from "./xmlParser.js";
+import { relationshipIdOf } from "@stll/docx-core/model";
 //#region src/docx/imageParser.ts
 /**
+* Image Parser - Parse embedded images from w:drawing elements
+*
+* DOCX images are contained in <w:drawing> elements with either:
+* - wp:inline - Inline images that flow with text
+* - wp:anchor - Floating/anchored images with text wrapping
+*
+* OOXML Structure:
+* w:drawing
+*   ├── wp:inline or wp:anchor
+*   │   ├── wp:extent (size: cx, cy in EMUs)
+*   │   ├── wp:effectExtent (effect margins)
+*   │   ├── wp:docPr (document properties: id, name, descr, title)
+*   │   ├── wp:positionH / wp:positionV (for anchor only)
+*   │   ├── wp:wrap* (wrapping mode for anchor: wrapNone, wrapSquare, etc.)
+*   │   └── a:graphic
+*   │       └── a:graphicData
+*   │           └── pic:pic
+*   │               ├── pic:nvPicPr (non-visual properties)
+*   │               ├── pic:blipFill
+*   │               │   └── a:blip (r:embed = rId)
+*   │               └── pic:spPr
+*   │                   └── a:xfrm (transform: rotation, flip)
+*
+* EMU (English Metric Units): 914400 EMU = 1 inch
+* Conversion: pixels = (emu * 96) / 914400
+*/
+const DRAWINGML_MAIN_NAMESPACE_URIS = /* @__PURE__ */ new Set(["http://schemas.openxmlformats.org/drawingml/2006/main", "http://purl.oclc.org/ooxml/drawingml/main"]);
+const FIXED_PERCENTAGE = /^-?\d+$/u;
+/**
 * Convert rotation value (1/60000 of a degree) to degrees
 *
 * @param rot - Rotation in 60000ths of a degree
 * @returns Rotation in degrees
 */
 function rotToDegrees(rot) {
-	if (!rot) return;
+	if (rot === null || rot === void 0) return;
 	const val = Number.parseInt(rot, 10);
 	if (Number.isNaN(val)) return;
 	return val / 6e4;
 }
 /**
-* Find any of the specified elements
+* A child of `wp:inline` or `wp:anchor`, resolved by namespace.
+*
+* The `wp` prefix is the producer's choice, not the document's meaning: a
+* package that binds the WordprocessingDrawing namespace to another prefix
+* carries the same `wp:extent` and a prefix-matched read finds none of it.
 */
-function findAnyOf(parent, names) {
-	const children = getChildElements(parent);
-	for (const child of children) if (names.includes(child.name || "")) return child;
-	return null;
-}
+const findDrawingChild = (parent, localName) => findChildByNamespaceUri(parent, WORDPROCESSING_DRAWING_NAMESPACE_URIS, localName);
 /**
 * Parse extent element for image size
 *
@@ -46,26 +79,6 @@ function parseExtent(extent) {
 	};
 }
 /**
-* Parse effect extent for shadow/effect margins
-*
-* @param effectExtent - wp:effectExtent element
-* @returns Padding for effects
-*/
-function parseEffectExtent(effectExtent) {
-	if (!effectExtent) return;
-	const l = parseNumericAttribute(effectExtent, null, "l") ?? 0;
-	const t = parseNumericAttribute(effectExtent, null, "t") ?? 0;
-	const r = parseNumericAttribute(effectExtent, null, "r") ?? 0;
-	const b = parseNumericAttribute(effectExtent, null, "b") ?? 0;
-	if (l === 0 && t === 0 && r === 0 && b === 0) return;
-	return {
-		left: l,
-		top: t,
-		right: r,
-		bottom: b
-	};
-}
-/**
 * The `a:ext` uri under which Word records that a drawing is decorative. The
 * extension holds `<adec:decorative val="…"/>`; `CT_NonVisualDrawingProps` has
 * no `@decorative` attribute for it to be written as.
@@ -107,6 +120,22 @@ const parseDocPropsExtensions = (docPr) => {
 	return result;
 };
 /**
+* One of `wp:docPr`'s two `CT_Hyperlink` children, as the source wrote it.
+*
+* Resolved by namespace URI rather than by the `a:` prefix: a producer is free
+* to bind DrawingML's namespace to another prefix, and a prefix-matched read
+* would drop the whole link for a document that does.
+*/
+const parseDocPrLink = (docPr, localName) => {
+	const element = findChildByNamespaceUri(docPr, DRAWINGML_NAMESPACE_URIS, localName);
+	if (!element) return;
+	const rId = getAttribute(element, "r", "id");
+	return {
+		xml: captureVerbatimXml(element),
+		...rId == null ? {} : { rId }
+	};
+};
+/**
 * Parse document properties (wp:docPr)
 *
 * @param docPr - wp:docPr element
@@ -118,31 +147,48 @@ function parseDocProps(docPr) {
 	const names = parseNonVisualDrawingNames(docPr);
 	const hidden = parseOnOffAttribute(docPr, null, "hidden");
 	const { decorative, other: docPrExtensions } = parseDocPropsExtensions(docPr);
-	const hlinkClickEl = findChild(docPr, "a", "hlinkClick");
-	const hlinkRId = hlinkClickEl ? getAttribute(hlinkClickEl, "r", "id") : null;
+	const hlinkClickSource = parseDocPrLink(docPr, "hlinkClick");
+	const hlinkHoverSource = parseDocPrLink(docPr, "hlinkHover");
 	return {
 		...id != null ? { id } : {},
 		...names,
 		...decorative === void 0 ? {} : { decorative },
 		...hidden === void 0 ? {} : { hidden },
 		...docPrExtensions.length > 0 ? { docPrExtensions } : {},
-		...hlinkRId != null ? { hlinkRId } : {}
+		...hlinkClickSource === void 0 ? {} : { hlinkClickSource },
+		...hlinkHoverSource === void 0 ? {} : { hlinkHoverSource }
 	};
 }
+const safeDocPrLinks = ({ props, rels }) => {
+	const targetOf = (link) => {
+		if (link === void 0) return;
+		if (link.rId === void 0) return "";
+		const resolved = resolveRelationshipIdOfType(rels, link.rId, RELATIONSHIP_TYPES.hyperlink);
+		return resolved.status === "resolved" ? sanitizeExternalUrl(resolved.relationship.target) : void 0;
+	};
+	const click = props.hlinkClickSource;
+	const clickHref = targetOf(click);
+	const hoverKept = targetOf(props.hlinkHoverSource) !== void 0;
+	return {
+		...clickHref ? { hlinkHref: clickHref } : {},
+		...clickHref !== void 0 && click?.rId !== void 0 ? { hlinkRId: click.rId } : {},
+		...clickHref === void 0 || click === void 0 ? {} : { hlinkClickSource: click },
+		...hoverKept && props.hlinkHoverSource !== void 0 ? { hlinkHoverXml: props.hlinkHoverSource.xml } : {}
+	};
+};
 /**
 * Parse transform properties from a:xfrm
 */
 function parseTransform(xfrm) {
 	if (!xfrm) return;
-	const rot = getAttribute(xfrm, null, "rot");
-	const flipH = parseOnOffValue(getAttribute(xfrm, null, "flipH")) === true;
-	const flipV = parseOnOffValue(getAttribute(xfrm, null, "flipV")) === true;
-	const rotation = rotToDegrees(rot);
-	if (rotation === void 0 && !flipH && !flipV) return;
+	const flipH = parseOnOffValue(getAttribute(xfrm, null, "flipH"));
+	const flipV = parseOnOffValue(getAttribute(xfrm, null, "flipV"));
+	const rotation = rotToDegrees(getAttribute(xfrm, null, "rot"));
+	if (rotation === void 0 && flipH === void 0 && flipV === void 0) return;
 	const transform = {};
 	if (rotation !== void 0) transform.rotation = rotation;
-	if (flipH) transform.flipH = true;
-	if (flipV) transform.flipV = true;
+	if (flipH !== void 0) transform.flipH = flipH;
+	if (flipV !== void 0) transform.flipV = flipV;
 	return transform;
 }
 /**
@@ -154,13 +200,22 @@ function parseTransform(xfrm) {
 * `a:srcRect` crop element, so callers that need either share this walk.
 */
 function findBlipFillElement(container) {
-	const graphic = findByFullName(container, "a:graphic");
-	if (!graphic) return null;
-	const graphicData = findByFullName(graphic, "a:graphicData");
-	if (!graphicData) return null;
-	const pic = findByFullName(graphicData, "pic:pic");
-	if (!pic) return null;
-	return findByFullName(pic, "pic:blipFill");
+	return findByFullName(findPictureElement(container), "pic:blipFill");
+}
+/** `a:graphic > a:graphicData > pic:pic`, the one walk every picture read shares. */
+function findPictureElement(container) {
+	return findByFullName(findByFullName(findByFullName(container, "a:graphic"), "a:graphicData"), "pic:pic");
+}
+/**
+* `pic:cNvPr` — the picture's own name, alt text and title.
+*
+* Not `wp:docPr`'s. They are two `CT_NonVisualDrawingProps` elements on the
+* same drawing and a reader names the object from whichever one it is looking
+* at, so folding them together loses whichever the source did not repeat.
+*/
+function findPictureNonVisualProps(container) {
+	const pic = findPictureElement(container);
+	return pic ? findByFullName(findByFullName(pic, "pic:nvPicPr"), "pic:cNvPr") : null;
 }
 /**
 * Parse `<a:srcRect l="..." t="..." r="..." b="..."/>` inside `pic:blipFill`.
@@ -191,16 +246,6 @@ function parseImageCrop(blipFill) {
 	return crop;
 }
 /**
-* Parse an OOXML `ST_OnOff` attribute on an element. Accepts the full
-* set of literals the spec allows (`"1"`/`"true"`/`"on"` and
-* `"0"`/`"false"`/`"off"`); anything else (including an absent
-* attribute) folds back to `undefined` so callers can apply the
-* spec-defined default.
-*/
-function parseOnOffAttr(element, name) {
-	return parseOnOffValue(getAttribute(element, null, name));
-}
-/**
 * Parse `<a:alphaModFix amt="..."/>` inside the `a:blip` element. The
 * `amt` value is in 1/100000; convert to a fraction in [0, 1] for CSS
 * `opacity`. Returns undefined when no alpha modifier is present (fully
@@ -219,6 +264,24 @@ function parseImageOpacity(blip) {
 	if (amt === void 0 || amt >= 1e5) return;
 	return Math.max(0, amt / 1e5);
 }
+const parseLuminancePercent = (luminance, attribute) => {
+	const raw = getAttribute(luminance, null, attribute);
+	if (raw === null) return;
+	const percent = percentageSpelling(raw) ?? (FIXED_PERCENTAGE.test(raw.trim()) ? Number(raw) / 1e3 : void 0);
+	return percent === void 0 || !Number.isFinite(percent) ? void 0 : normalizeImageLuminancePercent(percent);
+};
+/** Parse DrawingML `a:lum` into signed percentage values, preserving explicit zeroes. */
+function parseImageLuminance(blip) {
+	const luminance = findChildByNamespaceUri(blip, DRAWINGML_MAIN_NAMESPACE_URIS, "lum");
+	if (!luminance) return;
+	const brightness = parseLuminancePercent(luminance, "bright");
+	const contrast = parseLuminancePercent(luminance, "contrast");
+	if (brightness === void 0 && contrast === void 0) return;
+	return {
+		...brightness === void 0 ? {} : { brightness },
+		...contrast === void 0 ? {} : { contrast }
+	};
+}
 /**
 * Extract rId from a:blip element.
 *
@@ -228,12 +291,7 @@ function parseImageOpacity(blip) {
 */
 function extractBlipRId(blip) {
 	if (!blip) return;
-	const rEmbed = getAttribute(blip, "r", "embed");
-	if (rEmbed) return rEmbed;
-	const embed = getAttribute(blip, null, "embed");
-	if (embed) return embed;
-	const rLink = getAttribute(blip, "r", "link");
-	if (rLink) return rLink;
+	return relationshipIdOf(getAttribute(blip, "r", "embed")) ?? relationshipIdOf(getAttribute(blip, null, "embed")) ?? relationshipIdOf(getAttribute(blip, "r", "link"));
 }
 /**
 * Find transform (a:xfrm) from picture shape properties
@@ -241,15 +299,7 @@ function extractBlipRId(blip) {
 * Path: a:graphic > a:graphicData > pic:pic > pic:spPr > a:xfrm
 */
 function findPictureTransform(container) {
-	const graphic = findByFullName(container, "a:graphic");
-	if (!graphic) return null;
-	const graphicData = findByFullName(graphic, "a:graphicData");
-	if (!graphicData) return null;
-	const pic = findByFullName(graphicData, "pic:pic");
-	if (!pic) return null;
-	const spPr = findByFullName(pic, "pic:spPr");
-	if (!spPr) return null;
-	return findByFullName(spPr, "a:xfrm");
+	return findByFullName(findByFullName(findPictureElement(container), "pic:spPr"), "a:xfrm");
 }
 /**
 * Normalize a target path to the standard word/media/... format
@@ -341,26 +391,20 @@ function resolveImageData(rId, rels, media) {
 * @returns Parsed Image object
 */
 function parseInline(inlineEl, rels, media) {
-	const size = parseExtent(findByFullName(inlineEl, "wp:extent"));
-	const padding = parseEffectExtent(findByFullName(inlineEl, "wp:effectExtent"));
-	const props = parseDocProps(findByFullName(inlineEl, "wp:docPr"));
+	const size = parseExtent(findDrawingChild(inlineEl, "extent"));
+	const padding = parseDrawingEffectExtent(findDrawingChild(inlineEl, "effectExtent"));
+	const props = parseDocProps(findDrawingChild(inlineEl, "docPr"));
 	const frameLocks = parseGraphicFrameLocks(inlineEl);
+	const pictureNames = parseNonVisualDrawingNames(findPictureNonVisualProps(inlineEl));
 	const blipFill = findBlipFillElement(inlineEl);
 	const blip = blipFill ? findByFullName(blipFill, "a:blip") : null;
 	const rId = extractBlipRId(blip);
 	const crop = parseImageCrop(blipFill);
 	const opacity = parseImageOpacity(blip);
+	const effects = parseImageLuminance(blip);
 	const imageData = resolveImageData(rId, rels, media);
 	const transform = parseTransform(findPictureTransform(inlineEl));
-	const distT = parseNumericAttribute(inlineEl, null, "distT") ?? void 0;
-	const distB = parseNumericAttribute(inlineEl, null, "distB") ?? void 0;
-	const distL = parseNumericAttribute(inlineEl, null, "distL") ?? void 0;
-	const distR = parseNumericAttribute(inlineEl, null, "distR") ?? void 0;
-	const wrap = { type: "inline" };
-	if (distT !== void 0) wrap.distT = distT;
-	if (distB !== void 0) wrap.distB = distB;
-	if (distL !== void 0) wrap.distL = distL;
-	if (distR !== void 0) wrap.distR = distR;
+	const wrap = parseInlineWrap(inlineEl);
 	const image = {
 		type: "image",
 		...rId === void 0 ? {} : { rId },
@@ -371,6 +415,7 @@ function parseInline(inlineEl, rels, media) {
 	if (props.name !== void 0) image.docPrName = props.name;
 	if (props.alt !== void 0) image.alt = props.alt;
 	if (props.title !== void 0) image.title = props.title;
+	if (Object.keys(pictureNames).length > 0) image.pictureNames = pictureNames;
 	if (props.decorative !== void 0) image.decorative = props.decorative;
 	if (props.hidden !== void 0) image.hidden = props.hidden;
 	if (props.docPrExtensions !== void 0) image.docPrExtensions = props.docPrExtensions;
@@ -382,15 +427,12 @@ function parseInline(inlineEl, rels, media) {
 	if (transform) image.transform = transform;
 	if (crop) image.crop = crop;
 	if (opacity !== void 0) image.opacity = opacity;
+	if (effects !== void 0) image.effects = effects;
 	if (frameLocks) image.frameLocks = frameLocks;
-	const hlink = resolveRelationshipIdOfType(rels, props.hlinkRId, RELATIONSHIP_TYPES.hyperlink);
-	if (hlink.status === "resolved") {
-		const safeHref = sanitizeExternalUrl(hlink.relationship.target);
-		if (safeHref) {
-			image.hlinkHref = safeHref;
-			image.hlinkRId = hlink.relationship.id;
-		}
-	}
+	Object.assign(image, safeDocPrLinks({
+		props,
+		rels
+	}));
 	return image;
 }
 /**
@@ -402,13 +444,14 @@ function parseInline(inlineEl, rels, media) {
 * @returns Parsed Image object
 */
 function parseAnchor(anchorEl, rels, media) {
-	const size = parseExtent(findByFullName(anchorEl, "wp:extent"));
-	const padding = parseEffectExtent(findByFullName(anchorEl, "wp:effectExtent"));
-	const props = parseDocProps(findByFullName(anchorEl, "wp:docPr"));
+	const size = parseExtent(findDrawingChild(anchorEl, "extent"));
+	const effectExtent = findDrawingChild(anchorEl, "effectExtent");
+	const padding = parseDrawingEffectExtent(effectExtent);
+	const props = parseDocProps(findDrawingChild(anchorEl, "docPr"));
 	const frameLocks = parseGraphicFrameLocks(anchorEl);
+	const pictureNames = parseNonVisualDrawingNames(findPictureNonVisualProps(anchorEl));
 	const behindDoc = parseAnchorBehindDoc(anchorEl);
-	const layoutInCell = parseOnOffAttr(anchorEl, "layoutInCell");
-	const allowOverlap = parseOnOffAttr(anchorEl, "allowOverlap");
+	const anchor = parseDrawingAnchor(anchorEl);
 	const anchorDistT = parseNumericAttribute(anchorEl, null, "distT");
 	const anchorDistB = parseNumericAttribute(anchorEl, null, "distB");
 	const anchorDistL = parseNumericAttribute(anchorEl, null, "distL");
@@ -419,9 +462,15 @@ function parseAnchor(anchorEl, rels, media) {
 		...anchorDistL != null ? { distL: anchorDistL } : {},
 		...anchorDistR != null ? { distR: anchorDistR } : {}
 	};
-	const wrap = parseWrapElement(findAnyOf(anchorEl, WRAP_ELEMENT_NAMES), behindDoc, anchorDistances);
-	const posH = findByFullName(anchorEl, "wp:positionH");
-	const posV = findByFullName(anchorEl, "wp:positionV");
+	const anchorEffectExtent = parseDrawingEffectExtent(effectExtent);
+	const wrap = parseWrapElement({
+		wrapEl: findWrapElement(anchorEl),
+		behindDoc,
+		anchorDistances,
+		...anchorEffectExtent === void 0 ? {} : { anchorEffectExtent }
+	});
+	const posH = findDrawingChild(anchorEl, "positionH");
+	const posV = findDrawingChild(anchorEl, "positionV");
 	const horizontal = parsePositionH(posH);
 	const vertical = parsePositionV(posV);
 	let position;
@@ -434,6 +483,7 @@ function parseAnchor(anchorEl, rels, media) {
 	const rId = extractBlipRId(blip);
 	const crop = parseImageCrop(blipFill);
 	const opacity = parseImageOpacity(blip);
+	const effects = parseImageLuminance(blip);
 	const imageData = resolveImageData(rId, rels, media);
 	const transform = parseTransform(findPictureTransform(anchorEl));
 	const image = {
@@ -446,6 +496,7 @@ function parseAnchor(anchorEl, rels, media) {
 	if (props.name !== void 0) image.docPrName = props.name;
 	if (props.alt !== void 0) image.alt = props.alt;
 	if (props.title !== void 0) image.title = props.title;
+	if (Object.keys(pictureNames).length > 0) image.pictureNames = pictureNames;
 	if (props.decorative !== void 0) image.decorative = props.decorative;
 	if (props.hidden !== void 0) image.hidden = props.hidden;
 	if (props.docPrExtensions !== void 0) image.docPrExtensions = props.docPrExtensions;
@@ -458,17 +509,13 @@ function parseAnchor(anchorEl, rels, media) {
 	if (transform) image.transform = transform;
 	if (crop) image.crop = crop;
 	if (opacity !== void 0) image.opacity = opacity;
+	if (effects !== void 0) image.effects = effects;
 	if (frameLocks) image.frameLocks = frameLocks;
-	if (layoutInCell !== void 0) image.layoutInCell = layoutInCell;
-	if (allowOverlap !== void 0) image.allowOverlap = allowOverlap;
-	const hlink = resolveRelationshipIdOfType(rels, props.hlinkRId, RELATIONSHIP_TYPES.hyperlink);
-	if (hlink.status === "resolved") {
-		const safeHref = sanitizeExternalUrl(hlink.relationship.target);
-		if (safeHref) {
-			image.hlinkHref = safeHref;
-			image.hlinkRId = hlink.relationship.id;
-		}
-	}
+	if (anchor !== void 0) image.anchor = anchor;
+	Object.assign(image, safeDocPrLinks({
+		props,
+		rels
+	}));
 	return image;
 }
 /**
@@ -483,12 +530,10 @@ function parseAnchor(anchorEl, rels, media) {
 */
 function parseDrawing(drawingEl, rels, media) {
 	if (isTextBoxDrawing(drawingEl)) return null;
-	const children = getChildElements(drawingEl);
-	for (const child of children) {
-		const name = child.name || "";
-		if (name === "wp:inline" || name === "wp:anchor") return name === "wp:inline" ? parseInline(child, rels, media) : parseAnchor(child, rels, media);
-	}
-	return null;
+	const inline = findDrawingChild(drawingEl, "inline");
+	if (inline) return parseInline(inline, rels, media);
+	const anchor = findDrawingChild(drawingEl, "anchor");
+	return anchor ? parseAnchor(anchor, rels, media) : null;
 }
 /**
 * Parse an image from a w:drawing element

package/dist/docx/index.d.ts

@@ -1,5 +1,6 @@
 import { getCachedNumberingMap } from "./numberingParser.js";
 import { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, DocxEncryptionErrorCode, isDocxEncryptionError } from "./encryption/errors.js";
 import { DecryptDocxOptions, DecryptDocxResult, decryptDocxIfNeeded, openDocxBuffer } from "./encryption/openEncryptedDocx.js";
+import { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, ParagraphNumberingOverride, ParagraphNumberingSlots, ResolvedParagraphNumbering, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering } from "./numberingReference.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, RewriteDocxMetadataPrivacyResult, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./metadataPrivacy.js";
-export { DOCX_ENCRYPTION_ERROR_CODES, type DecryptDocxOptions, type DecryptDocxResult, DocxEncryptionError, type DocxEncryptionErrorCode, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, type FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, type RewriteDocxMetadataPrivacyResult, decryptDocxIfNeeded, getCachedNumberingMap, isDocxEncryptionError, isFolioDocumentPrivacyTransform, openDocxBuffer, rewriteDocxMetadataPrivacy };
+export { DOCX_ENCRYPTION_ERROR_CODES, type DecryptDocxOptions, type DecryptDocxResult, DocxEncryptionError, type DocxEncryptionErrorCode, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, type FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, type ParagraphNumberingOverride, type ParagraphNumberingSlots, type ResolvedParagraphNumbering, type RewriteDocxMetadataPrivacyResult, decryptDocxIfNeeded, getCachedNumberingMap, isDocxEncryptionError, isFolioDocumentPrivacyTransform, isNumberingReference, mergeParagraphNumbering, openDocxBuffer, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, rewriteDocxMetadataPrivacy, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering };

package/dist/docx/index.js

@@ -2,4 +2,5 @@ import { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, isDocxEncryptionError
 import { decryptDocxIfNeeded, openDocxBuffer } from "./encryption/openEncryptedDocx.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentPrivacyArchiveError, InvalidFolioDocumentPrivacyOptionsError, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./metadataPrivacy.js";
 import { getCachedNumberingMap } from "./numberingParser.js";
-export { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentPrivacyArchiveError, InvalidFolioDocumentPrivacyOptionsError, decryptDocxIfNeeded, getCachedNumberingMap, isDocxEncryptionError, isFolioDocumentPrivacyTransform, openDocxBuffer, rewriteDocxMetadataPrivacy };
+import { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering } from "./numberingReference.js";
+export { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentPrivacyArchiveError, InvalidFolioDocumentPrivacyOptionsError, NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, decryptDocxIfNeeded, getCachedNumberingMap, isDocxEncryptionError, isFolioDocumentPrivacyTransform, isNumberingReference, mergeParagraphNumbering, openDocxBuffer, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, rewriteDocxMetadataPrivacy, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering };

package/dist/docx/inlineContentRemovals.d.ts

@@ -0,0 +1,28 @@
+import { InlineContentSlot } from "./paragraphTraversal.js";
+//#region src/docx/inlineContentRemovals.d.ts
+/**
+ * Positions marked for removal, per inline-content array.
+ *
+ * Removal shifts every later index in that array, so a normaliser records the
+ * positions while it reads and drops them once, after it has finished reading.
+ */
+declare class InlineContentRemovals {
+  #private;
+  mark({ content, index }: Pick<InlineContentSlot, "content" | "index">): void;
+  /**
+   * Applies every marked removal and answers how many items were dropped.
+   *
+   * Consolidation is re-run over each array a removal touched, because every
+   * inline item that is not a run is a merge boundary: `parseParagraph`
+   * consolidated the array while the removed item still stood between its
+   * neighbours, so dropping it leaves two runs adjacent that the next parse
+   * merges. That is an oscillation rather than a loss, save 1 writes the pair
+   * and save 2 writes one run, and it reaches every normaliser that removes an
+   * item, not only the one it was found through. Restoring the invariant here
+   * makes the parse a fixed point by construction; an array nothing was
+   * removed from is not touched.
+   */
+  apply(): number;
+}
+//#endregion
+export { InlineContentRemovals };

package/dist/docx/inlineContentRemovals.js

@@ -0,0 +1,46 @@
+import { consolidateParagraphContent } from "./runConsolidator.js";
+//#region src/docx/inlineContentRemovals.ts
+/**
+* Positions marked for removal, per inline-content array.
+*
+* Removal shifts every later index in that array, so a normaliser records the
+* positions while it reads and drops them once, after it has finished reading.
+*/
+var InlineContentRemovals = class {
+	#byContent = /* @__PURE__ */ new Map();
+	mark({ content, index }) {
+		const indexes = this.#byContent.get(content);
+		if (indexes) {
+			indexes.add(index);
+			return;
+		}
+		this.#byContent.set(content, /* @__PURE__ */ new Set([index]));
+	}
+	/**
+	* Applies every marked removal and answers how many items were dropped.
+	*
+	* Consolidation is re-run over each array a removal touched, because every
+	* inline item that is not a run is a merge boundary: `parseParagraph`
+	* consolidated the array while the removed item still stood between its
+	* neighbours, so dropping it leaves two runs adjacent that the next parse
+	* merges. That is an oscillation rather than a loss, save 1 writes the pair
+	* and save 2 writes one run, and it reaches every normaliser that removes an
+	* item, not only the one it was found through. Restoring the invariant here
+	* makes the parse a fixed point by construction; an array nothing was
+	* removed from is not touched.
+	*/
+	apply() {
+		let removed = 0;
+		for (const [content, indexes] of this.#byContent) {
+			if (indexes.size === 0) continue;
+			const kept = content.filter((_, index) => !indexes.has(index));
+			removed += content.length - kept.length;
+			const next = consolidateParagraphContent(kept);
+			content.length = 0;
+			content.push(...next);
+		}
+		return removed;
+	}
+};
+//#endregion
+export { InlineContentRemovals };