feat(table): insert rows above a row and with empty cells

[airmang]

바뀐 점

행 삽입 insert_row_by_clone(hwpx.table_patch.apply_table_ops)은 기준 행 아래에만 넣을 수 있었고, 기준 칸의 글까지 복제했다. 이제 두 선택지를 받는다.

• side: "above": 기준 행 위에 넣는다.
• blank: true: 새 칸에 그 칸 서식의 빈 문단 하나만 둔다(한/글과 같음).

apply_table_ops(data, [{"op": "insert_row_by_clone", "table_index": 0, "ref_row": 1,
                        "side": "above", "count": 2, "blank": True}])

한/글의 동작

한/글로 3×3 표를 만들고, 칸에 커서를 둔 채 줄을 추가해 저장했다.

• 새 행은 기준 행의 저장 높이를 받는다(위·아래 같음).
• 새 칸은 같은 열 기준 칸의 테두리, 문단 모양, 글자 모양을 따르고 글은 비어 있다.
  • 기준 행에 열을 합친 칸이 있으면 새 행에도 같은 폭의 합친 칸이 생긴다.
• 세로 합친 칸
  • 삽입 선을 가로지르면 rowSpan이 는다(저장 높이는 그대로).
  • 그 경계에서 끝나거나(아래쪽) 시작하면(위쪽) rowSpan은 그대로이고, 새 행에 그 열의 칸이 따로 생긴다.
• 한/글은 표 sz의 높이를 배치 높이로 다시 저장한다. python-hwpx는 전처럼 그대로 두고, 한/글은 열 때 표를 다시 배치한다.

insert_row_by_clone은 이 규칙을 따른다. 위쪽 삽입은 아래쪽 규칙을 뒤집은 것이다.

칸 영역

칸 영역(hp:cellzone)은 그 영역 칸들에 테두리·배경을 주고, 한/글은 이를 그린다. 행 삽입과 행·열 삭제가 영역을 옮기지 않아, 남은 영역이 다른 칸에 테두리를 그렸다. 이제 영역이 칸과 함께 움직인다.

• 행 삽입(아래쪽 포함): 새 행 뒤의 영역은 밀고, 새 행을 가로지르는 영역은 넓힌다. 열 삽입과 같은 도우미 _shift_zones를 쓴다.
• 행·열 삭제: 영역은 남는 줄만큼 줄고 그 앞에서 지워진 줄만큼 당겨진다. 줄이 모두 지워진 영역은 없어지고, 마지막 영역이면 목록째 없어진다(OWPML은 목록에 영역이 하나 이상이어야 한다).
• 열 삭제 뒤 칸이 남지 않은 행을 접을 때는, 칸 합치기가 그런 줄을 접을 때처럼 영역을 이웃 줄로 접는다.

코드

• table_patch.py
  • _clone_row_template과 _insert_row_by_clone이 side, blank를 받는다.
  • _shift_zone_columns를 행·열 공용 _shift_zones로 바꿈.
  • _drop_zone_lines(행·열 삭제), _collapse_zone_line(빈 행 접기)을 더함.
  • 두 op 표가 side, blank를 넘긴다.
  • apply_table_ops 설명.
• 변경 로그.

테스트

tests/test_insert_row_sides.py를 더하고, 한/글 저장본 스무 개(기준 표 5, 한/글이 행을 넣은 표 15)를 함께 넣는다.

• 한/글이 넣은 행과의 대조(15쌍)
  • 대상: 아래, 위, 3개, 높은 행 옆(셋), 세로 합친 칸(가로지름·끝남·시작함, 다섯), 가로 합친 칸(아래·위), 열마다 다른 서식(아래·위).
  • 한/글이 만든 기준 표에 blank: true로 같은 행을 넣는다.
  • 칸마다 주소, 범위, 폭, 높이, 테두리, 문단·글자 모양, 글이 한/글 결과와 같은지 본다.
  • rowCnt와 표 폭이 같은지, 표 높이는 그대로인지 본다.
• 그 밖에 시험하는 것
  • 위쪽 복제의 글 순서, 빈 행.
  • 위쪽 삽입에서의 합친 칸 둘.
  • 칸 영역 이동(아래·위).
  • 잘못된 side의 거부.

tests/test_table_ops_delete_zones.py를 더한다. 행·열 삭제에서 영역이 당겨지고, 줄고, 없어지는지, 마지막 영역과 함께 목록이 없어지는지 본다. 고치기 전에는 영역이 있는 3판이 모두 틀렸다.

이 PR은 #430 위에 쌓았다. #430이 병합되면 그 커밋들은 이 PR의 diff에서 빠진다.

🤖 Generated with Claude Code