react-native-vroom-chart 0.13.0 → 0.14.0

package/src/VroomChart.tsx

@@ -1,18 +1,31 @@
 // VroomChart — Phase 3.
 //
-// Owns a SharedValue<SkPicture> driven by:
-//   - useChartCore's "initial" picture (when data/size/range change), AND
-//   - Pan gesture callbacks that call handle.pan(dx, dy) → fresh picture.
+// Owns SharedValues driven by:
+//   - useChartCore's "initial" frame (when data/size/range change), AND
+//   - Pan gesture callbacks that call handle.pan(dx, dy) → a fresh frame.
 //
-// Reanimated 4 + RN-Skia 2 propagate SharedValue<SkPicture> changes to
-// <Picture> without a React re-render, so gesture-driven redraws are cheap.
+// iOS wraps an SkPicture in-process. Android rasterizes to an SkImage (the
+// two Skia copies can't share a picture pointer) so pan/zoom don't serialize
+// the scene — and the system typeface — on every frame.
+//
+// Reanimated 4 + RN-Skia 2 propagate SharedValue changes to <Picture>/<Image>
+// without a React re-render, so gesture-driven redraws are cheap.
 //
 // Gestures run on the JS thread for now (`runOnJS(true)`) — installing the
 // JSI bindings on the worklet runtime is a later perf optimization.
 
 import React, { useEffect, useRef, useCallback, useState, useMemo } from 'react';
-import { View, type LayoutChangeEvent } from 'react-native';
-import { Canvas, Picture, Skia, type SkPicture } from '@shopify/react-native-skia';
+import { PixelRatio, View, type LayoutChangeEvent } from 'react-native';
+import {
+  AlphaType,
+  Canvas,
+  ColorType,
+  Image,
+  Picture,
+  Skia,
+  type SkImage,
+  type SkPicture,
+} from '@shopify/react-native-skia';
 import {
   Gesture,
   GestureDetector,
@@ -22,9 +35,14 @@ import { useReducedMotion, useSharedValue } from 'react-native-reanimated';
 
 import { useChartCore } from './useChartCore';
 import { ease, easingIndex } from './easing';
+import type { ChartFrame } from './jsi.d';
 import type { VroomChartProps } from './types';
 import './jsi.d';
 
+function isSkImage(frame: ChartFrame): frame is SkImage {
+  return typeof (frame as SkImage).getImageInfo === 'function';
+}
+
 /**
  * Skia-rendered candlestick chart. Pass OHLCV `candles` and size it via `style`
  * (it fills its parent by default). Pan to scroll, pinch to zoom, drag the
@@ -46,6 +64,7 @@ export function VroomChart(props: VroomChartProps) {
     chartType,
     transitionMs,
     transitionEasing,
+    intervalTransition,
     theme,
     rsi,
     macd,
@@ -92,16 +111,39 @@ export function VroomChart(props: VroomChartProps) {
     [priceLines, priceLinesStyle, onPriceLineClose],
   );
 
-  // RN-Skia's recorder reads this SharedValue on the UI/render runtime, a beat
-  // behind JS-thread writes. If it ever reads null it throws ("Invalid prop
-  // value for SkTextBlob received" — RN-Skia's mislabeled SkPicture error), so
-  // we seed it with an empty picture and *never* assign null into it.
+  // RN-Skia's recorder reads these SharedValues on the UI/render runtime, a
+  // beat behind JS-thread writes. If it ever reads null it throws ("Invalid
+  // prop value for SkTextBlob received" — RN-Skia's mislabeled SkPicture
+  // error), so we seed them and *never* assign null. Android writes the image
+  // SV (raster path); iOS writes the picture SV. The unused layer stays a
+  // transparent 1×1 so it doesn't cover the other.
   const emptyPicture = useMemo(() => {
     const rec = Skia.PictureRecorder();
     rec.beginRecording(Skia.XYWHRect(0, 0, 1, 1));
     return rec.finishRecordingAsPicture();
   }, []);
+  const emptyImage = useMemo(() => {
+    const data = Skia.Data.fromBytes(new Uint8Array(4));
+    return Skia.Image.MakeImage(
+      {
+        width: 1,
+        height: 1,
+        colorType: ColorType.RGBA_8888,
+        alphaType: AlphaType.Premul,
+      },
+      data,
+      4,
+    )!;
+  }, []);
   const pictureSV = useSharedValue<SkPicture>(emptyPicture);
+  const imageSV = useSharedValue<SkImage>(emptyImage);
+  const applyFrame = useCallback(
+    (frame: ChartFrame) => {
+      if (isSkImage(frame)) imageSV.value = frame;
+      else pictureSV.value = frame;
+    },
+    [imageSV, pictureSV],
+  );
 
   // An OS reduced-motion preference snaps every transition, the way
   // prefers-reduced-motion does on web.
@@ -111,15 +153,15 @@ export function VroomChart(props: VroomChartProps) {
   // capture) but repaints every frame, so it writes straight into the SV rather
   // than through React state — the same bypass the gesture handlers use.
   const onFrame = useCallback(
-    (p: SkPicture) => {
-      pictureSV.value = p;
+    (p: ChartFrame) => {
+      applyFrame(p);
     },
-    [pictureSV],
+    [applyFrame],
   );
 
   const { handle, picture, volumeCollapseRef } = useChartCore(
     candles,
-    { width, height },
+    { width, height, pxRatio: PixelRatio.get() },
     visibleRange,
     defaultCandleWidth,
     chartType,
@@ -131,7 +173,7 @@ export function VroomChart(props: VroomChartProps) {
     bollingerBands,
     volume,
     priceLinesProp,
-    { seriesKey, transitionMs, transitionEasing, reduceMotion, onFrame },
+    { seriesKey, transitionMs, transitionEasing, intervalTransition, reduceMotion, onFrame },
   );
 
   // When the crosshair is showing, pan moves it (instead of scrolling) and
@@ -166,11 +208,11 @@ export function VroomChart(props: VroomChartProps) {
     animRaf.current = null;
     if (!handle) return;
     const next = handle.render();
-    if (next) pictureSV.value = next;
+    if (next) applyFrame(next);
     if (handle.isAnimating()) {
       animRaf.current = requestAnimationFrame(animTick);
     }
-  }, [handle, pictureSV]);
+  }, [handle, applyFrame]);
   const maybeStartAnim = useCallback(() => {
     if (animRaf.current != null) return;
     if (!handle?.isAnimating()) return;
@@ -194,9 +236,9 @@ export function VroomChart(props: VroomChartProps) {
   // pulse on needs — otherwise the ring wouldn't move until you touched the
   // chart.
   useEffect(() => {
-    if (picture) pictureSV.value = picture;
+    if (picture) applyFrame(picture);
     maybeStartAnim();
-  }, [picture, pictureSV, maybeStartAnim]);
+  }, [picture, applyFrame, maybeStartAnim]);
 
   // Candle↔line morph. When `chartType` changes we drive the core per-frame with
   // a (collapse, fade) blend and push a fresh picture into the SV each frame — the
@@ -225,7 +267,7 @@ export function VroomChart(props: VroomChartProps) {
       morphFade.current = target;
       handle.setChartType(target);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       maybeStartAnim();
       return undefined;
     }
@@ -243,7 +285,7 @@ export function VroomChart(props: VroomChartProps) {
       morphFade.current = target;
       handle.setChartType(target);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       maybeStartAnim();
       return undefined;
     }
@@ -258,7 +300,7 @@ export function VroomChart(props: VroomChartProps) {
       // Reduced motion still crossfades, but skips the vertical collapse.
       handle.setMorph(reduceMotion ? 0 : fade, fade);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       if (prog < 1) {
         morphRaf.current = requestAnimationFrame(step);
       } else {
@@ -266,7 +308,7 @@ export function VroomChart(props: VroomChartProps) {
         morphFade.current = target;
         handle.setChartType(target); // lock the exact endpoint
         const q = handle.render();
-        if (q) pictureSV.value = q;
+        if (q) applyFrame(q);
         maybeStartAnim();
       }
     };
@@ -279,9 +321,9 @@ export function VroomChart(props: VroomChartProps) {
       }
     };
     // maybeStartAnim is memoized on [handle, animTick] and animTick on
-    // [handle, pictureSV], both already deps here — so it adds no new restarts
+    // [handle, applyFrame], both already deps here — so it adds no new restarts
     // of this clock.
-  }, [handle, chartType, transitionMs, reduceMotion, pictureSV, maybeStartAnim]);
+  }, [handle, chartType, transitionMs, reduceMotion, applyFrame, maybeStartAnim]);
 
   // Volume-bar collapse. The core staggers the bars itself — tallest falling
   // first, all landing together — so unlike the loop above this one hands it
@@ -321,7 +363,7 @@ export function VroomChart(props: VroomChartProps) {
       volumeCollapseRef.current = { t: target, easing };
       handle.setVolumeCollapse(target, easing);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       maybeStartAnim();
       return undefined;
     }
@@ -338,7 +380,7 @@ export function VroomChart(props: VroomChartProps) {
       volumeCollapseRef.current = { t, easing: kind };
       handle.setVolumeCollapse(t, kind);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       if (prog < 1) {
         volumeRaf.current = requestAnimationFrame(step);
       } else {
@@ -359,7 +401,7 @@ export function VroomChart(props: VroomChartProps) {
     volume?.enabled,
     transitionMs,
     reduceMotion,
-    pictureSV,
+    applyFrame,
     volumeCollapseRef,
     maybeStartAnim,
   ]);
@@ -386,7 +428,7 @@ export function VroomChart(props: VroomChartProps) {
       axisCollapse.current = { y: targetY, x: targetX };
       handle.setAxisCollapse(targetY, targetX);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       maybeStartAnim();
       return undefined;
     }
@@ -408,7 +450,7 @@ export function VroomChart(props: VroomChartProps) {
       axisCollapse.current = { y: targetY, x: targetX };
       handle.setAxisCollapse(targetY, targetX);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       maybeStartAnim();
       return undefined;
     }
@@ -425,7 +467,7 @@ export function VroomChart(props: VroomChartProps) {
       axisCollapse.current = { y, x };
       handle.setAxisCollapse(y, x);
       const p = handle.render();
-      if (p) pictureSV.value = p;
+      if (p) applyFrame(p);
       if (prog < 1) {
         axisRaf.current = requestAnimationFrame(step);
       } else {
@@ -447,7 +489,7 @@ export function VroomChart(props: VroomChartProps) {
     showXAxis,
     transitionMs,
     reduceMotion,
-    pictureSV,
+    applyFrame,
     maybeStartAnim,
   ]);
 
@@ -516,7 +558,7 @@ export function VroomChart(props: VroomChartProps) {
           priceDrag.current = { index: pl.index, id: pl.line.id, price: pl.line.price };
           handle.setPriceLineDrag(pl.index, pl.line.price);
           const p = handle.render();
-          if (p) pictureSV.value = p;
+          if (p) applyFrame(p);
         }
       }
     })
@@ -546,7 +588,7 @@ export function VroomChart(props: VroomChartProps) {
         // scrolling. Vertical line tracks the finger x; the dot/horizontal line
         // stay lifted `crosshairOffset` px above the fingertip.
         const ch = handle.setCrosshair(e.x, e.y - crosshairOffset);
-        if (ch) pictureSV.value = ch;
+        if (ch) applyFrame(ch);
         // The line follows the finger every frame (above), but only notify the
         // host when the snapped slot actually changes. The slot has a timeMs
         // even in the empty space ahead of the last candle, where candle=null.
@@ -564,7 +606,7 @@ export function VroomChart(props: VroomChartProps) {
         // (axes follow). Diagonal works naturally.
         next = handle.translate(e.changeX, e.changeY);
       }
-      if (next) pictureSV.value = next;
+      if (next) applyFrame(next);
       maybeStartAnim();
     })
     .onEnd((e) => {
@@ -577,7 +619,7 @@ export function VroomChart(props: VroomChartProps) {
         priceDrag.current = null;
         handle.setPriceLineDrag(-1, 0);
         const p = handle.render();
-        if (p) pictureSV.value = p;
+        if (p) applyFrame(p);
         if (g) onPriceLineDragEnd?.(g.id, g.price);
         return;
       }
@@ -606,7 +648,7 @@ export function VroomChart(props: VroomChartProps) {
         velocity *= Math.pow(0.5, dt / HALF_LIFE_S);
         const dx = velocity * dt;
         const next = handle.pan(dx, 0);
-        if (next) pictureSV.value = next;
+        if (next) applyFrame(next);
         maybeStartAnim();
 
         if (Math.abs(velocity) > MIN_STOP) {
@@ -680,7 +722,7 @@ export function VroomChart(props: VroomChartProps) {
       if (frameX === 1 && frameY === 1) return;
 
       const next = handle.zoom(frameX, frameY, focalX, focalY);
-      if (next) pictureSV.value = next;
+      if (next) applyFrame(next);
       maybeStartAnim();
     });
 
@@ -699,7 +741,7 @@ export function VroomChart(props: VroomChartProps) {
       cancelDecay();
       crosshairActive.current = true;
       const ch = handle.setCrosshair(e.x, e.y - crosshairOffset);
-      if (ch) pictureSV.value = ch;
+      if (ch) applyFrame(ch);
       const info = handle.getCrosshairInfo();
       lastCrosshairTime.current = info?.timeMs ?? null;
       onCrosshair?.({
@@ -729,7 +771,7 @@ export function VroomChart(props: VroomChartProps) {
       if (hitAxis(e.x, e.y) !== 'chart') return;
       crosshairActive.current = false;
       const ch = handle.clearCrosshair();
-      if (ch) pictureSV.value = ch;
+      if (ch) applyFrame(ch);
       lastCrosshairTime.current = null;
       onCrosshair?.({ active: false, candle: null, timeMs: null, price: null, reason: 'hide' });
     });
@@ -749,9 +791,17 @@ export function VroomChart(props: VroomChartProps) {
         <View style={{ flex: 1 }}>
           <Canvas style={{ flex: 1 }}>
             {width > 0 && height > 0 ? (
-              // pictureSV is always a valid picture (seeded empty, never null),
-              // so RN-Skia's UI-thread reader never sees null.
-              <Picture picture={pictureSV} />
+              <>
+                <Picture picture={pictureSV} />
+                <Image
+                  image={imageSV}
+                  x={0}
+                  y={0}
+                  width={width}
+                  height={height}
+                  fit="fill"
+                />
+              </>
             ) : null}
           </Canvas>
         </View>

package/src/index.ts

@@ -22,6 +22,8 @@ export type {
   VolumeConfig,
   ChartType,
   TransitionEasing,
+  IntervalTransition,
   PriceLine,
   PriceLinesStyle,
+  DefaultDrawingStyle,
 } from './types';

package/src/jsi.d.ts

@@ -1,6 +1,10 @@
 // Ambient declaration for the JSI HostObject installed by VroomChartModule.
 
-import type { SkPicture } from '@shopify/react-native-skia';
+import type { SkImage, SkPicture } from '@shopify/react-native-skia';
+import type { IntervalTransition } from '@vroomchart/types';
+
+/** Frame the JSI handle returns: an SkPicture on iOS, an SkImage on Android. */
+export type ChartFrame = SkPicture | SkImage;
 
 export interface ChartHandle {
   setCandles(buffer: ArrayBuffer): void;
@@ -62,15 +66,12 @@ export interface ChartHandle {
    */
   preservePriceEnvelope(prevLow: number, prevHigh: number): void;
   /**
-   * Capture the visible candle geometry so the next data swap can animate as a
-   * reshape rather than a jump: each candle's wick and body slide and stretch
-   * into the shape of its counterpart in the new data.
-   *
-   * Candles are paired by *slot* — position counting back from the right edge of
-   * the visible window, which a timeframe switch preserves. Call before
-   * setCandles, then drive setIntervalMorph from 0 to 1.
+   * Capture the visible candle geometry so the next data swap can animate.
+   * `'transform'` (default) lerps each slot into its counterpart; `'fade'`
+   * fades the capture out then the new scene in. Call before setCandles,
+   * then drive setIntervalMorph from 0 to 1.
    */
-  beginIntervalMorph(): void;
+  beginIntervalMorph(mode?: IntervalTransition): void;
   /**
    * Advance the interval morph started by beginIntervalMorph. `t` (clamped to
    * 0..1) is the eased progress: 0 renders the captured geometry pixel-
@@ -79,30 +80,30 @@ export interface ChartHandle {
    */
   setIntervalMorph(t: number): void;
   /** Shifts the visible range by `dx`/`dy` pixels and returns a fresh picture. */
-  pan(dx: number, dy: number): SkPicture | null;
+  pan(dx: number, dy: number): ChartFrame | null;
   /**
    * Two-finger translation: shifts the time window AND the price bounds
    * without rescaling. dy > 0 (drag down) moves content down.
    */
-  translate(dx: number, dy: number): SkPicture | null;
+  translate(dx: number, dy: number): ChartFrame | null;
   /**
    * Directional zoom by per-axis multiplicative factors around focus point
    * (`fx`, `fy`) in pixels. `scaleX` resizes the time window (>1 = wider
    * candles); `scaleY` resizes the price range (>1 = taller candles). Pass 1
    * for an axis to leave it untouched.
    */
-  zoom(scaleX: number, scaleY: number, fx: number, fy: number): SkPicture | null;
+  zoom(scaleX: number, scaleY: number, fx: number, fy: number): ChartFrame | null;
   /**
    * Drag-on-y-axis price scaling. `dy > 0` widens the price range
    * (candles shrink). Pivots around the price-range center.
    */
-  scalePriceAxis(dy: number): SkPicture | null;
+  scalePriceAxis(dy: number): ChartFrame | null;
   /**
    * Drag-on-x-axis time scaling. `dx > 0` widens the time window
    * (candles thin). Pivots around the right edge so the most recent
    * visible candle stays in place.
    */
-  scaleTimeAxis(dx: number): SkPicture | null;
+  scaleTimeAxis(dx: number): ChartFrame | null;
   /**
    * Current axis dimensions in pixels for hit testing in JS gestures.
    * `indicatorHeight` is the below-chart indicator pane height (0 when none).
@@ -117,9 +118,9 @@ export interface ChartHandle {
    * `y` should already be lifted above the touch point so the dot/horizontal
    * line aren't hidden under the thumb.
    */
-  setCrosshair(x: number, y: number): SkPicture | null;
+  setCrosshair(x: number, y: number): ChartFrame | null;
   /** Hides the crosshair and returns a fresh picture. */
-  clearCrosshair(): SkPicture | null;
+  clearCrosshair(): ChartFrame | null;
   /**
    * OHLCV of the candle the crosshair currently snaps to, or null when the
    * crosshair is inactive / there are no visible candles. Cheap to poll at
@@ -326,7 +327,7 @@ export interface ChartHandle {
   setPriceLineDrag(index: number, price: number): void;
   /** True while any axis-label fade is still in progress. Drives a RAF loop. */
   isAnimating(): boolean;
-  render(): SkPicture | null;
+  render(): ChartFrame | null;
 }
 
 export interface VroomChartJSI {

package/src/types.ts

@@ -20,8 +20,10 @@ export type {
   MACDConfig,
   ChartType,
   TransitionEasing,
+  IntervalTransition,
   PriceLine,
   PriceLinesStyle,
+  DefaultDrawingStyle,
 } from '@vroomchart/types';
 
 /**

package/src/useChartCore.ts

@@ -1,12 +1,11 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
 import type { MutableRefObject } from 'react';
-import type { SkPicture } from '@shopify/react-native-skia';
 
 import NativeVroomChart from './NativeVroomChart';
 import type { DataTransition } from './dataTransitions';
 import { classifyTransition, inferStepMs, timeframeWindow } from './dataTransitions';
 import { ease } from './easing';
-import type { ChartHandle } from './jsi.d';
+import type { ChartFrame, ChartHandle } from './jsi.d';
 import { packCandles } from './packCandles';
 import { applyTheme, parseColor, FLOAT_LINE_TIP_PULSE } from './theme';
 import type {
@@ -19,6 +18,7 @@ import type {
   PriceLinesStyle,
   RSIConfig,
   TransitionEasing,
+  IntervalTransition,
   VisibleRange,
   VolumeConfig,
   VroomTheme,
@@ -230,16 +230,18 @@ export type TransitionOptions = {
   transitionMs?: number;
   /** Curve applied to the morph's progress. Default 'ease-in-out'. */
   transitionEasing?: TransitionEasing;
+  /** `'transform'` (default) slot-lerps; `'fade'` fades out then in. */
+  intervalTransition?: IntervalTransition;
   /** OS reduced-motion preference: skips the capture and snaps. */
   reduceMotion?: boolean;
   /** Receives every morph frame. Without one, data swaps snap. */
-  onFrame?: (picture: SkPicture) => void;
+  onFrame?: (picture: ChartFrame) => void;
 };
 
 export type ChartCoreState = {
   handle: ChartHandle | null;
   /** Picture freshly rendered after the latest data/size/range push. */
-  picture: SkPicture | null;
+  picture: ChartFrame | null;
   /**
    * The last volume collapse handed to the core, or null before the first push.
    * VroomChart's animation loop owns this — it lives here only so the data effect
@@ -282,7 +284,7 @@ export function useChartCore(
     seriesKey?: string;
   } | null>(null);
   const intervalMorphRaf = useRef<number | null>(null);
-  const [picture, setPicture] = useState<SkPicture | null>(null);
+  const [picture, setPicture] = useState<ChartFrame | null>(null);
 
   if (!handleRef.current && size.width > 0 && size.height > 0) {
     ensureInstalled();
@@ -296,11 +298,13 @@ export function useChartCore(
     ms: number;
     easing: TransitionEasing | undefined;
     reduceMotion: boolean;
-  }>({ ms: 300, easing: undefined, reduceMotion: false });
+    interval: IntervalTransition;
+  }>({ ms: 300, easing: undefined, reduceMotion: false, interval: 'transform' });
   animRef.current = {
     ms: Math.max(0, transition?.transitionMs ?? 300),
     easing: transition?.transitionEasing,
     reduceMotion: transition?.reduceMotion ?? false,
+    interval: transition?.intervalTransition === 'fade' ? 'fade' : 'transform',
   };
   const onFrameRef = useRef(transition?.onFrame);
   onFrameRef.current = transition?.onFrame;
@@ -420,7 +424,7 @@ export function useChartCore(
             onFrameRef.current != null;
           if (morphing) {
             endIntervalMorph();
-            h.beginIntervalMorph();
+            h.beginIntervalMorph(animRef.current.interval);
           }
         } else if (transitionKind === 'initial' || transitionKind === 'reset') {
           // Wholesale reframing — the slot pairing no longer holds, so land any