feat(table): split a cell into rows and columns as Hancom does

[airmang]

바뀐 점

표 구조 편집(hwpx.table_patch.apply_table_ops)은 세로로 합친 칸을 쌓인 칸들로 되돌리는 것(split_cell_vertical)만 할 수 있었다. 칸을 열로 나누거나, 한 행짜리 칸을 여러 줄로 나눌 수 없었다. 이제 한/글의 셀 나누기처럼 칸을 줄·칸으로 나눈다.

apply_table_ops(data, [{"op": "split_cell", "table_index": 0, "row": 1, "col": 1, "cols": 3}])
apply_table_ops(data, [{"op": "split_cell", "table_index": 0, "row": 1, "col": 1, "rows": 2, "cols": 2}])

• row, col: 나눌 칸의 주소.
• rows, cols: 2~63(한/글과 같은 한도). 둘 다 주면 열로 먼저 나누고, 나뉜 칸마다 줄로 나눈다.

한/글의 동작

한/글로 3×3 표를 만들고, 칸에 커서를 둔 채 셀 나누기를 해 저장했다.

• 열로 나누기
  • 칸 폭을 똑같이 나누고, 나머지는 마지막 칸이 갖는다(13984 → 4661·4661·4662).
  • 나뉜 칸의 경계에 새 격자 선이 생긴다.
  • 그 선을 가로지르는 다른 칸은 폭은 그대로이고, 덮는 열만큼 colSpan이 는다.
  • 두 열을 합친 칸을 2칸으로 나누면 이미 있는 선에서 나뉘어 격자가 그대로다.
  • 3칸으로 나누면 새 선 둘이 생기고, 가운데 칸은 두 격자 열을 덮는다.
• 줄로 나누기
  • 칸이 덮는 행이 똑같이 나뉘면 그 행들에서 나눈다.
  • 아니면 한 행씩 나누고, 모자라는 행을 칸의 마지막 행 뒤에 더한다.
  • 그 행 옆 칸은 새 행까지 덮도록 rowSpan이 는다.
• 글은 첫 칸에 남는다. 나머지 칸은 그 칸의 테두리·문단 모양·글자 모양을 따른 빈 칸이다.
• 표 폭(sz)은 그대로다.

split_cell은 이 규칙을 따른다. 다른 점은 줄로 나눈 칸의 저장 높이 하나다.

• 한/글은 내용으로 높이를 정한다. 마지막 칸은 남는 높이를 받아, 내용보다 낮은 행에서는 0이나 음수가 된다(282 → 1282·0).
• split_cell은 칸의 저장 높이를 똑같이 나눈다. 한/글에서 '줄 높이를 같게 나누기'를 켠 결과와 같다(3282 → 1641·1641). 한/글은 이 선택이 꺼진 것이 기본이라, 내용보다 높은 행에서는 경계선 자리가 다르다(1282·2000).
• 어느 쪽이든 한/글은 칸을 내용만큼 그린다. 표 높이(sz)는 전처럼 그대로 둔다.

칸 영역(hp:cellzone)은 덮던 자리를 그대로 덮는다. 열은 좌표로 다시 매기고, 줄은 새 행까지 넓힌다.

코드

• table_patch.py
  • _split_cell, _split_cell_columns, _split_cell_rows, _cell_at, _regrid_zone_columns, SPLIT_CELL_MAX를 더함.
  • _shift_zones가 touching(새 행 바로 앞에서 끝나는 영역도 넓힘)을 받는다.
  • _blank_cell_text에서 _drop_line_caches를 뺌. 폭이 바뀐 첫 칸의 줄 캐시를 지운다.
  • apply_table_ops 설명, 두 op 표.
• docs/editor-menu-reverse-map.md: "셀 나누기" 행.
• 변경 로그.

테스트

tests/test_split_cell.py를 더하고, 한/글 저장본 열아홉 개(기준 표 6, 한/글이 나눈 표 13)를 함께 넣는다.

• 높이까지 한/글과 같은 판(7쌍)
  • 2칸, 3칸, 넓은 열 2칸, 두 열 합친 칸 2칸·3칸, 서식 칸 2칸, 높은 행 2줄(고르게).
  • 칸마다 주소, 범위, 폭, 높이, 테두리, 문단·글자 모양, 글을 보고, rowCnt·colCnt·표 sz도 맞춘다.
• 높이 말고는 한/글과 같은 판(6쌍)
  • 2줄, 3줄, 2×2, 세로 합친 칸 2줄·3줄, 서식 칸 2줄.
• 저장 높이를 똑같이 나누는지(4판), 칸 영역, 거부(1개, 64칸, 칸이 시작하지 않는 주소).

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

🤖 Generated with Claude Code