Update app.py

app.py

@@ -1,549 +1,174 @@
-# verify_bug2_ver8.py
-# 実行方法: python verify_bug2_ver8.py
-
-import re
-import difflib
-import html
-
-# ============================================================
-# 定数
-# ============================================================
-
-LATIN_LIGATURES = set(range(0xFB00, 0xFB07))
-KANGXI_RADICALS = set(range(0x2F00, 0x2FD6))
-CJK_RADICALS_SUPPLEMENT = set(range(0x2E80, 0x2F00))
-COMPATIBILITY_IDEOGRAPHS = set(range(0xF900, 0xFB00))
-ENCLOSED_CJK             = set(range(0x1F200, 0x1F300))
-VERTICAL_BRACKETS        = set(range(0xFE10, 0xFE20))
-CJK_COMPATIBILITY        = set(range(0x3300, 0x3400))
-ENCLOSED_ALPHANUMERICS   = set(range(0x2460, 0x2500))
-ENCLOSED_CJK_LETTERS     = set(range(0x3200, 0x3300))
-
-HYPHENS = set([
-    '\u002D', '\uFF0D', '\u2010', '\u2011', '\u2012', '\u2013', '\u2014',
-])
-
-KANJI_NUMBERS = set('零一二三四五六七八九十')
-ARABIC_NUMBERS = set('0123456789０１２３４５６７８９')
-
-YAKUMONO = set(
-    '。、．，.,'
-    '〔〕《》〈〉【】［］（）()[]'
-    '「」『』｢｣'
-    '〝〟'
-    '！？・…―'
-    '!?'
-    '〜～'
-    '；：;:'
-    '／/＼\\'
-    '‥'
-    '＋+'
-    '＊*'
-    '＃#'
-    '＆&'
-    '％%'
-    '＠@'
-    '＄$'
-    '￥¥'
-    '＾^'
-    '｜|'
-    '`｀'
-    '′″'
-    '§'
-    '※'
-    '〒'
-    '♪♫♬♩'
-    '→←↑↓↗↘↙↖'
-    '◯○●◎□■△▲▽▼◇◆☆★'
-    '©®™'
-)
-
-BRACKET_PAIRS = [
-    ('（', '）'), ('(', ')'), ('[', ']'), ('〔', '〕'), ('《', '》'),
-    ('〈', '〉'), ('【', '】'), ('［', '］'), ('「', '」'), ('『', '』'),
-]
-OPEN_BRACKETS  = set(p[0] for p in BRACKET_PAIRS)
-CLOSE_BRACKETS = set(p[1] for p in BRACKET_PAIRS)
-BRACKET_MAP    = {p[0]: p[1] for p in BRACKET_PAIRS}
-
-# ============================================================
-# 関数
-# ============================================================
-
-def build_active_flags(original, settings):
-    n = len(original)
-    flags = [True] * n
-
-    if settings.get('ignore_brackets_with_content'):
-        i = 0
-        while i < n:
-            ch = original[i]
-            if ch in OPEN_BRACKETS:
-                expected_close = BRACKET_MAP[ch]
-                depth = 1
-                j = i + 1
-                while j < n and depth > 0:
-                    if original[j] == ch: depth += 1
-                    elif original[j] == expected_close: depth -= 1
-                    elif original[j] in CLOSE_BRACKETS and original[j] != expected_close: break
-                    j += 1
-                if depth == 0:
-                    for k in range(i, j): flags[k] = False
-                    i = j
-                else:
-                    i += 1
-            else:
-                i += 1
-
-    if settings.get('ignore_yakumono'):
-        for i, ch in enumerate(original):
-            if ch in YAKUMONO: flags[i] = False
-    if settings.get('ignore_alpha'):
-        for i, ch in enumerate(original):
-            if re.match(r'[A-Za-zＡ-Ｚａ-ｚ]', ch): flags[i] = False
-    if settings.get('ignore_digit'):
-        for i, ch in enumerate(original):
-            if re.match(r'[0-9０-９]', ch): flags[i] = False
-    if settings.get('ignore_kana'):
-        for i, ch in enumerate(original):
-            if re.match(r'[ァ-ンｦ-ﾟ]', ch): flags[i] = False
-    if settings.get('ignore_ligature'):
-        for i, ch in enumerate(original):
-            if ord(ch) in LATIN_LIGATURES: flags[i] = False
-    if settings.get('ignore_kangxi'):
-        for i, ch in enumerate(original):
-            if ord(ch) in KANGXI_RADICALS or ord(ch) in CJK_RADICALS_SUPPLEMENT: flags[i] = False
-    if settings.get('ignore_kanjinum'):
-        for i, ch in enumerate(original):
-            if ch in KANJI_NUMBERS or ch in ARABIC_NUMBERS: flags[i] = False
-    if settings.get('ignore_hyphen'):
-        for i, ch in enumerate(original):
-            if ch in HYPHENS: flags[i] = False
-    if settings.get('ignore_kumimoji'):
-        for i, ch in enumerate(original):
-            if (ord(ch) in COMPATIBILITY_IDEOGRAPHS or ord(ch) in ENCLOSED_CJK
-                    or ord(ch) in VERTICAL_BRACKETS or ord(ch) in CJK_COMPATIBILITY
-                    or ord(ch) in ENCLOSED_ALPHANUMERICS or ord(ch) in ENCLOSED_CJK_LETTERS):
-                flags[i] = False
-    if settings.get('ignore_space'):
-        for i, ch in enumerate(original):
-            if ch in ' \t　': flags[i] = False
-    if settings.get('ignore_newline'):
-        for i, ch in enumerate(original):
-            if ch in '\r\n': flags[i] = False
-
-    return flags
-
-def build_active_text_and_map(original, flags):
-    active_chars = [(i, ch) for i, ch in enumerate(original) if flags[i]]
-    active_text = ''.join(ch for _, ch in active_chars)
-    index_map = [i for i, _ in active_chars]
-    return active_text, index_map
-
-def merge_ranges(ranges):
-    merged = []
-    for s, e in sorted(ranges):
-        if s >= e: continue
-        if merged and s <= merged[-1][1]:
-            merged[-1] = (merged[-1][0], max(merged[-1][1], e))
-        else:
-            merged.append([s, e])
-    return [(s, e) for s, e in merged]
-
-# ============================================================
-# ポストフィルタリング
-# ============================================================
-
-EQUAL_MERGE_THRESHOLD = 0
-
-def filter_opcodes(opcodes):
-    ops = list(opcodes)
-    n = len(ops)
-    if n == 0:
-        return [], []
-
-    is_diff = []
-    for tag, i1, i2, j1, j2 in ops:
-        if tag == 'equal':
-            is_diff.append((i2 - i1) <= EQUAL_MERGE_THRESHOLD)
-        else:
-            is_diff.append(True)
-
-    # 両端のequal区間はdiff扱いにしない
-    for idx in range(n):
-        if ops[idx][0] == 'equal':
-            is_diff[idx] = False
-        else:
-            break
-    for idx in range(n-1, -1, -1):
-        if ops[idx][0] == 'equal':
-            is_diff[idx] = False
-        else:
-            break
-
-    result_src = []
-    result_dst = []
-
-    i = 0
-    while i < n:
-        if is_diff[i]:
-            j = i + 1
-            while j < n and is_diff[j]:
-                j += 1
-            # この範囲内でreplace/delete/insertの文字位置のみ収集
-            for k in range(i, j):
-                tag, i1, i2, j1, j2 = ops[k]
-                if tag in ('replace', 'delete'):
-                    for pos in range(i1, i2):
-                        result_src.append(pos)
-                if tag in ('replace', 'insert'):
-                    for pos in range(j1, j2):
-                        result_dst.append(pos)
-            i = j
-        else:
-            i += 1
-
-    return result_src, result_dst
-
-# ============================================================
-# 比較コア
-# ============================================================
-
-def compare_texts(src, dst, settings):
-    src_flags = build_active_flags(src, settings)
-    dst_flags = build_active_flags(dst, settings)
-
-    src_active, src_map = build_active_text_and_map(src, src_flags)
-    dst_active, dst_map = build_active_text_and_map(dst, dst_flags)
-
-    color_mode = settings.get('color_mode', 'color1')
-    if color_mode == 'color1':
-        hl_style = 'background-color:#ffaaaa;color:#000000;'
-    elif color_mode == 'color2':
-        hl_style = 'background-color:#aaaaff;color:#000000;'
-    else:
-        hl_style = 'background-color:#000000;color:#ffffff;'
-
-    src_diff_ranges = []
-    dst_diff_ranges = []
-
-    if src_active != '' or dst_active != '':
-        matcher = difflib.SequenceMatcher(None, src_active, dst_active, autojunk=False)
-        opcodes = matcher.get_opcodes()
-        result_src, result_dst = filter_opcodes(opcodes)
-
-        for pos in result_src:
-            orig = src_map[pos]
-            src_diff_ranges.append((orig, orig + 1))
-
-        for pos in result_dst:
-            orig = dst_map[pos]
-            dst_diff_ranges.append((orig, orig + 1))
-
-    has_diff = bool(src_diff_ranges or dst_diff_ranges)
-
-    def build_html(text, highlight_ranges):
-        merged = merge_ranges(highlight_ranges)
-        if not merged:
-            return '<span>' + html.escape(text).replace('\n', '<br>') + '</span>'
-        parts = []
-        prev = 0
-        for s, e in merged:
-            s = max(s, prev)
-            e = min(e, len(text))
-            if s >= e: continue
-            if prev < s:
-                parts.append('<span>' + html.escape(text[prev:s]).replace('\n', '<br>') + '</span>')
-            parts.append(
-                f'<span style="{hl_style}">'
-                + html.escape(text[s:e]).replace('\n', '<br>')
-                + '</span>'
-            )
-            prev = e
-        if prev < len(text):
-            parts.append('<span>' + html.escape(text[prev:]).replace('\n', '<br>') + '</span>')
-        return ''.join(parts)
-
-    src_html = build_html(src, merge_ranges(src_diff_ranges))
-    dst_html = build_html(dst, merge_ranges(dst_diff_ranges))
-
-    return src_html, dst_html, has_diff
-
-# ============================================================
-# ヘルパー
-# ============================================================
-
-def extract_highlighted(text, html_result):
-    pattern = re.compile(r'<span style="[^"]*">(.+?)</span>', re.DOTALL)
-    results = []
-    for m in pattern.finditer(html_result):
-        inner = m.group(1).replace('<br>', '\n')
-        results.append(inner)
-    return results
-
-def run_test(name, src, dst, settings, expect_src_hl, expect_dst_hl, expect_has_diff):
-    src_html, dst_html, has_diff = compare_texts(src, dst, settings)
-    src_hl = extract_highlighted(src, src_html)
-    dst_hl = extract_highlighted(dst, dst_html)
-
-    ok_src  = (expect_src_hl is None or src_hl == expect_src_hl)
-    ok_dst  = (expect_dst_hl is None or dst_hl == expect_dst_hl)
-    ok_diff = (has_diff == expect_has_diff)
-    ok_all  = ok_src and ok_dst and ok_diff
-
-    status = "✅ PASS" if ok_all else "❌ FAIL"
-    print(f"{status} {name}")
-    if not ok_src:
-        print(f"  [src_hl ] 期待: {expect_src_hl}")
-        print(f"  [src_hl ] 実際: {src_hl}")
-    if not ok_dst:
-        print(f"  [dst_hl ] 期待: {expect_dst_hl}")
-        print(f"  [dst_hl ] 実際: {dst_hl}")
-    if not ok_diff:
-        print(f"  [has_diff] 期待: {expect_has_diff} / 実際: {has_diff}")
-
-# ============================================================
-# テストデータ
-# ============================================================
-
-OFF = {}
-ALL_ON = {
-    'ignore_alpha': True, 'ignore_digit': True, 'ignore_kana': True,
-    'ignore_yakumono': True, 'ignore_ligature': True, 'ignore_kangxi': True,
-    'ignore_brackets_with_content': True, 'ignore_kanjinum': True,
-    'ignore_hyphen': True, 'ignore_kumimoji': True,
-    'ignore_space': True, 'ignore_newline': True,
+# verify_highlight_annotation.py
+# 実行: python verify_highlight_annotation.py
+# 出力: output_highlighted.pdf (カレントディレクトリ)
+# 確認: Adobe Acrobat等で開き、ハイライトが「注釈」として認識されるか確認
+
+import io
+import os
+from reportlab.lib.pagesizes import A4
+from reportlab.pdfgen import canvas as rl_canvas
+from reportlab.pdfbase import pdfmetrics
+from reportlab.pdfbase.ttfonts import TTFont
+import fitz  # PyMuPDF
+
+# =====================
+# 設定
+# =====================
+FONT_NAME = "NotoSansJP"
+FONT_FILE = "NotoSansJP-Regular.ttf"  # カレントディレクトリに配置すること
+OUTPUT_FILE = "output_highlighted.pdf"
+
+# ハイライト色 (RGB 0.0-1.0)
+COLORS = {
+    "color1": (1.0, 0.6, 0.6),   # 赤系
+    "color2": (0.6, 0.8, 1.0),   # 青系
+    "mono":   (0.5, 0.5, 0.5),   # グレー（モノクロ代替）
 }
 
-SRC25 = (
-    "第1条（契約期間）本契約の有効期間は、2024年4月1日［開始日］からAプラン月額￥5,000\u2010を適用する。"
-    "担当はアイウ部門とし、\uFB01gure\u2F00の基準、組み文字\u336B\u2460\u339Dによる。費用 区切り\n"
-    "第2条〔備考〕詳細は\u4E00\u30002024年12月31日までに別途定める。\uFB03\u2F05\uFF71\uFF72\uFF73\u2011\u2014\n"
-    "第3条 担当者はＡＢＣ１２３とする。"
-)
-
-DST25 = (
-    "第1条[契約期間]本契約の有効期間は、2025年5月1日からBプラン月額￥8,000+を適用する。"
-    "担当はカキク部門とし、\uFB02oor\u2F01の基準、組み文字\u336C\u2461\u339Eによる。費用　区切り\n"
-    "第2条〔備考〕詳細は\u4E8C\u4E09\u30002026年1月1日までに別途定める。\uFF74\uFF75\uFF76\u2012\u2F16\uFB04\n"
-    "第4条 担当者はＸＹＺ４５６とする。"
-)
-
-# ============================================================
-# テストケース
-# ============================================================
-
-print("=" * 60)
-print("バグ2 検証スクリプト ver8")
-print("=" * 60)
-
-# ---- 全設定オフ ----
-run_test("TEST-01 相違なし",
-    "吾輩は猫である。名前はまだない。",
-    "吾輩は猫である。名前はまだない。",
-    OFF, [], [], False)
-
-run_test("TEST-02 相違あり基本",
-    "吾輩は猫である。", "吾輩は犬である。",
-    OFF, ["猫"], ["犬"], True)
-
-run_test("TEST-03 比較先に追加",
-    "abcdef", "abcXYZdef",
-    OFF, [], ["XYZ"], True)
-
-run_test("TEST-04 比較元に削除",
-    "abcXYZdef", "abcdef",
-    OFF, ["XYZ"], [], True)
-
-run_test("TEST-27 空文字",
-    "", "", OFF, [], [], False)
-
-run_test("TEST-28 片方空文字",
-    "abcdef", "", OFF, ["abcdef"], [], True)
-
-run_test("TEST-29 改行のみ相違 設定オフ",
-    "\n\n", "\n", OFF, ["\n"], [], True)
-
-run_test("TEST-30 スペースのみ相違 設定オフ",
-    "abc def", "abcdef",
-    OFF, [" "], [], True)
-
-run_test("TEST-35 比較元削除箇所ハイライト",
-    "abcXYZdef", "abcdef",
-    OFF, ["XYZ"], [], True)
-
-# ---- 約物無視 ----
-run_test("TEST-08 約物無視 設定オン",
-    "吾輩は、猫である。「名前」は（まだ）ない！",
-    "吾輩は猫である名前はまだない",
-    {'ignore_yakumono': True}, [], [], False)
-
-run_test("TEST-08 約物無視 設定オフ",
-    "吾輩は、猫である。「名前」は（まだ）ない！",
-    "吾輩は猫である名前はまだない",
-    OFF,
-    ["、", "。「", "」", "（", "）", "！"],
-    [], True)
-
-run_test("TEST-09 約物無視 設定オン",
-    "(abc)テスト", "abcテスト",
-    {'ignore_yakumono': True}, [], [], False)
-
-run_test("TEST-09 英字無視 設定オン",
-    "(abc)テスト", "abcテスト",
-    {'ignore_alpha': True},
-    ["(", ")"], [], True)
-
-run_test("TEST-16 約物無視 設定オン",
-    "〔brackets〕《brackets》〈brackets〉【brackets】［brackets］「brackets」『brackets』",
-    "テスト確認",
-    {'ignore_yakumono': True},
-    ["brackets", "brackets", "brackets", "brackets", "brackets", "brackets", "brackets"],
-    ["テスト確認"],
-    True)
-
-# ---- 括弧付き文字無視 ----
-run_test("TEST-12 括弧付き文字無視 設定オン",
-    "���スト(abc)文字列です", "テスト文字列です",
-    {'ignore_brackets_with_content': True}, [], [], False)
-
-run_test("TEST-12 英字無視 設定オン",
-    "テスト(abc)文字列です", "テスト文字列です",
-    {'ignore_alpha': True},
-    ["(", ")"], [], True)
-
-run_test("TEST-13 括弧付き文字無視 全角 設定オン",
-    "テスト（abc）文字列です", "テスト文字列です",
-    {'ignore_brackets_with_content': True}, [], [], False)
-
-run_test("TEST-13 英字無視 設定オン",
-    "テスト（abc）文字列です", "テスト文字列です",
-    {'ignore_alpha': True},
-    ["（", "）"], [], True)
-
-run_test("TEST-14 括弧付き文字無視 入れ子 設定オン",
-    "テスト(abc(def)ghi)文字列です", "テスト文字列です",
-    {'ignore_brackets_with_content': True}, [], [], False)
-
-run_test("TEST-14 英字無視 設定オン",
-    "テスト(abc(def)ghi)文字列です", "テスト文字列です",
-    {'ignore_alpha': True},
-    ["(", "(", ")", ")"], [], True)
-
-# ---- ハイフン無視 ----
-run_test("TEST-19 ハイフン無視 設定オン",
-    "abc-def\uFF0Dghi\u2010jkl\u2011mno\u2013pqr\u2014stu",
-    "abcdefghijklmnopqrstu",
-    {'ignore_hyphen': True}, [], [], False)
-
-run_test("TEST-19 ハイフン無視 設定オフ",
-    "abc-def\uFF0Dghi\u2010jkl\u2011mno\u2013pqr\u2014stu",
-    "abcdefghijklmnopqrstu",
-    OFF,
-    ["-", "\uFF0D", "\u2010", "\u2011", "\u2013", "\u2014"],
-    [], True)
-
-run_test("TEST-37 ハイフン全種 設定オン",
-    "abc-def\uFF0Dghi\u2010jkl\u2011mno\u2013pqr\u2014stu",
-    "abcdefghijklmnopqrstu",
-    {'ignore_hyphen': True}, [], [], False)
-
-run_test("TEST-37 ハイフン全種 設定オフ",
-    "abc-def\uFF0Dghi\u2010jkl\u2011mno\u2013pqr\u2014stu",
-    "abcdefghijklmnopqrstu",
-    OFF,
-    ["-", "\uFF0D", "\u2010", "\u2011", "\u2013", "\u2014"],
-    [], True)
-
-# ---- スペース・改行 ----
-run_test("TEST-21 スペース削除 設定オン",
-    "abc def　ghi", "abcdefghi",
-    {'ignore_space': True}, [], [], False)
-
-run_test("TEST-21 スペース削除 設定オフ",
-    "abc def　ghi", "abcdefghi",
-    OFF, [" ", "　"], [], True)
-
-run_test("TEST-21 英字無視 設定オン",
-    "abc def　ghi", "abcdefghi",
-    {'ignore_alpha': True},
-    [" ", "　"], [], True)
-
-run_test("TEST-22 改行削除 設定オン",
-    "abc\ndef\nghi", "abcdefghi",
-    {'ignore_newline': True}, [], [], False)
-
-run_test("TEST-22 改行削除 設定オフ",
-    "abc\ndef\nghi", "abcdefghi",
-    OFF, ["\n", "\n"], [], True)
-
-run_test("TEST-22 英字無視 設定オン",
-    "abc\ndef\nghi", "abcdefghi",
-    {'ignore_alpha': True},
-    ["\n", "\n"], [], True)
-
-# ---- 約物と括弧付き文字両方 ----
-run_test("TEST-23 約物と括弧付き文字両方 設定オン",
-    "吾輩は(猫)である。名前は【まだ】ない！",
-    "吾輩はである。名前はない！",
-    {'ignore_yakumono': True, 'ignore_brackets_with_content': True},
-    [], [], False)
-
-# ---- 空括弧 ----
-run_test("TEST-39 カナ無視 設定オン",
-    "()テスト（）文字", "テスト文字",
-    {'ignore_kana': True},
-    ["(", ")", "（", "）"], [], True)
-
-run_test("TEST-39 約物無視 設定オン",
-    "()テスト（）文字", "テスト文字",
-    {'ignore_yakumono': True}, [], [], False)
-
-# ---- TEST-25 ----
-print()
-print("--- TEST-25 ---")
-
-run_test("TEST-25 全設定OFF",
-    SRC25, DST25, OFF, None, None, True)
-
-run_test("TEST-25 全設定ON",
-    SRC25, DST25, ALL_ON, [], [], False)
-
-run_test("TEST-25 英字のみON",
-    SRC25, DST25, {'ignore_alpha': True}, None, None, True)
-
-run_test("TEST-25 数字のみON",
-    SRC25, DST25, {'ignore_digit': True}, None, None, True)
-
-run_test("TEST-25 カナのみON",
-    SRC25, DST25, {'ignore_kana': True}, None, None, True)
-
-run_test("TEST-25 約物のみON",
-    SRC25, DST25, {'ignore_yakumono': True}, None, None, True)
-
-run_test("TEST-25 括弧付き文字のみON",
-    SRC25, DST25, {'ignore_brackets_with_content': True}, None, None, True)
-
-run_test("TEST-25 漢数字のみON",
-    SRC25, DST25, {'ignore_kanjinum': True}, None, None, True)
-
-run_test("TEST-25 ハイフンのみON",
-    SRC25, DST25, {'ignore_hyphen': True}, None, None, True)
-
-run_test("TEST-25 組み文字のみON",
-    SRC25, DST25, {'ignore_kumimoji': True}, None, None, True)
-
-run_test("TEST-25 リガチャのみON",
-    SRC25, DST25, {'ignore_ligature': True}, None, None, True)
-
-run_test("TEST-25 康煕部首のみON",
-    SRC25, DST25, {'ignore_kangxi': True}, None, None, True)
-
-run_test("TEST-25 スペースのみON",
-    SRC25, DST25, {'ignore_space': True}, None, None, True)
-
-run_test("TEST-25 改行のみON",
-    SRC25, DST25, {'ignore_newline': True}, None, None, True)
-
-print("=" * 60)
-print("完了")
+# =====================
+# Step1: reportlabでベースPDF生成
+# =====================
+def build_base_pdf(font_file: str) -> bytes:
+    """テスト用テキストを含むPDF���reportlabで生成してbytesで返す"""
+
+    pdfmetrics.registerFont(TTFont(FONT_NAME, font_file))
+
+    buffer = io.BytesIO()
+    PAGE_W, PAGE_H = A4
+    MARGIN = 20
+    c = rl_canvas.Canvas(buffer, pagesize=A4)
+    c.setFont(FONT_NAME, 12)
+
+    # テスト文字列（差分あり想定）
+    lines = [
+        "吾輩は猫である。名前はまだない。",       # 行1: 差分なし想定
+        "吾輩は犬である。名前はもうある。",        # 行2: 差分あり想定（「犬」「もうある」）
+        "abcXYZdef",                               # 行3: 差分あり（「XYZ」）
+        "テスト　スペース　あり",                  # 行4: 差分なし想定
+    ]
+
+    y = PAGE_H - MARGIN - 20
+    for line in lines:
+        c.drawString(MARGIN, y, line)
+        y -= 20
+
+    c.save()
+    return buffer.getvalue()
+
+
+# =====================
+# Step2: PyMuPDFでHighlight Annotation付与
+# =====================
+def add_highlight_annotations(pdf_bytes: bytes, color_mode: str = "color1") -> bytes:
+    """
+    PyMuPDFを使い、指定テキストにHighlight Annotationを付与する。
+    テキスト検索 → quads取得 → add_highlight_annot の流れを検証。
+    """
+    hl_color = COLORS.get(color_mode, COLORS["color1"])
+
+    doc = fitz.open(stream=pdf_bytes, filetype="pdf")
+
+    # 検証用: ハイライトしたいテキストのリスト
+    highlight_targets = [
+        "犬",
+        "もうある",
+        "XYZ",
+    ]
+
+    page = doc[0]  # 1ページ目
+
+    for target in highlight_targets:
+        # テキスト検索でquadsを取得
+        areas = page.search_for(target, quads=True)
+        if not areas:
+            print(f"[WARNING] テキストが見つかりません: '{target}'")
+            continue
+
+        for quad in areas:
+            annot = page.add_highlight_annot(quad)
+            annot.set_colors(stroke=hl_color)
+            annot.update()
+            print(f"[OK] ハイライト注釈追加: '{target}' at {quad}")
+
+    result = io.BytesIO()
+    doc.save(result)
+    doc.close()
+    return result.getvalue()
+
+
+# =====================
+# Step3: 文字座標から直接Annotationを付与する方式の検証
+# =====================
+def add_highlight_by_position(pdf_bytes: bytes, color_mode: str = "color1") -> bytes:
+    """
+    reportlabで描画した文字位置を座標で指定してHighlight Annotationを付与。
+    (テキスト検索不要の方式 - 本番実装候補)
+    reportlabのy座標(下原点) → PyMuPDFのy座標(上原点)変換を検証。
+    """
+    hl_color = COLORS.get(color_mode, COLORS["color1"])
+    PAGE_W, PAGE_H = A4  # (595.27, 841.89)
+    MARGIN = 20
+    FONT_SIZE = 12
+    LINE_HEIGHT = 20
+
+    doc = fitz.open(stream=pdf_bytes, filetype="pdf")
+    page = doc[0]
+
+    # reportlabで描画した行2の「犬」の座標を手動計算
+    # reportlab: y = PAGE_H - MARGIN - 20 - LINE_HEIGHT * 1 = 841.89 - 20 - 20 - 20 = 781.89
+    # PyMuPDF: y_mupdf = PAGE_H - y_rl = 841.89 - 781.89 = 60.0  ← ベースライン
+    # Highlight用rect: x0, y0(上端), x1, y1(下端)
+
+    # 行インデックス1（0始まり）= 「吾輩は犬である...」行
+    line_idx = 1
+    y_rl = PAGE_H - MARGIN - 20 - LINE_HEIGHT * line_idx  # reportlab y（ベースライン）
+    y_mupdf_base = PAGE_H - y_rl                           # PyMuPDF y（上原点換算）
+
+    # 「犬」は「吾輩は」(3文字)の後 → x方向はフォント幅が必要だが近似で指定
+    # 実際はreportlab側でstringWidthを使って正確に計算する
+    x0 = MARGIN + 3 * FONT_SIZE * 0.9   # 近似（全角文字）
+    x1 = x0 + FONT_SIZE
+
+    rect = fitz.Rect(x0, y_mupdf_base - FONT_SIZE, x1, y_mupdf_base + 2)
+    quad = rect.quad
+
+    annot = page.add_highlight_annot(quad)
+    annot.set_colors(stroke=hl_color)
+    annot.update()
+    print(f"[OK] 座標指定ハイライト注釈追加: rect={rect}")
+
+    result = io.BytesIO()
+    doc.save(result)
+    doc.close()
+    return result.getvalue()
+
+
+# =====================
+# メイン
+# =====================
+if __name__ == "__main__":
+    # フォントファイル確認
+    if not os.path.isfile(FONT_FILE):
+        print(f"[ERROR] フォントファイルが見つかりません: {FONT_FILE}")
+        print("カレントディレクトリに NotoSansJP-Regular.ttf を配置してください。")
+        exit(1)
+
+    print("=== Step1: reportlabでベースPDF生成 ===")
+    base_pdf = build_base_pdf(FONT_FILE)
+    print(f"[OK] ベースPDF生成完了 ({len(base_pdf)} bytes)")
+
+    print("\n=== Step2: テキスト検索によるHighlight Annotation ===")
+    highlighted_pdf = add_highlight_annotations(base_pdf, color_mode="color1")
+    print(f"[OK] Annotation付与完了 ({len(highlighted_pdf)} bytes)")
+
+    print("\n=== Step3: 座標指定によるHighlight Annotation ===")
+    highlighted_pdf2 = add_highlight_by_position(highlighted_pdf, color_mode="color1")
+    print(f"[OK] 座標指定Annotation付与完了 ({len(highlighted_pdf2)} bytes)")
+
+    with open(OUTPUT_FILE, "wb") as f:
+        f.write(highlighted_pdf2)
+    print(f"\n=== 出力完了: {OUTPUT_FILE} ===")
+    print("Adobe Acrobat等で開き、以下を確認してください：")
+    print("  1. 「犬」「もうある」「XYZ」がハイライト注釈として表示される")
+    print("  2. 注釈パネルでHighlight Annotationとして認識されている")
+    print("  3. 座標指定のハイライトも正しい位置に表示される")