hyperprop-charting-library 0.1.129 → 0.1.131

package/docs/API.md

@@ -392,7 +392,13 @@ Built-in:
 - `"bollinger"`: Bollinger Bands (overlay)
 - `"macd"`: MACD with signal line and zero-anchored histogram (separate pane; inputs `fast`, `slow`, `signal`, colors)
 
-All separate-pane indicators (`macd`, `stochastic`, `stochrsi`, `adx`, `obv`, `mfi`, `cci`, `williamsr`, `roc`, `momentum`, `rsi`, `atr`, `stddev`) also accept `showValueLine: boolean` (default `false`): draws a dotted horizontal line across the pane at each line's latest value, ticker-line style, matching the value tag on the right scale. Toggle it per instance, e.g. `chart.updateIndicator(id, { inputs: { showValueLine: true } })`.
+All separate-pane indicators (`macd`, `stochastic`, `stochrsi`, `adx`, `obv`, `mfi`, `cci`, `williamsr`, `roc`, `momentum`, `rsi`, `atr`, `stddev`) also accept `showValueLine: boolean` (default `true`): draws a dotted horizontal line across the pane at each line's latest value, ticker-line style, matching the value tag on the right scale. Toggle it per instance, e.g. `chart.updateIndicator(id, { inputs: { showValueLine: false } })`.
+
+Separate panes also get, automatically:
+
+- The main chart's grid: vertical time gridlines run through every pane, and each pane draws horizontal gridlines on round values using the same `grid` color/opacity options.
+- Draggable dividers: the border above each pane resizes it (cursor turns to a row-resize handle). Hosts can persist the new height via `onIndicatorPaneHeightChange`.
+- TradingView-style legend controls on hover: eye (hide/show), gear (settings), `{}` (view source), and X (remove). The eye toggles visibility internally — a hidden indicator collapses to a small legend strip instead of disappearing, so it can be un-hidden in place. Gear/source/remove emit `onIndicatorPaneAction` events for the host UI; if no handler is registered, X removes the indicator directly.
 - `"stochastic"`: Stochastic %K/%D with 20/80 guides (separate pane; inputs `kLength`, `kSmoothing`, `dLength`)
 - `"stochrsi"`: Stochastic RSI %K/%D (separate pane; inputs `rsiLength`, `stochLength`, `kSmoothing`, `dSmoothing`)
 - `"adx"`: ADX with optional +DI/-DI lines, Wilder smoothing (separate pane; inputs `length`, `showDi`)
@@ -499,6 +505,8 @@ Use `getDrawings()` / `setDrawings()` for persistence.
 - `onChartClick(handler: ((event: ChartClickEvent) => void) | null): void`
 - `onCrosshairMove(handler: ((event: CrosshairMoveEvent) => void) | null): void`
 - `onCrosshairPriceAction(handler: ((event: CrosshairPriceActionEvent) => void) | null): void`
+- `onIndicatorPaneAction(handler: ((event: IndicatorPaneActionEvent) => void) | null): void` — pane-legend hover buttons. Event: `{ id, type, action: "settings" | "remove" | "source" | "visibility", visible? }`. Open your settings dialog on `"settings"`, a code/definition view on `"source"`, and remove the indicator from your own state on `"remove"`; `"visibility"` is informational (the chart already toggled it).
+- `onIndicatorPaneHeightChange(handler: ((event: IndicatorPaneHeightChangeEvent) => void) | null): void` — pane divider drag-resize. Event: `{ id, paneHeightRatio, dragging }`; persist the ratio when `dragging === false`.
 - `zoomInX(factor?: number): void` (default factor `1.25`)
 - `zoomOutX(factor?: number): void` (default factor `1.25`)
 - `zoomInY(factor?: number): void` (default factor `1.25`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperprop-charting-library",
-  "version": "0.1.129",
+  "version": "0.1.131",
   "description": "Lightweight TypeScript charting core",
   "type": "module",
   "main": "./dist/hyperprop-charting-library.cjs",