OVAPortableText 0.1.0__tar.gz → 0.1.2__tar.gz

{ovaportabletext-0.1.0/docs/dev/ova → ovaportabletext-0.1.2}/CHANGELOG.md

@@ -5,14 +5,21 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.2]
+
 ### Added
-- publish-readiness improvements for packaging, CI, docs, and edge tests
-- runtime `__version__` single source module
-- `py.typed` marker for typed package consumers
-- release-oriented docs: API reference and publishing checklist
-- file-based round-trip helpers: `save_json()` / `load_json()`
-- section batch helpers: `append_paragraphs()` / `append_bullet_items()` / `append_number_items()`
-- additional real-world docs, smoke examples, and regression-oriented tests
+- optional `strict_ids=True` fail-early duplicate-ID checks for common authoring paths
+- continuous-content helpers on `Section`:
+  - `append_to_last_content()`
+  - `append_blocks_to_last_content()`
+  - `append_text_block_to_last_content()`
+  - `append_paragraph_to_last_content()`
+- release-facing docs now explain the implemented v1.0 protocol subset more explicitly
+
+### Changed
+- packaging and release metadata were aligned for a cleaner publication flow
+- `Section.numbering` now accepts only protocol-approved values: `auto`, `none`, and `manual`
+- publishing checklist now includes changelog layout and sdist verification guidance
 
 ## [0.1.1]
 

{ovaportabletext-0.1.0 → ovaportabletext-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OVAPortableText
-Version: 0.1.0
+Version: 0.1.2
 Summary: Python builder for generating OVAPortableText / Report Profile v1 JSON documents
 Author: FENG QU
 License-Expression: MIT
@@ -29,7 +29,10 @@ OVAPortableText 的目标不是直接渲染 PDF，而是让 Python 端**以强
 
 ## Current scope / 当前实现范围
 
-Step 9 currently includes:
+The package currently implements an intentionally selected, production-usable subset of the v1.0 protocol rather than every reserved taxonomy item.
+当前实现是 v1.0 协议里一个**可生产使用的已落地子集**，并不是把规范里所有预留 taxonomy 一次性全部实现。
+
+Implemented today:
 
 - top-level document / section skeleton
 - content body items
@@ -37,19 +40,19 @@ Step 9 currently includes:
 - protocol-approved text styles for v1
 - decorator marks + annotation `markDefs`
 - list semantics: `listItem` / `level`
-- first batch of inline objects:
+- inline objects:
   - `hard_break`
   - `xref`
   - `citation_ref`
   - `footnote_ref`
   - `glossary_term`
-- first batch of block objects:
+- block objects:
   - `image`
   - `chart`
   - `table`
   - `math_block`
   - `callout`
-- first typed registries:
+- typed registries:
   - `assets.images / logos / backgrounds / icons / attachments`
   - `datasets.tables / charts(pie) / metrics`
   - `bibliography / footnotes / glossary`
@@ -57,9 +60,16 @@ Step 9 currently includes:
 - section / figure / table / equation numbering helpers
 - global resolver / index builder
 - structured document validation report with issue context
-- detailed bilingual comments / 详细中英文双语注释
 - round-trip helpers: `from_dict()` / `from_json()` / `save_json()` / `load_json()`
 
+Not yet implemented as first-class authoring helpers:
+
+- reserved or future taxonomy items that are present in the protocol but not yet exposed as stable Python helpers
+- a full generated symbol reference for every internal class or helper
+
+This boundary is intentional: the package focuses on the pieces that are already stable enough for Python authoring and downstream renderer handoff.
+这个边界是有意为之：当前包优先把已经稳定、适合 Python 生产 JSON 和交给下游渲染器的部分做好。
+
 ## Install / 安装
 
 ### PIP
@@ -71,12 +81,13 @@ pip install OVAPortableText
 ## Quick start / 快速开始
 
 ```python
-from ova_portable_text import create_document, section
+from ova_portable_text import create_document
 
 report = create_document(
     title="Patent Valuation Report",
     language="en",
     documentType="report",
+    strict_ids=True,
 )
 
 intro = report.new_section(id="sec-1", level=1, title="Executive Summary")
@@ -85,7 +96,7 @@ intro.append_paragraph("This is the opening introduction of the chapter.")
 background = intro.new_subsection(id="sec-1-1", title="Background")
 background.append_paragraph("This is the body text of subsection 1.1.")
 
-intro.append_paragraph("This is a concluding paragraph after subsection 1.1.")
+intro.append_paragraph_to_last_content("This is a concluding paragraph after subsection 1.1.")
 
 report.assert_valid()
 print(report.to_json())
@@ -95,9 +106,10 @@ print(report.to_json())
 
 1. create one `Document`
 2. append sections and registries
-3. call `validate()` during development
-4. call `assert_valid()` before exporting or handing off to Java
-5. export with `to_dict()` / `to_json()`
+3. enable `strict_ids=True` during authoring when you want duplicate IDs to fail early
+4. call `validate()` during development
+5. call `assert_valid()` before exporting or handing off to Java
+6. export with `to_dict()` / `to_json()`
 
 ## Common authoring patterns / 常见写法
 
@@ -158,7 +170,36 @@ report.add_chart_dataset(
 )
 ```
 
-### 3) Validate before export / 导出前校验
+### 3) Fail duplicate IDs earlier when needed / 需要时尽早拦截重复 ID
+
+```python
+from ova_portable_text import create_document
+
+report = create_document(title="Strict IDs", language="en", strict_ids=True)
+report.new_section(id="sec-1", level=1, title="Intro")
+
+# Raises immediately instead of waiting until validate()
+report.new_section(id="sec-1", level=1, title="Duplicate Intro")
+```
+
+### 4) Keep a continuous content flow / 保持连续 content 语义
+
+```python
+from ova_portable_text import create_document
+
+report = create_document(title="Flow Demo", language="en")
+sec = report.new_section(id="sec-1", level=1, title="Intro")
+
+sec.append_paragraph("Opening paragraph.")
+sec.append_paragraph_to_last_content("Still part of the same content item.")
+
+sub = sec.new_subsection(id="sec-1-1", title="Background")
+sub.append_paragraph("Subsection text.")
+
+sec.append_paragraph_to_last_content("This now starts a new content item after the subsection.")
+```
+
+### 5) Validate before export / 导出前校验
 
 ```python
 validation = report.validate()
@@ -166,7 +207,7 @@ print(validation.to_text())
 report.assert_valid()
 ```
 
-### 4) Save JSON to disk and read it back / 落盘 JSON 再读回
+### 6) Save JSON to disk and read it back / 落盘 JSON 再读回
 
 ```python
 from pathlib import Path
@@ -185,8 +226,8 @@ print(restored.meta.title)
 `validate()` returns a structured `ValidationReport`.
 `validate()` 会返回结构化的 `ValidationReport`。
 
-Step 8 adds maintenance-friendly context in each issue, such as:
-第 8 步开始，每条 issue 会尽量附带更适合维护的上下文，例如：
+Each issue tries to include maintenance-friendly context, such as:
+每条 issue 会尽量附带更适合维护的上下文，例如：
 
 - `sectionId`
 - `sectionTitle`
@@ -209,14 +250,23 @@ print(resolver.debug_summary())
 print(resolver.resolve_xref(target_type="section", target_id="sec-1"))
 ```
 
+## Protocol-aligned authoring notes / 与协议对齐的写作说明
+
+- `Section.numbering` only accepts `"auto"`, `"none"`, or `"manual"`.
+- `strict_ids=True` is an authoring-time safety helper and is **not** serialized into the final JSON.
+- `append_*_to_last_content(...)` helpers are ergonomic helpers for preserving the protocol meaning of a continuous `content` item.
+- The recommended chart dataset structure is the protocol-native pie `slices[]` shape; `pie_chart_from_parallel_arrays(...)` is a compatibility/helper layer for older parallel-array inputs.
+
 ## Included docs / 附带文档
 
 - `docs/QUICKSTART.md`
+- `docs/API_REFERENCE.md`
 - `docs/VALIDATION_AND_RESOLVER.md`
 - `docs/TEST_MATRIX.md`
 - `docs/REAL_WORLD_RECIPES.md`
 - `docs/USER_TESTING_CHECKLIST.md`
 - `docs/PROTOCOL_ALIGNMENT.md`
+- `docs/PUBLISHING_CHECKLIST.md`
 
 ## Included examples / 附带样例
 
@@ -232,7 +282,6 @@ print(resolver.resolve_xref(target_type="section", target_id="sec-1"))
 - `examples/save_and_load_json_demo.py`
 - `examples/patent_valuation_style_report.py`
 
-
 ## Version / 版本
 
 ```python

{ovaportabletext-0.1.0 → ovaportabletext-0.1.2}/README.md

@@ -6,7 +6,10 @@ OVAPortableText 的目标不是直接渲染 PDF，而是让 Python 端**以强
 
 ## Current scope / 当前实现范围
 
-Step 9 currently includes:
+The package currently implements an intentionally selected, production-usable subset of the v1.0 protocol rather than every reserved taxonomy item.
+当前实现是 v1.0 协议里一个**可生产使用的已落地子集**，并不是把规范里所有预留 taxonomy 一次性全部实现。
+
+Implemented today:
 
 - top-level document / section skeleton
 - content body items
@@ -14,19 +17,19 @@ Step 9 currently includes:
 - protocol-approved text styles for v1
 - decorator marks + annotation `markDefs`
 - list semantics: `listItem` / `level`
-- first batch of inline objects:
+- inline objects:
   - `hard_break`
   - `xref`
   - `citation_ref`
   - `footnote_ref`
   - `glossary_term`
-- first batch of block objects:
+- block objects:
   - `image`
   - `chart`
   - `table`
   - `math_block`
   - `callout`
-- first typed registries:
+- typed registries:
   - `assets.images / logos / backgrounds / icons / attachments`
   - `datasets.tables / charts(pie) / metrics`
   - `bibliography / footnotes / glossary`
@@ -34,9 +37,16 @@ Step 9 currently includes:
 - section / figure / table / equation numbering helpers
 - global resolver / index builder
 - structured document validation report with issue context
-- detailed bilingual comments / 详细中英文双语注释
 - round-trip helpers: `from_dict()` / `from_json()` / `save_json()` / `load_json()`
 
+Not yet implemented as first-class authoring helpers:
+
+- reserved or future taxonomy items that are present in the protocol but not yet exposed as stable Python helpers
+- a full generated symbol reference for every internal class or helper
+
+This boundary is intentional: the package focuses on the pieces that are already stable enough for Python authoring and downstream renderer handoff.
+这个边界是有意为之：当前包优先把已经稳定、适合 Python 生产 JSON 和交给下游渲染器的部分做好。
+
 ## Install / 安装
 
 ### PIP
@@ -48,12 +58,13 @@ pip install OVAPortableText
 ## Quick start / 快速开始
 
 ```python
-from ova_portable_text import create_document, section
+from ova_portable_text import create_document
 
 report = create_document(
     title="Patent Valuation Report",
     language="en",
     documentType="report",
+    strict_ids=True,
 )
 
 intro = report.new_section(id="sec-1", level=1, title="Executive Summary")
@@ -62,7 +73,7 @@ intro.append_paragraph("This is the opening introduction of the chapter.")
 background = intro.new_subsection(id="sec-1-1", title="Background")
 background.append_paragraph("This is the body text of subsection 1.1.")
 
-intro.append_paragraph("This is a concluding paragraph after subsection 1.1.")
+intro.append_paragraph_to_last_content("This is a concluding paragraph after subsection 1.1.")
 
 report.assert_valid()
 print(report.to_json())
@@ -72,9 +83,10 @@ print(report.to_json())
 
 1. create one `Document`
 2. append sections and registries
-3. call `validate()` during development
-4. call `assert_valid()` before exporting or handing off to Java
-5. export with `to_dict()` / `to_json()`
+3. enable `strict_ids=True` during authoring when you want duplicate IDs to fail early
+4. call `validate()` during development
+5. call `assert_valid()` before exporting or handing off to Java
+6. export with `to_dict()` / `to_json()`
 
 ## Common authoring patterns / 常见写法
 
@@ -135,7 +147,36 @@ report.add_chart_dataset(
 )
 ```
 
-### 3) Validate before export / 导出前校验
+### 3) Fail duplicate IDs earlier when needed / 需要时尽早拦截重复 ID
+
+```python
+from ova_portable_text import create_document
+
+report = create_document(title="Strict IDs", language="en", strict_ids=True)
+report.new_section(id="sec-1", level=1, title="Intro")
+
+# Raises immediately instead of waiting until validate()
+report.new_section(id="sec-1", level=1, title="Duplicate Intro")
+```
+
+### 4) Keep a continuous content flow / 保持连续 content 语义
+
+```python
+from ova_portable_text import create_document
+
+report = create_document(title="Flow Demo", language="en")
+sec = report.new_section(id="sec-1", level=1, title="Intro")
+
+sec.append_paragraph("Opening paragraph.")
+sec.append_paragraph_to_last_content("Still part of the same content item.")
+
+sub = sec.new_subsection(id="sec-1-1", title="Background")
+sub.append_paragraph("Subsection text.")
+
+sec.append_paragraph_to_last_content("This now starts a new content item after the subsection.")
+```
+
+### 5) Validate before export / 导出前校验
 
 ```python
 validation = report.validate()
@@ -143,7 +184,7 @@ print(validation.to_text())
 report.assert_valid()
 ```
 
-### 4) Save JSON to disk and read it back / 落盘 JSON 再读回
+### 6) Save JSON to disk and read it back / 落盘 JSON 再读回
 
 ```python
 from pathlib import Path
@@ -162,8 +203,8 @@ print(restored.meta.title)
 `validate()` returns a structured `ValidationReport`.
 `validate()` 会返回结构化的 `ValidationReport`。
 
-Step 8 adds maintenance-friendly context in each issue, such as:
-第 8 步开始，每条 issue 会尽量附带更适合维护的上下文，例如：
+Each issue tries to include maintenance-friendly context, such as:
+每条 issue 会尽量附带更适合维护的上下文，例如：
 
 - `sectionId`
 - `sectionTitle`
@@ -186,14 +227,23 @@ print(resolver.debug_summary())
 print(resolver.resolve_xref(target_type="section", target_id="sec-1"))
 ```
 
+## Protocol-aligned authoring notes / 与协议对齐的写作说明
+
+- `Section.numbering` only accepts `"auto"`, `"none"`, or `"manual"`.
+- `strict_ids=True` is an authoring-time safety helper and is **not** serialized into the final JSON.
+- `append_*_to_last_content(...)` helpers are ergonomic helpers for preserving the protocol meaning of a continuous `content` item.
+- The recommended chart dataset structure is the protocol-native pie `slices[]` shape; `pie_chart_from_parallel_arrays(...)` is a compatibility/helper layer for older parallel-array inputs.
+
 ## Included docs / 附带文档
 
 - `docs/QUICKSTART.md`
+- `docs/API_REFERENCE.md`
 - `docs/VALIDATION_AND_RESOLVER.md`
 - `docs/TEST_MATRIX.md`
 - `docs/REAL_WORLD_RECIPES.md`
 - `docs/USER_TESTING_CHECKLIST.md`
 - `docs/PROTOCOL_ALIGNMENT.md`
+- `docs/PUBLISHING_CHECKLIST.md`
 
 ## Included examples / 附带样例
 
@@ -209,7 +259,6 @@ print(resolver.resolve_xref(target_type="section", target_id="sec-1"))
 - `examples/save_and_load_json_demo.py`
 - `examples/patent_valuation_style_report.py`
 
-
 ## Version / 版本
 
 ```python

ovaportabletext-0.1.2/docs/API_REFERENCE.md

@@ -0,0 +1,149 @@
+# API Reference
+
+This page is a practical API map instead of a generated full symbol dump.
+本文档是实用型 API 地图，而不是自动生成的完整符号清单。
+
+## Scope note / 范围说明
+
+This package intentionally documents the stable, author-facing subset of the protocol that is already implemented.
+本文档刻意只覆盖已经稳定、面向作者使用的那部分 API。
+
+That means:
+
+- the protocol may reserve more taxonomy items than this package currently exposes as helpers
+- internal classes may exist without being recommended as public authoring entry points
+
+## Main entry points / 主要入口
+
+- `create_document(...)`
+- `document(...)`
+- `Document.from_meta(...)`
+- `Document.from_dict(...)`
+- `Document.from_json(...)`
+
+Commonly used constructor options:
+
+- `title`
+- `language`
+- `documentType`
+- `strict_ids=False`
+
+## Core authoring objects / 核心写作对象
+
+- `Document`
+- `Section`
+- `TextBlock`
+- `Span`
+- `ImageBlock`
+- `ChartBlock`
+- `TableBlock`
+- `MathBlock`
+- `CalloutBlock`
+
+## Registries / 注册表对象
+
+- `ImageAsset`
+- `LogoAsset`
+- `BackgroundAsset`
+- `IconAsset`
+- `AttachmentAsset`
+- `TableDataset`
+- `PieChartDataset`
+- `MetricDataset`
+- `BibliographyEntry`
+- `FootnoteEntry`
+- `GlossaryEntry`
+
+## Validation / 校验
+
+- `Document.validate()`
+- `Document.assert_valid()`
+- `ValidationReport`
+- `DocumentValidationError`
+
+## Resolver / 解析器
+
+- `Document.build_resolver()`
+- `DocumentResolver.resolve_xref(...)`
+- `DocumentResolver.get_by_id(...)`
+- `DocumentResolver.get_by_anchor(...)`
+- `DocumentResolver.debug_summary()`
+
+## Numbering / 编号辅助
+
+- `Document.build_numbering()`
+- `NumberingConfig`
+- `DocumentNumbering`
+- `Section.numbering`
+- `NumberingMode = Literal["auto", "none", "manual"]`
+
+## Export / 导出
+
+- `to_dict(exclude_none=True)`
+- `to_json(indent=2, exclude_none=True)`
+- `save_json(path, indent=2, exclude_none=True)`
+- `load_json(path)`
+
+## Recommended import style / 推荐导入方式
+
+```python
+from ova_portable_text import (
+    create_document,
+    section,
+    paragraph,
+    xref,
+    citation_ref,
+)
+```
+
+## Authoring helpers / 常用 authoring helper
+
+### Document-level helpers
+
+- `Document.new_section(...)`
+- `Document.append_section(...)`
+- `Document.add_image_asset(...)`
+- `Document.add_chart_dataset(...)`
+- `Document.add_table_dataset(...)`
+- `Document.add_bibliography_entry(...)`
+- `Document.add_footnote(...)`
+- `Document.add_glossary_entry(...)`
+
+### Section-level helpers
+
+- `Section.append_paragraph(...)`
+- `Section.append_paragraphs(*paragraphs)`
+- `Section.append_lead(...)`
+- `Section.append_bullet_item(...)`
+- `Section.append_bullet_items(*items, level=1)`
+- `Section.append_number_item(...)`
+- `Section.append_number_items(*items, level=1)`
+- `Section.new_subsection(...)`
+
+### Continuous-content helpers
+
+- `Section.append_to_last_content(block)`
+- `Section.append_blocks_to_last_content(*blocks)`
+- `Section.append_text_block_to_last_content(block)`
+- `Section.append_paragraph_to_last_content(...)`
+
+Use these when you want multiple blocks to remain in the same protocol `content` item until a subsection boundary naturally starts a new one.
+当你希望多个 block 仍然属于同一个协议 `content` item 时，优先使用这些 helper；遇到 `subsection` 边界后，再自然开始新的 `content`。
+
+## Strict ID mode / 严格 ID 模式
+
+`create_document(..., strict_ids=True)` enables fail-early duplicate-ID checks for the most common authoring paths.
+`create_document(..., strict_ids=True)` 会在最常见的 authoring 路径上，把重复 ID 尽量前置到添加当下报错。
+
+Important notes:
+
+- this mode is authoring-time only
+- it does **not** serialize into final JSON
+- full validation is still available through `validate()` / `assert_valid()`
+
+## Compatibility helpers / 兼容性 helper
+
+- `pie_chart_from_parallel_arrays(...)`
+
+This helper converts older parallel-array pie inputs into the protocol-native pie `slices[]` dataset structure.
+这个 helper 会把旧的并行数组饼图输入，转换成协议原生的 pie `slices[]` 数据结构。

ovaportabletext-0.1.2/docs/PUBLISHING_CHECKLIST.md

@@ -0,0 +1,56 @@
+# Publishing Checklist
+
+## Before release / 发布前检查
+
+- [ ] confirm `pyproject.toml` package metadata
+- [ ] confirm `src/ova_portable_text/version.py` matches the release version
+- [ ] confirm root `CHANGELOG.md` exists and is updated
+- [ ] confirm `docs/dev/ova/CHANGELOG.md` is synced if you keep both copies
+- [ ] replace repository URLs if needed
+- [ ] run `pytest -q`
+- [ ] run `python -m build`
+- [ ] inspect the generated sdist and wheel filenames
+- [ ] verify root `CHANGELOG.md` is included in the sdist
+- [ ] install the built wheel in a clean virtual environment
+- [ ] verify README examples still run
+- [ ] tag the release in Git
+
+## Suggested release flow / 建议发布流程
+
+```bash
+python -m pip install --upgrade build twine
+python -m pytest -q
+python -m build
+
+# Optional: inspect the build artifacts
+ls -lh dist/
+
+tar -tf dist/ovaportabletext-*.tar.gz | grep CHANGELOG
+
+python -m venv .venv-publish-test
+source .venv-publish-test/bin/activate
+pip install dist/*.whl
+python -c "import ova_portable_text; print(ova_portable_text.__version__)"
+python -c "from ova_portable_text import create_document; print(create_document(title='Smoke', language='en').meta.title)"
+
+twine check dist/*
+twine upload --repository testpypi dist/*
+# After verifying TestPyPI, upload to the real PyPI repository.
+```
+
+## Release notes for 0.1.2 / 0.1.2 发布重点
+
+- packaging metadata and changelog layout were aligned for release
+- `Section.numbering` is now restricted to the protocol values: `auto` / `none` / `manual`
+- optional `strict_ids=True` was added to fail earlier on common duplicate-ID mistakes
+- continuous-content helpers were added to make protocol-aligned `content` authoring easier
+- docs now state more clearly that the package implements a stable subset of the v1.0 protocol
+
+## Notes / 备注
+
+- Use TestPyPI first.
+- 先发 TestPyPI，再发正式 PyPI。
+- Keep version bumps explicit and consistent.
+- 版本号变更要明确且保持一致。
+- Treat `validate()` / `assert_valid()` as the final gate even if `strict_ids=True` is enabled.
+- 即使启用了 `strict_ids=True`，`validate()` / `assert_valid()` 仍然应作为最后一道闸门。

ovaportabletext-0.1.2/docs/dev/ova/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+本项目的重要变更会记录在此文件中。
+
+## [Unreleased]
+
+## [0.1.2]
+
+### Added
+- optional `strict_ids=True` fail-early duplicate-ID checks for common authoring paths
+- continuous-content helpers on `Section`:
+  - `append_to_last_content()`
+  - `append_blocks_to_last_content()`
+  - `append_text_block_to_last_content()`
+  - `append_paragraph_to_last_content()`
+- release-facing docs now explain the implemented v1.0 protocol subset more explicitly
+
+### Changed
+- packaging and release metadata were aligned for a cleaner publication flow
+- `Section.numbering` now accepts only protocol-approved values: `auto`, `none`, and `manual`
+- publishing checklist now includes changelog layout and sdist verification guidance
+
+## [0.1.1]
+
+### Added
+- improved authoring ergonomics for local save/load and batch section writing
+- more release-prep docs and smoke-test coverage
+
+## [0.1.0]
+
+### Added
+- document / section tree builder
+- text blocks, spans, marks, markDefs, and list semantics
+- inline refs: `xref`, `citation_ref`, `footnote_ref`, `glossary_term`, `hard_break`
+- block objects: `image`, `chart`, `table`, `math_block`, `callout`
+- registries: assets, datasets, bibliography, footnotes, glossary
+- numbering helpers, resolver, validator, and round-trip helpers

{ovaportabletext-0.1.0 → ovaportabletext-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "OVAPortableText"
-version = "0.1.0"
+version = "0.1.2"
 description = "Python builder for generating OVAPortableText / Report Profile v1 JSON documents"
 readme = "README.md"
 requires-python = ">=3.10"

{ovaportabletext-0.1.0 → ovaportabletext-0.1.2}/src/ova_portable_text/__init__.py

@@ -85,7 +85,7 @@ from .registry import (
     TableDataset,
 )
 from .resolver import DocumentResolver, ResolvedTarget
-from .section import Section
+from .section import NumberingMode, Section
 from .theme import ThemeConfig
 from .validator import assert_valid_document, validate_document
 from .version import __version__