Merge main into stable

[superdoc-orbit]

Summary

• creates merge/main-into-stable-2026-08-04 from stable
• merges main into the candidate branch
• opens the promotion PR to stable

---

Auto-created by promote-stable workflow.

[github-actions]

The ecma-spec MCP tools are being denied by the permission layer in this environment (every call — ooxml_element, ooxml_attributes, ooxml_children, ooxml_search — returns "haven't granted it yet"), so I wasn't able to run live schema lookups. I'll be transparent about that and base the compliance review on ECMA-376 knowledge, focused on the OOXML-handler changes in the changed files.

---

Status: PASS

The OOXML that this PR actually reads and writes is spec-compliant, and in one place it fixes a latent violation. Walking the substantive handler changes:

• w:delInstrText for deleted field instructions (preProcessNodesForFldChar.js, track-change-helpers.js, del-translator.js, crossReference-translator.js). Recognizing/emitting w:delInstrText for a field-instruction run inside <w:del> is correct — that's exactly the ECMA-376 element for a deleted field code, the deletion-equivalent of w:instrText (cited §17.16.13). Renaming w:instrText → w:delInstrText recursively while leaving w:fldChar untouched is right; field-char delimiters are valid inside a deleted run and must not be renamed. See https://ooxml.dev/spec?q=delInstrText

• w:delText inside <w:del> (track-change-helpers.js renameTextElementsForDeletion). Renaming every w:t → w:delText (not just the first) is correct — deleted run content must use w:delText, and a stray w:t inside <w:del> would not be treated as deleted. https://ooxml.dev/spec?q=delText

• Paragraph-mark deletion via w:pPr/w:rPr/w:del (legacy-handle-paragraph-node.js, generate-paragraph-properties.js, paragraph.js). A tracked deletion of the paragraph glyph belongs in the paragraph-mark run properties (CT_ParaRPr permits w:del), so reading/writing it there is the correct representation, and pairing it with the run-level <w:del> under one id matches Word. https://ooxml.dev/spec?q=del

• w:id allocated as a decimal (resolve-export-word-id.js, generate-paragraph-properties.js). This is a genuine fix: w:id on CT_TrackChange/CT_Markup is ST_DecimalNumber, so routing the internal UUID through the allocator keeps it in schema. Writing the UUID straight in would have been the violation, and the comments call that out correctly. https://ooxml.dev/spec?q=CT_Markup

• w:tc must keep a block-level child (translate-table-cell.js). Correct — CT_Tc requires at least one block-level element, so backfilling an empty <w:p> when every child drops out avoids emitting a w:tc with only w:tcPr, which Word would flag for repair. https://ooxml.dev/spec?q=tc

One thing worth flagging as an FYI (not a blocker): appendParagraphMarkDeletion writes w:authorEmail on the <w:del> element (conditionally), matching what the existing w:ins/w:del translators already do. w:authorEmail is not part of CT_TrackChange in ECMA-376 (only w:author, w:date, and the inherited w:id). It's a pre-existing SuperDoc convention this PR simply propagates for consistency rather than something this change introduces, and Word tolerates the unknown attribute — but if strict-schema validity ever matters, that attribute is non-standard across the whole track-changes export path, not just here.

Net: no spec violations introduced by this PR; the field/deletion handling is correct and the decimal-id and w:tc guards remove real hazards. I'd suggest re-running the ecma-spec tools once permissions are available to confirm the authorEmail point, since I couldn't verify it live.

[superdoc-orbit]

🎉 This PR is included in superdoc-cli v0.23.0

The release is available on GitHub release

[superdoc-orbit]

🎉 This PR is included in superdoc-sdk v1.22.0

[superdoc-orbit]

🎉 This PR is included in @superdoc-dev/mcp v0.18.0

The release is available on GitHub release

[superdoc-orbit]

🎉 This PR is included in superdoc v1.46.0

The release is available on GitHub release

[superdoc-orbit]

🎉 This PR is included in @superdoc-dev/react v1.17.0

The release is available on GitHub release

[superdoc-orbit]

🎉 This PR is included in vscode-ext v2.18.0