python-hwpx-automation 6.0.3__py3-none-any.whl

hwpx_automation/office/authoring/design/profiles/report/fragments/info_table.xml

@@ -0,0 +1 @@
+<hp:p xmlns:hp="http://www.hancom.co.kr/hwpml/2011/paragraph" id="2147483648" paraPrIDRef="69" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="72"><hp:tbl id="2130414164" zOrder="7" numberingType="TABLE" textWrap="TOP_AND_BOTTOM" textFlow="BOTH_SIDES" lock="0" dropcapstyle="None" pageBreak="CELL" repeatHeader="1" rowCnt="2" colCnt="4" cellSpacing="0" borderFillIDRef="4" noAdjust="0"><hp:sz width="47440" widthRelTo="ABSOLUTE" height="5128" heightRelTo="ABSOLUTE" protect="0"/><hp:pos treatAsChar="1" affectLSpacing="0" flowWithText="1" allowOverlap="0" holdAnchorAndSO="0" vertRelTo="PARA" horzRelTo="PARA" vertAlign="TOP" horzAlign="LEFT" vertOffset="0" horzOffset="0"/><hp:outMargin left="0" right="0" top="0" bottom="0"/><hp:inMargin left="510" right="510" top="141" bottom="141"/><hp:tr><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="49"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="61"><hp:t>{{cell}}</hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="0" rowAddr="0"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2614"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="8"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="61"><hp:t>{{cell}}</hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="1" rowAddr="0"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2614"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="8"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="61"><hp:t>{{cell}}</hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="2" rowAddr="0"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2614"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="50"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="61"><hp:t>{{cell}}</hp:t></hp:run><hp:run charPrIDRef="73"><hp:t></hp:t></hp:run><hp:run charPrIDRef="74"><hp:t></hp:t></hp:run><hp:run charPrIDRef="73"><hp:t></hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="3" rowAddr="0"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2614"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc></hp:tr><hp:tr><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="34"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="61"><hp:t>{{cell}}</hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="0" rowAddr="1"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2514"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="25"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="61"><hp:t>{{cell}}</hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="1" rowAddr="1"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2514"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="25"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="62"><hp:t>{{cell}}</hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="2" rowAddr="1"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2514"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc><hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="0" borderFillIDRef="32"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0"><hp:p id="2147483648" paraPrIDRef="20" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="61"><hp:t>{{cell}}</hp:t></hp:run></hp:p></hp:subList><hp:cellAddr colAddr="3" rowAddr="1"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="11860" height="2514"/><hp:cellMargin left="510" right="510" top="141" bottom="141"/></hp:tc></hp:tr></hp:tbl><hp:t/></hp:run></hp:p>

hwpx_automation/office/authoring/design/profiles/report/fragments/title.xml

@@ -0,0 +1 @@
+<hp:p xmlns:hp="http://www.hancom.co.kr/hwpml/2011/paragraph" id="2147483648" paraPrIDRef="39" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0"><hp:run charPrIDRef="22"><hp:t>{{title}}</hp:t></hp:run><hp:run charPrIDRef="21"><hp:t></hp:t></hp:run></hp:p>

hwpx_automation/office/authoring/design/profiles/report/profile.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": "hwpx.design.profile.v1",
+  "id": "report",
+  "template": "template.hwpx",
+  "fragments": {
+    "title": "fragments/title.xml",
+    "heading": "fragments/heading.xml",
+    "body": "fragments/body.xml",
+    "info_table": "fragments/info_table.xml"
+  },
+  "page": {
+    "width": 59528,
+    "height": 84186,
+    "orientation": "WIDELY",
+    "margins": {
+      "left": 5669,
+      "right": 5669,
+      "top": 4251,
+      "bottom": 4252
+    }
+  },
+  "char_pr_count": 123,
+  "style_coverage_threshold": 0.98,
+  "source_basename": "2026년 AI융합형 교육실 구축운영 계획서(양식2).hwpx"
+}

hwpx_automation/office/authoring/design/validator.py

@@ -0,0 +1,107 @@
+# SPDX-License-Identifier: Apache-2.0
+"""``styleCoverage`` — every style a composed body references must be defined
+(plan §2 Phase E, task 3).
+
+Because fragments are harvested from the *same* Hancom save as their skeleton,
+coverage is 1.0 by construction. The check exists to catch the failure mode the
+plan forbids: a fragment (or minimal-XML fallback) that references a ``charPr`` /
+``paraPr`` / ``style`` the header never defined — i.e. imagined structure. In
+production mode that drops coverage below threshold and the compose fails.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+from lxml import etree  # pyright: ignore[reportAttributeAccessIssue]
+
+from ._support import ln
+
+_REF_TO_KIND = {
+    "charPrIDRef": "charPr",
+    "paraPrIDRef": "paraPr",
+    "styleIDRef": "style",
+    "borderFillIDRef": "borderFill",
+}
+
+
+@dataclass(slots=True)
+class StyleCoverage:
+    coverage: float
+    referenced: int
+    covered: int
+    missing: list[tuple[str, str]] = field(default_factory=list)
+
+    @property
+    def ok(self) -> bool:
+        return not self.missing
+
+    def meets(self, threshold: float) -> bool:
+        return self.coverage >= threshold
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "coverage": round(self.coverage, 4),
+            "referenced": self.referenced,
+            "covered": self.covered,
+            "missing": [{"kind": k, "id": i} for k, i in self.missing],
+        }
+
+
+def header_style_ids(doc: Any) -> dict[str, set[str]]:
+    """Collect defined style ids from the document's header part(s)."""
+
+    ids: dict[str, set[str]] = {"charPr": set(), "paraPr": set(), "style": set(), "borderFill": set()}
+    package = doc._package
+    try:
+        header_paths = package.header_paths()
+    except Exception:  # pragma: no cover - defensive
+        header_paths = []
+    for path in header_paths:
+        try:
+            root = package.get_xml(path)
+        except Exception:  # pragma: no cover - defensive
+            continue
+        for element in root.iter():
+            name = ln(element.tag)
+            if name in ids and element.get("id") is not None:
+                ids[name].add(element.get("id"))
+    return ids
+
+
+def collect_references(elements: list[etree._Element]) -> list[tuple[str, str]]:
+    """Return (kind, id) for every style reference in *elements*."""
+
+    refs: list[tuple[str, str]] = []
+    for root in elements:
+        for element in root.iter():
+            for attr, kind in _REF_TO_KIND.items():
+                value = element.get(attr)
+                if value is not None:
+                    refs.append((kind, value))
+    return refs
+
+
+def style_coverage(doc: Any, elements: list[etree._Element]) -> StyleCoverage:
+    """Fraction of style references in *elements* defined by *doc*'s header."""
+
+    defined = header_style_ids(doc)
+    refs = collect_references(elements)
+    if not refs:
+        return StyleCoverage(coverage=1.0, referenced=0, covered=0)
+    missing: list[tuple[str, str]] = []
+    covered = 0
+    for kind, value in refs:
+        if value in defined.get(kind, set()):
+            covered += 1
+        else:
+            missing.append((kind, value))
+    return StyleCoverage(
+        coverage=covered / len(refs),
+        referenced=len(refs),
+        covered=covered,
+        missing=missing,
+    )
+
+
+__all__ = ["StyleCoverage", "style_coverage", "header_style_ids", "collect_references"]

hwpx_automation/office/authoring/presets/__init__.py

@@ -0,0 +1,22 @@
+# SPDX-License-Identifier: Apache-2.0
+"""Opinionated document presets built on public ``python-hwpx`` APIs."""
+
+from .proposal import (
+    DEFAULT_PROPOSAL_SECTIONS,
+    ProposalSection,
+    ProposalSpec,
+    ProposalStylePreset,
+    create_proposal_document,
+    inspect_proposal_quality,
+    normalize_proposal_spec,
+)
+
+__all__ = [
+    "DEFAULT_PROPOSAL_SECTIONS",
+    "ProposalSection",
+    "ProposalSpec",
+    "ProposalStylePreset",
+    "create_proposal_document",
+    "inspect_proposal_quality",
+    "normalize_proposal_spec",
+]