python-hwpx 2.11.0__tar.gz → 2.11.1__tar.gz

{python_hwpx-2.11.0/src/python_hwpx.egg-info → python_hwpx-2.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.11.0
+Version: 2.11.1
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -261,6 +261,19 @@ HWPX 파일은 **ZIP + XML** 구조이므로, 한/글 프로그램 없이 Python
 | 🧰 **작업 도구** | unpack/pack/분석/비교 | pack-ready 작업 디렉터리 추출과 재구성 점검 |
 | 🏗️ **저수준 XML** | 데이터클래스 매핑 | OWPML 스키마 ↔ Python 객체 직접 조작 |
 | 🔄 **네임스페이스 호환** | 자동 정규화 | HWPML 2016 → 2011 자동 변환 |
+| 🏗️ **빌더** | 조립형 생성 | `hwpx.builder` — Section/Heading/Table/Image/Header 조립, 하드게이트 저장 리포트 |
+| ✅ **편집기 오픈 안전** | `validate_editor_open_safety` | 저장/팩/리페어/빌더 출력 게이트, `openSafety` 증거 반환 |
+| 🧪 **퍼징 수렴 루프** | `hwpx.tools.fuzz` | 시드 결정적 시나리오 생성 · 3중 오라클 러너 · 회귀 fixture 박제 |
+| 🖥️ **레이아웃 프리뷰** | `hwpx.tools.layout_preview` | 페이지 박스·표·여백 근사 HTML/PNG (에이전트 자기검증용) |
+| 🧷 **바이트 보존 패치** | `hwpx.patch` | section XML 바이트 splice — 미수정 영역 바이트 보존 |
+| 📐 **기존 문서 서식 편집** | 문단·페이지 | 정렬·줄간격·들여쓰기·문단 간격, 용지·여백·방향, 머리말/쪽번호, 불릿/번호 |
+| 🖊️ **누름틀** | 양식 필드 | 클릭히어 필드 조회·서식 보존 채움 |
+| 🏛️ **공문서 도구** | `official_lint` · 결재란 | 항목기호 위계·"끝." 표시·붙임·날짜 표기 lint, 결재란 프리셋 |
+| 📷 **고급 생성기** | `advanced_generators` | 사진대지(image_grid)·회의 명패·표 기반 조직도 |
+| 🆚 **신구대조** | `doc_diff` | 문단 LCS diff·신구대조표 생성·참조 정합 lint |
+| 📨 **메일머지·표 계산** | `mail_merge` | 템플릿+데이터 N부 대량 생성, 표 합계·평균 |
+| 🪄 **서식 이식** | `style_profile` | 참조 문서 프로파일 추출·적용, 템플릿 레지스트리 |
+| 🛡️ **입력 강건화** | `opc.security` | XML entity 폭탄·ZIP 압축 폭탄 가드 |
 
 ## 기능 상세
 

{python_hwpx-2.11.0 → python_hwpx-2.11.1}/README.md

@@ -225,6 +225,19 @@ HWPX 파일은 **ZIP + XML** 구조이므로, 한/글 프로그램 없이 Python
 | 🧰 **작업 도구** | unpack/pack/분석/비교 | pack-ready 작업 디렉터리 추출과 재구성 점검 |
 | 🏗️ **저수준 XML** | 데이터클래스 매핑 | OWPML 스키마 ↔ Python 객체 직접 조작 |
 | 🔄 **네임스페이스 호환** | 자동 정규화 | HWPML 2016 → 2011 자동 변환 |
+| 🏗️ **빌더** | 조립형 생성 | `hwpx.builder` — Section/Heading/Table/Image/Header 조립, 하드게이트 저장 리포트 |
+| ✅ **편집기 오픈 안전** | `validate_editor_open_safety` | 저장/팩/리페어/빌더 출력 게이트, `openSafety` 증거 반환 |
+| 🧪 **퍼징 수렴 루프** | `hwpx.tools.fuzz` | 시드 결정적 시나리오 생성 · 3중 오라클 러너 · 회귀 fixture 박제 |
+| 🖥️ **레이아웃 프리뷰** | `hwpx.tools.layout_preview` | 페이지 박스·표·여백 근사 HTML/PNG (에이전트 자기검증용) |
+| 🧷 **바이트 보존 패치** | `hwpx.patch` | section XML 바이트 splice — 미수정 영역 바이트 보존 |
+| 📐 **기존 문서 서식 편집** | 문단·페이지 | 정렬·줄간격·들여쓰기·문단 간격, 용지·여백·방향, 머리말/쪽번호, 불릿/번호 |
+| 🖊️ **누름틀** | 양식 필드 | 클릭히어 필드 조회·서식 보존 채움 |
+| 🏛️ **공문서 도구** | `official_lint` · 결재란 | 항목기호 위계·"끝." 표시·붙임·날짜 표기 lint, 결재란 프리셋 |
+| 📷 **고급 생성기** | `advanced_generators` | 사진대지(image_grid)·회의 명패·표 기반 조직도 |
+| 🆚 **신구대조** | `doc_diff` | 문단 LCS diff·신구대조표 생성·참조 정합 lint |
+| 📨 **메일머지·표 계산** | `mail_merge` | 템플릿+데이터 N부 대량 생성, 표 합계·평균 |
+| 🪄 **서식 이식** | `style_profile` | 참조 문서 프로파일 추출·적용, 템플릿 레지스트리 |
+| 🛡️ **입력 강건화** | `opc.security` | XML entity 폭탄·ZIP 압축 폭탄 가드 |
 
 ## 기능 상세
 

{python_hwpx-2.11.0 → python_hwpx-2.11.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "2.11.0"
+version = "2.11.1"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"

{python_hwpx-2.11.0 → python_hwpx-2.11.1}/src/hwpx/authoring.py

@@ -168,16 +168,30 @@ class DocumentStylePreset:
     heading_bold: bool = True
     heading_underline: bool = True
     table_header_bold: bool = True
+    title_size: int = 18
+    subtitle_size: int = 12
+    heading_size: int = 14
+    font: str = "함초롬바탕"
 
     def ensure_tokens(self, document: HwpxDocument) -> dict[str, str]:
         """Create/reuse run styles and return semantic token IDs."""
 
         return {
-            "title": document.ensure_run_style(bold=self.title_bold),
-            "subtitle": document.ensure_run_style(italic=self.subtitle_italic),
+            "title": document.ensure_run_style(
+                bold=self.title_bold,
+                size=self.title_size,
+                font=self.font,
+            ),
+            "subtitle": document.ensure_run_style(
+                italic=self.subtitle_italic,
+                size=self.subtitle_size,
+                font=self.font,
+            ),
             "heading": document.ensure_run_style(
                 bold=self.heading_bold,
                 underline=self.heading_underline,
+                size=self.heading_size,
+                font=self.font,
             ),
             "body": document.ensure_run_style(),
             "bullet": document.ensure_run_style(),
@@ -186,6 +200,25 @@ class DocumentStylePreset:
         }
 
 
+def _outline_style_refs(document: HwpxDocument, level: int) -> dict[str, str | int]:
+    """Return paragraph style refs for a HWP outline heading level, if available."""
+
+    safe_level = min(10, max(1, int(level)))
+    for style in document.styles.values():
+        name = str(style.name or "")
+        eng_name = str(style.eng_name or "")
+        if name == f"개요 {safe_level}" or eng_name == f"Outline {safe_level}":
+            refs: dict[str, str | int] = {}
+            style_id = style.raw_id if style.raw_id is not None else style.id
+            if style_id is None:
+                continue
+            refs["style_id_ref"] = style_id
+            if style.para_pr_id_ref is not None:
+                refs["para_pr_id_ref"] = int(style.para_pr_id_ref)
+            return refs
+    return {}
+
+
 def _plan_issue(
     code: str,
     path: str,
@@ -1717,6 +1750,7 @@ def _render_block(
             block.text,
             char_pr_id_ref=tokens["heading"],
             inherit_style=False,
+            **_outline_style_refs(document, block.level),
         )
         return
     if isinstance(block, BuilderParagraph):

{python_hwpx-2.11.0 → python_hwpx-2.11.1}/src/hwpx/builder/core.py

@@ -25,6 +25,25 @@ _A4_HWP_SIZE = (59528, 84188)
 # changing default node contracts or the plan-v1 authoring style-token path.
 
 
+def _outline_style_refs(document: HwpxDocument, level: int) -> dict[str, str | int]:
+    """Return paragraph style refs for the built-in HWP outline level, if present."""
+
+    safe_level = min(10, max(1, int(level)))
+    for style in document.styles.values():
+        name = str(style.name or "")
+        eng_name = str(style.eng_name or "")
+        if name == f"개요 {safe_level}" or eng_name == f"Outline {safe_level}":
+            refs: dict[str, str | int] = {}
+            style_id = style.raw_id if style.raw_id is not None else style.id
+            if style_id is None:
+                continue
+            refs["style_id_ref"] = style_id
+            if style.para_pr_id_ref is not None:
+                refs["para_pr_id_ref"] = int(style.para_pr_id_ref)
+            return refs
+    return {}
+
+
 @dataclass(frozen=True)
 class _BuilderPreset:
     name: str = "default"
@@ -264,6 +283,7 @@ class Heading:
             section_index=section_index,
             char_pr_id_ref=char_pr_id,
             inherit_style=False,
+            **_outline_style_refs(document, self.level),
         )
 
 

{python_hwpx-2.11.0 → python_hwpx-2.11.1/src/python_hwpx.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.11.0
+Version: 2.11.1
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -261,6 +261,19 @@ HWPX 파일은 **ZIP + XML** 구조이므로, 한/글 프로그램 없이 Python
 | 🧰 **작업 도구** | unpack/pack/분석/비교 | pack-ready 작업 디렉터리 추출과 재구성 점검 |
 | 🏗️ **저수준 XML** | 데이터클래스 매핑 | OWPML 스키마 ↔ Python 객체 직접 조작 |
 | 🔄 **네임스페이스 호환** | 자동 정규화 | HWPML 2016 → 2011 자동 변환 |
+| 🏗️ **빌더** | 조립형 생성 | `hwpx.builder` — Section/Heading/Table/Image/Header 조립, 하드게이트 저장 리포트 |
+| ✅ **편집기 오픈 안전** | `validate_editor_open_safety` | 저장/팩/리페어/빌더 출력 게이트, `openSafety` 증거 반환 |
+| 🧪 **퍼징 수렴 루프** | `hwpx.tools.fuzz` | 시드 결정적 시나리오 생성 · 3중 오라클 러너 · 회귀 fixture 박제 |
+| 🖥️ **레이아웃 프리뷰** | `hwpx.tools.layout_preview` | 페이지 박스·표·여백 근사 HTML/PNG (에이전트 자기검증용) |
+| 🧷 **바이트 보존 패치** | `hwpx.patch` | section XML 바이트 splice — 미수정 영역 바이트 보존 |
+| 📐 **기존 문서 서식 편집** | 문단·페이지 | 정렬·줄간격·들여쓰기·문단 간격, 용지·여백·방향, 머리말/쪽번호, 불릿/번호 |
+| 🖊️ **누름틀** | 양식 필드 | 클릭히어 필드 조회·서식 보존 채움 |
+| 🏛️ **공문서 도구** | `official_lint` · 결재란 | 항목기호 위계·"끝." 표시·붙임·날짜 표기 lint, 결재란 프리셋 |
+| 📷 **고급 생성기** | `advanced_generators` | 사진대지(image_grid)·회의 명패·표 기반 조직도 |
+| 🆚 **신구대조** | `doc_diff` | 문단 LCS diff·신구대조표 생성·참조 정합 lint |
+| 📨 **메일머지·표 계산** | `mail_merge` | 템플릿+데이터 N부 대량 생성, 표 합계·평균 |
+| 🪄 **서식 이식** | `style_profile` | 참조 문서 프로파일 추출·적용, 템플릿 레지스트리 |
+| 🛡️ **입력 강건화** | `opc.security` | XML entity 폭탄·ZIP 압축 폭탄 가드 |
 
 ## 기능 상세
 

{python_hwpx-2.11.0 → python_hwpx-2.11.1}/tests/test_builder_core.py

@@ -344,6 +344,15 @@ def test_builder_lowers_headings_with_level_aware_styles(tmp_path) -> None:
     assert heading_1_run.style is not None
     assert heading_2_run.style is not None
     assert int(heading_1_run.style.attributes["height"]) > int(heading_2_run.style.attributes["height"])
+    outline_styles = {
+        str(style.raw_id if style.raw_id is not None else style.id): int(
+            style.name.rsplit(" ", 1)[-1]
+        )
+        for style in reopened.styles.values()
+        if (style.name or "").startswith("개요 ")
+    }
+    assert outline_styles.get(str(paragraphs[0].style_id_ref)) == 1
+    assert outline_styles.get(str(paragraphs[1].style_id_ref)) == 2
 
 
 def test_ensure_numbering_creates_sample_shaped_refs() -> None:

{python_hwpx-2.11.0 → python_hwpx-2.11.1}/tests/test_document_plan.py

@@ -344,6 +344,54 @@ def test_create_document_from_plan_generates_valid_formatted_hwpx(tmp_path) -> N
         reopened.close()
 
 
+def test_document_plan_headings_use_outline_paragraph_styles() -> None:
+    document = create_document_from_plan(_plan())
+    try:
+        outline_styles = {
+            str(style.raw_id if style.raw_id is not None else style.id): int(
+                style.name.rsplit(" ", 1)[-1]
+            )
+            for style in document.styles.values()
+            if (style.name or "").startswith("개요 ")
+        }
+        heading_levels = {
+            (paragraph.text or "").strip(): outline_styles.get(str(paragraph.style_id_ref))
+            for paragraph in document.paragraphs
+            if (paragraph.text or "").strip() in {"Executive Summary", "Budget"}
+        }
+
+        assert heading_levels == {"Executive Summary": 1, "Budget": 2}
+    finally:
+        document.close()
+
+
+def test_document_plan_title_and_heading_styles_have_visual_hierarchy() -> None:
+    document = create_document_from_plan(_plan())
+    try:
+        runs_by_text = {
+            (paragraph.text or "").strip(): paragraph.runs[0]
+            for paragraph in document.paragraphs
+            if (paragraph.text or "").strip()
+        }
+
+        title_style = runs_by_text["2026 AI Education Operating Plan"].style
+        subtitle_style = runs_by_text["Draft for internal review"].style
+        heading_style = runs_by_text["Executive Summary"].style
+        body_style = runs_by_text[
+            "The program connects classroom practice, teacher training, and evidence review."
+        ].style
+
+        assert title_style is not None
+        assert subtitle_style is not None
+        assert heading_style is not None
+        assert body_style is not None
+        assert int(title_style.attributes["height"]) > int(heading_style.attributes["height"])
+        assert int(heading_style.attributes["height"]) > int(body_style.attributes["height"])
+        assert int(subtitle_style.attributes["height"]) > int(body_style.attributes["height"])
+    finally:
+        document.close()
+
+
 def test_operating_plan_vertical_slice_reports_required_content_and_tables(tmp_path) -> None:
     output = tmp_path / "operating-plan.hwpx"
     plan = _operating_plan()