exstruct 0.5.2__tar.gz → 0.5.3__tar.gz

{exstruct-0.5.2 → exstruct-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: exstruct
-Version: 0.5.2
+Version: 0.5.3
 Summary: Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines
 Keywords: excel,structure,data,exstruct
 Author: harumiWeb
@@ -158,6 +158,7 @@ exstruct-mcp --root C:\data --log-file C:\logs\exstruct-mcp.log --on-conflict re
 Available tools:
 
 - `exstruct_extract`
+- `exstruct_capture_sheet_images`
 - `exstruct_make`
 - `exstruct_patch`
 - `exstruct_read_json_chunk`
@@ -169,6 +170,12 @@ Available tools:
 Notes:
 
 - In MCP, `exstruct_extract` defaults to `options.alpha_col=true` (column keys: `A`, `B`, ...). Set `options.alpha_col=false` for legacy 0-based numeric string keys.
+- `exstruct_capture_sheet_images` is COM-only (Experimental) and supports optional `sheet` / `range` targeting (`A1:B2`, `Sheet1!A1:B2`, `'Sheet 1'!A1:B2`). When `out_dir` is omitted, it creates a unique `<workbook_stem>_images` directory under MCP `--root`.
+- MCP server startup sets `EXSTRUCT_RENDER_SUBPROCESS=1` by default (`setdefault`). If you prefer in-process rendering, set `EXSTRUCT_RENDER_SUBPROCESS=0` before launching the server.
+- Timeout tuning for `exstruct_capture_sheet_images`: `EXSTRUCT_MCP_CAPTURE_SHEET_IMAGES_TIMEOUT_SEC` (tool timeout), `EXSTRUCT_RENDER_SUBPROCESS_STARTUP_TIMEOUT_SEC` (worker startup), `EXSTRUCT_RENDER_SUBPROCESS_JOIN_TIMEOUT_SEC` (primary wait budget), `EXSTRUCT_RENDER_SUBPROCESS_RESULT_TIMEOUT_SEC` (post-exit grace).
+- Subprocess errors are stage-aware (`stage=startup|join|result|worker`) so MCP clients can distinguish bootstrap failures vs timeout vs worker-side rendering errors.
+- Trade-off of `EXSTRUCT_RENDER_SUBPROCESS=1`: subprocess startup/coordination overhead and dependency on worker-side module resolution.
+- Trade-off of `EXSTRUCT_RENDER_SUBPROCESS=0`: less crash isolation and higher memory pressure risk in long-running processes.
 - Logs go to stderr (and optionally `--log-file`) to avoid contaminating stdio responses.
 - On Windows with Excel, standard/verbose can use COM for richer extraction. On non-Windows, COM is unavailable and extraction uses openpyxl-based fallbacks.
 - `exstruct_patch` supports `backend` selection:
@@ -176,13 +183,13 @@ Notes:
   - `com`: force COM (rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`)
   - `openpyxl`: force openpyxl (`.xls` is not supported)
 - `create_chart` is COM-only (`backend="openpyxl"` is not allowed for requests that include it), and it also rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`.
-- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
-- `create_chart` `data_range` accepts either one range string or `list[str]` (multi-series), and `data_range` / `category_range` both support sheet-qualified ranges (`Sheet2!A1:B10`, `'Sales Data'!A1:B10`).
-- `create_chart` supports optional explicit labels: `chart_title`, `x_axis_title`, `y_axis_title`.
-- `create_chart` and `apply_table_style` can be combined in one request when the backend resolves to COM (`backend="com"` or `backend="auto"` with COM available).
-- For stable `apply_table_style` COM runs on Windows, ensure desktop Excel is installed/runnable and the target `range` is a contiguous header-included A1 range.
-- `exstruct_patch` error detail may include `error_code` / `failed_field` / `raw_com_message`; table-related codes include `table_style_invalid`, `list_object_add_failed`, and `com_api_missing`.
-- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
+- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
+- `create_chart` `data_range` accepts either one range string or `list[str]` (multi-series), and `data_range` / `category_range` both support sheet-qualified ranges (`Sheet2!A1:B10`, `'Sales Data'!A1:B10`).
+- `create_chart` supports optional explicit labels: `chart_title`, `x_axis_title`, `y_axis_title`.
+- `create_chart` and `apply_table_style` can be combined in one request when the backend resolves to COM (`backend="com"` or `backend="auto"` with COM available).
+- For stable `apply_table_style` COM runs on Windows, ensure desktop Excel is installed/runnable and the target `range` is a contiguous header-included A1 range.
+- `exstruct_patch` error detail may include `error_code` / `failed_field` / `raw_com_message`; table-related codes include `table_style_invalid`, `list_object_add_failed`, and `com_api_missing`.
+- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
 - Use `exstruct_make` for new workbook creation and `exstruct_patch` for editing existing workbooks.
 - `exstruct_make` creates a new workbook and applies `ops` in one call (`out_path` required, `ops` optional).
   - Supports `.xlsx` / `.xlsm` / `.xls`

{exstruct-0.5.2 → exstruct-0.5.3}/README.md

@@ -93,6 +93,7 @@ exstruct-mcp --root C:\data --log-file C:\logs\exstruct-mcp.log --on-conflict re
 Available tools:
 
 - `exstruct_extract`
+- `exstruct_capture_sheet_images`
 - `exstruct_make`
 - `exstruct_patch`
 - `exstruct_read_json_chunk`
@@ -104,6 +105,12 @@ Available tools:
 Notes:
 
 - In MCP, `exstruct_extract` defaults to `options.alpha_col=true` (column keys: `A`, `B`, ...). Set `options.alpha_col=false` for legacy 0-based numeric string keys.
+- `exstruct_capture_sheet_images` is COM-only (Experimental) and supports optional `sheet` / `range` targeting (`A1:B2`, `Sheet1!A1:B2`, `'Sheet 1'!A1:B2`). When `out_dir` is omitted, it creates a unique `<workbook_stem>_images` directory under MCP `--root`.
+- MCP server startup sets `EXSTRUCT_RENDER_SUBPROCESS=1` by default (`setdefault`). If you prefer in-process rendering, set `EXSTRUCT_RENDER_SUBPROCESS=0` before launching the server.
+- Timeout tuning for `exstruct_capture_sheet_images`: `EXSTRUCT_MCP_CAPTURE_SHEET_IMAGES_TIMEOUT_SEC` (tool timeout), `EXSTRUCT_RENDER_SUBPROCESS_STARTUP_TIMEOUT_SEC` (worker startup), `EXSTRUCT_RENDER_SUBPROCESS_JOIN_TIMEOUT_SEC` (primary wait budget), `EXSTRUCT_RENDER_SUBPROCESS_RESULT_TIMEOUT_SEC` (post-exit grace).
+- Subprocess errors are stage-aware (`stage=startup|join|result|worker`) so MCP clients can distinguish bootstrap failures vs timeout vs worker-side rendering errors.
+- Trade-off of `EXSTRUCT_RENDER_SUBPROCESS=1`: subprocess startup/coordination overhead and dependency on worker-side module resolution.
+- Trade-off of `EXSTRUCT_RENDER_SUBPROCESS=0`: less crash isolation and higher memory pressure risk in long-running processes.
 - Logs go to stderr (and optionally `--log-file`) to avoid contaminating stdio responses.
 - On Windows with Excel, standard/verbose can use COM for richer extraction. On non-Windows, COM is unavailable and extraction uses openpyxl-based fallbacks.
 - `exstruct_patch` supports `backend` selection:
@@ -111,13 +118,13 @@ Notes:
   - `com`: force COM (rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`)
   - `openpyxl`: force openpyxl (`.xls` is not supported)
 - `create_chart` is COM-only (`backend="openpyxl"` is not allowed for requests that include it), and it also rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`.
-- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
-- `create_chart` `data_range` accepts either one range string or `list[str]` (multi-series), and `data_range` / `category_range` both support sheet-qualified ranges (`Sheet2!A1:B10`, `'Sales Data'!A1:B10`).
-- `create_chart` supports optional explicit labels: `chart_title`, `x_axis_title`, `y_axis_title`.
-- `create_chart` and `apply_table_style` can be combined in one request when the backend resolves to COM (`backend="com"` or `backend="auto"` with COM available).
-- For stable `apply_table_style` COM runs on Windows, ensure desktop Excel is installed/runnable and the target `range` is a contiguous header-included A1 range.
-- `exstruct_patch` error detail may include `error_code` / `failed_field` / `raw_com_message`; table-related codes include `table_style_invalid`, `list_object_add_failed`, and `com_api_missing`.
-- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
+- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
+- `create_chart` `data_range` accepts either one range string or `list[str]` (multi-series), and `data_range` / `category_range` both support sheet-qualified ranges (`Sheet2!A1:B10`, `'Sales Data'!A1:B10`).
+- `create_chart` supports optional explicit labels: `chart_title`, `x_axis_title`, `y_axis_title`.
+- `create_chart` and `apply_table_style` can be combined in one request when the backend resolves to COM (`backend="com"` or `backend="auto"` with COM available).
+- For stable `apply_table_style` COM runs on Windows, ensure desktop Excel is installed/runnable and the target `range` is a contiguous header-included A1 range.
+- `exstruct_patch` error detail may include `error_code` / `failed_field` / `raw_com_message`; table-related codes include `table_style_invalid`, `list_object_add_failed`, and `com_api_missing`.
+- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
 - Use `exstruct_make` for new workbook creation and `exstruct_patch` for editing existing workbooks.
 - `exstruct_make` creates a new workbook and applies `ops` in one call (`out_path` required, `ops` optional).
   - Supports `.xlsx` / `.xlsm` / `.xls`

{exstruct-0.5.2 → exstruct-0.5.3}/pyproject.toml

@@ -1,7 +1,7 @@
-[project]
-name = "exstruct"
-version = "0.5.2"
-description = "Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines"
+[project]
+name = "exstruct"
+version = "0.5.3"
+description = "Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines"
 readme = "README.md"
 license = { file = "LICENSE" }
 keywords = ["excel", "structure", "data", "exstruct"]

{exstruct-0.5.2 → exstruct-0.5.3}/src/exstruct/mcp/__init__.py

@@ -28,6 +28,11 @@ from .patch_runner import (
     run_make,
     run_patch,
 )
+from .render_runner import (
+    CaptureSheetImagesRequest,
+    CaptureSheetImagesResult,
+    run_capture_sheet_images,
+)
 from .sheet_reader import (
     CellReadItem,
     FormulaReadItem,
@@ -42,6 +47,8 @@ from .sheet_reader import (
     read_range,
 )
 from .tools import (
+    CaptureSheetImagesToolInput,
+    CaptureSheetImagesToolOutput,
     DescribeOpToolInput,
     DescribeOpToolOutput,
     ExtractToolInput,
@@ -61,6 +68,7 @@ from .tools import (
     ReadRangeToolOutput,
     ValidateInputToolInput,
     ValidateInputToolOutput,
+    run_capture_sheet_images_tool,
     run_describe_op_tool,
     run_extract_tool,
     run_list_ops_tool,
@@ -79,6 +87,10 @@ from .validate_input import (
 )
 
 __all__ = [
+    "CaptureSheetImagesRequest",
+    "CaptureSheetImagesResult",
+    "CaptureSheetImagesToolInput",
+    "CaptureSheetImagesToolOutput",
     "DescribeOpToolInput",
     "DescribeOpToolOutput",
     "ExtractRequest",
@@ -133,6 +145,8 @@ __all__ = [
     "run_make",
     "run_make_tool",
     "run_patch",
+    "run_capture_sheet_images",
+    "run_capture_sheet_images_tool",
     "run_patch_tool",
     "read_cells",
     "read_formulas",

exstruct-0.5.3/src/exstruct/mcp/render_runner.py

@@ -0,0 +1,124 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from pydantic import BaseModel, Field, field_validator, model_validator
+
+from exstruct import render
+
+from .io import PathPolicy
+from .shared.a1 import resolve_sheet_and_range
+from .shared.output_path import resolve_image_output_dir
+
+logger = logging.getLogger(__name__)
+
+
+class CaptureSheetImagesRequest(BaseModel):
+    """Input model for MCP sheet image capture."""
+
+    xlsx_path: Path
+    out_dir: Path | None = None
+    dpi: int = Field(default=144, ge=1)
+    sheet: str | None = None
+    range: str | None = None  # noqa: A003
+
+    @field_validator("sheet")
+    @classmethod
+    def _validate_sheet(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        candidate = value.strip()
+        if not candidate:
+            raise ValueError("sheet must not be empty when provided.")
+        return candidate
+
+    @field_validator("range")
+    @classmethod
+    def _validate_range(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        candidate = value.strip()
+        if not candidate:
+            raise ValueError("range must not be empty when provided.")
+        return candidate
+
+    @model_validator(mode="after")
+    def _validate_sheet_range_consistency(self) -> CaptureSheetImagesRequest:
+        selection = resolve_sheet_and_range(self.sheet, self.range)
+        self.sheet = selection.sheet
+        self.range = selection.range_ref
+        return self
+
+
+class CaptureSheetImagesResult(BaseModel):
+    """Output model for MCP sheet image capture."""
+
+    out_dir: str
+    image_paths: list[str] = Field(default_factory=list)
+    warnings: list[str] = Field(default_factory=list)
+
+
+def run_capture_sheet_images(
+    request: CaptureSheetImagesRequest,
+    *,
+    policy: PathPolicy | None = None,
+) -> CaptureSheetImagesResult:
+    """Capture worksheet images using Excel COM rendering pipeline.
+
+    Args:
+        request: Capture request payload.
+        policy: Optional path access policy.
+
+    Returns:
+        Capture result with resolved output directory and written images.
+    """
+    resolved_input = _resolve_input_path(request.xlsx_path, policy=policy)
+    resolved_out_dir = resolve_image_output_dir(
+        resolved_input,
+        out_dir=request.out_dir,
+        policy=policy,
+    )
+    _ensure_com_available()
+    resolved_out_dir.mkdir(parents=True, exist_ok=True)
+    written_paths = render.export_sheet_images(
+        resolved_input,
+        resolved_out_dir,
+        dpi=request.dpi,
+        sheet=request.sheet,
+        a1_range=request.range,
+    )
+    return CaptureSheetImagesResult(
+        out_dir=str(resolved_out_dir),
+        image_paths=[str(path) for path in written_paths],
+        warnings=[],
+    )
+
+
+def _resolve_input_path(path: Path, *, policy: PathPolicy | None) -> Path:
+    """Resolve and validate input workbook path."""
+    resolved = policy.ensure_allowed(path) if policy else path.resolve()
+    if not resolved.exists():
+        raise FileNotFoundError(f"Input file not found: {resolved}")
+    if not resolved.is_file():
+        raise ValueError(f"Input path is not a file: {resolved}")
+    return resolved
+
+
+def _ensure_com_available() -> None:
+    """Validate Excel COM availability and raise ValueError when unavailable."""
+    app: object | None = None
+    try:
+        app = render._require_excel_app()
+    except Exception as exc:  # pragma: no cover - delegated by render internals
+        raise ValueError(
+            "Excel (COM) is not available. Rendering (PDF/image) requires a desktop Excel installation."
+        ) from exc
+    finally:
+        if app is not None:
+            quit_method = getattr(app, "quit", None)
+            if callable(quit_method):
+                try:
+                    quit_method()
+                except Exception as exc:  # pragma: no cover - defensive probe cleanup
+                    logger.warning("Failed to close Excel app after COM probe: %s", exc)

{exstruct-0.5.2 → exstruct-0.5.3}/src/exstruct/mcp/server.py

@@ -4,6 +4,7 @@ import argparse
 import functools
 import importlib
 import logging
+import math
 import os
 from pathlib import Path
 import sys
@@ -24,6 +25,8 @@ from .patch.normalize import (
     parse_patch_op_json as _normalize_parse_patch_op_json,
 )
 from .tools import (
+    CaptureSheetImagesToolInput,
+    CaptureSheetImagesToolOutput,
     DescribeOpToolInput,
     DescribeOpToolOutput,
     ExtractToolInput,
@@ -44,6 +47,7 @@ from .tools import (
     RuntimeInfoToolOutput,
     ValidateInputToolInput,
     ValidateInputToolOutput,
+    run_capture_sheet_images_tool,
     run_describe_op_tool,
     run_extract_tool,
     run_list_ops_tool,
@@ -60,6 +64,7 @@ if TYPE_CHECKING:  # pragma: no cover - typing only
     from mcp.server.fastmcp import FastMCP
 
 logger = logging.getLogger(__name__)
+_DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS = 120.0
 
 
 class ServerConfig(BaseModel):
@@ -105,10 +110,15 @@ def run_server(config: ServerConfig) -> None:
         config: Server configuration.
     """
     os.environ.setdefault("EXSTRUCT_BORDER_CLUSTER_BACKEND", "python")
+    os.environ.setdefault("EXSTRUCT_RENDER_SUBPROCESS", "1")
     logger.info(
         "Border cluster backend set to %s for MCP.",
         os.getenv("EXSTRUCT_BORDER_CLUSTER_BACKEND"),
     )
+    logger.info(
+        "Render subprocess mode for MCP set to %s.",
+        os.getenv("EXSTRUCT_RENDER_SUBPROCESS"),
+    )
     _import_mcp()
     policy = PathPolicy(root=config.root, deny_globs=config.deny_globs)
     logger.info("MCP root: %s", policy.normalize_root())
@@ -302,6 +312,8 @@ def _register_tools(
     tool = app.tool(name="exstruct_extract")
     tool(_extract_tool)
 
+    _register_capture_sheet_images_tool(app, policy=policy)
+
     async def _read_json_chunk_tool(  # pylint: disable=redefined-builtin
         out_path: str,
         sheet: str | None = None,
@@ -722,6 +734,98 @@ Returns:
     return f"{base_description.strip()}\n\n{build_patch_tool_mini_schema()}"
 
 
+def _register_capture_sheet_images_tool(app: FastMCP, *, policy: PathPolicy) -> None:
+    """Register the sheet image capture MCP tool."""
+
+    async def _capture_sheet_images_tool(  # pylint: disable=redefined-builtin
+        xlsx_path: str,
+        out_dir: str | None = None,
+        dpi: int = 144,
+        sheet: str | None = None,
+        range: str | None = None,  # noqa: A002
+    ) -> CaptureSheetImagesToolOutput:
+        """Export worksheet images as PNG files (COM only).
+
+        Args:
+            xlsx_path: Path to the Excel workbook.
+            out_dir: Optional output directory for PNG files. When omitted, MCP
+                creates a unique directory under server `--root` using
+                `<workbook_stem>_images` with numeric suffixes as needed.
+            dpi: Rendering DPI (must be >= 1).
+            sheet: Optional target sheet name. Required only when `range` is
+                unqualified (for example, `A1:B2`).
+            range: Optional A1 range (`A1:B2`) with optional sheet qualifier
+                (`Sheet1!A1:B2`, `'Sheet 1'!A1:B2`).
+
+        Returns:
+            Export result payload with resolved output directory and image paths.
+        """
+        payload = CaptureSheetImagesToolInput(
+            xlsx_path=xlsx_path,
+            out_dir=out_dir,
+            dpi=dpi,
+            sheet=sheet,
+            range=range,
+        )
+        work = functools.partial(
+            run_capture_sheet_images_tool,
+            payload,
+            policy=policy,
+        )
+        timeout_seconds = _get_capture_sheet_images_timeout_seconds()
+        try:
+            with anyio.fail_after(timeout_seconds):
+                result = cast(
+                    CaptureSheetImagesToolOutput,
+                    await anyio.to_thread.run_sync(work, abandon_on_cancel=True),
+                )
+        except TimeoutError as exc:
+            raise TimeoutError(
+                "capture_sheet_images timed out after "
+                f"{timeout_seconds:.1f}s. "
+                "Adjust workbook/range size or increase "
+                "EXSTRUCT_MCP_CAPTURE_SHEET_IMAGES_TIMEOUT_SEC."
+            ) from exc
+        return result
+
+    capture_sheet_images_tool = app.tool(name="exstruct_capture_sheet_images")
+    capture_sheet_images_tool(_capture_sheet_images_tool)
+
+
+def _get_capture_sheet_images_timeout_seconds() -> float:
+    """Return capture timeout seconds from environment."""
+    raw_value = os.getenv("EXSTRUCT_MCP_CAPTURE_SHEET_IMAGES_TIMEOUT_SEC")
+    if raw_value is None:
+        return _DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS
+    try:
+        parsed = float(raw_value)
+    except ValueError:
+        logger.warning(
+            "Invalid EXSTRUCT_MCP_CAPTURE_SHEET_IMAGES_TIMEOUT_SEC=%r. "
+            "Falling back to %.1fs.",
+            raw_value,
+            _DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS,
+        )
+        return _DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS
+    if not math.isfinite(parsed):
+        logger.warning(
+            "Non-finite EXSTRUCT_MCP_CAPTURE_SHEET_IMAGES_TIMEOUT_SEC=%r. "
+            "Falling back to %.1fs.",
+            raw_value,
+            _DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS,
+        )
+        return _DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS
+    if parsed <= 0:
+        logger.warning(
+            "Non-positive EXSTRUCT_MCP_CAPTURE_SHEET_IMAGES_TIMEOUT_SEC=%r. "
+            "Falling back to %.1fs.",
+            raw_value,
+            _DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS,
+        )
+        return _DEFAULT_CAPTURE_SHEET_IMAGES_TIMEOUT_SECONDS
+    return parsed
+
+
 def _register_op_schema_tools(app: FastMCP) -> None:
     """Register schema discovery tools."""
 

exstruct-0.5.3/src/exstruct/mcp/shared/__init__.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from .a1 import (
+    QualifiedA1Range,
+    SheetRangeSelection,
+    column_index_to_label,
+    column_label_to_index,
+    normalize_range,
+    parse_qualified_a1_range,
+    parse_range_geometry,
+    range_cell_count,
+    resolve_sheet_and_range,
+    split_a1,
+)
+from .output_path import (
+    apply_conflict_policy,
+    next_available_directory,
+    next_available_path,
+    resolve_image_output_dir,
+    resolve_output_path,
+)
+
+__all__ = [
+    "QualifiedA1Range",
+    "SheetRangeSelection",
+    "apply_conflict_policy",
+    "column_index_to_label",
+    "column_label_to_index",
+    "next_available_path",
+    "next_available_directory",
+    "normalize_range",
+    "parse_qualified_a1_range",
+    "parse_range_geometry",
+    "range_cell_count",
+    "resolve_image_output_dir",
+    "resolve_sheet_and_range",
+    "resolve_output_path",
+    "split_a1",
+]