feat: work through the 2.0.0 milestone — 26 issues

[toxicphreAK]

Works through the 2.0.0 milestone: 26 of the 30 open issues implemented, the other
four assessed and left open with a reason.

What landed

Tables — _Row.repeat_as_header and the rest of w:trPr (#106); Table.look,
the w:tblLook flags without which a styled table looks nothing like Word's preview
(#97); Table.width including percentages, .indent and .cell_margins (#107);
add_table(title=, description=) (#138).

Paragraphs and sections — ParagraphFormat.mark_font, the paragraph mark's own run
properties and the only place an empty paragraph's formatting lives (#105);
character-unit indents and line-unit spacing, plus the w:start/w:end spellings Word
now writes (#104); bidi and text_direction on paragraphs, sections and cells (#108);
ParagraphFormat.borders and Section.page_borders (#123).

Parts that were never loaded — the theme part and Font.theme_typeface, which is
the first way to find out what a document whose fonts come only from its theme is
actually rendered in (#96); endnotes (#94); the custom XML data store (#100); the VBA
project as bytes, with the content-type coupling both ways (#127).

Content that was unreachable — InlineShape.image and Document.images (#124);
OMML equations (#95); embedded OLE objects (#101).

Styles — w:docDefaults (#99); the reachability closure behind Styles.usage(),
Style.in_use and Styles.unused (#114); Styles.remove_unused(),
LatentStyles.trim() and Document.cleanup() on top of it (#115);
Styles.import_from(), .extract() and .extract_xml() (#116).

Content operations — copy_to() on paragraphs, runs, rows and tables, with the
relationship remapping, drawing-id reassignment and bookmark handling a hand-written
deep copy gets wrong (#112); writable numbering definitions (#98); the caption API
(#102).

Images — EXIF Orientation honoured on insert, as a rotation in the DrawingML
rather than in the pixels (#125).

The bundled template — the Word-authored Hyperlink, CommentText,
CommentTextChar and CommentReference definitions adopted (#117), and 447 KB of
parts no generated document needs removed (#113).

Tooling — a python -m docx CLI over the inspection and cleanup operations (#118).

Decisions worth reading

• Equation text is deliberately not in Paragraph.text (Expose OMML equation content (m:oMath) - equations are silently dropped from Paragraph.text #95). Including it would
  describe the document more truthfully, but replace_text() measures offsets against
  .text and can only cut at run boundaries; text it cannot reach would mis-target
  every replacement after the first equation in a paragraph.
• A copied bookmark is dropped, not duplicated (Add a copy API for paragraphs, runs, rows and tables #112). A bookmark name is
  document-wide, so a duplicate is a second bookmark competing for anything that refers
  to the name.
• Caption bookmark names come from a counter, not a timestamp (Add a caption API on top of the SEQ field and bookmark support #102), so the same
  document still serializes to the same bytes.
• w:nsid and w:tmpl are not written for a new numbering definition (Make numbering definitions writable - define a list from scratch #98).
  Inventing them would claim a provenance the definition does not have.

Behaviour changes

Three, all in HISTORY.rst. The visible one: links in newly created documents are
theme-coloured rather than hardcoded blue, because add_hyperlink() now resolves the
real Word definition instead of synthesising one.

Not implemented

• Word Default Template #23 Word Default Template — needs a Word session to author the styles. Default template ships 447 KB of parts no generated document needs #113 and
  Adopt the Word-authored Hyperlink, CommentText and CommentReference style definitions #117 split out and landed the parts that did not.
• Charts: record the decision (not planned for 2.x) #126 Charts — filed to record a decision. The issue's own position is "not planned
  for 2.x"; nothing here changes that.
• Read and decompress VBA module source, behind an optional [vba] extra #128 VBA module source — blocked on a real macro fixture, as the issue says. The
  27-byte vbaProject.bin in the repo is a stub with no valid OLE signature.
• Far future: a pure-Python OLE compound file layer — read, manipulate and write #129 pure-Python OLE compound file layer — explicitly far future, and its stated
  prerequisites (Read and decompress VBA module source, behind an optional [vba] extra #128 landed, a real fixture, a decision on where the layer lives) are
  not met.

Checks

ruff check . clean, 2872 unit tests and 677 behave scenarios passing on both Python
3.9 and 3.12. A self-review pass found and fixed two defects — a shape-id collision
between embedded objects, and a KeyError from InlineShape.image on an unresolvable
relationship — plus three smaller points; each has a regression test, in the last
commit.

Review note

Ten commits, ~10k lines. Individually coherent, but this would normally have been
several PRs.