OVAPortableText 0.3.0__tar.gz → 0.5.0__tar.gz

{ovaportabletext-0.3.0 → ovaportabletext-0.5.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.3.0 → ovaportabletext-0.5.0}/CHANGELOG.md

@@ -2,7 +2,50 @@
 
 **All notable changes to this project will be documented in this file.**  ** **本项目的重要变更会记录在此文件中。
 
-## [Unreleased]
+## [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
+
+### Added
+
+* aligned the package with `report.v1.3`
+* added typed chart models for `bar`, `line`, and `matrix_bubble` datasets
+* added shared `ChartAxis`, `ChartCategory`, `MatrixBubbleCategory`, and `SizeMetric` models
+* added chart helper functions for bar, horizontal bar, line, and matrix bubble datasets
+* added validation coverage for v1.3 chart category references, series keys, and matrix bubble size values
+* added tests covering v1.3 schema defaults, `pie.slices[].colorHint`, bar variants, line points, and matrix bubble output
+
+### Changed
+
+* default `schemaVersion` is now `report.v1.3`
+* package metadata and public version now reflect `v0.4.0` / `report.v1.3`
+* `datasets.charts` now has first-class Python models for all v1.3 formal chart types while keeping the generic chart fallback
+
+### Fixed
+
+* preserved `pie.slices[].colorHint` while avoiding new visual-style fields for v1.3 chart types
+* normalized legacy `sizeMetric.valueUnit` input to `sizeMetric.unit` without emitting `valueUnit` in new matrix-bubble output
+* avoided any `chartType = "bubble"` helper for v1.3; classification bubble charts now use `chartType = "matrix_bubble"`
 
 ## [0.3.0] - 2026-04-08
 

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: OVAPortableText
-Version: 0.3.0
+Version: 0.5.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.5.0** 已实现 [`report.v1.4`](PROTOCOL.md) 的生成、读取和校验，默认新建 v1.4 文档并兼容读取 v1.3。新增五种图表、共享图表语义和组合 `figure`。见 [新版使用指南](docs/PYTHON_V14.md) 与 [完整 Python 示例](examples/v14_report.py)。渲染效果由下游渲染器独立验收。
+
+**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 文档。
 
 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，再交给下游渲染器处理。