@stll/folio-core 0.15.0 → 0.15.2

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;
 };
 /**

package/dist/docx/unzip.js

@@ -59,6 +59,27 @@ const DEFAULT_UNZIP_LIMITS = {
 	maxTotalUncompressedBytes: 250 * MEBIBYTE,
 	allowedMediaMimeTypes: DEFAULT_ALLOWED_MEDIA_MIME_TYPES
 };
+const PARSED_XML_PARTS = /* @__PURE__ */ new Set([
+	"[content_types].xml",
+	"_rels/.rels",
+	"docprops/app.xml",
+	"docprops/core.xml",
+	"docprops/custom.xml",
+	"word/_rels/document.xml.rels",
+	"word/_rels/fonttable.xml.rels",
+	"word/comments.xml",
+	"word/commentsextended.xml",
+	"word/commentsextensible.xml",
+	"word/document.xml",
+	"word/endnotes.xml",
+	"word/fonttable.xml",
+	"word/footnotes.xml",
+	"word/numbering.xml",
+	"word/settings.xml",
+	"word/styles.xml",
+	"word/theme/theme1.xml"
+]);
+const shouldExtractXmlPart = (path) => PARSED_XML_PARTS.has(path) || path.startsWith("word/");
 const ZIP_END_OF_CENTRAL_DIRECTORY_SIGNATURE = 101010256;
 const ZIP_CENTRAL_DIRECTORY_FILE_HEADER_SIGNATURE = 33639248;
 const ZIP_END_OF_CENTRAL_DIRECTORY_SIZE = 22;
@@ -73,9 +94,10 @@ const ZIP_CENTRAL_DIRECTORY_FILE_HEADER_SIZE = 46;
 async function unzipDocx(buffer, options = {}) {
 	const limits = createUnzipLimits(options);
 	if (buffer.byteLength > limits.maxInputBytes) throw new DocxSecurityError("DOCX file exceeds the maximum allowed size");
-	const zipBuffer = await openDocxBuffer(buffer, { password: options.password });
+	const containerType = detectDocxContainerType(buffer);
+	const zipBuffer = containerType === DOCX_CONTAINER_TYPES.ZIP ? buffer : await openDocxBuffer(buffer, { password: options.password });
 	if (zipBuffer.byteLength > limits.maxInputBytes) throw new DocxSecurityError("DOCX file exceeds the maximum allowed size");
-	const wasEncrypted = detectDocxContainerType(buffer) === DOCX_CONTAINER_TYPES.CFB;
+	const wasEncrypted = containerType === DOCX_CONTAINER_TYPES.CFB;
 	const loaded = await loadDocxZip(zipBuffer, limits.maxFiles);
 	if (loaded.buffer.byteLength > limits.maxInputBytes) throw new DocxSecurityError("DOCX file exceeds the maximum allowed size");
 	const { zip } = loaded;
@@ -111,6 +133,7 @@ async function unzipDocx(buffer, options = {}) {
 		wasEncrypted
 	};
 	let totalUncompressedBytes = 0;
+	const extractionTasks = [];
 	for (const [path, file] of entries) {
 		if (!isSafeDocxPath(path)) throw new DocxSecurityError("DOCX file contains an unsafe entry path");
 		if (!isPreservableDocxEntry(path)) continue;
@@ -122,34 +145,16 @@ async function unzipDocx(buffer, options = {}) {
 		}
 		if (lowerPath.endsWith(".xml") || lowerPath.endsWith(".rels")) {
 			assertEntrySize(path, declaredSize, limits.maxXmlBytes);
-			const xmlContent = await file.async("text");
-			assertExtractedSize(path, xmlContent.length, limits.maxXmlBytes);
-			content.allXml.set(path, xmlContent);
-			if (lowerPath === "word/document.xml") content.documentXml = xmlContent;
-			else if (lowerPath === "word/styles.xml") content.stylesXml = xmlContent;
-			else if (lowerPath === "word/theme/theme1.xml") content.themeXml = xmlContent;
-			else if (lowerPath === "word/numbering.xml") content.numberingXml = xmlContent;
-			else if (lowerPath === "word/fonttable.xml") content.fontTableXml = xmlContent;
-			else if (lowerPath === "word/settings.xml") content.settingsXml = xmlContent;
-			else if (lowerPath === "word/websettings.xml") content.webSettingsXml = xmlContent;
-			else if (lowerPath === "word/footnotes.xml") content.footnotesXml = xmlContent;
-			else if (lowerPath === "word/endnotes.xml") content.endnotesXml = xmlContent;
-			else if (lowerPath === "word/comments.xml") content.commentsXml = xmlContent;
-			else if (lowerPath === "word/commentsextensible.xml") content.commentsExtensibleXml = xmlContent;
-			else if (lowerPath === "word/commentsextended.xml") content.commentsExtendedXml = xmlContent;
-			else if (lowerPath === "word/_rels/document.xml.rels") content.documentRels = xmlContent;
-			else if (lowerPath === "_rels/.rels") content.packageRels = xmlContent;
-			else if (lowerPath === "[content_types].xml") content.contentTypesXml = xmlContent;
-			else if (lowerPath === "docprops/core.xml") content.corePropsXml = xmlContent;
-			else if (lowerPath === "docprops/app.xml") content.appPropsXml = xmlContent;
-			else if (lowerPath === "docprops/custom.xml") content.customPropsXml = xmlContent;
-			else if (/^word\/header[^/]*\.xml$/u.test(lowerPath)) {
-				const filename = path.split("/").pop() || path;
-				content.headers.set(filename, xmlContent);
-			} else if (/^word\/footer[^/]*\.xml$/u.test(lowerPath)) {
-				const filename = path.split("/").pop() || path;
-				content.footers.set(filename, xmlContent);
-			}
+			if (options.extractAllXml === false && !shouldExtractXmlPart(lowerPath)) continue;
+			extractionTasks.push(file.async("text").then((xmlContent) => {
+				assertExtractedSize(path, xmlContent.length, limits.maxXmlBytes);
+				return {
+					type: "xml",
+					path,
+					lowerPath,
+					content: xmlContent
+				};
+			}));
 		} else if (lowerPath.startsWith("word/media/")) {
 			const mimeType = getMediaMimeType(path);
 			if (!limits.allowedMediaMimeTypes.has(mimeType)) continue;
@@ -157,22 +162,73 @@ async function unzipDocx(buffer, options = {}) {
 				content.warnings.push(`Skipped oversized media file: ${path}; original entry preserved for round-trip.`);
 				continue;
 			}
-			const binaryContent = await file.async("arraybuffer");
-			if (binaryContent.byteLength > limits.maxMediaBytes) {
-				content.warnings.push(`Skipped oversized media file: ${path}; original entry preserved for round-trip.`);
-				continue;
-			}
-			if (!isMediaContentAllowed(binaryContent, mimeType)) continue;
-			content.media.set(path, binaryContent);
+			extractionTasks.push(file.async("arraybuffer").then((binaryContent) => {
+				if (binaryContent.byteLength > limits.maxMediaBytes) {
+					content.warnings.push(`Skipped oversized media file: ${path}; original entry preserved for round-trip.`);
+					return null;
+				}
+				if (!isMediaContentAllowed(binaryContent, mimeType)) return null;
+				return {
+					type: "media",
+					path,
+					mimeType,
+					content: binaryContent
+				};
+			}));
 		} else if (lowerPath.startsWith("word/fonts/")) {
 			if (isEntryTooLarge(declaredSize, limits.maxFontBytes)) continue;
-			const binaryContent = await file.async("arraybuffer");
-			if (binaryContent.byteLength > limits.maxFontBytes) continue;
-			content.fonts.set(path, binaryContent);
+			extractionTasks.push(file.async("arraybuffer").then((binaryContent) => {
+				if (binaryContent.byteLength > limits.maxFontBytes) return null;
+				return {
+					type: "font",
+					path,
+					content: binaryContent
+				};
+			}));
 		}
 	}
+	for (const extracted of await Promise.all(extractionTasks)) {
+		if (!extracted) continue;
+		if (extracted.type === "xml") {
+			assignXmlContent(content, extracted);
+			continue;
+		}
+		if (extracted.type === "media") {
+			content.media.set(extracted.path, extracted.content);
+			continue;
+		}
+		content.fonts.set(extracted.path, extracted.content);
+	}
 	return content;
 }
+function assignXmlContent(content, { path, lowerPath, content: xmlContent }) {
+	content.allXml.set(path, xmlContent);
+	if (lowerPath === "word/document.xml") content.documentXml = xmlContent;
+	else if (lowerPath === "word/styles.xml") content.stylesXml = xmlContent;
+	else if (lowerPath === "word/theme/theme1.xml") content.themeXml = xmlContent;
+	else if (lowerPath === "word/numbering.xml") content.numberingXml = xmlContent;
+	else if (lowerPath === "word/fonttable.xml") content.fontTableXml = xmlContent;
+	else if (lowerPath === "word/settings.xml") content.settingsXml = xmlContent;
+	else if (lowerPath === "word/websettings.xml") content.webSettingsXml = xmlContent;
+	else if (lowerPath === "word/footnotes.xml") content.footnotesXml = xmlContent;
+	else if (lowerPath === "word/endnotes.xml") content.endnotesXml = xmlContent;
+	else if (lowerPath === "word/comments.xml") content.commentsXml = xmlContent;
+	else if (lowerPath === "word/commentsextensible.xml") content.commentsExtensibleXml = xmlContent;
+	else if (lowerPath === "word/commentsextended.xml") content.commentsExtendedXml = xmlContent;
+	else if (lowerPath === "word/_rels/document.xml.rels") content.documentRels = xmlContent;
+	else if (lowerPath === "_rels/.rels") content.packageRels = xmlContent;
+	else if (lowerPath === "[content_types].xml") content.contentTypesXml = xmlContent;
+	else if (lowerPath === "docprops/core.xml") content.corePropsXml = xmlContent;
+	else if (lowerPath === "docprops/app.xml") content.appPropsXml = xmlContent;
+	else if (lowerPath === "docprops/custom.xml") content.customPropsXml = xmlContent;
+	else if (/^word\/header[^/]*\.xml$/u.test(lowerPath)) {
+		const filename = path.split("/").pop() || path;
+		content.headers.set(filename, xmlContent);
+	} else if (/^word\/footer[^/]*\.xml$/u.test(lowerPath)) {
+		const filename = path.split("/").pop() || path;
+		content.footers.set(filename, xmlContent);
+	}
+}
 async function loadDocxZip(buffer, maxFiles) {
 	try {
 		return {

package/dist/docx/vmlImageParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/vmlImageParser.d.ts
 /**
  * Parse a `w:pict` element into an inline image, or null when it carries no

package/dist/docx/vmlImageParser.js

@@ -1,4 +1,4 @@
-import { cloneWithXmlnsDeclarations, elementToXml, findAllDeep, findChild, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
+import { cloneWithXmlnsDeclarations, elementToXml, findAllDeep, findChild, findDeep, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
 import { pixelsToEmu } from "../utils/units.js";
 import { sanitizeImageSrc } from "../utils/sanitizeImageSrc.js";
 import { resolveImageData } from "./imageParser.js";
@@ -136,6 +136,7 @@ const previewImage = (pictElement, svg, widthPx, heightPx, style, rootXmlns) =>
 	};
 };
 const parseStandaloneShapePreview = (pictElement, shape, rootXmlns) => {
+	if (findDeep(shape, "v", "textbox")) return null;
 	const style = parseStyleAttr(getAttribute(shape, null, "style"));
 	const widthPx = cssLengthToPx(style["width"]);
 	const heightPx = cssLengthToPx(style["height"]);
@@ -159,6 +160,7 @@ const parseGroupPreview = (pictElement, group, rootXmlns) => {
 	if (size.first <= 0 || size.second <= 0) return null;
 	const content = getChildElements(group).slice(0, MAX_VML_PREVIEW_SHAPES).map((child) => {
 		const localName = getLocalName(child.name ?? "");
+		if (findDeep(child, "v", "textbox")) return "";
 		if (localName === "line") {
 			const from = coordinatePair(getAttribute(child, null, "from"));
 			const to = coordinatePair(getAttribute(child, null, "to"));

package/dist/docx/watermarkParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/watermarkParser.d.ts
 /**
  * Result of walking a header for its watermark. Carries the modeled

package/dist/docx/xmlParser.d.ts

@@ -79,7 +79,7 @@ declare function parseXmlDocument(xml: string): XmlElement | null;
  * Get local name from a prefixed element name
  * e.g., "w:p" -> "p", "a:graphic" -> "graphic"
  */
-declare function getLocalName(name: string): string;
+declare function getLocalName(name: string | undefined): string;
 /**
  * Get namespace prefix from an element name
  * e.g., "w:p" -> "w", "a:graphic" -> "a"
@@ -92,7 +92,7 @@ declare function getNamespacePrefix(name: string): string | null;
  * @param namespace - Namespace prefix (e.g., "w", "a")
  * @param localName - Local element name (e.g., "p", "r")
  */
-declare function matchesName(element: XmlElement, namespace: string, localName: string): boolean;
+declare function matchesName(element: XmlElement, _namespace: string, localName: string): boolean;
 /**
  * Find first child element matching the given namespaced name
  *
@@ -101,7 +101,7 @@ declare function matchesName(element: XmlElement, namespace: string, localName:
  * @param localName - Local element name (e.g., "p")
  * @returns First matching child or null
  */
-declare function findChild(parent: XmlElement | null | undefined, namespace: string, localName: string): XmlElement | null;
+declare function findChild(parent: XmlElement | null | undefined, _namespace: string, localName: string): XmlElement | null;
 /**
  * Find all child elements matching the given namespaced name
  *
@@ -110,7 +110,7 @@ declare function findChild(parent: XmlElement | null | undefined, namespace: str
  * @param localName - Local element name
  * @returns Array of matching children
  */
-declare function findChildren(parent: XmlElement | null | undefined, namespace: string, localName: string): XmlElement[];
+declare function findChildren(parent: XmlElement | null | undefined, _namespace: string, localName: string): XmlElement[];
 /**
  * Find first child element by local name only (ignoring namespace)
  *
@@ -237,6 +237,14 @@ 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 a zero-based numbering level reference.
+ *
+ * OOXML numbering levels cannot be negative. Some producers emit negative
+ * sentinel values alongside `w:numId="0"` to disable numbering; treat those
+ * as an omitted level instead of leaking an invalid value into the model.
+ */
+declare function parseNumberingLevelAttribute(element: XmlElement | null | undefined): 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
@@ -294,10 +302,15 @@ declare function collectXmlnsDeclarations(element: XmlElement): Record<string, s
  */
 declare function mergeXmlnsDeclarations(inherited: Record<string, string>, element: XmlElement): Record<string, string>;
 /**
- * Return a shallow clone of `element` whose attributes carry every declaration
- * in `xmlnsDecls`. Existing attributes (including any namespace declarations the
- * element already carries) win over the injected ones.
+ * Return a shallow clone of `element` carrying the inherited namespace
+ * declarations needed by its raw subtree.
+ *
+ * Existing declarations retain their authored order. Only missing, referenced
+ * bindings are appended, which makes repeated detach/replay cycles idempotent
+ * even when the surrounding document declares a different namespace superset.
+ * If a producer omitted a binding for a standard OOXML prefix, use its
+ * canonical binding so the detached subtree is valid on its first replay.
  */
 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, parseTableMeasurementValue, 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, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/docx/xmlParser.js

@@ -53,6 +53,8 @@ const fxpBuilder = new XMLBuilder(fxpBuilderOptions);
 const TEXT_KEY = "#text";
 /** Attribute group key used by fast-xml-parser in preserveOrder mode. */
 const ATTR_KEY = ":@";
+/** Character reference required to keep carriage returns through XML end-of-line normalization. */
+const XML_CARRIAGE_RETURN_REFERENCE = "
";
 /**
 * Convert a fast-xml-parser preserveOrder node into an XmlElement.
 *
@@ -75,9 +77,8 @@ function fxpNodeToElement(node) {
 		};
 		if (attrs) element.attributes = attrs;
 		if (children.length > 0) {
-			const elements = [];
-			for (const child of children) elements.push(fxpNodeToElement(child));
-			element.elements = elements;
+			for (let index = 0; index < children.length; index += 1) children[index] = fxpNodeToElement(children[index]);
+			element.elements = children;
 		}
 		return element;
 	}
@@ -89,9 +90,8 @@ function fxpNodeToElement(node) {
 * `{ elements: [...] }`.
 */
 function fxpToRootElement(nodes) {
-	const elements = [];
-	for (const node of nodes) elements.push(fxpNodeToElement(node));
-	return { elements };
+	for (let index = 0; index < nodes.length; index += 1) nodes[index] = fxpNodeToElement(nodes[index]);
+	return { elements: nodes };
 }
 /**
 * Convert an XmlElement back into the fast-xml-parser preserveOrder format
@@ -123,7 +123,7 @@ function parseXml(xml) {
 */
 function elementToXml(element) {
 	const fxpNode = elementToFxpNode(element);
-	return fxpBuilder.build([fxpNode]);
+	return fxpBuilder.build([fxpNode]).replaceAll("\r", XML_CARRIAGE_RETURN_REFERENCE);
 }
 /**
 * Parse XML string to a more convenient format
@@ -131,7 +131,10 @@ function elementToXml(element) {
 function parseXmlDocument(xml) {
 	try {
 		const parsed = parseXml(xml);
-		if (parsed.elements && parsed.elements.length > 0) return parsed.elements.find((e) => e.type === "element") ?? null;
+		if (parsed.elements && parsed.elements.length > 0) {
+			for (const element of parsed.elements) if (element.type === "element") return element;
+			return null;
+		}
 		return parsed;
 	} catch {
 		return null;
@@ -142,6 +145,8 @@ function parseXmlDocument(xml) {
 * e.g., "w:p" -> "p", "a:graphic" -> "graphic"
 */
 function getLocalName(name) {
+	if (!name) return "";
+	if (name[1] === ":") return name.slice(2);
 	const colonIndex = name.indexOf(":");
 	return colonIndex !== -1 ? name.slice(colonIndex + 1) : name;
 }
@@ -150,9 +155,16 @@ function getLocalName(name) {
 * e.g., "w:p" -> "w", "a:graphic" -> "a"
 */
 function getNamespacePrefix(name) {
+	if (name[1] === ":") return name[0] ?? null;
 	const colonIndex = name.indexOf(":");
 	return colonIndex !== -1 ? name.slice(0, colonIndex) : null;
 }
+function hasLocalName(name, localName) {
+	if (!name) return false;
+	if (name === localName) return true;
+	const localNameOffset = name.length - localName.length;
+	return localNameOffset > 0 && name[localNameOffset - 1] === ":" && name.endsWith(localName);
+}
 /**
 * Check if an element matches a given namespaced name
 *
@@ -160,12 +172,9 @@ function getNamespacePrefix(name) {
 * @param namespace - Namespace prefix (e.g., "w", "a")
 * @param localName - Local element name (e.g., "p", "r")
 */
-function matchesName(element, namespace, localName) {
+function matchesName(element, _namespace, localName) {
 	if (!element.name) return false;
-	const fullName = `${namespace}:${localName}`;
-	if (element.name === fullName) return true;
-	if (getLocalName(element.name) === localName) return true;
-	return false;
+	return hasLocalName(element.name, localName);
 }
 /**
 * Find first child element matching the given namespaced name
@@ -175,13 +184,11 @@ function matchesName(element, namespace, localName) {
 * @param localName - Local element name (e.g., "p")
 * @returns First matching child or null
 */
-function findChild(parent, namespace, localName) {
+function findChild(parent, _namespace, localName) {
 	if (!parent || !parent.elements) return null;
-	const fullName = `${namespace}:${localName}`;
 	for (const child of parent.elements) {
 		if (child.type !== "element") continue;
-		if (child.name === fullName) return child;
-		if (getLocalName(child.name || "") === localName) return child;
+		if (hasLocalName(child.name, localName)) return child;
 	}
 	return null;
 }
@@ -193,13 +200,12 @@ function findChild(parent, namespace, localName) {
 * @param localName - Local element name
 * @returns Array of matching children
 */
-function findChildren(parent, namespace, localName) {
+function findChildren(parent, _namespace, localName) {
 	if (!parent || !parent.elements) return [];
-	const fullName = `${namespace}:${localName}`;
 	const results = [];
 	for (const child of parent.elements) {
 		if (child.type !== "element") continue;
-		if (child.name === fullName || getLocalName(child.name || "") === localName) results.push(child);
+		if (hasLocalName(child.name, localName)) results.push(child);
 	}
 	return results;
 }
@@ -214,7 +220,7 @@ function findChildByLocalName(parent, localName) {
 	if (!parent || !parent.elements) return null;
 	for (const child of parent.elements) {
 		if (child.type !== "element") continue;
-		if (getLocalName(child.name || "") === localName) return child;
+		if (hasLocalName(child.name, localName)) return child;
 	}
 	return null;
 }
@@ -227,7 +233,9 @@ function findChildByLocalName(parent, localName) {
 */
 function findChildrenByLocalName(parent, localName) {
 	if (!parent || !parent.elements) return [];
-	return parent.elements.filter((child) => child.type === "element" && getLocalName(child.name || "") === localName);
+	const results = [];
+	for (const child of parent.elements) if (child.type === "element" && hasLocalName(child.name, localName)) results.push(child);
+	return results;
 }
 /**
 * Find first child element by full name (including namespace prefix)
@@ -252,7 +260,9 @@ function findByFullName(parent, fullName) {
 */
 function getChildElements(parent) {
 	if (!parent || !parent.elements) return [];
-	return parent.elements.filter((child) => child.type === "element");
+	const results = [];
+	for (const child of parent.elements) if (child.type === "element") results.push(child);
+	return results;
 }
 /**
 * Get an attribute value from an element
@@ -277,13 +287,13 @@ function getAttribute(element, namespace, name) {
 	if (!element || !element.attributes) return null;
 	const attrs = element.attributes;
 	if (namespace) {
-		const prefixedName = `${namespace}:${name}`;
-		if (prefixedName in attrs) return attrs[prefixedName] ?? null;
+		const prefixedValue = attrs[`${namespace}:${name}`];
+		if (prefixedValue !== void 0) return prefixedValue;
 	}
-	if (name in attrs) return attrs[name] ?? null;
+	const unprefixedValue = attrs[name];
+	if (unprefixedValue !== void 0) return unprefixedValue;
 	if (namespace) {
-		const suffix = `:${name}`;
-		for (const key of Object.keys(attrs)) if (key.endsWith(suffix)) return attrs[key] ?? null;
+		for (const key in attrs) if (hasLocalName(key, name)) return attrs[key] ?? null;
 	}
 	return null;
 }
@@ -312,8 +322,11 @@ function getAttributeAnyPrefix(element, localName) {
 	if (canonical !== null) return canonical;
 	const attrs = element.attributes;
 	if (attrs) {
-		const suffix = `:${localName}`;
-		for (const [key, value] of Object.entries(attrs)) if (key === localName || key.endsWith(suffix)) return value;
+		for (const key in attrs) if (hasLocalName(key, localName)) {
+			const value = attrs[key];
+			if (value === void 0) return null;
+			return typeof value === "string" ? value : String(value);
+		}
 	}
 	return null;
 }
@@ -416,6 +429,17 @@ function parseNumericAttribute(element, namespace, name, scale = 1) {
 	return num * scale;
 }
 /**
+* Parse a zero-based numbering level reference.
+*
+* OOXML numbering levels cannot be negative. Some producers emit negative
+* sentinel values alongside `w:numId="0"` to disable numbering; treat those
+* as an omitted level instead of leaking an invalid value into the model.
+*/
+function parseNumberingLevelAttribute(element) {
+	const level = parseNumericAttribute(element, "w", "val");
+	return level !== void 0 && level >= 0 ? level : void 0;
+}
+/**
 * 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.
@@ -519,9 +543,14 @@ function collectXmlnsDeclarations(element) {
 	const out = {};
 	const attrs = element.attributes;
 	if (!attrs) return out;
-	for (const [key, value] of Object.entries(attrs)) {
-		if (Object.keys(out).length >= MAX_XMLNS_DECLARATIONS_PER_ELEMENT) break;
-		if ((key === "xmlns" || key.startsWith("xmlns:")) && value !== void 0) out[key] = String(value);
+	let declarationCount = 0;
+	for (const key in attrs) {
+		if (declarationCount >= MAX_XMLNS_DECLARATIONS_PER_ELEMENT) break;
+		const value = attrs[key];
+		if ((key === "xmlns" || key.startsWith("xmlns:")) && value !== void 0) {
+			out[key] = String(value);
+			declarationCount += 1;
+		}
 	}
 	return out;
 }
@@ -535,26 +564,80 @@ function collectXmlnsDeclarations(element) {
 */
 function mergeXmlnsDeclarations(inherited, element) {
 	const own = collectXmlnsDeclarations(element);
-	if (Object.keys(own).length === 0) return inherited;
-	return {
+	for (const _key in own) return {
 		...inherited,
 		...own
 	};
+	return inherited;
 }
+const QNAME_VALUE_ATTRIBUTES = /* @__PURE__ */ new Set([
+	"Ignorable",
+	"PreserveAttributes",
+	"PreserveElements",
+	"ProcessContent",
+	"Requires"
+]);
+const addPrefix = (name, prefixes) => {
+	const separatorIndex = name.indexOf(":");
+	if (separatorIndex > 0) prefixes.add(name.slice(0, separatorIndex));
+};
+/**
+* Collect namespace prefixes whose bindings a detached raw subtree needs.
+*
+* Element and attribute names use prefixes directly. Markup-compatibility and
+* QName-valued attributes can also refer to prefixes in their values, so keep
+* those bindings even when no descendant name uses them.
+*/
+const collectUsedNamespacePrefixes = (element, prefixes = /* @__PURE__ */ new Set()) => {
+	if (element.name) if (element.name.includes(":")) addPrefix(element.name, prefixes);
+	else prefixes.add("");
+	if (element.attributes) for (const [name, value] of Object.entries(element.attributes)) {
+		if (name === "xmlns" || name.startsWith("xmlns:")) continue;
+		addPrefix(name, prefixes);
+		const localName = name.slice(name.indexOf(":") + 1);
+		if (name !== "xsi:type" && !QNAME_VALUE_ATTRIBUTES.has(localName)) continue;
+		for (const token of String(value).split(/\s+/u)) {
+			const separatorIndex = token.indexOf(":");
+			prefixes.add(separatorIndex > 0 ? token.slice(0, separatorIndex) : token);
+		}
+	}
+	if (element.elements) {
+		for (const child of element.elements) if (child.type === "element") collectUsedNamespacePrefixes(child, prefixes);
+	}
+	return prefixes;
+};
+const isCanonicalNamespacePrefix = (prefix) => Object.hasOwn(NAMESPACES, prefix);
 /**
-* Return a shallow clone of `element` whose attributes carry every declaration
-* in `xmlnsDecls`. Existing attributes (including any namespace declarations the
-* element already carries) win over the injected ones.
+* Return a shallow clone of `element` carrying the inherited namespace
+* declarations needed by its raw subtree.
+*
+* Existing declarations retain their authored order. Only missing, referenced
+* bindings are appended, which makes repeated detach/replay cycles idempotent
+* even when the surrounding document declares a different namespace superset.
+* If a producer omitted a binding for a standard OOXML prefix, use its
+* canonical binding so the detached subtree is valid on its first replay.
 */
 function cloneWithXmlnsDeclarations(element, xmlnsDecls) {
-	if (Object.keys(xmlnsDecls).length === 0) return element;
-	return {
+	const prefixes = collectUsedNamespacePrefixes(element);
+	const additions = {};
+	const attributes = element.attributes ?? {};
+	for (const [name, value] of Object.entries(xmlnsDecls)) {
+		const prefix = name === "xmlns" ? "" : name.slice(6);
+		if (prefixes.has(prefix) && attributes[name] === void 0) additions[name] = value;
+	}
+	for (const prefix of prefixes) {
+		const name = `xmlns:${prefix}`;
+		if (!prefix || attributes[name] !== void 0 || additions[name] !== void 0 || !isCanonicalNamespacePrefix(prefix)) continue;
+		additions[name] = NAMESPACES[prefix];
+	}
+	for (const _key in additions) return {
 		...element,
 		attributes: {
-			...xmlnsDecls,
-			...element.attributes
+			...attributes,
+			...additions
 		}
 	};
+	return element;
 }
 //#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, parseTableMeasurementValue, 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, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };