OVAPortableText 0.4.0__tar.gz → 0.6.0__tar.gz

{ovaportabletext-0.4.0 → ovaportabletext-0.6.0}/.gitignore

@@ -114,6 +114,9 @@ Thumbs.db
 # =========================
 docs/_build/
 
+# Local report design references
+/docs/startup_report_example/
+
 # =========================
 # Temporary files
 # =========================
@@ -145,3 +148,16 @@ temp/
 *.tgz
 *.bz2
 *.rar
+
+# =========================
+# Node / frontend workspace
+# =========================
+node_modules/
+**/node_modules/
+.vite/
+**/.vite/
+coverage/
+**/coverage/
+*.tsbuildinfo
+editor/.tools/
+editor/**/dist/

{ovaportabletext-0.4.0 → ovaportabletext-0.6.0}/CHANGELOG.md

@@ -2,7 +2,40 @@
 
 **All notable changes to this project will be documented in this file.**  ** **本项目的重要变更会记录在此文件中。
 
-## [Unreleased]
+## [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
+
+* froze the `report.v1.4` contract in `PROTOCOL.md` and `docs/protocol/v1.4.md`
+* defined five new chart types, shared chart semantics, and the `figure` composition block
+* added a complete generic v1.4 JSON example and a protocol freeze record
+
+### Python SDK
+
+* added timeline, stage_progress, flow, funnel and range models and authoring helpers
+* added data roles/basis, numeric domains/ticks, annotations, percent bars and doughnut center content
+* added figure composition with grid dependencies, shared figure numbering and adjacent captions
+* added strict known-chart dispatch, chart semantic diagnostics and raw-payload validation
+* report malformed chart containers and discriminators as structured validation errors instead of internal exceptions
+* preserved historical v1.3 custom chart types without implicit migration; new features require v1.4
+* changed the default schema to `report.v1.4`; explicit v1.3 authoring remains available
+* added v1.4 regression coverage, a runnable report example and migration/API guidance
+* excluded local report design materials from Git and distribution artifacts
+
+This package produces JSON; downstream rendering requires separate implementation and acceptance.
 
 ## [0.4.0] - 2026-05-14
 

{ovaportabletext-0.4.0 → ovaportabletext-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: OVAPortableText
-Version: 0.4.0
+Version: 0.6.0
 Summary: Python builder for generating OVAPortableText / Report Profile v1 JSON documents
 Author: FENG QU
 License-Expression: MIT
@@ -23,8 +23,10 @@ Description-Content-Type: text/markdown
 
 # OVAPortableText
 
-**OVAPortableText** is a Python authoring package for building JSON documents that conform to the **OVA Report Profile v1.0** protocol.  
-**OVAPortableText** 是一个 Python 端的协议生成包，用于创建符合 **OVA Report Profile v1.0** 协议的 JSON 文档。
+> Python **0.6.0** 已实现 [`report.v1.5`](PROTOCOL.md)，新增 `valuation_result` 原生估值结果横幅。支持单值/区间、币种、估值口径、投前/投后、基准日及显示倍率；默认新建 v1.5，兼容旧版本。见 [v1.5 使用指南](docs/PYTHON_V15.md) 与 [可运行示例](examples/v15_valuation_result.py)。渲染端需独立实现横幅。
+
+**OVAPortableText** is a Python authoring package for building JSON documents that conform to the **OVA Report Profile v1.5** protocol.
+**OVAPortableText** 是一个 Python 端的协议生成包，用于创建符合 **OVA Report Profile v1.5** 协议的 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，再交给下游渲染器处理。