feat(table): insert and delete rows and columns and split cells on the table object

[airmang]

바뀐 점

표 객체(hwpx.model.Table, 곧 HwpxOxmlTable)에는 칸 합치기(merge_cells)와 합친 칸 풀기(split_merged_cell)만 있었다. 행·열을 넣거나 지우는 것과 칸 나누기는 바이트 경로(apply_table_ops)에만 있었다. 이제 표 객체에도 다섯 메서드가 있다.

table = doc.tables.all[0]
table.insert_rows(1, 2)                         # 1행 아래에 2행, 1행을 복제
table.insert_rows(0, side="above", blank=True)  # 0행 위에 빈 행
table.insert_columns(2, side="left")            # 2열 왼쪽에 열(표가 넓어짐)
table.delete_rows([3, 4])
table.delete_columns(1)                         # 그 폭은 남은 열에 나눔
table.split_cell(1, 1, rows=2, cols=3)          # 한/글의 셀 나누기
doc.tables.insert_rows(table, 1)                # doc.tables에도 같은 이름(첫 인자로 표)

• 규칙은 apply_table_ops의 같은 편집과 같다(insert_row_by_clone, insert_column_by_clone, delete_row, delete_column, split_cell). 한/글의 줄/칸 추가하기·지우기, 셀 나누기를 따른다.
• 새 칸은 기준 칸의 서식과 글을 받는다. blank=True면 한/글처럼 그 서식의 빈 문단 하나만 둔다.
• 칸 영역(hp:cellzone)도 함께 옮긴다.
• 새 문단은 문서 어디에도 없는 id를 받는다.
• 편집하면 표를 담은 문단의 줄 캐시를 지운다.
• 편집 전에 얻은 셀·행 객체는 표에 속하지 않으니 다시 얻는다.
• 거부되는 편집(표 안의 표, 모든 행·열 삭제, 칸이 시작하지 않는 주소, 잘못된 인자)은 TableStructureError를 내고 표를 그대로 둔다.

코드

• oxml/table_structure.py(새 모듈)
  • TableStructureEdits: HwpxOxmlTable의 믹스인.
  • 다섯 메서드는 표 XML에 apply_table_ops의 편집을 적용하고, 결과를 표 요소에 제자리로 돌려놓는다.
  • table.py가 줄 수 상한에 닿아 새 모듈로 뺐다.
  • docs/architecture/module-ownership.json에 등록하고, 형식 검사 범위(pyproject.toml)에 넣었다.
• oxml/table.py: class HwpxOxmlTable(TableStructureEdits)(+1줄).
• table_patch.py: _restructure_table(표 하나에 구조 편집 하나를 적용하고 격자를 검사). apply_table_ops도 이것을 쓴다.
• _document/ns/tables.py: doc.tables의 다섯 위임 메서드.
• capabilities.py: 표 구조 영역의 진입점에 hwpx.model:Table.
• docs/api_reference.md, 지원 표(두 벌), 변경 로그.
• tests/test_product_boundary.py(분류 모듈 수 181), tests/test_namespace_hygiene.py(doc.tables 동사).
• tests/data/model_surface.json: 다섯 메서드를 Table의 안정(stable) 멤버로 넣었다. docs/stable-api.md의 멤버 수는 198이 되고, 설명 한 단락을 더했다.
• tests/data/import_breadth.json: import hwpx가 읽는 hwpx 모듈 상한을 97 → 98로 올렸다.
  • 표 객체가 이 믹스인을 상속하므로, 새 모듈은 표 모듈과 함께 읽힐 수밖에 없다.
  • 모듈은 메서드 정의뿐이라 가볍고, 편집 코드(table_patch)는 처음 편집할 때 읽는다.
  • table.py에 둘 수 없는 이유는 줄 수 상한이다.

테스트

tests/test_table_structure_edits.py를 더한다.

• 한/글 저장본과의 대조(15판)
  • 바이트 경로 시험의 한/글 저장본(열 넣기 5, 행 넣기 5, 칸 나누기 5)을 표 객체로 다시 연다.
  • 같은 편집을 하고 칸마다 한/글 결과와 맞춘다.
• apply_table_ops와의 대조(7판): 합친 칸이 있는 표에서 두 경로의 결과 칸이 같은지 본다.
• 편집 뒤 표 객체가 새 모양을 읽는지, doc.tables 메서드, 다시 연 문서.
• 두 구역 문서에서 새 문단 id가 겹치지 않는지, 표를 담은 문단의 줄 캐시.
• 거부 7가지에서 표가 그대로인지, 표 안의 표.

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

🤖 Generated with Claude Code