@beyondwork/docx-react-component 1.0.120 → 1.0.121

package/dist/{chunk-KCHEAX4Z.js → chunk-EMDH4IQN.js}

@@ -8,7 +8,7 @@ import {
   getRevisionActionability,
   normalizeParsedTextDocument,
   normalizeParsedTextDocumentAsync
-} from "./chunk-327AIUXL.js";
+} from "./chunk-UWDWGQH5.js";
 import {
   OLE_RELATIONSHIP_TYPES,
   buildFieldRegistry,
@@ -59,7 +59,7 @@ import {
   resolveHighlightColor,
   setActiveParseTelemetryBus,
   toCanonicalNumberingInstanceId
-} from "./chunk-NQZUGMLW.js";
+} from "./chunk-TMU7JMXX.js";
 import {
   createPersistedSourcePackage,
   decodeBytesBase64,
@@ -117,7 +117,7 @@ import {
   createCanonicalDocumentId,
   createCanonicalDocumentSignature,
   validatePersistedEditorSnapshot
-} from "./chunk-4JNUMMM7.js";
+} from "./chunk-PGGPPZ65.js";
 import {
   createDetachedAnchor
 } from "./chunk-M2HUK3KF.js";
@@ -7577,16 +7577,14 @@ function parseHdrFtrXml(xml, rootLocalName, opts = { relationships: [] }) {
     return { blocks: [] };
   }
   const blocks = [];
-  for (const child of hdrFtrElement.children) {
-    if (child.type !== "element") {
-      continue;
-    }
+  const rootXmlPath = `/${rootLocalName}[1]`;
+  for (const [child, childXmlPath] of elementChildrenWithXmlPath(hdrFtrElement, rootXmlPath)) {
     const name = localName(child.name);
     if (name === "p") {
       blocks.push(parseParagraphElement(child, xml, opts));
     } else if (name === "tbl") {
       if (isSimpleSecondaryStoryTable(child)) {
-        blocks.push(parseSimpleTableElement(child, xml, opts));
+        blocks.push(parseSimpleTableElement(child, xml, opts, childXmlPath));
       } else {
         blocks.push({
           type: "opaque_block",
@@ -7635,7 +7633,7 @@ function parseParagraphElement(pElement, sourceXml, opts) {
     } else if (name === "hyperlink") {
       children.push(parseHyperlinkElement(child, opts));
     } else if (name === "bookmarkStart" || name === "bookmarkEnd") {
-      children.push(parseBookmarkElement(child));
+      children.push(parseBookmarkElement(child, opts.sourcePartPath ?? "/word/document.xml"));
     } else if (name === "fldSimple") {
       if (activeComplexField && activeComplexField.instruction.trim().length > 0) {
         children.push(
@@ -7661,7 +7659,7 @@ function parseParagraphElement(pElement, sourceXml, opts) {
           } else if (gname === "hyperlink") {
             children.push(parseHyperlinkElement(grandchild, opts));
           } else if (gname === "bookmarkStart" || gname === "bookmarkEnd") {
-            children.push(parseBookmarkElement(grandchild));
+            children.push(parseBookmarkElement(grandchild, opts.sourcePartPath ?? "/word/document.xml"));
           } else if (gname === "fldSimple") {
             pushFieldNode(children, grandchild, "simple", opts.sourcePartPath);
           }
@@ -7790,12 +7788,12 @@ function parseRunElement(rElement, opts) {
         nodes.push(ref);
       }
     } else if (name === "bookmarkStart" || name === "bookmarkEnd") {
-      nodes.push(parseBookmarkElement(child));
+      nodes.push(parseBookmarkElement(child, opts.sourcePartPath ?? "/word/document.xml"));
     } else if (name === "instrText") {
       pushFieldNode(nodes, child, "complex", opts.sourcePartPath);
     } else if (name === "drawing") {
       const drawingXml = currentSourceXml.slice(child.start, child.end);
-      const drawingResult = parseDrawingInlineNode(drawingXml, opts);
+      const drawingResult = parseDrawingInlineNode(drawingXml, opts, void 0, child);
       if (drawingResult) {
         nodes.push(drawingResult);
       }
@@ -7877,11 +7875,11 @@ function parseRunChildNode(child, marks, opts) {
     return null;
   }
   if (name === "bookmarkStart" || name === "bookmarkEnd") {
-    return parseBookmarkElement(child);
+    return parseBookmarkElement(child, opts.sourcePartPath ?? "/word/document.xml");
   }
   if (name === "drawing") {
     const drawingXml = currentSourceXml.slice(child.start, child.end);
-    return parseDrawingInlineNode(drawingXml, opts);
+    return parseDrawingInlineNode(drawingXml, opts, void 0, child);
   }
   if (name === "pict") {
     const pictXml = currentSourceXml.slice(child.start, child.end);
@@ -7927,7 +7925,7 @@ function parseHyperlinkElement(element, opts) {
     children
   };
 }
-function parseDrawingInlineNode(rawXml, opts, legacyDrawingXml) {
+function parseDrawingInlineNode(rawXml, opts, legacyDrawingXml, sourceElement) {
   try {
     const frame = parseDrawingFrame(rawXml, {
       ...opts,
@@ -7942,7 +7940,14 @@ function parseDrawingInlineNode(rawXml, opts, legacyDrawingXml) {
       blockParser: (xml) => parseTxbxBlocksForHeaderFooter(xml, opts, 1)
     });
     if (frame && !(frame.content.type === "shape" && frame.content.isTextBox)) {
-      return frame;
+      return sourceElement ? {
+        ...frame,
+        sourceRef: createElementSourceRef(
+          opts.sourcePartPath ?? "/word/document.xml",
+          "drawing",
+          sourceElement
+        )
+      } : frame;
     }
     if (frame?.content.type !== "shape" || !frame.content.isTextBox) {
       return frame;
@@ -7981,14 +7986,13 @@ function parseTxbxBlocksForHeaderFooter(innerXml, opts, depth) {
   currentSourceXml = innerXml;
   try {
     const blocks = [];
-    for (const child of txbxContent.children) {
-      if (child.type !== "element") continue;
+    for (const [child, childXmlPath] of elementChildrenWithXmlPath(txbxContent, "/txbxContent[1]")) {
       const name = localName(child.name);
       if (name === "p") {
         blocks.push(parseParagraphElement(child, innerXml, opts));
       } else if (name === "tbl") {
         if (isSimpleSecondaryStoryTable(child)) {
-          blocks.push(parseSimpleTableElement(child, innerXml, opts));
+          blocks.push(parseSimpleTableElement(child, innerXml, opts, childXmlPath));
         } else {
           blocks.push({
             type: "opaque_block",
@@ -8004,18 +8008,21 @@ function parseTxbxBlocksForHeaderFooter(innerXml, opts, depth) {
     currentSourceXml = previousSourceXml;
   }
 }
-function parseBookmarkElement(element) {
+function parseBookmarkElement(element, partPath) {
   const bookmarkId = readStringAttr(element, "w:id") ?? "0";
+  const sourceRef = createElementSourceRef(partPath, localName(element.name), element);
   if (localName(element.name) === "bookmarkStart") {
     return {
       type: "bookmark_start",
       bookmarkId,
-      name: readStringAttr(element, "w:name") ?? ""
+      name: readStringAttr(element, "w:name") ?? "",
+      sourceRef
     };
   }
   return {
     type: "bookmark_end",
-    bookmarkId
+    bookmarkId,
+    sourceRef
   };
 }
 function pushFieldNode(nodes, element, fieldType, sourcePartPath = "/word/document.xml") {
@@ -8058,6 +8065,40 @@ function createFieldSequenceSourceRef(partPath, node) {
     endOffset: node.end
   };
 }
+function createElementSourceRef(partPath, element, node) {
+  return {
+    sourceId: `part:${partPath}#${element}:${node.start}`,
+    partPath,
+    storyKind: /\/footer\d+\.xml$/i.test(partPath) ? "footer" : "header",
+    element,
+    startOffset: node.start,
+    endOffset: node.end
+  };
+}
+function createStableTableSourceRef(partPath, element, xmlPath, extras = {}) {
+  return {
+    sourceId: `part:${partPath}#${xmlPath}`,
+    partPath,
+    storyKind: /\/footer\d+\.xml$/i.test(partPath) ? "footer" : "header",
+    element,
+    xmlPath,
+    ...extras
+  };
+}
+function elementChildrenWithXmlPath(parent, parentXmlPath) {
+  const ordinals = /* @__PURE__ */ new Map();
+  const children = [];
+  for (const child of parent.children) {
+    if (child.type !== "element") {
+      continue;
+    }
+    const name = localName(child.name);
+    const ordinal = (ordinals.get(name) ?? 0) + 1;
+    ordinals.set(name, ordinal);
+    children.push([child, `${parentXmlPath}/${name}[${ordinal}]`]);
+  }
+  return children;
+}
 function readFieldInstruction(element) {
   const instruction = readStringAttr(element, "w:instr") ?? extractTextContent(element);
   return instruction.trim().length > 0 ? instruction : void 0;
@@ -8284,7 +8325,7 @@ function containsRiskyElement(element) {
   }
   return false;
 }
-function parseSimpleTableElement(tblElement, sourceXml, opts) {
+function parseSimpleTableElement(tblElement, sourceXml, opts, sourceXmlPath) {
   let gridColumns = [];
   const rows = [];
   let propertiesXml;
@@ -8322,11 +8363,12 @@ function parseSimpleTableElement(tblElement, sourceXml, opts) {
     } else if (name === "tblGrid") {
       gridColumns = readGridColumns2(child);
     } else if (name === "tr") {
-      rows.push(parseSimpleTableRow(child, sourceXml, opts));
+      rows.push(parseSimpleTableRow(child, sourceXml, opts, `${sourceXmlPath}/tr[${rows.length + 1}]`));
     }
   }
   return {
     type: "table",
+    sourceRef: createStableTableSourceRef(opts.sourcePartPath ?? "/word/document.xml", "tbl", sourceXmlPath),
     ...styleId ? { styleId } : {},
     ...propertiesXml ? { propertiesXml } : {},
     gridColumns,
@@ -8348,7 +8390,7 @@ function parseSimpleTableElement(tblElement, sourceXml, opts) {
 function readGridColumns2(tblGrid) {
   return readGridColumns(tblGrid);
 }
-function parseSimpleTableRow(trElement, sourceXml, opts) {
+function parseSimpleTableRow(trElement, sourceXml, opts, sourceXmlPath) {
   const cells = [];
   let propertiesXml;
   let height;
@@ -8369,11 +8411,12 @@ function parseSimpleTableRow(trElement, sourceXml, opts) {
       horizontalAlignment = readRowHorizontalAlignment(child);
       cnfStyle = readRowCnfStyle(child);
     } else if (name === "tc") {
-      cells.push(parseSimpleTableCell(child, sourceXml, opts));
+      cells.push(parseSimpleTableCell(child, sourceXml, opts, `${sourceXmlPath}/tc[${cells.length + 1}]`));
     }
   }
   return {
     type: "table_row",
+    sourceRef: createStableTableSourceRef(opts.sourcePartPath ?? "/word/document.xml", "tr", sourceXmlPath),
     ...propertiesXml ? { propertiesXml } : {},
     ...height !== void 0 ? { height } : {},
     ...heightRule ? { heightRule } : {},
@@ -8384,7 +8427,7 @@ function parseSimpleTableRow(trElement, sourceXml, opts) {
     cells
   };
 }
-function parseSimpleTableCell(tcElement, sourceXml, opts) {
+function parseSimpleTableCell(tcElement, sourceXml, opts, sourceXmlPath) {
   const children = [];
   let propertiesXml;
   let gridSpan;
@@ -8426,6 +8469,9 @@ function parseSimpleTableCell(tcElement, sourceXml, opts) {
   }
   return {
     type: "table_cell",
+    sourceRef: createStableTableSourceRef(opts.sourcePartPath ?? "/word/document.xml", "tc", sourceXmlPath, {
+      tableCellPath: sourceXmlPath
+    }),
     ...propertiesXml ? { propertiesXml } : {},
     ...gridSpan ? { gridSpan } : {},
     ...verticalMerge ? { verticalMerge } : {},
@@ -8471,28 +8517,22 @@ function parseFootnotesXml(xml) {
   const footnotes = {};
   const endnotes = {};
   if (footnotesElement) {
-    for (const child of footnotesElement.children) {
-      if (child.type !== "element") {
-        continue;
-      }
+    for (const [child, childXmlPath] of elementChildrenWithXmlPath2(footnotesElement, "/footnotes[1]")) {
       if (localName(child.name) !== "footnote") {
         continue;
       }
-      const definition = parseNoteElement(child, "footnote");
+      const definition = parseNoteElement(child, "footnote", childXmlPath);
       if (definition) {
         footnotes[definition.noteId] = definition;
       }
     }
   }
   if (endnotesElement) {
-    for (const child of endnotesElement.children) {
-      if (child.type !== "element") {
-        continue;
-      }
+    for (const [child, childXmlPath] of elementChildrenWithXmlPath2(endnotesElement, "/endnotes[1]")) {
       if (localName(child.name) !== "endnote") {
         continue;
       }
-      const definition = parseNoteElement(child, "endnote");
+      const definition = parseNoteElement(child, "endnote", childXmlPath);
       if (definition) {
         endnotes[definition.noteId] = definition;
       }
@@ -8512,14 +8552,11 @@ function parseEndnotesXml(xml, existing) {
     ...existing?.endnotes ?? {}
   };
   if (endnotesElement) {
-    for (const child of endnotesElement.children) {
-      if (child.type !== "element") {
-        continue;
-      }
+    for (const [child, childXmlPath] of elementChildrenWithXmlPath2(endnotesElement, "/endnotes[1]")) {
       if (localName(child.name) !== "endnote") {
         continue;
       }
-      const definition = parseNoteElement(child, "endnote");
+      const definition = parseNoteElement(child, "endnote", childXmlPath);
       if (definition) {
         endnotes[definition.noteId] = definition;
       }
@@ -8568,7 +8605,7 @@ function parseFootnoteSeparators(xml) {
     ...continuationSeparatorParagraphXml !== void 0 ? { continuationSeparatorParagraphXml } : {}
   };
 }
-function parseNoteElement(element, kind) {
+function parseNoteElement(element, kind, sourceXmlPath) {
   const rawId = readStringAttr(element, "w:id") ?? "";
   const rawType = readStringAttr(element, "w:type") ?? "";
   if (!rawId || SPECIAL_NOTE_IDS.has(rawId) || SPECIAL_NOTE_TYPES.has(rawType)) {
@@ -8576,16 +8613,13 @@ function parseNoteElement(element, kind) {
   }
   const noteId = rawId;
   const blocks = [];
-  for (const child of element.children) {
-    if (child.type !== "element") {
-      continue;
-    }
+  for (const [child, childXmlPath] of elementChildrenWithXmlPath2(element, sourceXmlPath)) {
     const name = localName(child.name);
     if (name === "p") {
-      blocks.push(parseParagraphElement2(child));
+      blocks.push(parseParagraphElement2(child, kind));
     } else if (name === "tbl") {
       if (isSimpleSecondaryStoryTable2(child)) {
-        blocks.push(parseSimpleTableElement2(child));
+        blocks.push(parseSimpleTableElement2(child, kind, childXmlPath));
       } else {
         blocks.push({
           type: "opaque_block",
@@ -8605,7 +8639,7 @@ function parseNoteElement(element, kind) {
   }
   return { noteId, kind, blocks };
 }
-function parseParagraphElement2(pElement) {
+function parseParagraphElement2(pElement, noteKind) {
   let styleId;
   let alignment;
   let spacing;
@@ -8628,15 +8662,15 @@ function parseParagraphElement2(pElement) {
       spacing = readParagraphSpacing2(child);
       indentation = readParagraphIndentation2(child);
     } else if (name === "r") {
-      activeComplexField = appendRunNodes2(child, children, activeComplexField);
+      activeComplexField = appendRunNodes2(child, children, activeComplexField, noteKind);
     } else if (name === "hyperlink") {
       if (activeComplexField && activeComplexField.instruction.trim().length > 0) {
         children.push(createFieldNode2(activeComplexField.instruction, "complex", activeComplexField.children));
         activeComplexField = null;
       }
-      children.push(parseHyperlinkElement2(child));
+      children.push(parseHyperlinkElement2(child, noteKind));
     } else if (name === "bookmarkStart" || name === "bookmarkEnd") {
-      const bookmarkNode = parseBookmarkElement2(child);
+      const bookmarkNode = parseBookmarkElement2(child, noteKind);
       if (activeComplexField?.mode === "result") {
         activeComplexField.children.push(bookmarkNode);
       } else {
@@ -8666,7 +8700,7 @@ function parseParagraphElement2(pElement) {
     children
   };
 }
-function appendRunNodes2(rElement, nodes, activeComplexField) {
+function appendRunNodes2(rElement, nodes, activeComplexField, noteKind) {
   const marks = parseRunProperties2(rElement);
   for (const child of rElement.children) {
     if (child.type !== "element") {
@@ -8695,7 +8729,7 @@ function appendRunNodes2(rElement, nodes, activeComplexField) {
       }
       continue;
     }
-    const inlineNode = parseRunChildNode2(child, marks);
+    const inlineNode = parseRunChildNode2(child, marks, noteKind);
     if (!inlineNode) {
       continue;
     }
@@ -8707,7 +8741,7 @@ function appendRunNodes2(rElement, nodes, activeComplexField) {
   }
   return activeComplexField;
 }
-function parseRunElement2(rElement) {
+function parseRunElement2(rElement, noteKind) {
   const nodes = [];
   const marks = parseRunProperties2(rElement);
   for (const child of rElement.children) {
@@ -8740,14 +8774,14 @@ function parseRunElement2(rElement) {
         nodes.push({ type: "footnote_ref", noteId, noteKind: "endnote" });
       }
     } else if (name === "bookmarkStart" || name === "bookmarkEnd") {
-      nodes.push(parseBookmarkElement2(child));
+      nodes.push(parseBookmarkElement2(child, noteKind));
     } else if (name === "instrText") {
       pushFieldNode2(nodes, child, "complex");
     }
   }
   return nodes;
 }
-function parseRunChildNode2(child, marks) {
+function parseRunChildNode2(child, marks, noteKind) {
   const name = localName(child.name);
   if (name === "t") {
     const text = extractTextContent2(child);
@@ -8781,16 +8815,16 @@ function parseRunChildNode2(child, marks) {
     return null;
   }
   if (name === "bookmarkStart" || name === "bookmarkEnd") {
-    return parseBookmarkElement2(child);
+    return parseBookmarkElement2(child, noteKind);
   }
   return null;
 }
-function parseHyperlinkElement2(element) {
+function parseHyperlinkElement2(element, noteKind) {
   const href = element.attributes["w:anchor"] ? `#${element.attributes["w:anchor"]}` : element.attributes["r:id"] ?? "relationship:unknown";
   const children = [];
   for (const child of element.children) {
     if (child.type === "element" && localName(child.name) === "r") {
-      for (const runChild of parseRunElement2(child)) {
+      for (const runChild of parseRunElement2(child, noteKind)) {
         if (runChild.type === "text" || runChild.type === "hard_break" || runChild.type === "tab") {
           children.push(runChild);
         }
@@ -8803,18 +8837,21 @@ function parseHyperlinkElement2(element) {
     children
   };
 }
-function parseBookmarkElement2(element) {
+function parseBookmarkElement2(element, noteKind) {
   const bookmarkId = readStringAttr(element, "w:id") ?? "0";
+  const sourceRef = createElementSourceRef2(noteKind, localName(element.name), element);
   if (localName(element.name) === "bookmarkStart") {
     return {
       type: "bookmark_start",
       bookmarkId,
-      name: readStringAttr(element, "w:name") ?? ""
+      name: readStringAttr(element, "w:name") ?? "",
+      sourceRef
     };
   }
   return {
     type: "bookmark_end",
-    bookmarkId
+    bookmarkId,
+    sourceRef
   };
 }
 function pushFieldNode2(nodes, element, fieldType) {
@@ -8986,7 +9023,7 @@ function containsRiskyElement2(element) {
   }
   return false;
 }
-function parseSimpleTableElement2(tblElement) {
+function parseSimpleTableElement2(tblElement, noteKind = "footnote", sourceXmlPath = `/${noteKind === "endnote" ? "endnotes" : "footnotes"}[1]/tbl[1]`) {
   let gridColumns = [];
   const rows = [];
   let propertiesXml;
@@ -9024,11 +9061,12 @@ function parseSimpleTableElement2(tblElement) {
     } else if (name === "tblGrid") {
       gridColumns = readGridColumns3(child);
     } else if (name === "tr") {
-      rows.push(parseSimpleTableRow2(child));
+      rows.push(parseSimpleTableRow2(child, noteKind, `${sourceXmlPath}/tr[${rows.length + 1}]`));
     }
   }
   return {
     type: "table",
+    sourceRef: createStableTableSourceRef2(noteKind, "tbl", sourceXmlPath),
     ...styleId ? { styleId } : {},
     ...propertiesXml ? { propertiesXml } : {},
     gridColumns,
@@ -9050,7 +9088,7 @@ function parseSimpleTableElement2(tblElement) {
 function readGridColumns3(tblGrid) {
   return readGridColumns(tblGrid);
 }
-function parseSimpleTableRow2(trElement) {
+function parseSimpleTableRow2(trElement, noteKind, sourceXmlPath) {
   const cells = [];
   let propertiesXml;
   let height;
@@ -9071,11 +9109,12 @@ function parseSimpleTableRow2(trElement) {
       horizontalAlignment = readRowHorizontalAlignment(child);
       cnfStyle = readRowCnfStyle(child);
     } else if (name === "tc") {
-      cells.push(parseSimpleTableCell2(child));
+      cells.push(parseSimpleTableCell2(child, noteKind, `${sourceXmlPath}/tc[${cells.length + 1}]`));
     }
   }
   return {
     type: "table_row",
+    sourceRef: createStableTableSourceRef2(noteKind, "tr", sourceXmlPath),
     ...propertiesXml ? { propertiesXml } : {},
     ...height !== void 0 ? { height } : {},
     ...heightRule ? { heightRule } : {},
@@ -9086,7 +9125,7 @@ function parseSimpleTableRow2(trElement) {
     cells
   };
 }
-function parseSimpleTableCell2(tcElement) {
+function parseSimpleTableCell2(tcElement, noteKind, sourceXmlPath) {
   const children = [];
   let propertiesXml;
   let gridSpan;
@@ -9123,11 +9162,14 @@ function parseSimpleTableCell2(tcElement) {
       margins = readCellMargins(child);
       cnfStyle = readCellCnfStyle(child);
     } else if (name === "p") {
-      children.push(parseParagraphElement2(child));
+      children.push(parseParagraphElement2(child, noteKind));
     }
   }
   return {
     type: "table_cell",
+    sourceRef: createStableTableSourceRef2(noteKind, "tc", sourceXmlPath, {
+      tableCellPath: sourceXmlPath
+    }),
     ...propertiesXml ? { propertiesXml } : {},
     ...gridSpan ? { gridSpan } : {},
     ...verticalMerge ? { verticalMerge } : {},
@@ -9143,6 +9185,42 @@ function parseSimpleTableCell2(tcElement) {
     children: children.length > 0 ? children : [{ type: "paragraph", children: [] }]
   };
 }
+function createStableTableSourceRef2(noteKind, element, xmlPath, extras = {}) {
+  const partPath = noteKind === "endnote" ? "/word/endnotes.xml" : "/word/footnotes.xml";
+  return {
+    sourceId: `part:${partPath}#${xmlPath}`,
+    partPath,
+    storyKind: noteKind,
+    element,
+    xmlPath,
+    ...extras
+  };
+}
+function createElementSourceRef2(noteKind, element, node) {
+  const partPath = noteKind === "endnote" ? "/word/endnotes.xml" : "/word/footnotes.xml";
+  return {
+    sourceId: `part:${partPath}#${element}:${node.start}`,
+    partPath,
+    storyKind: noteKind,
+    element,
+    startOffset: node.start,
+    endOffset: node.end
+  };
+}
+function elementChildrenWithXmlPath2(parent, parentXmlPath) {
+  const ordinals = /* @__PURE__ */ new Map();
+  const children = [];
+  for (const child of parent.children) {
+    if (child.type !== "element") {
+      continue;
+    }
+    const name = localName(child.name);
+    const ordinal = (ordinals.get(name) ?? 0) + 1;
+    ordinals.set(name, ordinal);
+    children.push([child, `${parentXmlPath}/${name}[${ordinal}]`]);
+  }
+  return children;
+}
 function serializeElementToXml2(element) {
   const attrs = Object.entries(element.attributes).map(([key, value]) => ` ${key}="${escapeXmlAttribute4(value)}"`).join("");
   const children = element.children.map((child) => {