@pipsend/charts 2.0.1 → 2.1.0

package/dist/pipsend-charts.standalone.development.js

@@ -1,6 +1,6 @@
 /*!
  * @license
- * Pipsend Charts v2.0.1
+ * Pipsend Charts v2.1.0
  * Copyright (c) 2026 Pipsend
  * Licensed under MIT License
  * Built on TradingView Lightweight Charts™ (Apache 2.0)
@@ -17550,6 +17550,164 @@
         };
     }
 
+    function isOhlc(bar) {
+        return bar !== null
+            && bar !== undefined
+            && typeof bar.close === 'number';
+    }
+    /**
+     * Turns raw OHLC bars into Heikin Ashi ones.
+     *
+     * Heikin Ashi is a price transform, not an overlay: each candle averages itself
+     * with the one before it, which drops most of the single-bar noise and leaves
+     * runs of same-coloured bodies while a trend holds.
+     *
+     * ```
+     * close = (O + H + L + C) / 4
+     * open  = (previous open + previous close) / 2      // first bar: (O + C) / 2
+     * high  = max(H, open, close)
+     * low   = min(L, open, close)
+     * ```
+     *
+     * Because every bar folds in the one before it, the result depends on where the
+     * data starts: the same bar computed from a longer history differs slightly.
+     * The difference decays over a few bars, so pass the whole series rather than a
+     * recent window when you can.
+     *
+     * Whitespace items are passed through untouched, and do not advance the
+     * running open/close — a gap in the data is not a bar.
+     *
+     * @param bars - Source bars, ordered oldest to newest.
+     * @returns The transformed bars, one per input item.
+     */
+    function calculateHeikinAshi(bars) {
+        const result = [];
+        let previousOpen = null;
+        let previousClose = null;
+        for (const bar of bars) {
+            if (!isOhlc(bar)) {
+                if (bar !== null && bar !== undefined) {
+                    result.push({ time: bar.time, customValues: bar.customValues });
+                }
+                continue;
+            }
+            const haClose = (bar.open + bar.high + bar.low + bar.close) / 4;
+            const haOpen = previousOpen === null || previousClose === null
+                ? (bar.open + bar.close) / 2
+                : (previousOpen + previousClose) / 2;
+            result.push({
+                time: bar.time,
+                open: haOpen,
+                high: Math.max(bar.high, haOpen, haClose),
+                low: Math.min(bar.low, haOpen, haClose),
+                close: haClose,
+                customValues: bar.customValues,
+            });
+            previousOpen = haOpen;
+            previousClose = haClose;
+        }
+        return result;
+    }
+    /**
+     * Draw a source series as Heikin Ashi candles.
+     *
+     * The source series is left in place holding its real prices — it is only
+     * hidden — so indicators bound to it keep computing on the true OHLC, and
+     * `remove()` puts the chart back exactly as it was. That makes this usable as a
+     * chart-type toggle:
+     *
+     * ```js
+     * const ha = applyHeikinAshi(candleSeries, chart);
+     * // …back to regular candles:
+     * ha.remove();
+     * ```
+     *
+     * @param series - Source OHLC series (a candlestick or bar series).
+     * @param chart - Chart instance.
+     * @param options - Heikin Ashi configuration options.
+     * @returns The Heikin Ashi candlestick series, plus live control over its options.
+     */
+    function applyHeikinAshi(series, chart, options = {}) {
+        const resolved = {
+            paneIndex: options.paneIndex ?? 0,
+            upColor: options.upColor ?? '#26a69a',
+            downColor: options.downColor ?? '#ef5350',
+            borderVisible: options.borderVisible ?? true,
+            borderUpColor: options.borderUpColor ?? '#26a69a',
+            borderDownColor: options.borderDownColor ?? '#ef5350',
+            wickVisible: options.wickVisible ?? true,
+            wickUpColor: options.wickUpColor ?? '#26a69a',
+            wickDownColor: options.wickDownColor ?? '#ef5350',
+            hideSource: options.hideSource ?? true,
+        };
+        const sourceOptions = series.options();
+        // Same price scale and the same formatting as the source: the candles are a
+        // restatement of that series, not a second instrument, so they must not
+        // autoscale on their own axis or round to a different precision.
+        const haSeries = chart.addSeries(candlestickSeries, {
+            upColor: resolved.upColor,
+            downColor: resolved.downColor,
+            borderVisible: resolved.borderVisible,
+            borderUpColor: resolved.borderUpColor,
+            borderDownColor: resolved.borderDownColor,
+            wickVisible: resolved.wickVisible,
+            wickUpColor: resolved.wickUpColor,
+            wickDownColor: resolved.wickDownColor,
+            priceScaleId: sourceOptions.priceScaleId,
+            priceFormat: sourceOptions.priceFormat,
+        }, resolved.paneIndex);
+        const sourceWasVisible = sourceOptions.visible;
+        if (resolved.hideSource === true) {
+            series.applyOptions({ visible: false });
+        }
+        const runtime = bindIndicator({
+            _internal_source: series,
+            _internal_chart: chart,
+            _internal_outputs: [haSeries],
+            _internal_label: 'Heikin Ashi',
+            _internal_options: resolved,
+            // Every option here is a colour or a toggle on the series itself, so a
+            // change never needs the transform run again.
+            _internal_recomputeOn: [],
+            _internal_compute: (data) => [
+                [haSeries, calculateHeikinAshi(data)],
+            ],
+            _internal_applyStyle: (current) => {
+                haSeries.applyOptions({
+                    upColor: current.upColor,
+                    downColor: current.downColor,
+                    borderVisible: current.borderVisible,
+                    borderUpColor: current.borderUpColor,
+                    borderDownColor: current.borderDownColor,
+                    wickVisible: current.wickVisible,
+                    wickUpColor: current.wickUpColor,
+                    wickDownColor: current.wickDownColor,
+                });
+                series.applyOptions({
+                    visible: current.hideSource === true ? false : sourceWasVisible,
+                });
+            },
+        });
+        const handle = {
+            _internal_series: haSeries,
+            options: runtime.options,
+            applyOptions: runtime.applyOptions,
+            recalculate: runtime.recalculate,
+            remove: () => {
+                runtime.remove();
+                // The source outlives the indicator, so its visibility is ours to put
+                // back — otherwise removing a Heikin Ashi overlay leaves a blank chart.
+                try {
+                    series.applyOptions({ visible: sourceWasVisible });
+                }
+                catch (error) {
+                    // The series may already be gone if the chart was disposed
+                }
+            },
+        };
+        return handle;
+    }
+
     /**
      * Apply RSI indicator to a series
      * @param series - Source series to calculate RSI from
@@ -29608,7 +29766,7 @@
      * Returns the current version as a string. For example `'1.0.0'`.
      */
     function version() {
-        return "2.0.1";
+        return "2.1.0";
     }
 
     var PipsendChartsModule = /*#__PURE__*/Object.freeze({
@@ -29665,6 +29823,7 @@
         applyCCI: applyCCI,
         applyDonchianChannels: applyDonchianChannels,
         applyEMA: applyEMA,
+        applyHeikinAshi: applyHeikinAshi,
         applyIchimoku: applyIchimoku,
         applyKeltnerChannels: applyKeltnerChannels,
         applyMACD: applyMACD,
@@ -29680,6 +29839,7 @@
         applyVolume: applyVolume,
         applyWMA: applyWMA,
         applyWilliamsR: applyWilliamsR,
+        calculateHeikinAshi: calculateHeikinAshi,
         calculatePipConfig: calculatePipConfig,
         coordinateFromTime: coordinateFromTime,
         createArrowTool: createArrowTool,

package/dist/pipsend-charts.standalone.development.mjs

@@ -1,6 +1,6 @@
 /*!
  * @license
- * Pipsend Charts v2.0.1
+ * Pipsend Charts v2.1.0
  * Copyright (c) 2026 Pipsend
  * Licensed under MIT License
  * Built on TradingView Lightweight Charts™ (Apache 2.0)
@@ -17547,6 +17547,164 @@ function applyPivotPoints(series, chart, options = {}) {
     };
 }
 
+function isOhlc(bar) {
+    return bar !== null
+        && bar !== undefined
+        && typeof bar.close === 'number';
+}
+/**
+ * Turns raw OHLC bars into Heikin Ashi ones.
+ *
+ * Heikin Ashi is a price transform, not an overlay: each candle averages itself
+ * with the one before it, which drops most of the single-bar noise and leaves
+ * runs of same-coloured bodies while a trend holds.
+ *
+ * ```
+ * close = (O + H + L + C) / 4
+ * open  = (previous open + previous close) / 2      // first bar: (O + C) / 2
+ * high  = max(H, open, close)
+ * low   = min(L, open, close)
+ * ```
+ *
+ * Because every bar folds in the one before it, the result depends on where the
+ * data starts: the same bar computed from a longer history differs slightly.
+ * The difference decays over a few bars, so pass the whole series rather than a
+ * recent window when you can.
+ *
+ * Whitespace items are passed through untouched, and do not advance the
+ * running open/close — a gap in the data is not a bar.
+ *
+ * @param bars - Source bars, ordered oldest to newest.
+ * @returns The transformed bars, one per input item.
+ */
+function calculateHeikinAshi(bars) {
+    const result = [];
+    let previousOpen = null;
+    let previousClose = null;
+    for (const bar of bars) {
+        if (!isOhlc(bar)) {
+            if (bar !== null && bar !== undefined) {
+                result.push({ time: bar.time, customValues: bar.customValues });
+            }
+            continue;
+        }
+        const haClose = (bar.open + bar.high + bar.low + bar.close) / 4;
+        const haOpen = previousOpen === null || previousClose === null
+            ? (bar.open + bar.close) / 2
+            : (previousOpen + previousClose) / 2;
+        result.push({
+            time: bar.time,
+            open: haOpen,
+            high: Math.max(bar.high, haOpen, haClose),
+            low: Math.min(bar.low, haOpen, haClose),
+            close: haClose,
+            customValues: bar.customValues,
+        });
+        previousOpen = haOpen;
+        previousClose = haClose;
+    }
+    return result;
+}
+/**
+ * Draw a source series as Heikin Ashi candles.
+ *
+ * The source series is left in place holding its real prices — it is only
+ * hidden — so indicators bound to it keep computing on the true OHLC, and
+ * `remove()` puts the chart back exactly as it was. That makes this usable as a
+ * chart-type toggle:
+ *
+ * ```js
+ * const ha = applyHeikinAshi(candleSeries, chart);
+ * // …back to regular candles:
+ * ha.remove();
+ * ```
+ *
+ * @param series - Source OHLC series (a candlestick or bar series).
+ * @param chart - Chart instance.
+ * @param options - Heikin Ashi configuration options.
+ * @returns The Heikin Ashi candlestick series, plus live control over its options.
+ */
+function applyHeikinAshi(series, chart, options = {}) {
+    const resolved = {
+        paneIndex: options.paneIndex ?? 0,
+        upColor: options.upColor ?? '#26a69a',
+        downColor: options.downColor ?? '#ef5350',
+        borderVisible: options.borderVisible ?? true,
+        borderUpColor: options.borderUpColor ?? '#26a69a',
+        borderDownColor: options.borderDownColor ?? '#ef5350',
+        wickVisible: options.wickVisible ?? true,
+        wickUpColor: options.wickUpColor ?? '#26a69a',
+        wickDownColor: options.wickDownColor ?? '#ef5350',
+        hideSource: options.hideSource ?? true,
+    };
+    const sourceOptions = series.options();
+    // Same price scale and the same formatting as the source: the candles are a
+    // restatement of that series, not a second instrument, so they must not
+    // autoscale on their own axis or round to a different precision.
+    const haSeries = chart.addSeries(candlestickSeries, {
+        upColor: resolved.upColor,
+        downColor: resolved.downColor,
+        borderVisible: resolved.borderVisible,
+        borderUpColor: resolved.borderUpColor,
+        borderDownColor: resolved.borderDownColor,
+        wickVisible: resolved.wickVisible,
+        wickUpColor: resolved.wickUpColor,
+        wickDownColor: resolved.wickDownColor,
+        priceScaleId: sourceOptions.priceScaleId,
+        priceFormat: sourceOptions.priceFormat,
+    }, resolved.paneIndex);
+    const sourceWasVisible = sourceOptions.visible;
+    if (resolved.hideSource === true) {
+        series.applyOptions({ visible: false });
+    }
+    const runtime = bindIndicator({
+        _internal_source: series,
+        _internal_chart: chart,
+        _internal_outputs: [haSeries],
+        _internal_label: 'Heikin Ashi',
+        _internal_options: resolved,
+        // Every option here is a colour or a toggle on the series itself, so a
+        // change never needs the transform run again.
+        _internal_recomputeOn: [],
+        _internal_compute: (data) => [
+            [haSeries, calculateHeikinAshi(data)],
+        ],
+        _internal_applyStyle: (current) => {
+            haSeries.applyOptions({
+                upColor: current.upColor,
+                downColor: current.downColor,
+                borderVisible: current.borderVisible,
+                borderUpColor: current.borderUpColor,
+                borderDownColor: current.borderDownColor,
+                wickVisible: current.wickVisible,
+                wickUpColor: current.wickUpColor,
+                wickDownColor: current.wickDownColor,
+            });
+            series.applyOptions({
+                visible: current.hideSource === true ? false : sourceWasVisible,
+            });
+        },
+    });
+    const handle = {
+        _internal_series: haSeries,
+        options: runtime.options,
+        applyOptions: runtime.applyOptions,
+        recalculate: runtime.recalculate,
+        remove: () => {
+            runtime.remove();
+            // The source outlives the indicator, so its visibility is ours to put
+            // back — otherwise removing a Heikin Ashi overlay leaves a blank chart.
+            try {
+                series.applyOptions({ visible: sourceWasVisible });
+            }
+            catch (error) {
+                // The series may already be gone if the chart was disposed
+            }
+        },
+    };
+    return handle;
+}
+
 /**
  * Apply RSI indicator to a series
  * @param series - Source series to calculate RSI from
@@ -29605,7 +29763,7 @@ const customSeriesDefaultOptions = {
  * Returns the current version as a string. For example `'1.0.0'`.
  */
 function version() {
-    return "2.0.1";
+    return "2.1.0";
 }
 
-export { areaSeries as AreaSeries, ArrowTool, barSeries as BarSeries, baselineSeries as BaselineSeries, BrushTool, candlestickSeries as CandlestickSeries, CircleTool, ColorType, CrossLineTool, CrosshairMode, DEFAULT_SESSIONS, DraggablePriceLine, DrawingToolsManager, EXTENDED_FIBONACCI_RATIOS, FibonacciCalculator, FibonacciExtensionTool, FibonacciFanTool, FibonacciTool, GanttTool, histogramSeries as HistogramSeries, HorizontalLineTool, InteractiveLineManager, LastPriceAnimationMode, lineSeries as LineSeries, LineStyle, LineType, MismatchDirection, ParallelChannelTool, PitchforkTool, PolygonTool, PositionCalculator, PositionMarkersManager, PositionTool, PriceLineSource, PriceScaleMode, RectangleTool, RulerCalculator, RulerTool, STANDARD_FIBONACCI_RATIOS, TextTool, TickMarkType, TrackingModeExitMode, TradingSessionsIndicator, TrendLineTool, VerticalLineTool, VolumeProfileIndicator, applyADX, applyATR, applyBollingerBands, applyCCI, applyDonchianChannels, applyEMA, applyIchimoku, applyKeltnerChannels, applyMACD, applyMFI, applyOBV, applyParabolicSAR, applyPivotPoints, applyRSI, applySMA, applyStochastic, applySuperTrend, applyVWAP, applyVolume, applyWMA, applyWilliamsR, calculatePipConfig, coordinateFromTime, createArrowTool, createBrushTool, createChart, createChartEx, createCircleTool, createCrossLineTool, createFibonacciExtensionTool, createFibonacciFanTool, createFibonacciTool, createGanttTool, createHorizontalLineTool, createImageWatermark, createInteractiveLineManager, createOptionsChart, createParallelChannelTool, createPitchforkTool, createPolygonTool, createPositionMarkers, createPositionTool, createRectangleTool, createRulerTool, createSeriesMarkers, createTextTool, createTextWatermark, createTradingLine, createTradingSessionsIndicator, createTrendLineTool, createUpDownMarkers, createVerticalLineTool, createVolumeProfileIndicator, createYieldCurveChart, customSeriesDefaultOptions, defaultHorzScaleBehavior, getPipConfig, isBusinessDay, isUTCTimestamp, setSeriesVolumes, setVolumeProfileData, timeFromCoordinate, version };
+export { areaSeries as AreaSeries, ArrowTool, barSeries as BarSeries, baselineSeries as BaselineSeries, BrushTool, candlestickSeries as CandlestickSeries, CircleTool, ColorType, CrossLineTool, CrosshairMode, DEFAULT_SESSIONS, DraggablePriceLine, DrawingToolsManager, EXTENDED_FIBONACCI_RATIOS, FibonacciCalculator, FibonacciExtensionTool, FibonacciFanTool, FibonacciTool, GanttTool, histogramSeries as HistogramSeries, HorizontalLineTool, InteractiveLineManager, LastPriceAnimationMode, lineSeries as LineSeries, LineStyle, LineType, MismatchDirection, ParallelChannelTool, PitchforkTool, PolygonTool, PositionCalculator, PositionMarkersManager, PositionTool, PriceLineSource, PriceScaleMode, RectangleTool, RulerCalculator, RulerTool, STANDARD_FIBONACCI_RATIOS, TextTool, TickMarkType, TrackingModeExitMode, TradingSessionsIndicator, TrendLineTool, VerticalLineTool, VolumeProfileIndicator, applyADX, applyATR, applyBollingerBands, applyCCI, applyDonchianChannels, applyEMA, applyHeikinAshi, applyIchimoku, applyKeltnerChannels, applyMACD, applyMFI, applyOBV, applyParabolicSAR, applyPivotPoints, applyRSI, applySMA, applyStochastic, applySuperTrend, applyVWAP, applyVolume, applyWMA, applyWilliamsR, calculateHeikinAshi, calculatePipConfig, coordinateFromTime, createArrowTool, createBrushTool, createChart, createChartEx, createCircleTool, createCrossLineTool, createFibonacciExtensionTool, createFibonacciFanTool, createFibonacciTool, createGanttTool, createHorizontalLineTool, createImageWatermark, createInteractiveLineManager, createOptionsChart, createParallelChannelTool, createPitchforkTool, createPolygonTool, createPositionMarkers, createPositionTool, createRectangleTool, createRulerTool, createSeriesMarkers, createTextTool, createTextWatermark, createTradingLine, createTradingSessionsIndicator, createTrendLineTool, createUpDownMarkers, createVerticalLineTool, createVolumeProfileIndicator, createYieldCurveChart, customSeriesDefaultOptions, defaultHorzScaleBehavior, getPipConfig, isBusinessDay, isUTCTimestamp, setSeriesVolumes, setVolumeProfileData, timeFromCoordinate, version };