fix: consider rich table cell refs in tree operations

[vagenas]

Fix: Consider rich table cell refs during tree operations

This commit fixes an issue where tree operations weren't handling references from RichTableCell objects, causing broken document hierarchies.

Changes:

1. Updated _shift_up: When removing a node, updates any table cell references to point to the node's child instead (errors if the node has multiple or no children).
2. Updated _shift_down: Updates table cell references to point to the new wrapper node before moving the subtree.
3. Updated _move_subtree: Prevents moving nodes that are referenced by table cells.
4. Improved fix_misplaced_list_items auto-healing: Uses updated _shift_down and _move_subtree instead of deleting and recreating items, which preserves references correctly.

Tests:

• Added 3 test cases for rich table cell reference handling
• Updated expected output for misplaced list items test

[mergify]

Merge Protections

🔴 1 of 2 protections blocking · waiting on 👀 reviews

	Protection	Waiting on
🔴	Require two reviewer for test updates	👀 reviews
🟢	Enforce conventional commit	—

🔴 Require two reviewer for test updates

Waiting for

• #approved-reviews-by >= 2

This rule is failing.

When test data is updated, we require two reviewers

• #approved-reviews-by >= 2

---

Show 1 satisfied protection

🟢 Enforce conventional commit

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?(!)?:

[github-actions]

✅ DCO Check Passed

Thanks @vagenas, all your commits are properly signed off. 🎉

[codecov]

Codecov Report

❌ Patch coverage is 89.47368% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
docling_core/types/doc/document.py	89.47%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!

[ceberam]

@vagenas there is a conflict with test_docling_doc.py

In the meantime...Besides nodes referenced by rich table cells, what about items referenced by a GraphCell or those referenced by a FloatingItem through captions, references, or footnotes ?