chore: release 3.1.0

Bump the version, date the changelog and group it into Added and Changed, and
point the install snippet at 3.1.0.

Author: CtrlAltDevelop

CHANGELOG.md

@@ -1,7 +1,31 @@
-## Unreleased
+## 3.1.0 - 2026-10-06
 
 ### Added
 
+- **Sizing the panes from your code.** `KChartWidget.paneHeights` sets the
+  indicator panes' heights and `volumeHeight` the volume pane's. Heights are
+  used as given — past `ChartStyle.maxPaneHeight` if asked — and cut back only
+  when a pane would squeeze the candles out of the box. Null leaves the heights
+  to the chart, as before. While a list is given the host owns the heights: a
+  drag or a controller call is reported through `onPaneHeightsChanged`, and the
+  pane moves when the list is passed back.
+- **Maximizing a pane.** `KChartController.maximizePane`, `maximizeVolume`,
+  `restorePanes` and `toggleMaximizePane` stretch one pane over the chart, the
+  candles keeping a strip above it, for a "maximize this indicator" button. The
+  stretch follows the chart's size and its own indicator through a reorder.
+  `setPaneHeight`, `resetPaneHeights`, `paneHeights`, `maximizedPane` and
+  `isVolumeMaximized` complete the set.
+- **`KChartWidget.paneSizeMode`** chooses how the chart's parts are sized.
+  `PaneSizeMode.heights` is the default and the behaviour so far.
+  `PaneSizeMode.ratios` splits the height by `paneRatios` — the candles, the
+  volume pane, then each indicator pane, so `[3, 1, 2]` is half, a sixth and a
+  third — and holds the split as the chart is resized. `PaneSizeMode.custom`
+  lets the user lay the chart out: `KChartController.editPanes` shows a line
+  between each two parts to drag between the smallest and largest height each
+  may take, the layout is kept as proportions, and `onPaneRatiosChanged`
+  reports it for saving. `finishEditingPanes`, `toggleEditPanes` and
+  `isEditingPanes` complete the set. Both modes need a bounded height and no
+  `mBaseHeight`.
 - **`ChartStyle.gridColumnMode`** chooses where the grid's vertical lines go.
   `GridColumnMode.dateTicks` (the default, and the behaviour so far) rules a line
   wherever a candle crosses a time bucket; with only a few candles in view that
@@ -14,37 +38,18 @@
 - **`ChartStyle.gridDashPattern`** dashes the grid lines with a list of on/off
   lengths, e.g. `[4, 3]`. Null is solid; an empty list or a non-positive length
   is read as solid.
-- The example app has switches for all three, and a chip per pane that maximizes it.
-- **`KChartWidget.paneHeights`** sizes the indicator panes from the host, and
-  `KChartWidget.volumeHeight` the volume pane. Heights are used as given — past
-  `ChartStyle.maxPaneHeight` if asked — and cut back only when a pane would
-  squeeze the candles out of the box. Null leaves the heights to the chart, as
-  before. While a list is given the host owns the heights: a drag or a controller
-  call is reported through `onPaneHeightsChanged` and the pane moves when the
-  list is passed back.
-- **`KChartController.maximizePane`, `maximizeVolume`, `restorePanes`,
-  `toggleMaximizePane`,
-  `setPaneHeight`, `resetPaneHeights`, `paneHeights` and `maximizedPane`** drive
-  the same from code, for a "maximize this indicator" button. A maximized pane
-  follows the chart's size and its own indicator through a reorder.
-- **`KChartWidget.paneSizeMode`** chooses how the chart's parts are sized.
-  `PaneSizeMode.heights` is the default and the behaviour so far. `ratios` splits
-  the height by `paneRatios` — the candles, the volume pane, then each indicator
-  pane, so `[3, 1, 2]` is half, a sixth and a third — and holds the split as the
-  chart is resized. `custom` lets the user lay the chart out: `KChartController.
-  editPanes` shows a line between each two parts to drag between the smallest and
-  largest height each may take, the layout is kept as proportions, and
-  `onPaneRatiosChanged` reports it for saving. Both need a bounded height and no
-  `mBaseHeight`; the example app has a switch for them.
-- `KChartController.editPanes`, `finishEditingPanes`, `toggleEditPanes` and
-  `isEditingPanes` drive the editing; `KChartHost` has two more members for it.
+- The example app has switches for the grid options, a sizing chooser for the
+  panes, an Edit layout chip, and a chip to maximize each pane and the volume.
+
+### Changed
+
+- Dragged pane heights move with their pane when `onReorderPane` reorders the
+  indicators, instead of staying at their position.
 - `ChartStyle.minPaneHeight` is held at 32 or more when a pane is dragged or
   maximized around, so a pane can never be made so small that its edge cannot be
   grabbed to make it bigger again.
-- Dragged pane heights now move with their pane when `onReorderPane` reorders
-  the indicators, instead of staying at their position.
-- `KChartHost` has nine new members for the above; only an app that implements
-  it itself (a test double) needs to add them.
+- `KChartHost` has nine new members for the above. Only an app that implements
+  it itself, such as a test double, needs to add them.
 
 ## 3.0.0 - 2026-09-19
 

README.md

@@ -387,7 +387,7 @@ indicator and drawing tool is included; there is no paid tier.
 ```yaml
 dependencies:
   material_ui: ">=1.0.0 <2.0.0"
-  ohlcv_chart: ">=3.0.0 <4.0.0"
+  ohlcv_chart: ">=3.1.0 <4.0.0"
 ```
 
 Every widget here is built on the `material_ui` package rather than the

pubspec.yaml

@@ -3,7 +3,7 @@ description: >-
   Candlestick charts for Flutter with 31 indicators, 29 drawing tools and 39
   more chart widgets: depth, order flow, series, pie, treemap, sankey. Pure
   CustomPainter, no WebView.
-version: 3.0.0
+version: 3.1.0
 homepage: https://github.com/CtrlAltDevelop
 repository: https://github.com/CtrlAltDevelop/ohlcv_chart
 issue_tracker: https://github.com/CtrlAltDevelop/ohlcv_chart/issues