react-native-vroom-chart 0.11.0 → 0.11.1

package/cpp/_core_include/vroom/vroom_chart.h

@@ -187,6 +187,13 @@ typedef struct VroomDrawing {
     int32_t               kind;         // 0 = line, 1 = box, 2 = pencil, 3 = path
     const VroomDrawPoint* points;       // pencil/path points (kind 2/3), else null
     int32_t               point_count;  // number of `points`, else 0
+    // Box (kind 1) interior fill, 0xAARRGGBB. Alpha 0 means unset, in which case
+    // the interior falls back to `color` at 10% alpha. Ignored by other kinds.
+    uint32_t              fill;
+    // Protects the drawing from editing: hit_test reports its body (so a host
+    // can still select it and offer to unlock) but never its handles, and no
+    // handles are drawn. Rendering is otherwise unaffected.
+    bool                  locked;
 } VroomDrawing;
 
 // A resting-liquidity band: a price interval carrying a total order size on one
@@ -257,6 +264,14 @@ typedef struct VroomCoord {
     double  price;
 } VroomCoord;
 
+// An axis-aligned rectangle in CSS pixels, relative to the chart's top-left.
+typedef struct VroomRect {
+    float x;
+    float y;
+    float width;
+    float height;
+} VroomRect;
+
 // ---- Styling keys ---------------------------------------------------------
 
 typedef enum {
@@ -578,6 +593,18 @@ bool vroom_chart_hit_test_drawing(VroomChart* chart, float x_px, float y_px,
                                   int32_t* out_index, int32_t* out_part,
                                   float* out_t);
 
+// Fills *out with the pixel bounding box of committed drawing `index` and
+// returns true; false (out untouched) for an out-of-range index, an empty
+// series, or a degenerate viewport.
+//
+// The rectangle spans the shape's painted extent — every anchor of a pencil or
+// path, both corners of a line or box — grown by half the stroke width, so it
+// covers the pixels the stroke actually paints. It is the anchor a host uses to
+// position UI against the selection, and because it is computed from live core
+// state it stays correct mid-reshape, before the edit reaches the host's array.
+bool vroom_chart_drawing_bounds(VroomChart* chart, int32_t index,
+                                VroomRect* out);
+
 // Selects a committed drawing (renders its handles). `index` -1 clears the
 // selection. `grabbed_endpoint` renders that handle 50% larger while it's being
 // dragged (0/1 for a line, 0 for the box corner the host normalized to, the

package/cpp/_core_src/chart.h

@@ -206,6 +206,8 @@ struct VroomChart {
         float                       width = 2.f;
         int32_t                     kind = 0;
         std::vector<VroomDrawPoint> points;  // pencil path (kind 2)
+        uint32_t                    fill = 0;      // 0 alpha = derive from color
+        bool                        locked = false;
     };
     std::vector<StoredDrawing> drawings;
 

package/cpp/_core_src/chart_facade.cpp

@@ -926,6 +926,8 @@ extern "C" void vroom_chart_set_drawings(VroomChart* chart,
         d.color = src.color;
         d.width = src.width;
         d.kind = src.kind;
+        d.fill = src.fill;
+        d.locked = src.locked;
         if ((src.kind == 2 || src.kind == 3) && src.points && src.point_count > 0) {
             d.points.assign(src.points, src.points + src.point_count);
             // Keep a/b mirroring the path ends so bounds/handle code is uniform.
@@ -1152,6 +1154,31 @@ extern "C" bool vroom_chart_hit_test_drawing(VroomChart* chart, float x_px,
     return true;
 }
 
+extern "C" bool vroom_chart_drawing_bounds(VroomChart* chart, int32_t index,
+                                           VroomRect* out) {
+    if (!chart || !out || chart->candles.empty()) return false;
+    const int64_t window_ms = chart->visible_end_ms - chart->visible_start_ms;
+    if (window_ms <= 0) return false;
+    const auto lay = chart->layout();
+    // Same bounds as coord_at / draw_chart so the rectangle matches the render.
+    const auto range = vroom::visible_indices(
+        chart->candles.data(), chart->candles.size(),
+        chart->visible_start_ms, chart->visible_end_ms);
+    const size_t n = range.end - range.start;
+    const auto bounds =
+        chart->price_bounds_manual
+            ? chart->price_bounds
+            : vroom::auto_price_bounds(chart->candles.data() + range.start, n);
+    vroom::drawing_bounds::RectPx r{};
+    if (!vroom::drawings::bounds_of(*chart, lay, bounds, window_ms, index, &r))
+        return false;
+    out->x = r.x;
+    out->y = r.y;
+    out->width = r.width;
+    out->height = r.height;
+    return true;
+}
+
 extern "C" bool vroom_chart_hit_test_price_line(VroomChart* chart, float x_px,
                                                 float y_px, int32_t* out_index,
                                                 int32_t* out_part) {

package/cpp/_core_src/drawing_bounds.h

@@ -0,0 +1,70 @@
+// The pixel bounding box of a drawing (see bounds_of in drawings.cpp).
+//
+// A host anchoring UI to a selected drawing needs one rectangle, whatever the
+// shape: a box and a freehand stroke both have to yield something positionable.
+// Reducing the projected anchors to their extent gives that uniformly, where the
+// anchors themselves would not — a pencil stroke's `a`/`b` are just its first
+// and last samples, which say nothing about how far the stroke wandered between
+// them.
+//
+// The extent is grown by half the stroke width on every side, because a stroke
+// straddles its path: a 2px line through y=100 paints 99..101. Without that the
+// rectangle would clip the very pixels it is meant to describe.
+//
+// Skia-free and header-only so the unit tests can cover it; see
+// tests/test_drawing_bounds.cpp.
+
+#pragma once
+
+#include <algorithm>
+#include <cmath>
+
+namespace vroom::drawing_bounds {
+
+// An axis-aligned rectangle in CSS pixels, relative to the chart's top-left.
+struct RectPx {
+    float x = 0.f;
+    float y = 0.f;
+    float width = 0.f;
+    float height = 0.f;
+};
+
+// Accumulates projected points into their extent. Points are fed one at a time
+// so callers can project straight from their own storage without materializing
+// an intermediate array.
+struct Accumulator {
+    float min_x = 0.f;
+    float min_y = 0.f;
+    float max_x = 0.f;
+    float max_y = 0.f;
+    bool  has = false;
+
+    // Non-finite coordinates are dropped rather than propagated: a single NaN
+    // would otherwise poison every comparison and hand the host an unusable
+    // rectangle.
+    void add(float x, float y) {
+        if (!std::isfinite(x) || !std::isfinite(y)) return;
+        if (!has) {
+            min_x = max_x = x;
+            min_y = max_y = y;
+            has = true;
+            return;
+        }
+        min_x = std::min(min_x, x);
+        max_x = std::max(max_x, x);
+        min_y = std::min(min_y, y);
+        max_y = std::max(max_y, y);
+    }
+
+    // The extent grown by half of `stroke_width` on each side. A single point
+    // yields a zero-extent rectangle inflated to the stroke's own footprint,
+    // which is exactly what a one-sample pencil stroke paints.
+    RectPx to_rect(float stroke_width) const {
+        if (!has) return RectPx{};
+        const float pad = std::max(stroke_width, 0.f) * 0.5f;
+        return RectPx{min_x - pad, min_y - pad, (max_x - min_x) + pad * 2.f,
+                      (max_y - min_y) + pad * 2.f};
+    }
+};
+
+}  // namespace vroom::drawing_bounds

package/cpp/_core_src/drawings.cpp

@@ -51,17 +51,23 @@ SkRect box_rect(SkPoint a, SkPoint b) {
                             std::max(a.fX, b.fX), std::max(a.fY, b.fY));
 }
 
-// Strokes the box outline and paints a faint fill (~10% of the border alpha) of
-// the same color, spanning opposite corners `a` and `b`.
-void draw_box(SkCanvas* canvas, SkPoint a, SkPoint b, SkColor color, float width) {
+// Strokes the box outline and paints its interior, spanning opposite corners
+// `a` and `b`. `fill_color` is used as given; alpha 0 means the caller didn't
+// set one, and the interior falls back to a faint tint of the border (~10% of
+// its alpha) — a solid default would hide the candles the box was drawn around.
+void draw_box(SkCanvas* canvas, SkPoint a, SkPoint b, SkColor color, float width,
+              SkColor fill_color) {
     const SkRect r = box_rect(a, b);
 
     SkPaint fill;
     fill.setAntiAlias(true);
     fill.setStyle(SkPaint::kFill_Style);
-    // Faint fill: 10% of the border's alpha, same RGB.
-    const U8CPU fill_alpha = static_cast<U8CPU>(SkColorGetA(color) * 0.1f);
-    fill.setColor(SkColorSetA(color, fill_alpha));
+    if (SkColorGetA(fill_color) != 0) {
+        fill.setColor(fill_color);
+    } else {
+        const U8CPU fill_alpha = static_cast<U8CPU>(SkColorGetA(color) * 0.1f);
+        fill.setColor(SkColorSetA(color, fill_alpha));
+    }
     canvas->drawRect(r, fill);
 
     SkPaint border;
@@ -334,7 +340,8 @@ void draw(SkCanvas* canvas,
             const SkPoint a = to_px(chart, lay, bounds, window_ms, d.a);
             const SkPoint b = to_px(chart, lay, bounds, window_ms, d.b);
             if (d.kind == 1) {
-                draw_box(canvas, a, b, static_cast<SkColor>(d.color), d.width);
+                draw_box(canvas, a, b, static_cast<SkColor>(d.color), d.width,
+                         static_cast<SkColor>(d.fill));
                 continue;
             }
             SkPaint line;
@@ -348,9 +355,12 @@ void draw(SkCanvas* canvas,
     }
 
     // 1b. Handles on the selected committed drawing (unclipped, like the draft's
-    //     dots). The grabbed endpoint renders 50% larger.
+    //     dots). The grabbed endpoint renders 50% larger. A locked drawing shows
+    //     none: nothing about it can be dragged, so an affordance saying
+    //     otherwise would be a lie.
     if (chart.selected_drawing >= 0 &&
-        static_cast<size_t>(chart.selected_drawing) < chart.drawings.size()) {
+        static_cast<size_t>(chart.selected_drawing) < chart.drawings.size() &&
+        !chart.drawings[chart.selected_drawing].locked) {
         const auto& d = chart.drawings[chart.selected_drawing];
         const SkPoint sa = to_px(chart, lay, bounds, window_ms, d.a);
         const SkPoint sb = to_px(chart, lay, bounds, window_ms, d.b);
@@ -432,8 +442,10 @@ void draw(SkCanvas* canvas,
         canvas->save();
         canvas->clipRect(clip);
         if (chart.draft_kind == 1) {
+            // The draft has no fill of its own — the preview shows the default
+            // tint until the box is committed with one.
             draw_box(canvas, a, b, static_cast<SkColor>(chart.draft_color),
-                     chart.draft_width);
+                     chart.draft_width, SK_ColorTRANSPARENT);
         } else {
             SkPaint guide;
             guide.setAntiAlias(true);
@@ -463,9 +475,13 @@ HitResult hit_test(const VroomChart& chart,
     if (window_ms <= 0 || chart.drawings.empty()) return miss;
 
     // Grab-priority: if a drawing is selected, its (visible) handles win first.
+    // A locked drawing draws no handles, so there is nothing here to grab — it
+    // falls through to the body pass and stays selectable, which is how a host
+    // toolbar can still reach it to unlock it.
     constexpr float kHandleHit = kNodeRingRadius + 6.f;
     if (chart.selected_drawing >= 0 &&
-        static_cast<size_t>(chart.selected_drawing) < chart.drawings.size()) {
+        static_cast<size_t>(chart.selected_drawing) < chart.drawings.size() &&
+        !chart.drawings[chart.selected_drawing].locked) {
         const auto& d = chart.drawings[chart.selected_drawing];
         const SkPoint a = to_px(chart, lay, bounds, window_ms, d.a);
         const SkPoint b = to_px(chart, lay, bounds, window_ms, d.b);
@@ -546,4 +562,37 @@ HitResult hit_test(const VroomChart& chart,
     return best_i >= 0 ? HitResult{best_i, best_part, best_t} : miss;
 }
 
+bool bounds_of(const VroomChart& chart,
+               const Layout& lay,
+               const PriceBounds& bounds,
+               int64_t window_ms,
+               int32_t index,
+               vroom::drawing_bounds::RectPx* out) {
+    if (!out || window_ms <= 0) return false;
+    if (index < 0 || static_cast<size_t>(index) >= chart.drawings.size())
+        return false;
+    const auto& d = chart.drawings[static_cast<size_t>(index)];
+
+    vroom::drawing_bounds::Accumulator acc;
+    if ((d.kind == 2 || d.kind == 3) && !d.points.empty()) {
+        // Pencil/path: every sample counts. `a`/`b` only mirror the first and
+        // last, so they would miss however far the stroke wandered between them.
+        for (const auto& p : d.points) {
+            const SkPoint q = to_px(chart, lay, bounds, window_ms, p);
+            acc.add(q.fX, q.fY);
+        }
+    } else {
+        // Line/box: the two stored corners already span the shape — a box's
+        // derived corners are exactly their extent.
+        const SkPoint a = to_px(chart, lay, bounds, window_ms, d.a);
+        const SkPoint b = to_px(chart, lay, bounds, window_ms, d.b);
+        acc.add(a.fX, a.fY);
+        acc.add(b.fX, b.fY);
+    }
+    if (!acc.has) return false;
+
+    *out = acc.to_rect(d.width > 0.f ? d.width : 2.f);
+    return true;
+}
+
 }  // namespace vroom::drawings

package/cpp/_core_src/drawings.h

@@ -12,6 +12,7 @@
 
 #pragma once
 
+#include "drawing_bounds.h"
 #include "viewport.h"
 #include "vroom/vroom_chart.h"
 
@@ -59,4 +60,18 @@ HitResult hit_test(const VroomChart& chart,
                    float x,
                    float y);
 
+// The pixel bounding box of committed drawing `index`, written to `out`. False
+// (leaving `out` untouched) for an out-of-range index or a degenerate viewport.
+//
+// The rectangle covers the shape's painted extent — every anchor of a pencil or
+// path, both corners of a line or box — grown by half the stroke width. It is
+// what the host positions a selection toolbar against, so it tracks the drawing
+// live through a pan, a zoom, and a reshape in progress.
+bool bounds_of(const VroomChart& chart,
+               const vroom::Layout& lay,
+               const vroom::PriceBounds& bounds,
+               int64_t window_ms,
+               int32_t index,
+               vroom::drawing_bounds::RectPx* out);
+
 }  // namespace vroom::drawings

package/lib/index.d.mts

@@ -177,6 +177,12 @@ type DrawingBase = {
     color?: VroomColor;
     /** Stroke width in px. Default 2. */
     width?: number;
+    /**
+     * Protect the drawing from editing. A locked drawing still renders and can
+     * still be selected — so a toolbar can offer to unlock it — but it can't be
+     * dragged, reshaped or deleted, and its grab handles aren't drawn. Web only.
+     */
+    locked?: boolean;
 };
 /** A two-point trendline from `points[0]` to `points[1]`. */
 type LineDrawing = DrawingBase & {
@@ -192,6 +198,15 @@ type BoxDrawing = DrawingBase & {
     type: 'box';
     /** Two opposite corners, in data space. */
     points: [DrawPoint, DrawPoint];
+    /**
+     * Interior fill, painted beneath the stroke. Omitted, the interior keeps its
+     * default tint of the stroke color at 10% alpha.
+     *
+     * A solid fill hides the candles the box was drawn around, so this usually
+     * wants an alpha — as the high byte of an 8-digit hex (`'#5400ce2c'` is a
+     * green at 33%), since vroom reads hex as `#aarrggbb`, not CSS `#rrggbbaa`.
+     */
+    fill?: VroomColor;
 };
 /**
  * A freehand pencil stroke: an open path through `points`, in order. Unlike the
@@ -224,6 +239,35 @@ type PathDrawing = DrawingBase & {
  * `'line'` and `'box'` are always exactly two points.
  */
 type Drawing = LineDrawing | BoxDrawing | PencilDrawing | PathDrawing;
+/** An axis-aligned rectangle in CSS px, relative to the chart container. */
+type DrawingRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** The currently selected drawing and where it sits on screen. */
+type DrawingSelection = {
+    /**
+     * The selected drawing. While a drag or reshape is in flight this holds the
+     * last committed geometry — the edit reaches you through `onDrawingChange`
+     * on release — whereas `rect` tracks the shape live.
+     */
+    drawing: Drawing;
+    /** The drawing's bounds in CSS px, relative to the chart container. */
+    rect: DrawingRect;
+};
+/**
+ * The subset of a drawing's appearance a host can change after the fact,
+ * through `restyle`. Fields left out are kept as they were.
+ */
+type DrawingStyle = {
+    color?: VroomColor;
+    width?: number;
+    /** Box interior fill; ignored by the other drawing types. */
+    fill?: VroomColor;
+    locked?: boolean;
+};
 /**
  * Storage adapter for **managed** drawing persistence. Provide it via the
  * `drawingStore` prop and the chart owns the drawings array itself — loading and
@@ -264,11 +308,11 @@ type UndoRedoState = {
     canRedo: boolean;
 };
 /**
- * Programmatic undo/redo controls, published through the `historyRef` prop in
- * managed mode — for toolbar buttons and other UI outside the chart. The
- * keyboard shortcuts (⌘Z / ⇧⌘Z / Ctrl+Y) work without this.
+ * Programmatic controls over the chart's drawings, published through the
+ * `historyRef` prop in managed mode — for toolbar buttons and other UI outside
+ * the chart. The keyboard shortcuts (⌘Z / ⇧⌘Z / Ctrl+Y) work without this.
  */
-type UndoRedoControls = {
+type DrawingControls = {
     /** Roll back the most recent committed drawing action. No-op when empty. */
     undo: () => void;
     /** Re-apply the most recently undone action. No-op when empty. */
@@ -279,6 +323,16 @@ type UndoRedoControls = {
      * chart for what the user perceives as a brand-new context.
      */
     clearHistory: () => void;
+    /**
+     * Restyle the drawing with this `id`, merging `patch` over its current
+     * appearance. No-op for an unknown id.
+     *
+     * In managed mode the chart owns the drawings array, so this is the only way
+     * to say "this drawing's color is now X" — the array is otherwise mutated by
+     * user gestures alone. The change records an undo step and persists like any
+     * other edit.
+     */
+    restyle: (id: string, patch: DrawingStyle) => void;
 };
 /** Price source for a moving average. */
 type MASource = 'close' | 'open' | 'high' | 'low' | 'hl2' | 'hlc3' | 'ohlc4';
@@ -749,6 +803,17 @@ type VroomChartCoreProps = {
      * drawing with this `id` from your controlled `drawings` state. Web only.
      */
     onDrawingDelete?: (id: string) => void;
+    /**
+     * Fired when the selected drawing changes, and again whenever its position on
+     * screen moves — panning, zooming, resizing, or dragging the shape itself.
+     * `null` on deselect.
+     *
+     * Anchor a floating toolbar to `selection.rect` and it will stay attached to
+     * the drawing: the rect is recomputed from live chart state once per painted
+     * frame, so it tracks 1:1 rather than settling after the gesture. Works in
+     * both controlled and managed mode. Web only.
+     */
+    onSelectionChange?: (selection: DrawingSelection | null) => void;
     /**
      * Fired when the chart wants the mode changed — e.g. it requests `'pan'` after
      * the user clicks away from a just-drawn line. Since `mode` is controlled, the
@@ -769,13 +834,13 @@ type VroomChartCoreProps = {
      */
     onHistoryChange?: (state: UndoRedoState) => void;
     /**
-     * Receives programmatic `undo`/`redo`/`clearHistory` controls in managed mode
-     * (e.g. `useRef<UndoRedoControls | null>(null)` passed here, then
+     * Receives programmatic `undo`/`redo`/`clearHistory`/`restyle` controls in
+     * managed mode (e.g. `useRef<DrawingControls | null>(null)` passed here, then
      * `historyRef.current?.undo()` from a toolbar button). Set to `null` while
      * unmounted or when no `drawingStore` is present. Web only.
      */
     historyRef?: {
-        current: UndoRedoControls | null;
+        current: DrawingControls | null;
     };
     /**
      * Fired when the user presses the undo shortcut (⌘Z / Ctrl+Z) in controlled

package/lib/index.d.ts

@@ -177,6 +177,12 @@ type DrawingBase = {
     color?: VroomColor;
     /** Stroke width in px. Default 2. */
     width?: number;
+    /**
+     * Protect the drawing from editing. A locked drawing still renders and can
+     * still be selected — so a toolbar can offer to unlock it — but it can't be
+     * dragged, reshaped or deleted, and its grab handles aren't drawn. Web only.
+     */
+    locked?: boolean;
 };
 /** A two-point trendline from `points[0]` to `points[1]`. */
 type LineDrawing = DrawingBase & {
@@ -192,6 +198,15 @@ type BoxDrawing = DrawingBase & {
     type: 'box';
     /** Two opposite corners, in data space. */
     points: [DrawPoint, DrawPoint];
+    /**
+     * Interior fill, painted beneath the stroke. Omitted, the interior keeps its
+     * default tint of the stroke color at 10% alpha.
+     *
+     * A solid fill hides the candles the box was drawn around, so this usually
+     * wants an alpha — as the high byte of an 8-digit hex (`'#5400ce2c'` is a
+     * green at 33%), since vroom reads hex as `#aarrggbb`, not CSS `#rrggbbaa`.
+     */
+    fill?: VroomColor;
 };
 /**
  * A freehand pencil stroke: an open path through `points`, in order. Unlike the
@@ -224,6 +239,35 @@ type PathDrawing = DrawingBase & {
  * `'line'` and `'box'` are always exactly two points.
  */
 type Drawing = LineDrawing | BoxDrawing | PencilDrawing | PathDrawing;
+/** An axis-aligned rectangle in CSS px, relative to the chart container. */
+type DrawingRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** The currently selected drawing and where it sits on screen. */
+type DrawingSelection = {
+    /**
+     * The selected drawing. While a drag or reshape is in flight this holds the
+     * last committed geometry — the edit reaches you through `onDrawingChange`
+     * on release — whereas `rect` tracks the shape live.
+     */
+    drawing: Drawing;
+    /** The drawing's bounds in CSS px, relative to the chart container. */
+    rect: DrawingRect;
+};
+/**
+ * The subset of a drawing's appearance a host can change after the fact,
+ * through `restyle`. Fields left out are kept as they were.
+ */
+type DrawingStyle = {
+    color?: VroomColor;
+    width?: number;
+    /** Box interior fill; ignored by the other drawing types. */
+    fill?: VroomColor;
+    locked?: boolean;
+};
 /**
  * Storage adapter for **managed** drawing persistence. Provide it via the
  * `drawingStore` prop and the chart owns the drawings array itself — loading and
@@ -264,11 +308,11 @@ type UndoRedoState = {
     canRedo: boolean;
 };
 /**
- * Programmatic undo/redo controls, published through the `historyRef` prop in
- * managed mode — for toolbar buttons and other UI outside the chart. The
- * keyboard shortcuts (⌘Z / ⇧⌘Z / Ctrl+Y) work without this.
+ * Programmatic controls over the chart's drawings, published through the
+ * `historyRef` prop in managed mode — for toolbar buttons and other UI outside
+ * the chart. The keyboard shortcuts (⌘Z / ⇧⌘Z / Ctrl+Y) work without this.
  */
-type UndoRedoControls = {
+type DrawingControls = {
     /** Roll back the most recent committed drawing action. No-op when empty. */
     undo: () => void;
     /** Re-apply the most recently undone action. No-op when empty. */
@@ -279,6 +323,16 @@ type UndoRedoControls = {
      * chart for what the user perceives as a brand-new context.
      */
     clearHistory: () => void;
+    /**
+     * Restyle the drawing with this `id`, merging `patch` over its current
+     * appearance. No-op for an unknown id.
+     *
+     * In managed mode the chart owns the drawings array, so this is the only way
+     * to say "this drawing's color is now X" — the array is otherwise mutated by
+     * user gestures alone. The change records an undo step and persists like any
+     * other edit.
+     */
+    restyle: (id: string, patch: DrawingStyle) => void;
 };
 /** Price source for a moving average. */
 type MASource = 'close' | 'open' | 'high' | 'low' | 'hl2' | 'hlc3' | 'ohlc4';
@@ -749,6 +803,17 @@ type VroomChartCoreProps = {
      * drawing with this `id` from your controlled `drawings` state. Web only.
      */
     onDrawingDelete?: (id: string) => void;
+    /**
+     * Fired when the selected drawing changes, and again whenever its position on
+     * screen moves — panning, zooming, resizing, or dragging the shape itself.
+     * `null` on deselect.
+     *
+     * Anchor a floating toolbar to `selection.rect` and it will stay attached to
+     * the drawing: the rect is recomputed from live chart state once per painted
+     * frame, so it tracks 1:1 rather than settling after the gesture. Works in
+     * both controlled and managed mode. Web only.
+     */
+    onSelectionChange?: (selection: DrawingSelection | null) => void;
     /**
      * Fired when the chart wants the mode changed — e.g. it requests `'pan'` after
      * the user clicks away from a just-drawn line. Since `mode` is controlled, the
@@ -769,13 +834,13 @@ type VroomChartCoreProps = {
      */
     onHistoryChange?: (state: UndoRedoState) => void;
     /**
-     * Receives programmatic `undo`/`redo`/`clearHistory` controls in managed mode
-     * (e.g. `useRef<UndoRedoControls | null>(null)` passed here, then
+     * Receives programmatic `undo`/`redo`/`clearHistory`/`restyle` controls in
+     * managed mode (e.g. `useRef<DrawingControls | null>(null)` passed here, then
      * `historyRef.current?.undo()` from a toolbar button). Set to `null` while
      * unmounted or when no `drawingStore` is present. Web only.
      */
     historyRef?: {
-        current: UndoRedoControls | null;
+        current: DrawingControls | null;
     };
     /**
      * Fired when the user presses the undo shortcut (⌘Z / Ctrl+Z) in controlled

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-vroom-chart",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Mobile-first Skia candlestick chart for React Native",
   "license": "MIT",
   "author": "Darion Welch",