feat(DocItem): Add comments field for linking annotations to document…

[s1v4-d]

… items

Implements support for linking comments (from Word/PPT documents) to their annotated content using the established FloatingItem/RefItem pattern.

Changes:

• Add comments: List[RefItem] field to DocItem class
• Update _update_breadth_first_with_lookup() to handle comment references on deletion
• Bump CURRENT_VERSION to 1.9.0
• Fix version comparison bug (string vs integer for minor version)
• Add 4 new tests for comments functionality
• Update test data files for new schema

Closes: docling-project/docling#464
Related: docling-project/docling#2834

[github-actions]

✅ DCO Check Passed

Thanks @s1v4-d, all your commits are properly signed off. 🎉

[dosubot]

Related Documentation

Checked 7 published document(s) in 0 knowledge base(s). No updates required.

^{How did I do? Any feedback?}  

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

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)(?:\(.+\))?(!)?:

🟢 Require two reviewer for test updates

Wonderful, this rule succeeded.

When test data is updated, we require two reviewers

• #approved-reviews-by >= 2

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[vagenas]

Added couple improvements:

• introduced fine-granular references (FineRef) including span ranges
• extended API with add_comment() operation encapsulating all relevant labels etc.
• improved serialization to suppress empty .comments lists (most common case)