@a3s-lab/office 0.46.0 → 0.48.0

package/dist/{0~4042.js → 0~3534.js}

@@ -1,6 +1,7 @@
 import jszip from "jszip";
 import { normalizeDocumentIndexEntryDraft, serializeUtf8Xml, directChildren, xmlNamespacePrefix, normalizeDocumentLanguageTag, parseXml, firstDescendant, decodeXmlBytes, directChild, descendants, normalizeDocumentProofingLanguages, attribute as work_ooxml_package_attribute, normalizeDocumentIndexOptions } from "./6968.js";
 import { normalizeDocumentEmphasisMark, normalizeDocumentCharacterScalePercent, documentCitationStyle, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentCharacterSpacingTwips, normalizeDocumentKerningThresholdHalfPoints, normalizeDocumentOpenTypeNumberSpacing, createDocumentBibliography, normalizeDocumentImageTransform, normalizeDocumentOpenTypeLigatures, normalizeDocumentOpenTypeNumberForm, normalizeDocumentTabStops, documentCitationStyleDetails, normalizeDocumentOpenTypeStylisticSets } from "./4174.js";
+import { normalizeDocumentHref } from "./0~work-document-links.js";
 const BIBLIOGRAPHY_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/bibliography';
 const CUSTOM_XML_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/customXml';
 const OFFICE_RELATIONSHIPS_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
@@ -708,6 +709,511 @@ function isAllowedExtensionNamespace(namespace, context) {
 function isNamespacePrefix(value) {
     return /^[A-Za-z_][A-Za-z0-9_.-]*$/.test(value) && 'xml' !== value;
 }
+const PACKAGE_RELATIONSHIP_NAMESPACE = 'http://schemas.openxmlformats.org/package/2006/relationships';
+const TRANSITIONAL_RELATIONSHIP_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+const STRICT_RELATIONSHIP_NAMESPACE = 'http://purl.oclc.org/ooxml/officeDocument/relationships';
+const work_docx_note_comment_hyperlink_relationships_RELATIONSHIP_NAMESPACES = new Set([
+    TRANSITIONAL_RELATIONSHIP_NAMESPACE,
+    STRICT_RELATIONSHIP_NAMESPACE
+]);
+const HYPERLINK_RELATIONSHIP_TYPES = new Set([
+    `${TRANSITIONAL_RELATIONSHIP_NAMESPACE}/hyperlink`,
+    `${STRICT_RELATIONSHIP_NAMESPACE}/hyperlink`
+]);
+const GENERATED_HYPERLINK_RELATIONSHIP_TYPE = `${TRANSITIONAL_RELATIONSHIP_NAMESPACE}/hyperlink`;
+const RELATIONSHIP_ID_PATTERN = /^[A-Za-z_][A-Za-z0-9_.-]{0,254}$/;
+const MAX_RELATIONSHIPS = 65536;
+async function loadDocxHyperlinkRelationshipState(generatedArchive, sourceArchive, ownerPart) {
+    const path = work_docx_note_comment_hyperlink_relationships_relationshipPartPath(ownerPart);
+    const [generated, source] = await Promise.all([
+        loadRelationships(generatedArchive, path, 'generated'),
+        loadRelationships(sourceArchive, path, 'source')
+    ]);
+    return {
+        archive: generatedArchive,
+        dirty: false,
+        generated: generated.document,
+        generatedMalformed: generated.malformed,
+        path,
+        source: source.document
+    };
+}
+function readDocxHyperlinkDestination(hyperlink, state, role) {
+    if (!DOCX_WORDPROCESSING_NAMESPACES.has(hyperlink.namespaceURI ?? '')) return null;
+    const anchor = uniqueNamespacedAttribute(hyperlink, 'anchor', DOCX_WORDPROCESSING_NAMESPACES);
+    const relationshipId = uniqueNamespacedAttribute(hyperlink, 'id', work_docx_note_comment_hyperlink_relationships_RELATIONSHIP_NAMESPACES);
+    if (void 0 === anchor || void 0 === relationshipId) return null;
+    const normalizedAnchor = null === anchor ? null : normalizeAnchor(anchor);
+    if (null !== anchor && !normalizedAnchor) return null;
+    if (normalizedAnchor && relationshipId) return null;
+    if (normalizedAnchor) return {
+        kind: 'internal',
+        target: normalizedAnchor
+    };
+    if (!relationshipId || !RELATIONSHIP_ID_PATTERN.test(relationshipId)) return null;
+    const relationships = 'generated' === role ? state.generated : state.source;
+    const relationship = relationships?.byId.get(relationshipId);
+    if (!relationship || !isExternalHyperlinkRelationship(relationship)) return null;
+    const target = normalizeDocumentHref(relationship.target);
+    if (!target || target.startsWith('#')) return null;
+    return {
+        kind: 'external',
+        relationshipId,
+        target
+    };
+}
+function ensureDocxExternalHyperlinkRelationships(state, requests) {
+    if (!requests.length) return [];
+    if (state.generatedMalformed) return null;
+    const relationships = state.generated ?? createRelationshipsDocument();
+    const usedIds = new Set(relationships.usedIds);
+    const idByTarget = new Map(Array.from(relationships.byId.values()).flatMap((item)=>{
+        const target = isExternalHyperlinkRelationship(item) ? normalizeDocumentHref(item.target) : null;
+        return target && !target.startsWith('#') ? [
+            [
+                target,
+                item.id
+            ]
+        ] : [];
+    }));
+    const pending = [];
+    const result = [];
+    for (const request of requests){
+        if (!RELATIONSHIP_ID_PATTERN.test(request.sourceId)) return null;
+        const target = normalizeDocumentHref(request.target);
+        if (!target || target.startsWith('#')) return null;
+        const existingId = idByTarget.get(target);
+        if (existingId) {
+            result.push(existingId);
+            continue;
+        }
+        if (usedIds.size >= MAX_RELATIONSHIPS) return null;
+        const id = usedIds.has(request.sourceId) ? work_docx_note_comment_hyperlink_relationships_nextRelationshipId(usedIds) : request.sourceId;
+        usedIds.add(id);
+        idByTarget.set(target, id);
+        pending.push({
+            id,
+            target
+        });
+        result.push(id);
+    }
+    if (!pending.length) return result;
+    state.generated = relationships;
+    for (const item of pending)appendExternalHyperlinkRelationship(relationships, item.id, item.target);
+    state.dirty = true;
+    return result;
+}
+function setDocxHyperlinkDestination(hyperlink, root, destination, relationshipId) {
+    removeNamespacedAttribute(hyperlink, 'anchor', DOCX_WORDPROCESSING_NAMESPACES);
+    removeNamespacedAttribute(hyperlink, 'id', work_docx_note_comment_hyperlink_relationships_RELATIONSHIP_NAMESPACES);
+    if ('internal' === destination.kind) {
+        const namespace = hyperlink.namespaceURI;
+        if (!namespace || !DOCX_WORDPROCESSING_NAMESPACES.has(namespace)) return false;
+        setNamespacedAttribute(hyperlink, root, namespace, 'w', 'anchor', destination.target);
+        return true;
+    }
+    if (!relationshipId || !RELATIONSHIP_ID_PATTERN.test(relationshipId)) return false;
+    setNamespacedAttribute(hyperlink, root, TRANSITIONAL_RELATIONSHIP_NAMESPACE, 'r', 'id', relationshipId);
+    return true;
+}
+function flushDocxHyperlinkRelationships(state) {
+    if (!state.dirty || !state.generated) return;
+    state.archive.file(state.path, serializeUtf8Xml(state.generated.document));
+}
+function normalizeAnchor(value) {
+    const anchor = value.trim();
+    return anchor.length <= 255 && normalizeDocumentHref(`#${anchor}`) ? anchor : null;
+}
+function isExternalHyperlinkRelationship(relationship) {
+    return HYPERLINK_RELATIONSHIP_TYPES.has(relationship.type) && 'external' === relationship.targetMode.toLowerCase();
+}
+async function loadRelationships(archive, path, role) {
+    const entry = archive.file(path);
+    if (!entry) return {
+        document: null,
+        malformed: false
+    };
+    try {
+        const document = parseXml(decodeXmlBytes(await entry.async('uint8array'), `${role} DOCX ${path}`), `${role} DOCX ${path}`);
+        const root = document.documentElement;
+        if ('Relationships' !== root.localName || root.namespaceURI !== PACKAGE_RELATIONSHIP_NAMESPACE) return {
+            document: null,
+            malformed: true
+        };
+        const byId = new Map();
+        const usedIds = new Set();
+        const elements = directChildren(root);
+        if (elements.length > MAX_RELATIONSHIPS) return {
+            document: null,
+            malformed: true
+        };
+        for (const element of elements){
+            if ('Relationship' !== element.localName || element.namespaceURI !== PACKAGE_RELATIONSHIP_NAMESPACE) return {
+                document: null,
+                malformed: true
+            };
+            const record = relationshipRecord(element);
+            if (!record || usedIds.has(record.id)) return {
+                document: null,
+                malformed: true
+            };
+            byId.set(record.id, record);
+            usedIds.add(record.id);
+        }
+        return {
+            document: {
+                byId,
+                document,
+                usedIds
+            },
+            malformed: false
+        };
+    } catch  {
+        return {
+            document: null,
+            malformed: true
+        };
+    }
+}
+function relationshipRecord(element) {
+    const id = element.getAttribute('Id')?.trim() ?? '';
+    const target = element.getAttribute('Target')?.trim() ?? '';
+    const type = element.getAttribute('Type')?.trim() ?? '';
+    const targetMode = element.getAttribute('TargetMode')?.trim() ?? '';
+    if (!RELATIONSHIP_ID_PATTERN.test(id) || !target || !type) return null;
+    return {
+        id,
+        target,
+        targetMode,
+        type
+    };
+}
+function createRelationshipsDocument() {
+    const document = parseXml(`<Relationships xmlns="${PACKAGE_RELATIONSHIP_NAMESPACE}"/>`, 'generated DOCX hyperlink relationships');
+    return {
+        byId: new Map(),
+        document,
+        usedIds: new Set()
+    };
+}
+function appendExternalHyperlinkRelationship(relationships, id, target) {
+    const element = relationships.document.createElementNS(PACKAGE_RELATIONSHIP_NAMESPACE, 'Relationship');
+    element.setAttribute('Id', id);
+    element.setAttribute('Type', GENERATED_HYPERLINK_RELATIONSHIP_TYPE);
+    element.setAttribute('Target', target);
+    element.setAttribute('TargetMode', 'External');
+    relationships.document.documentElement.append(element);
+    relationships.byId.set(id, {
+        id,
+        target,
+        targetMode: 'External',
+        type: GENERATED_HYPERLINK_RELATIONSHIP_TYPE
+    });
+    relationships.usedIds.add(id);
+}
+function uniqueNamespacedAttribute(element, localName, namespaces) {
+    const matches = Array.from(element.attributes).filter((item)=>xmlAttributeLocalName(item) === localName && namespaces.has(xmlAttributeNamespace(element, item) ?? ''));
+    return matches.length <= 1 ? matches[0]?.value.trim() ?? null : void 0;
+}
+function removeNamespacedAttribute(element, localName, namespaces) {
+    for (const item of Array.from(element.attributes))if (xmlAttributeLocalName(item) === localName && namespaces.has(xmlAttributeNamespace(element, item) ?? '')) element.removeAttributeNode(item);
+}
+function setNamespacedAttribute(element, root, namespace, preferredPrefix, localName, value) {
+    let prefix = xmlDeclaredPrefix(element, namespace) ?? xmlDeclaredPrefix(root, namespace);
+    if (!prefix) {
+        prefix = availablePrefix(root, preferredPrefix);
+        root.setAttributeNS(XMLNS_NAMESPACE, `xmlns:${prefix}`, namespace);
+    }
+    element.setAttributeNS(namespace, `${prefix}:${localName}`, value);
+}
+function availablePrefix(root, preferred) {
+    if (!xmlNamespaceUri(root, preferred)) return preferred;
+    let index = 1;
+    while(xmlNamespaceUri(root, `${preferred}${index}`))index += 1;
+    return `${preferred}${index}`;
+}
+function work_docx_note_comment_hyperlink_relationships_nextRelationshipId(used) {
+    let index = 1;
+    while(used.has(`rId${index}`))index += 1;
+    return `rId${index}`;
+}
+function work_docx_note_comment_hyperlink_relationships_relationshipPartPath(ownerPart) {
+    const separator = ownerPart.lastIndexOf('/');
+    const directory = separator < 0 ? '' : ownerPart.slice(0, separator + 1);
+    const file = ownerPart.slice(separator + 1);
+    return `${directory}_rels/${file}.rels`;
+}
+const work_docx_note_comment_hyperlink_content_MARKUP_COMPATIBILITY_NAMESPACE = 'http://schemas.openxmlformats.org/markup-compatibility/2006';
+const MAX_PARAGRAPHS = 65536;
+const MAX_RUNS = 262144;
+const MAX_COMMENT_RUN_SEGMENTS = 4096;
+function noteCommentContentParagraphs(scope, role, relationships, limits) {
+    const paragraphs = descendants(scope, 'p').filter(isWordElement);
+    const paragraphKey = `${role}Paragraphs`;
+    limits[paragraphKey] += paragraphs.length;
+    if (limits[paragraphKey] > MAX_PARAGRAPHS) throw new Error(`${roleLabel(role)} DOCX exceeds the stable note/comment hyperlink paragraph limit.`);
+    const result = [];
+    for (const paragraph of paragraphs){
+        const runKey = `${role}Runs`;
+        limits[runKey] += directContentRunCount(paragraph);
+        if (limits[runKey] > MAX_RUNS) throw new Error(`${roleLabel(role)} DOCX exceeds the stable note/comment hyperlink run limit.`);
+        const content = noteCommentParagraphContent(paragraph, relationships, role);
+        if (!content?.text) continue;
+        const ancestry = paragraphAncestry(paragraph, scope);
+        if (ancestry) result.push({
+            element: paragraph,
+            hyperlinks: content.hyperlinks,
+            identity: `${ancestry}\u0000${content.text}`,
+            runs: content.runs,
+            text: content.text
+        });
+    }
+    return result;
+}
+function directContentRunCount(paragraph) {
+    let count = 0;
+    for (const child of Array.from(paragraph.children))if (isWordElement(child)) {
+        if ('r' === child.localName) count += 1;
+        if ('hyperlink' === child.localName) count += wordDirectChildren(child, 'r').length;
+    }
+    return count;
+}
+function noteCommentParagraphContent(paragraph, relationships, role) {
+    const runs = [];
+    const hyperlinks = [];
+    let offset = 0;
+    let paragraphProperties = 0;
+    for (const child of Array.from(paragraph.children)){
+        if (!isWordElement(child)) {
+            if (isContentSemanticNamespace(child.namespaceURI ?? '')) return null;
+            continue;
+        }
+        if ('pPr' === child.localName) {
+            paragraphProperties += 1;
+            if (paragraphProperties > 1) return null;
+            continue;
+        }
+        if ('r' === child.localName) {
+            const text = contentRunText(child);
+            if (null === text) return null;
+            const start = offset;
+            offset += text.length;
+            if (text) runs.push({
+                container: null,
+                element: child,
+                start,
+                end: offset,
+                text
+            });
+            continue;
+        }
+        if ('hyperlink' !== child.localName) return null;
+        const start = offset;
+        for (const hyperlinkChild of Array.from(child.children)){
+            if (!isWordElement(hyperlinkChild)) {
+                if (isContentSemanticNamespace(hyperlinkChild.namespaceURI ?? '')) return null;
+                continue;
+            }
+            if ('r' !== hyperlinkChild.localName) return null;
+            const text = contentRunText(hyperlinkChild);
+            if (null === text) return null;
+            const runStart = offset;
+            offset += text.length;
+            if (text) runs.push({
+                container: child,
+                element: hyperlinkChild,
+                start: runStart,
+                end: offset,
+                text
+            });
+        }
+        if (offset > start) hyperlinks.push({
+            destination: readDocxHyperlinkDestination(child, relationships, role),
+            element: child,
+            start,
+            end: offset,
+            text: runs.filter((run)=>run.container === child).map((run)=>run.text).join('')
+        });
+    }
+    return {
+        hyperlinks,
+        runs,
+        text: runs.map((run)=>run.text).join('')
+    };
+}
+function groupNoteCommentParagraphs(paragraphs) {
+    const result = new Map();
+    for (const paragraph of paragraphs){
+        const matches = result.get(paragraph.identity) ?? [];
+        matches.push(paragraph);
+        result.set(paragraph.identity, matches);
+    }
+    return result;
+}
+function groupNoteCommentHyperlinks(hyperlinks) {
+    const result = new Map();
+    for (const hyperlink of hyperlinks){
+        const key = noteCommentHyperlinkSpanKey(hyperlink);
+        const matches = result.get(key) ?? [];
+        matches.push(hyperlink);
+        result.set(key, matches);
+    }
+    return result;
+}
+function noteCommentHyperlinkSpanKey(item) {
+    return `${item.start}:${item.end}:${item.text}`;
+}
+function noteCommentHyperlinksOverlap(left, right) {
+    return left.start < right.end && right.start < left.end;
+}
+function restoreElementChildren(element, children) {
+    while(element.firstChild)element.removeChild(element.firstChild);
+    for (const child of children)element.append(child);
+}
+function alignCommentRunBoundaries(generated, source) {
+    if (generated.hyperlinks.length || 1 !== generated.runs.length || generated.runs[0].container || source.runs.length <= 1 || source.runs.length > MAX_COMMENT_RUN_SEGMENTS || !isSimpleTextRun(generated.runs[0].element) || source.runs.some((run)=>!isSimpleTextRun(run.element))) return false;
+    const original = generated.runs[0].element;
+    if (!original.parentNode) return false;
+    const clones = [];
+    for (const sourceRun of source.runs){
+        const clone = original.cloneNode(true);
+        const textElement = wordDirectChildren(clone, 't')[0];
+        if (!textElement) return false;
+        textElement.textContent = sourceRun.text;
+        setTextSpacePreservation(textElement, sourceRun.text);
+        clones.push(clone);
+    }
+    for (const clone of clones)original.parentNode.insertBefore(clone, original);
+    original.remove();
+    return true;
+}
+function isKnownOoxmlNamespace(namespace) {
+    if (namespace === work_docx_note_comment_hyperlink_content_MARKUP_COMPATIBILITY_NAMESPACE) return false;
+    return DOCX_WORDPROCESSING_NAMESPACES.has(namespace) || namespace.startsWith('http://schemas.microsoft.com/office/') || namespace.startsWith('http://schemas.openxmlformats.org/') || namespace.startsWith('http://purl.oclc.org/ooxml/') || namespace.startsWith('urn:schemas-microsoft-com:') || namespace.startsWith('urn:microsoft-com:office:');
+}
+function contentRunText(run) {
+    let text = '';
+    for (const child of Array.from(run.children)){
+        if (!isWordElement(child)) {
+            if (isContentSemanticNamespace(child.namespaceURI ?? '')) return null;
+            continue;
+        }
+        if ('rPr' !== child.localName) {
+            if ('t' === child.localName || 'delText' === child.localName) text += child.textContent ?? '';
+            else if ('tab' === child.localName) text += '\t';
+            else if ('br' === child.localName || 'cr' === child.localName) text += '\n';
+            else if ('noBreakHyphen' === child.localName) text += '\u2011';
+            else if ('softHyphen' === child.localName) text += '\u00ad';
+            else if ('footnoteRef' !== child.localName && 'endnoteRef' !== child.localName) return null;
+        }
+    }
+    return text;
+}
+function isSimpleTextRun(run) {
+    const children = Array.from(run.children).filter(isWordElement);
+    return 1 === children.filter((child)=>'t' === child.localName).length && children.every((child)=>'rPr' === child.localName || 't' === child.localName);
+}
+function setTextSpacePreservation(element, text) {
+    for (const item of Array.from(element.attributes))if ('space' === xmlAttributeLocalName(item) && xmlAttributeNamespace(element, item) === XML_NAMESPACE) element.removeAttributeNode(item);
+    if (/^\s|\s$/u.test(text)) element.setAttributeNS(XML_NAMESPACE, 'xml:space', 'preserve');
+}
+function paragraphAncestry(paragraph, scope) {
+    const path = [];
+    let current = paragraph;
+    while(current && current !== scope){
+        if (!isWordElement(current)) return null;
+        path.push(current.localName);
+        current = current.parentElement;
+    }
+    return current === scope ? path.reverse().join('/') : null;
+}
+function isContentSemanticNamespace(namespace) {
+    return namespace === work_docx_note_comment_hyperlink_content_MARKUP_COMPATIBILITY_NAMESPACE || isKnownOoxmlNamespace(namespace);
+}
+function wordDirectChildren(element, localName) {
+    return Array.from(element.children).filter((child)=>child.localName === localName && isWordElement(child));
+}
+function isWordElement(element) {
+    return DOCX_WORDPROCESSING_NAMESPACES.has(element.namespaceURI ?? '');
+}
+function roleLabel(role) {
+    return 'source' === role ? 'Registered source' : 'Generated';
+}
+const CONTENT_CONTROL_MC_NAMESPACE = 'http://schemas.openxmlformats.org/markup-compatibility/2006';
+const CONTENT_CONTROL_RELATIONSHIP_NAMESPACES = new Set([
+    'http://schemas.openxmlformats.org/officeDocument/2006/relationships',
+    'http://purl.oclc.org/ooxml/officeDocument/relationships'
+]);
+const CONTENT_CONTROL_WORD_2012_NAMESPACE = 'http://schemas.microsoft.com/office/word/2012/wordml';
+function isContentControlSemanticNamespace(namespace) {
+    return namespace === CONTENT_CONTROL_MC_NAMESPACE || CONTENT_CONTROL_RELATIONSHIP_NAMESPACES.has(namespace) || isKnownOoxmlNamespace(namespace);
+}
+function isDocxWordElement(element) {
+    return DOCX_WORDPROCESSING_NAMESPACES.has(element.namespaceURI ?? '');
+}
+function work_docx_note_comment_content_control_xml_wordDirectChildren(element, localName) {
+    return Array.from(element.children).filter((child)=>child.localName === localName && isDocxWordElement(child));
+}
+function hasOnlyPassiveContentControlAttributes(element) {
+    return Array.from(element.attributes).every((item)=>{
+        const namespace = xmlAttributeNamespace(element, item);
+        return Boolean(namespace === XMLNS_NAMESPACE || namespace === CONTENT_CONTROL_MC_NAMESPACE || namespace && !CONTENT_CONTROL_RELATIONSHIP_NAMESPACES.has(namespace) && !isKnownOoxmlNamespace(namespace));
+    });
+}
+function hasUnsupportedContentControlSemanticChild(element) {
+    return Array.from(element.children).some((child)=>!isDocxWordElement(child) && isContentControlSemanticNamespace(child.namespaceURI ?? ''));
+}
+function hasContentControlRelationshipReference(root) {
+    return [
+        root,
+        ...Array.from(root.querySelectorAll('*'))
+    ].some((element)=>Array.from(element.attributes).some((item)=>CONTENT_CONTROL_RELATIONSHIP_NAMESPACES.has(xmlAttributeNamespace(element, item) ?? '')));
+}
+function createWordElement(document, context, localName) {
+    const namespace = context.namespaceURI ?? [
+        ...DOCX_WORDPROCESSING_NAMESPACES
+    ][0];
+    const prefix = xmlNamespacePrefix(context, namespace) ?? 'w';
+    return document.createElementNS(namespace, `${prefix}:${localName}`);
+}
+function createNamespacedElement(document, context, namespace, preferredPrefix, localName) {
+    const prefix = availableNamespacePrefix(context.ownerDocument.documentElement, namespace, preferredPrefix);
+    return document.createElementNS(namespace, `${prefix}:${localName}`);
+}
+function setWordContentControlAttribute(element, context, localName, value) {
+    const namespace = context.namespaceURI ?? [
+        ...DOCX_WORDPROCESSING_NAMESPACES
+    ][0];
+    const prefix = xmlNamespacePrefix(context, namespace) ?? 'w';
+    element.setAttributeNS(namespace, `${prefix}:${localName}`, value);
+}
+function setNamespacedContentControlAttribute(element, context, namespace, preferredPrefix, localName, value) {
+    const prefix = availableNamespacePrefix(context.ownerDocument.documentElement, namespace, preferredPrefix);
+    element.setAttributeNS(namespace, `${prefix}:${localName}`, value);
+}
+function ensureIgnorableContentControlNamespace(root, namespace, preferredPrefix) {
+    const prefix = availableNamespacePrefix(root, namespace, preferredPrefix);
+    if (!xmlNamespacePrefix(root, namespace)) root.setAttributeNS(XMLNS_NAMESPACE, `xmlns:${prefix}`, namespace);
+    const mcPrefix = availableNamespacePrefix(root, CONTENT_CONTROL_MC_NAMESPACE, 'mc');
+    if (!xmlNamespacePrefix(root, CONTENT_CONTROL_MC_NAMESPACE)) root.setAttributeNS(XMLNS_NAMESPACE, `xmlns:${mcPrefix}`, CONTENT_CONTROL_MC_NAMESPACE);
+    const existing = Array.from(root.attributes).find((item)=>'Ignorable' === xmlAttributeLocalName(item) && xmlAttributeNamespace(root, item) === CONTENT_CONTROL_MC_NAMESPACE);
+    const prefixes = new Set((existing?.value ?? '').trim().split(/\s+/u).filter(Boolean));
+    prefixes.add(prefix);
+    const value = Array.from(prefixes).join(' ');
+    if (existing) existing.value = value;
+    else root.setAttributeNS(CONTENT_CONTROL_MC_NAMESPACE, `${mcPrefix}:Ignorable`, value);
+}
+function availableNamespacePrefix(root, namespace, preferred) {
+    const existing = xmlNamespacePrefix(root, namespace);
+    if (existing) return existing;
+    let prefix = preferred;
+    let index = 1;
+    while(xmlNamespaceUri(root, prefix)){
+        prefix = `${preferred}${index}`;
+        index += 1;
+    }
+    return prefix;
+}
 const DOCX_ROTATION_UNITS_PER_DEGREE = 60000;
 const DOCX_QUADRANT_ROTATION_UNITS = 5400000;
 function readDocxImageTransform(drawing) {
@@ -1718,7 +2224,7 @@ function inspectDocxProofingLanguages(properties) {
         status: 'absent',
         spoofedCount: 0
     };
-    const native = matches.filter((element)=>isWordElement(element));
+    const native = matches.filter((element)=>work_docx_proofing_isWordElement(element));
     const spoofedCount = matches.length - native.length;
     if (1 !== matches.length || 1 !== native.length) return {
         status: 'invalid',
@@ -1764,7 +2270,7 @@ function inspectDocxNoProof(properties) {
         status: 'absent',
         spoofedCount: 0
     };
-    const native = matches.filter((element)=>isWordElement(element));
+    const native = matches.filter((element)=>work_docx_proofing_isWordElement(element));
     const spoofedCount = matches.length - native.length;
     if (1 !== matches.length || 1 !== native.length) return {
         status: 'invalid',
@@ -1835,7 +2341,7 @@ function documentProofingLanguageDocxOptions(source) {
         } : {}
     };
 }
-function isWordElement(element) {
+function work_docx_proofing_isWordElement(element) {
     return DOCX_WORDPROCESSING_NAMESPACES.has(element.namespaceURI ?? '');
 }
 function work_docx_proofing_isNamespaceDeclaration(attribute) {
@@ -2180,4 +2686,4 @@ function isParagraphPartRoot(root, path) {
     const expected = /^word\/header\d*\.xml$/i.test(path) ? 'hdr' : /^word\/footer\d*\.xml$/i.test(path) ? 'ftr' : /^word\/footnotes\.xml$/i.test(path) ? 'footnotes' : /^word\/endnotes\.xml$/i.test(path) ? 'endnotes' : 'document';
     return root.localName === expected && DOCX_WORDPROCESSING_NAMESPACES.has(root.namespaceURI ?? '');
 }
-export { DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES, DOCX_WORDPROCESSING_NAMESPACES, DOCX_WORD_2010_NAMESPACE, DocxImageTransformPatchCollector, DocxParagraphDefaultCollapsedPatchCollector, STRICT_WORDPROCESSING_NAMESPACE, XMLNS_NAMESPACE, XML_NAMESPACE, assertXmlRoot, cloneXmlElement, createDocxThemeResolver, cssColorToHex, cssFontFamily, cssFontSize, dataBoolean, documentIndexEntryInstruction, documentIndexInstruction, documentProofingLanguageDocxOptions, docxCharacterPositionHalfPointsFromProperties, docxCharacterPositionValue, docxCharacterScalePercentFromProperties, docxCharacterScaleValue, docxCharacterSpacingTwipsFromProperties, docxCharacterSpacingValue, docxEmphasisMarkRunOptions, docxKerningThresholdValue, docxThemeColor, docxThemeFont, domDirection, hasNonWhitespaceXmlText, inspectDocxEmphasisMark, inspectDocxKerningThresholdHalfPoints, inspectDocxNoProof, inspectDocxProofingLanguages, mergeDocxIgnorableExtensions, mergeDocxIgnorableExtensionsAtPairs, paragraphAlignment, paragraphBidirectional, paragraphDirectionOptions, paragraphIndent, paragraphPaginationOptions, paragraphSpacingOptions, paragraphTabStops, parseBoundedDocxInteger, parseDocumentIndexEntryInstruction, parseDocumentIndexInstruction, parseDocxColorSchemeMappingElement, parseDocxParagraphDefaultCollapsed, parseDocxTwipsMeasure, patchDocxBibliography, patchDocxExplicitZeroCharacterSpacing, patchDocxExplicitZeroKerningThresholds, patchDocxImageTransforms, patchDocxParagraphDefaultCollapsed, readDocxBibliography, readDocxImageTransform, resolveDocxEmphasisMark, resolveDocxKerningThresholdHalfPoints, resolveDocxOpenTypeFeatures, resolveDocxProofing, resolveDocxThemeResolver, xmlAttributeLocalName, xmlAttributeNamespace, xmlDeclaredPrefix, xmlNamespaceUri };
+export { CONTENT_CONTROL_MC_NAMESPACE, CONTENT_CONTROL_RELATIONSHIP_NAMESPACES, CONTENT_CONTROL_WORD_2012_NAMESPACE, DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES, DOCX_WORDPROCESSING_NAMESPACES, DOCX_WORD_2010_NAMESPACE, DocxImageTransformPatchCollector, DocxParagraphDefaultCollapsedPatchCollector, STRICT_WORDPROCESSING_NAMESPACE, XMLNS_NAMESPACE, XML_NAMESPACE, alignCommentRunBoundaries, assertXmlRoot, cloneXmlElement, createDocxThemeResolver, createNamespacedElement, createWordElement, cssColorToHex, cssFontFamily, cssFontSize, dataBoolean, documentIndexEntryInstruction, documentIndexInstruction, documentProofingLanguageDocxOptions, docxCharacterPositionHalfPointsFromProperties, docxCharacterPositionValue, docxCharacterScalePercentFromProperties, docxCharacterScaleValue, docxCharacterSpacingTwipsFromProperties, docxCharacterSpacingValue, docxEmphasisMarkRunOptions, docxKerningThresholdValue, docxThemeColor, docxThemeFont, domDirection, ensureDocxExternalHyperlinkRelationships, ensureIgnorableContentControlNamespace, flushDocxHyperlinkRelationships, groupNoteCommentHyperlinks, groupNoteCommentParagraphs, hasContentControlRelationshipReference, hasNonWhitespaceXmlText, hasOnlyPassiveContentControlAttributes, hasUnsupportedContentControlSemanticChild, inspectDocxEmphasisMark, inspectDocxKerningThresholdHalfPoints, inspectDocxNoProof, inspectDocxProofingLanguages, isContentControlSemanticNamespace, isDocxWordElement, isKnownOoxmlNamespace, loadDocxHyperlinkRelationshipState, mergeDocxIgnorableExtensions, mergeDocxIgnorableExtensionsAtPairs, noteCommentContentParagraphs, noteCommentHyperlinkSpanKey, noteCommentHyperlinksOverlap, noteCommentParagraphContent, paragraphAlignment, paragraphBidirectional, paragraphDirectionOptions, paragraphIndent, paragraphPaginationOptions, paragraphSpacingOptions, paragraphTabStops, parseBoundedDocxInteger, parseDocumentIndexEntryInstruction, parseDocumentIndexInstruction, parseDocxColorSchemeMappingElement, parseDocxParagraphDefaultCollapsed, parseDocxTwipsMeasure, patchDocxBibliography, patchDocxExplicitZeroCharacterSpacing, patchDocxExplicitZeroKerningThresholds, patchDocxImageTransforms, patchDocxParagraphDefaultCollapsed, readDocxBibliography, readDocxImageTransform, resolveDocxEmphasisMark, resolveDocxKerningThresholdHalfPoints, resolveDocxOpenTypeFeatures, resolveDocxProofing, resolveDocxThemeResolver, restoreElementChildren, setDocxHyperlinkDestination, setNamespacedContentControlAttribute, setWordContentControlAttribute, work_docx_note_comment_content_control_xml_wordDirectChildren, xmlAttributeLocalName, xmlAttributeNamespace, xmlDeclaredPrefix, xmlNamespaceUri };