[satoryu]

Bug (#197)

TextRun#text= only wrote when the run had exactly one w:t, or none. Otherwise it silently did nothing. Runs with several w:t are common:

• LibreOffice and macOS textutil write text<w:br/>text in one run.
• A hyperlink made of several runs is wrapped as a single TextRun.

As a result, Paragraph#text= on such a single-run paragraph and Bookmark#insert_text_before/after next to such a run silently did nothing.

Fix

TextRun#text= replaces the text from the first through the last w:t:

• The content goes into the first w:t. The other w:t, and any w:br / w:tab / w:cr between them, are removed. #text never includes breaks or tabs, so a plain string can't say where they belong.
• Breaks outside that range are kept, for example a trailing page break (<w:br w:type="page"/>), as are w:rPr, drawings and fields.
• A run with a single w:t behaves exactly as before.
• The doc comment points to Paragraph#substitute for edits that need line breaks to stay in place.

Bookmark#insert_text_before/after no longer go through text=. With the change above, text= would delete the adjacent run's line breaks just to add a few characters. Instead they write into the w:t right next to the bookmark: the end of the preceding run, or the start of the following one. When that run ends or starts with a break or tab, a new w:t is added on the bookmark's side of it. This also fixes an existing bug: on a run like <w:t>a</w:t><w:br/> before the bookmark, the text used to land before the break, on the wrong side.

remove_separators_between moved from Paragraph into Container (private), so Paragraph#substitute and TextRun#text= share it. No public API is added; the new constants and helpers are private.

Tests

• text_run_spec:
  • several w:t with breaks and tabs between them → replaced, separators removed, formatting kept
  • a leading break and a trailing page break → kept
  • hyperlink made of two runs → replaced
• paragraph_spec: #text= on a single run holding several w:t.
• bookmark_spec, with the adjacent run holding several w:t:
  • insert_text_after → Xa<br>b
  • insert_text_before → a<tab>bX
  • the run ends with a break → a<br>X
  • the run starts with a break → X<br>a, with w:rPr still first

The full suite passes (293 examples), including the existing bookmark integration specs on real files.

Closes #197

🤖 Generated with Claude Code