Add PDF annotation convenience APIs

[messense]

No description provided.

[Copilot]

Pull request overview

This PR expands the PDF annotation API surface with higher-level “convenience” constructors and additional annotation property accessors/mutators, plus redaction helpers and supporting FFI wrapper functions.

Changes:

• Add PdfPage::*add_*_annotation() helpers (line, polygon/polyline, ink, text markup, stamp, redact) and redaction application helpers with options.
• Extend PdfAnnotation with additional getters/setters (geometry, colors, flags, opacity, border, quad points, ink list, default appearance, etc.) and improve detached-annotation handling.
• Harden string decoding by returning Error::InvalidUtf8 instead of panicking on invalid UTF-8.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/pdf/page.rs	Adds annotation-creation convenience APIs, redaction helpers, and stricter delete_annotation validation.
src/pdf/annotation.rs	Adds many annotation accessors/mutators, redaction option types, quad/area helpers, and detached-annotation checks.
src/pdf/tests_annotation.rs	Adds tests covering new annotation conveniences, geometry roundtrips (incl. rotation), redaction behavior, and error cases.
src/pdf/object.rs	Avoids panics by returning Error::InvalidUtf8 on invalid UTF-8 conversion.
src/pdf/mod.rs	Re-exports newly introduced annotation/redaction types.
src/color.rs	Adds derives to AnnotationColor to support comparisons in new tests.
mupdf-sys/wrapper/pdf_page.c	Adds wrapper for redaction with options.
mupdf-sys/wrapper/pdf_annot.c	Adds wrappers for new annotation APIs and improves error handling for detached annotations during filtering.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.