요약

NewNumber 컨트롤이 모든 후속 페이지에 매번 재적용되어 본문 모든 페이지가
page_number=1 로 고정되던 회귀 버그 수정.

samples/2022년 국립국어원 업무계획.hwp:

• 페이지 시퀀스: [1, 2, 3, 1, 1, ..., 1] → [1, 2, 1, 2, 3, ..., 33]
• 푸터 페이지 10: - 1 - → - 8 - (PDF 와 일치)
• 푸터 페이지 30: - 1 - → - 28 - (PDF 와 일치)

closes #353

변경 사항

핵심 변경 로직

기존 (버그):

if let Some(fp) = first_para {
    for &(nn_pi, nn_num) in new_page_numbers {
        if nn_pi <= fp {           // 매 페이지마다 참 → 매번 리셋
            page_num = nn_num as u32;
        }
    }
}

수정:

let mut assigner = PageNumberAssigner::new(new_page_numbers, 1);
for page in pages.iter_mut() {
    let page_num = assigner.assign(page);  // 1회만 적용 + 자동 +1
    ...
}

assign() 동작:

1. consumed 에 없는 NewNumber 중 그 컨트롤의 소유 문단이 페이지에서 처음 등장하면 적용 + consumed 마킹
2. 카운터 증가

"처음 등장" 판정:

• FullParagraph / Table / Shape: 항상 인정
• PartialParagraph: start_line == 0 일 때만
• PartialTable: is_continuation == false 일 때만

Test plan

• cargo test --lib renderer::page_number — 단위 테스트 6건 통과
• cargo test --test page_number_propagation — 회귀 테스트 2건 통과
• RHWP_USE_PAGINATOR=1 cargo test --test page_number_propagation — PAGINATOR 경로 2건 통과
• cargo test 전체 — 1006 + 49(통합) 모두 통과, 회귀 0건
• cargo clippy --all-targets --release — 신규 경고 0건
• 시각 검증 — PDF 페이지 5/10/15/20/30/35 푸터와 SVG 푸터 정확 일치
• 다른 샘플 spot check — exam_kor.hwp (24p), exam_math.hwp (20p), 21_언어_기출_편집가능본.hwp (15p) 모두 1..N 단조 증가

명시적 제외 (별도 이슈)

• 전체 페이지 수 차이 (PDF 37 vs SVG 35) → 페이지 분기 오버플로 — vpos 권위값/spacing 누적 오차로 본문이 페이지 박스 초과 #356 페이지 분기 오버플로
• HWPPAGE_ODD/EVEN 강제 시작 → 별도 이슈 필요 시 등록

참고 문서

• 수행 계획서: mydocs/plans/task_m05x_353.md
• 구현 계획서: mydocs/plans/task_m05x_353_impl.md
• 단계별 보고서: mydocs/working/task_m05x_353_stage{1..5}.md
• 최종 보고서: mydocs/report/task_m05x_353_report.md