@stll/folio-core 0.47.7 → 0.48.0

package/dist/docx/previewBudget.d.ts

@@ -1,28 +1,5 @@
+import { document_d_exports } from "../types/document.js";
 //#region src/docx/previewBudget.d.ts
-/**
- * Every synthetic preview a parse attaches to the model, and the budget each
- * one answers to.
- *
- * A preview is not document content. It is a drawing folio makes up so a shape
- * it cannot project still occupies the page, and the package round-trips from
- * its preserved XML whether the preview exists or not. So a preview is the one
- * thing in the model that may be dropped, and a package that would retain more
- * of it than it is worth has it dropped rather than being refused.
- *
- * Producer and budget have to agree on what a preview looks like. They used to
- * agree by coincidence: the VML producer wrote its filename as a literal and
- * the budget recognized it as a constant in another file, so renaming one
- * would have stopped the other charging for it without anything failing. The
- * table below is that agreement written once, and a producer builds its image
- * out of the entry the budget matches against.
- *
- * An entry says what backs the preview, because that decides what there is to
- * agree on. A source-backed preview is image data in `src`, recognized by the
- * strings its producer stamps on it and charged by the character. A
- * descriptor-backed preview is no picture at all, so it carries none of those
- * strings: a table that offered them would be offering a cap over nothing and
- * a prefix nothing can start with.
- */
 type PreviewKindName = "vmlShape" | "wpGroup" | "smartArt";
 declare const PREVIEW_KINDS: {
   /** A VML shape folio renders rather than projects (`v:shape`, `v:rect`, ...). */
@@ -39,9 +16,9 @@ declare const PREVIEW_KINDS: {
    * The group's shapes, their text and any picture they carry are drawn into
    * one SVG, so a package with many groups retains as much generated text as a
    * package of VML shapes does, from a producer bounded per drawing the same
-   * way. It was missing from this table, which is not a preview with a generous
-   * cap but a preview with none: the matcher below never named it, so no
-   * package was ever charged for one.
+   * way. It was once missing from this table, which was not a preview with a
+   * generous cap but a preview with none: the budget never recognized it, so
+   * no package was ever charged for one.
    */
   readonly wpGroup: {
     readonly backing: "source";
@@ -75,11 +52,56 @@ type SourceBackedKindName = { [Name in PreviewKindName]: (typeof PREVIEW_KINDS)[
  */
 type PreviewBudgetOverrides = Partial<Record<SourceBackedKindName, number>>;
 /**
- * Charge every generated preview in the model against its kind's allowance and
- * drop the `src` of those past it. Dropping leaves the image in place with its
- * size and wrap, so the page still reserves the space the drawing occupies,
- * and never touches the preserved XML the package saves from.
+ * Everything a preview image states except what the ledger stamps on it: its
+ * geometry, wrap, position and names. A preview has no relationship behind
+ * it, so its frame cannot name one.
+ */
+type PreviewFrame = Omit<document_d_exports.Image, "type" | "rId" | "src" | "mimeType" | "filename">;
+/** The one way a producer builds a preview image. */
+type PreviewLedger = {
+  /**
+   * Build a `kind` preview that draws `svg` over `frame`, registered against
+   * the package's allowance for that kind.
+   */
+  readonly svgImage: (kind: SourceBackedKindName, svg: string, frame: PreviewFrame) => document_d_exports.Image;
+  /**
+   * Withdraw every preview inside content the parse built and then discarded,
+   * so it spends no allowance. Walks only `discarded`.
+   */
+  readonly release: (discarded: unknown) => void;
+};
+/** One parse's ledger, and the budget that charges it. */
+type PackagePreviewBudget = {
+  readonly ledger: PreviewLedger;
+  /**
+   * Charge every registered preview against its kind's allowance and drop the
+   * `src` of those past it. Dropping leaves the image in place with its size
+   * and wrap, so the page still reserves the space the drawing occupies, and
+   * never touches the preserved XML the package saves from.
+   *
+   * Previews are charged in the order the parse built them, which is the
+   * order it read the parts: the body (a text box's content right after the
+   * paragraph that anchors it), then headers and footers in relationship
+   * order, footnotes, endnotes, and comments last. Past an allowance, the
+   * previews built first keep their `src`.
+   */
+  readonly enforce: (overrides?: PreviewBudgetOverrides) => void;
+};
+/**
+ * One parse's previews and their budget.
+ *
+ * A parse that builds content and then discards it (a note repeating an id, a
+ * separator note, a duplicate comment, a watermark's host paragraph) releases
+ * that content, or its previews would spend allowance no retained preview can
+ * use. A missed release errs towards dropping a preview, never towards
+ * retaining more than the cap; the budget's tests pin that a package's ledger
+ * holds exactly the previews its model carries.
+ */
+declare const createPackagePreviewBudget: () => PackagePreviewBudget;
+/**
+ * A ledger for a read that builds no package: one part parsed on its own,
+ * whose previews no package budget charges.
  */
-declare const enforcePackagePreviewBudget: (root: unknown, overrides?: PreviewBudgetOverrides) => void;
+declare const standalonePreviewLedger: () => PreviewLedger;
 //#endregion
-export { PREVIEW_KINDS, PreviewBudgetOverrides, enforcePackagePreviewBudget };
+export { PackagePreviewBudget, PreviewBudgetOverrides, PreviewLedger, createPackagePreviewBudget, standalonePreviewLedger };

package/dist/docx/previewBudget.js

@@ -21,9 +21,9 @@ const PREVIEW_KINDS = {
 	* The group's shapes, their text and any picture they carry are drawn into
 	* one SVG, so a package with many groups retains as much generated text as a
 	* package of VML shapes does, from a producer bounded per drawing the same
-	* way. It was missing from this table, which is not a preview with a generous
-	* cap but a preview with none: the matcher below never named it, so no
-	* package was ever charged for one.
+	* way. It was once missing from this table, which was not a preview with a
+	* generous cap but a preview with none: the budget never recognized it, so
+	* no package was ever charged for one.
 	*/
 	wpGroup: {
 		backing: "source",
@@ -45,75 +45,69 @@ const PREVIEW_KINDS = {
 	*/
 	smartArt: { backing: "descriptor" }
 };
-const KIND_NAMES = Object.keys(PREVIEW_KINDS);
 /**
-* Whether a package charges this kind, narrowing the name to a source-backed
-* one: the predicate reads the same field `SourceBackedKindName` selects on.
-*/
-const isSourceBacked = (name) => {
-	const kind = PREVIEW_KINDS[name];
-	switch (kind.backing) {
-		case "source": return true;
-		case "descriptor": return false;
-		default: return kind;
-	}
-};
-const SOURCE_BACKED_KIND_NAMES = KIND_NAMES.filter(isSourceBacked);
-/**
-* The kind a model image was generated as, or `undefined` for one the package
-* actually carries. A generated preview has no relationship behind it; the
-* filename and data-URL prefix name which producer made it.
-*
-* "No relationship" is read as the one spelling `RelationshipId` leaves: a
-* field that is absent or `undefined`. The walk takes an unvalidated object,
-* so the check stays, but it no longer has a second spelling to accept.
+* One parse's previews and their budget.
 *
-* Only a source-backed kind can be named this way. A descriptor-backed preview
-* has no `src` to match, so no image the model carries can be charged to it.
-*/
-const previewKindOf = (value) => {
-	if (!("type" in value) || value.type !== "image" || "rId" in value && value.rId !== void 0 || !("src" in value) || typeof value.src !== "string" || !("mimeType" in value) || !("filename" in value)) return;
-	const { src, mimeType, filename } = value;
-	return SOURCE_BACKED_KIND_NAMES.find((name) => {
-		const kind = PREVIEW_KINDS[name];
-		return mimeType === kind.mimeType && filename === kind.filename && src.startsWith(kind.srcPrefix);
-	});
-};
-/**
-* Charge every generated preview in the model against its kind's allowance and
-* drop the `src` of those past it. Dropping leaves the image in place with its
-* size and wrap, so the page still reserves the space the drawing occupies,
-* and never touches the preserved XML the package saves from.
+* A parse that builds content and then discards it (a note repeating an id, a
+* separator note, a duplicate comment, a watermark's host paragraph) releases
+* that content, or its previews would spend allowance no retained preview can
+* use. A missed release errs towards dropping a preview, never towards
+* retaining more than the cap; the budget's tests pin that a package's ledger
+* holds exactly the previews its model carries.
 */
-const enforcePackagePreviewBudget = (root, overrides = {}) => {
-	const remaining = new Map(SOURCE_BACKED_KIND_NAMES.map((name) => [name, Math.max(0, overrides[name] ?? PREVIEW_KINDS[name].maxPackageCharacters)]));
-	const visited = /* @__PURE__ */ new WeakSet();
-	const visit = (value) => {
-		if (value === null || typeof value !== "object" || visited.has(value)) return;
-		visited.add(value);
-		if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return;
-		if (value instanceof Map) {
-			for (const child of value.values()) visit(child);
+const createPackagePreviewBudget = () => {
+	const entries = [];
+	const registered = /* @__PURE__ */ new WeakSet();
+	const released = /* @__PURE__ */ new WeakSet();
+	const release = (value, seen) => {
+		if (value === null || typeof value !== "object" || seen.has(value) || value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return;
+		seen.add(value);
+		if (registered.has(value)) {
+			released.add(value);
 			return;
 		}
-		if (Array.isArray(value)) {
-			for (const child of value) visit(child);
-			return;
-		}
-		const kind = previewKindOf(value);
-		if (kind !== void 0) {
-			const image = value;
-			const length = image.src.length;
-			const left = remaining.get(kind);
-			if (length <= left) remaining.set(kind, left - length);
-			else {
-				remaining.set(kind, 0);
-				delete image.src;
+		for (const child of value instanceof Map ? value.values() : Object.values(value)) release(child, seen);
+	};
+	return {
+		ledger: {
+			svgImage: (kind, svg, frame) => {
+				const { srcPrefix, mimeType, filename } = PREVIEW_KINDS[kind];
+				const image = {
+					type: "image",
+					src: `${srcPrefix}${encodeURIComponent(svg)}`,
+					mimeType,
+					filename,
+					...frame
+				};
+				entries.push({
+					kind,
+					image
+				});
+				registered.add(image);
+				return image;
+			},
+			release: (discarded) => {
+				release(discarded, /* @__PURE__ */ new WeakSet());
+			}
+		},
+		enforce: (overrides = {}) => {
+			const remaining = /* @__PURE__ */ new Map();
+			for (const { kind, image } of entries) {
+				if (image.src === void 0 || released.has(image)) continue;
+				const left = remaining.get(kind) ?? Math.max(0, overrides[kind] ?? PREVIEW_KINDS[kind].maxPackageCharacters);
+				if (image.src.length <= left) remaining.set(kind, left - image.src.length);
+				else {
+					remaining.set(kind, 0);
+					delete image.src;
+				}
 			}
 		}
-		for (const child of Object.values(value)) visit(child);
 	};
-	visit(root);
 };
+/**
+* A ledger for a read that builds no package: one part parsed on its own,
+* whose previews no package budget charges.
+*/
+const standalonePreviewLedger = () => createPackagePreviewBudget().ledger;
 //#endregion
-export { PREVIEW_KINDS, enforcePackagePreviewBudget };
+export { createPackagePreviewBudget, standalonePreviewLedger };

package/dist/docx/rezip.js

@@ -4,10 +4,10 @@ import { isAllowedExternalWatermarkImageUrl } from "../watermark/index.js";
 import { appVersionInSchemaForm, normalizeAppVersionInExtendedProperties } from "./appVersionNormalization.js";
 import { withoutOrphanCommentRanges } from "./commentRangeIntegrity.js";
 import { applyReplyThreadMarkers } from "./commentReplyMarkers.js";
+import { readDocumentSectionFacts } from "./documentSectionFacts.js";
 import { normalizeDrawingIds } from "./drawingIdNormalization.js";
 import { rebindDrawingImageRelationship } from "./drawingRelationships.js";
 import { parseEndnotes, parseFootnotes } from "./footnoteParser.js";
-import { parseHeaderFooterType } from "./headerFooterRefParser.js";
 import { assertValidFolioDocumentModel } from "./modelValidation.js";
 import { isNewDataUrlDrawing } from "./newImage.js";
 import { missingNoteReferenceStyles, noteReferenceNeeds } from "./noteReferenceStyles.js";
@@ -30,8 +30,7 @@ import { readRootNamespaceBindings } from "./serializer/partNamespaces.js";
 import { serializeSettingsXml } from "./serializer/settingsSerializer.js";
 import { serializeStyle, serializeStylesXml } from "./serializer/stylesSerializer.js";
 import { serializeThemeXml } from "./serializer/themeSerializer.js";
-import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, WORDPROCESSINGML_NAMESPACE_URIS, findChild, findChildByNamespaceUri, findChildrenByNamespaceUri, getAttribute, getAttributeByNamespaceUri, getChildElements, getLocalName, getNamespaceUri, matchesName, parseXml, parseXmlDocument } from "./xmlParser.js";
-import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, findChildByNamespaceUri, findChildrenByNamespaceUri, getAttribute, getAttributeByNamespaceUri, getChildElements, getLocalName, getNamespaceUri, matchesName, parseXml, parseXmlDocument } from "./xmlParser.js";
 import { TaggedError, panic } from "better-result";
 import { escapeXmlAttribute, escapeXmlText, validateDocxPackage } from "@stll/docx-core";
 import { mintRelationshipId } from "@stll/docx-core/model";
@@ -108,47 +107,6 @@ function findMaxRId(relsXml) {
 	}
 	return maxId;
 }
-const isWordprocessingElement = (element, localName) => getLocalName(element.name) === localName && WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(element) ?? "");
-const countDocumentSections = (xml) => {
-	assertXmlResourceLimits({ xml });
-	let count = 0;
-	const pending = [{
-		element: parseXml(xml),
-		insidePropertyChange: false
-	}];
-	while (pending.length > 0) {
-		const current = pending.pop();
-		if (!current) break;
-		const { element, insidePropertyChange } = current;
-		const isPropertyChange = isWordprocessingElement(element, "sectPrChange");
-		if (!insidePropertyChange && isWordprocessingElement(element, "sectPr")) count += 1;
-		for (const child of getChildElements(element)) pending.push({
-			element: child,
-			insidePropertyChange: insidePropertyChange || isPropertyChange
-		});
-	}
-	return count;
-};
-const extractHeaderFooterReferences = (xml) => {
-	const references = [];
-	assertXmlResourceLimits({ xml });
-	const pending = [parseXml(xml)];
-	while (pending.length > 0) {
-		const node = pending.pop();
-		if (!node) break;
-		const element = getLocalName(node.name);
-		if ((element === "headerReference" || element === "footerReference") && isWordprocessingElement(node, element)) {
-			const rId = getAttributeByNamespaceUri(node, OFFICE_RELATIONSHIP_NAMESPACE_URIS, "id");
-			if (rId) references.push({
-				element,
-				type: parseHeaderFooterType(getAttributeByNamespaceUri(node, WORDPROCESSINGML_NAMESPACE_URIS, "type")),
-				rId
-			});
-		}
-		pending.push(...getChildElements(node));
-	}
-	return references;
-};
 const hasParsedHeaderFooterPart = (doc, ref) => {
 	return (ref.element === "headerReference" ? doc.package.headers : doc.package.footers)?.has(ref.rId) ?? false;
 };
@@ -201,9 +159,10 @@ const assertSectionCarriersMatchModel = ({ doc, serializedSectionCount }) => {
 	const modelSectionCount = carriers.length + (finalSectionProperties === void 0 ? 0 : 1);
 	if (serializedSectionCount !== modelSectionCount) throw new DocxPackageFidelityError(`Full DOCX repack would write ${serializedSectionCount} sections where the editor holds ${modelSectionCount}.`);
 };
-function assertDocumentPackageFidelity({ originalDocumentXml, serializedDocumentXml, doc, sectionEndpointRemoval, sectionReferenceRemovals = [] }) {
-	const originalSectionCount = countDocumentSections(originalDocumentXml);
-	const serializedSectionCount = countDocumentSections(serializedDocumentXml);
+function assertDocumentPackageFidelity({ originalDocumentFacts, serializedDocumentXml, doc, sectionEndpointRemoval, sectionReferenceRemovals = [] }) {
+	const serializedDocumentFacts = readDocumentSectionFacts(serializedDocumentXml);
+	const originalSectionCount = originalDocumentFacts.sectionCount;
+	const serializedSectionCount = serializedDocumentFacts.sectionCount;
 	const trackedRemovedSectionCount = sectionEndpointRemoval ? sectionEndpointRemoval.sourceParagraphEndpointCount - sectionEndpointRemoval.expectedParagraphEndpointCount : 0;
 	const exactTrackedSectionRemoval = trackedRemovedSectionCount > 0 && originalSectionCount - trackedRemovedSectionCount === serializedSectionCount && serializedSectionCount < originalSectionCount;
 	if (serializedSectionCount < originalSectionCount && !exactTrackedSectionRemoval) throw new DocxPackageFidelityError("Full DOCX repack would drop section properties. Use selective patching instead.");
@@ -212,14 +171,14 @@ function assertDocumentPackageFidelity({ originalDocumentXml, serializedDocument
 		serializedSectionCount
 	});
 	const serializedReferenceCounts = /* @__PURE__ */ new Map();
-	for (const reference of extractHeaderFooterReferences(serializedDocumentXml)) incrementReferenceCount(serializedReferenceCounts, headerFooterReferenceKey(reference));
+	for (const reference of serializedDocumentFacts.headerFooterReferences) incrementReferenceCount(serializedReferenceCounts, headerFooterReferenceKey(reference));
 	const removedReferenceCounts = /* @__PURE__ */ new Map();
 	if (exactTrackedSectionRemoval && sectionEndpointRemoval) for (const { part, type, relationshipId } of sectionEndpointRemoval.removedReferences) incrementReferenceCount(removedReferenceCounts, `${part}Reference:${type}:${relationshipId}`);
 	const resolvedReferenceCounts = /* @__PURE__ */ new Map();
 	for (const { part, type, relationshipId } of sectionReferenceRemovals) incrementReferenceCount(resolvedReferenceCounts, `${part}Reference:${type}:${relationshipId}`);
 	for (const [key, count] of resolvedReferenceCounts) removedReferenceCounts.set(key, Math.max(count, removedReferenceCounts.get(key) ?? 0));
 	const missingRefs = [];
-	for (const reference of extractHeaderFooterReferences(originalDocumentXml)) {
+	for (const reference of originalDocumentFacts.headerFooterReferences) {
 		if (!hasParsedHeaderFooterPart(doc, reference)) continue;
 		const key = headerFooterReferenceKey(reference);
 		if (consumeReferenceCount(serializedReferenceCounts, key) || consumeReferenceCount(removedReferenceCounts, key)) continue;
@@ -614,6 +573,30 @@ const generateDocxZip = async (zip, compressionLevel) => {
 		compressionOptions: { level: compressionLevel }
 	});
 };
+/**
+* Section facts of each source package's `word/document.xml`, keyed by the
+* source buffer. Hosts save repeatedly against one baseline buffer, often
+* through a fresh `Document` each time, so the buffer is the identity that
+* survives between saves. The facts are reused only while the part read from
+* it is still the same string, so a buffer rewritten in place is read again.
+*/
+const sourceDocumentSectionFacts = /* @__PURE__ */ new WeakMap();
+const originalDocumentPart = (buffer, xml) => {
+	if (xml === void 0) return;
+	return {
+		xml,
+		sectionFacts: () => {
+			const cached = sourceDocumentSectionFacts.get(buffer);
+			if (cached?.xml === xml) return cached.facts;
+			const facts = readDocumentSectionFacts(xml);
+			sourceDocumentSectionFacts.set(buffer, {
+				xml,
+				facts
+			});
+			return facts;
+		}
+	};
+};
 const parsedZipSources = /* @__PURE__ */ new WeakMap();
 const loadParsedZipSource = async (document, buffer) => {
 	const cached = parsedZipSources.get(document);
@@ -624,7 +607,7 @@ const loadParsedZipSource = async (document, buffer) => {
 	const source = {
 		buffer,
 		zip,
-		documentXml,
+		document: originalDocumentPart(buffer, documentXml),
 		corePropertiesXml
 	};
 	parsedZipSources.set(document, source);
@@ -644,7 +627,7 @@ const normalizeExportDrawingIds = ({ package: docxPackage }) => {
 		...docxPackage.endnotes !== void 0 ? { endnotes: docxPackage.endnotes } : {}
 	});
 };
-const finishRepack = async ({ document, originalZip, outputZip, originalDocumentXml, originalCorePropertiesXml, compressionLevel, updateModifiedDate, modifiedBy, changedNoteParaIds, sectionEndpointRemoval, sectionReferenceRemovals }) => {
+const finishRepack = async ({ document, originalZip, outputZip, originalDocument, originalCorePropertiesXml, compressionLevel, updateModifiedDate, modifiedBy, changedNoteParaIds, sectionEndpointRemoval, sectionReferenceRemovals }) => {
 	await materializeNewHeaderFooterParts(document, outputZip, compressionLevel);
 	await materializeEmbeddedMedia({
 		document,
@@ -657,9 +640,9 @@ const finishRepack = async ({ document, originalZip, outputZip, originalDocument
 	await processNewHyperlinks(parts, outputZip, compressionLevel);
 	assertValidFolioDocumentModel(document, "Cannot repack invalid DOCX document model");
 	applyReplyThreadMarkers(document);
-	const documentXml = serializeDocument(document, originalDocumentXml === void 0 ? void 0 : readRootNamespaceBindings(originalDocumentXml));
-	if (originalDocumentXml) assertDocumentPackageFidelity({
-		originalDocumentXml,
+	const documentXml = serializeDocument(document, originalDocument === void 0 ? void 0 : readRootNamespaceBindings(originalDocument.xml));
+	if (originalDocument?.xml) assertDocumentPackageFidelity({
+		originalDocumentFacts: originalDocument.sectionFacts(),
 		serializedDocumentXml: documentXml,
 		doc: document,
 		...sectionEndpointRemoval !== void 0 && { sectionEndpointRemoval },
@@ -712,7 +695,7 @@ async function repackDocxWithSectionEndpointRemoval({ document: doc, options, se
 		document: exportDocument,
 		originalZip,
 		outputZip: newZip,
-		originalDocumentXml,
+		originalDocument: originalDocumentPart(doc.originalBuffer, originalDocumentXml),
 		originalCorePropertiesXml,
 		compressionLevel,
 		updateModifiedDate,
@@ -770,7 +753,7 @@ async function repackDocxFromRaw(doc, rawContent, options = {}) {
 	applyReplyThreadMarkers(exportDocument);
 	const documentXml = serializeDocument(exportDocument, rawContent.documentXml ? readRootNamespaceBindings(rawContent.documentXml) : void 0);
 	if (rawContent.documentXml) assertDocumentPackageFidelity({
-		originalDocumentXml: rawContent.documentXml,
+		originalDocumentFacts: readDocumentSectionFacts(rawContent.documentXml),
 		serializedDocumentXml: documentXml,
 		doc: exportDocument
 	});
@@ -1790,7 +1773,7 @@ async function createDocx(doc, properties = {}) {
 			document: withoutOrphanCommentRanges(doc),
 			originalZip: source.zip,
 			outputZip: cloneDocxZip(source.zip),
-			originalDocumentXml: source.documentXml,
+			originalDocument: source.document,
 			originalCorePropertiesXml: source.corePropertiesXml,
 			compressionLevel: 6,
 			updateModifiedDate: true
@@ -1801,7 +1784,7 @@ async function createDocx(doc, properties = {}) {
 		document: withoutOrphanCommentRanges(doc),
 		originalZip: zip,
 		outputZip: zip,
-		originalDocumentXml: void 0,
+		originalDocument: void 0,
 		originalCorePropertiesXml: await zip.file("docProps/core.xml")?.async("text"),
 		compressionLevel: 6,
 		updateModifiedDate: true

package/dist/docx/runParser.d.ts

@@ -1,5 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
+import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 //#region src/docx/runParser.d.ts
 /**
@@ -71,9 +72,11 @@ declare function parseRunProperties(rPr: XmlElement | null, theme: document_d_ex
  * @param theme - Theme for resolving theme colors/fonts
  * @param rels - Relationship map for resolving image references
  * @param media - Media files map for image data
+ * @param previews - The ledger of the package this run belongs to; a run read
+ *   on its own charges its previews to no package
  * @returns Parsed Run object
  */
-declare function parseRun(node: XmlElement, _styles: StyleMap | null, theme: document_d_exports.Theme | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, rootXmlns?: Record<string, string>): document_d_exports.Run;
+declare function parseRun(node: XmlElement, _styles: StyleMap | null, theme: document_d_exports.Theme | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, rootXmlns?: Record<string, string>, previews?: PreviewLedger): document_d_exports.Run;
 /**
  * Get plain text from a run
  *