@stll/folio-core 0.15.0 → 0.15.2

package/dist/docx/drawingUtils.js

@@ -1,5 +1,5 @@
 import { ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, ShapeOutlineStyleSchema, narrowEnum } from "./parserEnums.js";
-import { findByFullName, getAttribute, getChildElements, getTextContent, parseNumericAttribute } from "./xmlParser.js";
+import { elementToXml, findByFullName, findChildByLocalName, findChildrenByLocalName, getAttribute, getChildElements, getTextContent, parseNumericAttribute } from "./xmlParser.js";
 //#region src/docx/drawingUtils.ts
 /**
 * Map OOXML scheme names to standard theme color slots.
@@ -24,6 +24,28 @@ const SCHEME_TO_THEME_COLOR = {
 	folHlink: "folHlink"
 };
 /**
+* Map normalized theme color slots back to DrawingML scheme color names.
+* DrawingML uses bg1/bg2/tx1/tx2 where the document model uses descriptive names.
+*/
+const THEME_COLOR_TO_DRAWING_SCHEME = {
+	dk1: "dk1",
+	lt1: "lt1",
+	dk2: "dk2",
+	lt2: "lt2",
+	accent1: "accent1",
+	accent2: "accent2",
+	accent3: "accent3",
+	accent4: "accent4",
+	accent5: "accent5",
+	accent6: "accent6",
+	hlink: "hlink",
+	folHlink: "folHlink",
+	background1: "bg1",
+	text1: "tx1",
+	background2: "bg2",
+	text2: "tx2"
+};
+/**
 * sRGB hex per OOXML (ST_HexColorRGB): exactly six hex digits, case-insensitive.
 * Anything else is rejected so untrusted DOCX input cannot smuggle markup through
 * downstream renderers that interpolate the value into HTML/SVG.
@@ -97,9 +119,8 @@ function parseColorElement(element) {
 */
 function parseFill(spPr) {
 	if (!spPr) return;
-	const children = getChildElements(spPr);
-	if (children.some((el) => el.name === "a:noFill")) return { type: "none" };
-	const solidFill = children.find((el) => el.name === "a:solidFill");
+	if (findChildByLocalName(spPr, "noFill")) return { type: "none" };
+	const solidFill = findChildByLocalName(spPr, "solidFill");
 	if (solidFill) {
 		const color = parseColorElement(solidFill);
 		return color !== void 0 ? {
@@ -107,31 +128,105 @@ function parseFill(spPr) {
 			color
 		} : { type: "solid" };
 	}
-	if (children.some((el) => el.name === "a:gradFill")) return { type: "gradient" };
+	const gradientFill = findChildByLocalName(spPr, "gradFill");
+	if (gradientFill) return parseGradientFill(gradientFill);
+}
+function parseGradientFill(gradientFill) {
+	let type = "linear";
+	let angle;
+	const linear = findChildByLocalName(gradientFill, "lin");
+	if (linear) {
+		const authoredAngle = getAttribute(linear, null, "ang");
+		if (authoredAngle) {
+			const parsedAngle = Number.parseInt(authoredAngle, 10);
+			angle = Number.isNaN(parsedAngle) ? void 0 : parsedAngle / 6e4;
+		}
+	}
+	const path = findChildByLocalName(gradientFill, "path");
+	if (path) {
+		const pathType = getAttribute(path, null, "path");
+		if (pathType === "circle") type = "radial";
+		else if (pathType === "rect") type = "rectangular";
+		else type = "path";
+	}
+	const stops = [];
+	const stopList = findChildByLocalName(gradientFill, "gsLst");
+	if (stopList) for (const stop of findChildrenByLocalName(stopList, "gs")) {
+		const authoredPosition = getAttribute(stop, null, "pos");
+		const parsedPosition = authoredPosition ? Number.parseInt(authoredPosition, 10) : 0;
+		const color = parseColorElement(stop);
+		if (color) stops.push({
+			position: Number.isNaN(parsedPosition) ? 0 : parsedPosition,
+			color
+		});
+	}
+	return {
+		type: "gradient",
+		rawXml: elementToXml(gradientFill),
+		gradient: {
+			type,
+			...angle !== void 0 ? { angle } : {},
+			stops
+		}
+	};
 }
 /**
 * Parse outline from shape properties (a:ln).
 */
 function parseOutline(spPr) {
-	const ln = spPr ? findByFullName(spPr, "a:ln") : null;
+	const ln = spPr ? findChildByLocalName(spPr, "ln") : null;
 	if (!ln) return;
-	const children = getChildElements(ln);
-	if (children.some((el) => el.name === "a:noFill")) return;
-	const outline = {};
+	if (findChildByLocalName(ln, "noFill")) return;
+	const outline = { rawXml: elementToXml(ln) };
 	const w = getAttribute(ln, null, "w");
-	if (w) outline.width = Number.parseInt(w, 10);
-	const solidFill = children.find((el) => el.name === "a:solidFill");
+	if (w) {
+		const parsed = Number.parseInt(w, 10);
+		if (!Number.isNaN(parsed)) outline.width = parsed;
+	}
+	const cap = getAttribute(ln, null, "cap");
+	if (cap === "flat") outline.cap = "flat";
+	else if (cap === "rnd") outline.cap = "round";
+	else if (cap === "sq") outline.cap = "square";
+	if (findChildByLocalName(ln, "bevel")) outline.join = "bevel";
+	else if (findChildByLocalName(ln, "round")) outline.join = "round";
+	else if (findChildByLocalName(ln, "miter")) outline.join = "miter";
+	const solidFill = findChildByLocalName(ln, "solidFill");
 	if (solidFill) {
 		const color = parseColorElement(solidFill);
 		if (color !== void 0) outline.color = color;
 	}
-	const prstDash = children.find((el) => el.name === "a:prstDash");
+	const prstDash = findChildByLocalName(ln, "prstDash");
 	if (prstDash) {
 		const val = narrowEnum(getAttribute(prstDash, null, "val"), ShapeOutlineStyleSchema);
 		if (val) outline.style = val;
 	}
+	const headEnd = findChildByLocalName(ln, "headEnd");
+	if (headEnd) outline.headEnd = parseLineEnd(headEnd);
+	const tailEnd = findChildByLocalName(ln, "tailEnd");
+	if (tailEnd) outline.tailEnd = parseLineEnd(tailEnd);
 	return outline;
 }
+const LINE_END_TYPES = [
+	"none",
+	"triangle",
+	"stealth",
+	"diamond",
+	"oval",
+	"arrow"
+];
+function parseLineEnd(element) {
+	const authoredType = getAttribute(element, null, "type");
+	const type = LINE_END_TYPES.find((allowed) => allowed === authoredType) ?? "none";
+	const authoredWidth = getAttribute(element, null, "w");
+	const authoredLength = getAttribute(element, null, "len");
+	const width = authoredWidth === "sm" || authoredWidth === "med" || authoredWidth === "lg" ? authoredWidth : void 0;
+	const length = authoredLength === "sm" || authoredLength === "med" || authoredLength === "lg" ? authoredLength : void 0;
+	return {
+		type,
+		...width !== void 0 ? { width } : {},
+		...length !== void 0 ? { length } : {}
+	};
+}
 /**
 * Parse horizontal position from wp:positionH element.
 */
@@ -140,11 +235,11 @@ function parsePositionH(posH) {
 	const relativeTo = narrowEnum(getAttribute(posH, null, "relativeFrom"), ImageHorizontalRelativeToSchema) ?? "column";
 	const alignEl = findByFullName(posH, "wp:align");
 	if (alignEl) {
-		const text = getTextContent(alignEl);
-		const result = { relativeTo };
-		const alignment = narrowEnum(text, ImageHorizontalAlignmentSchema);
-		if (alignment) result.alignment = alignment;
-		return result;
+		const alignment = narrowEnum(getTextContent(alignEl), ImageHorizontalAlignmentSchema);
+		if (alignment) return {
+			relativeTo,
+			alignment
+		};
 	}
 	const posOffsetEl = findByFullName(posH, "wp:posOffset");
 	if (posOffsetEl) {
@@ -155,7 +250,10 @@ function parsePositionH(posH) {
 			posOffset: Number.isNaN(posOffset) ? 0 : posOffset
 		};
 	}
-	return { relativeTo };
+	return {
+		relativeTo,
+		posOffset: 0
+	};
 }
 /**
 * Parse vertical position from wp:positionV element.
@@ -165,11 +263,11 @@ function parsePositionV(posV) {
 	const relativeTo = narrowEnum(getAttribute(posV, null, "relativeFrom"), ImageVerticalRelativeToSchema) ?? "paragraph";
 	const alignEl = findByFullName(posV, "wp:align");
 	if (alignEl) {
-		const text = getTextContent(alignEl);
-		const result = { relativeTo };
-		const alignment = narrowEnum(text, ImageVerticalAlignmentSchema);
-		if (alignment) result.alignment = alignment;
-		return result;
+		const alignment = narrowEnum(getTextContent(alignEl), ImageVerticalAlignmentSchema);
+		if (alignment) return {
+			relativeTo,
+			alignment
+		};
 	}
 	const posOffsetEl = findByFullName(posV, "wp:posOffset");
 	if (posOffsetEl) {
@@ -180,7 +278,10 @@ function parsePositionV(posV) {
 			posOffset: Number.isNaN(posOffset) ? 0 : posOffset
 		};
 	}
-	return { relativeTo };
+	return {
+		relativeTo,
+		posOffset: 0
+	};
 }
 /**
 * Parse position for anchored drawings (combines positionH + positionV).
@@ -188,10 +289,15 @@ function parsePositionV(posV) {
 function parseAnchorPosition(anchor) {
 	const positionH = findByFullName(anchor, "wp:positionH");
 	const positionV = findByFullName(anchor, "wp:positionV");
-	if (!positionH && !positionV) return;
 	return {
-		horizontal: parsePositionH(positionH) ?? { relativeTo: "column" },
-		vertical: parsePositionV(positionV) ?? { relativeTo: "paragraph" }
+		horizontal: parsePositionH(positionH) ?? {
+			relativeTo: "column",
+			posOffset: 0
+		},
+		vertical: parsePositionV(positionV) ?? {
+			relativeTo: "paragraph",
+			posOffset: 0
+		}
 	};
 }
 /** Known wrap element names */
@@ -302,4 +408,4 @@ function resolveColorValueToHex(color) {
 	if (color.themeColor) return `#${DEFAULT_THEME_COLOR_HEX[color.themeColor] ?? "000000"}`;
 }
 //#endregion
-export { WRAP_ELEMENT_NAMES, parseAnchorPosition, parseAnchorWrap, parseColorElement, parseFill, parseOutline, parsePositionH, parsePositionV, parseWrapElement, resolveColorValueToHex };
+export { THEME_COLOR_TO_DRAWING_SCHEME, WRAP_ELEMENT_NAMES, parseAnchorPosition, parseAnchorWrap, parseColorElement, parseFill, parseOutline, parsePositionH, parsePositionV, parseWrapElement, resolveColorValueToHex };

package/dist/docx/encryption/agileDecryption.d.ts

@@ -1,5 +1,4 @@
 import { AgileKeyMaterial } from "./encryptionInfo.js";
-
 //#region src/docx/encryption/agileDecryption.d.ts
 declare const decryptAgileEncryptedPackage: (password: string, material: AgileKeyMaterial, encryptedPackage: Uint8Array) => Promise<Uint8Array>;
 //#endregion

package/dist/docx/encryption/cryptoBytes.js

@@ -34,7 +34,10 @@ const bytesEqual = (left, right) => {
 	for (let i = 0; i < left.length; i++) mismatch |= left[i] ^ right[i];
 	return mismatch === 0;
 };
-const toArrayBuffer = (bytes) => bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+const toArrayBuffer = (bytes) => {
+	if (bytes.buffer instanceof ArrayBuffer && bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength) return bytes.buffer;
+	return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+};
 const decodeBase64 = (encoded) => {
 	if (typeof atob === "function") {
 		const binary = atob(encoded);

package/dist/docx/encryption/openEncryptedDocx.d.ts

@@ -7,10 +7,13 @@
  * @see https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-offcrypto/
  */
 type DecryptDocxOptions = {
-  /** Password for Agile-encrypted .docx files (Office 2010+). */password?: string | undefined;
+  /** Password for Agile-encrypted .docx files (Office 2010+). */
+  password?: string | undefined;
 };
 type DecryptDocxResult = {
-  /** Plaintext OOXML ZIP bytes, or the original buffer when unencrypted. */data: ArrayBuffer; /** True when the input was an encrypted CFB container and decryption ran. */
+  /** Plaintext OOXML ZIP bytes, or the original buffer when unencrypted. */
+  data: ArrayBuffer;
+  /** True when the input was an encrypted CFB container and decryption ran. */
   wasEncrypted: boolean;
 };
 /**

package/dist/docx/ensureParaIds.d.ts

@@ -7,9 +7,13 @@ declare const EnsureParaIdsError_base: import("better-result").TaggedErrorClass<
 declare class EnsureParaIdsError extends EnsureParaIdsError_base {}
 /** Counts and normalized bytes returned by {@link ensureParaIds}. */
 type EnsureParaIdsResult = {
-  /** The normalized `.docx`; the input bytes verbatim when `alreadyComplete`. */docx: Uint8Array; /** Paragraphs that received a paraId (missing or all-zero before). */
-  assigned: number; /** Duplicate paraIds reassigned (the first occurrence keeps the id). */
-  deduplicated: number; /** True when the input already had full, unique coverage. */
+  /** The normalized `.docx`; the input bytes verbatim when `alreadyComplete`. */
+  docx: Uint8Array;
+  /** Paragraphs that received a paraId (missing or all-zero before). */
+  assigned: number;
+  /** Duplicate paraIds reassigned (the first occurrence keeps the id). */
+  deduplicated: number;
+  /** True when the input already had full, unique coverage. */
   alreadyComplete: boolean;
 };
 /** Controls mutation of package metadata that has security implications. */

package/dist/docx/fieldParser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/fieldParser.d.ts
 /**
  * All known field types from OOXML specification
@@ -33,16 +32,22 @@ declare function isKnownFieldType(type: string): type is document_d_exports.Fiel
  * Parsed field instruction with arguments and switches
  */
 type ParsedFieldInstruction = {
-  /** Field type */type: document_d_exports.FieldType; /** Raw instruction string */
-  raw: string; /** Field argument (e.g., property name for DOCPROPERTY, bookmark name for REF) */
-  argument?: string; /** Field switches (e.g., \* MERGEFORMAT, \@ "date format") */
+  /** Field type */
+  type: document_d_exports.FieldType;
+  /** Raw instruction string */
+  raw: string;
+  /** Field argument (e.g., property name for DOCPROPERTY, bookmark name for REF) */
+  argument?: string;
+  /** Field switches (e.g., \* MERGEFORMAT, \@ "date format") */
   switches: FieldSwitch[];
 };
 /**
  * Field switch parsed from instruction
  */
 type FieldSwitch = {
-  /** Switch character (e.g., '*', '@', '#', 'h', 'p') */switch: string; /** Switch value if any */
+  /** Switch character (e.g., '*', '@', '#', 'h', 'p') */
+  switch: string;
+  /** Switch value if any */
   value?: string;
 };
 /**
@@ -83,12 +88,19 @@ type ComplexFieldState = "outside" | "code" | "result";
  * Complex field parsing context
  */
 type ComplexFieldContext = {
-  /** Current state */state: ComplexFieldState; /** Accumulated instruction text */
-  instruction: string; /** Runs in the field code section */
-  codeRuns: document_d_exports.Run[]; /** Runs in the result section */
-  resultRuns: document_d_exports.Run[]; /** Whether field is locked */
-  fldLock: boolean; /** Whether field needs update */
-  dirty: boolean; /** Nesting level (for nested fields) */
+  /** Current state */
+  state: ComplexFieldState;
+  /** Accumulated instruction text */
+  instruction: string;
+  /** Runs in the field code section */
+  codeRuns: document_d_exports.Run[];
+  /** Runs in the result section */
+  resultRuns: document_d_exports.Run[];
+  /** Whether field is locked */
+  fldLock: boolean;
+  /** Whether field needs update */
+  dirty: boolean;
+  /** Nesting level (for nested fields) */
   nestingLevel: number;
 };
 /**

package/dist/docx/fontTableParser.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/fontTableParser.d.ts
 declare const parseFontTable: (xml: string | null | undefined) => document_d_exports.FontTable | undefined;
 //#endregion

package/dist/docx/footnoteParser.d.ts

@@ -2,30 +2,43 @@ import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
-
 //#region src/docx/footnoteParser.d.ts
 /**
  * Footnote map returned by parseFootnotes
  */
 type FootnoteMap = {
-  /** All footnotes indexed by ID */byId: Map<number, document_d_exports.Footnote>; /** Array of all footnotes in document order */
-  footnotes: document_d_exports.Footnote[]; /** Get footnote by ID */
-  getFootnote: (id: number) => document_d_exports.Footnote | undefined; /** Check if footnote exists */
-  hasFootnote: (id: number) => boolean; /** Get all normal (non-separator) footnotes */
-  getNormalFootnotes: () => document_d_exports.Footnote[]; /** Get separator footnote if exists */
-  getSeparator: () => document_d_exports.Footnote | undefined; /** Get continuation separator if exists */
+  /** All footnotes indexed by ID */
+  byId: Map<number, document_d_exports.Footnote>;
+  /** Array of all footnotes in document order */
+  footnotes: document_d_exports.Footnote[];
+  /** Get footnote by ID */
+  getFootnote: (id: number) => document_d_exports.Footnote | undefined;
+  /** Check if footnote exists */
+  hasFootnote: (id: number) => boolean;
+  /** Get all normal (non-separator) footnotes */
+  getNormalFootnotes: () => document_d_exports.Footnote[];
+  /** Get separator footnote if exists */
+  getSeparator: () => document_d_exports.Footnote | undefined;
+  /** Get continuation separator if exists */
   getContinuationSeparator: () => document_d_exports.Footnote | undefined;
 };
 /**
  * Endnote map returned by parseEndnotes
  */
 type EndnoteMap = {
-  /** All endnotes indexed by ID */byId: Map<number, document_d_exports.Endnote>; /** Array of all endnotes in document order */
-  endnotes: document_d_exports.Endnote[]; /** Get endnote by ID */
-  getEndnote: (id: number) => document_d_exports.Endnote | undefined; /** Check if endnote exists */
-  hasEndnote: (id: number) => boolean; /** Get all normal (non-separator) endnotes */
-  getNormalEndnotes: () => document_d_exports.Endnote[]; /** Get separator endnote if exists */
-  getSeparator: () => document_d_exports.Endnote | undefined; /** Get continuation separator if exists */
+  /** All endnotes indexed by ID */
+  byId: Map<number, document_d_exports.Endnote>;
+  /** Array of all endnotes in document order */
+  endnotes: document_d_exports.Endnote[];
+  /** Get endnote by ID */
+  getEndnote: (id: number) => document_d_exports.Endnote | undefined;
+  /** Check if endnote exists */
+  hasEndnote: (id: number) => boolean;
+  /** Get all normal (non-separator) endnotes */
+  getNormalEndnotes: () => document_d_exports.Endnote[];
+  /** Get separator endnote if exists */
+  getSeparator: () => document_d_exports.Endnote | undefined;
+  /** Get continuation separator if exists */
   getContinuationSeparator: () => document_d_exports.Endnote | undefined;
 };
 /**

package/dist/docx/footnoteParser.js

@@ -30,8 +30,10 @@ function parseNoteBlockContent(element, styles, theme, numbering, rels, media) {
 	for (const child of getChildElements(element)) {
 		const localName = getLocalName(child.name ?? "");
 		if (localName === "p") blocks.push(parseParagraph(child, styles, theme, numbering, rels));
-		else if (localName === "tbl") blocks.push(parseTable(child, styles, theme, numbering, rels, media));
-		else if (localName === "sdt") {
+		else if (localName === "tbl") {
+			const table = parseTable(child, styles, theme, numbering, rels, media);
+			if (table) blocks.push(table);
+		} else if (localName === "sdt") {
 			const sdtPr = findChild(child, "w", "sdtPr");
 			const sdtEndPr = findChild(child, "w", "sdtEndPr");
 			const sdtContent = findChild(child, "w", "sdtContent");

package/dist/docx/groupDrawingParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/groupDrawingParser.d.ts
 /** 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;

package/dist/docx/headerFooterParser.d.ts

@@ -2,16 +2,20 @@ import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
 import { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences } from "./headerFooterRefParser.js";
-
 //#region src/docx/headerFooterParser.d.ts
 /**
  * Map of header/footer ID to HeaderFooter content
  */
 type HeaderFooterMap = {
-  /** Map of rId to HeaderFooter */byId: Map<string, document_d_exports.HeaderFooter>; /** Get header/footer by rId */
-  get: (rId: string) => document_d_exports.HeaderFooter | undefined; /** Check if header/footer exists */
-  has: (rId: string) => boolean; /** Get all headers/footers */
-  getAll: () => document_d_exports.HeaderFooter[]; /** Get by type */
+  /** Map of rId to HeaderFooter */
+  byId: Map<string, document_d_exports.HeaderFooter>;
+  /** Get header/footer by rId */
+  get: (rId: string) => document_d_exports.HeaderFooter | undefined;
+  /** Check if header/footer exists */
+  has: (rId: string) => boolean;
+  /** Get all headers/footers */
+  getAll: () => document_d_exports.HeaderFooter[];
+  /** Get by type */
   getByType: (type: document_d_exports.HeaderFooterType) => document_d_exports.HeaderFooter | undefined;
 };
 /**

package/dist/docx/headerFooterRefParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/headerFooterRefParser.d.ts
 /**
  * Parse a header reference from sectPr (w:headerReference)

package/dist/docx/headerFooterReferenceNormalization.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/headerFooterReferenceNormalization.d.ts
 type NormalizeHeaderFooterReferencesInput = {
   documentBody: document_d_exports.DocumentBody;
@@ -10,10 +9,6 @@ type NormalizeHeaderFooterReferencesResult = {
   removedDanglingHeaderReferences: number;
   removedDanglingFooterReferences: number;
 };
-declare const normalizeHeaderFooterReferences: ({
-  documentBody,
-  headers,
-  footers
-}: NormalizeHeaderFooterReferencesInput) => NormalizeHeaderFooterReferencesResult;
+declare const normalizeHeaderFooterReferences: ({ documentBody, headers, footers }: NormalizeHeaderFooterReferencesInput) => NormalizeHeaderFooterReferencesResult;
 //#endregion
 export { normalizeHeaderFooterReferences };

package/dist/docx/headerFooterVerbatim.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/headerFooterVerbatim.d.ts
 /**
  * Folio extension on {@link HeaderFooter}: original part XML captured at parse
@@ -8,12 +7,14 @@ import { document_d_exports } from "../types/document.js";
  * Cleared on first edit.
  */
 type HeaderFooterWithVerbatim = document_d_exports.HeaderFooter & {
-  verbatimXml?: string; /** Fingerprint of modeled fields at parse time; verbatim replay is safe only while it matches. */
+  verbatimXml?: string;
+  /** Fingerprint of modeled fields at parse time; verbatim replay is safe only while it matches. */
   verbatimFingerprint?: string;
 };
 declare const getHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter) => string | undefined;
 declare const canReplayHeaderFooterVerbatim: (hf: document_d_exports.HeaderFooter) => boolean;
 declare const assignHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter, xml: string) => void;
+declare const refreshHeaderFooterVerbatimFingerprint: (hf: document_d_exports.HeaderFooter) => void;
 declare const clearHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter) => void;
 //#endregion
-export { HeaderFooterWithVerbatim, assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml };
+export { HeaderFooterWithVerbatim, assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };

package/dist/docx/headerFooterVerbatim.js

@@ -16,10 +16,15 @@ const assignHeaderFooterVerbatimXml = (hf, xml) => {
 	ext.verbatimXml = xml;
 	ext.verbatimFingerprint = headerFooterSerializationFingerprint(hf);
 };
+const refreshHeaderFooterVerbatimFingerprint = (hf) => {
+	const ext = hf;
+	if (!ext.verbatimXml) return;
+	ext.verbatimFingerprint = headerFooterSerializationFingerprint(hf);
+};
 const clearHeaderFooterVerbatimXml = (hf) => {
 	const ext = hf;
 	delete ext.verbatimXml;
 	delete ext.verbatimFingerprint;
 };
 //#endregion
-export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml };
+export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };

package/dist/docx/hyperlinkParser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/hyperlinkParser.d.ts
 /**
  * Parse a hyperlink element (w:hyperlink)

package/dist/docx/hyperlinkParser.js

@@ -1,16 +1,8 @@
-import { getAttribute, getChildElements, mergeXmlnsDeclarations, parseNumericAttribute } from "./xmlParser.js";
+import { getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseNumericAttribute } from "./xmlParser.js";
 import { sanitizeExternalUrl, sanitizeLinkTarget } from "../utils/urlSecurity.js";
 import { parseRun } from "./runParser.js";
 //#region src/docx/hyperlinkParser.ts
 /**
-* Get the local name of an element (without namespace prefix)
-*/
-function getLocalName(name) {
-	if (!name) return "";
-	const colonIndex = name.indexOf(":");
-	return colonIndex !== -1 ? name.slice(colonIndex + 1) : name;
-}
-/**
 * Parse bookmark start (w:bookmarkStart)
 *
 * Used for internal hyperlink targets within the document.

package/dist/docx/imageParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/imageParser.d.ts
 /**
  * Resolve image data from relationships and media map

package/dist/docx/imageParser.js

@@ -1,8 +1,8 @@
 import { findByFullName, findChild, getAttribute, getChildElements, parseNumericAttribute } from "./xmlParser.js";
 import { emuToPixels } from "../utils/units.js";
+import { WRAP_ELEMENT_NAMES, parsePositionH, parsePositionV, parseWrapElement } from "./drawingUtils.js";
 import { sanitizeExternalUrl } from "../utils/urlSecurity.js";
 import { sanitizeImageSrc } from "../utils/sanitizeImageSrc.js";
-import { WRAP_ELEMENT_NAMES, parsePositionH, parsePositionV, parseWrapElement } from "./drawingUtils.js";
 import { resolveTarget } from "./relsParser.js";
 import { isTextBoxDrawing } from "./textBoxParser.js";
 //#region src/docx/imageParser.ts
@@ -325,8 +325,9 @@ function parseInline(inlineEl, rels, media) {
 		wrap
 	};
 	if (props.id) image.id = props.id;
-	if (props.alt) image.alt = props.alt;
-	if (props.title) image.title = props.title;
+	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 (props.decorative) image.decorative = true;
 	const safeSrc = sanitizeImageSrc(imageData.src);
 	if (safeSrc) image.src = safeSrc;
@@ -338,7 +339,10 @@ function parseInline(inlineEl, rels, media) {
 	if (opacity !== void 0) image.opacity = opacity;
 	if (props.hlinkRId && rels) {
 		const safeHref = sanitizeExternalUrl(resolveTarget(rels, props.hlinkRId));
-		if (safeHref) image.hlinkHref = safeHref;
+		if (safeHref) {
+			image.hlinkHref = safeHref;
+			image.hlinkRId = props.hlinkRId;
+		}
 	}
 	return image;
 }
@@ -391,8 +395,9 @@ function parseAnchor(anchorEl, rels, media) {
 		wrap
 	};
 	if (props.id) image.id = props.id;
-	if (props.alt) image.alt = props.alt;
-	if (props.title) image.title = props.title;
+	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 (props.decorative) image.decorative = true;
 	const safeSrc = sanitizeImageSrc(imageData.src);
 	if (safeSrc) image.src = safeSrc;
@@ -407,7 +412,10 @@ function parseAnchor(anchorEl, rels, media) {
 	if (allowOverlap !== void 0) image.allowOverlap = allowOverlap;
 	if (props.hlinkRId && rels) {
 		const safeHref = sanitizeExternalUrl(resolveTarget(rels, props.hlinkRId));
-		if (safeHref) image.hlinkHref = safeHref;
+		if (safeHref) {
+			image.hlinkHref = safeHref;
+			image.hlinkRId = props.hlinkRId;
+		}
 	}
 	return image;
 }

package/dist/docx/mathToMathml.d.ts

@@ -1,5 +1,4 @@
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/mathToMathml.d.ts
 /**
  * Convert an OMML element (`<m:oMath>` or `<m:oMathPara>`) into a MathML