cli-v0.20.0

What's New

• Footnotes and endnotes — Double-click reference markers to navigate to notes; delete from either side removes both marker and note; insert via editor.commands.insertFootnote(); caret and arrow navigation track correctly in multi-paragraph notes.
• Textbox selection, resize, and move — Click within 6px of a textbox border to select it; resize with corner handles and live feedback; drag to move with margin-offset preservation in body, headers, and footers.
• Document API — image manipulation — New operations for crop, rotate, scale, flip, and replace-source; full control over alt text, captions, z-order, wrapping, and anchor; TIFF support added.
• Document API — hyperlinks — New operations for insert, wrap, list, patch, and remove; pasted URLs automatically convert to real DOCX link elements.
• Document API — list operations — New operations for apply, continue, restart, remove, and getState; control bullets, numbering, alignment, marker fonts, and indentation per level.
• Document API — block operations — blocks.merge preserves first paragraph properties; blocks.split and blocks.move return affected ranges and transaction IDs.
• Document API — paragraph numbering — format.paragraph.setNumbering attaches numbering to paragraphs; blocks.list surfaces list state; format.paragraph.setMarkRunProps controls marker appearance.
• Search in tracked deletions — Find & Replace now searches text within deleted tracked changes, not just insertions.
• Cross-reference navigation — Double-click a REF or NOTEREF field pointing at a footnote or endnote to navigate to that note.
• Mutations planning — mutations.planExecute plans and executes mutations in a single operation with per-entry transactions and failure semantics.
• HTML extraction — New getHtml operation to read document content as HTML.
• Vector shape improvements — Outer shadow effects on shapes; shape-group transforms with rotation and flip; images clipped to preset shape geometry; improved anchoring and z-order; Word-compatible preset geometry.

Improvements

• List rendering — First-line indent lists compute marker suffix tab width from actual rendered tab stops; justified text width is now correct.
• Footnote performance — Warm-start reserve convergence reduces keystroke cost on 25-footnote documents from 75ms to 12ms; single pagination per keystroke instead of nine.
• Editor performance — Block-node metadata transactions no longer trigger full-document numbering diffs; saves ~16ms per keystroke on 776-paragraph documents.
• Toolbar refresh — Coalesce headless toolbar snapshots per microtask to eliminate redundant rebuilds.
• IME composition — Defer layout rerender and track-changes rewriting during input method editing to prevent conflicts.
• Font configuration — Malformed fonts.bundled configuration no longer crashes; defaults to full bundled pack with warning.
• Track changes — Cross-paragraph deletes no longer split paragraphs in suggesting mode; position mapping no longer crashes; accept/reject now reports which decision was taken.
• URL paste detection — Auto-linking now requires explicit URL intent (www., http(s)://, mailto:, tel:, sms:) to prevent plain text or relative paths from being mistakenly linked.

Fixes

• Footnotes rendering — Terminal-page reserve bump ensures footnotes render when body fills last page.
• Note caret and selection — Multi-paragraph notes now track caret and selection correctly; arrow navigation no longer skips lines; goal-column preserved across presses.
• Note paragraph styles — FootnoteText style now preserved on Enter, paste, and every paragraph-creation path.
• Header/footer activation — Double-click resolves note references only in body fragments; header/footer with behindDoc textboxes no longer break.
• Tracked-change review — Navigation no longer jumps and leaves the UI in inconsistent states.
• Comment behavior — Repaired regression in comment behavior after recent refactors.
• Format persistence — w:caps now persists on export via text transform.
• List export — Document XML syncs before numbering pruning to preserve list definitions.
• Image resize handles — Alignment with actual image position corrected.
• Link popover rendering — Popovers mount outside overflow:hidden containers to prevent clipping.
• Security — Remediated critical and high penetration test findings.