OVAPortableText 0.5.0__tar.gz → 0.7.0__tar.gz

{ovaportabletext-0.5.0 → ovaportabletext-0.7.0}/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 **All notable changes to this project will be documented in this file.**  ** **本项目的重要变更会记录在此文件中。
 
+## [0.7.0] - 2026-10-13
+
+### SDK
+
+* added opt-in report.v1.6 page, object pagination, table/header alignment and explicit caption models and helpers
+* added version boundaries, mutable-model validation, local caption resolution and two-sided group authoring while keeping report.v1.5 as the default
+* preserved historical theme extensions and legacy caption helpers; added SDK tests, a runnable example and a renderer handoff checklist
+* froze the protocol and Python SDK for release; renderer testing is unavailable and explicitly deferred, with no renderer compatibility claim
+
+### Protocol
+
+* designed `report.v1.6` pagination, page orientation scopes, table alignment inheritance, and explicit caption binding/placement
+* refined only the new v1.6 contract: independent object before/after pagination, header alignment defaults, two-sided explicit captions, and deferred positional record cell overrides; existing v1.5 behavior and required column widths remain unchanged
+* updated the main protocol and added the complete v1.6 protocol, JSON example, validation requirements, and renderer acceptance matrix
+* retained Python 0.6.0 / report.v1.5 runtime defaults and frozen protocol archives; v1.6 renderer and editor acceptance remain pending
+
+## [0.6.0] - 2026-09-27
+
+### Protocol and Python SDK
+
+* froze `report.v1.5` with native `valuation_result` banners for point and range estimates
+* added typed valuation amounts, currency base-unit semantics, display scale/precision, valuation/capital basis, date and sample-data classification
+* added strict helpers, known-type dispatch, full-document diagnostics, reference/grid support and JSON round trips
+* default new documents to v1.5 while preserving explicit v1.4 and older documents without implicit migration
+* preserve historical custom `valuation_result` payloads under their original schema; require explicit conversion before upgrading
+* added a runnable example, a protocol fixture, a renderer contract and migration guidance
+
+The package creates JSON. The downstream renderer must implement the valuation banner; no silent fallback is provided.
+
 ## [0.5.0] - 2026-09-21
 
 ### Protocol

{ovaportabletext-0.5.0 → ovaportabletext-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: OVAPortableText
-Version: 0.5.0
+Version: 0.7.0
 Summary: Python builder for generating OVAPortableText / Report Profile v1 JSON documents
 Author: FENG QU
 License-Expression: MIT
@@ -23,10 +23,10 @@ Description-Content-Type: text/markdown
 
 # OVAPortableText
 
-> Python **0.5.0** 已实现 [`report.v1.4`](PROTOCOL.md) 的生成、读取和校验，默认新建 v1.4 文档并兼容读取 v1.3。新增五种图表、共享图表语义和组合 `figure`。见 [新版使用指南](docs/PYTHON_V14.md) 与 [完整 Python 示例](examples/v14_report.py)。渲染效果由下游渲染器独立验收。
+> Python **0.7.0** 已实现 [`report.v1.6`](PROTOCOL.md)：对象前后分页、页面方向、表格/表头对齐及显式 caption 前后组。默认仍创建 v1.5，新能力显式启用 v1.6。见 [使用指南](docs/PYTHON_V16.md)、[JSON 示例](docs/protocol/v1.6-example.json)和[冻结记录](docs/protocol/v1.6-freeze.md)。本次冻结覆盖协议与 SDK；渲染器当前无法测试，渲染验收延期。
 
-**OVAPortableText** is a Python authoring package for building JSON documents that conform to the **OVA Report Profile v1.4** protocol.
-**OVAPortableText** 是一个 Python 端的协议生成包，用于创建符合 **OVA Report Profile v1.4** 协议的 JSON 文档。
+**OVAPortableText** is a Python authoring package for building JSON documents that conform to the **OVA Report Profile v1.6** protocol.
+**OVAPortableText** 是一个 Python 端的协议生成包，用于创建符合 **OVA Report Profile v1.6** 协议的 JSON 文档。
 
 It is **not** a PDF renderer. Its job is to help Python code produce a typed, validated, protocol-aligned document payload that can be handed off to a downstream renderer.  
 它**不是** PDF 渲染器。它的职责是帮助 Python 代码以强类型、可校验、可维护的方式生成协议 JSON，再交给下游渲染器处理。
@@ -73,8 +73,8 @@ The package ends at **structured JSON generation + validation + debugging suppor
 
 ## 3. Current protocol scope implemented by the package / 当前包已实现的协议范围
 
-This package intentionally implements the **stable, author-facing subset** of Report Profile v1.0.  
-当前包刻意只实现了 Report Profile v1.0 中**已经稳定、适合作者侧使用的那部分能力**。
+This package implements the authoring and validation contracts through Report Profile v1.6; new documents default to v1.5 for compatibility.
+当前包实现到 Report Profile v1.6 的构建与校验合同；为保持兼容，新文档默认 v1.5。以下为基础能力概览，新增能力见 v1.6 使用指南。
 
 Currently implemented / 当前已实现：
 
@@ -430,11 +430,11 @@ twine check dist/*
 
 ### 11.3 Release note / 发布说明
 
-The current package version is **0.1.3**.  
-当前包版本为 **0.1.3**。
+The current package version is **0.7.0**.
+当前包版本为 **0.7.0**。
 
-This branch of the package is aligned to the current Report Profile v1.0 protocol draft used in this repository.  
-当前这版包对齐的是本仓库内维护的 Report Profile v1.0 协议版本。
+This release supports the frozen Report Profile v1.6 protocol; renderer acceptance remains separate.
+当前版本支持本仓库冻结的 Report Profile v1.6 协议；渲染器验收独立进行。
 
 ---