@beyondwork/docx-react-component 1.0.120 → 1.0.121

package/dist/io/docx-session.cjs

@@ -8954,6 +8954,9 @@ function validateDocumentNode(value, path, issues, context = "root") {
       }
       return;
     case "table_row":
+      if (record.sourceRef !== void 0) {
+        validateCanonicalSourceRef(record.sourceRef, `${path}.sourceRef`, issues);
+      }
       if (!Array.isArray(record.cells)) {
         issues.push({ path: `${path}.cells`, message: "cells must be an array." });
       } else {
@@ -8963,6 +8966,9 @@ function validateDocumentNode(value, path, issues, context = "root") {
       }
       return;
     case "table_cell":
+      if (record.sourceRef !== void 0) {
+        validateCanonicalSourceRef(record.sourceRef, `${path}.sourceRef`, issues);
+      }
       if (!Array.isArray(record.children)) {
         issues.push({ path: `${path}.children`, message: "children must be an array." });
       } else {
@@ -8993,9 +8999,15 @@ function validateDocumentNode(value, path, issues, context = "root") {
     case "bookmark_start":
       expectString(record.bookmarkId, `${path}.bookmarkId`, issues);
       expectString(record.name, `${path}.name`, issues);
+      if (record.sourceRef !== void 0) {
+        validateCanonicalSourceRef(record.sourceRef, `${path}.sourceRef`, issues);
+      }
       return;
     case "bookmark_end":
       expectString(record.bookmarkId, `${path}.bookmarkId`, issues);
+      if (record.sourceRef !== void 0) {
+        validateCanonicalSourceRef(record.sourceRef, `${path}.sourceRef`, issues);
+      }
       return;
     case "scope_marker_start":
     case "scope_marker_end":
@@ -9096,6 +9108,9 @@ function validateDocumentNode(value, path, issues, context = "root") {
       return;
     }
     case "ole_embed":
+      if (record.sourceRef !== void 0) {
+        validateCanonicalSourceRef(record.sourceRef, `${path}.sourceRef`, issues);
+      }
       expectString(record.id, `${path}.id`, issues);
       expectString(record.relationshipId, `${path}.relationshipId`, issues);
       expectString(record.rawXml, `${path}.rawXml`, issues);
@@ -9224,12 +9239,12 @@ function validateCanonicalSourceRef(value, path, issues) {
     return;
   }
   expectString(record.sourceId, `${path}.sourceId`, issues);
-  for (const key of ["partPath", "storyKind", "element"]) {
+  for (const key of ["partPath", "storyKind", "element", "xmlPath", "tableCellPath"]) {
     if (record[key] !== void 0) {
       expectString(record[key], `${path}.${key}`, issues);
     }
   }
-  for (const key of ["ordinal", "startOffset", "endOffset"]) {
+  for (const key of ["ordinal", "startOffset", "endOffset", "tableDepth"]) {
     if (record[key] !== void 0 && (!Number.isInteger(record[key]) || record[key] < 0)) {
       issues.push({
         path: `${path}.${key}`,
@@ -14134,6 +14149,7 @@ function resolveContentType(path, contentTypes) {
 // src/io/ooxml/parse-bookmark-references.ts
 var HYPERLINK_ANCHOR_RE = /<(?:\w+:)?hyperlink\b[^>]*\bw:anchor\s*=\s*"([^"]*)"/gi;
 var INSTR_TEXT_RE = /<(?:\w+:)?instrText\b[^>]*>([\s\S]*?)<\/(?:\w+:)?instrText>/gi;
+var SIMPLE_FIELD_INSTR_RE = /<(?:\w+:)?fldSimple\b[^>]*\bw:instr\s*=\s*"([^"]*)"/gi;
 var TOC_FIELD_RE = /\bTOC\b/;
 var REFLIKE_FIELD_RE = /\b(?:HYPERLINK|REF|PAGEREF|NOTEREF)\s+([A-Za-z0-9_:.\-]+)/g;
 var DATA_BINDING_RE = /<(?:\w+:)?dataBinding\b/i;
@@ -14152,12 +14168,14 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
   }
   INSTR_TEXT_RE.lastIndex = 0;
   while ((m = INSTR_TEXT_RE.exec(documentXml)) !== null) {
-    const instrText = m[1] ?? "";
-    if (TOC_FIELD_RE.test(instrText)) retainAllToc = true;
-    REFLIKE_FIELD_RE.lastIndex = 0;
-    let r;
-    while ((r = REFLIKE_FIELD_RE.exec(instrText)) !== null) {
-      if (r[1]) retained.add(r[1]);
+    if (scanInstructionForRetainedBookmarks(m[1] ?? "", retained)) {
+      retainAllToc = true;
+    }
+  }
+  SIMPLE_FIELD_INSTR_RE.lastIndex = 0;
+  while ((m = SIMPLE_FIELD_INSTR_RE.exec(documentXml)) !== null) {
+    if (scanInstructionForRetainedBookmarks(m[1] ?? "", retained)) {
+      retainAllToc = true;
     }
   }
   retainRevisionBoundedBookmarks(documentXml, retained);
@@ -14167,6 +14185,15 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
     retainAll
   };
 }
+function scanInstructionForRetainedBookmarks(instruction, retained) {
+  const hasTocField = TOC_FIELD_RE.test(instruction);
+  REFLIKE_FIELD_RE.lastIndex = 0;
+  let r;
+  while ((r = REFLIKE_FIELD_RE.exec(instruction)) !== null) {
+    if (r[1]) retained.add(r[1]);
+  }
+  return hasTocField;
+}
 function retainRevisionBoundedBookmarks(documentXml, retained) {
   const starts = /* @__PURE__ */ new Map();
   BOOKMARK_START_RE.lastIndex = 0;
@@ -17669,7 +17696,7 @@ var SAFE_TABLE_FIELD_FAMILIES = /* @__PURE__ */ new Set([
   "FORMULA"
 ]);
 var RISKY_TABLE_MARKUP_RE = /<w:(ins|del|moveFrom|moveTo|rPrChange|pPrChange|tblPrChange|trPrChange|tcPrChange|sectPrChange|cellIns|cellDel|cellMerge|smartTag)\b/;
-var SIMPLE_FIELD_INSTR_RE = /\bw:instr="([^"]*)"/g;
+var SIMPLE_FIELD_INSTR_RE2 = /\bw:instr="([^"]*)"/g;
 var COMPLEX_FIELD_TOKEN_RE = /<(?:\w+:)?fldChar\b[^>]*?(?:\w+:)?fldCharType="(begin|separate|end)"[^>]*?(?:\/>|>[\s\S]*?<\/(?:\w+:)?fldChar>)|<(?:\w+:)?instrText\b[^>]*>([\s\S]*?)<\/(?:\w+:)?instrText>/gu;
 function decodeXmlEntities5(text) {
   return text.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
@@ -17710,7 +17737,7 @@ function isSafeTableFieldInstruction(instruction) {
 }
 function tableRequiresOpaquePreservation(rawXml) {
   if (RISKY_TABLE_MARKUP_RE.test(rawXml)) return true;
-  const simpleInstructions = [...rawXml.matchAll(SIMPLE_FIELD_INSTR_RE)].map(
+  const simpleInstructions = [...rawXml.matchAll(SIMPLE_FIELD_INSTR_RE2)].map(
     (match) => match[1] ?? ""
   );
   const complexInstructions = extractComplexFieldInstructionsFromRaw(rawXml);
@@ -18393,7 +18420,11 @@ function parseMainDocumentXmlInner(xml, relationships, mediaParts, sourcePartPat
   const documentElement2 = findChildElement4(root, "document");
   const bodyElement = findChildElement4(documentElement2, "body");
   const relationshipMap = new Map(relationships.map((relationship) => [relationship.id, relationship]));
-  const allBlocks = bodyElement.children.filter((node) => node.type === "element").map((node) => parseBodyChild(node, xml, relationshipMap, relationships, mediaParts, sourcePartPath)).filter((block) => !(block.type === "opaque_block" && block.rawXml === ""));
+  const allBlocks = mapElementChildrenWithXmlPath(
+    bodyElement,
+    "/document[1]/body[1]",
+    (node, xmlPath) => parseBodyChild(node, xml, relationshipMap, relationships, mediaParts, sourcePartPath, 0, xmlPath)
+  ).filter((block) => !(block.type === "opaque_block" && block.rawXml === ""));
   let finalSectionProperties;
   const blocks = [];
   for (let i = 0; i < allBlocks.length; i++) {
@@ -18483,22 +18514,25 @@ function parseBlockStreamFromXml(xml, ctx) {
   const priorDepth = activeTxbxBlockStreamDepth;
   activeTxbxBlockStreamDepth = depth;
   try {
-    return wrapper.children.filter((n) => n.type === "element").map(
-      (n) => parseBodyChild(
+    return mapElementChildrenWithXmlPath(
+      wrapper,
+      `/${localName(wrapper.name)}[1]`,
+      (n, xmlPath) => parseBodyChild(
         n,
         xml,
         relationshipMap,
         ctx.relationships,
         ctx.mediaParts,
         ctx.sourcePartPath,
-        depth
+        depth,
+        xmlPath
       )
     );
   } finally {
     activeTxbxBlockStreamDepth = priorDepth;
   }
 }
-function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath, _depth = 0) {
+function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath, _depth = 0, sourceXmlPath = `/${localName(node.name)}[1]`) {
   const nodeType = localName(node.name);
   if (nodeType === "tbl") {
     const rawTableXml = sourceXml.slice(node.start, node.end);
@@ -18509,7 +18543,15 @@ function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaPa
       };
     }
     try {
-      return parseTableElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath);
+      return parseTableElement(
+        node,
+        sourceXml,
+        relationshipMap,
+        relationships,
+        mediaParts,
+        sourcePartPath,
+        sourceXmlPath
+      );
     } catch {
       return {
         type: "opaque_block",
@@ -18518,10 +18560,26 @@ function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaPa
     }
   }
   if (nodeType === "sdt") {
-    return parseSdtElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath);
+    return parseSdtElement(
+      node,
+      sourceXml,
+      relationshipMap,
+      relationships,
+      mediaParts,
+      sourcePartPath,
+      sourceXmlPath
+    );
   }
   if (nodeType === "customXml") {
-    return parseCustomXmlElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath);
+    return parseCustomXmlElement(
+      node,
+      sourceXml,
+      relationshipMap,
+      relationships,
+      mediaParts,
+      sourcePartPath,
+      sourceXmlPath
+    );
   }
   if (nodeType === "altChunk") {
     return parseAltChunkElement(node, sourceXml);
@@ -18667,6 +18725,7 @@ function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaPa
             type: "bookmark_start",
             bookmarkId: bkId,
             name: bkName,
+            sourceRef: createElementSourceRef(sourcePartPath, "bookmarkStart", child),
             rawXml: sourceXml.slice(child.start, child.end)
           };
           flushActiveComplexField(children, () => {
@@ -18694,6 +18753,7 @@ function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaPa
           const bookmarkNode = {
             type: "bookmark_end",
             bookmarkId: bkEndId,
+            sourceRef: createElementSourceRef(sourcePartPath, "bookmarkEnd", child),
             rawXml: sourceXml.slice(child.start, child.end)
           };
           flushActiveComplexField(children, () => {
@@ -18901,7 +18961,7 @@ function flushActiveComplexField(children, reset, activeComplexField) {
   });
   reset();
 }
-function parseTableElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath) {
+function parseTableElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath, sourceXmlPath) {
   let styleId;
   let tblLook;
   let propertiesXml;
@@ -18945,13 +19005,24 @@ function parseTableElement(node, sourceXml, relationshipMap, relationships, medi
         break;
       }
       case "tr": {
-        rows.push(parseTableRowElement(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
+        rows.push(
+          parseTableRowElement(
+            child,
+            sourceXml,
+            relationshipMap,
+            relationships,
+            mediaParts,
+            sourcePartPath,
+            `${sourceXmlPath}/tr[${rows.length + 1}]`
+          )
+        );
         break;
       }
     }
   }
   return {
     type: "table",
+    sourceRef: createStableTableSourceRef(sourcePartPath, "tbl", sourceXmlPath),
     ...styleId ? { styleId } : {},
     ...tblLook ? { tblLook } : {},
     ...propertiesXml ? { propertiesXml } : {},
@@ -18972,7 +19043,7 @@ function parseTableElement(node, sourceXml, relationshipMap, relationships, medi
     rawXml: sourceXml.slice(node.start, node.end)
   };
 }
-function parseTableRowElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath) {
+function parseTableRowElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath, sourceXmlPath) {
   let propertiesXml;
   let unknownPropertyChildren;
   let gridBefore;
@@ -19004,12 +19075,23 @@ function parseTableRowElement(node, sourceXml, relationshipMap, relationships, m
         cnfStyle = readRowCnfStyle2(child);
         break;
       case "tc":
-        cells.push(parseTableCellElement(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
+        cells.push(
+          parseTableCellElement(
+            child,
+            sourceXml,
+            relationshipMap,
+            relationships,
+            mediaParts,
+            sourcePartPath,
+            `${sourceXmlPath}/tc[${cells.length + 1}]`
+          )
+        );
         break;
     }
   }
   return {
     type: "table_row",
+    sourceRef: createStableTableSourceRef(sourcePartPath, "tr", sourceXmlPath),
     ...propertiesXml ? { propertiesXml } : {},
     ...unknownPropertyChildren ? { unknownPropertyChildren } : {},
     ...gridBefore !== void 0 ? { gridBefore } : {},
@@ -19026,7 +19108,7 @@ function parseTableRowElement(node, sourceXml, relationshipMap, relationships, m
     rawXml: sourceXml.slice(node.start, node.end)
   };
 }
-function parseTableCellElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath) {
+function parseTableCellElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath, sourceXmlPath) {
   let propertiesXml;
   let unknownPropertyChildren;
   let gridSpan;
@@ -19061,13 +19143,27 @@ function parseTableCellElement(node, sourceXml, relationshipMap, relationships,
         break;
       }
       default: {
-        children.push(parseBodyChild(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
+        children.push(
+          parseBodyChild(
+            child,
+            sourceXml,
+            relationshipMap,
+            relationships,
+            mediaParts,
+            sourcePartPath,
+            0,
+            `${sourceXmlPath}/${localName(child.name)}[${countPriorElementSiblingsByName(node, child) + 1}]`
+          )
+        );
         break;
       }
     }
   }
   return {
     type: "table_cell",
+    sourceRef: createStableTableSourceRef(sourcePartPath, "tc", sourceXmlPath, {
+      tableCellPath: sourceXmlPath
+    }),
     ...propertiesXml ? { propertiesXml } : {},
     ...unknownPropertyChildren ? { unknownPropertyChildren } : {},
     ...gridSpan ? { gridSpan } : {},
@@ -19085,7 +19181,7 @@ function parseTableCellElement(node, sourceXml, relationshipMap, relationships,
     rawXml: sourceXml.slice(node.start, node.end)
   };
 }
-function parseSdtElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath) {
+function parseSdtElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath, sourceXmlPath) {
   const propertiesNode = node.children.find(
     (child) => child.type === "element" && localName(child.name) === "sdtPr"
   );
@@ -19098,7 +19194,20 @@ function parseSdtElement(node, sourceXml, relationshipMap, relationships, mediaP
       rawXml: sourceXml.slice(node.start, node.end)
     };
   }
-  const children = contentNode.children.filter((child) => child.type === "element").map((child) => parseBodyChild(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
+  const children = mapElementChildrenWithXmlPath(
+    contentNode,
+    `${sourceXmlPath}/sdtContent[1]`,
+    (child, childXmlPath) => parseBodyChild(
+      child,
+      sourceXml,
+      relationshipMap,
+      relationships,
+      mediaParts,
+      sourcePartPath,
+      0,
+      childXmlPath
+    )
+  );
   return {
     type: "sdt",
     sourceRef: createElementSourceRef(sourcePartPath, "sdt", node),
@@ -19107,7 +19216,7 @@ function parseSdtElement(node, sourceXml, relationshipMap, relationships, mediaP
     rawXml: sourceXml.slice(node.start, node.end)
   };
 }
-function parseCustomXmlElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath) {
+function parseCustomXmlElement(node, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath, sourceXmlPath) {
   const uri = readOptionalAttribute2(node, "uri");
   const element = readOptionalAttribute2(node, "element");
   if (!uri && !element) {
@@ -19116,9 +19225,20 @@ function parseCustomXmlElement(node, sourceXml, relationshipMap, relationships,
       rawXml: sourceXml.slice(node.start, node.end)
     };
   }
-  const children = node.children.filter(
-    (child) => child.type === "element" && localName(child.name) !== "customXmlPr"
-  ).map((child) => parseBodyChild(child, sourceXml, relationshipMap, relationships, mediaParts, sourcePartPath));
+  const children = mapElementChildrenWithXmlPath(
+    node,
+    sourceXmlPath,
+    (child, childXmlPath) => localName(child.name) === "customXmlPr" ? void 0 : parseBodyChild(
+      child,
+      sourceXml,
+      relationshipMap,
+      relationships,
+      mediaParts,
+      sourcePartPath,
+      0,
+      childXmlPath
+    )
+  ).filter((child) => child !== void 0);
   return {
     type: "custom_xml",
     ...uri ? { uri } : {},
@@ -19650,6 +19770,43 @@ function createElementSourceRef(partPath, element, node) {
     endOffset: node.end
   };
 }
+function createStableTableSourceRef(partPath, element, xmlPath, extras = {}) {
+  return {
+    sourceId: `part:${partPath}#${xmlPath}`,
+    partPath,
+    storyKind: storyKindFromPartPath(partPath),
+    element,
+    xmlPath,
+    ...extras
+  };
+}
+function mapElementChildrenWithXmlPath(parent, parentXmlPath, mapChild) {
+  const ordinals = /* @__PURE__ */ new Map();
+  const mapped = [];
+  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);
+    mapped.push(mapChild(child, `${parentXmlPath}/${name}[${ordinal}]`));
+  }
+  return mapped;
+}
+function countPriorElementSiblingsByName(parent, target) {
+  const name = localName(target.name);
+  let count = 0;
+  for (const child of parent.children) {
+    if (child === target) {
+      return count;
+    }
+    if (child.type === "element" && localName(child.name) === name) {
+      count += 1;
+    }
+  }
+  return count;
+}
 function createFieldSequenceSourceRef(partPath, node) {
   activeFieldSequenceOrdinal += 1;
   return {
@@ -19751,7 +19908,10 @@ function parseRun(node, sourceXml, relationships, mediaParts, sourcePartPath) {
             })
           });
           if (frame) {
-            result.push(frame);
+            result.push({
+              ...frame,
+              sourceRef: createElementSourceRef(sourcePartPath, "drawing", child)
+            });
             break;
           }
         } catch {
@@ -19800,6 +19960,7 @@ function parseRun(node, sourceXml, relationships, mediaParts, sourcePartPath) {
           ...parsedMedia.map((media) => ({
             type: "image",
             mediaId: media.mediaId,
+            sourceRef: createElementSourceRef(sourcePartPath, "drawing", child),
             relationshipId: media.relationshipId,
             packagePartName: media.packagePartName,
             contentType: media.contentType,
@@ -19830,7 +19991,10 @@ function parseRun(node, sourceXml, relationships, mediaParts, sourcePartPath) {
             })
           });
           if (frame) {
-            result.push(frame);
+            result.push({
+              ...frame,
+              sourceRef: createElementSourceRef(sourcePartPath, "AlternateContent", child)
+            });
             break;
           }
         } catch {
@@ -19867,7 +20031,10 @@ function parseRun(node, sourceXml, relationships, mediaParts, sourcePartPath) {
         try {
           const oleNode = parseObject(child, objectXml, relationships);
           if (oleNode) {
-            result.push(oleNode);
+            result.push({
+              ...oleNode,
+              sourceRef: createElementSourceRef(sourcePartPath, "object", child)
+            });
             break;
           }
         } catch {
@@ -20895,6 +21062,7 @@ function normalizeTable(table, state, packagePartName) {
   state.cursor += 1;
   return {
     type: "table",
+    ...table.sourceRef ? { sourceRef: table.sourceRef } : {},
     ...table.styleId ? { styleId: table.styleId } : {},
     ...table.propertiesXml ? { propertiesXml: table.propertiesXml } : {},
     ...table.unknownPropertyChildren ? { unknownPropertyChildren: table.unknownPropertyChildren } : {},
@@ -20918,6 +21086,7 @@ function normalizeTableRow(row, state, packagePartName) {
   const cells = row.cells.map((cell) => normalizeTableCell(cell, state, packagePartName));
   return {
     type: "table_row",
+    ...row.sourceRef ? { sourceRef: row.sourceRef } : {},
     ...row.propertiesXml ? { propertiesXml: row.propertiesXml } : {},
     ...row.unknownPropertyChildren ? { unknownPropertyChildren: row.unknownPropertyChildren } : {},
     ...row.gridBefore !== void 0 ? { gridBefore: row.gridBefore } : {},
@@ -20943,6 +21112,7 @@ function normalizeTableCell(cell, state, packagePartName) {
   }
   return {
     type: "table_cell",
+    ...cell.sourceRef ? { sourceRef: cell.sourceRef } : {},
     ...cell.propertiesXml ? { propertiesXml: cell.propertiesXml } : {},
     ...cell.unknownPropertyChildren ? { unknownPropertyChildren: cell.unknownPropertyChildren } : {},
     ...cell.gridSpan ? { gridSpan: cell.gridSpan } : {},
@@ -21111,6 +21281,7 @@ function normalizeInlineChildren(nodes, state, packagePartName) {
       case "ole_embed":
         normalized.push({
           type: "ole_embed",
+          ...node.sourceRef ? { sourceRef: node.sourceRef } : {},
           id: node.id,
           ...node.progId ? { progId: node.progId } : {},
           embedType: node.embedType,
@@ -21124,13 +21295,15 @@ function normalizeInlineChildren(nodes, state, packagePartName) {
         normalized.push({
           type: "bookmark_start",
           bookmarkId: node.bookmarkId,
-          name: node.name
+          name: node.name,
+          ...node.sourceRef ? { sourceRef: node.sourceRef } : {}
         });
         break;
       case "bookmark_end":
         normalized.push({
           type: "bookmark_end",
-          bookmarkId: node.bookmarkId
+          bookmarkId: node.bookmarkId,
+          ...node.sourceRef ? { sourceRef: node.sourceRef } : {}
         });
         break;
       case "scope_marker_start":
@@ -21203,6 +21376,7 @@ function normalizeImageNode(node, state) {
   return {
     type: "image",
     mediaId: node.mediaId,
+    ...node.sourceRef ? { sourceRef: node.sourceRef } : {},
     ...node.altText ? { altText: node.altText } : {},
     ...node.placementXml ? { placementXml: node.placementXml } : {},
     ...node.display ? { display: node.display } : {},
@@ -23763,16 +23937,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",
@@ -23821,7 +23993,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(
@@ -23847,7 +24019,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);
           }
@@ -23976,12 +24148,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);
       }
@@ -24063,11 +24235,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);
@@ -24113,7 +24285,7 @@ function parseHyperlinkElement(element, opts) {
     children
   };
 }
-function parseDrawingInlineNode(rawXml, opts, legacyDrawingXml) {
+function parseDrawingInlineNode(rawXml, opts, legacyDrawingXml, sourceElement) {
   try {
     const frame = parseDrawingFrame(rawXml, {
       ...opts,
@@ -24128,7 +24300,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: createElementSourceRef2(
+          opts.sourcePartPath ?? "/word/document.xml",
+          "drawing",
+          sourceElement
+        )
+      } : frame;
     }
     if (frame?.content.type !== "shape" || !frame.content.isTextBox) {
       return frame;
@@ -24167,14 +24346,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",
@@ -24190,18 +24368,21 @@ function parseTxbxBlocksForHeaderFooter(innerXml, opts, depth) {
     currentSourceXml = previousSourceXml;
   }
 }
-function parseBookmarkElement(element) {
+function parseBookmarkElement(element, partPath) {
   const bookmarkId = readStringAttr(element, "w:id") ?? "0";
+  const sourceRef = createElementSourceRef2(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") {
@@ -24244,6 +24425,40 @@ function createFieldSequenceSourceRef2(partPath, node) {
     endOffset: node.end
   };
 }
+function createElementSourceRef2(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 createStableTableSourceRef2(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;
@@ -24470,7 +24685,7 @@ function containsRiskyElement(element) {
   }
   return false;
 }
-function parseSimpleTableElement(tblElement, sourceXml, opts) {
+function parseSimpleTableElement(tblElement, sourceXml, opts, sourceXmlPath) {
   let gridColumns = [];
   const rows = [];
   let propertiesXml;
@@ -24508,11 +24723,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: createStableTableSourceRef2(opts.sourcePartPath ?? "/word/document.xml", "tbl", sourceXmlPath),
     ...styleId ? { styleId } : {},
     ...propertiesXml ? { propertiesXml } : {},
     gridColumns,
@@ -24534,7 +24750,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;
@@ -24555,11 +24771,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: createStableTableSourceRef2(opts.sourcePartPath ?? "/word/document.xml", "tr", sourceXmlPath),
     ...propertiesXml ? { propertiesXml } : {},
     ...height !== void 0 ? { height } : {},
     ...heightRule ? { heightRule } : {},
@@ -24570,7 +24787,7 @@ function parseSimpleTableRow(trElement, sourceXml, opts) {
     cells
   };
 }
-function parseSimpleTableCell(tcElement, sourceXml, opts) {
+function parseSimpleTableCell(tcElement, sourceXml, opts, sourceXmlPath) {
   const children = [];
   let propertiesXml;
   let gridSpan;
@@ -24612,6 +24829,9 @@ function parseSimpleTableCell(tcElement, sourceXml, opts) {
   }
   return {
     type: "table_cell",
+    sourceRef: createStableTableSourceRef2(opts.sourcePartPath ?? "/word/document.xml", "tc", sourceXmlPath, {
+      tableCellPath: sourceXmlPath
+    }),
     ...propertiesXml ? { propertiesXml } : {},
     ...gridSpan ? { gridSpan } : {},
     ...verticalMerge ? { verticalMerge } : {},
@@ -24657,28 +24877,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;
       }
@@ -24698,14 +24912,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;
       }
@@ -24754,7 +24965,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)) {
@@ -24762,16 +24973,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",
@@ -24791,7 +24999,7 @@ function parseNoteElement(element, kind) {
   }
   return { noteId, kind, blocks };
 }
-function parseParagraphElement2(pElement) {
+function parseParagraphElement2(pElement, noteKind) {
   let styleId;
   let alignment;
   let spacing;
@@ -24814,15 +25022,15 @@ function parseParagraphElement2(pElement) {
       spacing = readParagraphSpacing4(child);
       indentation = readParagraphIndentation4(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 {
@@ -24852,7 +25060,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") {
@@ -24881,7 +25089,7 @@ function appendRunNodes2(rElement, nodes, activeComplexField) {
       }
       continue;
     }
-    const inlineNode = parseRunChildNode2(child, marks);
+    const inlineNode = parseRunChildNode2(child, marks, noteKind);
     if (!inlineNode) {
       continue;
     }
@@ -24893,7 +25101,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) {
@@ -24926,14 +25134,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);
@@ -24967,16 +25175,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);
         }
@@ -24989,18 +25197,21 @@ function parseHyperlinkElement2(element) {
     children
   };
 }
-function parseBookmarkElement2(element) {
+function parseBookmarkElement2(element, noteKind) {
   const bookmarkId = readStringAttr(element, "w:id") ?? "0";
+  const sourceRef = createElementSourceRef3(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) {
@@ -25172,7 +25383,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;
@@ -25210,11 +25421,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: createStableTableSourceRef3(noteKind, "tbl", sourceXmlPath),
     ...styleId ? { styleId } : {},
     ...propertiesXml ? { propertiesXml } : {},
     gridColumns,
@@ -25236,7 +25448,7 @@ function parseSimpleTableElement2(tblElement) {
 function readGridColumns3(tblGrid) {
   return readGridColumns(tblGrid);
 }
-function parseSimpleTableRow2(trElement) {
+function parseSimpleTableRow2(trElement, noteKind, sourceXmlPath) {
   const cells = [];
   let propertiesXml;
   let height;
@@ -25257,11 +25469,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: createStableTableSourceRef3(noteKind, "tr", sourceXmlPath),
     ...propertiesXml ? { propertiesXml } : {},
     ...height !== void 0 ? { height } : {},
     ...heightRule ? { heightRule } : {},
@@ -25272,7 +25485,7 @@ function parseSimpleTableRow2(trElement) {
     cells
   };
 }
-function parseSimpleTableCell2(tcElement) {
+function parseSimpleTableCell2(tcElement, noteKind, sourceXmlPath) {
   const children = [];
   let propertiesXml;
   let gridSpan;
@@ -25309,11 +25522,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: createStableTableSourceRef3(noteKind, "tc", sourceXmlPath, {
+      tableCellPath: sourceXmlPath
+    }),
     ...propertiesXml ? { propertiesXml } : {},
     ...gridSpan ? { gridSpan } : {},
     ...verticalMerge ? { verticalMerge } : {},
@@ -25329,6 +25545,42 @@ function parseSimpleTableCell2(tcElement) {
     children: children.length > 0 ? children : [{ type: "paragraph", children: [] }]
   };
 }
+function createStableTableSourceRef3(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 createElementSourceRef3(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}="${escapeXmlAttribute5(value)}"`).join("");
   const children = element.children.map((child) => {