Phase 4 Iteration 3: reflow đoạn văn 'như Word' (EditOp::ReflowText)

Engine:
- EditOp::ReflowText { indices, text }: engine tự suy hình học từ các run
  (lề trái/bề rộng từ bounds, baseline từ matrix.f gom cụm ±1pt, khoảng cách
  dòng = median hiệu baseline); bẻ dòng greedy đo bằng hmtx của font thật
  (fontmatch::wrap_lines + char_advance, ttf-parser); \n = ngắt dòng cứng,
  từ quá dài cắt theo ký tự, dòng rỗng giữ nhịp baseline
- Giữ font theo thang 4 mức nhất quán với iteration 2: (1) font nhúng parse
  được + phủ đủ glyph → nhúng lại chính bytes đó; (2) family base-14 + ASCII
  → font chuẩn PDF qua FPDFText_LoadStandardFont (BaseFont giữ tên chuẩn,
  không nhúng, file không phình; đo bằng font metric-compatible); (3) font
  hệ thống cùng họ; (4) fallback. FontLoad enum Bytes/Builtin cho pha nạp font
- Dòng mới giữ phần tuyến tính matrix của run neo (scale/nghiêng), Tf =
  unscaled run neo → cỡ hiển thị không đổi

UI + Tauri:
- paragraphLines: gom đoạn nhiều dòng (baseline cách đều ±25%, cỡ chữ tương
  đồng, giao ngang ≥30%); double-click đoạn ≥2 dòng → textarea sửa CẢ ĐOẠN
  WYSIWYG (đúng font/cỡ/màu/kiểu + line-height đúng nhịp baseline)
- Enter = xuống dòng cứng · Ctrl+Enter/bấm ra ngoài = áp dụng · Esc = huỷ;
  1 commit = 1 op reflowText = 1 nấc undo
- DTO reflowText (indices) trong Tauri

Test: 3 integration mới (wrap giữ font nhúng + tiếng Việt + baseline đều;
hard break; base-14 giữ BaseFont Helvetica chuẩn) + 3 unit wrap_lines.
Toàn bộ suite engine ngoài qpdf: 52/52 xanh.

Docs: 12 (Iteration 3 + giới hạn v1), 13 (E26–E30), 14 (mục 3.1 → đã giải,
cập nhật thứ tự việc tiếp theo), README.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HgnbPwSoRGNH7LHsDUmRpk

docs/12-phase4-summary.md

@@ -1,8 +1,57 @@
-# 12 — Tổng kết Phase 4 (Chỉnh sửa nội dung — Edit) · Iteration 1 + 2
+# 12 — Tổng kết Phase 4 (Chỉnh sửa nội dung — Edit) · Iteration 1 + 2 + 3
 
-> Trạng thái sau Iteration 2: **sửa text GIỮ NGUYÊN FONT (chuẩn Foxit)**.
-> 50/50 test engine xanh ngoài qpdf (14 test edit + 3 unit fontmatch + 33 test cũ).
-> Iteration 1: 43/43, đã chạy app thật + chụp ảnh xác minh.
+> Trạng thái sau Iteration 3: **sửa CẢ ĐOẠN với reflow "như Word" + GIỮ FONT**.
+> 52/52 test engine xanh ngoài qpdf (17 test edit + 6 unit fontmatch + 29 test cũ).
+
+## Iteration 3 — Reflow đoạn văn "như Word" (mới nhất)
+
+Đóng gap trải nghiệm cuối cùng của tính năng moat (mục 3.1 của
+`docs/14-foxit-gap-analysis.md`): double-click vào đoạn nhiều dòng → sửa cả
+đoạn trong 1 ô, chữ tự bẻ dòng lại theo bề rộng khối khi commit.
+
+### Engine — `EditOp::ReflowText { indices, text }`
+- Engine TỰ suy hình học từ các run: lề trái/bề rộng khối từ bounds, baseline
+  từ `matrix.f` (gom cụm ±1pt), khoảng cách dòng = median hiệu baseline
+  (1 dòng → 1.25× cỡ hiển thị) — UI chỉ cần gửi indices + text mới.
+- **Bẻ dòng đo bằng hmtx thật** (`fontmatch::wrap_lines` + `char_advance` qua
+  ttf-parser): greedy theo từ, `\n` = ngắt cứng, từ quá dài cắt theo ký tự,
+  dòng rỗng giữ nhịp baseline. Không kerning (chấp nhận v1, nới 2%).
+- **Giữ font theo thang 4 mức** (nhất quán triết lý iteration 2):
+  1. Font NHÚNG parse được + phủ đủ glyph → nhúng lại chính bytes đó (glyph y hệt);
+  2. Family nhóm base-14 (Helvetica/Times/Courier + Arial alias) + text ASCII →
+     **font chuẩn PDF qua `FPDFText_LoadStandardFont`** — BaseFont giữ tên chuẩn,
+     KHÔNG nhúng, file không phình; đo width bằng font metric-compatible
+     (Liberation/Arial);
+  3. Font hệ thống cùng họ (coverage-checked); 4. fallback mặc định.
+- Dòng mới giữ phần tuyến tính matrix của run neo (scale/nghiêng), gốc tại
+  (lề trái, baseline thứ i); Tf = unscaled của run neo → cỡ hiển thị không đổi.
+- Đoạn dài ra thì các dòng mới nối xuống dưới theo đúng nhịp baseline (hành vi
+  tương tự Foxit khi khối text nở ra).
+
+### UI
+- Double-click: **đoạn ≥2 dòng → textarea sửa cả đoạn** (`paragraphLines` gom
+  dòng baseline cách đều ±25%, cỡ chữ tương đồng, giao ngang ≥30%); 1 dòng →
+  ô sửa dòng như iteration 2.
+- Textarea WYSIWYG: đúng font/cỡ/màu/kiểu + line-height đúng nhịp baseline;
+  nội dung khởi tạo = các dòng nối bằng khoảng trắng (đoạn chảy tự nhiên);
+  **Enter = ngắt cứng, Ctrl+Enter hoặc bấm ra ngoài = áp dụng, Esc = huỷ**.
+- 1 commit = 1 op `reflowText` = 1 nấc undo.
+
+### Test mới (3 integration + 3 unit)
+- `reflow_wraps_and_keeps_embedded_font` — đoạn 3 dòng font nhúng + text Việt
+  dài gấp mấy lần → bẻ >3 dòng, mọi dòng trong bề rộng khối, **font nhúng giữ
+  nguyên**, baseline đều 15pt±2, text cũ biến mất.
+- `reflow_hard_break_creates_new_line` — `\n` ra đúng 2 dòng cách 1 nhịp.
+- `reflow_base14_ascii_keeps_standard_font` — Helvetica không nhúng + ASCII
+  dài → nhiều dòng, **BaseFont vẫn "Helvetica" chuẩn** (builtin, không nhúng).
+- Unit `wrap_lines`: greedy theo từ / ngắt cứng + dòng rỗng / cắt từ quá dài.
+
+### Giới hạn ghi nhận (v1, sẽ nâng ở vòng sau)
+- Đoạn justify (giãn đều 2 lề) reflow về căn trái; chưa kerning; khối text
+  XOAY chưa reflow theo hướng xoay (dòng mới đặt theo trục ngang).
+- Khối lẫn NHIỀU font/cỡ trong 1 đoạn: dòng mới thống nhất theo run neo.
+
+> Iteration 1: 43/43 test, đã chạy app thật + chụp ảnh xác minh.
 
 ## Iteration 2 — Giữ font gốc + trải nghiệm Foxit (mới)
 

docs/13-phase4-user-tests.md

@@ -41,6 +41,15 @@ cargo run
 | E24 | Sửa text tiếng Việt trên file có font nhúng (file Word xuất PDF) | Đúng dấu **và giữ nguyên font nhúng** (mở lại ở Foxit xem tên font trong Edit) | |
 | E25 | Sửa nhiều lần rồi thoát chế độ sửa (không lưu) | Không còn file `ff_edit_*.pdf` rác trong thư mục %TEMP% | |
 
+## Bổ sung Iteration 3 — Sửa cả đoạn với reflow "như Word"
+| # | Thao tác | Kỳ vọng | KQ |
+|---|----------|---------|----|
+| E26 | Bấm đúp vào 1 đoạn văn NHIỀU dòng | Textarea phủ CẢ ĐOẠN, nội dung ghép đủ các dòng, đúng font/cỡ/màu | |
+| E27 | Thêm 1 câu dài vào giữa đoạn → Ctrl+Enter (hoặc bấm ra ngoài) | Chữ tự bẻ dòng lại trong đúng bề rộng khối, không tràn phải, khoảng cách dòng giữ nguyên, **font giữ nguyên** | |
+| E28 | Trong textarea bấm Enter giữa chừng rồi áp dụng | Vị trí Enter thành xuống dòng cứng (đoạn tách dòng tại đó) | |
+| E29 | Xoá bớt chữ cho đoạn ngắn lại → áp dụng | Đoạn co lại còn ít dòng hơn, không sót dòng cũ | |
+| E30 | Hoàn tác (Ctrl+Z) sau 1 lần reflow | Cả đoạn quay về nguyên trạng trong 1 bước | |
+
 ## Mẫu phản hồi
 ```
 [Mã] (vd E16) — Phần mềm mở: <Foxit/Adobe/Chrome> — Hiện tượng: <mô tả> —

docs/14-foxit-gap-analysis.md

@@ -51,21 +51,17 @@ tác tầng PDF object trực tiếp.
 
 Xếp theo mức độ ảnh hưởng trải nghiệm:
 
-### 3.1 Reflow đoạn văn nhiều dòng ("sửa như Word") — GAP LỚN NHẤT CÒN LẠI
-- **Hiện tại:** sửa được cả dòng (Iteration 2), chưa tự bẻ dòng lại cả đoạn.
-- **Foxit:** click vào đoạn → gõ → chữ tự chảy xuống dòng trong khối.
-- **Giải pháp (Iteration 3, khả thi với stack hiện tại):**
-  1. Gom block: các dòng có baseline cách đều (±20%), cùng lề trái/phải giao nhau.
-  2. Đo width chính xác tầng engine bằng `hmtx` của đúng font bytes
-     (`ttf-parser` đã có trong cây phụ thuộc; với font không nhúng thì đo bằng
-     font hệ thống đã match — chấp nhận sai số như chính Foxit).
-  3. UI: textarea phủ block; engine nhận `ReflowBlock { runs, new_text, box }`
-     → tự bẻ dòng theo width, sinh dãy SetText/AddText/Delete với baseline
-     spacing gốc.
-  4. Nghiệm thu so với Foxit: gõ giữa đoạn 5 dòng → không tràn box, giãn dòng
-     giữ nguyên, font giữ nguyên.
-- **Rủi ro:** đoạn justify (giãn từ) và kerning → v1 chấp nhận căn trái/đều
-  theo heuristic, như mức "Edit Text" thường của Foxit.
+### 3.1 Reflow đoạn văn nhiều dòng ("sửa như Word") — ✅ ĐÃ GIẢI (Iteration 3)
+- **Đã làm đúng kế hoạch:** UI gom block theo baseline cách đều + giao ngang;
+  engine `EditOp::ReflowText` tự suy hình học từ matrix/bounds các run, đo
+  width bằng `hmtx` (ttf-parser), bẻ dòng greedy (`\n` = ngắt cứng), tạo lại
+  các dòng đúng baseline spacing; font giữ theo thang 4 mức (bytes nhúng →
+  font chuẩn base-14 qua `FPDFText_LoadStandardFont` → cùng họ → fallback).
+  3 test integration + 3 unit — xem `docs/12` mục Iteration 3.
+- **Còn lại của mục này (v2):** đoạn justify reflow về căn trái; chưa kerning;
+  khối text xoay chưa reflow theo hướng xoay; đoạn lẫn nhiều font thống nhất
+  theo run neo. Đây là các case Foxit xử lý tốt hơn — nâng khi gặp tài liệu
+  thực tế, không chặn trải nghiệm chính.
 
 ### 3.2 Hiệu năng phiên sửa trên file rất lớn
 - **Hiện tại:** mô hình "materialize tức thì" — mỗi thao tác lưu toàn bộ tài
@@ -133,16 +129,16 @@ Foxit hơn" — chi phí khổng lồ, không giải quyết gap nào ở mục
 ## 5. Tiến độ so với đích + thứ tự việc đề xuất
 
 Đã xong (lõi, có test): Viewer ✅ · Annotate ✅ · Organize + lưu vững ✅ ·
-**Edit text/object giữ font ✅ (iteration 2)**.
+**Edit text/object giữ font ✅ (iteration 2) · Reflow đoạn "như Word" ✅
+(iteration 3)**.
 
 Thứ tự đề xuất tiếp theo, bám giá trị người dùng:
-1. **Iteration 3 của Edit: reflow đoạn** (mục 3.1) — hoàn tất lời hứa "sửa như
-   Word", gap trải nghiệm cuối cùng của tính năng moat.
-2. **Phase 5 Bảo mật + "Lưu tối ưu"** (mục 3.3 gộp vào đây): mã hoá UI (nợ
+1. **Phase 5 Bảo mật + "Lưu tối ưu"** (mục 3.3 gộp vào đây): mã hoá UI (nợ
    Phase 3), redaction thật, subset font, dọn rác, chữ ký số.
-3. Phase 6 Form → Phase 7 OCR/Convert → Phase 8 phát hành (theo roadmap).
-4. Song song, rải theo từng phase: mở rộng font matching (3.4) và nấc 1 của
-   hiệu năng phiên sửa (3.2) khi chạm file lớn thực tế.
+2. Phase 6 Form → Phase 7 OCR/Convert → Phase 8 phát hành (theo roadmap).
+3. Song song, rải theo từng phase: mở rộng font matching (3.4), nấc 1 của
+   hiệu năng phiên sửa (3.2) khi chạm file lớn thực tế, và v2 của reflow
+   (justify/xoay — mục 3.1).
 
 ## 6. Checklist FINAL TARGET & RULE cho chính tài liệu này
 - [x] Đối chiếu từng tính năng với hành vi Foxit làm chuẩn nghiệm thu.