@beyondwork/docx-react-component 1.0.0 → 1.0.2

package/docs/research/docx-react-component/Feature Compatibility Matrix for a React Word Compatible Legal Editor v1.md

@@ -1,219 +0,0 @@
-# Feature Compatibility Matrix for a React Word Compatible Legal Editor v1
-
-## Support philosophy and integrity contract
-
-This v1 editor is engineered for **legal review workflows** (contracts, pleadings, deal docs, redlines, comment-based review), not for full Microsoft Word feature parity. The guiding rule is **“roundtrip integrity over rendering fidelity”**: exported `.docx` must reopen in modern Word without repair dialogs and without structural damage, even if the on-screen layout in the browser is simplified. citeturn15search3turn15search13turn10search3
-
-The interoperability contract is based on these WordprocessingML realities:
-
-- A Word document body is fundamentally **block structures** (e.g., paragraphs and tables) where a paragraph (`w:p`) contains runs (`w:r`) and text (`w:t`), plus annotations like comments and revisions. citeturn6search3turn4search7turn13search0turn16search1  
-- Critical legal review constructs (comments, tracked changes, numbering, tables) are represented as **specific OOXML elements and parts** (e.g., `comments.xml`, `commentsExtended.xml`, `numbering.xml`, headers/footers parts). citeturn9search17turn11search7turn7search17turn3search2  
-- “Unknown” or out-of-scope OOXML is commonly carried using **markup compatibility and extensibility** (e.g., `mc:AlternateContent`, ignorable namespaces). A conformant producer must avoid destroying semantics it does not understand. citeturn15search0turn15search5turn15search1
-
-Accordingly, v1 uses four operational principles:
-
-1. **Supported features are normalized into an internal schema** and can be edited safely and serialized back to OOXML with deterministic behavior.
-2. **Preserve-only features are retained byte-for-byte** (or as faithful XML subtrees) and re-emitted, but editing is intentionally constrained to prevent corruption.
-3. **Import-only features are visually flattened** for reading but are not emitted as the same OOXML feature on export (used sparingly in v1 because legal workflows demand roundtrip).
-4. **Unsupported-fatal conditions block save/export** (or force read-only mode) when v1 cannot guarantee Word-safe output.
-
-## Matrix definitions and processing rules
-
-### Support classes
-
-- **supported-roundtrip**: imported into editor model (or safely preserved), edits are safe per the rules below, export is Word-safe, and Word reopens feature intact (or with stated, bounded simplifications).
-- **supported-import-only**: imported for display; editing/export does not fully preserve the semantic feature.
-- **supported-export-only**: feature can be created on export but not reliably parsed from arbitrary input.
-- **preserve-only**: imported and re-emitted without semantic understanding; editing is locked or restricted to prevent damaging the preserved XML/parts.
-- **unsupported-fatal**: v1 cannot guarantee Word-safe export if present (or if user edits would intersect it); workflow must block editing/export in those regions or fail fast.
-
-### Preservation rules used across the matrix
-
-- **Package-level preservation**: preserve all unknown parts and relationships in the OPC package graph unless v1 must rewrite package metadata (content types / rels). OPC concepts of parts, content types, and relationships are foundational for `.docx`. citeturn15search3turn15search13turn15search2  
-- **Markup compatibility**: preserve `mc:AlternateContent` structures and ignorable namespaces as-is; v1 does not “pick a Choice” and discard others. citeturn15search5turn15search1turn15search0  
-- **Atomic opaque nodes**: any unknown block-level or inline-level XML subtree is represented as an **opaque node** that is not splittable by editing operations; deletion is either disallowed or deletes the entire opaque node as a unit (explicitly called out where relevant).
-
-## Full feature compatibility matrix
-
-The following tables are the v1 **single source of truth**. Columns are identical across categories.
-
-### Core structure
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Paragraphs (`w:p`) | supported-roundtrip | Fully parsed into block schema: paragraph node + paragraph properties + inline content. Paragraph is defined as `w:p` and can contain properties, annotations, custom markup, and run-level content. citeturn6search3turn18search3 | Editable: insert/delete text; split/merge paragraphs; paragraph-level ops allowed even with tracked changes enabled (see Review section for revision markup rules). | Native serialization back to `w:p` with `w:pPr` and child content; unknown children preserved as opaque nodes if not parsed. | Fully intact. | v1 never emits an empty paragraph without at least one valid run/text structure when required by context; paragraph boundary ops must also preserve comment/revision markers order. citeturn6search3turn16search14 | “Basic legal contract” with mixed paragraphs; paragraph split/merge; with comments and revisions. | editor-core, docx-parser, serializer, preservation-layer |
-| Runs (`w:r`) and text containers (`w:t`) | supported-roundtrip | Fully parsed into inline schema: run properties + run children (`w:t`, `w:br`, `w:tab`, drawings, fields/hyperlinks as separate nodes). Runs are defined as `w:r`. citeturn4search7turn18search18 | Editable: run segmentation is internal; user edits text seamlessly across run boundaries (editor may re-split/merge runs deterministically). | Native run emission with normalized run boundary rules; preserve run properties precedence vs styles where present. citeturn5search6turn18search0 | Fully intact. | WordprocessingML whitespace handling requires `xml:space="preserve"` in some cases; v1 maintains this on export to prevent space loss. citeturn6search14turn6search2 | Paragraph with multiple runs and mixed formatting; leading/trailing spaces; copy/paste across runs. | editor-core, serializer |
-| Significant whitespace in text (`xml:space="preserve"` on `w:t`) | supported-roundtrip | Import reads `xml:space` and preserves exact text content including leading/trailing spaces. citeturn6search14 | Editable (transparent to user). Editor recalculates when `xml:space="preserve"` is required after edits. | Native emission: `xml:space="preserve"` applied whenever leading or trailing spaces would otherwise be collapsed. citeturn6search14turn6search2 | Fully intact (no unintended whitespace collapse). | v1 does not attempt to normalize multiple internal spaces; it preserves literal text exactly unless user changes it. | “Whitespace torture” fixture: leading/trailing spaces, multiple spaces, tabs, mixed revisions. | editor-core, serializer |
-| Hard line breaks (`w:br`) | supported-roundtrip | Parsed into inline “line break” tokens; includes explicit breaks in runs. (Drawing/inline objects use their own elements; see Media.) citeturn19search0turn3search3 | Editable: insert/delete “line break” token. | Native: serialized as `w:br` in the correct run position. | Intact; Word displays as manual line breaks. | Page/column breaks are **not** treated as `w:br` in v1 unless explicitly represented that way in OOXML; `w:br` types beyond simple line break are preserve-only unless listed elsewhere. | Contract clause with manual line breaks (addresses/signature blocks). | editor-core, serializer |
-| Tabs (`w:tab`) | supported-roundtrip | Parsed into inline “tab” tokens (not converted to spaces). | Editable: insert/delete tab token; no “tab stop UI” in v1. | Native: serialized as `w:tab` in runs. | Intact; tab layout depends on Word tab stops/styles. | v1 does not provide a visual ruler; display in browser is approximate and may not match Word tab alignment exactly, but OOXML roundtrips. | Legal pleadings with tab-indented captions; signature blocks using tabs. | editor-core, serializer |
-| Paragraph styles (`w:pPr/w:pStyle`) | supported-roundtrip | Parsed and retained as paragraph style references (`pStyle` styleId). citeturn18search0turn18search2 | Locked (not exposed): v1 can apply built-in heading styles via UI (see next row), but does not edit style definitions. | Passthrough for style references; styles part preserved. citeturn18search6turn18search2 | Intact; Word applies styles normally. | If a referenced styleId is missing/corrupt in the source, v1 preserves reference but does not synthesize a style; Word behavior depends on Word’s fallback rules. | Contract with custom paragraph styles + Normal/BodyText. | docx-parser, serializer, preservation-layer |
-| Headings (Heading 1–9 semantics via styles and/or `w:outlineLvl`) | supported-roundtrip | Import detects headings by styleId conventions and/or outline level when present; `w:outlineLvl` defines structural outline level (0–9) though it does not itself change appearance. citeturn17view0turn18search7turn18search0 | Partially editable: v1 exposes “Heading 1–Heading 9” which sets paragraph `pStyle` to the corresponding styleId if present; v1 does **not** edit style definitions (font/spacing) for headings. | Native: emits `pStyle` unchanged/updated; preserves any existing `outlineLvl`; does not invent `outlineLvl` unless it already exists. citeturn18search0turn18search7 | Intact; Word headings appear per styles in `styles.xml`. | If a document uses custom heading styles not named/derived from built-ins, v1 preserves them but may not classify them as headings in UI; no TOC regeneration in v1. citeturn17view0 | Contract with multi-level headings, custom style inheritance, TOC field present. | editor-core, docx-parser, serializer |
-
-### Formatting
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Bold (`w:b`) | supported-roundtrip | Parsed from run properties; `w:b` is the bold toggle. citeturn5search0turn5search6 | Editable: toggle bold on selection; bold inside/outside revisions supported. | Native: emitted as `w:rPr/w:b` on the minimal set of runs required. citeturn5search6turn5search4 | Intact. | **Tracked formatting changes are not generated in v1** (no new `rPrChange` revisions). Formatting edits apply directly. Existing tracked formatting revisions are preserve-only (see Review). citeturn12search11turn14view0 | Legal contract with defined terms in bold; edits inside inserted text. | editor-core, serializer |
-| Italic (`w:i`) | supported-roundtrip | Parsed from run properties; `w:i` is italics toggle. citeturn5search8turn5search6 | Editable: toggle italic on selection. | Native emission as `w:rPr/w:i`. citeturn5search6turn5search5 | Intact. | Same tracked-formatting caveat as bold. | Clause with italic emphasis; mixed bold+italic runs. | editor-core, serializer |
-| Underline (`w:u`) | supported-roundtrip | Parsed including underline style values; `w:u` defines underline and “none” removes it. citeturn6search0turn5search6 | Editable: underline toggle exposes a single default underline style; UI does not expose full underline style enumeration. | Native: emits `w:u` with `val` as needed; preserves original underline styles when not edited. citeturn6search0 | Intact; style may simplify if user re-applies underline (falls back to default single underline). | If source uses uncommon underline styles, v1 preserves unless the underline is edited, in which case the style normalizes to default underline. citeturn6search0 | Contract with underlined headings/signature lines. | editor-core, serializer |
-| Strikethrough (`w:strike`) | supported-roundtrip | Parsed from run properties; strike draws a horizontal line through text. citeturn5search7turn5search3 | Editable: toggle strikethrough as formatting (distinct from tracked deletion). | Native emission as `w:strike`. citeturn5search13 | Intact. | Users must not confuse strikethrough formatting with tracked deletions; tracked deletions use `w:del` containers (see Review). citeturn12search5turn13search0 | Doc with strikethrough used for “reserved/deleted” text without track changes. | editor-core, serializer |
-| Font family (`w:rFonts`) | supported-roundtrip | Parsed from run fonts; can specify ASCII / High ANSI / CS / East Asian font faces. citeturn6search1turn6search9 | Partially editable: v1 UI may allow selecting a font family; advanced script-specific font slots are not exposed. | Native: emits `w:rFonts` for ASCII+High ANSI; preserves CS/East Asian slots if unchanged. citeturn6search1 | Intact in Word. | Browser rendering depends on installed fonts; visual differences vs Word are expected, but OOXML values roundtrip. citeturn6search1 | Contract with mixed fonts (Times New Roman/Calibri) and defined-term styling. | editor-core, serializer |
-| Font size (`w:sz`) | supported-roundtrip | Parsed; `w:sz` stores half-points for non-complex script. citeturn4search22turn5search6 | Partially editable: v1 UI may expose a limited size picker. | Native: emits `w:sz`; preserves related `szCs` if present and unchanged. citeturn4search22 | Intact. | If the source uses complex-script-specific sizing, v1 preserves but does not author new complex-script sizes. citeturn4search22 | Pleading with small footers; contract with 10/12/14 pt variations. | editor-core, serializer |
-| Font color (`w:color`) | supported-roundtrip | Parsed; `w:color` defines run color or auto behavior. citeturn4search3turn5search6 | Partially editable: v1 may expose a restricted palette; “theme color” editing not exposed. | Native: emits `w:color`; preserves theme-related attributes if unchanged. citeturn4search3 | Intact. | Many legal workflows avoid color; if color is edited, v1 writes explicit RGB and may drop theme linkage. citeturn4search3 | Doc with red/blue markup (non-track-changes) plus normal text. | editor-core, serializer |
-| Paragraph alignment (`w:jc`) | supported-roundtrip | Parsed from paragraph properties; `w:jc` controls alignment. citeturn4search0turn4search9 | Partially editable: left/center/right/justify exposed. | Native: emits `w:jc` in `w:pPr` only when needed; preserves inherited style behavior when not overridden. citeturn4search0 | Intact. | Alignment may be inherited through style hierarchy; v1 does not compute a full cascade for UI display but preserves stored values. citeturn4search0turn18search0 | Signature blocks (right-aligned), centered titles, justified body. | editor-core, serializer |
-| Indentation (`w:ind`) | supported-roundtrip | Parsed with full attribute set (start/end/firstLine/hanging, etc.). citeturn4search1turn4search17 | Locked (not exposed in v1 UI): indentation is preserved and survives edits to text. | Passthrough/native: emitted exactly as imported if paragraph exists; no recomputation. citeturn4search1 | Intact. | v1 does not attempt to reconcile indentation vs numbering indentation; list rendering in browser may be approximate for complex styles. citeturn7search17turn4search1 | Contract with indented block quotes/recitals; list paragraphs with hanging indents. | serializer, preservation-layer |
-| Spacing before/after and line spacing (`w:spacing`) | supported-roundtrip | Parsed from paragraph properties. citeturn4search2turn4search6 | Locked (not exposed): spacing preserved through text edits. | Passthrough/native: emitted as imported, including before/after/line and autos. citeturn4search2 | Intact. | Browser line layout does not replicate Word pagination; spacing values roundtrip but on-screen measurement is approximate. citeturn4search2 | Contract with spacing rules; title blocks with large before/after spacing. | serializer, preservation-layer |
-| Character styles (`w:rPr/w:rStyle`) | preserve-only | Imported and preserved as character style references; character styles are referenced via `rStyle`. citeturn18search1turn18search5 | Not exposed: v1 does not provide a style editor or style picker for arbitrary character styles. | Passthrough: preserved and re-emitted; styles part preserved. citeturn18search6turn18search5 | Intact. | If user edits inside styled text, v1 may split runs but retains `rStyle` on resulting runs; it does not guarantee minimal run diffs. citeturn18search5turn4search7 | Doc with Hyperlink style; custom character style for defined terms. | preservation-layer, serializer |
-
-### Lists
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Bullet lists (Word numbering system) | supported-roundtrip | Parsed via paragraph numbering properties `w:numPr` referencing numbering instances (`w:numId`) and levels (`w:ilvl`). citeturn7search2turn7search9turn7search13 | Editable: toggle bullet list; indent/outdent 0–8 levels; split/merge list items. | Native: updates `w:numPr` bindings; preserves existing numbering definitions unless v1 must create a new list instance. citeturn7search17turn7search12 | Intact; Word renders bullets per numbering definitions. | v1 supports common bullet formats; uncommon bullet glyphs are preserved but may render as generic bullets in-browser. citeturn7search17 | Legal outline with bullets under numbered sections; nested bullets. | numbering-engine, serializer |
-| Numbered lists | supported-roundtrip | Parsed using the same numbering model: abstract numbering definitions + numbering instances. citeturn7search17turn7search18turn7search12 | Editable: toggle numbered list; indent/outdent; continue numbering across adjacent items. | Native: updates `numId/ilvl` and preserves abstractNum/num structures; v1 does not rewrite list templates unless needed. citeturn7search17turn7search12 | Intact. | Number formatting (`numFmt`) variety is broad; v1 guarantees correct roundtrip but only guarantees accurate in-browser numbering for common formats (decimal, alpha, roman, bullet). citeturn7search11turn7search17 | Contract with multi-level numbering (1., 1.1, (a), (i)). | numbering-engine, serializer |
-| Nested lists (up to 9 levels in Word, 0–8 in `ilvl`) | supported-roundtrip | Parsed: `w:ilvl` is stored per paragraph and preserved. citeturn7search13turn7search16 | Editable: indent/outdent list items across levels; maintains list structure deterministically. | Native: emits correct `ilvl` in `numPr`. citeturn7search13 | Intact. | v1 does not provide a UI for editing `lvlText` templates; it preserves what exists. citeturn7search11 | “Deal outline” fixture: 4–6 nested levels with mixed punctuation. | numbering-engine, editor-core |
-| Restart numbering | supported-roundtrip | Imported restarts are detected either by new numbering instances (`w:num`) or by level overrides with `startOverride` when present. citeturn7search12turn7search0turn7search5 | Editable: “Restart numbering” command creates a new numbering instance referencing the same abstract definition or emits a level override start value at level 0. citeturn7search0turn7search12 | Native: emits new `w:num` instance and/or `lvlOverride/startOverride` depending on document constraints; preserves existing restart model if already present. citeturn7search6turn7search0 | Intact; Word restarts at specified values. | Restart semantics can also be affected by `lvlRestart` rules; v1 does not author complex restart policies—only explicit restarts requested by user. citeturn7search0 | “Schedules” exhibit: multiple separate numbered lists restarting at 1. | numbering-engine, serializer |
-| Numbering definitions and overrides (`abstractNum`, `num`, `lvlOverride`) | preserve-only | Imported and preserved; v1 reads enough for accurate list structure binding but does not expose definition editing. citeturn7search18turn7search12turn7search6 | Locked: no list-template editor in v1. | Passthrough: preserves numbering part; emits minimal deltas for paragraph bindings and explicit restarts. citeturn7search17turn7search12 | Intact. | If the source numbering part is internally inconsistent but Word tolerates it, v1 preserves it; if v1 must modify it, it may normalize/repair into a Word-safe form (logged as a warning). citeturn7search17turn15search3 | “Numbering zoo”: custom list templates, overrides, style-linked numbering. | preservation-layer, numbering-engine, serializer |
-
-### Tables
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Basic tables (`w:tbl` / `w:tr` / `w:tc`) | supported-roundtrip | Fully parsed into table schema: rows, cells, and cell block content; `w:tbl` defines table. citeturn8search0turn8search8 | Partially editable: edit text inside cells; select cells; delete/insert **cell content**. Table structure edit (add/remove rows/cols) is **not exposed** in v1 to protect layout + merges. | Native: serialize to `w:tbl` with preserved tblPr/tblGrid; ensures each cell contains at least one paragraph. citeturn8search0turn8search12 | Intact. | WordprocessingML requires valid cell content; v1 guarantees every exported `w:tc` contains at least one `w:p` (empty paragraph allowed) to avoid corruption/repair prompts. citeturn8search12turn8search0 | “Table heavy contract”: definitions table; signature table; exhibits table. | table-engine, serializer |
-| Merged cells horizontal (`w:gridSpan`) | supported-roundtrip | Parsed from cell properties; `gridSpan` describes grid columns spanned. citeturn2search4turn8search1 | Locked: v1 does not expose merge/split UI. Cell text editing allowed without affecting merge metadata. | Passthrough/native: preserves `gridSpan` exactly. citeturn2search4 | Intact; Word shows merged cell. | If a user deletes an entire merged cell’s content, merge metadata remains; deleting the cell itself is not supported in v1. | Table fixture with multi-column header cells + merged signature blocks. | table-engine, preservation-layer |
-| Merged cells vertical (`w:vMerge`) | supported-roundtrip | Parsed from `tcPr`; `vMerge` specifies vertical merge state (restart/continue semantics). citeturn1search1turn8search1 | Locked: no merge/split UI. | Passthrough/native: preserves `vMerge` exactly. citeturn1search1 | Intact. | v1 does not recompute row heights and does not attempt to “repair” invalid vertical merge grids; it preserves what it imported unless structure editing is attempted (blocked). citeturn1search1turn8search12 | Table fixture with vertically merged stub columns. | table-engine, preservation-layer |
-| Table-wide properties (`w:tblPr`) | supported-roundtrip | Parsed and retained; includes borders, widths, and other table-wide properties. citeturn8search2turn8search0 | Locked: not exposed for editing. | Passthrough: emitted exactly as imported. citeturn8search2 | Intact. | Browser rendering may not match Word’s border collapsing/layout; OOXML is preserved. citeturn8search7turn8search2 | Table fixture with explicit borders, widths, and style-based formatting. | preservation-layer, serializer |
-| Table grid and column definitions (`w:tblGrid`) | supported-roundtrip | Preserved; grid defines shared vertical edges and default widths. citeturn2search8turn8search0 | Locked. | Passthrough. citeturn2search8 | Intact. | Because v1 does not expose column add/remove, tblGrid can be preserved safely without recomputation. citeturn2search8 | “Fixed-width comparison table” fixture with explicit grid columns. | preservation-layer |
-| Table layout algorithm (`w:tblLayout` fixed/auto) | preserve-only | Imported and preserved (table may be fixed or AutoFit). citeturn8search7turn8search3 | Not exposed. | Passthrough. citeturn8search7 | Intact. | Word may still adjust column widths on open depending on content and AutoFit rules; v1 does not attempt to predict these adjustments. citeturn8search7turn8search19 | AutoFit stress table: long text cells vs fixed width. | preservation-layer |
-
-### Media
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Images inline (`w:drawing` with `wp:inline`) | supported-roundtrip | Parsed into inline “image” objects referencing package media parts and relationships; drawing objects are represented via `w:drawing`. citeturn3search3turn3search11 | Partially editable: select, cut/paste as a single object, delete; no crop, no wrap style editing. | Native: preserves image part + relationship IDs if unchanged; new images create new relationships and media parts with proper content types. citeturn3search3turn15search3 | Intact; Word shows image inline with text. | v1 does not support floating wrap; if an inline image is converted to floating in Word and re-imported, it becomes preserve-only (next row). citeturn3search3turn3search11 | Contract with logos; exhibits with scanned signature images inline. | media-manager, serializer |
-| Images floating/anchored (`wp:anchor`) | preserve-only | Imported as opaque object: v1 does not parse anchor positioning; stores original DrawingML subtree and relationships. citeturn3search3turn3search19 | Not exposed; rendered as placeholder (thumbnail if possible). | Passthrough: emits original anchor subtree unchanged. citeturn3search3turn15search0 | Intact; Word preserves floating positioning. | Editing text around anchored objects is allowed, but deleting/splitting inside the anchored object’s XML is blocked; object is atomic in v1. citeturn15search0turn15search5 | Doc with floating signature stamp/watermark-like images; inline + anchored mix. | preservation-layer, media-manager |
-| Captions | preserve-only | Imported as ordinary paragraphs (often via a “Caption” style) and may include sequence fields; v1 preserves style refs and fields rather than implementing caption semantics. citeturn18search0turn2search2turn2search6 | Not exposed as a special feature; caption text is editable like normal paragraph, but caption numbering is not recomputed. | Passthrough for fields/style references; paragraph text emitted normally. citeturn2search2turn18search0 | Visually intact; numbering may be stale until Word updates fields. | Caption auto-numbering typically relies on fields (e.g., SEQ); v1 does not update field results and therefore does not guarantee correct caption numbering after edits. citeturn2search6turn2search2 | Exhibit with figure/table captions using fields; edit caption text and reopen. | preservation-layer, serializer |
-
-### Links
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Hyperlinks external (`w:hyperlink` with `r:id`) | supported-roundtrip | Fully parsed: `w:hyperlink` element with relationship target. citeturn2search1turn0search7 | Editable: edit display text; edit URL; remove hyperlink (keeps text). | Native: emits `w:hyperlink` and maintains relationship in `.rels`. citeturn2search1turn15search3 | Intact; clickable links in Word. | v1 preserves hyperlink history/visited flags if present; does not expose them in UI. citeturn0search7turn2search1 | Contract with external exhibit links and defined-term references to URLs. | hyperlink-manager, serializer |
-| Hyperlinks internal (`w:hyperlink` with `w:anchor` to bookmarks) | preserve-only | Parsed enough to render as a link; bookmark targets are preserved but bookmark management is not implemented. citeturn2search1turn6search18 | Not exposed: cannot create new internal anchors; can remove link wrapper (keeps text). | Passthrough for anchor attribute and bookmark structures. citeturn6search18turn2search1 | Intact; Word resolves links if bookmarks exist. | If the user deletes the target bookmark paragraph, Word may break the internal link; v1 does not validate bookmark integrity. citeturn6search18 | Brief with internal cross-references; bookmarks + hyperlinks. | preservation-layer, serializer |
-
-### Review
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Comments anchors (range) (`w:commentRangeStart`, `w:commentRangeEnd`, `w:commentReference`) | supported-roundtrip | Fully parsed for **single-paragraph ranges**: v1 maps start/end markers and reference marks by `w:id`. Spec defines start/end range markers and reference-to-comment linkage by id. citeturn16search1turn16search3turn9search9turn9search17 | Partially editable: can add, delete, and move comment ranges within a single paragraph; editing inside range updates anchors deterministically. | Native: emits range markers and reference in correct ordering; preserves ids and ensures `comments.xml` has matching comment entries. citeturn16search1turn9search17 | Intact; Word shows anchored comments. | Comment ranges can be structurally complex (start/end markers may fall in different nestings); v1 guarantees correctness for ranges fully contained in one paragraph and not crossing opaque nodes. citeturn16search7turn16search14 | “Redline + comments” contract: comment on defined term; edit inside range; move anchor. | comment-engine, editor-core, serializer |
-| Comments text bodies (`/word/comments.xml`) | supported-roundtrip | Parsed into comment objects (author/date/text); comments part contains comment content. citeturn9search17turn9search4 | Editable: add/edit/delete comment text. | Native: emits `comments.xml` with stable ids and required entries. citeturn9search17 | Intact. | v1 preserves comment metadata fields (author/date). If missing, v1 writes system defaults (e.g., “Unknown”) but does not fabricate identity parts. citeturn10search14 | Comment-only fixture: multiple comments with authors/dates. | comment-engine, serializer |
-| Comment replies (threading via `commentsExtended.xml` / `w15:commentEx` / `paraIdParent`) | supported-roundtrip | Parsed when present: v1 reads `commentsExtended.xml` to link replies using `paraIdParent`. citeturn11search7turn11search4turn11search11 | Editable: add replies; reorder not supported (chronological only). | Native: emits/updates `commentsExtended.xml` (`commentsEx`) and `commentEx` entries so Word recognizes threads. citeturn11search7turn11search11turn10search5 | Intact; Word displays replies as threaded. | Thread linkage depends on `paraId`/`paraIdParent` consistency; v1 assigns stable paraIds and does not change them on simple edits to comment text. citeturn11search7turn11search3 | Threaded comments fixture (Word 2013+): root comment + 3 replies + reopen. | comment-engine, serializer |
-| Comment resolution status (done/resolved via `w15:commentEx` `done`) | supported-roundtrip | Imported from `commentEx` “done” flag when present. citeturn10search1turn10search8 | Editable: resolve/unresolve supported (per-thread root). | Native: toggles `w15:done` on the root comment’s `commentEx`. citeturn10search1turn11search7 | Intact; Word shows resolved/done state. | Some Word clients treat “resolved” semantics differently across versions; v1 writes the standards-based flag and does not attempt client-specific variants. citeturn9search7turn10search1 | Threaded comments + resolved state fixture. | comment-engine, serializer |
-| Track changes global setting (`w:trackRevisions` in settings) | supported-roundtrip | Imported and preserved; `trackRevisions` specifies revisions tracking is enabled in the document settings. citeturn3search12turn0search5 | Partially editable: v1 exposes a document-level “Track changes mode” toggle that controls whether edits generate revision markup. | Native: emits/updates `w:trackRevisions` in settings when toggled. citeturn3search12turn13search7 | Intact; Word respects track changes being enabled. | Even if `trackRevisions` is on, Word does not automatically “track” changes unless the correct revision markup exists; v1 must generate `w:ins`/`w:del` (next rows). citeturn3search12turn13search0 | Fixture: same document edited with toggle off vs on; compare OOXML output. | review-engine, serializer |
-| Tracked insertions (run-level) (`w:ins` inserted run content) | supported-roundtrip | Fully parsed: inserted content containers are recognized and rendered as insertions. citeturn13search0turn13search1 | Editable: insert text while tracking is on creates `w:ins` around inserted runs; edits inside an inserted region keep the region inserted. | Native: emits `w:ins` with required metadata (author/date/id as configured) and correct child runs. citeturn13search0turn3search12 | Intact redlines in Word. | v1 does not generate “move” revisions; move operations become insert+delete (see “revisions overlap” and “moves” rows). citeturn12search10turn12search2 | “Redlines basic”: insertions across multiple runs with formatting. | review-engine, serializer |
-| Tracked deletions (run-level) (`w:del` deleted run content) | supported-roundtrip | Fully parsed and rendered as deletion with deleted text representation. citeturn12search5turn13search19 | Editable: delete text while tracking is on creates `w:del` containers; backspace/delete across run boundaries supported. | Native: emits `w:del` with required metadata; deleted inner text is emitted as deleted content (Word shows strikethrough per view). citeturn12search5turn16search12 | Intact redlines in Word. | v1 does not guarantee “minimal diff” for deletions; deleting across formatting boundaries may produce multiple adjacent `w:del` segments. | “Redlines basic”: deletions with mixed formatting + reopen. | review-engine, serializer |
-| Paragraph mark deletion/merge (`w:del` on paragraph mark run properties) | supported-roundtrip | Imported and preserved; deletion of paragraph mark merges paragraphs in tracked-change semantics. citeturn3search1turn14view0 | Editable: deleting a paragraph boundary while tracking is on generates paragraph mark deletion revision (join paragraphs with tracked marker). | Native: emits `w:del` in paragraph mark properties as Word expects. citeturn3search1turn14view0 | Intact; Word shows paragraph merge as tracked change. | This is distinct from deleting all text in a paragraph; v1 uses the paragraph-mark mechanism for boundary deletions only. citeturn3search1turn6search3 | Fixture: delete paragraph boundary between two clauses with comments + redlines enabled. | review-engine, serializer |
-| Paragraph mark insertion/split (`w:ins` on paragraph mark run properties) | supported-roundtrip | Imported and preserved; insertion of a paragraph mark is tracked via paragraph mark ins semantics. citeturn12search4turn12search8 | Editable: pressing Enter while tracking is on generates paragraph mark insertion revision (split paragraph). | Native: emits paragraph mark insertion markup. citeturn12search8 | Intact. | v1 does not generate “formatting change” revisions for paragraph property changes; splitting paragraphs preserves the imported paragraph properties deterministically. citeturn14view0turn4search5 | Fixture: split a numbered paragraph; split inside comment range (single-paragraph only). | review-engine, serializer |
-| Accept/reject insertions and deletions | supported-roundtrip | Imported revision markup is recognized for supported revision types (`w:ins` / `w:del` run content and paragraph-mark ins/del). citeturn13search0turn12search5turn14view0 | Editable: accept/reject per change and “accept all / reject all” supported for those types. | Native: accept = unwrap insertions / remove deletions; reject = remove insertions / unwrap deletions. This mirrors common Open XML revision processing patterns. citeturn14view0turn13search1turn13search19 | Intact; Word opens with changes applied. | For preserve-only revision types (moves, formatting changes, table-row revisions, numberingChange), accept/reject UI is disabled to avoid partial corruption. citeturn12search2turn12search11turn3search5turn1search8 | Fixture: accept/reject flow across paragraph joins, list items, and table-cell text. | review-engine |
-| Tracked moves (`moveFrom`/`moveTo` and range markers) | preserve-only | Imported and preserved; v1 renders as delete+insert visually to user (labelled “move (preserved)”). citeturn12search10turn14view0 | Not exposed: cannot create new move revisions; cannot accept/reject moves in v1 UI (must use Word). | Passthrough: emits move markup unchanged. citeturn12search10turn14view0 | Intact; Word shows move tracking as in source. | Editing within a moved range is blocked because move ranges can cross structural boundaries; user must accept/reject in Word first for safe editing. citeturn14view0turn12search10 | Fixture: Word-generated “Move text” revision spanning multiple paragraphs. | preservation-layer, review-engine |
-| Tracked formatting changes (`rPrChange`, `pPrChange`) | preserve-only | Imported and retained; v1 does not attempt to interpret these revisions beyond marking them as “format change (preserved)”. citeturn12search11turn14view0 | Not exposed: cannot create new tracked formatting changes; cannot accept/reject these in v1. | Passthrough unchanged. citeturn12search11turn14view0 | Intact; Word shows formatting revisions. | If a user edits a paragraph/run that contains formatting-change revisions, v1 blocks the edit unless the user first accepts/rejects formatting changes in Word. citeturn12search11turn14view0 | Fixture: toggle bold with “Track formatting” enabled in Word; reopen after v1 view-only. | preservation-layer, review-engine |
-| Comments on deleted text (edge case) | preserve-only | Imported: comment anchors and deletions may overlap; v1 preserves the exact marker placement and renders comment thread with an indicator “anchored to deleted text”. citeturn16search0turn12search5turn16search1 | Not editable: v1 blocks edits that would require re-anchoring comments whose anchor text is deleted. | Passthrough: preserves overlap in markup. | Word behavior varies by view; Word can hide comments associated with text marked for deletion in Track Changes views. citeturn16search0turn16search8 | This is a known Word UX behavior; v1 preserves data but cannot force Word to display hidden comments in certain markup views. citeturn16search0turn16search8 | Fixture: comment anchored to a word, then that word is deleted with Track Changes on. | preservation-layer, comment-engine |
-| Edits inside commented ranges (edge case) | supported-roundtrip | For single-paragraph comment ranges only: v1 updates anchor offsets deterministically as text is inserted/deleted inside the range. citeturn16search1turn16search14 | Partially editable: allowed within same paragraph; if edit would cause range to cross paragraphs or opaque nodes, edit is blocked. | Native: emits updated comment range markers positions. citeturn16search1turn16search3 | Intact. | Multi-paragraph comment ranges are preserve-only (next row). citeturn16search7 | Fixture: insert text mid-range; delete part of range; add reply. | comment-engine, editor-core |
-| Multi-paragraph comment ranges | preserve-only | Imported and preserved as opaque “comment-range spanning blocks” because start/end markers can cross complex nestings. citeturn16search7turn16search14 | Not exposed: cannot create/edit multi-paragraph comment ranges. | Passthrough unchanged. | Intact. | v1 UI still shows the comment thread, but highlight mapping in-browser is simplified (e.g., highlights first paragraph only) while preserving OOXML anchors. | Fixture: comment spanning two paragraphs in Word. | preservation-layer, comment-engine |
-| Revisions overlapping lists (edge case) | preserve-only | Imported revisions that structurally affect numbering/list properties (e.g., numbering changes) are preserved. Numbering changes can be tracked with dedicated elements like `numberingChange`. citeturn1search8turn7search17 | Not exposed: v1 blocks operations that would create list-structure revisions beyond run-level insert/delete inside a list item. | Passthrough (including `numberingChange` if present). citeturn1search8 | Intact. | v1 supports redlines **within** list item text, but does not support tracked changes that alter list definitions/levels as revisions. citeturn1search8turn7search13 | Fixture: change list level/numbering style with Track Changes on in Word. | preservation-layer, review-engine, numbering-engine |
-| Revisions overlapping tables (edge case) | preserve-only | Imported structural table revisions (row insert/delete, cell merge revisions) are preserved; table row insertion/deletion revisions use `ins`/`del` on row properties. citeturn3search4turn3search5turn1search5 | Not exposed: v1 blocks table structural edits when Track Changes on; only run-level insert/delete inside cell paragraphs is supported. | Passthrough. citeturn3search4turn3search5 | Intact. | Accept/reject for these structural table revisions is disabled in v1; use Word for that operation. citeturn3search4turn3search5turn14view0 | Fixture: insert/delete table row with Track Changes on; cell merge with Track Changes. | preservation-layer, review-engine, table-engine |
-| Nested revisions (edge case) | preserve-only | Imported nested/overlapping `w:ins`/`w:del` structures are preserved as-is; v1 does not normalize by rewriting. citeturn13search0turn12search5turn3search17 | Not exposed: cannot edit inside nested revision regions; cannot accept/reject them in v1. | Passthrough unchanged. | Intact. | Nested revisions can be semantically involved (many elements participate in revision tracking); v1 intentionally avoids rewriting to prevent corruption. citeturn3search17turn14view0 | Fixture: multiple authors produce nested revisions; ensure v1 preserves and reopens in Word. | preservation-layer, review-engine |
-| Deleting content with comments attached (edge case) | supported-roundtrip | v1 supports tracked deletions of text inside a comment range; the comment anchor range is updated if it remains within the same paragraph and not fully deleted. citeturn16search1turn12search5turn16search0 | Partially editable: if deletion would remove the entire anchor, v1 prompts and requires explicit action: “Delete comment too” or “Cancel deletion.” | Native: either (a) delete comment and remove markers, or (b) block deletion to keep anchor, matching Word’s anchoring constraint that deleting anchor text often deletes the comment. citeturn16search2turn16search6 | Intact per chosen action. | Word commonly deletes comments when the anchored text is deleted unless a workaround keeps at least one anchored character; v1 exposes this explicitly to prevent silent loss. citeturn16search2turn16search6 | Fixture: delete entire commented phrase with Track Changes on/off; verify comment retention rules. | comment-engine, review-engine |
-| Mixed formatting within revisions (edge case) | supported-roundtrip | Inserted/deleted content can contain runs with independent formatting; v1 imports runs inside `w:ins` and `w:del` normally. citeturn13search0turn12search5turn5search6 | Editable: formatting can be applied inside inserted text; formatting across inserted/deleted boundaries is supported as direct formatting (not as tracked formatting change). | Native: emits formatting as run properties within revision containers. citeturn5search6turn13search0 | Intact. | v1 never creates `rPrChange` to represent formatting changes as tracked revisions; Word will show formatting but not as a tracked “format change.” citeturn12search11turn14view0 | Fixture: insert bold text; delete italic text; accept/reject. | editor-core, review-engine, serializer |
-
-### Document structure
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Section breaks and section properties (`w:sectPr`) | preserve-only | Imported and preserved; OOXML locates section properties at the end of the section (often in last paragraph) and final `sectPr` as child of body. citeturn1search2turn2search3 | Not exposed: cannot insert/delete section breaks in v1. | Passthrough: emits section properties exactly as imported. citeturn1search2 | Intact; Word maintains page layout, margins, columns defined by sections. | Because section breaks affect pagination and headers/footers, v1 treats them as immutable to avoid breaking the document layout graph. citeturn1search2turn3search2 | Fixture: contract with multiple sections (portrait/landscape), continuous break, different header/footer. | preservation-layer, section-engine |
-| Headers and footers (references and parts) (`w:headerReference`, `w:footerReference`, header/footer parts) | preserve-only | Imported and preserved: section `sectPr` references header/footer parts via relationship ids. citeturn3search2turn3search6turn3search18 | Not exposed: cannot edit header/footer content in v1. | Passthrough: preserves header/footer parts and relationships. citeturn3search2turn3search6turn15search3 | Intact; page numbers, logos, etc. preserved. | Headers/footers often include fields (PAGE/NUMPAGES) and layout constructs; v1 preserves but does not update fields. citeturn2search6turn3search18 | Fixture: page numbering in footer + “FIRST” header; reopen and verify. | preservation-layer, header-footer-engine |
-| Footnotes (references + footnote part) | preserve-only | Imported and preserved: footnotes have reference marks in body and a footnote story part with `footnote` elements. citeturn1search11turn1search7 | Not exposed for editing in v1: footnote content is readable (rendered in a side panel/popover) but locked. | Passthrough for footnotes part and references. citeturn1search11turn1search7 | Intact. | Footnote placement/numbering is controlled by Word; v1 does not add/remove footnotes and does not validate advanced conformance constraints beyond preserving what was imported. citeturn1search11turn1search3 | Fixture: contract with multiple footnotes; footnote inside table cell. | preservation-layer, notes-engine |
-| Endnotes (references + endnote part) | preserve-only | Imported and preserved; endnote references use `endnoteReference`. citeturn1search3turn1search11 | Not exposed (same behavior as footnotes). | Passthrough unchanged. citeturn1search3 | Intact. | Spec notes conformance constraints (e.g., endnote references inside notes can be non-conformant); v1 preserves but will not create new such constructs. citeturn1search3 | Fixture: endnotes at end of document; mixed footnotes/endnotes. | preservation-layer, notes-engine |
-
-### Advanced and edge features
-
-| Feature Name | Support Class | Import Status | Edit Status | Export Status | Reopen in Word Behavior | Known Caveats | Fixture Coverage | Owner |
-|---|---|---|---|---|---|---|---|---|
-| Fields (simple fields `w:fldSimple`) | preserve-only | Imported and preserved as opaque inline nodes; v1 renders the current field result text but does not interpret field codes. Fields can be represented using `fldSimple`. citeturn2search2turn2search6 | Not exposed: cannot insert/update fields in v1. | Passthrough: preserves original field XML and existing field result runs. citeturn2search2turn2search6 | Intact; Word updates field results when user updates fields. | Since v1 does not recompute field results, any changes to surrounding text may require Word to update fields for correct display (TOC, page numbers, cross refs). citeturn2search6turn9search17 | Fixture: PAGE/REF/TOC/SEQ fields; reopen and update fields in Word. | preservation-layer |
-| Fields (complex fields via `w:fldChar` + `w:instrText`) | preserve-only | Imported and preserved as opaque inline sequences; v1 does not attempt to restructure begin/separate/end runs. citeturn2search6turn2search10turn6search10 | Not exposed. | Passthrough unchanged. citeturn2search10turn2search6 | Intact. | Editing inside a complex field region is blocked; user must edit in Word or convert field to text there. citeturn2search10turn2search6 | Fixture: TOC field, REF field cross-reference, DATE field, hyperlink-as-field variants. | preservation-layer |
-| Content controls (SDTs) block-level (`w:sdt` block) | preserve-only | Imported as opaque blocks: SDT properties and content preserved. SDTs encapsulate block-level structures via `sdtPr` and `sdtContent`. citeturn19search11turn2search11 | Not exposed: v1 does not create or edit content control properties; content inside SDT is locked in v1 to avoid breaking bindings/locks. | Passthrough unchanged. citeturn19search11turn2search11 | Intact. | Locked SDTs can be “undeletable” or behave unexpectedly across clients when combined with track changes/comments; v1 avoids editing them. citeturn12search13turn2search11 | Fixture: template doc with content controls (repeating sections, locked sections). | preservation-layer |
-| Content controls (SDTs) inline-level (`w:sdt` inline) | preserve-only | Imported as opaque inline nodes. citeturn19search19turn2search11 | Not exposed. | Passthrough unchanged. citeturn19search19 | Intact. | Same as block SDTs: editing inside is blocked. | Fixture: inline SDTs around party names/defined terms. | preservation-layer |
-| Embedded objects (`w:object`, OLE, VML positioning) | preserve-only | Imported as opaque inline objects; `w:object` indicates embedded object and positioning is via VML. citeturn19search0turn19search16 | Not exposed; displayed as placeholder. | Passthrough: preserves object parts, relationships, and VML. citeturn19search0turn15search3 | Intact; Word shows embedded object. | Embedded objects can include additional linked field codes; v1 preserves but does not validate them. citeturn19search8turn19search0 | Fixture: embedded Excel object; embedded Visio; reopen in Word. | preservation-layer, media-manager |
-| External content imports (`w:altChunk`) | preserve-only | Imported and preserved as opaque block; `altChunk` anchors external content to be imported by Word. citeturn19search1turn19search9 | Not exposed; cannot expand/convert altChunk in v1. | Passthrough unchanged. citeturn19search1 | Intact; Word may convert/import on open/save. | AltChunk behavior depends on Word processing; v1 does not “apply” the chunk. If the legal workflow requires editing imported content, open and save in Word first to materialize it. citeturn19search5turn19search1 | Fixture: doc with altChunk from HTML; reopen in Word to confirm non-damage. | preservation-layer |
-| Custom XML markup (`w:customXml` wrappers and custom XML parts) | preserve-only | Imported and preserved; custom XML can wrap inline runs, paragraphs, tables, rows, or cells. citeturn19search14turn19search6turn19search2 | Not exposed; editing inside customXml-wrapped regions is blocked unless the wrapper encloses only supported plain text and can be maintained without splitting (rare; disabled in v1). | Passthrough: preserves wrappers + associated custom XML parts and relationships. citeturn19search6turn15search3 | Intact. | Custom XML is frequently used for document assembly systems; splitting paragraphs/runs inside wrappers can break bindings, so v1 locks these regions. citeturn19search6turn19search14 | Fixture: doc assembly template with customXml tags around party names and clauses. | preservation-layer |
-| Unknown OOXML elements in body | preserve-only | Imported as opaque nodes at the smallest safe granularity (block or inline) and preserved as XML subtrees. Supported structures remain editable; unknown nodes are atomic. Markup compatibility constructs are preserved. citeturn15search0turn15search5turn15search1 | Not exposed: cannot edit inside unknown nodes; delete/cut allowed only as a whole-node operation. | Passthrough: exact subtree is re-emitted; ignorable namespaces and AlternateContent preserved. citeturn15search5turn15search1 | Intact in Word. | If an unknown node is removed, Word may lose that feature; v1 requires explicit user confirmation for deleting opaque nodes (“This may remove unsupported Word features”). citeturn15search0turn15search5 | Fixture: doc containing SmartArt/diagrams, custom namespaces, AlternateContent blocks. | preservation-layer |
-| Unknown OOXML parts/relationships in package | preserve-only | Imported into package manifest and preserved. OPC relies on parts, relationships, and content types; v1 preserves unknown relationships and parts unless it must rewrite `[Content_Types].xml` due to new media. citeturn15search3turn15search13turn15search2 | Not exposed. | Passthrough with minimal necessary updates for new parts (images/comments). citeturn15search3turn15search13 | Intact. | When new parts are added (e.g., images), v1 must update content types and relationships carefully; QA must validate Word opens without repair prompts. citeturn15search3turn15search13 | Fixture: doc with custom parts + add a comment + add an image; verify relationships remain valid. | preservation-layer, serializer |
-| Malformed OOXML (not well-formed XML, broken relationships/content types) | unsupported-fatal | Import validates: XML must be well-formed; relationship targets must be resolvable enough to preserve. | Not editable; v1 opens in “read-only diagnostics” mode only and blocks export. | No export permitted. | N/A (export blocked). | This is the only safe stance for high-integrity legal workflows: emitting a repaired guess risks silent corruption. citeturn15search3turn15search13 | Fixture: intentionally corrupted `.docx` with missing rel target / malformed XML. | docx-parser, serializer |
-
-## Safety guarantees and scope boundaries
-
-### Guaranteed safe features
-
-The following are guaranteed **supported-roundtrip** in v1 (import → edit within stated bounds → export → reopen in Word intact):
-
-- Paragraphs, runs/text, whitespace preservation, hard line breaks, tabs. citeturn6search3turn4search7turn6search14  
-- Headings via paragraph style references (no style editing). citeturn18search0turn18search2  
-- Inline formatting: bold, italic, underline (default style), strikethrough. citeturn5search0turn5search8turn6search0turn5search7  
-- Lists (including nested) and explicit restart numbering. citeturn7search17turn7search13turn7search0  
-- Tables: table body structure, merged cells preserved, cell text editing safe. citeturn8search0turn2search4turn1search1  
-- Inline images (`wp:inline`). citeturn3search3turn3search11  
-- Hyperlinks (external via relationships). citeturn2search1turn0search7turn15search3  
-- Comments (single-paragraph ranges), replies (threading), and resolution state. citeturn16search1turn11search7turn10search1  
-- Tracked insertions and deletions (run-level and paragraph-mark level) and accept/reject for those types. citeturn13search0turn12search5turn14view0  
-
-### Preserve-only features
-
-These features are preserved and roundtrip to Word, but are not editable (or are editable only as atomic objects):
-
-- Section breaks and section properties, headers/footers, footnotes/endnotes. citeturn1search2turn3search2turn1search11  
-- Fields (simple and complex). citeturn2search2turn2search6turn2search10  
-- Content controls (SDTs). citeturn19search11turn19search19  
-- Embedded objects (OLE/VML), floating/anchored drawings, altChunk, custom XML wrappers. citeturn19search0turn3search3turn19search1turn19search6  
-- Tracked moves, tracked formatting changes, tracked structural revisions for tables/lists beyond run-level insert/delete inside content. citeturn12search10turn12search11turn3search4turn1search8  
-- Unknown OOXML in body or unknown package parts/relationships (opaque preservation). citeturn15search0turn15search5turn15search3  
-
-### Known risk areas
-
-These are specifically called out for engineering and QA because they can produce subtle corruption if mishandled:
-
-- **Comments vs deletions**: Word may hide comments anchored to deleted text in certain Track Changes views; v1 preserves the markup but cannot control Word UI behavior. citeturn16search0turn16search8  
-- **Multi-paragraph comment ranges**: marker placement can cross complex XML nesting; v1 preserves but does not edit. citeturn16search7turn16search14  
-- **Structural revisions in tables/lists**: OOXML uses specialized revision elements (e.g., row ins/del, numberingChange, cellMerge). v1 preserves but does not author or accept/reject them. citeturn3search4turn1search8turn1search5  
-- **Markup compatibility**: incorrect handling of `mc:AlternateContent` (e.g., dropping unchosen branches) can destroy content; v1 preserves all branches. citeturn15search5turn15search1  
-- **OPC relationship integrity**: any serializer bug in relationships or content types can trigger Word repair dialogs. citeturn15search3turn15search13turn15search2  
-
-## Test fixture map for QA and interoperability
-
-This section defines the **required `.docx` fixtures** that QA must maintain. Fixtures are intentionally legal-workflow-shaped (contracts, exhibits, redlines) and must be validated by:  
-(1) import → (2) edit operations → (3) export → (4) reopen in Word and confirm no repair + intended display.
-
-| Fixture ID | Fixture name | Required contents | Primary features validated |
-|---|---|---|---|
-| F01 | Basic contract skeleton | 10–20 paragraphs, mixed runs, leading/trailing whitespace cases | Paragraphs, runs/text, whitespace preservation, split/merge paragraphs citeturn6search3turn6search14 |
-| F02 | Headings and styles contract | Heading 1–4, custom paragraph styles, outline level present in some styles | Headings, `pStyle`, style preservation citeturn18search0turn18search7 |
-| F03 | Legal outline numbering | Multi-level numbered list (1., 1.1, (a), (i)), nested bullets | Lists, nested lists, numbering preservation citeturn7search13turn7search17 |
-| F04 | Restart numbering schedules | Two separate numbered lists restarting at 1; one uses `startOverride` | Restart numbering, overrides citeturn7search0turn7search6 |
-| F05 | Table-heavy agreement | 3–5 tables with borders, fixed grid columns, long text in cells | Basic tables, tblGrid preservation, cell paragraph validity citeturn8search0turn2search8turn8search12 |
-| F06 | Merged-cells signature table | Horizontal `gridSpan` merges + vertical `vMerge` merges | Merged cells preservation citeturn2search4turn1search1 |
-| F07 | Inline images exhibit | Inline logo and scanned signature images | Inline images + OPC rel correctness citeturn3search11turn15search3 |
-| F08 | Hyperlinks exhibit list | External hyperlinks (http/https/mailto) in body and in a table cell | Hyperlink import/edit/export + rels citeturn2search1turn15search3 |
-| F09 | Comments anchored single paragraph | Several comments with overlapping ranges inside one paragraph; edit inside ranges | Comment anchors (single-paragraph) + edits inside range citeturn16search1turn16search14 |
-| F10 | Threaded comments and resolve | Root comment + 2 replies, resolved/done state set, mix of authors | Replies via commentsExtended + done flag citeturn11search7turn10search1 |
-| F11 | Redlines basic | Insertions, deletions, mixed formatting within revisions, accept/reject flows | `w:ins`/`w:del`, accept/reject, mixed formatting in revisions citeturn13search0turn12search5turn14view0 |
-| F12 | Redlines paragraph joins/splits | Delete a paragraph mark; insert paragraph mark; accept/reject | Paragraph mark ins/del semantics citeturn3search1turn12search8 |
-| F13 | Comments on deleted text | Comment anchored to a word that is later deleted under Track Changes | Edge case: comment+deletion overlap; Word visibility caveat citeturn16search0turn12search5 |
-| F14 | Revisions in tables and lists | Table row inserted/deleted with Track Changes; numberingChange present | Preserve-only structural revisions; ensure no damage on roundtrip citeturn3search4turn1search8 |
-| F15 | Sections + headers/footers | Two sections with different header/footer, page numbers fields | Preserve-only sections + headers/footers + fields citeturn1search2turn3search2turn2search6 |
-| F16 | Footnotes and endnotes | Multiple footnotes and endnotes; references in body and in table | Preserve-only notes; rendering/read-only behavior citeturn1search11turn1search3 |
-| F17 | Fields and TOC | TOC (complex field), cross-references, PAGE fields in footer | Preserve-only fields; ensure no structural damage citeturn2search6turn2search10 |
-| F18 | Content controls template | SDT blocks and inline SDTs with locking properties | Preserve-only SDTs; locked editing enforcement citeturn19search11turn19search19 |
-| F19 | Custom XML doc assembly | `w:customXml` wrappers around paragraphs/runs, custom XML parts | Preserve-only custom XML; block edits inside wrappers citeturn19search6turn19search14 |
-| F20 | Unknown OOXML and AlternateContent | `mc:AlternateContent`, ignorable namespaces, SmartArt/diagrams | Unknown OOXML preservation + markup compatibility rules citeturn15search5turn15search1turn3search19 |
-| F21 | Malformed/broken docx | Missing relationship target and/or malformed XML | Unsupported-fatal behavior (block export) citeturn15search3turn15search13 |
-
-This fixture set is the minimum required for the matrix above. Any new feature request must (a) add rows to the matrix and (b) add at least one new fixture or extend an existing fixture with explicit Word reopen assertions.