docvortex 0.3.0__tar.gz → 0.4.0__tar.gz

{docvortex-0.3.0/src/docvortex.egg-info → docvortex-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docvortex
-Version: 0.3.0
+Version: 0.4.0
 Summary: A fast, multi-format document parsing and conversion engine
 License-Expression: MIT
 Project-URL: Repository, https://github.com/myhloli/DocVortex
@@ -215,3 +215,7 @@ All 15 native document formats support this API. Normal parsing also carries the
 DocVortex supports ordinary CPython 3.10–3.14. Physical text lines are joined by deterministic Unicode boundary rules, with URL and dehyphenation safeguards. Language detection models and the fast-langdetect / fasttext-predict dependencies are no longer required.
 
 The shared `resolve_text_line_boundary` and `merge_text_line_contents` helpers no longer accept `block_language`; `detect_lang` has been removed. Hosts should call the shared boundary helpers directly. OCR language selection and Magika code-language recognition are unchanged.
+
+## Public SDK and 0.4 migration
+
+Geometry, document access, assets and regional PDF analysis have explicit public contracts. See [the SDK migration guide](docs/sdk-0.4.md). `docvortex.public_api.PUBLIC_API` lists supported cross-package modules and symbols. Replaced Python paths are removed in 0.4; document JSON and Bundle semantics are unchanged. Upgrade MinerU together, or constrain older hosts to `docvortex<0.4.0`.

{docvortex-0.3.0 → docvortex-0.4.0}/README.md

@@ -162,3 +162,7 @@ All 15 native document formats support this API. Normal parsing also carries the
 DocVortex supports ordinary CPython 3.10–3.14. Physical text lines are joined by deterministic Unicode boundary rules, with URL and dehyphenation safeguards. Language detection models and the fast-langdetect / fasttext-predict dependencies are no longer required.
 
 The shared `resolve_text_line_boundary` and `merge_text_line_contents` helpers no longer accept `block_language`; `detect_lang` has been removed. Hosts should call the shared boundary helpers directly. OCR language selection and Magika code-language recognition are unchanged.
+
+## Public SDK and 0.4 migration
+
+Geometry, document access, assets and regional PDF analysis have explicit public contracts. See [the SDK migration guide](docs/sdk-0.4.md). `docvortex.public_api.PUBLIC_API` lists supported cross-package modules and symbols. Replaced Python paths are removed in 0.4; document JSON and Bundle semantics are unchanged. Upgrade MinerU together, or constrain older hosts to `docvortex<0.4.0`.

docvortex-0.4.0/docs/sdk-0.4.md

@@ -0,0 +1,39 @@
+# DocVortex 0.4 公共 SDK 与宿主迁移
+
+MinerU 使用 `docvortex>=0.4.0,<0.5.0`。本轮调整 Python 模块边界，保持文档协议、解析路由、模型回退与渲染语义。
+
+## 公开入口
+
+| 原入口或职责 | 新入口 |
+| --- | --- |
+| foundation 几何及 PDF 通用坐标原语 | `docvortex.geometry` |
+| foundation 文本与链接规则 | `docvortex.content.text`、`docvortex.content.links` |
+| 图像统计、素材编码与路径校验 | `docvortex.assets` |
+| PDFDocument、PDFPage、字符和几何契约 | `docvortex.document.pdf` |
+| HTML 来源上下文 | `docvortex.document.contracts.HtmlSourceContext` |
+| 原生文字证据、区域表格及 OCR 文本投影 | `docvortex.analyzers.pdf` |
+| 模型文本、坐标自动判断与虚拟 OCR token | MinerU PDF 分析层 |
+| xhigh layout 容器补全 | MinerU PDF 分析层 |
+| 推理平台支持判断 | MinerU model/runtime |
+
+`docvortex.public_api.PUBLIC_API` 是静态模块及符号清单。新增跨库依赖必须同时更新清单、文档和契约测试；不能通过基础实现、私有模块或动态别名绕过边界。
+
+## 行为与资源所有权
+
+`prepare_text_evidence` 返回具名的 `PDFTextEvidence`，`apply_text_evidence` 统一完成链接、样式、脚本与 InlineSpan 物化。MinerU 仍决定调用时机、公式排除区域、超大字符页和 OCR 回退。
+
+`prepare_table_page` 仅在存在候选表格时调用；同页复用其物化数据。`recover_table_region` 返回最终 HTML、来源、置信度和诊断，`None` 表示没有可接受结果。结构恢复异常以 `PDFTableRecoveryError` 保留原始原因，交给宿主回退；HTML 物化异常继续传播，避免改变旧异常边界。页面几何可以复用，证据不持有 PDFium 裸句柄。
+
+通用 `convert_bbox` 显式声明 `unit`、`pixel` 或 `point`；`page_size` 使用 point，`render_scale` 是每 point 的像素数。模型 bbox 的自动解释与三位小数规则保留在 MinerU。共享 PDFium 锁、进程池和资源关闭职责仍归 DocVortex。
+
+## 升级与回退
+
+本轮直接删除被替代的旧门面及重导出，不提供过渡版本或旧 pickle 路径兼容。JSON、Bundle、HTTP API 和输出格式保持既有契约。
+
+配套升级两个 wheel；旧版 MinerU 必须显式约束 `docvortex<0.4.0`。旧版依赖上限 `<1` 无法阻止解析器选择 0.4，因此不要只升级 DocVortex。回退时同时恢复旧版 MinerU 与其兼容的 DocVortex。
+
+## 验证
+
+`tools/validate_docvortex_boundary.py` 可对指定两仓库源码或当前安装包捕获真实 PDF 的中间协议与全部渲染。记录实际导入路径、样本 SHA256 和页数；比较时只允许忽略 DocVortex producer 版本、DOCX/EPUB 容器时间字段，以及经独立复算确认由 producer 版本派生的 EPUB 标识。
+
+MinerU 的 `DocVortex boundary integration` 手动工作流接受未发布的 0.4 wheel URL，以及可选的 mineru-vl-utils 配套 wheel URL，在三种操作系统及 Python 3.10、3.13、3.14 上验证边界、协议和固定推理结果。DocVortex 自身 CI 验证独立安装与基础算法。配置工作流不代表已经通过远端 CI。

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/_shared/hyperlink.py

@@ -2,13 +2,12 @@
 
 from __future__ import annotations
 
-from ....foundation.hyperlink import (
+from ....foundation._hyperlink import (
     DEFAULT_EXTERNAL_HYPERLINK_SCHEMES,
     OFFICE_EXTERNAL_HYPERLINK_SCHEMES,
     sanitize_hyperlink_target,
 )
 
-
 __all__ = [
     "DEFAULT_EXTERNAL_HYPERLINK_SCHEMES",
     "OFFICE_EXTERNAL_HYPERLINK_SCHEMES",

docvortex-0.4.0/src/docvortex/analyzers/native/_shared/image.py

@@ -0,0 +1,5 @@
+"""保留原有导入入口；共享实现由下层模块唯一维护。"""
+
+from ....foundation.image_encoding import image_to_b64str, image_to_bytes
+
+__all__ = ["image_to_b64str", "image_to_bytes"]

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/_shared/names.py

@@ -1,7 +1,5 @@
 """保留原有导入入口；共享实现由下层模块唯一维护。"""
 
-from docvortex.foundation.xml_names import (
-    local_name as local_name,
-)
+from ....foundation.xml_names import local_name
 
 __all__ = ["local_name"]

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/contracts.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING, Any, BinaryIO, Protocol, TypedDict
 from ...schema import BBox
 
 if TYPE_CHECKING:
-    from ...document.pdf.document import _PDFPageSnapshot
+    from ...document.pdf._document import _PDFPageSnapshot
 
 
 class RawBlock(TypedDict, total=False):

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/epub/xhtml.py

@@ -5,12 +5,9 @@ from __future__ import annotations
 import base64
 from dataclasses import dataclass
 
-from lxml import html as lxml_html
 from lxml import etree  # type: ignore[reportMissingImports]
+from lxml import html as lxml_html
 
-from ....content.spans import normalize_span_dicts
-from ....foundation.image_payload import parse_image_data_uri_strict
-from .._shared.hyperlink import sanitize_hyperlink_target
 from docvortex.content.markup import (
     MarkupAnchorDocument,
     MarkupAnchorRegistry,
@@ -22,11 +19,23 @@ from docvortex.content.markup import (
 )
 from docvortex.content.markup.projector import (
     BLOCK_TAGS as _BLOCK_TAGS,
+)
+from docvortex.content.markup.projector import (
     SKIPPED_TAGS as _SKIPPED_TAGS,
+)
+from docvortex.content.markup.projector import (
     clean_text_node as _clean_text_node,
+)
+from docvortex.content.markup.projector import (
     entity_text as _entity_text,
+)
+from docvortex.content.markup.projector import (
     local_name as _local_name,
 )
+
+from ....content.spans import normalize_span_dicts
+from ....foundation._image_payload import parse_image_data_uri_strict
+from .._shared.hyperlink import sanitize_hyperlink_target
 from .constants import IMAGE_MEDIA_BY_EXTENSION, SVG_MEDIA_TYPE
 from .package import EpubPackage
 

docvortex-0.4.0/src/docvortex/analyzers/native/html/__init__.py

@@ -0,0 +1,5 @@
+"""HTML 静态 Flash 解析实现。"""
+
+from .errors import HtmlParseError, HtmlResourceLimitError
+
+__all__ = ["HtmlParseError", "HtmlResourceLimitError"]

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/html/converter.py

@@ -8,17 +8,18 @@ from typing import Any, BinaryIO
 
 from loguru import logger
 
-from ....schema import BlockType
 from docvortex.content.markup import MarkupProjector, MarkupStylesheet
+from docvortex.document.contracts import HtmlSourceContext
+
+from ....codecs.html import decode_docvortex_html_wire
 from ....content.spans import text_spans
+from ....schema import BlockType
 from .anchors import HtmlAnchorRegistry, append_referenced_notes
 from .constants import MAX_HTML_BYTES, MAX_HTML_RENDERED_BYTES
-from docvortex.document.contracts import HtmlSourceContext
 from .document import HtmlDocument, parse_html_document
 from .errors import HtmlResourceLimitError
 from .resources import HtmlResourceContext
 from .selector import select_auto_content
-from ....codecs.html import decode_docvortex_html_wire
 
 
 class HtmlConverter:

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/html/document.py

@@ -3,19 +3,20 @@
 from __future__ import annotations
 
 import codecs
+import re
 from copy import deepcopy
 from dataclasses import dataclass
-import re
 from typing import Literal
 
-from lxml import etree, html as lxml_html  # type: ignore[reportMissingImports]
+from lxml import etree  # type: ignore[reportMissingImports]
+from lxml import html as lxml_html
 
 from docvortex.content.markup.formula import FormulaExtraction, extract_formula, is_tex_script
 from docvortex.content.markup.projector import local_name
-from .constants import MAX_HTML_BYTES, MAX_HTML_DEPTH, MAX_HTML_NODES
 from docvortex.document.contracts import HtmlSourceContext
-from .errors import HtmlParseError, HtmlResourceLimitError
 
+from .constants import MAX_HTML_BYTES, MAX_HTML_DEPTH, MAX_HTML_NODES
+from .errors import HtmlParseError, HtmlResourceLimitError
 
 _ACTIVE_TAGS = frozenset(
     {

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/html/resources.py

@@ -9,19 +9,19 @@ from urllib.parse import SplitResult, unquote, urljoin, urlsplit, urlunsplit
 
 from lxml import etree  # type: ignore[reportMissingImports]
 
-from ....foundation.image_payload import parse_image_data_uri_strict, validate_remote_image_url
-from .._shared.hyperlink import sanitize_hyperlink_target
 from docvortex.content.markup import ResolvedMarkupImage
+from docvortex.document.contracts import HtmlSourceContext
+
+from ....foundation._image_payload import parse_image_data_uri_strict, validate_remote_image_url
+from .._shared.hyperlink import sanitize_hyperlink_target
 from .constants import (
     MAX_HTML_IMAGE_BYTES,
     MAX_HTML_IMAGE_TOTAL_BYTES,
     MAX_HTML_STYLESHEET_BYTES,
     MAX_HTML_STYLESHEET_TOTAL_BYTES,
 )
-from docvortex.document.contracts import HtmlSourceContext
 from .errors import HtmlResourceLimitError
 
-
 _IMAGE_MIME_SIGNATURES: tuple[tuple[str, tuple[bytes, ...]], ...] = (
     ("image/jpeg", (b"\xff\xd8\xff",)),
     ("image/png", (b"\x89PNG\r\n\x1a\n",)),

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/models.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING, Any, BinaryIO
 from docvortex.document.contracts import HtmlSourceContext
 
 if TYPE_CHECKING:
-    from ...document.pdf.document import PDFDocument
+    from ...document.pdf._document import PDFDocument
 
 
 class PdfModel:
@@ -15,8 +15,8 @@ class PdfModel:
 
     def predict(self, pdf_doc: PDFDocument) -> list[list[dict[str, Any]]]:
         """分析调用方持有的 PDFDocument，在所有文字匹配结束后统一输出可见英数。"""
-        from .pdf import pipeline
         from ...content import normalize_pdf_model_text
+        from .pdf import pipeline
 
         pages = pipeline._analyze_native_document(pdf_doc)
         normalize_pdf_model_text(pages)

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/ofd/images.py

@@ -6,12 +6,12 @@ import math
 from io import BytesIO
 
 from loguru import logger
-from PIL import Image, UnidentifiedImageError
 from lxml import etree  # type: ignore[reportMissingImports]
+from PIL import Image, UnidentifiedImageError
 
-from docvortex.foundation.image_encoding import image_to_b64str
+from ....foundation._image_payload import validate_decoded_raster_size
+from ....foundation.image_encoding import image_to_b64str
 from ....schema import BBox
-from ....foundation.image_payload import validate_decoded_raster_size
 from .errors import OfdParseError
 from .geometry import Affine, bbox_intersection, canonical_angle, parse_affine, parse_st_box, transform_angle, transform_bbox
 from .models import ImageItem, ResourceRegistry

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/ofd/vector.py

@@ -10,11 +10,11 @@ from xml.etree import ElementTree as ET
 from lxml import etree
 from PIL import Image, ImageChops
 
-from ....foundation.image_payload import MAX_DECODED_RASTER_DIMENSION, MAX_DECODED_RASTER_PIXELS
+from ....foundation._image_payload import MAX_DECODED_RASTER_DIMENSION, MAX_DECODED_RASTER_PIXELS
 from ....schema import BBox
 from .constants import MAX_ENTRY_BYTES
 from .errors import OfdResourceLimitError
-from .geometry import Affine, bbox_intersection, parse_affine, parse_st_box, transform_bbox, parse_numbers
+from .geometry import Affine, bbox_intersection, parse_affine, parse_numbers, parse_st_box, transform_bbox
 from .models import OfdPageScene
 from .package import OfdPackage, element_text, first_child, local_name
 from .path import OfdPathBudget, PathCommand, parse_path_commands

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/office/docx/context.py

@@ -3,9 +3,11 @@
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Final, Optional, TypeAlias, Union
+
 from pydantic import AnyUrl
+
+from .....foundation.type_identity import preserve_type_module
 from .formatting_types import Formatting
-from docvortex.foundation.type_identity import preserve_type_module
 
 _ParagraphHyperlink: TypeAlias = Optional[Union[AnyUrl, Path, str]]
 _ParagraphElement: TypeAlias = tuple[str, Optional[Formatting], _ParagraphHyperlink]

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/office/image.py

@@ -11,7 +11,7 @@ from loguru import logger
 from metafile_render import MetafileError, MetafileResourceLimitError, render_metafile
 from PIL import Image, ImageDraw, ImageFont, UnidentifiedImageError
 
-from docvortex.foundation.image_encoding import image_to_b64str
+from ....foundation.image_encoding import image_to_b64str
 
 VECTOR_IMAGE_FORMATS = frozenset({"WMF", "EMF"})
 VECTOR_IMAGE_EXTENSIONS = frozenset({".wmf", ".emf"})

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/office/odf/text.py

@@ -11,8 +11,8 @@ from typing import Any
 
 from lxml import etree  # type: ignore[reportMissingImports]
 
-from .....schema import BlockType
-from ..._shared.hyperlink import sanitize_hyperlink_target
+from docvortex.content.mathml import mathml_to_latex
+
 from .....content.spans import (
     append_equation_span,
     append_text_span,
@@ -20,8 +20,9 @@ from .....content.spans import (
     inline_span_plain_text,
     strip_span_dicts,
 )
-from docvortex.content.mathml import mathml_to_latex
-from docvortex.foundation.image_encoding import image_to_b64str
+from .....foundation.image_encoding import image_to_b64str
+from .....schema import BlockType
+from ..._shared.hyperlink import sanitize_hyperlink_target
 from ..image import create_text_placeholder, serialize_office_image
 from ..rich_text import OfficeRichTextSegment, build_rich_text_from_segments
 from .chart import parse_chart_block
@@ -32,7 +33,6 @@ from .package import OdfPackage
 from .styles import OdfStyles
 from .table import OdfTableExpansionBudget, parse_table_grid, table_grid_to_html
 
-
 _WHITESPACE_RE = re.compile(r"[\t\r\n ]+")
 _MAX_EXPLICIT_SPACE_COUNT = 10_000
 

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/office/pptx/context.py

@@ -2,9 +2,10 @@
 
 from dataclasses import dataclass
 from typing import Any, Final, Optional
+
 from pptx.enum.shapes import PP_PLACEHOLDER
-from docvortex.foundation.type_identity import preserve_type_module
 
+from .....foundation.type_identity import preserve_type_module
 
 IGNORED_NOTES_PLACEHOLDER_TYPES: Final = {
     PP_PLACEHOLDER.SLIDE_IMAGE,

docvortex-0.3.0/src/docvortex/analyzers/native/pdf/script_geometry.py → docvortex-0.4.0/src/docvortex/analyzers/native/pdf/_script_geometry.py

@@ -7,11 +7,9 @@ import statistics
 from dataclasses import dataclass
 from typing import Any, Literal
 
-from ....document.pdf.text.contracts import Char
-
+from ....document.pdf.text._contracts import Char
 from ....schema import BBox
 
-
 SCRIPT_BODY_COMPARABLE_HEIGHT_RATIO = 0.9
 SCRIPT_BASELINE_ABSOLUTE_TOLERANCE = 0.35
 SCRIPT_BASELINE_LOOSE_HEIGHT_RATIO = 0.04

{docvortex-0.3.0/src/docvortex/analyzers/native/pdf/table_recovery → docvortex-0.4.0/src/docvortex/analyzers/native/pdf/_table_recovery}/candidate.py

@@ -8,7 +8,6 @@ from collections.abc import Callable
 from dataclasses import dataclass
 
 from .....schema import BBox
-
 from .contracts import NativeTableCandidate, NativeTableCandidateSource, NativeTableCell, NativeTableGlyph, NativeTableText
 from .geometry import bbox_center
 from .text import build_cell_text, glyph_overlap_ratio

{docvortex-0.3.0/src/docvortex/analyzers/native/pdf/table_recovery → docvortex-0.4.0/src/docvortex/analyzers/native/pdf/_table_recovery}/contracts.py

@@ -5,8 +5,7 @@ from __future__ import annotations
 from dataclasses import dataclass, field
 from typing import Literal
 
-from .....document.pdf.text.contracts import Char
-
+from .....document.pdf.text._contracts import Char
 from .....schema import BBox
 
 NativeTableCandidateSource = Literal[
@@ -19,6 +18,10 @@ NativeTableCandidateSource = Literal[
 ]
 
 
+class PDFTableRecoveryError(RuntimeError):
+    """标记结构恢复阶段的失败，供宿主区分可回退错误与 HTML 物化异常。"""
+
+
 @dataclass(frozen=True, slots=True)
 class NativeTableRule:
     """保存页面坐标中的一条可见横线或竖线。"""

{docvortex-0.3.0/src/docvortex/analyzers/native/pdf/table_recovery → docvortex-0.4.0/src/docvortex/analyzers/native/pdf/_table_recovery}/geometry.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 from collections.abc import Iterable
 
 from .....schema import BBox
-from ..table_geometry import normalize_bbox as normalize_bbox, rotate_local_bbox as rotate_local_bbox
+from ..table_geometry import normalize_bbox, rotate_local_bbox
 
 
 def normalize_angle(value: object) -> int:

{docvortex-0.3.0/src/docvortex/analyzers/native/pdf/table_recovery → docvortex-0.4.0/src/docvortex/analyzers/native/pdf/_table_recovery}/sparse_hybrid.py

@@ -8,10 +8,10 @@ from collections import Counter
 from dataclasses import dataclass
 from typing import Any
 
-from .sparse_common import _LocalRule, _local_rules, cluster_members
 from .candidate import GridCellSpec, build_candidate
 from .contracts import NativeTableCandidate, NativeTableInput, NativeTableText, NativeTableTextRow
 from .geometry import covered_interval_ratio, normalize_angle, normalize_bbox, page_bbox_to_table_local, table_local_size
+from .sparse_common import _local_rules, _LocalRule, cluster_members
 
 MIN_COLUMN_SUPPORT = 0.60
 MIN_OVERALL_ANCHOR_SUPPORT = 0.80

{docvortex-0.3.0/src/docvortex/analyzers/native/pdf/table_recovery → docvortex-0.4.0/src/docvortex/analyzers/native/pdf/_table_recovery}/sparse_multiline.py

@@ -8,10 +8,10 @@ from collections import Counter
 from dataclasses import dataclass
 from typing import Any
 
-from .sparse_common import _LocalRule, _local_rules, cluster_members
 from .candidate import GridCellSpec, build_candidate
 from .contracts import NativeTableCandidate, NativeTableGlyph, NativeTableInput, NativeTableText, NativeTableTextRow
 from .geometry import covered_interval_ratio, normalize_angle, normalize_bbox, page_bbox_to_table_local, table_local_size
+from .sparse_common import _local_rules, _LocalRule, cluster_members
 
 MIN_MULTILINE_RELIABILITY = 0.98
 

{docvortex-0.3.0/src/docvortex/analyzers/native/pdf/table_recovery → docvortex-0.4.0/src/docvortex/analyzers/native/pdf/_table_recovery}/text.py

@@ -6,12 +6,10 @@ import statistics
 import unicodedata
 from dataclasses import dataclass
 
-from .....document.pdf.text.contracts import Char
-
+from .....document.pdf.text._contracts import Char
+from .....foundation._text import resolve_text_line_boundary
 from .....schema import BBox
-from .....foundation.text import resolve_text_line_boundary
 from ..spatial_text import _normalize_table_text
-
 from .contracts import NativeTableGlyph, NativeTableInput, NativeTableText, NativeTableTextRow, NativeTableToken
 from .geometry import bbox_center, bbox_intersection, bbox_union, normalize_angle, normalize_bbox, page_bbox_to_table_local
 

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/char_geometry.py

@@ -11,13 +11,13 @@ from dataclasses import dataclass, field
 from functools import lru_cache
 from typing import Any, Literal, Sequence, TypeAlias
 
+from ....document.pdf._document import PDFPageTextGeometry
 from ....schema import BBox
-from ....document.pdf.document import PDFPageTextGeometry
 from .geometry import (
-    _clip_validated_bbox,
     _bbox_axis_overlap_ratio,
     _bbox_union_many,
     _clip_bbox,
+    _clip_validated_bbox,
     _coerce_bbox,
     _rotate_bbox_from_upright,
     _rotate_bbox_to_upright,
@@ -25,7 +25,6 @@ from .geometry import (
 )
 from .models import _LineItem
 
-
 X_RELIABLE_PAIR_MIN = 30
 X_STRONG_MEDIAN_RATIO = 1.30
 X_STRONG_RATIO_THRESHOLD = 1.35

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/code_blocks.py

@@ -7,10 +7,8 @@ import statistics
 import unicodedata
 from typing import Any
 
-from .spatial_text import project_pdf_spatial_text
+from ....document.pdf._document import PDFPathInfo
 from ....schema import BBox
-from ....document.pdf.document import PDFPathInfo
-
 from .geometry import (
     _bbox_area,
     _bbox_center_x,
@@ -21,7 +19,7 @@ from .geometry import (
 )
 from .models import _CodeCandidate, _LineItem, _PageSource
 from .native_text import _sanitize_pdf_control_text
-
+from .spatial_text import project_pdf_spatial_text
 
 _MONOSPACE_FONT_HINTS = (
     "mono",

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/formulas.py

@@ -8,12 +8,9 @@ import unicodedata
 from dataclasses import dataclass, replace
 from typing import Any
 
-
+from ....document.pdf._document import PDFPathInfo
+from ....foundation._text import build_tagged_formula_content
 from ....schema import BBox
-from ....document.pdf.document import PDFPathInfo
-from ....foundation.text import build_tagged_formula_content
-
-from .models import _AxisLine, _FormulaAnchor, _LineItem, _PageSource, _TextLane
 from .geometry import (
     _bbox_axis_overlap_ratio,
     _bbox_center_x,
@@ -30,7 +27,6 @@ from .geometry import (
     _rotate_bbox_to_upright,
     _transform_axis_lines,
 )
-from .native_text import _sanitize_pdf_control_text
 from .line_layout import (
     _connection_crosses_table,
     _infer_text_lanes,
@@ -40,7 +36,8 @@ from .line_layout import (
     _lines_tight_output_bbox,
 )
 from .line_merging import _join_formula_visual_row, _merge_overlapping_inline_cluster
-
+from .models import _AxisLine, _FormulaAnchor, _LineItem, _PageSource, _TextLane
+from .native_text import _sanitize_pdf_control_text
 
 _FORMULA_NUMBER_SUFFIX_RE = re.compile(r"^(?P<prefix>.*?)(?P<marker>[(（﹙][^()（）﹙﹚\r\n]+[)）﹚])\s*$")
 _FORMULA_NUMBER_MARKER_RE = re.compile(

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/graphics.py

@@ -2,17 +2,14 @@
 
 from __future__ import annotations
 
-from dataclasses import replace
 import math
 import re
 import statistics
+from dataclasses import replace
 from typing import Any
 
-
+from ....document.pdf._document import PDFPathInfo
 from ....schema import BBox
-from ....document.pdf.document import PDFPathInfo
-
-from .models import _AxisLine, _GraphicCandidate, _LineItem, _PageSource, _TextLane
 from .geometry import (
     _bbox_area,
     _bbox_axis_overlap_ratio,
@@ -29,10 +26,10 @@ from .geometry import (
     _point_in_bbox,
     _rotate_bbox_to_upright,
 )
-from .native_text import _fill_native_typography, _normalize_native_run_text, _sanitize_pdf_control_text
 from .line_layout import _infer_text_lanes, _line_effective_height
 from .line_merging import _join_formula_visual_row
-
+from .models import _AxisLine, _GraphicCandidate, _LineItem, _PageSource, _TextLane
+from .native_text import _fill_native_typography, _normalize_native_run_text, _sanitize_pdf_control_text
 
 _MIN_RASTER_IMAGE_PAGE_AREA_RATIO = 0.0038
 

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/inline/detection.py

@@ -6,8 +6,8 @@ import math
 import statistics
 from typing import Any, Sequence
 
+from .....document.pdf._document import PDFLinkAnnotation
 from .....schema import BBox
-from .....document.pdf.document import PDFLinkAnnotation
 from .common import (
     _bbox_intersection_area,
     _canonical_styles,

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/inline/matching.py

@@ -7,8 +7,8 @@ from typing import TYPE_CHECKING, Any, Sequence
 
 from loguru import logger
 
+from .....foundation._text import is_hyphen_at_line_end
 from .....schema import BBox
-from .....foundation.text import is_hyphen_at_line_end
 
 if TYPE_CHECKING:
     from ..models import _LineItem

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/inline/materialize.py

@@ -5,7 +5,6 @@ from __future__ import annotations
 import re
 from typing import Any, Sequence
 
-from .....schema import BBox
 from .....content.spans import (
     append_equation_span,
     append_hyperlink_span,
@@ -13,6 +12,7 @@ from .....content.spans import (
     extend_inline_spans,
     normalize_span_dicts,
 )
+from .....schema import BBox
 from .common import _canonical_styles
 from .matching import (
     _assign_lines_to_blocks,
@@ -455,3 +455,19 @@ __all__ = [
     "_parse_native_script_markup",
     "materialize_pdf_inline_spans",
 ]
+
+
+def apply_pdf_inline_evidence(
+    blocks: list[dict[str, Any]],
+    link_lines: list[PDFTextLinkLine],
+    style_lines: list[PDFTextStyleLine],
+    script_lines: list[PDFTextScriptLine],
+    page_size: tuple[float, float],
+    *,
+    materialized_diagnostics: list[dict[str, Any]] | None = None,
+) -> None:
+    """在调用方已有页面准备之后统一执行行内语义物化顺序。"""
+    apply_pdf_text_links(blocks, link_lines, page_size)
+    apply_pdf_text_styles(blocks, style_lines, page_size)
+    apply_pdf_text_scripts(blocks, script_lines, page_size, materialized_diagnostics=materialized_diagnostics)
+    materialize_pdf_inline_spans(blocks)

{docvortex-0.3.0 → docvortex-0.4.0}/src/docvortex/analyzers/native/pdf/inline/scripts.py

@@ -7,8 +7,8 @@ import unicodedata
 from typing import Any, Literal, Sequence
 
 from .....schema import BBox
+from .._script_geometry import ScriptRole, classify_char_script_roles
 from ..geometry import _rotate_bbox_to_upright
-from ..script_geometry import ScriptRole, classify_char_script_roles
 from .common import _coerce_bbox, _normalize_match_fragment, _ordered_line_chars
 from .types import (
     _PDF_SCRIPT_AUTHOR_MARKS,