python-hwpx-automation 6.2.1__tar.gz → 6.4.2__tar.gz

{python_hwpx_automation-6.2.1/src/python_hwpx_automation.egg-info → python_hwpx_automation-6.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 6.2.1
+Version: 6.4.2
 Summary: Task-oriented HWPX document automation for Python, with an optional MCP adapter.
 Author: Kohkyuhyun
 License-Expression: Apache-2.0
@@ -20,7 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: python-hwpx<6,>=5.2.0
+Requires-Dist: python-hwpx<6,>=5.4.0
 Requires-Dist: pydantic<3,>=2.11
 Requires-Dist: cryptography>=42.0
 Requires-Dist: anyio>=4.0
@@ -74,10 +74,11 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 이 저장소의 main은 아직 공개되지 않은 6.2.1 후보 — release-approved 상태의 후보(수식 저작 `add_equation`,
-> 계약 `342cf672f29cd183`, 129 도구)입니다. 현재 공개 트레인은
-> `python-hwpx 5.1.1 → python-hwpx-automation 6.1.3 → hwpx-plugin 1.1.0`
-> (계약 `ac1a422376b5ac84`, 2026-07-31 released)입니다. 공개 트레인은
+> 이 저장소의 main은 아직 공개되지 않은 6.4.2 후보 — release-approved 상태(표 테두리·음영
+> `format_table` 확장, 수리된 core 5.4.0 기본값, 계약 `dbdbdfaac26148b7`,
+> 130 도구)입니다. 현재 공개 트레인은
+> `python-hwpx 5.3.0 → python-hwpx-automation 6.3.1 → hwpx-plugin 1.3.0`
+> (계약 `236f8ea855c875fe`, 2026-07-31 released)입니다. 공개 트레인은
 > core·automation PyPI와 plugin GitHub
 > Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격했으며, 기존
 > 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태

{python_hwpx_automation-6.2.1 → python_hwpx_automation-6.4.2}/README.md

@@ -14,10 +14,11 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 이 저장소의 main은 아직 공개되지 않은 6.2.1 후보 — release-approved 상태의 후보(수식 저작 `add_equation`,
-> 계약 `342cf672f29cd183`, 129 도구)입니다. 현재 공개 트레인은
-> `python-hwpx 5.1.1 → python-hwpx-automation 6.1.3 → hwpx-plugin 1.1.0`
-> (계약 `ac1a422376b5ac84`, 2026-07-31 released)입니다. 공개 트레인은
+> 이 저장소의 main은 아직 공개되지 않은 6.4.2 후보 — release-approved 상태(표 테두리·음영
+> `format_table` 확장, 수리된 core 5.4.0 기본값, 계약 `dbdbdfaac26148b7`,
+> 130 도구)입니다. 현재 공개 트레인은
+> `python-hwpx 5.3.0 → python-hwpx-automation 6.3.1 → hwpx-plugin 1.3.0`
+> (계약 `236f8ea855c875fe`, 2026-07-31 released)입니다. 공개 트레인은
 > core·automation PyPI와 plugin GitHub
 > Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격했으며, 기존
 > 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태

{python_hwpx_automation-6.2.1 → python_hwpx_automation-6.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "6.2.1"
+version = "6.4.2"
 description = "Task-oriented HWPX document automation for Python, with an optional MCP adapter."
 readme = "README.md"
 authors = [{ name = "Kohkyuhyun" }]
@@ -29,7 +29,7 @@ dependencies = [
     # the bounded major here is what makes "no valid install has two declarers"
     # true rather than hopeful, and prevents the next core major from silently
     # breaking an already-published automation line.
-    "python-hwpx>=5.2.0,<6", # HWPX object model, OXML/OPC, format-native primitives
+    "python-hwpx>=5.4.0,<6", # HWPX object model, OXML/OPC, format-native primitives
 
     "pydantic>=2.11,<3",
     "cryptography>=42.0",

{python_hwpx_automation-6.2.1 → python_hwpx_automation-6.4.2}/src/hwpx_automation/core/content.py

@@ -418,20 +418,77 @@ def split_cell_in_table(doc: HwpxDocument, table_index: int, row: int, col: int)
     return original
 
 
-def format_table_in_doc(doc: HwpxDocument, table_index: int, has_header_row: bool = None) -> None:
-    """표 서식을 변경한다. 헤더 행 강조 등."""
-    if has_header_row is None:
-        return
+def _apply_table_border_fill(
+    doc: HwpxDocument,
+    table,
+    border_type: str = None,
+    border_color: str = None,
+    border_width: str = None,
+    fill_color: str = None,
+    row: int = None,
+    col: int = None,
+) -> str:
+    """테두리/음영 borderFill을 만들어 표 전체 또는 한 셀에 적용한다."""
+    border_fill_id = doc.ensure_border_fill(
+        border_type=border_type or "SOLID",
+        border_color=border_color or "#000000",
+        border_width=border_width or "0.12 mm",
+        fill_color=fill_color,
+    )
+    if row is not None:
+        table.set_cell_border_fill(row, col, border_fill_id)
+        return border_fill_id
+    table.element.set("borderFillIDRef", str(border_fill_id))
+    for table_row in table.rows:
+        for cell in table_row.cells:
+            cell.element.set("borderFillIDRef", str(border_fill_id))
+    table.mark_dirty()
+    return border_fill_id
+
+
+def format_table_in_doc(
+    doc: HwpxDocument,
+    table_index: int,
+    has_header_row: bool = None,
+    border_type: str = None,
+    border_color: str = None,
+    border_width: str = None,
+    fill_color: str = None,
+    row: int = None,
+    col: int = None,
+) -> dict:
+    """표 서식을 변경한다. 헤더 행 강조·테두리(선 종류/색/굵기)·셀 음영."""
+    if (row is None) != (col is None):
+        raise ValueError("row와 col은 함께 지정해야 합니다 (셀 단위 테두리 적용)")
+    wants_border = any(
+        value is not None for value in (border_type, border_color, border_width, fill_color)
+    )
+    if row is not None and not wants_border:
+        raise ValueError("row/col 지정은 테두리·음영 파라미터와 함께 사용합니다")
+    if has_header_row is None and not wants_border:
+        return {}
     tables = list(_iter_tables(doc))
     if table_index < 0 or table_index >= len(tables):
         raise ValueError(f"유효하지 않은 table_index: {table_index}")
     table = tables[table_index]
-    if not table.rows:
-        return
-    for cell in table.rows[0].cells:
-        for paragraph in getattr(cell, "paragraphs", []):
-            for run in paragraph.runs:
-                run.bold = bool(has_header_row)
+    applied: dict = {}
+    if wants_border:
+        applied["border_fill_id"] = _apply_table_border_fill(
+            doc,
+            table,
+            border_type=border_type,
+            border_color=border_color,
+            border_width=border_width,
+            fill_color=fill_color,
+            row=row,
+            col=col,
+        )
+    if has_header_row is not None and table.rows:
+        for cell in table.rows[0].cells:
+            for paragraph in getattr(cell, "paragraphs", []):
+                for run in paragraph.runs:
+                    run.bold = bool(has_header_row)
+    return applied
 
 
 def copy_document_file(source: str, destination: str = None) -> str:

{python_hwpx_automation-6.2.1 → python_hwpx_automation-6.4.2}/src/hwpx_automation/handlers/content_edit.py

@@ -680,6 +680,46 @@ def add_page_break(
     return _with_save_verification({"success": True}, verification)
 
 
+def add_chart(
+    filename: str,
+    chart_type: str,
+    categories: list,
+    series: list,
+    title: str = None,
+    paragraph_index: int = None,
+    table_index: int = None,
+    row: int = None,
+    col: int = None,
+    treat_as_char: bool = False,
+    dry_run: bool = False,
+    expected_revision: str = None,
+) -> dict:
+    """네이티브 차트(<hp:chart>+ECMA-376 chartML part)를 삽입합니다. 렌더 검증된
+    MVP 3종(bar·line·pie)만 지원 — 밖이면 CHART_UNSUPPORTED로 typed 거부(무음
+    근사 없음). series=[{"name": str, "values": [number,...]}], values 길이는
+    categories와 일치해야 합니다. 실한컴은 chartML만으로 차트를 그립니다(OLE
+    폴백·사전렌더 이미지 불요). 배치: 기본=문서 끝 새 문단(float),
+    paragraph_index=기존 문단, tableIndex+row+col=표 셀, treat_as_char=인라인."""
+    path = resolve_path(filename)
+    guard = _revision_guard(path, expected_revision)
+    if guard is not None:
+        return guard
+    result = RUNTIME_SERVICES.ops.add_chart(
+        path,
+        chart_type=chart_type,
+        categories=categories,
+        series=series,
+        title=title,
+        paragraph_index=paragraph_index,
+        table_index=table_index,
+        row=row,
+        col=col,
+        treat_as_char=treat_as_char,
+        dry_run=dry_run,
+    )
+    return _with_document_state(result, path)
+
+
 def add_equation(
     filename: str,
     latex: str = None,
@@ -1070,24 +1110,40 @@ def format_table(
     filename: str,
     table_index: int,
     has_header_row: bool = None,
+    border_type: str = None,
+    border_color: str = None,
+    border_width: str = None,
+    fill_color: str = None,
+    row: int = None,
+    col: int = None,
     dry_run: bool = False,
     expected_revision: str = None,
 ) -> dict:
-    """표 서식을 적용합니다. dry_run=True이면 원본을 저장하지 않습니다."""
+    """표 서식을 적용합니다. 헤더 행 강조 외에 테두리 선 종류(OWPML 어휘:
+    SOLID/DASH/DOT/DOUBLE_SLIM/WAVE 등)·색·굵기와 셀 음영(fill_color)을
+    표 전체 또는 (row, col) 한 셀에 적용합니다. dry_run=True이면 원본을
+    저장하지 않습니다."""
     path = resolve_path(filename)
     guard = _revision_guard(path, expected_revision)
     if guard is not None:
         return guard
     doc = open_doc(path)
-    format_table_in_doc(doc, table_index, has_header_row=has_header_row)
+    applied = format_table_in_doc(
+        doc,
+        table_index,
+        has_header_row=has_header_row,
+        border_type=border_type,
+        border_color=border_color,
+        border_width=border_width,
+        fill_color=fill_color,
+        row=row,
+        col=col,
+    )
+    result = {"formatted": True, "table_index": table_index, **applied}
     if dry_run:
-        return _with_dry_run_verification(
-            {"formatted": True, "table_index": table_index}, doc, path
-        )
+        return _with_dry_run_verification(result, doc, path)
     verification = _save_doc_verification(doc, path)
-    return _with_save_verification(
-        {"formatted": True, "table_index": table_index}, verification
-    )
+    return _with_save_verification(result, verification)
 
 
 __all__ = [
@@ -1097,6 +1153,7 @@ __all__ = [
     "delete_paragraph",
     "add_page_break",
     "add_equation",
+    "add_chart",
     "apply_edits",
     "undo_last_edit",
     "replace_by_anchor",

{python_hwpx_automation-6.2.1 → python_hwpx_automation-6.4.2}/src/hwpx_automation/hwpx_ops.py

@@ -517,6 +517,35 @@ class HwpxOps:
             path, text, section_index=section_index, run_style=run_style
         )
 
+    def add_chart(
+        self,
+        path: str,
+        *,
+        chart_type: str,
+        categories: list[str],
+        series: list[dict],
+        title: Optional[str] = None,
+        paragraph_index: Optional[int] = None,
+        table_index: Optional[int] = None,
+        row: Optional[int] = None,
+        col: Optional[int] = None,
+        treat_as_char: bool = False,
+        dry_run: bool = False,
+    ) -> Dict[str, Any]:
+        return self._services.content_layout.add_chart(
+            path,
+            chart_type=chart_type,
+            categories=categories,
+            series=series,
+            title=title,
+            paragraph_index=paragraph_index,
+            table_index=table_index,
+            row=row,
+            col=col,
+            treat_as_char=treat_as_char,
+            dry_run=dry_run,
+        )
+
     def add_equation(
         self,
         path: str,

{python_hwpx_automation-6.2.1 → python_hwpx_automation-6.4.2}/src/hwpx_automation/identity.json

@@ -5,20 +5,20 @@
  "releaseState": {
   "status": "release-approved",
   "candidate": {
-   "pythonHwpx": "5.2.0",
+   "pythonHwpx": "5.4.0",
    "canonicalDistribution": "python-hwpx-automation",
-   "canonicalAutomation": "6.2.1",
+   "canonicalAutomation": "6.4.2",
    "compatibilityDistribution": "hwpx-mcp-server",
-   "compatibility": "6.2.1",
-   "plugin": "1.2.0",
-   "contractHash": "342cf672f29cd183"
+   "compatibility": "6.4.2",
+   "plugin": "1.4.0",
+   "contractHash": "dbdbdfaac26148b7"
   },
   "currentPublic": {
-   "pythonHwpx": "5.1.1",
+   "pythonHwpx": "5.3.0",
    "primaryDistribution": "python-hwpx-automation",
-   "primaryApplication": "6.1.3",
-   "plugin": "1.1.0",
-   "contractHash": "ac1a422376b5ac84"
+   "primaryApplication": "6.3.1",
+   "plugin": "1.3.0",
+   "contractHash": "236f8ea855c875fe"
   },
   "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."
  },

python_hwpx_automation-6.4.2/src/hwpx_automation/office/charting/__init__.py

@@ -0,0 +1,162 @@
+# SPDX-License-Identifier: Apache-2.0
+"""Deterministic data → ECMA-376 chartML generator (MVP: bar, line, pie).
+
+The grammar mirrors the render-verified probes in
+specs/055-chart-authoring/evidence/p0 (workspace): a ``c:chartSpace``
+skeleton, per-series ``c:ser`` with string/number caches, and the
+type-specific plot element (``c:barChart`` / ``c:lineChart`` + axis pair /
+``c:pieChart``). Anything outside the verified set is refused with a typed
+error — no silent approximation. Real Hancom draws the output from the
+chartML alone (no OLE fallback, no pre-rendered image).
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Sequence
+from xml.sax.saxutils import escape
+
+CHART_TYPES = ("bar", "line", "pie")
+
+_CAT_AX_ID = "111111111"
+_VAL_AX_ID = "222222222"
+
+_HEAD = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>'
+    '<c:chartSpace xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"'
+    ' xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"'
+    ' xmlns:c="http://schemas.openxmlformats.org/drawingml/2006/chart">'
+    '<c:date1904 val="0"/><c:roundedCorners val="0"/><c:chart>'
+)
+
+
+class UnsupportedChartError(ValueError):
+    """Raised for chart types or shapes outside the render-verified MVP set."""
+
+
+@dataclass(frozen=True)
+class ChartSeries:
+    """One data series: a display name and one value per category."""
+
+    name: str
+    values: tuple[float, ...]
+
+
+def _series(index: int, name: str, categories: Sequence[str],
+            values: Sequence[float], extra: str = "") -> str:
+    cats = "".join(
+        f'<c:pt idx="{i}"><c:v>{escape(str(c))}</c:v></c:pt>'
+        for i, c in enumerate(categories)
+    )
+    vals = "".join(
+        f'<c:pt idx="{i}"><c:v>{v:g}</c:v></c:pt>' for i, v in enumerate(values)
+    )
+    column = chr(ord("B") + index)
+    return (
+        f'<c:ser><c:idx val="{index}"/><c:order val="{index}"/>'
+        f"<c:tx><c:strRef><c:f>Sheet1!${column}$1</c:f>"
+        f'<c:strCache><c:ptCount val="1"/><c:pt idx="0"><c:v>{escape(name)}</c:v></c:pt>'
+        f"</c:strCache></c:strRef></c:tx>{extra}"
+        f"<c:cat><c:strRef><c:f>Sheet1!$A$2:$A${len(categories) + 1}</c:f>"
+        f'<c:strCache><c:ptCount val="{len(categories)}"/>{cats}</c:strCache></c:strRef></c:cat>'
+        f"<c:val><c:numRef><c:f>Sheet1!${column}$2:${column}${len(values) + 1}</c:f>"
+        f"<c:numCache><c:formatCode>General</c:formatCode>"
+        f'<c:ptCount val="{len(values)}"/>{vals}</c:numCache></c:numRef></c:val></c:ser>'
+    )
+
+
+def _axes() -> str:
+    return (
+        f'<c:catAx><c:axId val="{_CAT_AX_ID}"/>'
+        '<c:scaling><c:orientation val="minMax"/></c:scaling><c:delete val="0"/>'
+        f'<c:axPos val="b"/><c:crossAx val="{_VAL_AX_ID}"/></c:catAx>'
+        f'<c:valAx><c:axId val="{_VAL_AX_ID}"/>'
+        '<c:scaling><c:orientation val="minMax"/></c:scaling><c:delete val="0"/>'
+        f'<c:axPos val="l"/><c:crossAx val="{_CAT_AX_ID}"/></c:valAx>'
+    )
+
+
+def build_chart_ml(
+    chart_type: str,
+    categories: Sequence[str],
+    series: Sequence[ChartSeries],
+    *,
+    title: str | None = None,
+) -> str:
+    """Build chartML for one of the render-verified MVP chart types.
+
+    Raises:
+        UnsupportedChartError: unknown chart type, empty/mismatched data, or
+            a shape outside the verified set (e.g. multi-series pie).
+    """
+
+    if chart_type not in CHART_TYPES:
+        raise UnsupportedChartError(
+            f"unsupported chart type {chart_type!r}; render-verified types: "
+            + ", ".join(CHART_TYPES)
+        )
+    if not categories:
+        raise UnsupportedChartError("categories must be non-empty")
+    if not series:
+        raise UnsupportedChartError("series must be non-empty")
+    if chart_type == "pie" and len(series) != 1:
+        raise UnsupportedChartError("a pie chart takes exactly one series")
+    if len(series) > 25:
+        raise UnsupportedChartError("at most 25 series are supported")
+    for item in series:
+        if not item.name.strip():
+            raise UnsupportedChartError("every series needs a non-empty name")
+        if len(item.values) != len(categories):
+            raise UnsupportedChartError(
+                f"series {item.name!r} has {len(item.values)} values for "
+                f"{len(categories)} categories"
+            )
+
+    parts: list[str] = [_HEAD]
+    if title is not None and title.strip():
+        parts.append(
+            "<c:title><c:tx><c:rich><a:bodyPr/><a:p><a:r><a:t>"
+            + escape(title)
+            + "</a:t></a:r></a:p></c:rich></c:tx><c:overlay val=\"0\"/></c:title>"
+            '<c:autoTitleDeleted val="0"/>'
+        )
+    parts.append("<c:plotArea><c:layout/>")
+
+    if chart_type == "bar":
+        parts.append('<c:barChart><c:barDir val="col"/><c:grouping val="clustered"/><c:varyColors val="0"/>')
+        for index, item in enumerate(series):
+            parts.append(_series(index, item.name, categories, item.values))
+        parts.append(
+            f'<c:axId val="{_CAT_AX_ID}"/><c:axId val="{_VAL_AX_ID}"/></c:barChart>'
+        )
+        parts.append(_axes())
+    elif chart_type == "line":
+        parts.append('<c:lineChart><c:grouping val="standard"/><c:varyColors val="0"/>')
+        for index, item in enumerate(series):
+            parts.append(
+                _series(
+                    index, item.name, categories, item.values,
+                    '<c:marker><c:symbol val="circle"/><c:size val="5"/></c:marker>',
+                )
+            )
+        parts.append(
+            '<c:marker val="1"/>'
+            f'<c:axId val="{_CAT_AX_ID}"/><c:axId val="{_VAL_AX_ID}"/></c:lineChart>'
+        )
+        parts.append(_axes())
+    else:  # pie
+        parts.append('<c:pieChart><c:varyColors val="1"/>')
+        parts.append(_series(0, series[0].name, categories, series[0].values))
+        parts.append('<c:firstSliceAng val="0"/></c:pieChart>')
+
+    parts.append("</c:plotArea>")
+    parts.append('<c:plotVisOnly val="1"/></c:chart></c:chartSpace>')
+    return "".join(parts)
+
+
+__all__ = [
+    "CHART_TYPES",
+    "ChartSeries",
+    "UnsupportedChartError",
+    "build_chart_ml",
+]

{python_hwpx_automation-6.2.1 → python_hwpx_automation-6.4.2}/src/hwpx_automation/ops_services/content_layout.py

@@ -127,17 +127,18 @@ class ContentLayoutService:
         table_index: Optional[int],
         row: Optional[int],
         col: Optional[int],
+        target_error_code: str = "EQUATION_TARGET_INVALID",
     ) -> Any:
         cell_parts = (table_index, row, col)
         use_cell = any(part is not None for part in cell_parts)
         if use_cell and not all(part is not None for part in cell_parts):
             raise self._context._new_error(
-                "EQUATION_TARGET_INVALID",
+                target_error_code,
                 "provide tableIndex, row, and col together for a cell target",
             )
         if use_cell and paragraph_index is not None:
             raise self._context._new_error(
-                "EQUATION_TARGET_INVALID",
+                target_error_code,
                 "paragraphIndex cannot be combined with a cell target",
             )
         if use_cell:
@@ -169,6 +170,80 @@ class ContentLayoutService:
                 ) from exc
         return None
 
+    def add_chart(
+        self,
+        path: str,
+        *,
+        chart_type: str,
+        categories: list[str],
+        series: list[dict],
+        title: Optional[str] = None,
+        paragraph_index: Optional[int] = None,
+        table_index: Optional[int] = None,
+        row: Optional[int] = None,
+        col: Optional[int] = None,
+        treat_as_char: bool = False,
+        dry_run: bool = False,
+    ) -> Dict[str, Any]:
+        from ..office.charting import (
+            ChartSeries,
+            UnsupportedChartError,
+            build_chart_ml,
+        )
+
+        try:
+            parsed_series = [
+                ChartSeries(
+                    name=str(item.get("name", "")),
+                    values=tuple(float(v) for v in item.get("values", ())),
+                )
+                for item in series
+            ]
+        except (TypeError, ValueError) as exc:
+            raise self._context._new_error(
+                "CHART_INPUT_INVALID",
+                f"series values must be numbers: {exc}",
+            ) from exc
+        try:
+            chart_ml = build_chart_ml(
+                chart_type, categories, parsed_series, title=title
+            )
+        except UnsupportedChartError as exc:
+            raise self._context._new_error(
+                "CHART_UNSUPPORTED", str(exc)
+            ) from exc
+
+        document, resolved = self._context._open_document(path)
+        paragraph = self._resolve_equation_target(
+            document,
+            paragraph_index=paragraph_index,
+            table_index=table_index,
+            row=row,
+            col=col,
+            target_error_code="CHART_TARGET_INVALID",
+        )
+        try:
+            inline_object = document.add_chart(
+                chart_ml, paragraph=paragraph, treat_as_char=treat_as_char
+            )
+        except ValueError as exc:
+            raise self._context._new_error(
+                "CHART_INPUT_INVALID", str(exc)
+            ) from exc
+        result = {
+            "ok": True,
+            "filename": path,
+            "chart": {
+                "chartType": chart_type,
+                "chartIDRef": inline_object.element.get("chartIDRef"),
+                "seriesCount": len(parsed_series),
+                "categoryCount": len(categories),
+            },
+        }
+        return self._transactions._with_transaction_verification(
+            result, document, resolved, dry_run=dry_run
+        )
+
     def add_equation(
         self,
         path: str,