Initial commit: FoFreeXit Phase 1 (Viewer) + Phase 2 (Annotate)

PDF viewer (render/search/text-select/thumbnails/outline) and annotation engine (Highlight/Underline/Strikeout/Square/FreeText/Note) over PDFium + lopdf, with Unicode font embedding for Vietnamese text and undo/redo.
2026-06-17 22:34:06 +07:00
commit 274012f854
52 changed files with 28479 additions and 0 deletions
@@ -0,0 +1,30 @@
+//! ff-engine — engine xử lý PDF của FoFreeXit.
+//!
+//! Phase 1: bọc PDFium (qua crate `pdfium-render`, tải động `pdfium.dll`)
+//! để mở tài liệu, đếm trang và render trang ra ảnh. Các module edit/io/font/
+//! ocr... sẽ thêm dần ở các phase sau (xem docs/03-roadmap.md, 04-architecture.md).
+
+pub mod annot;
+pub mod meta;
+pub mod render;
+pub mod text;
+
+pub use annot::{
+    apply_annotations, count_annotations, list_annotations, AnnotInfo, AnnotKind, AnnotSpec,
+};
+pub use meta::{outline, page_dims, OutlineItem, PageDim};
+pub use render::{bind_pdfium, page_count, render_page_png, PageImage};
+pub use text::{extract_text, page_char_boxes, search, CharBox, Rect, SearchHit};
+
+/// Lỗi cấp engine.
+#[derive(Debug, thiserror::Error)]
+pub enum EngineError {
+    #[error("không tìm thấy thư viện PDFium. Đặt biến môi trường FOFREEXIT_PDFIUM_PATH trỏ tới thư mục chứa pdfium.dll, hoặc chạy `scripts/fetch-pdfium`. Chi tiết: {0}")]
+    PdfiumNotFound(String),
+
+    #[error("lỗi PDFium: {0}")]
+    Pdfium(String),
+
+    #[error(transparent)]
+    Io(#[from] std::io::Error),
+}