python-hwpx-automation 7.2.0__tar.gz → 7.3.2__tar.gz

{python_hwpx_automation-7.2.0/src/python_hwpx_automation.egg-info → python_hwpx_automation-7.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 7.2.0
+Version: 7.3.2
 Summary: Task-oriented HWPX document automation for Python, with an optional MCP adapter.
 Author: Kohkyuhyun
 License-Expression: Apache-2.0
@@ -74,11 +74,10 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 발행이 승인된 7.2.0 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.5.0 → python-hwpx-automation 7.2.0 → hwpx-plugin 2.3.0` (`5e5c23651f92785a`).
-> 공개 트레인: `python-hwpx 6.4.0 → python-hwpx-automation 7.1.0 → hwpx-plugin 2.2.0` (`ba0211fc854a0a97`).
+> 발행이 승인된 7.3.2 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.2 → hwpx-plugin 2.4.0` (`5e5c23651f92785a`).
+> 공개 트레인: `python-hwpx 6.6.0 → python-hwpx-automation 7.3.1 → hwpx-plugin 2.4.0`.
 > 공개 좌표는 core·automation PyPI와 plugin GitHub
 > Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
-> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -132,7 +131,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==7.1.0",
+        "python-hwpx-automation[mcp]==7.3.1",
         "hwpx-automation-mcp"
       ],
       "env": {
@@ -151,10 +150,23 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 
 > 비-HWPX 문서(PDF/DOCX/XLSX/HTML/TXT)를 `document_to_markdown`으로 읽으려면
 > `pip install "python-hwpx-automation[ingest]"`로 MarkItDown adapter를 함께
-> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 5.0.0`.
+> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 6.5.0`.
 
-기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 6.x 동안 그대로 동작합니다 —
-전체 목록과 유지 규칙: [6.x 호환 표면](docs/compatibility-6x.md)
+기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 그대로 동작합니다 —
+전체 목록과 유지 규칙: [호환 표면](docs/compatibility-6x.md)
+
+## 한컴으로 PDF 렌더하기
+
+한컴(macOS 한컴오피스 한글 또는 Windows 한글 COM)이 있는 컴퓨터에서 문서 하나를
+PDF와 쪽 PNG로 렌더합니다. 별도 환경에서 실행하므로 호출하는 쪽의 python-hwpx
+고정 버전을 건드리지 않습니다.
+
+```bash
+uvx --from "python-hwpx-automation[oracle]==7.3.2" \
+  hwpx render-pdf in.hwpx out.pdf --png out/page --json
+```
+
+JSON 결과·종료 코드·플랫폼 요구 사항: [render-pdf](docs/render-pdf.md)
 
 ## 무엇을 하나
 
@@ -171,7 +183,8 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 
 ## 안전하게 쓰는 법
 
-처음부터 모든 도구를 외울 필요는 없습니다. 보통 이렇게 흘러갑니다.
+처음부터 모든 도구를 외울 필요는 없습니다. 기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를,
+새 문서는 document-plan을 먼저 봅니다. 보통 이렇게 흘러갑니다.
 
 1. **읽기** — `get_document_info` → `get_document_outline`/`get_document_text` → `find_text`, `get_table_map`으로 필요한 부분만 파악합니다. (저장하지 않음)
 2. **안전 수정** — `copy_document`로 사본을 만들고, 가장 작은 변경(`search_and_replace`, `set_table_cell_text`, `apply_document_commands`)을 적용한 뒤 다시 읽어 확인하고, 검토가 끝난 사본을 전달합니다.
@@ -184,7 +197,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 열림안전을 검사하고, 게이트가 실패하면 아무것도 쓰지 않습니다. capability
 handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단합니다.
 보안 상세: [하드닝 가이드](docs/hardening_guide_ko.md) · 옛 이름과의 호환
-식별자: [6.x 호환 표면](docs/compatibility-6x.md)
+식별자: [호환 표면](docs/compatibility-6x.md)
 
 > **위치 계약** — `paragraph_index`는 본문 직속 문단의 0-based 인덱스입니다. 표 안 문단은 여기 섞지 않고
 > `{"kind":"table_cell_paragraph","table_index":0,"row":0,"col":1,"cell_paragraph_index":0}` 같은 `location`
@@ -205,10 +218,10 @@ handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단
 | `HWPX_AUTOMATION_WORKFLOW_STORE` | durable workflow SQLite 경로. 기존 `HWPX_WORKFLOW_STORE`보다 우선 | 기존 6.x 상태 경로 |
 | `LOG_LEVEL` | 로그 레벨 | `INFO` |
 
-동일 suffix의 기존 `HWPX_MCP_*` 키는 6.x 동안 fallback으로 유지되며, 두 키가
+동일 suffix의 기존 `HWPX_MCP_*` 키는 fallback으로 유지되며, 두 키가
 함께 있으면 `HWPX_AUTOMATION_*`이 우선합니다. render·workflow·oracle·plugin
 연동용 보존 키 전체 목록과 workflow DB 경로 규칙은
-[6.x 호환 표면](docs/compatibility-6x.md)에 있습니다.
+[호환 표면](docs/compatibility-6x.md)에 있습니다.
 
 경로는 기본적으로 workspace 밖 traversal과 symlink escape를 거부하고, URL 입력은 HTTPS·공개 IP만
 허용합니다. 원자 rename을 제공하지 않는 호스트의 동시성 주의사항은 [하드닝 가이드](docs/hardening_guide_ko.md)를 보세요.
@@ -239,5 +252,3 @@ python scripts/run_conformance.py run \
 ## License · Maintainer
 
 Apache-2.0 ([LICENSE](LICENSE) · [NOTICE](NOTICE)) — **Kohkyuhyun** [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
-
-기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를 먼저 확인하세요. 새 문서는 document-plan, 에이전트 연결은 선택 MCP와 호스트 플러그인을 사용합니다.

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/README.md

@@ -14,11 +14,10 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 발행이 승인된 7.2.0 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.5.0 → python-hwpx-automation 7.2.0 → hwpx-plugin 2.3.0` (`5e5c23651f92785a`).
-> 공개 트레인: `python-hwpx 6.4.0 → python-hwpx-automation 7.1.0 → hwpx-plugin 2.2.0` (`ba0211fc854a0a97`).
+> 발행이 승인된 7.3.2 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.2 → hwpx-plugin 2.4.0` (`5e5c23651f92785a`).
+> 공개 트레인: `python-hwpx 6.6.0 → python-hwpx-automation 7.3.1 → hwpx-plugin 2.4.0`.
 > 공개 좌표는 core·automation PyPI와 plugin GitHub
 > Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
-> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -72,7 +71,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==7.1.0",
+        "python-hwpx-automation[mcp]==7.3.1",
         "hwpx-automation-mcp"
       ],
       "env": {
@@ -91,10 +90,23 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 
 > 비-HWPX 문서(PDF/DOCX/XLSX/HTML/TXT)를 `document_to_markdown`으로 읽으려면
 > `pip install "python-hwpx-automation[ingest]"`로 MarkItDown adapter를 함께
-> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 5.0.0`.
+> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 6.5.0`.
 
-기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 6.x 동안 그대로 동작합니다 —
-전체 목록과 유지 규칙: [6.x 호환 표면](docs/compatibility-6x.md)
+기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 그대로 동작합니다 —
+전체 목록과 유지 규칙: [호환 표면](docs/compatibility-6x.md)
+
+## 한컴으로 PDF 렌더하기
+
+한컴(macOS 한컴오피스 한글 또는 Windows 한글 COM)이 있는 컴퓨터에서 문서 하나를
+PDF와 쪽 PNG로 렌더합니다. 별도 환경에서 실행하므로 호출하는 쪽의 python-hwpx
+고정 버전을 건드리지 않습니다.
+
+```bash
+uvx --from "python-hwpx-automation[oracle]==7.3.2" \
+  hwpx render-pdf in.hwpx out.pdf --png out/page --json
+```
+
+JSON 결과·종료 코드·플랫폼 요구 사항: [render-pdf](docs/render-pdf.md)
 
 ## 무엇을 하나
 
@@ -111,7 +123,8 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 
 ## 안전하게 쓰는 법
 
-처음부터 모든 도구를 외울 필요는 없습니다. 보통 이렇게 흘러갑니다.
+처음부터 모든 도구를 외울 필요는 없습니다. 기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를,
+새 문서는 document-plan을 먼저 봅니다. 보통 이렇게 흘러갑니다.
 
 1. **읽기** — `get_document_info` → `get_document_outline`/`get_document_text` → `find_text`, `get_table_map`으로 필요한 부분만 파악합니다. (저장하지 않음)
 2. **안전 수정** — `copy_document`로 사본을 만들고, 가장 작은 변경(`search_and_replace`, `set_table_cell_text`, `apply_document_commands`)을 적용한 뒤 다시 읽어 확인하고, 검토가 끝난 사본을 전달합니다.
@@ -124,7 +137,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 열림안전을 검사하고, 게이트가 실패하면 아무것도 쓰지 않습니다. capability
 handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단합니다.
 보안 상세: [하드닝 가이드](docs/hardening_guide_ko.md) · 옛 이름과의 호환
-식별자: [6.x 호환 표면](docs/compatibility-6x.md)
+식별자: [호환 표면](docs/compatibility-6x.md)
 
 > **위치 계약** — `paragraph_index`는 본문 직속 문단의 0-based 인덱스입니다. 표 안 문단은 여기 섞지 않고
 > `{"kind":"table_cell_paragraph","table_index":0,"row":0,"col":1,"cell_paragraph_index":0}` 같은 `location`
@@ -145,10 +158,10 @@ handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단
 | `HWPX_AUTOMATION_WORKFLOW_STORE` | durable workflow SQLite 경로. 기존 `HWPX_WORKFLOW_STORE`보다 우선 | 기존 6.x 상태 경로 |
 | `LOG_LEVEL` | 로그 레벨 | `INFO` |
 
-동일 suffix의 기존 `HWPX_MCP_*` 키는 6.x 동안 fallback으로 유지되며, 두 키가
+동일 suffix의 기존 `HWPX_MCP_*` 키는 fallback으로 유지되며, 두 키가
 함께 있으면 `HWPX_AUTOMATION_*`이 우선합니다. render·workflow·oracle·plugin
 연동용 보존 키 전체 목록과 workflow DB 경로 규칙은
-[6.x 호환 표면](docs/compatibility-6x.md)에 있습니다.
+[호환 표면](docs/compatibility-6x.md)에 있습니다.
 
 경로는 기본적으로 workspace 밖 traversal과 symlink escape를 거부하고, URL 입력은 HTTPS·공개 IP만
 허용합니다. 원자 rename을 제공하지 않는 호스트의 동시성 주의사항은 [하드닝 가이드](docs/hardening_guide_ko.md)를 보세요.
@@ -179,5 +192,3 @@ python scripts/run_conformance.py run \
 ## License · Maintainer
 
 Apache-2.0 ([LICENSE](LICENSE) · [NOTICE](NOTICE)) — **Kohkyuhyun** [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
-
-기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를 먼저 확인하세요. 새 문서는 document-plan, 에이전트 연결은 선택 MCP와 호스트 플러그인을 사용합니다.

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "7.2.0"
+version = "7.3.2"
 description = "Task-oriented HWPX document automation for Python, with an optional MCP adapter."
 readme = "README.md"
 authors = [{ name = "Kohkyuhyun" }]

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/form_fill.py

@@ -1122,10 +1122,15 @@ def _runtime_validation(path: str) -> dict[str, Any]:
         {
             "part": getattr(issue, "part_name", None),
             "message": getattr(issue, "message", str(issue)),
+            "severity": getattr(issue, "severity", "error"),
         }
         for issue in getattr(document_report, "issues", ())
     ]
-    structure = {"ok": not structure_issues, "issues": structure_issues}
+    # a schema warning from python-hwpx does not block the hand-off; only its errors do
+    structure = {
+        "ok": not any(issue["severity"] == "error" for issue in structure_issues),
+        "issues": structure_issues,
+    }
     if validate_package is None:
         package = _dependency_unavailable_report(
             "python-hwpx>=2.10.3 is required for HWPX package validation",
@@ -1208,7 +1213,7 @@ def _issue_payload(issue: Any) -> dict[str, Any]:
     return {
         "part": getattr(issue, "part_name", None),
         "message": getattr(issue, "message", str(issue)),
-        "level": getattr(issue, "level", "error"),
+        "level": getattr(issue, "severity", "error"),
     }
 
 

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/identity.json

@@ -5,28 +5,28 @@
   "releaseState": {
     "status": "release-approved",
     "candidate": {
-      "pythonHwpx": "6.5.0",
+      "pythonHwpx": "6.6.0",
       "canonicalDistribution": "python-hwpx-automation",
-      "canonicalAutomation": "7.2.0",
+      "canonicalAutomation": "7.3.2",
       "compatibilityDistribution": "hwpx-mcp-server",
-      "compatibility": "7.2.0",
-      "plugin": "2.3.0",
+      "compatibility": "7.3.2",
+      "plugin": "2.4.0",
       "contractHash": "5e5c23651f92785a"
     },
     "currentPublic": {
-      "pythonHwpx": "6.4.0",
+      "pythonHwpx": "6.6.0",
       "primaryDistribution": "python-hwpx-automation",
-      "primaryApplication": "7.1.0",
-      "plugin": "2.2.0",
-      "contractHash": "ba0211fc854a0a97"
+      "primaryApplication": "7.3.1",
+      "plugin": "2.4.0",
+      "contractHash": "5e5c23651f92785a"
     },
     "promotionGate": "Three states are mandatory: unreleased-candidate while auditing; release-approved only after separate owner approval and while currentPublic still names the previously observed coherent stack; released only in a follow-up commit after remote truth is observed for core, canonical automation, the compatibility distribution, the plugin GitHub release, the marketplace entry, and a real marketplace install. The automation tag workflow publishes only release-approved, leaves currentPublic unchanged, and hands an attached receipt to plugin publication.",
     "previousPublic": {
-      "pythonHwpx": "6.4.0",
+      "pythonHwpx": "6.6.0",
       "primaryDistribution": "python-hwpx-automation",
-      "primaryApplication": "7.1.0",
-      "plugin": "2.2.0",
-      "contractHash": "ba0211fc854a0a97"
+      "primaryApplication": "7.3.1",
+      "plugin": "2.4.0",
+      "contractHash": "5e5c23651f92785a"
     },
     "publicationEvidence": null
   },

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/office/agent/blueprint/native.py

@@ -19,6 +19,15 @@ from ..model import AgentContractError
 
 _HWP_UNITS_PER_MM = 7200 / 25.4
 _INLINE_KINDS = frozenset({"table", "picture", "shape", "footnote", "endnote"})
+#: Names a blueprint may give a click-here field. Hancom opens the field only
+#: under its own type name, CLICK_HERE.
+_CLICK_HERE_NAMES = frozenset({"FORM", "CLICKHERE", "NURUMTUL", "누름틀"})
+
+
+def hancom_field_type(field_type: object) -> str | None:
+    """CLICK_HERE for any name of a click-here field, None for another field type."""
+    normalized = str(field_type or "ClickHere").replace("_", "").replace("-", "").upper()
+    return "CLICK_HERE" if normalized in _CLICK_HERE_NAMES else None
 
 
 @dataclass(frozen=True, slots=True)
@@ -463,9 +472,8 @@ class TypedNativeBridge:
     def _create_form_field(self, node_id: str, paragraph: Any) -> None:
         node = self.nodes[node_id]
         properties = node["properties"]
-        field_type = str(properties.get("fieldType") or "ClickHere")
-        normalized_type = field_type.replace("_", "").replace("-", "").upper()
-        if normalized_type not in {"FORM", "CLICKHERE", "NURUMTUL", "누름틀"}:
+        field_type = hancom_field_type(properties.get("fieldType"))
+        if field_type is None:
             raise AgentContractError("unsupported_content", "only FORM fields are replayable", target=node_id)
         host_id = self.references.get((node_id, "hostRun"))
         end_id = self.references.get((node_id, "endRun"))
@@ -486,7 +494,7 @@ class TypedNativeBridge:
                 "id": begin_id,
                 "fieldid": field_id,
                 "name": str(properties.get("name") or "")[:512],
-                "type": "CLICK_HERE" if normalized_type in {"FORM", "CLICKHERE"} else field_type,
+                "type": field_type,
                 "editable": "0" if properties.get("readOnly") else "1",
                 "dirty": "0",
                 "zorder": "-1",

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/office/agent/blueprint/replay.py

@@ -23,7 +23,7 @@ from .bundle import BlueprintBundle, read_blueprint_bundle
 from .dump import dump_document_blueprint
 from .mapping import ReplayPlan, materialize_dependencies, plan_replay
 from .model import BlueprintReplayResult, validate_replay_request
-from .native import CreatedBinding, TypedNativeBridge
+from .native import CreatedBinding, TypedNativeBridge, hancom_field_type
 
 IdempotencyStore = MutableMapping[str, Any]
 FaultInjector = Callable[[str, int | None], None]
@@ -80,6 +80,9 @@ def _semantic_nodes(
             identity = mapped.get("identity") if mapped else None
             if isinstance(identity, Mapping) and identity.get("name"):
                 properties["style"] = identity["name"]
+        if node["kind"] == "form-field" and "fieldType" in properties:
+            # A click-here field is written, and so read back, as CLICK_HERE whatever the blueprint called it.
+            properties["fieldType"] = hancom_field_type(properties["fieldType"]) or properties["fieldType"]
         normalized.append(
             {
                 "blueprintId": str(node["blueprintId"]),

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/office/agent/cli.py

@@ -591,10 +591,18 @@ def main(
     stdin = cast(TextIO, stdin or sys.stdin)
     stdout = cast(TextIO, stdout or sys.stdout)
     stderr = cast(TextIO, stderr or sys.stderr)
+    arguments = list(argv) if argv is not None else sys.argv[1:]
+    # Dispatched ahead of the parser, whose help and choice errors stay
+    # byte-identical to the frozen core CLI. The rendering owner is imported
+    # only here, so every other command stays free of the Hancom side.
+    if arguments[:1] == ["render-pdf"]:
+        from ..rendering.cli import main as render_main
+
+        return render_main(arguments, prog="hwpx", stdout=stdout, stderr=stderr)
     parser = build_parser()
     try:
         with contextlib.redirect_stdout(stdout), contextlib.redirect_stderr(stderr):
-            args = parser.parse_args(list(argv) if argv is not None else None)
+            args = parser.parse_args(arguments)
         if args.command == "help":
             if args.kind == "blueprint":
                 if args.json_help:

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/office/agent/commands.py

@@ -73,6 +73,8 @@ _PARAGRAPH_ALIGNMENTS = frozenset(
 _TABLE_ALIGNMENTS = frozenset({"LEFT", "CENTER", "RIGHT", "INSIDE", "OUTSIDE"})
 _VERTICAL_ALIGNMENTS = frozenset({"TOP", "CENTER", "BOTTOM"})
 _INLINE_KINDS = frozenset({"table", "picture", "shape", "footnote", "endnote"})
+#: Notes sit in an hp:ctrl: Hancom drops a note outside one and crashes on an empty one.
+_NOTE_TAGS = frozenset({"footNote", "endNote"})
 _SHAPE_KINDS = frozenset({"line", "rect", "ellipse", "arc", "polygon", "curve", "connectLine"})
 
 # Creation needs a few geometry fields that are readable, rather than editable,
@@ -450,7 +452,12 @@ def _insert_inline(
         _tag_like(paragraph.element, "run"),
         {"charPrIDRef": paragraph.char_pr_id_ref or "0"},
     )
-    run.append(element)
+    if _local_name(element) in _NOTE_TAGS:
+        control = run.makeelement(_tag_like(paragraph.element, "ctrl"), {})
+        control.append(element)
+        run.append(control)
+    else:
+        run.append(element)
     if index >= len(siblings):
         paragraph.element.append(run)
     else:
@@ -458,6 +465,8 @@ def _insert_inline(
         anchor_run = anchor.getparent() if hasattr(anchor, "getparent") else next(
             child for child in paragraph.element if anchor in list(child)
         )
+        if _local_name(anchor_run) == "ctrl":
+            anchor_run = anchor_run.getparent()
         paragraph.element.insert(list(paragraph.element).index(anchor_run), run)
     paragraph.section.mark_dirty()
     return run
@@ -468,6 +477,9 @@ def _remove_inline_element(element: Any, paragraph: Any) -> None:
         child for child in paragraph.element if element in list(child)
     )
     run.remove(element)
+    if _local_name(run) == "ctrl" and not list(run):
+        control, run = run, run.getparent()
+        run.remove(control)
     if not list(run) and run in list(paragraph.element):
         paragraph.element.remove(run)
     paragraph.section.mark_dirty()

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/office/agent/document.py

@@ -55,6 +55,15 @@ def _mm(value: object) -> float | None:
     return round(units / _HWP_UNITS_PER_MM, 3)
 
 
+def _drawn_page_size(page_size: Any) -> tuple[int, int]:
+    """Width and height as Hancom draws the page: as stored for
+    ``landscape="WIDELY"`` (portrait), turned otherwise (``NARROWLY``)."""
+
+    if page_size.orientation == "WIDELY":
+        return page_size.width, page_size.height
+    return page_size.height, page_size.width
+
+
 def _first_child(element: Any, local_name: str) -> Any | None:
     for child in element:
         if _local_name(child) == local_name:
@@ -249,7 +258,7 @@ class HwpxAgentDocument:
         self._add_record(root)
         for section_index, section in enumerate(self.document.sections, start=1):
             section_path = SemanticPath().child(indexed_segment("section", section_index))
-            page_size = section.properties.page_size
+            page_width, page_height = _drawn_page_size(section.properties.page_size)
             section_record = NodeRecord(
                 kind="section",
                 path=section_path.canonical,
@@ -259,8 +268,8 @@ class HwpxAgentDocument:
                     "index": section_index,
                     "partId": Path(section.part_name).name,
                     "paragraphCount": len(section.paragraphs),
-                    "pageWidthMm": _mm(page_size.width),
-                    "pageHeightMm": _mm(page_size.height),
+                    "pageWidthMm": _mm(page_width),
+                    "pageHeightMm": _mm(page_height),
                 },
                 native=section,
                 parent_path="/",

{python_hwpx_automation-7.2.0 → python_hwpx_automation-7.3.2}/src/hwpx_automation/office/authoring/__init__.py

@@ -2030,6 +2030,10 @@ def _normalize_v2_page(value: Any) -> BuilderPageSize | None:
     width = _float_value(value.get("widthMm", value.get("width_mm")), default=210)
     height = _float_value(value.get("heightMm", value.get("height_mm")), default=297)
     orientation = str(value.get("orientation") or "PORTRAIT").strip() or "PORTRAIT"
+    # Hancom's own landscape values, as read from a document: WIDELY is
+    # portrait, NARROWLY landscape. Hand the builder the plain names so every
+    # python-hwpx version draws the same page.
+    orientation = {"WIDELY": "PORTRAIT", "NARROWLY": "LANDSCAPE"}.get(orientation.upper(), orientation)
     return BuilderPageSize(width_mm=width, height_mm=height, orientation=orientation)
 
 
@@ -2681,7 +2685,10 @@ def _flow_oversized_authored_table(table: Any) -> None:
     section = table.paragraph.section
     page = section.properties.page_size
     margins = section.properties.page_margins
-    body_height = page.height - margins.top - margins.bottom
+    # Hancom turns every page but landscape="WIDELY", so a landscape page's
+    # drawn height is its stored width.
+    drawn_height = page.height if page.orientation == "WIDELY" else page.width
+    body_height = drawn_height - margins.top - margins.bottom
     if body_height > 0 and table.height > body_height:
         table.set_treat_as_char(False)