python-hwpx 6.5.0__tar.gz → 6.7.0__tar.gz

{python_hwpx-6.5.0/src/python_hwpx.egg-info → python_hwpx-6.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 6.5.0
+Version: 6.7.0
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -68,7 +68,7 @@ Dynamic: license-file
 
 한컴오피스가 없어도 됩니다. HWPX는 ZIP+XML(OWPML) 포맷이라 순수 파이썬만으로
 읽고, 고치고, 새로 만들 수 있습니다 — Windows·macOS·Linux·CI, 그리고
-**파이썬이 도는 ChatGPT 채팅 안에서도** 그대로 동작합니다. 기존 문서의 저장은 요청한 보존 등급과 실제 검증 결과를 영수증으로 남깁니다.
+**파이썬이 도는 ChatGPT 채팅 안에서도** 그대로 동작합니다.
 새 문서의 한컴 호환성은 아래에 날짜·버전을 명시한 코퍼스로 측정합니다.
 
 <p align="center">
@@ -109,7 +109,7 @@ from hwpx import HwpxDocument
 
 doc = HwpxDocument.new()
 doc.add_heading("2026 운영계획", level=1)
-doc.add_paragraph("가. 추진 배경", style="개요 2")
+doc.add_paragraph("추진 배경", style="개요 2")  # 한/글이 "가." 번호를 붙인다
 doc.save_to_path("계획.hwpx")
 ```
 
@@ -130,7 +130,7 @@ doc.save_to_path("계획.hwpx")
 - **편집** — 문단·표·이미지·머리글/바닥글·메모·각주, 줄간격·여백·쪽번호 같은 서식
 - **양식 채우기** — 라벨로 셀을 찾아 값만 채우기, 행·열 조정 같은 구조 편집도 바이트 보존으로
 - **생성·일괄 처리** — 새 문서 저작, 목차·상호참조, mail merge, 텍스트 diff, 변경추적(redline)
-- **검증·안전** — 패키지 구조 검증 CLI, 열림 안전 게이트, 모든 저장에 영수증(`MutationReport`)
+- **검증·안전** — 패키지 구조 검증 CLI, 열림 안전 게이트, 저장 결과 보고(`return_report=True`)
 
 자세한 내용: [5분 퀵스타트](docs/quickstart.md) · [사용 가이드](docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [예제](docs/examples.md)
 
@@ -152,20 +152,6 @@ report = doc.save_to_path("신청서-작성완료.hwpx", mode="patch", fallback=
 바이트 보존을 요구합니다. 수정 파트 내부의 보존과 시각적 배치는 별도 확인이
 필요합니다. 출력 재개봉과 내용 확인까지 포함한 경로는 [안전한 쓰기 계약](docs/safe-write-contract.md)을 따르세요.
 
-### 저장에는 영수증이 따라옵니다
-
-```python
-report = doc.save_to_path("결과.hwpx", return_report=True)
-print(report.actual_mode)        # "patch" 또는 "rebuild" — 실제 저장 등급
-print(report.preservation.untouched_part_payloads.to_dict())
-                                 # {"verified": 17, "changed": 0}
-```
-
-`mode="patch", fallback="error"`는 보존 등급 미달 시 출력하지 않습니다.
-기본 `auto`는 달성 가능한 등급을 선택합니다. `report.ok`는 요청 반영이나 시각
-검증 완료를 뜻하지 않습니다.
-전체 규칙: [안전한 쓰기 계약](docs/safe-write-contract.md).
-
 *예제 중 **독립 실행 예제** 표시가 없는 블록은 여러분의 기존 문서를 입력으로
 쓰는 조각입니다. 예제별 Python 블록 판정은
 [실행 ledger](docs/python-example-ledger.json)에 동결돼 있습니다.*
@@ -175,10 +161,9 @@ print(report.preservation.untouched_part_payloads.to_dict())
 만든 파일이 실제 한컴오피스에서 열리는지 재서 그대로 공개합니다. 측정마다
 스택과 날짜를 병기합니다:
 
-- **한컴 열림 120/120 · 렌더 검증 120/120** — 현행 스택(5.7.0 · 실한컴
-  12.0.0.3288 · 2026-08-03)의 축소 측정: 기준 스트라텀 + 신규 저작 표면
-  6종(각주·누름틀·수식·차트·체크박스·편집 계획). 영수증은 행마다 bucket이
-  있어 `jq` 한 줄로 재현됩니다
+- **한컴 열림 120/120 · 렌더 검증 120/120** — 기준 문서군 + 저작 기능
+  6종(각주·누름틀·수식·차트·체크박스·편집 계획) 축소 측정
+  (5.7.0 · 실한컴 12.0.0.3288 · 2026-08-03)
 - **한컴 열림 476/476** — 전수 동결 코퍼스(N=497) 측정
   (3.4.1 · 실한컴 12.0.0.3288 · 2026-07-19)
 - **미수정 영역 바이트 보존 497/497** · 개인정보 유출 0
@@ -218,13 +203,15 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
 
 | | python-hwpx | pyhwpx | pyhwp |
 |---|---|---|---|
-| **대상 포맷** | `.hwpx` (OWPML/OPC) | `.hwpx` | `.hwp` (v5 바이너리) |
+| **대상 포맷** | `.hwpx` (OWPML/OPC), `.hwp` (HWP 5.0) | `.hwpx` | `.hwp` (v5 바이너리) |
 | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
 | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 | **편집/생성 API** | ✅ | ✅ (COM) | ❌ 대부분 읽기 |
 | **AI 에이전트 연동 (MCP)** | ✅ companion 경유 | ❌ | ❌ |
 
-> HWP(v5 바이너리)는 지원하지 않습니다. 한컴오피스에서 HWPX로 변환 후 사용하세요.
+> HWP 5.0(`.hwp`)은 `HwpxDocument.open`으로 열어 같은 API로 편집하고,
+> `save_to_path("x.hwp")`로 HWP로 저장합니다. 옮기지 못한 내용은
+> `document.conversion_report`에 남고, 암호·배포용 문서는 `Hwp5Error`로 거부합니다.
 
 ## 알려진 제약
 
@@ -232,7 +219,7 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
   열지 못하는 파일이 됩니다(호출 시 경고만 나옵니다). 도형은 `add_line()` /
   `add_rectangle()` / `add_ellipse()`를 쓰세요.
 - 그림은 단순 개체 생성까지 지원합니다 (그룹·효과 미지원).
-- 암호화된 HWPX는 지원하지 않습니다.
+- 암호화된 HWPX와 암호·배포용 HWP는 지원하지 않습니다.
 
 ## 기여하기
 

{python_hwpx-6.5.0 → python_hwpx-6.7.0}/README.md

@@ -17,7 +17,7 @@
 
 한컴오피스가 없어도 됩니다. HWPX는 ZIP+XML(OWPML) 포맷이라 순수 파이썬만으로
 읽고, 고치고, 새로 만들 수 있습니다 — Windows·macOS·Linux·CI, 그리고
-**파이썬이 도는 ChatGPT 채팅 안에서도** 그대로 동작합니다. 기존 문서의 저장은 요청한 보존 등급과 실제 검증 결과를 영수증으로 남깁니다.
+**파이썬이 도는 ChatGPT 채팅 안에서도** 그대로 동작합니다.
 새 문서의 한컴 호환성은 아래에 날짜·버전을 명시한 코퍼스로 측정합니다.
 
 <p align="center">
@@ -58,7 +58,7 @@ from hwpx import HwpxDocument
 
 doc = HwpxDocument.new()
 doc.add_heading("2026 운영계획", level=1)
-doc.add_paragraph("가. 추진 배경", style="개요 2")
+doc.add_paragraph("추진 배경", style="개요 2")  # 한/글이 "가." 번호를 붙인다
 doc.save_to_path("계획.hwpx")
 ```
 
@@ -79,7 +79,7 @@ doc.save_to_path("계획.hwpx")
 - **편집** — 문단·표·이미지·머리글/바닥글·메모·각주, 줄간격·여백·쪽번호 같은 서식
 - **양식 채우기** — 라벨로 셀을 찾아 값만 채우기, 행·열 조정 같은 구조 편집도 바이트 보존으로
 - **생성·일괄 처리** — 새 문서 저작, 목차·상호참조, mail merge, 텍스트 diff, 변경추적(redline)
-- **검증·안전** — 패키지 구조 검증 CLI, 열림 안전 게이트, 모든 저장에 영수증(`MutationReport`)
+- **검증·안전** — 패키지 구조 검증 CLI, 열림 안전 게이트, 저장 결과 보고(`return_report=True`)
 
 자세한 내용: [5분 퀵스타트](docs/quickstart.md) · [사용 가이드](docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [예제](docs/examples.md)
 
@@ -101,20 +101,6 @@ report = doc.save_to_path("신청서-작성완료.hwpx", mode="patch", fallback=
 바이트 보존을 요구합니다. 수정 파트 내부의 보존과 시각적 배치는 별도 확인이
 필요합니다. 출력 재개봉과 내용 확인까지 포함한 경로는 [안전한 쓰기 계약](docs/safe-write-contract.md)을 따르세요.
 
-### 저장에는 영수증이 따라옵니다
-
-```python
-report = doc.save_to_path("결과.hwpx", return_report=True)
-print(report.actual_mode)        # "patch" 또는 "rebuild" — 실제 저장 등급
-print(report.preservation.untouched_part_payloads.to_dict())
-                                 # {"verified": 17, "changed": 0}
-```
-
-`mode="patch", fallback="error"`는 보존 등급 미달 시 출력하지 않습니다.
-기본 `auto`는 달성 가능한 등급을 선택합니다. `report.ok`는 요청 반영이나 시각
-검증 완료를 뜻하지 않습니다.
-전체 규칙: [안전한 쓰기 계약](docs/safe-write-contract.md).
-
 *예제 중 **독립 실행 예제** 표시가 없는 블록은 여러분의 기존 문서를 입력으로
 쓰는 조각입니다. 예제별 Python 블록 판정은
 [실행 ledger](docs/python-example-ledger.json)에 동결돼 있습니다.*
@@ -124,10 +110,9 @@ print(report.preservation.untouched_part_payloads.to_dict())
 만든 파일이 실제 한컴오피스에서 열리는지 재서 그대로 공개합니다. 측정마다
 스택과 날짜를 병기합니다:
 
-- **한컴 열림 120/120 · 렌더 검증 120/120** — 현행 스택(5.7.0 · 실한컴
-  12.0.0.3288 · 2026-08-03)의 축소 측정: 기준 스트라텀 + 신규 저작 표면
-  6종(각주·누름틀·수식·차트·체크박스·편집 계획). 영수증은 행마다 bucket이
-  있어 `jq` 한 줄로 재현됩니다
+- **한컴 열림 120/120 · 렌더 검증 120/120** — 기준 문서군 + 저작 기능
+  6종(각주·누름틀·수식·차트·체크박스·편집 계획) 축소 측정
+  (5.7.0 · 실한컴 12.0.0.3288 · 2026-08-03)
 - **한컴 열림 476/476** — 전수 동결 코퍼스(N=497) 측정
   (3.4.1 · 실한컴 12.0.0.3288 · 2026-07-19)
 - **미수정 영역 바이트 보존 497/497** · 개인정보 유출 0
@@ -167,13 +152,15 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
 
 | | python-hwpx | pyhwpx | pyhwp |
 |---|---|---|---|
-| **대상 포맷** | `.hwpx` (OWPML/OPC) | `.hwpx` | `.hwp` (v5 바이너리) |
+| **대상 포맷** | `.hwpx` (OWPML/OPC), `.hwp` (HWP 5.0) | `.hwpx` | `.hwp` (v5 바이너리) |
 | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
 | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 | **편집/생성 API** | ✅ | ✅ (COM) | ❌ 대부분 읽기 |
 | **AI 에이전트 연동 (MCP)** | ✅ companion 경유 | ❌ | ❌ |
 
-> HWP(v5 바이너리)는 지원하지 않습니다. 한컴오피스에서 HWPX로 변환 후 사용하세요.
+> HWP 5.0(`.hwp`)은 `HwpxDocument.open`으로 열어 같은 API로 편집하고,
+> `save_to_path("x.hwp")`로 HWP로 저장합니다. 옮기지 못한 내용은
+> `document.conversion_report`에 남고, 암호·배포용 문서는 `Hwp5Error`로 거부합니다.
 
 ## 알려진 제약
 
@@ -181,7 +168,7 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
   열지 못하는 파일이 됩니다(호출 시 경고만 나옵니다). 도형은 `add_line()` /
   `add_rectangle()` / `add_ellipse()`를 쓰세요.
 - 그림은 단순 개체 생성까지 지원합니다 (그룹·효과 미지원).
-- 암호화된 HWPX는 지원하지 않습니다.
+- 암호화된 HWPX와 암호·배포용 HWP는 지원하지 않습니다.
 
 ## 기여하기
 

{python_hwpx-6.5.0 → python_hwpx-6.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "6.5.0"
+version = "6.7.0"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
@@ -109,6 +109,9 @@ packages = [
     "hwpx.data",
     "hwpx.equation",
     "hwpx.form_fit",
+    # HWP 5.0(.hwp) 읽기·쓰기. `hwpx/__init__.py`가 이 패키지를 가져오므로 빠지면
+    # 휠에서 `import hwpx`가 깨진다.
+    "hwpx.hwp5",
     "hwpx.ingest",
     "hwpx.layout",
     # 6.0: add_* 가 반환하는 도메인 객체·결과 dataclass (WP-C가 채운다).
@@ -283,6 +286,48 @@ files = [
     # headroom -- same escape valve as dutmal_compose.py/objects.py/
     # field_marks.py above, per the WP-A rule.
     "src/hwpx/oxml/note_authoring.py",
+    # Grid clean-up after a cell merge (rows left without cells, columns no
+    # cell starts at) moved out of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_merge.py",
+    # Hyperlink field target form (Hancom's Command/Path parameters,
+    # written and read in one place) -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/hyperlink_form.py",
+    # Table width/height distribution (distribute cell width row by row) moved out
+    # of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_sizes.py",
+    # A paragraph shape's heading (outline levels 8 to 10 in Hancom's hp:switch form),
+    # written and read in one place -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/paragraph_heading.py",
+    # Floating-shape reference frames (set_position) and shape-text
+    # vertical alignment -- objects.py's overflow module (1600-line cap),
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/shape_position.py",
+    # Font table and border-fill reads plus replace_font (header.xml) --
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/header_fonts.py",
+    # HWP 5.0 (.hwp) container and record layer -- born in the gate, per the
+    # WP-A rule.
+    "src/hwpx/hwp5/__init__.py",
+    "src/hwpx/hwp5/bodytext.py",
+    "src/hwpx/hwp5/cfb.py",
+    "src/hwpx/hwp5/docinfo.py",
+    "src/hwpx/hwp5/errors.py",
+    "src/hwpx/hwp5/fileheader.py",
+    "src/hwpx/hwp5/reader.py",
+    "src/hwpx/hwp5/records.py",
+    "src/hwpx/hwp5/binary.py",
+    "src/hwpx/hwp5/header_xml.py",
+    "src/hwpx/hwp5/owpml.py",
+    "src/hwpx/hwp5/package.py",
+    "src/hwpx/hwp5/section_xml.py",
+    "src/hwpx/hwp5/summary.py",
+    "src/hwpx/hwp5/controls.py",
+    "src/hwpx/hwp5/docinfo_writer.py",
+    "src/hwpx/hwp5/section_writer.py",
+    "src/hwpx/hwp5/shapes.py",
+    "src/hwpx/hwp5/section_common.py",
+    "src/hwpx/hwp5/shape_xml.py",
+    "src/hwpx/hwp5/writer.py",
 ]
 # 칩 후보 1 ✅ 6.14 트레인㊾-1에서 해소: `src/hwpx/table_patch.py`(2073줄,
 # 6.12 트레인㊸ 갭⑤ 정리 시 team-lead가 지목, f7e4e67 리뷰) — 위 files
@@ -450,6 +495,48 @@ include = [
     # headroom -- same escape valve as dutmal_compose.py/objects.py/
     # field_marks.py above, per the WP-A rule.
     "src/hwpx/oxml/note_authoring.py",
+    # Grid clean-up after a cell merge (rows left without cells, columns no
+    # cell starts at) moved out of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_merge.py",
+    # Hyperlink field target form (Hancom's Command/Path parameters,
+    # written and read in one place) -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/hyperlink_form.py",
+    # Table width/height distribution (distribute cell width row by row) moved out
+    # of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_sizes.py",
+    # A paragraph shape's heading (outline levels 8 to 10 in Hancom's hp:switch form),
+    # written and read in one place -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/paragraph_heading.py",
+    # Floating-shape reference frames (set_position) and shape-text
+    # vertical alignment -- objects.py's overflow module (1600-line cap),
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/shape_position.py",
+    # Font table and border-fill reads plus replace_font (header.xml) --
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/header_fonts.py",
+    # HWP 5.0 (.hwp) container and record layer -- born in the gate, per the
+    # WP-A rule.
+    "src/hwpx/hwp5/__init__.py",
+    "src/hwpx/hwp5/bodytext.py",
+    "src/hwpx/hwp5/cfb.py",
+    "src/hwpx/hwp5/docinfo.py",
+    "src/hwpx/hwp5/errors.py",
+    "src/hwpx/hwp5/fileheader.py",
+    "src/hwpx/hwp5/reader.py",
+    "src/hwpx/hwp5/records.py",
+    "src/hwpx/hwp5/binary.py",
+    "src/hwpx/hwp5/header_xml.py",
+    "src/hwpx/hwp5/owpml.py",
+    "src/hwpx/hwp5/package.py",
+    "src/hwpx/hwp5/section_xml.py",
+    "src/hwpx/hwp5/summary.py",
+    "src/hwpx/hwp5/controls.py",
+    "src/hwpx/hwp5/docinfo_writer.py",
+    "src/hwpx/hwp5/section_writer.py",
+    "src/hwpx/hwp5/shapes.py",
+    "src/hwpx/hwp5/section_common.py",
+    "src/hwpx/hwp5/shape_xml.py",
+    "src/hwpx/hwp5/writer.py",
 ]
 pythonVersion = "3.10"
 typeCheckingMode = "basic"

{python_hwpx-6.5.0 → python_hwpx-6.7.0}/src/hwpx/__init__.py

@@ -45,6 +45,10 @@ _EXPERIMENTAL_EXPORTS = {
     "LayoutPreview": "hwpx.tools.layout_preview",
     "PreviewPage": "hwpx.tools.layout_preview",
     "render_layout_preview": "hwpx.tools.layout_preview",
+    # 쪽 수 추정(한/글 없이, 줄마다 쪽·단·세로 위치). 계약 유동.
+    "EstimatedLine": "hwpx.layout.pages",
+    "PageEstimate": "hwpx.layout.pages",
+    "estimate_pages": "hwpx.layout.pages",
     # 문서 프리뷰 뷰어(3.8.0 신규). 계약 유동.
     "DocumentViewer": "hwpx.tools.document_viewer",
     "render_document_viewer": "hwpx.tools.document_viewer",
@@ -347,6 +351,13 @@ def __dir__() -> list[str]:
     )
 
 
+# ``import hwpx.builder`` goes through the import system, not ``__getattr__``,
+# so the moved module names get their destination from a finder instead.
+from . import _moved_modules
+
+_moved_modules.install(_MOVED_TO_COMPANION)
+
+
 # --- stable 최상위 표면 (eager import) ------------------------------------------
 from .tools.text_extractor import (
     DEFAULT_NAMESPACES,
@@ -376,6 +387,7 @@ from .tools.package_validator import (
 )
 from .ingest import HwpxMarkdownConverter
 from .errors import HwpxError
+from .hwp5.errors import Hwp5ConversionWarning, Hwp5Error
 from .mutation_report import (
     MutationReport,
     PreservationDowngradeError,
@@ -415,6 +427,8 @@ __all__ = [
     "PackageValidationReport",
     "BytePreservingPatchResult",
     "HwpxError",
+    "Hwp5Error",
+    "Hwp5ConversionWarning",
     "MutationReport",
     "PreservationDowngradeError",
     "ParagraphTextPatch",

{python_hwpx-6.5.0 → python_hwpx-6.7.0}/src/hwpx/_document/_legacy.py

@@ -615,7 +615,7 @@ class _LegacyFacade:
         field_id: str | None = None,
         author: str | None = None,
         created: datetime | str | None = None,
-        number: int = 1,
+        number: int | None = None,
         anchor_char_pr_id_ref: str | int | None = None,
     ) -> tuple[HwpxOxmlMemo, HwpxOxmlParagraph, str]:
         """Create a memo and ensure it is visible by anchoring a MEMO field."""
@@ -801,7 +801,7 @@ class _LegacyFacade:
         field_id: str | None = None,
         author: str | None = None,
         created: datetime | str | None = None,
-        number: int = 1,
+        number: int | None = None,
         char_pr_id_ref: str | int | None = None,
     ) -> str:
         """Attach a MEMO field control to *paragraph* so Hangul shows *memo*."""
@@ -1241,7 +1241,9 @@ class _LegacyFacade:
         """Remove an embedded image by its manifest item id.
 
         This removes the binary data from the ZIP, the manifest entry, and
-        the header binItem entry.
+        the header binItem entry. An item the document still points at is
+        refused with ``HwpxValueError`` (code ``media-item-in-use``);
+        ``doc.media.remove_image(item_id, force=True)`` removes it anyway.
 
         Returns:
             ``True`` if any component was removed.