Update 2.0.0 docs, migration, and usage guide

Author: AppPear

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## 2.0.0-beta.9
+## 2.0.0
 
 ### Added
 
@@ -10,8 +10,13 @@
   - `chartXAxisLabels`, `chartYAxisLabels`, `chartAxisFont`, `chartAxisColor`
   - `chartLineWidth`, `chartLineBackground`, `chartLineMarks`, `chartLineStyle`, `chartLineAnimation`
   - `chartInteractionValue`
+  - `chartSelectionHandler`
+  - `chartPerformance`
 - Immutable chart configuration structs and environment-key-based composition.
 - Updated docs/examples and generated showcase app.
+- Dynamic streaming data source support via `ChartStreamingDataSource`.
+- Unified X-axis alignment strategy shared across chart layers.
+- Apple privacy manifest for SDK distribution (`PrivacyInfo.xcprivacy`).
 
 ### Changed
 

MIGRATION.md

@@ -1,5 +1,11 @@
 # SwiftUICharts Migration Guide
 
+## Target release
+
+This guide targets `2.0.0`.
+
+`2.0.0` is a major breaking release and phases out the old mutable chain API in favor of composable modifier-based configuration.
+
 ## Version direction
 
 This release moves to a strict SwiftUI-idiomatic modifier API.
@@ -8,6 +14,16 @@ This release moves to a strict SwiftUI-idiomatic modifier API.
 - `ViewModifier` composition
 - Environment keys instead of mutable reference state in view structs
 
+## Migration checklist
+
+1. Replace legacy chart types with `LineChart`, `BarChart`, `PieChart`, `RingsChart`.
+2. Replace old chain methods with `chart...` modifiers.
+3. Migrate interaction:
+   - shared value model: `chartInteractionValue(_:)`
+   - callback model: `chartSelectionHandler(_:)`
+4. Validate axis label/range behavior under the unified X-axis alignment model.
+5. Run `swift test` and build the showcase app to verify rendering parity.
+
 ## Old -> new mapping
 
 ### Previous chart data/range chains
@@ -54,6 +70,7 @@ This release moves to a strict SwiftUI-idiomatic modifier API.
 | --- | --- |
 | `.chartValue(...)` on chart views | `.chartInteractionValue(...)` on any parent container |
 | `@EnvironmentObject ChartValue` requirement | optional environment interaction value |
+| N/A | `.chartSelectionHandler { event in ... }` callback-based selection |
 
 ### Legacy public type replacements
 
@@ -109,3 +126,25 @@ AxisLabels {
 }
 .chartXAxisLabels(["Q1", "Q2", "Q3", "Q4"])
 ```
+
+## Advanced migration examples
+
+### Dynamic streaming data
+
+```swift
+@ObservedObject private var stream = ChartStreamingDataSource(initialValues: [12, 14, 18, 16],
+                                                              windowSize: 8,
+                                                              autoScroll: true)
+
+LineChart()
+    .chartData(stream)
+    .chartYRange(stream.suggestedYRange)
+```
+
+### Performance mode for large datasets
+
+```swift
+LineChart()
+    .chartData(largeSeries)
+    .chartPerformance(.automatic(threshold: 600, maxPoints: 180, simplifyLineStyle: true))
+```

README.md

@@ -4,6 +4,18 @@ SwiftUICharts is an open-source chart library for SwiftUI with iOS 13 compatibil
 
 This release uses a fully composable, SwiftUI-idiomatic API based on immutable configuration and `ViewModifier` chains.
 
+## 2.0.0 Release
+
+Version `2.0.0` is the new major composable release.
+
+- New modifier-first API (`chartData`, `chartXRange`, `chartYRange`, `chartGridLines`, axis modifiers, line modifiers)
+- Shared X-axis alignment model across chart types
+- Optional interaction model (`chartInteractionValue`) and callback model (`chartSelectionHandler`)
+- Streaming data support (`ChartStreamingDataSource`)
+- Performance mode (`chartPerformance`)
+- Accessibility + high-contrast presets
+- Apple privacy manifest included for SDK distribution (`PrivacyInfo.xcprivacy`)
+
 <p align="center">
 <img src="Resources/linevid2.gif" width="30%"/> <img src="Resources/barvid2.gif" width="30%"/> <img src="Resources/pievid2.gif" width="30%"/>
 </p>
@@ -21,13 +33,34 @@ Use Swift Package Manager in Xcode and add:
 
 `https://github.com/AppPear/ChartView`
 
+For `2.0.0`, depend on the `2.0.0` tag or from `2.0.0` up to next major.
+
 ## Migration
 
 This is a major composable API release.
 
 - Previous chain APIs like `.data`, `.rangeX`, `.rangeY`, `.setAxisXLabels`, `.setNumberOfHorizontalLines`, and line-specific setters were replaced by typed chart modifiers.
 - Full old-to-new mapping: [MIGRATION.md](./MIGRATION.md)
 
+## Migration In 3 Steps
+
+1. Replace legacy view types (`LineChartView`, `BarChartView`, `PieChartView`, `MultiLineChartView`) with composable chart views.
+2. Replace old chain methods with new modifiers.
+3. Move interaction to container-level wiring:
+   - shared state: `.chartInteractionValue(ChartValue())`
+   - callback-driven: `.chartSelectionHandler { event in ... }`
+
+### Common replacements
+
+| Old | New |
+| --- | --- |
+| `.data([Double])` | `.chartData([Double])` |
+| `.rangeX(...)` | `.chartXRange(...)` |
+| `.rangeY(...)` | `.chartYRange(...)` |
+| `.setNumberOfHorizontalLines(h)` | `.chartGridLines(horizontal: h, vertical: ...)` |
+| `.setAxisXLabels(...)` | `.chartXAxisLabels(...)` |
+| `.showChartMarks(...)` | `.chartLineMarks(...)` |
+
 ## Quick Start
 
 **Simple line chart**
@@ -122,3 +155,8 @@ AxisLabels {
 ## Full Examples
 
 See [example.md](./example.md) and [`Examples/SwiftUIChartsShowcase`](./Examples/SwiftUIChartsShowcase) for complete showcase code.
+
+## Release Notes
+
+- Changelog: [CHANGELOG.md](./CHANGELOG.md)
+- Migration details: [MIGRATION.md](./MIGRATION.md)

example.md

@@ -2,6 +2,13 @@
 
 ### Example codes (modifier-based composable API)
 
+## Notes for 2.0.0 usage
+
+- Use modifier APIs only (`chartData`, `chartXRange`, `chartYRange`, `chartGridLines`, `chartXAxisLabels`, etc.).
+- Use `chartInteractionValue(_:)` when you want shared interaction state.
+- Use `chartSelectionHandler(_:)` when you prefer callback-based interaction events.
+- Use `ChartStreamingDataSource` for dynamic feeds and `chartPerformance(_:)` for large datasets.
+
 <p align="left">
 <img src="Resources/linechartcard.png" width="400px"/>
 </p>