chart-library-native 1.0.0

package/src/api/tier1/useQuickMACD.ts

@@ -0,0 +1,60 @@
+// ============================================================================
+// 📄 bindings/react-native/src/api/tier1/useQuickMACD.ts
+// Tier 1 API: MACD (Standard settings)
+// ============================================================================
+
+import { useMACD } from '../../hooks/useIndicators';
+
+export interface UseQuickMACDResult {
+  macd: (number | null)[];
+  signal: (number | null)[];
+  histogram: (number | null)[];
+  loading: boolean;
+  error?: string;
+  currentSignal: {
+    macdValue: number | null;
+    signalValue: number | null;
+    histogramValue: number | null;
+    signal: 'buy' | 'sell' | 'neutral';
+  };
+  status: 'success' | 'error';
+}
+
+/**
+ * Quick MACD Hook - Industry standard settings
+ * 
+ * Default: fast=12, slow=26, signal=9 (most common)
+ * 
+ * @param closes - Array of close prices
+ * @returns { macd, signal, histogram, currentSignal, loading, error, status }
+ */
+export const useQuickMACD = (closes: number[]): UseQuickMACDResult => {
+  const { macd, signal, histogram, loading, status, error } = useMACD(closes, {
+    fast: 12,
+    slow: 26,
+    signal: 9
+  });
+
+  // Calculate trade signal
+  const validMacd = macd.filter(v => v !== null && Number.isFinite(v)) as number[];
+  const validSignal = signal.filter(v => v !== null && Number.isFinite(v)) as number[];
+  const validHist = histogram.filter(v => v !== null && Number.isFinite(v)) as number[];
+
+  const currentSignal = {
+    macdValue: validMacd.length > 0 ? validMacd[validMacd.length - 1] : null,
+    signalValue: validSignal.length > 0 ? validSignal[validSignal.length - 1] : null,
+    histogramValue: validHist.length > 0 ? validHist[validHist.length - 1] : null,
+    signal: ((): 'buy' | 'sell' | 'neutral' => {
+      if (validMacd.length === 0 || validSignal.length === 0 || validHist.length === 0) {
+        return 'neutral';
+      }
+      const h = validHist[validHist.length - 1];
+      const m = validMacd[validMacd.length - 1];
+      const s = validSignal[validSignal.length - 1];
+      return m > s && h > 0 ? 'buy' : m < s && h < 0 ? 'sell' : 'neutral';
+    })()
+  };
+
+  return { macd, signal, histogram, loading, error, currentSignal, status };
+};
+

package/src/api/tier1/useQuickRSI.ts

@@ -0,0 +1,38 @@
+// ============================================================================
+// 📄 bindings/react-native/src/api/tier1/useQuickRSI.ts
+// Tier 1 API: RSI (Relative Strength Index)
+// ============================================================================
+
+import { useRSI } from '../../hooks/useIndicators';
+
+export interface UseQuickRSIResult {
+  data: (number | null)[];
+  loading: boolean;
+  error?: string;
+  currentLevel: {
+    value: number | null;
+    level: 'overbought' | 'oversold' | 'neutral';
+  };
+  status: 'success' | 'error';
+}
+
+/**
+ * Quick RSI Hook - Standard RSI14
+ * 
+ * @param closes - Array of close prices
+ * @returns { data, loading, error, currentLevel, status }
+ */
+export const useQuickRSI = (closes: number[]): UseQuickRSIResult => {
+  const { data, loading, status, error } = useRSI(closes, { period: 14 });
+
+  const validData = data.filter(v => v !== null && Number.isFinite(v)) as number[];
+  const value = validData.length > 0 ? validData[validData.length - 1] : null;
+
+  const currentLevel = {
+    value,
+    level: (value === null ? 'neutral' : value > 70 ? 'overbought' : value < 30 ? 'oversold' : 'neutral') as 'overbought' | 'oversold' | 'neutral'
+  };
+
+  return { data, loading, error, currentLevel, status };
+};
+

package/src/helpers.cpp

@@ -0,0 +1,135 @@
+// ============================================================================
+// 📄 bindings/react-native/src/helpers.cpp
+// Mục đích: Helper functions implementation for JS <-> C++ type conversion
+// ============================================================================
+
+#include "helpers.h"
+#include <cmath>
+
+using namespace facebook;
+
+namespace chart {
+  namespace reactnative {
+    namespace helpers {
+      
+      // ======================================================================
+      // Convert JavaScript Array to C++ vector<double>
+      // ======================================================================
+      std::vector<double> jsArrayToVector(jsi::Runtime& runtime, const jsi::Value& array) {
+        if (!array.isObject()) {
+          throw jsi::JSError(runtime, "Expected array");
+        }
+        
+        jsi::Object obj = array.asObject(runtime);
+        if (!obj.isArray(runtime)) {
+          throw jsi::JSError(runtime, "Expected array");
+        }
+        
+        jsi::Array jsArray = obj.getArray(runtime);
+        size_t length = jsArray.length(runtime);
+        
+        std::vector<double> result;
+        result.reserve(length);
+        
+        for (size_t i = 0; i < length; i++) {
+          jsi::Value element = jsArray.getValueAtIndex(runtime, i);
+          if (element.isNumber()) {
+            result.push_back(element.asNumber());
+          } else if (element.isNull() || (element.isNumber() && std::isnan(element.asNumber()))) {
+            result.push_back(std::nan(""));
+          } else {
+            throw jsi::JSError(runtime, "Array element must be a number");
+          }
+        }
+        
+        return result;
+      }
+      
+      // ======================================================================
+      // Convert C++ vector<double> to JavaScript Array
+      // ======================================================================
+      jsi::Array vectorToJSArray(jsi::Runtime& runtime, const std::vector<double>& vec) {
+        jsi::Array result = jsi::Array(runtime, vec.size());
+        
+        for (size_t i = 0; i < vec.size(); i++) {
+          if (std::isnan(vec[i])) {
+            result.setValueAtIndex(runtime, i, jsi::Value::null());
+          } else {
+            result.setValueAtIndex(runtime, i, jsi::Value(vec[i]));
+          }
+        }
+        
+        return result;
+      }
+      
+      // ======================================================================
+      // Convert MACDResult to JavaScript Object
+      // ======================================================================
+      jsi::Object macdResultToJSObject(jsi::Runtime& runtime, const common::MACDResult& result) {
+        jsi::Object obj = jsi::Object(runtime);
+        obj.setProperty(runtime, "macd", vectorToJSArray(runtime, result.macd));
+        obj.setProperty(runtime, "signal", vectorToJSArray(runtime, result.signal));
+        obj.setProperty(runtime, "histogram", vectorToJSArray(runtime, result.histogram));
+        return obj;
+      }
+      
+      // ======================================================================
+      // Convert BollingerResult to JavaScript Object
+      // ======================================================================
+      jsi::Object bollingerResultToJSObject(jsi::Runtime& runtime, const common::BollingerResult& result) {
+        jsi::Object obj = jsi::Object(runtime);
+        obj.setProperty(runtime, "upper", vectorToJSArray(runtime, result.upper));
+        obj.setProperty(runtime, "mid", vectorToJSArray(runtime, result.mid));
+        obj.setProperty(runtime, "lower", vectorToJSArray(runtime, result.lower));
+        return obj;
+      }
+      
+      // ======================================================================
+      // Convert KDJResult to JavaScript Object
+      // ======================================================================
+      jsi::Object kdjResultToJSObject(jsi::Runtime& runtime, const common::KDJResult& result) {
+        jsi::Object obj = jsi::Object(runtime);
+        obj.setProperty(runtime, "k", vectorToJSArray(runtime, result.k));
+        obj.setProperty(runtime, "d", vectorToJSArray(runtime, result.d));
+        obj.setProperty(runtime, "j", vectorToJSArray(runtime, result.j));
+        return obj;
+      }
+      
+      // ======================================================================
+      // Convert DMIResult to JavaScript Object
+      // ======================================================================
+      jsi::Object dmiResultToJSObject(jsi::Runtime& runtime, const common::DMIResult& result) {
+        jsi::Object obj = jsi::Object(runtime);
+        obj.setProperty(runtime, "plusDI", vectorToJSArray(runtime, result.plusDI));
+        obj.setProperty(runtime, "minusDI", vectorToJSArray(runtime, result.minusDI));
+        obj.setProperty(runtime, "adx", vectorToJSArray(runtime, result.adx));
+        return obj;
+      }
+      
+      // ======================================================================
+      // Convert IchimokuResult to JavaScript Object
+      // ======================================================================
+      jsi::Object ichimokuResultToJSObject(jsi::Runtime& runtime, const common::IchimokuResult& result) {
+        jsi::Object obj = jsi::Object(runtime);
+        obj.setProperty(runtime, "tenkan", vectorToJSArray(runtime, result.tenkan));
+        obj.setProperty(runtime, "kijun", vectorToJSArray(runtime, result.kijun));
+        obj.setProperty(runtime, "senkouA", vectorToJSArray(runtime, result.senkouA));
+        obj.setProperty(runtime, "senkouB", vectorToJSArray(runtime, result.senkouB));
+        obj.setProperty(runtime, "chikou", vectorToJSArray(runtime, result.chikou));
+        return obj;
+      }
+      
+      // ======================================================================
+      // Convert StochasticResult to JavaScript Object
+      // ======================================================================
+      jsi::Object stochasticResultToJSObject(jsi::Runtime& runtime, const common::StochasticResult& result) {
+        jsi::Object obj = jsi::Object(runtime);
+        obj.setProperty(runtime, "k", vectorToJSArray(runtime, result.k));
+        obj.setProperty(runtime, "d", vectorToJSArray(runtime, result.d));
+        return obj;
+      }
+      
+    } // namespace helpers
+  } // namespace reactnative
+} // namespace chart
+

package/src/helpers.h

@@ -0,0 +1,65 @@
+// ============================================================================
+// 📄 bindings/react-native/src/helpers.h
+// Mục đích: Helper functions for JS <-> C++ type conversion
+// ============================================================================
+
+#ifndef HELPERS_H
+#define HELPERS_H
+
+#include <jsi/jsi.h>
+#include <vector>
+#include "../../core/indicators/indicators.h"
+#include "../../core/common/types.h"
+
+using namespace facebook;
+
+namespace chart {
+  namespace reactnative {
+    namespace helpers {
+      
+      // ======================================================================
+      // Convert JavaScript Array to C++ vector<double>
+      // ======================================================================
+      std::vector<double> jsArrayToVector(jsi::Runtime& runtime, const jsi::Value& array);
+      
+      // ======================================================================
+      // Convert C++ vector<double> to JavaScript Array
+      // ======================================================================
+      jsi::Array vectorToJSArray(jsi::Runtime& runtime, const std::vector<double>& vec);
+      
+      // ======================================================================
+      // Convert MACDResult to JavaScript Object
+      // ======================================================================
+      jsi::Object macdResultToJSObject(jsi::Runtime& runtime, const common::MACDResult& result);
+      
+      // ======================================================================
+      // Convert BollingerResult to JavaScript Object
+      // ======================================================================
+      jsi::Object bollingerResultToJSObject(jsi::Runtime& runtime, const common::BollingerResult& result);
+      
+      // ======================================================================
+      // Convert KDJResult to JavaScript Object
+      // ======================================================================
+      jsi::Object kdjResultToJSObject(jsi::Runtime& runtime, const common::KDJResult& result);
+      
+      // ======================================================================
+      // Convert DMIResult to JavaScript Object
+      // ======================================================================
+      jsi::Object dmiResultToJSObject(jsi::Runtime& runtime, const common::DMIResult& result);
+      
+      // ======================================================================
+      // Convert IchimokuResult to JavaScript Object
+      // ======================================================================
+      jsi::Object ichimokuResultToJSObject(jsi::Runtime& runtime, const common::IchimokuResult& result);
+      
+      // ======================================================================
+      // Convert StochasticResult to JavaScript Object
+      // ======================================================================
+      jsi::Object stochasticResultToJSObject(jsi::Runtime& runtime, const common::StochasticResult& result);
+      
+    } // namespace helpers
+  } // namespace reactnative
+} // namespace chart
+
+#endif // HELPERS_H
+

package/src/hooks/useIndicators.ts

@@ -0,0 +1,388 @@
+// ============================================================================
+// 📄 bindings/react-native/src/hooks/useIndicators.ts
+// Tier 2: Advanced hooks with full customization
+// ============================================================================
+
+import { useState, useEffect, useMemo } from 'react';
+import ChartLibrary from '../../index';
+import type { CandleData, MACDResult, KDJResult, BOLLResult, DMIResult } from '../types';
+
+// ============================================================================
+// MA Hook (Tier 2)
+// ============================================================================
+
+export interface MAConfig {
+  period: number;
+  type: 'simple' | 'exponential' | 'weighted';
+}
+
+export const useMA = (closes: number[], config: MAConfig) => {
+  const [data, setData] = useState<(number | null)[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | undefined>();
+  const [status, setStatus] = useState<'success' | 'error'>('success');
+
+  useEffect(() => {
+    if (!closes || closes.length === 0) {
+      setData([]);
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      let result: (number | null)[];
+
+      if (config.type === 'simple') {
+        result = ChartLibrary.calculateMA(closes, config.period);
+      } else if (config.type === 'exponential') {
+        result = ChartLibrary.calculateEMA(closes, config.period);
+      } else {
+        // Weighted - fallback to simple for now
+        result = ChartLibrary.calculateMA(closes, config.period);
+      }
+
+      setData(result);
+      setStatus('success');
+      setError(undefined);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+      setStatus('error');
+      setData([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [closes, config.period, config.type]);
+
+  return { data, loading, error, status };
+};
+
+// ============================================================================
+// EMA Hook (Tier 2)
+// ============================================================================
+
+export interface EMAConfig {
+  period: number;
+  type: 'exponential';
+}
+
+export const useEMA = (closes: number[], config: EMAConfig) => {
+  const [data, setData] = useState<(number | null)[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | undefined>();
+  const [status, setStatus] = useState<'success' | 'error'>('success');
+
+  useEffect(() => {
+    if (!closes || closes.length === 0) {
+      setData([]);
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      const result = ChartLibrary.calculateEMA(closes, config.period);
+      setData(result);
+      setStatus('success');
+      setError(undefined);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+      setStatus('error');
+      setData([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [closes, config.period]);
+
+  return { data, loading, error, status };
+};
+
+// ============================================================================
+// WMA Hook (Tier 2) - Placeholder
+// ============================================================================
+
+export interface WMAConfig {
+  period: number;
+  type: 'weighted';
+}
+
+export const useWMA = (closes: number[], config: WMAConfig) => {
+  // WMA not yet in C API, fallback to MA
+  return useMA(closes, { period: config.period, type: 'simple' });
+};
+
+// ============================================================================
+// MACD Hook (Tier 2)
+// ============================================================================
+
+export interface MACDConfig {
+  fast: number;
+  slow: number;
+  signal: number;
+}
+
+export const useMACD = (closes: number[], config: MACDConfig): MACDResult => {
+  const [macd, setMacd] = useState<(number | null)[]>([]);
+  const [signal, setSignal] = useState<(number | null)[]>([]);
+  const [histogram, setHistogram] = useState<(number | null)[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | undefined>();
+  const [status, setStatus] = useState<'success' | 'error'>('success');
+
+  useEffect(() => {
+    if (!closes || closes.length === 0) {
+      setMacd([]);
+      setSignal([]);
+      setHistogram([]);
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      const result = ChartLibrary.calculateMACD(closes, config.fast, config.slow, config.signal);
+      setMacd(result.macd);
+      setSignal(result.signal);
+      setHistogram(result.histogram);
+      setStatus('success');
+      setError(undefined);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+      setStatus('error');
+      setMacd([]);
+      setSignal([]);
+      setHistogram([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [closes, config.fast, config.slow, config.signal]);
+
+  return { macd, signal, histogram, loading, error, status };
+};
+
+// ============================================================================
+// RSI Hook (Tier 2)
+// ============================================================================
+
+export interface RSIConfig {
+  period: number;
+}
+
+export const useRSI = (closes: number[], config: RSIConfig) => {
+  const [data, setData] = useState<(number | null)[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | undefined>();
+  const [status, setStatus] = useState<'success' | 'error'>('success');
+
+  useEffect(() => {
+    if (!closes || closes.length === 0) {
+      setData([]);
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      const result = ChartLibrary.calculateRSI(closes, config.period);
+      setData(result);
+      setStatus('success');
+      setError(undefined);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+      setStatus('error');
+      setData([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [closes, config.period]);
+
+  return { data, loading, error, status };
+};
+
+// ============================================================================
+// KDJ Hook (Tier 2)
+// ============================================================================
+
+export interface KDJConfig {
+  n: number;
+  m1: number;
+  m2: number;
+}
+
+export const useKDJ = (candleData: CandleData[], config: KDJConfig): KDJResult => {
+  const [k, setK] = useState<(number | null)[]>([]);
+  const [d, setD] = useState<(number | null)[]>([]);
+  const [j, setJ] = useState<(number | null)[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | undefined>();
+  const [status, setStatus] = useState<'success' | 'error'>('success');
+
+  useEffect(() => {
+    if (!candleData || candleData.length === 0) {
+      setK([]);
+      setD([]);
+      setJ([]);
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      const highs = candleData.map(c => c.high);
+      const lows = candleData.map(c => c.low);
+      const closes = candleData.map(c => c.close);
+
+      const result = ChartLibrary.calculateKDJ(highs, lows, closes, config.n, config.m1, config.m2);
+      setK(result.k);
+      setD(result.d);
+      setJ(result.j);
+      setStatus('success');
+      setError(undefined);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+      setStatus('error');
+      setK([]);
+      setD([]);
+      setJ([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [candleData, config.n, config.m1, config.m2]);
+
+  return { k, d, j, loading, error, status };
+};
+
+// ============================================================================
+// Bollinger Bands Hook (Tier 2)
+// ============================================================================
+
+export interface BollingerConfig {
+  period: number;
+  k: number;
+}
+
+export const useBollinger = (closes: number[], config: BollingerConfig): BOLLResult => {
+  const [upper, setUpper] = useState<(number | null)[]>([]);
+  const [middle, setMiddle] = useState<(number | null)[]>([]);
+  const [lower, setLower] = useState<(number | null)[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | undefined>();
+  const [status, setStatus] = useState<'success' | 'error'>('success');
+
+  useEffect(() => {
+    if (!closes || closes.length === 0) {
+      setUpper([]);
+      setMiddle([]);
+      setLower([]);
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      const result = ChartLibrary.calculateBOLL(closes, config.period, config.k);
+      setUpper(result.upper);
+      setMiddle(result.middle);
+      setLower(result.lower);
+      setStatus('success');
+      setError(undefined);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+      setStatus('error');
+      setUpper([]);
+      setMiddle([]);
+      setLower([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [closes, config.period, config.k]);
+
+  return { upper, middle, lower, loading, error, status };
+};
+
+// ============================================================================
+// DMI Hook (Tier 2)
+// ============================================================================
+
+export interface DMIConfig {
+  period: number;
+}
+
+export const useDMI = (candleData: CandleData[], config: DMIConfig): DMIResult => {
+  const [pdi, setPdi] = useState<(number | null)[]>([]);
+  const [mdi, setMdi] = useState<(number | null)[]>([]);
+  const [adx, setAdx] = useState<(number | null)[]>([]);
+  const [adxr, setAdxr] = useState<(number | null)[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | undefined>();
+  const [status, setStatus] = useState<'success' | 'error'>('success');
+
+  useEffect(() => {
+    if (!candleData || candleData.length === 0) {
+      setPdi([]);
+      setMdi([]);
+      setAdx([]);
+      setAdxr([]);
+      setLoading(false);
+      return;
+    }
+
+    try {
+      setLoading(true);
+      const opens = candleData.map(c => c.open);
+      const highs = candleData.map(c => c.high);
+      const lows = candleData.map(c => c.low);
+      const closes = candleData.map(c => c.close);
+
+      const result = ChartLibrary.calculateDMI(opens, highs, lows, closes, config.period);
+      setPdi(result.pdi);
+      setMdi(result.mdi);
+      setAdx(result.adx);
+      setAdxr(result.adxr);
+      setStatus('success');
+      setError(undefined);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+      setStatus('error');
+      setPdi([]);
+      setMdi([]);
+      setAdx([]);
+      setAdxr([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [candleData, config.period]);
+
+  return { pdi, mdi, adx, adxr, loading, error, status };
+};
+
+// ============================================================================
+// Multiple Indicators Hook (Tier 2)
+// ============================================================================
+
+export const useMultipleIndicators = (
+  closes: number[],
+  configs: {
+    ma?: MAConfig;
+    ema?: EMAConfig;
+    macd?: MACDConfig;
+    rsi?: RSIConfig;
+    bollinger?: BollingerConfig;
+  }
+) => {
+  const ma = configs.ma ? useMA(closes, configs.ma) : null;
+  const ema = configs.ema ? useEMA(closes, configs.ema) : null;
+  const macd = configs.macd ? useMACD(closes, configs.macd) : null;
+  const rsi = configs.rsi ? useRSI(closes, configs.rsi) : null;
+  const bollinger = configs.bollinger ? useBollinger(closes, configs.bollinger) : null;
+
+  return {
+    ma,
+    ema,
+    macd,
+    rsi,
+    bollinger,
+    loading: ma?.loading || ema?.loading || macd?.loading || rsi?.loading || bollinger?.loading || false
+  };
+};
+