@stll/folio-core 0.15.0 → 0.15.1

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,7 +7,8 @@ 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;

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

package/dist/docx/metadataPrivacy.d.ts

@@ -33,8 +33,6 @@ declare const PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM: {
 };
 declare const resolveFolioDocumentPrivacyTransforms: (transforms: unknown) => FolioDocumentPrivacyTransform[];
 /** Rewrite selected package metadata fields without changing other package parts. */
-declare const rewriteDocxMetadataPrivacy: (buffer: ArrayBuffer, {
-  transforms
-}: FolioDocumentPrivacyOptions) => Promise<RewriteDocxMetadataPrivacyResult>;
+declare const rewriteDocxMetadataPrivacy: (buffer: ArrayBuffer, { transforms }: FolioDocumentPrivacyOptions) => Promise<RewriteDocxMetadataPrivacyResult>;
 //#endregion
 export { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM, RewriteDocxMetadataPrivacyResult, isFolioDocumentPrivacyTransform, resolveFolioDocumentPrivacyTransforms, rewriteDocxMetadataPrivacy };

package/dist/docx/modelValidation.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { ValidateDocumentModelIssue, ValidateDocumentModelResult } from "@stll/docx-core";
-
 //#region src/docx/modelValidation.d.ts
 declare class DocxModelValidationError extends Error {
   readonly issues: ValidateDocumentModelIssue[];

package/dist/docx/newImage.d.ts

@@ -0,0 +1,11 @@
+import { DrawingContent, RunContent } from "../types/content.js";
+//#region src/docx/newImage.d.ts
+/**
+ * A drawing needs a new package image part only when it is model-driven.
+ *
+ * Raw OOXML drawings can carry data-URL previews for browser rendering, but
+ * save replays their raw XML instead of serializing the preview image.
+ */
+declare const isNewDataUrlDrawing: (content: RunContent) => content is DrawingContent;
+//#endregion
+export { isNewDataUrlDrawing };

package/dist/docx/newImage.js

@@ -0,0 +1,11 @@
+//#region src/docx/newImage.ts
+const SYNTHETIC_IMAGE_RID_PREFIX = "rId_img_";
+/**
+* A drawing needs a new package image part only when it is model-driven.
+*
+* Raw OOXML drawings can carry data-URL previews for browser rendering, but
+* save replays their raw XML instead of serializing the preview image.
+*/
+const isNewDataUrlDrawing = (content) => content.type === "drawing" && !content.rawXml && content.image.src?.startsWith("data:") === true && (!content.image.rId || content.image.rId.startsWith(SYNTHETIC_IMAGE_RID_PREFIX));
+//#endregion
+export { isNewDataUrlDrawing };

package/dist/docx/normalizeBaseDirection.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/normalizeBaseDirection.d.ts
 /**
  * Return a copy of `doc` with `bidi` filled in for undecided RTL-led body

package/dist/docx/notePropertiesParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/notePropertiesParser.d.ts
 /**
  * Parse footnote properties from w:footnotePr element

package/dist/docx/numberingParser.d.ts

@@ -1,15 +1,19 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/numberingParser.d.ts
 /**
  * Map of rId to numbering definitions
  */
 type NumberingMap = {
-  definitions: document_d_exports.NumberingDefinitions; /** Get level info for a numId and ilvl */
-  getLevel: (numId: number, ilvl: number) => document_d_exports.ListLevel | null; /** Get the abstract numbering ID referenced by a numId */
-  getAbstractNumId: (numId: number) => number | null; /** Get abstract numbering by ID */
-  getAbstract: (abstractNumId: number) => document_d_exports.AbstractNumbering | null; /** Get the concrete numbering instance for a numId */
-  getInstance: (numId: number) => document_d_exports.NumberingInstance | null; /** Check if numId exists */
+  definitions: document_d_exports.NumberingDefinitions;
+  /** Get level info for a numId and ilvl */
+  getLevel: (numId: number, ilvl: number) => document_d_exports.ListLevel | null;
+  /** Get the abstract numbering ID referenced by a numId */
+  getAbstractNumId: (numId: number) => number | null;
+  /** Get abstract numbering by ID */
+  getAbstract: (abstractNumId: number) => document_d_exports.AbstractNumbering | null;
+  /** Get the concrete numbering instance for a numId */
+  getInstance: (numId: number) => document_d_exports.NumberingInstance | null;
+  /** Check if numId exists */
   hasNumbering: (numId: number) => boolean;
 };
 /**

package/dist/docx/numberingParser.js

@@ -1,4 +1,4 @@
-import { LevelSuffixSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
+import { FontHintSchema, LevelSuffixSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
 import { findChild, findChildren, getAttribute, parseBooleanElement, parseNumericAttribute, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/numberingParser.ts
 const NUMBER_FORMAT_MAP = {
@@ -468,11 +468,13 @@ function parseLevelRunProps(rPr) {
 		const hAnsi = getAttribute(rFontsEl, "w", "hAnsi");
 		const eastAsia = getAttribute(rFontsEl, "w", "eastAsia");
 		const cs = getAttribute(rFontsEl, "w", "cs");
+		const hint = narrowEnum(getAttribute(rFontsEl, "w", "hint"), FontHintSchema);
 		formatting.fontFamily = {
 			...ascii != null ? { ascii } : {},
 			...hAnsi != null ? { hAnsi } : {},
 			...eastAsia != null ? { eastAsia } : {},
-			...cs != null ? { cs } : {}
+			...cs != null ? { cs } : {},
+			...hint !== void 0 ? { hint } : {}
 		};
 	}
 	if (szEl) {

package/dist/docx/numberingReferenceNormalization.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
-
 //#region src/docx/numberingReferenceNormalization.d.ts
 type NormalizeNumberingReferencesInput = {
   documentBody: document_d_exports.DocumentBody;
@@ -13,13 +12,6 @@ type NormalizeNumberingReferencesInput = {
 type NormalizeNumberingReferencesResult = {
   removedMissingNumberingReferences: number;
 };
-declare const normalizeNumberingReferences: ({
-  documentBody,
-  numbering,
-  headers,
-  footers,
-  footnotes,
-  endnotes
-}: NormalizeNumberingReferencesInput) => NormalizeNumberingReferencesResult;
+declare const normalizeNumberingReferences: ({ documentBody, numbering, headers, footers, footnotes, endnotes }: NormalizeNumberingReferencesInput) => NormalizeNumberingReferencesResult;
 //#endregion
 export { normalizeNumberingReferences };

package/dist/docx/paragraphParser.d.ts

@@ -2,7 +2,6 @@ import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/paragraphParser.d.ts
 /**
  * Parse paragraph formatting properties (w:pPr)

package/dist/docx/paragraphParser.js

@@ -1,5 +1,5 @@
 import { BorderStyleSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, TabLeaderSchema, TabStopAlignmentSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
-import { elementToXml, findChild, findChildren, getAttribute, getChildElements, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
+import { elementToXml, findChild, findChildren, getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute } from "./xmlParser.js";
 import { parseRun, parseRunProperties } from "./runParser.js";
 import { parseFieldType } from "./fieldParser.js";
 import { isValidHexId } from "../utils/hexId.js";
@@ -100,7 +100,7 @@ function parseTabStops(tabs) {
 				alignment
 			};
 			const leader = narrowEnum(getAttribute(tab, "w", "leader"), TabLeaderSchema);
-			if (leader) tabStop.leader = leader;
+			if (leader && leader !== "none") tabStop.leader = leader;
 			result.push(tabStop);
 		}
 	}
@@ -335,7 +335,7 @@ function parseParagraphProperties(pPr, theme, styles) {
 				if (val !== void 0) formatting.numPr.numId = val;
 			}
 			if (ilvlEl) {
-				const val = parseNumericAttribute(ilvlEl, "w", "val");
+				const val = parseNumberingLevelAttribute(ilvlEl);
 				if (val !== void 0) formatting.numPr.ilvl = val;
 			}
 		}
@@ -368,14 +368,6 @@ function parseParagraphProperties(pPr, theme, styles) {
 	}
 	return Object.keys(formatting).length > 0 ? formatting : void 0;
 }
-/**
-* 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;
-}
 const RENDERED_BREAK_INLINE_WRAPPERS = /* @__PURE__ */ new Set([
 	"hyperlink",
 	"smartTag",
@@ -398,9 +390,13 @@ const RENDERED_BREAK_NON_CONTENT_MARKERS = /* @__PURE__ */ new Set([
 	"commentReference",
 	"permStart",
 	"permEnd",
-	"rsidR"
+	"rsidR",
+	"sdtPr",
+	"sdtEndPr",
+	"smartTagPr"
 ]);
 const RENDERED_BREAK_VISIBLE_RUN_CONTENT = /* @__PURE__ */ new Set([
+	"AlternateContent",
 	"t",
 	"tab",
 	"br",
@@ -681,7 +677,11 @@ function parseSimpleField(node, styles, theme, rels, media, rootXmlns = {}) {
 	if (dirty === "1" || dirty === "true") field.dirty = true;
 	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, node);
 	const children = getChildElements(node);
-	for (const child of children) if (getLocalName(child.name) === "r") field.content.push(parseRun(child, styles, theme, rels, media, inScopeXmlns));
+	for (const child of children) {
+		const localName = getLocalName(child.name);
+		if (localName === "r") field.content.push(parseRun(child, styles, theme, rels, media, inScopeXmlns));
+		else if (localName === "hyperlink") field.content.push(parseHyperlink(child, rels, styles, theme, media, inScopeXmlns));
+	}
 	return field;
 }
 /**
@@ -740,10 +740,23 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 				if (inComplexField) {
 					if (instrText) complexFieldInstr += instrText;
 					if ((!complexFieldFormatting || Object.keys(complexFieldFormatting).length === 0) && run.formatting && Object.keys(run.formatting).length > 0) complexFieldFormatting = run.formatting;
+					let inFieldCodeRegion = !hasFieldBegin && !afterSeparator;
+					const fieldCodeContent = [];
+					for (const content of run.content) {
+						if (content.type === "fieldChar") {
+							inFieldCodeRegion = content.charType === "begin";
+							continue;
+						}
+						if (inFieldCodeRegion) fieldCodeContent.push(content);
+					}
+					if (fieldCodeContent.length > 0) complexFieldCodeRuns.push(fieldCodeContent.length === run.content.length ? run : {
+						...run,
+						content: fieldCodeContent
+					});
 					if (hasFieldSeparate) afterSeparator = true;
 					if (afterSeparator && !hasFieldEnd) {
 						if (!hasFieldSeparate) complexFieldResultRuns.push(run);
-					} else if (!afterSeparator && !hasFieldBegin) complexFieldCodeRuns.push(run);
+					}
 					if (hasFieldEnd) {
 						let resultRuns = complexFieldResultRuns;
 						if (resultRuns.length === 0 && !afterSeparator && endOriginalValue !== void 0) resultRuns = [{

package/dist/docx/paragraphTextBoxEnrichment.d.ts

@@ -3,7 +3,6 @@ import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
 import { TableParserFn } from "./textBoxParser.js";
-
 //#region src/docx/paragraphTextBoxEnrichment.d.ts
 declare const enrichParagraphTextBoxes: (paragraph: document_d_exports.Paragraph, paraXml: 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, parseTable: TableParserFn) => void;
 //#endregion

package/dist/docx/paragraphTextBoxEnrichment.js

@@ -220,7 +220,8 @@ const scanRunForTextBoxDrawings = (xmlRun) => {
 			continue;
 		}
 		if (name === "pict") {
-			if (findDeep(el, "v", "textbox")) vmlTextBoxes.push(el);
+			if (findDeep(el, "v", "textbox")) if (findDeep(el, "v", "imagedata")) hasNonTextBoxContent = true;
+			else vmlTextBoxes.push(el);
 			else hasNonTextBoxContent = true;
 			continue;
 		}

package/dist/docx/paragraphTraversal.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/paragraphTraversal.d.ts
 type VisitDocxParagraphsInput = {
   documentBody: document_d_exports.DocumentBody;
@@ -8,12 +7,6 @@ type VisitDocxParagraphsInput = {
   footnotes?: readonly document_d_exports.Footnote[] | undefined;
   endnotes?: readonly document_d_exports.Endnote[] | undefined;
 };
-declare const visitDocxParagraphs: ({
-  documentBody,
-  headers,
-  footers,
-  footnotes,
-  endnotes
-}: VisitDocxParagraphsInput, visit: (paragraph: document_d_exports.Paragraph) => void) => void;
+declare const visitDocxParagraphs: ({ documentBody, headers, footers, footnotes, endnotes }: VisitDocxParagraphsInput, visit: (paragraph: document_d_exports.Paragraph) => void) => void;
 //#endregion
 export { visitDocxParagraphs };

package/dist/docx/parser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { DocxInput } from "../utils/docxInput.js";
 import { DocxUnzipOptions } from "./unzip.js";
-
 //#region src/docx/parser.d.ts
 /**
  * Progress callback for tracking parsing stages
@@ -20,13 +19,21 @@ type MediaResolver = (file: document_d_exports.MediaFile) => Promise<string | nu
  * Parsing options
  */
 type ParseOptions = {
-  /** Progress callback for tracking parsing stages */onProgress?: ProgressCallback; /** Whether to preload fonts (default: true) */
-  preloadFonts?: boolean; /** Whether to parse headers/footers (default: true) */
-  parseHeadersFooters?: boolean; /** Whether to parse footnotes/endnotes (default: true) */
-  parseNotes?: boolean; /** Whether to detect template variables (default: true) */
-  detectVariables?: boolean; /** Password for Agile-encrypted .docx files (Office 2010+). */
-  password?: string | undefined; /** Security limits for DOCX ZIP extraction */
-  unzipLimits?: DocxUnzipOptions; /** Optional async hook to override display URLs for non-browser media. */
+  /** Progress callback for tracking parsing stages */
+  onProgress?: ProgressCallback;
+  /** Whether to preload fonts (default: true) */
+  preloadFonts?: boolean;
+  /** Whether to parse headers/footers (default: true) */
+  parseHeadersFooters?: boolean;
+  /** Whether to parse footnotes/endnotes (default: true) */
+  parseNotes?: boolean;
+  /** Whether to detect template variables (default: true) */
+  detectVariables?: boolean;
+  /** Password for Agile-encrypted .docx files (Office 2010+). */
+  password?: string | undefined;
+  /** Security limits for DOCX ZIP extraction */
+  unzipLimits?: DocxUnzipOptions;
+  /** Optional async hook to override display URLs for non-browser media. */
   mediaResolver?: MediaResolver;
 };
 /**