@stll/folio-core 0.52.0 → 0.54.0

package/dist/docx/tableParser.d.ts

@@ -1,6 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
+import { ParseContext } from "./parseContext.js";
 import { XmlElement } from "./xmlParser.js";
+import { OwnedElsewhere } from "./containerChildren.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 //#region src/docx/tableParser.d.ts
@@ -68,6 +70,8 @@ declare function parseTableProperties(tblPrElement: XmlElement | null): document
  * {@link parseTablePropertyExceptionChanges}.
  */
 declare function parseTablePropertyExceptions(tblPrExElement: XmlElement | null): document_d_exports.TablePropertyExceptionFormatting | undefined;
+declare function isTableCellMergeRevisionValue(value: unknown): value is "continue" | "rest";
+declare function isTableCellMergeRevisionContinuation(value: "continue" | "rest" | undefined): boolean;
 /**
  * Parse table row properties (w:trPr)
  *
@@ -89,6 +93,20 @@ declare function parseConditionalFormatStyle(cnfElement: XmlElement | null): doc
  * @returns Parsed cell formatting
  */
 declare function parseTableCellProperties(tcPrElement: XmlElement | null): document_d_exports.TableCellFormatting | undefined;
+/**
+ * Record a `CT_SdtRow` / `CT_SdtCell` on the rows or cells it wrapped.
+ *
+ * Both are transparent: what they hold is ordinary rows and cells, and the
+ * control adds properties and an end mark. folio keeps the children modelled
+ * and puts the control on each of them rather than modelling a wrapper
+ * between them, because a table's children are rows and a row's are cells,
+ * and neither has a node to spare for something that is not one.
+ *
+ * Outermost first, so a control inside a control — a bound row inside a
+ * repeating section — comes back nested the way it was written. The
+ * recursion reads the inner one first, so the outer prepends.
+ */
+type TablePreservedChild = NonNullable<document_d_exports.TablePreservedMarkup["children"]>[number];
 /**
  * Parse table cell content, including nested block controls.
  *
@@ -105,6 +123,58 @@ type TableParseOptions = {
   rootXmlns?: Record<string, string>;
   /** The ledger of the package this table belongs to; a table read on its own has none. */
   previews?: PreviewLedger;
+  context?: ParseContext | undefined;
+};
+/** What a table's rows, cells and blocks read: the ledger is settled where the walk enters. */
+type TableScope = TableParseOptions & {
+  previews: PreviewLedger;
+};
+/** The parts and maps a table's content is read against. */
+type TableParseResources = {
+  styles: StyleMap | null;
+  theme: document_d_exports.Theme | null;
+  numbering: NumberingMap | null;
+  rels: document_d_exports.RelationshipMap | null;
+  media: Map<string, document_d_exports.MediaFile> | null;
+};
+/** One cell's block sequence, or a block control's inside it, as it is read. */
+type CellChildrenWalk = {
+  resources: TableParseResources;
+  options: TableScope;
+  modelled: document_d_exports.TableCellBlock[];
+  captured: document_d_exports.PreservedChild[];
+};
+declare const CELL_CONTENT_HANDLERS: {
+  readonly p: (child: XmlElement, { resources: { styles, theme, numbering, rels, media }, options, modelled }: CellChildrenWalk) => void;
+  readonly tbl: (child: XmlElement, { resources: { styles, theme, numbering, rels, media }, options, modelled }: CellChildrenWalk) => void;
+  readonly sdt: (child: XmlElement, { resources, options, modelled }: CellChildrenWalk) => "capture" | undefined;
+  readonly customXml: (child: XmlElement, { resources, options, modelled }: CellChildrenWalk) => void;
+  readonly bookmarkStart: (child: XmlElement, { modelled }: CellChildrenWalk) => void;
+  readonly bookmarkEnd: (child: XmlElement, { modelled }: CellChildrenWalk) => void;
+  readonly tcPr: OwnedElsewhere<"block-content", "tcPr">;
+  readonly sectPr: "capture";
+  readonly altChunk: "capture";
+  readonly commentRangeEnd: "capture";
+  readonly commentRangeStart: "capture";
+  readonly customXmlDelRangeEnd: "capture";
+  readonly customXmlDelRangeStart: "capture";
+  readonly customXmlInsRangeEnd: "capture";
+  readonly customXmlInsRangeStart: "capture";
+  readonly customXmlMoveFromRangeEnd: "capture";
+  readonly customXmlMoveFromRangeStart: "capture";
+  readonly customXmlMoveToRangeEnd: "capture";
+  readonly customXmlMoveToRangeStart: "capture";
+  readonly del: "capture";
+  readonly ins: "capture";
+  readonly moveFrom: "capture";
+  readonly moveFromRangeEnd: "capture";
+  readonly moveFromRangeStart: "capture";
+  readonly moveTo: "capture";
+  readonly moveToRangeEnd: "capture";
+  readonly moveToRangeStart: "capture";
+  readonly permEnd: "capture";
+  readonly permStart: "capture";
+  readonly proofErr: "capture";
 };
 /**
  * Parse a table cell (w:tc)
@@ -118,6 +188,49 @@ type TableParseOptions = {
  * @returns Parsed table cell
  */
 declare function parseTableCell(tcElement: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, options?: TableParseOptions): document_d_exports.TableCell;
+/** One row's children, or a cell-level content control's, as they are read. */
+type RowChildrenWalk = {
+  resources: TableParseResources;
+  options: TableScope;
+  row: document_d_exports.TableRow;
+  bookmarks: document_d_exports.PositionedBookmarkMarker[];
+  preservedChildren: TablePreservedChild[];
+  customXmlIdentity: {
+    next: number;
+  };
+};
+declare const ROW_CONTENT_HANDLERS: {
+  readonly commentRangeEnd: "capture";
+  readonly commentRangeStart: "capture";
+  readonly customXmlPr: "capture";
+  readonly customXmlDelRangeEnd: "capture";
+  readonly customXmlDelRangeStart: "capture";
+  readonly customXmlInsRangeEnd: "capture";
+  readonly customXmlInsRangeStart: "capture";
+  readonly customXmlMoveFromRangeEnd: "capture";
+  readonly customXmlMoveFromRangeStart: "capture";
+  readonly customXmlMoveToRangeEnd: "capture";
+  readonly customXmlMoveToRangeStart: "capture";
+  readonly del: "capture";
+  readonly ins: "capture";
+  readonly moveFrom: "capture";
+  readonly moveFromRangeEnd: "capture";
+  readonly moveFromRangeStart: "capture";
+  readonly moveTo: "capture";
+  readonly moveToRangeEnd: "capture";
+  readonly moveToRangeStart: "capture";
+  readonly permEnd: "capture";
+  readonly permStart: "capture";
+  readonly proofErr: "capture";
+  readonly tr: (child: XmlElement, { options }: RowChildrenWalk) => "capture";
+  readonly trPr: OwnedElsewhere<"row-content", "trPr">;
+  readonly tblPrEx: OwnedElsewhere<"row-content", "tblPrEx">;
+  readonly tc: (child: XmlElement, { resources: { styles, theme, numbering, rels, media }, options, row }: RowChildrenWalk) => void;
+  readonly sdt: (child: XmlElement, walk: RowChildrenWalk) => "capture" | undefined;
+  readonly customXml: (child: XmlElement, walk: RowChildrenWalk) => "capture" | undefined;
+  readonly bookmarkStart: (child: XmlElement, { row, bookmarks }: RowChildrenWalk) => void;
+  readonly bookmarkEnd: (child: XmlElement, { row, bookmarks }: RowChildrenWalk) => void;
+};
 /**
  * Parse a table row (w:tr)
  *
@@ -137,6 +250,49 @@ declare function parseTableRow(trElement: XmlElement, styles: StyleMap | null, t
  * @returns Array of column widths in twips
  */
 declare function parseTableGrid(tblGridElement: XmlElement | null): number[] | undefined;
+/** One table's children, or a row-level content control's, as they are read. */
+type TableChildrenWalk = {
+  resources: TableParseResources;
+  options: TableScope;
+  table: document_d_exports.Table;
+  rowsWithGridOffsets: Set<number>;
+  bookmarks: document_d_exports.PositionedBookmarkMarker[];
+  preservedChildren: TablePreservedChild[];
+  customXmlIdentity: {
+    next: number;
+  };
+};
+declare const TABLE_CONTENT_HANDLERS: {
+  readonly bookmarkStart: (child: XmlElement, { table, bookmarks }: TableChildrenWalk) => void;
+  readonly bookmarkEnd: (child: XmlElement, { table, bookmarks }: TableChildrenWalk) => void;
+  readonly commentRangeEnd: "capture";
+  readonly commentRangeStart: "capture";
+  readonly customXmlPr: "capture";
+  readonly customXmlDelRangeEnd: "capture";
+  readonly customXmlDelRangeStart: "capture";
+  readonly customXmlInsRangeEnd: "capture";
+  readonly customXmlInsRangeStart: "capture";
+  readonly customXmlMoveFromRangeEnd: "capture";
+  readonly customXmlMoveFromRangeStart: "capture";
+  readonly customXmlMoveToRangeEnd: "capture";
+  readonly customXmlMoveToRangeStart: "capture";
+  readonly del: "capture";
+  readonly ins: "capture";
+  readonly moveFrom: "capture";
+  readonly moveFromRangeEnd: "capture";
+  readonly moveFromRangeStart: "capture";
+  readonly moveTo: "capture";
+  readonly moveToRangeEnd: "capture";
+  readonly moveToRangeStart: "capture";
+  readonly permEnd: "capture";
+  readonly permStart: "capture";
+  readonly proofErr: "capture";
+  readonly tblPr: OwnedElsewhere<"table-content", "tblPr">;
+  readonly tblGrid: OwnedElsewhere<"table-content", "tblGrid">;
+  readonly tr: (child: XmlElement, { resources: { styles, theme, numbering, rels, media }, options, table, rowsWithGridOffsets }: TableChildrenWalk) => void;
+  readonly sdt: (child: XmlElement, walk: TableChildrenWalk) => "capture" | undefined;
+  readonly customXml: (child: XmlElement, walk: TableChildrenWalk) => "capture" | undefined;
+};
 /**
  * Parse a table element (w:tbl)
  *
@@ -215,4 +371,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, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };
+export { CELL_CONTENT_HANDLERS, MAX_TABLE_COLUMNS, ROW_CONTENT_HANDLERS, TABLE_CONTENT_HANDLERS, getHeaderRows, getTableColumnCount, getTableRowCount, getTableText, hasHeaderRow, isCellHorizontallyMerged, isCellMergeContinuation, isCellMergeStart, isFloatingTable, isTableCellMergeRevisionContinuation, isTableCellMergeRevisionValue, parseCellMargins, parseConditionalFormatStyle, parseFloatingTableProperties, parseTable, parseTableBorders, parseTableCell, parseTableCellProperties, parseTableGrid, parseTableLook, parseTableMeasurement, parseTableProperties, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };

package/dist/docx/tableParser.js

@@ -1,4 +1,5 @@
 import { NO_MODELLED_ATTRIBUTES, attributeRemainder } from "./attributeRemainder.js";
+import { blockCustomXmlShell } from "./blockCustomXmlShell.js";
 import { parseBookmarkEnd, parseBookmarkStart } from "./bookmarkParser.js";
 import { parseBorderSpec } from "./borderParser.js";
 import { CAPTURE, dispatchChildrenWithContext, keptUnless, ownedElsewhere, sequencePositions, withPreservedChildren } from "./containerChildren.js";
@@ -14,6 +15,7 @@ import { parsePropertyChangeInfo, parseTrackedChangeInfo } from "./trackedChange
 import { percentageSpelling, transitionalSlotEncoding } from "./transitionalSpelling.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, findChild, findChildren, findWordprocessingChild, getAttribute, getAttributeByNamespaceUri, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseOnOffAttribute, parseTableMeasurementValue, selectAlternateContentBranch } from "./xmlParser.js";
+import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 //#region src/docx/tableParser.ts
 /**
 * Sanity cap on `w:gridSpan` (and the derived table column count). Word's
@@ -556,6 +558,12 @@ function parseTableCellVerticalMergeRevisionValue(value) {
 	if (value === "cont") return "continue";
 	if (value === "rest") return "rest";
 }
+function isTableCellMergeRevisionValue(value) {
+	return value === "continue" || value === "rest";
+}
+function isTableCellMergeRevisionContinuation(value) {
+	return value === "continue";
+}
 const ROW_PROPERTY_HANDLERS = {
 	cnfStyle: (child, formatting) => {
 		const conditionalFormat = parseConditionalFormatStyle(child);
@@ -755,13 +763,35 @@ function parseTableCellProperties(tcPrElement) {
 	if (preserved) formatting.preserved = preserved;
 	return withSourceXml(formatting, tcPrElement);
 }
+const createCustomXmlWrapper = (element, identity) => ({
+	id: identity.next++,
+	...blockCustomXmlShell(element)
+});
+const recordCustomXmlWrapper = (wrapped, wrapper) => {
+	for (const item of wrapped) item.carrierStack = [{
+		type: "customXml",
+		wrapper
+	}, ...item.carrierStack ?? []];
+};
 const recordContentControl = (wrapped, carriers, sdtElement) => {
 	const properties = parseSdtProperties(findWordprocessingChild(sdtElement, "sdtPr"), findWordprocessingChild(sdtElement, "sdtEndPr"));
 	const siblings = captureSdtSiblingMarkers(sdtElement);
 	if (siblings.before.length > 0) properties.rawSdtChildrenBeforeContent = siblings.before;
 	if (siblings.after.length > 0) properties.rawSdtChildrenAfterContent = siblings.after;
-	for (const item of wrapped) item.contentControls = [properties, ...item.contentControls ?? []];
-	for (const item of carriers) item.contentControls = [properties, ...item.contentControls ?? []];
+	for (const item of wrapped) {
+		item.contentControls = [properties, ...item.contentControls ?? []];
+		item.carrierStack = [{
+			type: "sdt",
+			properties
+		}, ...item.carrierStack ?? []];
+	}
+	for (const item of carriers) {
+		item.contentControls = [properties, ...item.contentControls ?? []];
+		item.carrierStack = [{
+			type: "sdt",
+			properties
+		}, ...item.carrierStack ?? []];
+	}
 };
 /**
 * Accumulate a table container's own `xmlns:*` onto the inherited in-scope set,
@@ -779,7 +809,7 @@ const findLastFlowBlock = (blocks) => {
 	for (let index = blocks.length - 1; index >= 0; index -= 1) {
 		const block = blocks[index];
 		if (block?.type === "paragraph" || block?.type === "table") return block;
-		if (block?.type === "blockSdt") {
+		if (block?.type === "blockSdt" || block?.type === "blockCustomXml") {
 			const nested = findLastFlowBlock(block.content);
 			if (nested) return nested;
 		}
@@ -825,6 +855,19 @@ const CELL_CONTENT_HANDLERS = {
 			})
 		});
 	},
+	customXml: (child, { resources, options, modelled }) => {
+		const customXml = {
+			type: "blockCustomXml",
+			...blockCustomXmlShell(child),
+			content: parseCellChildren({
+				element: child,
+				resources,
+				options: withContainerXmlns(options, child),
+				requireTrailingParagraph: false
+			})
+		};
+		modelled.push(customXml);
+	},
 	bookmarkStart: (child, { modelled }) => {
 		modelled.push(parseBookmarkStart(child));
 	},
@@ -836,7 +879,6 @@ const CELL_CONTENT_HANDLERS = {
 	altChunk: CAPTURE,
 	commentRangeEnd: CAPTURE,
 	commentRangeStart: CAPTURE,
-	customXml: CAPTURE,
 	customXmlDelRangeEnd: CAPTURE,
 	customXmlDelRangeStart: CAPTURE,
 	customXmlInsRangeEnd: CAPTURE,
@@ -959,6 +1001,21 @@ const ROW_CONTENT_HANDLERS = {
 		}
 		recordContentControl(wrapped, [...preservedChildren.slice(firstCaptured), ...bookmarks.slice(firstBookmark)], child);
 	},
+	customXml: (child, walk) => {
+		const firstWrapped = walk.row.cells.length;
+		const firstCaptured = walk.preservedChildren.length;
+		const firstBookmark = walk.bookmarks.length;
+		dispatchRowChildren(child, walk);
+		if (walk.row.cells.length === firstWrapped) {
+			walk.preservedChildren.splice(firstCaptured);
+			walk.bookmarks.splice(firstBookmark);
+			return CAPTURE;
+		}
+		const wrapper = createCustomXmlWrapper(child, walk.customXmlIdentity);
+		recordCustomXmlWrapper(walk.row.cells.slice(firstWrapped), wrapper);
+		recordCustomXmlWrapper(walk.preservedChildren.slice(firstCaptured), wrapper);
+		recordCustomXmlWrapper(walk.bookmarks.slice(firstBookmark), wrapper);
+	},
 	bookmarkStart: (child, { row, bookmarks }) => {
 		bookmarks.push({
 			index: row.cells.length,
@@ -974,7 +1031,7 @@ const ROW_CONTENT_HANDLERS = {
 	...ROW_CHILD_OWNERS,
 	commentRangeEnd: CAPTURE,
 	commentRangeStart: CAPTURE,
-	customXml: CAPTURE,
+	customXmlPr: CAPTURE,
 	customXmlDelRangeEnd: CAPTURE,
 	customXmlDelRangeStart: CAPTURE,
 	customXmlInsRangeEnd: CAPTURE,
@@ -994,7 +1051,13 @@ const ROW_CONTENT_HANDLERS = {
 	permEnd: CAPTURE,
 	permStart: CAPTURE,
 	proofErr: CAPTURE,
-	tr: CAPTURE
+	tr: (child, { options }) => {
+		options.context?.warn({
+			code: PARSE_WARNING_CODES.nestedRowOpaque,
+			element: child.name ?? "w:tr"
+		});
+		return CAPTURE;
+	}
 };
 /**
 * One row's children, or a cell-level content control's.
@@ -1055,7 +1118,8 @@ function parseTableRow(trElement, styles, theme, numbering, rels, media, options
 		options: withContainerXmlns(options, trElement),
 		row,
 		bookmarks,
-		preservedChildren
+		preservedChildren,
+		customXmlIdentity: { next: 0 }
 	});
 	if (preservedChildren.length > 0) row.preserved = { children: preservedChildren };
 	if (bookmarks.length > 0) row.bookmarks = bookmarks;
@@ -1167,6 +1231,21 @@ const TABLE_CONTENT_HANDLERS = {
 		}
 		recordContentControl(wrapped, [...preservedChildren.slice(firstCaptured), ...bookmarks.slice(firstBookmark)], child);
 	},
+	customXml: (child, walk) => {
+		const firstWrapped = walk.table.rows.length;
+		const firstCaptured = walk.preservedChildren.length;
+		const firstBookmark = walk.bookmarks.length;
+		dispatchTableChildren(child, walk);
+		if (walk.table.rows.length === firstWrapped) {
+			walk.preservedChildren.splice(firstCaptured);
+			walk.bookmarks.splice(firstBookmark);
+			return CAPTURE;
+		}
+		const wrapper = createCustomXmlWrapper(child, walk.customXmlIdentity);
+		recordCustomXmlWrapper(walk.table.rows.slice(firstWrapped), wrapper);
+		recordCustomXmlWrapper(walk.preservedChildren.slice(firstCaptured), wrapper);
+		recordCustomXmlWrapper(walk.bookmarks.slice(firstBookmark), wrapper);
+	},
 	...TABLE_CHILD_OWNERS,
 	bookmarkStart: (child, { table, bookmarks }) => {
 		bookmarks.push({
@@ -1182,7 +1261,6 @@ const TABLE_CONTENT_HANDLERS = {
 	},
 	commentRangeEnd: CAPTURE,
 	commentRangeStart: CAPTURE,
-	customXml: CAPTURE,
 	customXmlPr: CAPTURE,
 	customXmlDelRangeEnd: CAPTURE,
 	customXmlDelRangeStart: CAPTURE,
@@ -1269,7 +1347,8 @@ function parseTable(tblElement, styles, theme, numbering, rels, media, options)
 		table,
 		rowsWithGridOffsets,
 		bookmarks,
-		preservedChildren
+		preservedChildren,
+		customXmlIdentity: { next: 0 }
 	});
 	if (table.rows.length === 0) return;
 	if (preservedChildren.length > 0) table.preserved = { children: preservedChildren };
@@ -1382,4 +1461,4 @@ function isFloatingTable(table) {
 	return table.formatting?.floating !== void 0;
 }
 //#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, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };
+export { CELL_CONTENT_HANDLERS, MAX_TABLE_COLUMNS, ROW_CONTENT_HANDLERS, TABLE_CONTENT_HANDLERS, getHeaderRows, getTableColumnCount, getTableRowCount, getTableText, hasHeaderRow, isCellHorizontallyMerged, isCellMergeContinuation, isCellMergeStart, isFloatingTable, isTableCellMergeRevisionContinuation, isTableCellMergeRevisionValue, parseCellMargins, parseConditionalFormatStyle, parseFloatingTableProperties, parseTable, parseTableBorders, parseTableCell, parseTableCellProperties, parseTableGrid, parseTableLook, parseTableMeasurement, parseTableProperties, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };

package/dist/docx/textBoxParser.js

@@ -300,7 +300,7 @@ const getTextBoxBlockText = (block) => {
 		return runTexts.join("");
 	}
 	if (block.type === "table") return block.rows.map((row) => row.cells.map((cell) => cell.content.map(getTextBoxBlockText).join("\n")).join("	")).join("\n");
-	if (block.type !== "blockSdt") return "";
+	if (block.type !== "blockSdt" && block.type !== "blockCustomXml") return "";
 	return block.content.map(getTextBoxBlockText).join("\n");
 };
 /**

package/dist/docx/unzip.d.ts

@@ -25,6 +25,13 @@ type DocxUnzipLimits = {
    * memory as bytes, not on what the parsed structure retains.
    */
   maxTotalUncompressedBytes: number;
+  /**
+   * Inflated bytes allowed per compressed byte, for each markup or text entry
+   * and for the package as a whole. Binary entries are bounded by the byte
+   * limits and the package ratio only, and entries and packages under 4 MiB
+   * inflated are exempt.
+   */
+  maxCompressionRatio: number;
   /** Elements allowed in one XML part, counted before any tree is built. */
   maxXmlElementsPerPart: number;
   /** Attributes allowed in one XML part, counted before any tree is built. */
@@ -75,13 +82,24 @@ type RawDocxContent = {
   /** True when the input was a password-protected CFB container. */
   wasEncrypted: boolean;
 };
+/** How {@link unzipDocx} treats the parts it does not extract. */
+type UnzipDocxBehavior = {
+  /**
+   * Inflate every part the unzip does not extract, within its declared size,
+   * so a later read of the returned package can trust that size. Callers
+   * that discard the package after reading the extracted parts can skip it.
+   * Defaults to `true`.
+   */
+  verifyUnreadEntries?: boolean;
+};
 /**
  * Extract all content from a DOCX file
  *
  * @param buffer - DOCX file as ArrayBuffer
  * @returns Promise resolving to extracted content
  */
-declare function unzipDocx(buffer: ArrayBuffer, options?: DocxUnzipOptions): Promise<RawDocxContent>;
+declare function unzipDocx(buffer: ArrayBuffer, options?: DocxUnzipOptions, { verifyUnreadEntries }?: UnzipDocxBehavior): Promise<RawDocxContent>;
+declare function getEntryUncompressedSize(file: JSZip.JSZipObject): number | null;
 /**
  * Get a list of all files in the DOCX
  *
@@ -142,4 +160,4 @@ declare function getContentSummary(content: RawDocxContent): {
   totalFiles: number;
 };
 //#endregion
-export { DocxSecurityError, DocxUnzipLimits, DocxUnzipOptions, RawDocxContent, extractFile, getContentSummary, getFileList, getMediaMimeType, hasFile, mediaToDataUrl, unzipDocx };
+export { DocxSecurityError, DocxUnzipLimits, DocxUnzipOptions, RawDocxContent, UnzipDocxBehavior, extractFile, getContentSummary, getEntryUncompressedSize, getFileList, getMediaMimeType, hasFile, mediaToDataUrl, unzipDocx };