@stll/folio-core 0.47.6 → 0.48.0

package/dist/docx/footnoteParser.js

@@ -1,6 +1,7 @@
 import { blockPlainText } from "./blockPlainText.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
 import { parseParagraph } from "./paragraphParser.js";
+import { standalonePreviewLedger } from "./previewBudget.js";
 import { captureSdtSiblingMarkers, parseSdtProperties } from "./sdtProperties.js";
 import { parseTable } from "./tableParser.js";
 import { findChildren, findWordprocessingChild, getAttributes, getChildElements, getLocalName, parseXml } from "./xmlParser.js";
@@ -27,13 +28,13 @@ function parseNoteId(element) {
 	const parsed = Number.parseInt(id, 10);
 	return Number.isNaN(parsed) ? 0 : parsed;
 }
-function parseNoteBlockContent(element, styles, theme, numbering, rels, media) {
+function parseNoteBlockContent(element, styles, theme, numbering, rels, media, previews) {
 	const blocks = [];
 	for (const child of getChildElements(element)) {
 		const localName = getLocalName(child.name ?? "");
-		if (localName === "p") blocks.push(parseParagraph(child, styles, theme, numbering, rels));
+		if (localName === "p") blocks.push(parseParagraph(child, styles, theme, numbering, rels, media, { previews }));
 		else if (localName === "tbl") {
-			const table = parseTable(child, styles, theme, numbering, rels, media);
+			const table = parseTable(child, styles, theme, numbering, rels, media, { previews });
 			if (table) blocks.push(table);
 		} else if (localName === "sdt") {
 			const sdtPr = findWordprocessingChild(child, "sdtPr");
@@ -46,7 +47,7 @@ function parseNoteBlockContent(element, styles, theme, numbering, rels, media) {
 			blocks.push({
 				type: "blockSdt",
 				properties,
-				content: sdtContent ? parseNoteBlockContent(sdtContent, styles, theme, numbering, rels, media) : []
+				content: sdtContent ? parseNoteBlockContent(sdtContent, styles, theme, numbering, rels, media, previews) : []
 			});
 		}
 	}
@@ -55,12 +56,12 @@ function parseNoteBlockContent(element, styles, theme, numbering, rels, media) {
 /**
 * Parse a single footnote element (w:footnote)
 */
-function parseFootnote(element, styles, theme, numbering, rels, media) {
+function parseFootnote(element, styles, theme, numbering, rels, media, previews) {
 	return {
 		type: "footnote",
 		id: parseNoteId(element),
 		noteType: parseNoteType(getNoteAttribute(element, "type")),
-		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media)
+		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media, previews)
 	};
 }
 /**
@@ -74,7 +75,7 @@ function parseFootnote(element, styles, theme, numbering, rels, media) {
 * @param media - Media files for images
 * @returns FootnoteMap with all footnotes
 */
-function parseFootnotes(footnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context) {
+function parseFootnotes(footnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context, previews = standalonePreviewLedger()) {
 	const byId = /* @__PURE__ */ new Map();
 	const footnotes = [];
 	if (!footnotesXml) return createFootnoteMap(byId, footnotes);
@@ -82,13 +83,14 @@ function parseFootnotes(footnotesXml, styles = null, theme = null, numbering = n
 	if (!rootElement) return createFootnoteMap(byId, footnotes);
 	const footnoteElements = findChildren(rootElement, "w", "footnote");
 	for (const fnEl of footnoteElements) {
-		const footnote = parseFootnote(fnEl, styles, theme, numbering, rels, media);
+		const footnote = parseFootnote(fnEl, styles, theme, numbering, rels, media, previews);
 		if (byId.has(footnote.id)) {
 			context?.warn({
 				code: PARSE_WARNING_CODES.duplicateNoteId,
 				element: "w:footnote",
 				at: `w:id ${String(footnote.id)}`
 			});
+			previews.release(footnote);
 			continue;
 		}
 		byId.set(footnote.id, footnote);
@@ -123,12 +125,12 @@ function createFootnoteMap(byId, footnotes) {
 /**
 * Parse a single endnote element (w:endnote)
 */
-function parseEndnote(element, styles, theme, numbering, rels, media) {
+function parseEndnote(element, styles, theme, numbering, rels, media, previews) {
 	return {
 		type: "endnote",
 		id: parseNoteId(element),
 		noteType: parseNoteType(getNoteAttribute(element, "type")),
-		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media)
+		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media, previews)
 	};
 }
 /**
@@ -142,7 +144,7 @@ function parseEndnote(element, styles, theme, numbering, rels, media) {
 * @param media - Media files for images
 * @returns EndnoteMap with all endnotes
 */
-function parseEndnotes(endnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context) {
+function parseEndnotes(endnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context, previews = standalonePreviewLedger()) {
 	const byId = /* @__PURE__ */ new Map();
 	const endnotes = [];
 	if (!endnotesXml) return createEndnoteMap(byId, endnotes);
@@ -150,13 +152,14 @@ function parseEndnotes(endnotesXml, styles = null, theme = null, numbering = nul
 	if (!rootElement) return createEndnoteMap(byId, endnotes);
 	const endnoteElements = findChildren(rootElement, "w", "endnote");
 	for (const enEl of endnoteElements) {
-		const endnote = parseEndnote(enEl, styles, theme, numbering, rels, media);
+		const endnote = parseEndnote(enEl, styles, theme, numbering, rels, media, previews);
 		if (byId.has(endnote.id)) {
 			context?.warn({
 				code: PARSE_WARNING_CODES.duplicateNoteId,
 				element: "w:endnote",
 				at: `w:id ${String(endnote.id)}`
 			});
+			previews.release(endnote);
 			continue;
 		}
 		byId.set(endnote.id, endnote);

package/dist/docx/groupDrawingParser.d.ts

@@ -1,5 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
+import { PreviewLedger } from "./previewBudget.js";
 //#region src/docx/groupDrawingParser.d.ts
 /**
  * Whether a `w:drawing` carries a WordprocessingGroup payload. A group this
@@ -8,6 +9,6 @@ import { XmlElement } from "./xmlParser.js";
  */
 declare const isGroupDrawing: (drawing: XmlElement) => boolean;
 /** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
-declare const parseGroupDrawing: (drawing: XmlElement, rels?: document_d_exports.RelationshipMap, media?: Map<string, document_d_exports.MediaFile>) => document_d_exports.Image | null;
+declare const parseGroupDrawing: (drawing: XmlElement, previews: PreviewLedger, rels?: document_d_exports.RelationshipMap, media?: Map<string, document_d_exports.MediaFile>) => document_d_exports.Image | null;
 //#endregion
 export { isGroupDrawing, parseGroupDrawing };

package/dist/docx/groupDrawingParser.js

@@ -1,6 +1,5 @@
 import { emuToPixels } from "../utils/units.js";
 import { parseImage, resolveImageData } from "./imageParser.js";
-import { PREVIEW_KINDS } from "./previewBudget.js";
 import { findAllDeep, findChildByLocalName, findChildrenByLocalName, getAttribute, getChildElements, getLocalName, getTextContent, parseNumericAttribute } from "./xmlParser.js";
 import { escapeXmlAttribute, escapeXmlText } from "@stll/docx-core";
 //#region src/docx/groupDrawingParser.ts
@@ -176,17 +175,15 @@ const groupElement = (drawing) => {
 */
 const isGroupDrawing = (drawing) => groupElement(drawing) !== null;
 /** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
-const parseGroupDrawing = (drawing, rels, media) => {
+const parseGroupDrawing = (drawing, previews, rels, media) => {
 	const group = groupElement(drawing);
 	if (!group) return null;
 	const image = parseImage(drawing, void 0, void 0);
 	if (!image || image.size.width <= 0 || image.size.height <= 0) return null;
 	const svg = createSvg(group, image.size.width, image.size.height, rels, media);
 	if (!svg || svg.length > MAX_SVG_CHARACTERS) return null;
-	image.src = `${PREVIEW_KINDS.wpGroup.srcPrefix}${encodeURIComponent(svg)}`;
-	image.mimeType = PREVIEW_KINDS.wpGroup.mimeType;
-	image.filename = PREVIEW_KINDS.wpGroup.filename;
-	return image;
+	const { rId: _rId, src: _src, mimeType: _mimeType, filename: _filename, ...frame } = image;
+	return previews.svgImage("wpGroup", svg, frame);
 };
 //#endregion
 export { isGroupDrawing, parseGroupDrawing };

package/dist/docx/headerFooterParser.d.ts

@@ -1,5 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
+import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 import { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences } from "./headerFooterRefParser.js";
 //#region src/docx/headerFooterParser.d.ts
@@ -28,9 +29,11 @@ type HeaderFooterMap = {
  * @param numbering - Parsed numbering definitions for lists
  * @param rels - Relationships for resolving hyperlinks/images
  * @param media - Media files for images
+ * @param previews - The ledger of the package this part belongs to; a part
+ *   read on its own charges its previews to no package
  * @returns HeaderFooter object
  */
-declare function parseHeader(headerXml: string, hdrFtrType?: document_d_exports.HeaderFooterType, 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): document_d_exports.HeaderFooter;
+declare function parseHeader(headerXml: string, hdrFtrType?: document_d_exports.HeaderFooterType, 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, previews?: PreviewLedger): document_d_exports.HeaderFooter;
 /**
  * Parse a footer XML file (word/footer*.xml)
  *
@@ -41,9 +44,11 @@ declare function parseHeader(headerXml: string, hdrFtrType?: document_d_exports.
  * @param numbering - Parsed numbering definitions for lists
  * @param rels - Relationships for resolving hyperlinks/images
  * @param media - Media files for images
+ * @param previews - The ledger of the package this part belongs to; a part
+ *   read on its own charges its previews to no package
  * @returns HeaderFooter object
  */
-declare function parseFooter(footerXml: string, hdrFtrType?: document_d_exports.HeaderFooterType, 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): document_d_exports.HeaderFooter;
+declare function parseFooter(footerXml: string, hdrFtrType?: document_d_exports.HeaderFooterType, 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, previews?: PreviewLedger): document_d_exports.HeaderFooter;
 /**
  * Generic function to parse either header or footer
  *

package/dist/docx/headerFooterParser.js

@@ -3,6 +3,7 @@ import { blockPlainText } from "./blockPlainText.js";
 import { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences } from "./headerFooterRefParser.js";
 import { assignHeaderFooterVerbatimXml } from "./headerFooterVerbatim.js";
 import { cloneParagraphWithPropertySource } from "./paragraphPropertySource.js";
+import { standalonePreviewLedger } from "./previewBudget.js";
 import { parseWatermark } from "./watermarkParser.js";
 import { collectXmlnsDeclarations, parseXml } from "./xmlParser.js";
 //#region src/docx/headerFooterParser.ts
@@ -16,9 +17,11 @@ import { collectXmlnsDeclarations, parseXml } from "./xmlParser.js";
 * @param numbering - Parsed numbering definitions for lists
 * @param rels - Relationships for resolving hyperlinks/images
 * @param media - Media files for images
+* @param previews - The ledger of the package this part belongs to; a part
+*   read on its own charges its previews to no package
 * @returns HeaderFooter object
 */
-function parseHeader(headerXml, hdrFtrType = "default", styles = null, theme = null, numbering = null, rels = null, media = null) {
+function parseHeader(headerXml, hdrFtrType = "default", styles = null, theme = null, numbering = null, rels = null, media = null, previews = standalonePreviewLedger()) {
 	const result = {
 		type: "header",
 		hdrFtrType,
@@ -35,11 +38,15 @@ function parseHeader(headerXml, hdrFtrType = "default", styles = null, theme = n
 	}
 	result.content = parseBlockContent(rootElement, styles, theme, numbering, rels, media, {
 		inHeaderFooter: true,
-		rootXmlns: collectXmlnsDeclarations(rootElement)
+		rootXmlns: collectXmlnsDeclarations(rootElement),
+		previews
 	});
 	if (watermarkResult) {
 		const host = result.content.at(watermarkResult.blockIndex);
-		if (host?.type === "paragraph") result.content[watermarkResult.blockIndex] = cloneParagraphWithPropertySource(host, { content: [] });
+		if (host?.type === "paragraph") {
+			previews.release(host.content);
+			result.content[watermarkResult.blockIndex] = cloneParagraphWithPropertySource(host, { content: [] });
+		}
 	}
 	assignHeaderFooterVerbatimXml(result, headerXml);
 	return result;
@@ -54,9 +61,11 @@ function parseHeader(headerXml, hdrFtrType = "default", styles = null, theme = n
 * @param numbering - Parsed numbering definitions for lists
 * @param rels - Relationships for resolving hyperlinks/images
 * @param media - Media files for images
+* @param previews - The ledger of the package this part belongs to; a part
+*   read on its own charges its previews to no package
 * @returns HeaderFooter object
 */
-function parseFooter(footerXml, hdrFtrType = "default", styles = null, theme = null, numbering = null, rels = null, media = null) {
+function parseFooter(footerXml, hdrFtrType = "default", styles = null, theme = null, numbering = null, rels = null, media = null, previews = standalonePreviewLedger()) {
 	const result = {
 		type: "footer",
 		hdrFtrType,
@@ -67,7 +76,8 @@ function parseFooter(footerXml, hdrFtrType = "default", styles = null, theme = n
 	if (!rootElement) return result;
 	result.content = parseBlockContent(rootElement, styles, theme, numbering, rels, media, {
 		inHeaderFooter: true,
-		rootXmlns: collectXmlnsDeclarations(rootElement)
+		rootXmlns: collectXmlnsDeclarations(rootElement),
+		previews
 	});
 	assignHeaderFooterVerbatimXml(result, footerXml);
 	return result;

package/dist/docx/hyperlinkParser.d.ts

@@ -1,6 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
+import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
+import { ChildReader } from "./containerChildren.js";
 //#region src/docx/hyperlinkParser.d.ts
 /**
  * Parse a hyperlink element (w:hyperlink)
@@ -13,10 +15,19 @@ import { StyleMap } from "./styleParser.js";
  * @param styles - Style map for resolving run styles
  * @param theme - Theme for resolving colors/fonts
  * @param media - Media files map for image data
+ * @param previews - The ledger of the package this link belongs to; a link
+ *   read on its own charges its previews to no package
  * @returns Parsed Hyperlink object
  */
-declare function parseHyperlink(node: XmlElement, rels: document_d_exports.RelationshipMap | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, media?: Map<string, document_d_exports.MediaFile> | null, rootXmlns?: Record<string, string>): document_d_exports.Hyperlink;
-/** What {@link hyperlinkChildHandlers} needs to read one child of a link. */
+declare function parseHyperlink(node: XmlElement, rels: document_d_exports.RelationshipMap | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, media?: Map<string, document_d_exports.MediaFile> | null, rootXmlns?: Record<string, string>, previews?: PreviewLedger): document_d_exports.Hyperlink;
+/**
+ * A `w:hyperlink`'s own attributes as a link with no children yet.
+ *
+ * The paragraph parser's revision-segmenting walk reads the children itself,
+ * so it takes the shell rather than a link whose children it would discard.
+ */
+declare function parseHyperlinkShell(node: XmlElement, rels: document_d_exports.RelationshipMap | null): document_d_exports.Hyperlink;
+/** What {@link HYPERLINK_CHILD_HANDLERS} needs to read one child of a link. */
 type HyperlinkChildContext = {
   /** Where a parsed or captured child lands, in source order. */
   push: (child: document_d_exports.Hyperlink["children"][number]) => void;
@@ -24,6 +35,7 @@ type HyperlinkChildContext = {
   theme: document_d_exports.Theme | null;
   rels: document_d_exports.RelationshipMap | null;
   media: Map<string, document_d_exports.MediaFile> | null;
+  previews: PreviewLedger;
   inScopeXmlns: Record<string, string>;
 };
 /**
@@ -43,39 +55,39 @@ type HyperlinkChildContext = {
  * recognising is recognised by all of them rather than by whichever list
  * somebody remembered to update.
  */
-declare const hyperlinkChildHandlers: (context: HyperlinkChildContext) => {
-  r: (child: XmlElement) => void;
-  bookmarkStart: (child: XmlElement) => void;
-  bookmarkEnd: (child: XmlElement) => void;
-  bdo: (child: XmlElement) => void;
-  dir: (child: XmlElement) => void;
-  customXml: (child: XmlElement) => void;
-  smartTag: (child: XmlElement) => void;
-  del: "capture";
-  ins: "capture";
-  moveFrom: "capture";
-  moveTo: "capture";
-  commentRangeEnd: "capture";
-  commentRangeStart: "capture";
-  customXmlDelRangeEnd: "capture";
-  customXmlDelRangeStart: "capture";
-  customXmlInsRangeEnd: "capture";
-  customXmlInsRangeStart: "capture";
-  customXmlMoveFromRangeEnd: "capture";
-  customXmlMoveFromRangeStart: "capture";
-  customXmlMoveToRangeEnd: "capture";
-  customXmlMoveToRangeStart: "capture";
-  fldSimple: (child: XmlElement) => void;
-  hyperlink: (child: XmlElement) => void;
-  moveFromRangeEnd: "capture";
-  moveFromRangeStart: "capture";
-  moveToRangeEnd: "capture";
-  moveToRangeStart: "capture";
-  permEnd: "capture";
-  permStart: "capture";
-  proofErr: "capture";
-  sdt: "capture";
-  subDoc: "capture";
+declare const HYPERLINK_CHILD_HANDLERS: {
+  readonly r: (child: XmlElement, { push, styles, theme, rels, media, previews, inScopeXmlns }: HyperlinkChildContext) => void;
+  readonly bookmarkStart: (child: XmlElement, { push }: HyperlinkChildContext) => void;
+  readonly bookmarkEnd: (child: XmlElement, { push }: HyperlinkChildContext) => void;
+  readonly bdo: ChildReader<HyperlinkChildContext>;
+  readonly dir: ChildReader<HyperlinkChildContext>;
+  readonly customXml: ChildReader<HyperlinkChildContext>;
+  readonly smartTag: ChildReader<HyperlinkChildContext>;
+  readonly del: "capture";
+  readonly ins: "capture";
+  readonly moveFrom: "capture";
+  readonly moveTo: "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 fldSimple: (child: XmlElement, { push }: HyperlinkChildContext) => void;
+  readonly hyperlink: (child: XmlElement, { push }: HyperlinkChildContext) => void;
+  readonly moveFromRangeEnd: "capture";
+  readonly moveFromRangeStart: "capture";
+  readonly moveToRangeEnd: "capture";
+  readonly moveToRangeStart: "capture";
+  readonly permEnd: "capture";
+  readonly permStart: "capture";
+  readonly proofErr: "capture";
+  readonly sdt: "capture";
+  readonly subDoc: "capture";
 };
 /**
  * Get the display text of a hyperlink
@@ -169,4 +181,4 @@ declare function createExternalHyperlink(url: string, children: document_d_expor
   target?: string;
 }): document_d_exports.Hyperlink;
 //#endregion
-export { HyperlinkChildContext, createExternalHyperlink, createInternalHyperlink, getHyperlinkRuns, getHyperlinkText, getHyperlinkUrl, hasContent, hyperlinkChildHandlers, isExternalLink, isInternalLink, parseHyperlink, resolveHyperlinkUrl };
+export { HYPERLINK_CHILD_HANDLERS, HyperlinkChildContext, createExternalHyperlink, createInternalHyperlink, getHyperlinkRuns, getHyperlinkText, getHyperlinkUrl, hasContent, isExternalLink, isInternalLink, parseHyperlink, parseHyperlinkShell, resolveHyperlinkUrl };

package/dist/docx/hyperlinkParser.js

@@ -1,7 +1,8 @@
 import { sanitizeExternalUrl } from "../utils/urlSecurity.js";
-import { CAPTURE, dispatchChildren, ownedElsewhere, withPreservedChildren } from "./containerChildren.js";
+import { CAPTURE, dispatchChildrenWithContext, ownedElsewhere, withPreservedChildren } from "./containerChildren.js";
 import { inlineWrapperOf } from "./inlineWrapperParser.js";
 import { preserveInlineChild, preservedInlineCapture } from "./preservedRunContent.js";
+import { standalonePreviewLedger } from "./previewBudget.js";
 import { RELATIONSHIP_TYPES, resolveRelationshipIdOfType } from "./relsParser.js";
 import { parseRun } from "./runParser.js";
 import { runHoldsPayload } from "./runPayload.js";
@@ -44,9 +45,40 @@ function parseBookmarkEnd(node) {
 * @param styles - Style map for resolving run styles
 * @param theme - Theme for resolving colors/fonts
 * @param media - Media files map for image data
+* @param previews - The ledger of the package this link belongs to; a link
+*   read on its own charges its previews to no package
 * @returns Parsed Hyperlink object
 */
-function parseHyperlink(node, rels, styles = null, theme = null, media = null, rootXmlns = {}) {
+function parseHyperlink(node, rels, styles = null, theme = null, media = null, rootXmlns = {}, previews = standalonePreviewLedger()) {
+	const hyperlink = parseHyperlinkShell(node, rels);
+	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, node);
+	const children = [];
+	hyperlink.children = withPreservedChildren(children, dispatchChildrenWithContext({
+		element: node,
+		container: "w:hyperlink",
+		capturePosition: () => children.length,
+		handlers: HYPERLINK_CHILD_HANDLERS,
+		context: {
+			push: (child) => {
+				children.push(child);
+			},
+			styles,
+			theme,
+			rels,
+			media,
+			previews,
+			inScopeXmlns
+		}
+	}), preservedInlineCapture);
+	return hyperlink;
+}
+/**
+* A `w:hyperlink`'s own attributes as a link with no children yet.
+*
+* The paragraph parser's revision-segmenting walk reads the children itself,
+* so it takes the shell rather than a link whose children it would discard.
+*/
+function parseHyperlinkShell(node, rels) {
 	const hyperlink = {
 		type: "hyperlink",
 		children: []
@@ -72,25 +104,12 @@ function parseHyperlink(node, rels, styles = null, theme = null, media = null, r
 	if (history !== void 0) hyperlink.history = history;
 	const docLocation = getAttribute(node, "w", "docLocation");
 	if (docLocation) hyperlink.docLocation = docLocation;
-	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, node);
-	const children = [];
-	hyperlink.children = withPreservedChildren(children, dispatchChildren({
-		element: node,
-		container: "w:hyperlink",
-		capturePosition: () => children.length,
-		handlers: hyperlinkChildHandlers({
-			push: (child) => {
-				children.push(child);
-			},
-			styles,
-			theme,
-			rels,
-			media,
-			inScopeXmlns
-		})
-	}), preservedInlineCapture);
 	return hyperlink;
 }
+/** A transparent wrapper the link holds, read as the wrapper it is. */
+const linkedInlineWrapper = (element) => (child, context) => {
+	context.push(parseLinkedInlineWrapper(element, child, context));
+};
 /**
 * What a `w:hyperlink` does with every child its content model declares.
 *
@@ -108,56 +127,50 @@ function parseHyperlink(node, rels, styles = null, theme = null, media = null, r
 * recognising is recognised by all of them rather than by whichever list
 * somebody remembered to update.
 */
-const hyperlinkChildHandlers = (context) => {
-	const { push, styles, theme, rels, media, inScopeXmlns } = context;
-	const wrapper = (element) => (child) => {
-		push(parseLinkedInlineWrapper(element, child, context));
-	};
-	return {
-		r: (child) => {
-			const run = parseRun(child, styles, theme, rels, media, inScopeXmlns);
-			if (runHoldsPayload(run)) push(run);
-		},
-		bookmarkStart: (child) => {
-			push(parseBookmarkStart(child));
-		},
-		bookmarkEnd: (child) => {
-			push(parseBookmarkEnd(child));
-		},
-		bdo: wrapper("bdo"),
-		dir: wrapper("dir"),
-		customXml: wrapper("customXml"),
-		smartTag: wrapper("smartTag"),
-		del: CAPTURE,
-		ins: CAPTURE,
-		moveFrom: CAPTURE,
-		moveTo: CAPTURE,
-		commentRangeEnd: CAPTURE,
-		commentRangeStart: CAPTURE,
-		customXmlDelRangeEnd: CAPTURE,
-		customXmlDelRangeStart: CAPTURE,
-		customXmlInsRangeEnd: CAPTURE,
-		customXmlInsRangeStart: CAPTURE,
-		customXmlMoveFromRangeEnd: CAPTURE,
-		customXmlMoveFromRangeStart: CAPTURE,
-		customXmlMoveToRangeEnd: CAPTURE,
-		customXmlMoveToRangeStart: CAPTURE,
-		fldSimple: (child) => {
-			push(preserveInlineChild(child));
-		},
-		hyperlink: (child) => {
-			push(preserveInlineChild(child));
-		},
-		moveFromRangeEnd: CAPTURE,
-		moveFromRangeStart: CAPTURE,
-		moveToRangeEnd: CAPTURE,
-		moveToRangeStart: CAPTURE,
-		permEnd: CAPTURE,
-		permStart: CAPTURE,
-		proofErr: CAPTURE,
-		sdt: CAPTURE,
-		subDoc: CAPTURE
-	};
+const HYPERLINK_CHILD_HANDLERS = {
+	r: (child, { push, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		const run = parseRun(child, styles, theme, rels, media, inScopeXmlns, previews);
+		if (runHoldsPayload(run)) push(run);
+	},
+	bookmarkStart: (child, { push }) => {
+		push(parseBookmarkStart(child));
+	},
+	bookmarkEnd: (child, { push }) => {
+		push(parseBookmarkEnd(child));
+	},
+	bdo: linkedInlineWrapper("bdo"),
+	dir: linkedInlineWrapper("dir"),
+	customXml: linkedInlineWrapper("customXml"),
+	smartTag: linkedInlineWrapper("smartTag"),
+	del: CAPTURE,
+	ins: CAPTURE,
+	moveFrom: CAPTURE,
+	moveTo: CAPTURE,
+	commentRangeEnd: CAPTURE,
+	commentRangeStart: CAPTURE,
+	customXmlDelRangeEnd: CAPTURE,
+	customXmlDelRangeStart: CAPTURE,
+	customXmlInsRangeEnd: CAPTURE,
+	customXmlInsRangeStart: CAPTURE,
+	customXmlMoveFromRangeEnd: CAPTURE,
+	customXmlMoveFromRangeStart: CAPTURE,
+	customXmlMoveToRangeEnd: CAPTURE,
+	customXmlMoveToRangeStart: CAPTURE,
+	fldSimple: (child, { push }) => {
+		push(preserveInlineChild(child));
+	},
+	hyperlink: (child, { push }) => {
+		push(preserveInlineChild(child));
+	},
+	moveFromRangeEnd: CAPTURE,
+	moveFromRangeStart: CAPTURE,
+	moveToRangeEnd: CAPTURE,
+	moveToRangeStart: CAPTURE,
+	permEnd: CAPTURE,
+	permStart: CAPTURE,
+	proofErr: CAPTURE,
+	sdt: CAPTURE,
+	subDoc: CAPTURE
 };
 const LINKED_SMART_TAG_PROPERTIES_OWNER = ownedElsewhere({
 	container: "run-level-content",
@@ -169,6 +182,12 @@ const LINKED_CUSTOM_XML_PROPERTIES_OWNER = ownedElsewhere({
 	child: "customXmlPr",
 	reader: "inlineWrapperParser#inlineWrapperOf"
 });
+const LINKED_INLINE_WRAPPER_HANDLERS = {
+	...HYPERLINK_CHILD_HANDLERS,
+	customXmlPr: LINKED_CUSTOM_XML_PROPERTIES_OWNER,
+	smartTagPr: LINKED_SMART_TAG_PROPERTIES_OWNER,
+	pPr: CAPTURE
+};
 /**
 * A transparent wrapper a link holds, with the content the link would hold.
 *
@@ -185,21 +204,17 @@ const LINKED_CUSTOM_XML_PROPERTIES_OWNER = ownedElsewhere({
 const parseLinkedInlineWrapper = (element, node, context) => {
 	const inScopeXmlns = mergeXmlnsDeclarations(context.inScopeXmlns, node);
 	const content = [];
-	return inlineWrapperOf(element, node, withPreservedChildren(content, dispatchChildren({
+	return inlineWrapperOf(element, node, withPreservedChildren(content, dispatchChildrenWithContext({
 		element: node,
 		container: "run-level-content",
 		capturePosition: () => content.length,
-		handlers: {
-			...hyperlinkChildHandlers({
-				...context,
-				inScopeXmlns,
-				push: (child) => {
-					content.push(child);
-				}
-			}),
-			customXmlPr: LINKED_CUSTOM_XML_PROPERTIES_OWNER,
-			smartTagPr: LINKED_SMART_TAG_PROPERTIES_OWNER,
-			pPr: CAPTURE
+		handlers: LINKED_INLINE_WRAPPER_HANDLERS,
+		context: {
+			...context,
+			inScopeXmlns,
+			push: (child) => {
+				content.push(child);
+			}
 		}
 	}), preservedInlineCapture));
 };
@@ -346,4 +361,4 @@ function createExternalHyperlink(url, children, options) {
 	};
 }
 //#endregion
-export { createExternalHyperlink, createInternalHyperlink, getHyperlinkRuns, getHyperlinkText, getHyperlinkUrl, hasContent, hyperlinkChildHandlers, isExternalLink, isInternalLink, parseHyperlink, resolveHyperlinkUrl };
+export { HYPERLINK_CHILD_HANDLERS, createExternalHyperlink, createInternalHyperlink, getHyperlinkRuns, getHyperlinkText, getHyperlinkUrl, hasContent, isExternalLink, isInternalLink, parseHyperlink, parseHyperlinkShell, resolveHyperlinkUrl };