@stll/folio-core 0.15.0 → 0.15.1

package/dist/docx/server/applyDocxXmlPatchProposal.d.ts

@@ -1,13 +1,13 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
 import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalLimits } from "./evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, FolioDocxConformanceReport } from "./validateDocxConformance.js";
-
 //#region src/docx/server/applyDocxXmlPatchProposal.d.ts
 declare const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION: 1;
 declare const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE: "folio-xml-patch-application-v1";
 type ApplyDocxXmlPatchProposalArgs = {
   readonly bytes: ArrayBuffer | Uint8Array;
-  readonly proposal: unknown; /** Exact package paths authorized by the server-side caller. */
+  readonly proposal: unknown;
+  /** Exact package paths authorized by the server-side caller. */
   readonly allowedParts: readonly string[];
   readonly validationProfile: typeof FOLIO_DOCX_CONFORMANCE_PROFILE;
   readonly archive?: DocxArchiveOptions;
@@ -75,13 +75,6 @@ declare const FolioDocxXmlPatchApplicationError_base: import("better-result").Ta
 }>;
 declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base {}
 /** Apply a guarded XML proposal and return output only after full profile validation. */
-declare const applyDocxXmlPatchProposal: ({
-  bytes,
-  proposal: rawProposal,
-  allowedParts,
-  validationProfile,
-  archive,
-  limits
-}: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
+declare const applyDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, validationProfile, archive, limits }: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
 //#endregion
 export { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal };

package/dist/docx/server/docxToMarkdown.d.ts

@@ -1,5 +1,4 @@
 import { MarkdownOptions } from "../../markdown/types.js";
-
 //#region src/docx/server/docxToMarkdown.d.ts
 /**
  * Convert a DOCX file to markdown in a single server-safe call.

package/dist/docx/server/evaluateDocxXmlPatchProposal.d.ts

@@ -1,5 +1,4 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
-
 //#region src/docx/server/evaluateDocxXmlPatchProposal.d.ts
 declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION: 1;
 declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE: "folio-xml-patch-proposal-v1";
@@ -26,7 +25,8 @@ type FolioDocxXmlPatchProposalLimits = {
 };
 type EvaluateDocxXmlPatchProposalArgs = {
   readonly bytes: ArrayBuffer | Uint8Array;
-  readonly proposal: unknown; /** Exact package paths authorized by the server-side caller. */
+  readonly proposal: unknown;
+  /** Exact package paths authorized by the server-side caller. */
   readonly allowedParts: readonly string[];
   readonly archive?: DocxArchiveOptions;
   readonly limits?: FolioDocxXmlPatchProposalLimits;
@@ -74,12 +74,6 @@ declare const InvalidFolioDocxXmlPatchProposalOptionsError_base: import("better-
 }>;
 declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsError_base {}
 declare const parseFolioDocxXmlPatchProposal: (value: unknown) => FolioDocxXmlPatchProposal;
-declare const evaluateDocxXmlPatchProposal: ({
-  bytes,
-  proposal: rawProposal,
-  allowedParts,
-  archive,
-  limits: rawLimits
-}: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
+declare const evaluateDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, archive, limits: rawLimits }: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
 //#endregion
 export { EvaluateDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposal, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalIssue, FolioDocxXmlPatchProposalIssueCode, FolioDocxXmlPatchProposalLimits, FolioDocxXmlReplacement, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal };

package/dist/docx/server/inspectDocxPackage.d.ts

@@ -1,5 +1,4 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
-
 //#region src/docx/server/inspectDocxPackage.d.ts
 declare const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION: 1;
 declare const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS: Readonly<{
@@ -37,7 +36,8 @@ type FolioDocxInspectedXmlPart = {
   readonly path: string;
   readonly contentType: string | null;
   readonly byteLength: number;
-  readonly sha256: string; /** Untrusted document data; callers must not treat this text as instructions. */
+  readonly sha256: string;
+  /** Untrusted document data; callers must not treat this text as instructions. */
   readonly text: string;
 };
 type FolioDocxPackageInspection = {
@@ -54,12 +54,7 @@ type ReadRequestedXmlPartsOptions = {
     maxBytes: number;
   }) => Promise<Uint8Array | null>;
 };
-declare const readRequestedXmlParts: ({
-  paths,
-  partsByPath,
-  limits,
-  readEntryUint8
-}: ReadRequestedXmlPartsOptions) => Promise<FolioDocxInspectedXmlPart[]>;
+declare const readRequestedXmlParts: ({ paths, partsByPath, limits, readEntryUint8 }: ReadRequestedXmlPartsOptions) => Promise<FolioDocxInspectedXmlPart[]>;
 /**
  * Inspect package metadata and only the explicitly requested XML part bodies.
  * This reports archive contents, not package conformance; use the conformance

package/dist/docx/server/validateDocxConformance.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
 import { DocxArchiveOptions } from "./boundedArchive.js";
-
 //#region src/docx/server/validateDocxConformance.d.ts
 declare const FOLIO_DOCX_CONFORMANCE_REPORT_VERSION: 1;
 declare const FOLIO_DOCX_CONFORMANCE_PROFILE: "folio-supported-v1";

package/dist/docx/settingsParser.d.ts

@@ -1,8 +1,8 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/settingsParser.d.ts
 type FolioDocumentSettings = document_d_exports.DocumentSettings & {
-  /** Swap left/right section margins on even physical pages. */mirrorMargins?: boolean;
+  /** Swap left/right section margins on even physical pages. */
+  mirrorMargins?: boolean;
 };
 /** OOXML default per §17.6.13 when `w:defaultTabStop` is absent. */
 declare const DEFAULT_TAB_STOP_TWIPS = 720;

package/dist/docx/shapeParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/shapeParser.d.ts
 /**
  * Parse a `<wps:wsp>` element into a Shape model. Does NOT pick up the

package/dist/docx/shapeParser.js

@@ -179,13 +179,10 @@ function colorNeedsRawPreservation(color) {
 }
 function fillNeedsRawPreservation(fill) {
 	if (!fill) return false;
-	if (fill.type === "solid") return colorNeedsRawPreservation(fill.color);
+	if (fill.type === "solid") return false;
 	if (fill.type === "gradient") return fill.gradient?.stops.some((stop) => colorNeedsRawPreservation(stop.color)) ?? false;
 	return false;
 }
-function outlineNeedsRawPreservation(outline) {
-	return colorNeedsRawPreservation(outline?.color);
-}
 /**
 * Parse a `<wps:wsp>` element into a Shape model. Does NOT pick up the
 * extent / position / wrap fields — those live on the wrapping
@@ -231,13 +228,17 @@ function parseShapeFromDrawing(drawingEl) {
 	if (!wsp) return null;
 	if (findChildByLocalName(wsp, "txbx") !== null) return null;
 	const spPr = findChildByLocalName(wsp, "spPr");
-	if (hasUnsupportedGeometry(spPr) || hasUnsupportedRgbColorModifiers(spPr) || hasUnmodeledFill(spPr) || fillNeedsRawPreservation(parseShapeFill(spPr)) || outlineNeedsRawPreservation(parseShapeOutline(spPr))) return null;
+	if (hasUnsupportedGeometry(spPr) || hasUnsupportedRgbColorModifiers(spPr) || hasUnmodeledFill(spPr) || fillNeedsRawPreservation(parseShapeFill(spPr))) return null;
 	const shape = parseShape(wsp);
 	const extent = findChildByLocalName(container, "extent");
-	if (extent) shape.size = {
-		width: parseNumericAttribute(extent, null, "cx") ?? shape.size.width,
-		height: parseNumericAttribute(extent, null, "cy") ?? shape.size.height
-	};
+	if (extent) {
+		const outerWidth = parseNumericAttribute(extent, null, "cx");
+		const outerHeight = parseNumericAttribute(extent, null, "cy");
+		shape.size = {
+			width: outerWidth !== void 0 && (outerWidth > 0 || shape.size.width === 0) ? outerWidth : shape.size.width,
+			height: outerHeight !== void 0 && (outerHeight > 0 || shape.size.height === 0) ? outerHeight : shape.size.height
+		};
+	}
 	if (container === anchor) {
 		const position = parseAnchorPosition(container);
 		if (position) shape.position = position;
@@ -266,7 +267,7 @@ function shouldPreserveRawShapeDrawing(drawingEl) {
 	if (hasUnsupportedGeometry(spPr)) return true;
 	if (hasUnsupportedRgbColorModifiers(spPr)) return true;
 	if (hasUnmodeledFill(spPr)) return true;
-	return fillNeedsRawPreservation(parseShapeFill(spPr)) || outlineNeedsRawPreservation(parseShapeOutline(spPr));
+	return fillNeedsRawPreservation(parseShapeFill(spPr));
 }
 //#endregion
 export { parseShape, parseShapeFromDrawing, shouldPreserveRawShapeDrawing };

package/dist/docx/streamingXmlParser.d.ts

@@ -0,0 +1,16 @@
+import { XmlElement } from "./xmlParser.js";
+//#region src/docx/streamingXmlParser.d.ts
+type ParseXmlResult = {
+  status: "parsed";
+  value: XmlElement;
+} | {
+  status: "unsupported";
+};
+/**
+ * Parse ordinary OOXML into Folio's existing element representation in one
+ * pass. Unsupported or malformed constructs return a sentinel so callers can
+ * retain the general-purpose parser as a compatibility fallback.
+ */
+declare const parseStreamingXml: (xml: string) => ParseXmlResult;
+//#endregion
+export { parseStreamingXml };

package/dist/docx/streamingXmlParser.js

@@ -0,0 +1,248 @@
+//#region src/docx/streamingXmlParser.ts
+const BUILT_IN_ENTITIES = {
+	amp: "&",
+	apos: "'",
+	gt: ">",
+	lt: "<",
+	quot: "\""
+};
+/**
+* Parse ordinary OOXML into Folio's existing element representation in one
+* pass. Unsupported or malformed constructs return a sentinel so callers can
+* retain the general-purpose parser as a compatibility fallback.
+*/
+const parseStreamingXml = (xml) => {
+	const root = { elements: [] };
+	const stack = [];
+	let cursor = 0;
+	let mergeAdjacentText = false;
+	while (cursor < xml.length) {
+		const open = xml.indexOf("<", cursor);
+		if (open === -1) {
+			if (!appendText(xml.slice(cursor), stack, mergeAdjacentText)) return { status: "unsupported" };
+			break;
+		}
+		if (open > cursor && !appendText(xml.slice(cursor, open), stack, mergeAdjacentText)) return { status: "unsupported" };
+		if (open > cursor) mergeAdjacentText = true;
+		if (xml.startsWith("<!--", open)) {
+			const close = xml.indexOf("-->", open + 4);
+			if (close === -1) return { status: "unsupported" };
+			cursor = close + 3;
+			continue;
+		}
+		if (xml.startsWith("<![CDATA[", open)) {
+			const close = xml.indexOf("]]>", open + 9);
+			if (close === -1 || !appendRawText(normalizeLineEndings(xml.slice(open + 9, close)), stack)) return { status: "unsupported" };
+			cursor = close + 3;
+			mergeAdjacentText = false;
+			continue;
+		}
+		if (xml.startsWith("<?", open)) {
+			const close = xml.indexOf("?>", open + 2);
+			if (close === -1) return { status: "unsupported" };
+			cursor = close + 2;
+			continue;
+		}
+		if (xml.startsWith("<!", open)) return { status: "unsupported" };
+		const close = findTagClose(xml, open + 1);
+		if (close === -1) return { status: "unsupported" };
+		if (xml.charCodeAt(open + 1) === 47) {
+			const name = xml.slice(open + 2, close).trim();
+			const frame = stack.pop();
+			if (!frame || frame.name !== name) return { status: "unsupported" };
+			cursor = close + 1;
+			mergeAdjacentText = false;
+			continue;
+		}
+		const parsedTag = parseOpenTag(xml, open + 1, close);
+		if (parsedTag.status === "unsupported") return parsedTag;
+		const parent = stack.at(-1)?.element ?? root;
+		appendElement(parent, parsedTag.element);
+		if (!parsedTag.selfClosing) {
+			if (stack.length >= 100) return { status: "unsupported" };
+			stack.push({
+				element: parsedTag.element,
+				name: parsedTag.name
+			});
+		}
+		cursor = close + 1;
+		mergeAdjacentText = false;
+	}
+	if (stack.length > 0) return { status: "unsupported" };
+	return {
+		status: "parsed",
+		value: root
+	};
+};
+const parseOpenTag = (xml, start, close) => {
+	let cursor = skipWhitespace(xml, start, close);
+	const nameStart = cursor;
+	cursor = scanName(xml, cursor, close);
+	if (cursor === nameStart) return { status: "unsupported" };
+	const name = xml.slice(nameStart, cursor);
+	if (isUnsafePropertyName(name)) return { status: "unsupported" };
+	let attributes;
+	let selfClosing = false;
+	while (cursor < close) {
+		cursor = skipWhitespace(xml, cursor, close);
+		if (cursor >= close) break;
+		if (xml.charCodeAt(cursor) === 47) {
+			selfClosing = true;
+			cursor = skipWhitespace(xml, cursor + 1, close);
+			if (cursor !== close) return { status: "unsupported" };
+			break;
+		}
+		const attributeNameStart = cursor;
+		cursor = scanName(xml, cursor, close);
+		if (cursor === attributeNameStart) return { status: "unsupported" };
+		const attributeName = xml.slice(attributeNameStart, cursor);
+		if (isUnsafePropertyName(attributeName)) return { status: "unsupported" };
+		cursor = skipWhitespace(xml, cursor, close);
+		if (xml.charCodeAt(cursor) !== 61) return { status: "unsupported" };
+		cursor = skipWhitespace(xml, cursor + 1, close);
+		const quote = xml.charCodeAt(cursor);
+		if (quote !== 34 && quote !== 39) return { status: "unsupported" };
+		const valueStart = cursor + 1;
+		cursor = xml.indexOf(quote === 34 ? "\"" : "'", valueStart);
+		if (cursor === -1 || cursor > close) return { status: "unsupported" };
+		const decoded = decodeXmlEntities(normalizeLineEndings(xml.slice(valueStart, cursor)));
+		if (decoded === null) return { status: "unsupported" };
+		attributes ??= {};
+		attributes[attributeName] = decoded;
+		cursor += 1;
+	}
+	const element = {
+		type: "element",
+		name
+	};
+	if (attributes) element.attributes = attributes;
+	return {
+		status: "parsed",
+		element,
+		name,
+		selfClosing
+	};
+};
+const appendElement = (parent, child) => {
+	parent.elements ??= [];
+	parent.elements.push(child);
+};
+const appendText = (text, stack, mergeAdjacentText) => {
+	if (text.length === 0) return true;
+	const decoded = decodeXmlEntities(normalizeLineEndings(text));
+	if (decoded === null) return false;
+	const parent = stack.at(-1)?.element;
+	const previous = mergeAdjacentText ? parent?.elements?.at(-1) : void 0;
+	if (previous?.type === "text" && typeof previous.text === "string") {
+		previous.text += decoded;
+		return true;
+	}
+	return appendRawText(decoded, stack);
+};
+const appendRawText = (text, stack) => {
+	const parent = stack.at(-1)?.element;
+	if (!parent) return text.trim().length === 0;
+	appendElement(parent, {
+		type: "text",
+		text
+	});
+	return true;
+};
+const findTagClose = (xml, start) => {
+	let quote = 0;
+	for (let cursor = start; cursor < xml.length; cursor += 1) {
+		const code = xml.charCodeAt(cursor);
+		if (quote !== 0) {
+			if (code === quote) quote = 0;
+			continue;
+		}
+		if (code === 34 || code === 39) {
+			quote = code;
+			continue;
+		}
+		if (code === 62) return cursor;
+	}
+	return -1;
+};
+const skipWhitespace = (xml, start, limit) => {
+	let cursor = start;
+	while (cursor < limit) {
+		const code = xml.charCodeAt(cursor);
+		if (code !== 9 && code !== 10 && code !== 13 && code !== 32) break;
+		cursor += 1;
+	}
+	return cursor;
+};
+const scanName = (xml, start, limit) => {
+	let cursor = start;
+	while (cursor < limit) {
+		const code = xml.charCodeAt(cursor);
+		if (code === 9 || code === 10 || code === 13 || code === 32 || code === 47 || code === 61 || code === 62) break;
+		cursor += 1;
+	}
+	return cursor;
+};
+const decodeXmlEntities = (value) => {
+	const firstEntity = value.indexOf("&");
+	if (firstEntity === -1) return value;
+	const parts = [];
+	let cursor = 0;
+	let entityStart = firstEntity;
+	while (entityStart !== -1) {
+		parts.push(value.slice(cursor, entityStart));
+		const entityEnd = value.indexOf(";", entityStart + 1);
+		if (entityEnd === -1) return null;
+		const entity = value.slice(entityStart + 1, entityEnd);
+		const decoded = decodeXmlEntity(entity);
+		if (decoded === null) return null;
+		parts.push(decoded);
+		cursor = entityEnd + 1;
+		entityStart = value.indexOf("&", cursor);
+	}
+	parts.push(value.slice(cursor));
+	return parts.join("");
+};
+const normalizeLineEndings = (value) => {
+	if (!value.includes("\r")) return value;
+	return value.replaceAll("\r\n", "\n").replaceAll("\r", "\n");
+};
+const decodeXmlEntity = (entity) => {
+	switch (entity) {
+		case "amp": return BUILT_IN_ENTITIES.amp;
+		case "apos": return BUILT_IN_ENTITIES.apos;
+		case "gt": return BUILT_IN_ENTITIES.gt;
+		case "lt": return BUILT_IN_ENTITIES.lt;
+		case "quot": return BUILT_IN_ENTITIES.quot;
+	}
+	if (entity.charCodeAt(0) !== 35) return null;
+	const hexadecimal = entity.charCodeAt(1) === 120 || entity.charCodeAt(1) === 88;
+	const digits = entity.slice(hexadecimal ? 2 : 1);
+	if (digits.length === 0 || !hasOnlyDigits(digits, hexadecimal)) return null;
+	const codePoint = Number.parseInt(digits, hexadecimal ? 16 : 10);
+	if (!Number.isInteger(codePoint) || codePoint <= 0 || codePoint > 1114111 || codePoint >= 55296 && codePoint <= 57343) return null;
+	return String.fromCodePoint(codePoint);
+};
+const hasOnlyDigits = (value, hexadecimal) => {
+	for (let index = 0; index < value.length; index += 1) {
+		const code = value.charCodeAt(index);
+		if (!(code >= 48 && code <= 57) && !(hexadecimal && code >= 97 && code <= 102) && !(hexadecimal && code >= 65 && code <= 70)) return false;
+	}
+	return true;
+};
+const isUnsafePropertyName = (name) => {
+	switch (name) {
+		case "__defineGetter__":
+		case "__defineSetter__":
+		case "__lookupGetter__":
+		case "__lookupSetter__":
+		case "__proto__":
+		case "constructor":
+		case "hasOwnProperty":
+		case "prototype":
+		case "toString":
+		case "valueOf": return true;
+		default: return false;
+	}
+};
+//#endregion
+export { parseStreamingXml };

package/dist/docx/styleParser.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/styleParser.d.ts
 /**
  * Style map keyed by styleId

package/dist/docx/styleParser.js

@@ -1,5 +1,5 @@
-import { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FontThemeSchema, HighlightColorSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
-import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
+import { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FontHintSchema, FontThemeSchema, HighlightColorSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
+import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
 import { mergeTextFormatting } from "../utils/textFormattingMerge.js";
 import { mergeParagraphFormatting } from "../utils/paragraphFormattingMerge.js";
 import { resolveThemeFontRef } from "./themeParser.js";
@@ -76,6 +76,8 @@ function parseRunProperties(rPr, theme) {
 		if (eastAsia) fontFamily.eastAsia = eastAsia;
 		const csFont = getAttribute(rFonts, "w", "cs");
 		if (csFont) fontFamily.cs = csFont;
+		const hint = narrowEnum(getAttribute(rFonts, "w", "hint"), FontHintSchema);
+		if (hint) fontFamily.hint = hint;
 		const asciiTheme = narrowEnum(getAttribute(rFonts, "w", "asciiTheme"), FontThemeSchema);
 		if (asciiTheme) {
 			fontFamily.asciiTheme = asciiTheme;
@@ -244,7 +246,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);
 		}
 	}
@@ -342,7 +344,7 @@ function parseParagraphProperties(pPr, theme) {
 				if (val !== void 0) formatting.numPr.numId = val;
 			}
 			if (ilvl) {
-				const val = parseNumericAttribute(ilvl, "w", "val");
+				const val = parseNumberingLevelAttribute(ilvl);
 				if (val !== void 0) formatting.numPr.ilvl = val;
 			}
 		}

package/dist/docx/tableParser.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/tableParser.d.ts
 /**
  * Sanity cap on `w:gridSpan` (and the derived table column count). Word's
@@ -139,7 +138,7 @@ declare function parseTableGrid(tblGridElement: XmlElement | null): number[] | u
 declare function parseTable(tblElement: 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, options?: {
   inHeaderFooter?: boolean;
   rootXmlns?: Record<string, string>;
-}): document_d_exports.Table;
+}): document_d_exports.Table | undefined;
 /**
  * Get the number of columns in a table
  *

package/dist/docx/tableParser.js

@@ -1,5 +1,5 @@
 import { BorderStyleSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, ShadingPatternSchema, TableCellTextDirectionSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
-import { findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue } from "./xmlParser.js";
+import { findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue } from "./xmlParser.js";
 import { parseBookmarkEnd, parseBookmarkStart } from "./bookmarkParser.js";
 import { parseParagraph } from "./paragraphParser.js";
 import { appendBookmarkMarkerToLastParagraphInBlocks, appendBookmarkMarkerToLastParagraphInCells, prependBookmarkMarkersToFirstParagraphInBlocks, prependBookmarkMarkersToFirstParagraphInCell } from "./bookmarkPlacement.js";
@@ -536,6 +536,7 @@ function parseCellContent(tcElement, styles, theme, numbering, rels, media, opti
 		}
 		if (localName === "tbl") {
 			const table = parseTable(child, styles, theme, numbering, rels, media, options);
+			if (!table) return;
 			if (prependBookmarkMarkersToFirstParagraphInBlocks([table], pendingBookmarkMarkers)) pendingBookmarkMarkers.length = 0;
 			content.push(table);
 			return;
@@ -635,11 +636,6 @@ function parseTableRow(trElement, styles, theme, numbering, rels, media, options
 	if (pendingBookmarkMarkers.length > 0) appendBookmarkMarkersToLastCell(row, pendingBookmarkMarkers);
 	return row;
 }
-function getLocalName(name) {
-	if (!name) return "";
-	const colonIndex = name.indexOf(":");
-	return colonIndex === -1 ? name : name.slice(colonIndex + 1);
-}
 function parseBookmarkMarker(child, localName) {
 	if (localName === "bookmarkStart") return parseBookmarkStart(child);
 	return parseBookmarkEnd(child);
@@ -751,6 +747,7 @@ function parseTable(tblElement, styles, theme, numbering, rels, media, options)
 		for (const sdtChild of getChildElements(sdtContent)) parseTableChild(sdtChild);
 	};
 	for (const child of getChildElements(tblElement)) parseTableChild(child);
+	if (table.rows.length === 0) return;
 	inferImplicitSingleCellRowSpans(table, rowsWithGridOffsets);
 	return table;
 }

package/dist/docx/textBoxParser.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/textBoxParser.d.ts
 /**
  * Extract raw paragraph elements from w:txbxContent
@@ -19,7 +18,7 @@ type ParagraphParserFn = (node: XmlElement, styles: StyleMap | null, theme: docu
 /**
  * Type for the table parser function to avoid circular imports
  */
-type TableParserFn = (node: 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) => document_d_exports.Table;
+type TableParserFn = (node: 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) => document_d_exports.Table | undefined;
 /**
  * Parse text box content with provided parser functions
  * This avoids circular dependencies by accepting parser functions as parameters

package/dist/docx/textBoxParser.js

@@ -55,7 +55,10 @@ function parseTextBoxContent(txbxContent, parseParagraph, parseTable, styles, th
 		if (localName === "p") {
 			const paragraph = parseParagraph(child, styles, theme, numbering, rels, media);
 			blocks.push(paragraph);
-		} else if (localName === "tbl" && parseTable) blocks.push(parseTable(child, styles, theme, numbering, rels, media));
+		} else if (localName === "tbl" && parseTable) {
+			const table = parseTable(child, styles, theme, numbering, rels, media);
+			if (table) blocks.push(table);
+		}
 	}
 	return blocks;
 }

package/dist/docx/textWhitespace.d.ts

@@ -0,0 +1,4 @@
+//#region src/docx/textWhitespace.d.ts
+declare const requiresXmlSpacePreserve: (text: string) => boolean;
+//#endregion
+export { requiresXmlSpacePreserve };

package/dist/docx/textWhitespace.js

@@ -0,0 +1,4 @@
+//#region src/docx/textWhitespace.ts
+const requiresXmlSpacePreserve = (text) => text.startsWith(" ") || text.endsWith(" ") || text.includes("  ");
+//#endregion
+export { requiresXmlSpacePreserve };

package/dist/docx/themeParser.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/themeParser.d.ts
 /**
  * Parse theme1.xml content

package/dist/docx/trackedMoveRangeNormalization.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/trackedMoveRangeNormalization.d.ts
 type NormalizeTrackedMoveRangesInput = {
   documentBody: document_d_exports.DocumentBody;
@@ -11,12 +10,6 @@ type NormalizeTrackedMoveRangesInput = {
 type NormalizeTrackedMoveRangesResult = {
   removedUnbalancedMoveRangeMarkers: number;
 };
-declare const normalizeTrackedMoveRanges: ({
-  documentBody,
-  headers,
-  footers,
-  footnotes,
-  endnotes
-}: NormalizeTrackedMoveRangesInput) => NormalizeTrackedMoveRangesResult;
+declare const normalizeTrackedMoveRanges: ({ documentBody, headers, footers, footnotes, endnotes }: NormalizeTrackedMoveRangesInput) => NormalizeTrackedMoveRangesResult;
 //#endregion
 export { normalizeTrackedMoveRanges };

package/dist/docx/unzip.d.ts

@@ -1,5 +1,4 @@
 import JSZip from "jszip";
-
 //#region src/docx/unzip.d.ts
 declare class DocxSecurityError extends Error {
   constructor(message: string);
@@ -14,7 +13,10 @@ type DocxUnzipLimits = {
   allowedMediaMimeTypes: ReadonlySet<string>;
 };
 type DocxUnzipOptions = Partial<Omit<DocxUnzipLimits, "allowedMediaMimeTypes">> & {
-  allowedMediaMimeTypes?: Iterable<string>; /** Password for Agile-encrypted .docx files (Office 2010+). */
+  allowedMediaMimeTypes?: Iterable<string>;
+  /** Extract every XML part into allXml instead of only parts used by the parser. */
+  extractAllXml?: boolean;
+  /** Password for Agile-encrypted .docx files (Office 2010+). */
   password?: string | undefined;
 };
 /**
@@ -46,7 +48,8 @@ type RawDocxContent = {
   allXml: Map<string, string>;
   originalZip: JSZip;
   originalBuffer: ArrayBuffer;
-  warnings: string[]; /** True when the input was a password-protected CFB container. */
+  warnings: string[];
+  /** True when the input was a password-protected CFB container. */
   wasEncrypted: boolean;
 };
 /**