@stll/folio-core 0.1.2 → 0.2.0

package/dist/docx/headerFooterParser.js

@@ -1,6 +1,7 @@
 import { collectXmlnsDeclarations, parseXml } from "./xmlParser.js";
 import { parseWatermark } from "./watermarkParser.js";
 import { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences } from "./headerFooterRefParser.js";
+import { assignHeaderFooterVerbatimXml } from "./headerFooterVerbatim.js";
 import { parseBlockContent } from "./blockContentParser.js";
 //#region src/docx/headerFooterParser.ts
 /**
@@ -34,6 +35,7 @@ function parseHeader(headerXml, hdrFtrType = "default", styles = null, theme = n
 		inHeaderFooter: true,
 		rootXmlns: collectXmlnsDeclarations(rootElement)
 	});
+	assignHeaderFooterVerbatimXml(result, headerXml);
 	return result;
 }
 /**
@@ -74,6 +76,7 @@ function parseFooter(footerXml, hdrFtrType = "default", styles = null, theme = n
 		inHeaderFooter: true,
 		rootXmlns: collectXmlnsDeclarations(rootElement)
 	});
+	assignHeaderFooterVerbatimXml(result, footerXml);
 	return result;
 }
 /**

package/dist/docx/headerFooterVerbatim.d.ts

@@ -0,0 +1,19 @@
+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
+ * time so unedited headers/footers re-emit byte-identically on save (VML OLE
+ * wrappers, smart tags, and other constructs the model cannot fully represent).
+ * 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. */
+  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 clearHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter) => void;
+//#endregion
+export { HeaderFooterWithVerbatim, assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml };

package/dist/docx/headerFooterVerbatim.js

@@ -0,0 +1,25 @@
+//#region src/docx/headerFooterVerbatim.ts
+const headerFooterSerializationFingerprint = (hf) => JSON.stringify({
+	content: hf.content,
+	watermark: hf.watermark,
+	watermarkBlockIndex: hf.watermarkBlockIndex,
+	rawWatermarkXml: hf.rawWatermarkXml
+});
+const getHeaderFooterVerbatimXml = (hf) => hf.verbatimXml;
+const canReplayHeaderFooterVerbatim = (hf) => {
+	const ext = hf;
+	if (!ext.verbatimXml || !ext.verbatimFingerprint) return false;
+	return ext.verbatimFingerprint === headerFooterSerializationFingerprint(hf);
+};
+const assignHeaderFooterVerbatimXml = (hf, xml) => {
+	const ext = hf;
+	ext.verbatimXml = xml;
+	ext.verbatimFingerprint = headerFooterSerializationFingerprint(hf);
+};
+const clearHeaderFooterVerbatimXml = (hf) => {
+	const ext = hf;
+	delete ext.verbatimXml;
+	delete ext.verbatimFingerprint;
+};
+//#endregion
+export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml };

package/dist/docx/index.d.ts

@@ -0,0 +1,2 @@
+import { getCachedNumberingMap } from "./numberingParser.js";
+export { getCachedNumberingMap };

package/dist/docx/index.js

@@ -0,0 +1,2 @@
+import { getCachedNumberingMap } from "./numberingParser.js";
+export { getCachedNumberingMap };

package/dist/docx/metafileRaster.d.ts

@@ -0,0 +1,30 @@
+//#region src/docx/metafileRaster.d.ts
+/**
+ * Extract a browser-renderable raster (PNG/JPEG) embedded inside an
+ * EMF/WMF metafile.
+ *
+ * Word frequently stores header logos / OLE preview pictures as EMF — a
+ * Windows GDI metafile browsers cannot decode. In practice such an EMF almost
+ * always carries the actual artwork as a single embedded PNG or JPEG (an
+ * `EmfPlusObject` bitmap record, or a `StretchDIBits` payload). Rather than
+ * implement a GDI renderer, this scans the byte stream for a raster signature,
+ * brackets it to its container's end marker, and returns the slice. The caller
+ * uses it as the media entry's `dataUrl` so `<img>` just works; the original
+ * EMF bytes stay on `MediaFile.data` for round-trip.
+ *
+ * When no embedded raster is found this returns `null`; callers fall back to a
+ * sized placeholder and/or the host-supplied `mediaResolver` hook.
+ */
+type ExtractedRaster = {
+  bytes: Uint8Array;
+  mimeType: "image/png" | "image/jpeg";
+};
+/**
+ * Scan a metafile (EMF or WMF) for an embedded browser-renderable raster.
+ * Returns the first PNG, else first JPEG found; `null` when none is present.
+ */
+declare function extractMetafileRaster(data: ArrayBuffer | Uint8Array): ExtractedRaster | null;
+/** True for EMF/WMF MIME types — the formats browsers cannot render natively. */
+declare function isMetafileMimeType(mimeType: string | undefined): boolean;
+//#endregion
+export { ExtractedRaster, extractMetafileRaster, isMetafileMimeType };

package/dist/docx/metafileRaster.js

@@ -0,0 +1,80 @@
+//#region src/docx/metafileRaster.ts
+function indexOfBytes(haystack, needle, from = 0) {
+	outer: for (let i = from; i + needle.length <= haystack.length; i++) {
+		for (let j = 0; j < needle.length; j++) if (haystack[i + j] !== needle[j]) continue outer;
+		return i;
+	}
+	return -1;
+}
+function extractPng(bytes) {
+	const start = indexOfBytes(bytes, [
+		137,
+		80,
+		78,
+		71,
+		13,
+		10,
+		26,
+		10
+	]);
+	if (start < 0) return null;
+	let off = start + 8;
+	while (off + 12 <= bytes.length) {
+		const b0 = bytes[off];
+		const b1 = bytes[off + 1];
+		const b2 = bytes[off + 2];
+		const b3 = bytes[off + 3];
+		const len = b0 << 24 | b1 << 16 | b2 << 8 | b3;
+		const type = String.fromCharCode(bytes[off + 4], bytes[off + 5], bytes[off + 6], bytes[off + 7]);
+		const next = off + 12 + (len >>> 0);
+		if (type === "IEND") return bytes.slice(start, off + 12);
+		if (next <= off || next > bytes.length) break;
+		off = next;
+	}
+	return null;
+}
+function extractJpeg(bytes) {
+	const start = indexOfBytes(bytes, [
+		255,
+		216,
+		255
+	]);
+	if (start < 0) return null;
+	let end = -1;
+	for (let i = bytes.length - 2; i > start + 1; i--) if (bytes[i] === 255 && bytes[i + 1] === 217) {
+		end = i + 2;
+		break;
+	}
+	return end > start ? bytes.slice(start, end) : null;
+}
+/**
+* Scan a metafile (EMF or WMF) for an embedded browser-renderable raster.
+* Returns the first PNG, else first JPEG found; `null` when none is present.
+*/
+function extractMetafileRaster(data) {
+	const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);
+	if (bytes.length < 32) return null;
+	const png = extractPng(bytes);
+	if (png) return {
+		bytes: png,
+		mimeType: "image/png"
+	};
+	const jpeg = extractJpeg(bytes);
+	if (jpeg) return {
+		bytes: jpeg,
+		mimeType: "image/jpeg"
+	};
+	return null;
+}
+const METAFILE_MIME = /* @__PURE__ */ new Set([
+	"image/x-emf",
+	"image/emf",
+	"image/x-wmf",
+	"image/wmf"
+]);
+/** True for EMF/WMF MIME types — the formats browsers cannot render natively. */
+function isMetafileMimeType(mimeType) {
+	return !!mimeType && METAFILE_MIME.has(mimeType);
+}
+//#endregion
+export { extractMetafileRaster, isMetafileMimeType };

package/dist/docx/paragraphParser.js

@@ -815,7 +815,11 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 					parsedContent: parseParagraphContents(child, styles, theme, null, rels, media, "default", inScopeXmlns)
 				});
 				break;
-			case "smartTag": break;
+			case "smartTag": {
+				const inner = parseParagraphContents(child, styles, theme, null, rels, media, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child));
+				contents.push(...inner);
+				break;
+			}
 			case "moveFromRangeStart": {
 				const id = Number.parseInt(getAttribute(child, "w", "id") ?? "0", 10);
 				const name = getAttribute(child, "w", "name") ?? "";

package/dist/docx/parser.d.ts

@@ -7,6 +7,15 @@ import { DocxUnzipLimits } from "./unzip.js";
  * Progress callback for tracking parsing stages
  */
 type ProgressCallback = (stage: string, percent: number) => void;
+/**
+ * Host hook for converting media the browser cannot render natively
+ * (EMF/WMF/TIFF) into a displayable `data:` or `blob:` URL. Receives the
+ * parsed {@link MediaFile} (original bytes on `.data`); return the replacement
+ * URL, or `null`/`undefined` to keep the built-in handling. Built-in handling
+ * already extracts an embedded PNG/JPEG from EMF/WMF when one exists; this
+ * hook is for vector-only metafiles where the host rasterizes server-side.
+ */
+type MediaResolver = (file: document_d_exports.MediaFile) => Promise<string | null | undefined>;
 /**
  * Parsing options
  */
@@ -18,7 +27,8 @@ type ParseOptions = {
   detectVariables?: boolean; /** Security limits for DOCX ZIP extraction */
   unzipLimits?: Partial<Omit<DocxUnzipLimits, "allowedMediaMimeTypes">> & {
     allowedMediaMimeTypes?: Iterable<string>;
-  };
+  }; /** Optional async hook to override display URLs for non-browser media. */
+  mediaResolver?: MediaResolver;
 };
 /**
  * Parse a DOCX file into a complete Document model
@@ -64,4 +74,4 @@ declare function getDocxSummary(buffer: ArrayBuffer): Promise<{
   variableCount: number;
 }>;
 //#endregion
-export { DocxParseError, ParseOptions, ProgressCallback, fullParseDocx, getDocxSummary, getDocxVariables, parseDocx, quickParseDocx };
+export { DocxParseError, MediaResolver, ParseOptions, ProgressCallback, fullParseDocx, getDocxSummary, getDocxVariables, parseDocx, quickParseDocx };

package/dist/docx/parser.js

@@ -12,6 +12,7 @@ import { normalizeCommentReferences } from "./commentReferenceNormalization.js";
 import { extractAllTemplateVariables, parseDocumentBody } from "./documentParser.js";
 import { parseFooter, parseHeader } from "./headerFooterParser.js";
 import { normalizeHeaderFooterReferences } from "./headerFooterReferenceNormalization.js";
+import { extractMetafileRaster, isMetafileMimeType } from "./metafileRaster.js";
 import { normalizeNumberingReferences } from "./numberingReferenceNormalization.js";
 import { parseSettings } from "./settingsParser.js";
 import { parseStylesPackage } from "./styleParser.js";
@@ -47,7 +48,7 @@ import { TaggedError } from "better-result";
 */
 async function parseDocx(input, options = {}) {
 	const buffer = input instanceof ArrayBuffer ? input : await toArrayBuffer(input);
-	const { onProgress = () => {}, preloadFonts = true, parseHeadersFooters = true, parseNotes = true, detectVariables = true, unzipLimits } = options;
+	const { onProgress = () => {}, preloadFonts = true, parseHeadersFooters = true, parseNotes = true, detectVariables = true, unzipLimits, mediaResolver } = options;
 	const warnings = [];
 	try {
 		const timeStage = (_name, fn) => fn();
@@ -80,6 +81,7 @@ async function parseDocx(input, options = {}) {
 		onProgress("Parsed numbering", 35);
 		onProgress("Processing media files...", 35);
 		const media = await timeStageAsync("media", () => buildMediaMap(raw, rels));
+		if (mediaResolver) await timeStageAsync("mediaResolver", () => applyMediaResolver(media, mediaResolver));
 		onProgress("Processed media", 40);
 		onProgress("Parsing document body...", 40);
 		let documentBody = { content: [] };
@@ -196,6 +198,11 @@ var DocxParseError = class extends TaggedError("DocxParseError")() {};
 /**
 * Build media file map from raw content and relationships
 */
+function copyBytesToArrayBuffer(bytes) {
+	const buffer = new ArrayBuffer(bytes.byteLength);
+	new Uint8Array(buffer).set(bytes);
+	return buffer;
+}
 async function buildMediaMap(raw, _rels) {
 	const media = /* @__PURE__ */ new Map();
 	for (const [path, data] of raw.media.entries()) {
@@ -217,6 +224,20 @@ async function buildMediaMap(raw, _rels) {
 				continue;
 			}
 		}
+		const raster = isMetafileMimeType(mimeType) ? extractMetafileRaster(data) : null;
+		if (raster) {
+			const mediaFile = {
+				path,
+				filename,
+				mimeType,
+				data,
+				dataUrl: mediaToDataUrl(copyBytesToArrayBuffer(raster.bytes), raster.mimeType)
+			};
+			media.set(path, mediaFile);
+			const normalizedPath = path.replace(/^word\//u, "");
+			if (normalizedPath !== path) media.set(normalizedPath, mediaFile);
+			continue;
+		}
 		const mediaFile = {
 			path,
 			filename,
@@ -230,6 +251,15 @@ async function buildMediaMap(raw, _rels) {
 	}
 	return media;
 }
+async function applyMediaResolver(media, resolver) {
+	const files = [...new Set(media.values())];
+	await Promise.all(files.map(async (file) => {
+		try {
+			const url = await resolver(file);
+			if (url) file.dataUrl = url;
+		} catch {}
+	}));
+}
 function attachLazyDataUrl(mediaFile) {
 	let cachedDataUrl;
 	Object.defineProperty(mediaFile, "dataUrl", {

package/dist/docx/serializer/headerFooterSerializer.js

@@ -2,6 +2,7 @@ import { escapeXml } from "./xmlUtils.js";
 import { serializeBlockSdt } from "./blockSdtSerializer.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializeTable } from "./tableSerializer.js";
+import { canReplayHeaderFooterVerbatim, getHeaderFooterVerbatimXml } from "../headerFooterVerbatim.js";
 //#region src/docx/serializer/headerFooterSerializer.ts
 const NAMESPACES = {
 	wpc: "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas",
@@ -45,6 +46,8 @@ function serializeBlock(block) {
 * @returns Complete XML string for header*.xml or footer*.xml
 */
 function serializeHeaderFooter(hf) {
+	const verbatim = getHeaderFooterVerbatimXml(hf);
+	if (verbatim && canReplayHeaderFooterVerbatim(hf)) return verbatim;
 	const rootTag = hf.type === "header" ? "w:hdr" : "w:ftr";
 	const nsDecl = buildNamespaceDeclarations();
 	const watermarkXml = serializeWatermarkParagraph(hf);

package/dist/docx/styleParser.js

@@ -1,4 +1,4 @@
-import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumericAttribute, parseXmlDocument } from "./xmlParser.js";
+import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
 import { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FontThemeSchema, HighlightColorSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
 import { resolveThemeFontRef } from "./themeParser.js";
 import { mergeTextFormatting } from "../utils/textFormattingMerge.js";
@@ -360,9 +360,9 @@ function parseParagraphProperties(pPr, theme) {
 */
 function parseTableMeasurement(element) {
 	if (!element) return;
-	const w = parseNumericAttribute(element, "w", "w");
 	const rawType = getAttribute(element, "w", "type");
 	const type = rawType === null ? "dxa" : narrowEnum(rawType, TableWidthTypeSchema);
+	const w = type ? parseTableMeasurementValue(element, type) : void 0;
 	if (w !== void 0 && type) return {
 		value: w,
 		type

package/dist/docx/tableParser.js

@@ -1,4 +1,4 @@
-import { findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
+import { findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue } from "./xmlParser.js";
 import { parseBookmarkEnd, parseBookmarkStart } from "./bookmarkParser.js";
 import { BorderStyleSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, ShadingPatternSchema, TableCellTextDirectionSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
 import { parseParagraph } from "./paragraphParser.js";
@@ -12,12 +12,11 @@ import { appendBookmarkMarkerToLastParagraphInBlocks, appendBookmarkMarkerToLast
 */
 function parseTableMeasurement(element) {
 	if (!element) return;
-	const value = parseNumericAttribute(element, "w", "w") ?? 0;
 	const typeStr = getAttribute(element, "w", "type") ?? "dxa";
 	let type = "dxa";
 	if (typeStr === "auto" || typeStr === "dxa" || typeStr === "nil" || typeStr === "pct") type = typeStr;
 	return {
-		value,
+		value: parseTableMeasurementValue(element, type) ?? 0,
 		type
 	};
 }

package/dist/docx/unzip.js

@@ -37,7 +37,9 @@ const DEFAULT_ALLOWED_MEDIA_MIME_TYPES = /* @__PURE__ */ new Set([
 	"image/gif",
 	"image/bmp",
 	"image/tiff",
-	"image/webp"
+	"image/webp",
+	"image/x-emf",
+	"image/x-wmf"
 ]);
 const PRESERVABLE_MEDIA_MIME_TYPES = /* @__PURE__ */ new Set([
 	...DEFAULT_ALLOWED_MEDIA_MIME_TYPES,
@@ -279,6 +281,10 @@ function isMediaContentAllowed(data, mimeType) {
 		case "image/bmp": return bytes[0] === 66 && bytes[1] === 77;
 		case "image/webp": return bytes[0] === 82 && bytes[1] === 73 && bytes[2] === 70 && bytes[3] === 70 && bytes[8] === 87 && bytes[9] === 69 && bytes[10] === 66 && bytes[11] === 80;
 		case "image/tiff": return bytes[0] === 73 && bytes[1] === 73 || bytes[0] === 77 && bytes[1] === 77;
+		case "image/x-emf":
+		case "image/emf": return bytes.length >= 44 && bytes[0] === 1 && bytes[40] === 32 && bytes[41] === 69 && bytes[42] === 77 && bytes[43] === 70;
+		case "image/x-wmf":
+		case "image/wmf": return bytes.length >= 4 && (bytes[0] === 215 && bytes[1] === 205 && bytes[2] === 198 && bytes[3] === 154 || (bytes[0] === 1 || bytes[0] === 2) && bytes[1] === 0 && bytes[2] === 9 && bytes[3] === 0);
 		default: return false;
 	}
 }

package/dist/docx/wrapTypes.d.ts

@@ -7,6 +7,13 @@
  * which OOXML wrap variants are floating, which paint over body text, and
  * which wrap around it.
  */
+/**
+ * OOXML text-wrap variants for a drawing anchor (`wp:inline` vs the
+ * `wp:wrap*` elements). `inline` keeps the object in the text run; every other
+ * variant takes it out of inline flow. Mirrors the eigenpal docx-editor union
+ * so adapters share one wrap vocabulary.
+ */
+type WrapType = "inline" | "square" | "tight" | "through" | "topAndBottom" | "behind" | "inFront";
 /**
  * `true` for any wrap type that takes the object out of inline flow.
  * Includes `topAndBottom` and the wrapNone variants (`behind`/`inFront`):
@@ -26,4 +33,4 @@ declare function isWrapNone(wrapType: string | undefined): boolean;
  */
 declare function wrapsAroundText(wrapType: string | undefined): boolean;
 //#endregion
-export { isFloatingWrapType, isWrapNone, wrapsAroundText };
+export { WrapType, isFloatingWrapType, isWrapNone, wrapsAroundText };

package/dist/docx/wrapTypes.js

@@ -1,12 +1,4 @@
 //#region src/docx/wrapTypes.ts
-/**
-* Wrap-type predicates shared across the layout pipeline.
-*
-* Mirrors eigenpal docx-editor `wrapTypes` so that the new textBoxFlow
-* predicates (eigenpal #474) and the existing image classifiers agree on
-* which OOXML wrap variants are floating, which paint over body text, and
-* which wrap around it.
-*/
 const FLOATING_WRAP_TYPES = /* @__PURE__ */ new Set([
 	"square",
 	"tight",

package/dist/docx/xmlParser.d.ts

@@ -237,6 +237,12 @@ declare function parseColorElement(element: XmlElement | null | undefined): {
  * @returns Parsed number or undefined
  */
 declare function parseNumericAttribute(element: XmlElement | null | undefined, namespace: string | null, name: string, scale?: number): number | undefined;
+/**
+ * Parse `w:w` on a table width/height element. For `w:type="pct"`, producers
+ * sometimes emit human-readable percentages (`100%`) instead of 50ths-of-percent
+ * (`5000`); normalize those to the ECMA-376 unit the layout engine expects.
+ */
+declare function parseTableMeasurementValue(element: XmlElement | null | undefined, widthType: string): number | undefined;
 /**
  * Parse a boolean value from an attribute or element presence
  *
@@ -294,4 +300,4 @@ declare function mergeXmlnsDeclarations(inherited: Record<string, string>, eleme
  */
 declare function cloneWithXmlnsDeclarations(element: XmlElement, xmlnsDecls: Record<string, string>): XmlElement;
 //#endregion
-export { NAMESPACES, XmlElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumericAttribute, parseXml, parseXmlDocument };
+export { NAMESPACES, XmlElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/docx/xmlParser.js

@@ -409,6 +409,22 @@ function parseNumericAttribute(element, namespace, name, scale = 1) {
 	return num * scale;
 }
 /**
+* Parse `w:w` on a table width/height element. For `w:type="pct"`, producers
+* sometimes emit human-readable percentages (`100%`) instead of 50ths-of-percent
+* (`5000`); normalize those to the ECMA-376 unit the layout engine expects.
+*/
+function parseTableMeasurementValue(element, widthType) {
+	const raw = getAttribute(element, "w", "w");
+	if (raw === null) return;
+	const trimmed = raw.trim();
+	if (widthType === "pct" && trimmed.endsWith("%")) {
+		const pct = Number.parseFloat(trimmed.slice(0, -1));
+		if (!Number.isNaN(pct)) return Math.round(pct * 50);
+	}
+	const num = Number.parseInt(trimmed, 10);
+	return Number.isNaN(num) ? void 0 : num;
+}
+/**
 * Parse a boolean value from an attribute or element presence
 *
 * OOXML boolean conventions:
@@ -524,4 +540,4 @@ function cloneWithXmlnsDeclarations(element, xmlnsDecls) {
 	};
 }
 //#endregion
-export { NAMESPACES, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumericAttribute, parseXml, parseXmlDocument };
+export { NAMESPACES, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };