@pipsend/charts 2.1.0 → 2.2.0

package/README.md

@@ -260,10 +260,15 @@ const ha = applyHeikinAshi(series, chart);
 ha.remove();
 ```
 
-The source series keeps its real prices and is only hidden, so indicators bound
-to it keep computing on the true OHLC, and `remove()` restores the chart exactly
-as it was — which makes this usable as a chart-type toggle. New bars pushed to
-the source are transformed automatically.
+The source series keeps its real prices and is only painted transparent, not
+hidden: indicators bound to it keep computing on the true OHLC, its price lines
+and primitives (positions, alerts, drawings) stay on screen, and `remove()`
+restores the chart exactly as it was — which makes this usable as a chart-type
+toggle. New bars pushed to the source are transformed automatically.
+
+The same trick is exported as `hideSeriesPaint(series)` for drawing any other
+view over a series: it blanks the paint, leaves the series visible to the engine,
+and returns a function that puts the paint back.
 
 Colors can be changed on a running transform, and are the candlestick ones:
 

package/dist/pipsend-charts.development.mjs

@@ -1,6 +1,6 @@
 /*!
  * @license
- * Pipsend Charts v2.1.0
+ * Pipsend Charts v2.2.0
  * Copyright (c) 2026 Pipsend
  * Licensed under MIT License
  * Built on TradingView Lightweight Charts™ (Apache 2.0)
@@ -15520,6 +15520,85 @@ function hasSeriesVolumes(series) {
     return volumes !== undefined && volumes.size > 0;
 }
 
+const TRANSPARENT = 'rgba(0, 0, 0, 0)';
+/**
+ * Take a series off the screen without hiding it.
+ *
+ * `visible: false` takes down everything hung off the series as well: its
+ * price lines, primitives and price-axis label stop rendering. A transform
+ * that only wants the bars themselves out of the way — Heikin Ashi drawing
+ * over its source — needs the series to stay visible to the engine, so its
+ * paint is made transparent instead and the last-value label and price line
+ * are switched off. Custom series have no known colours; those fall back to
+ * `visible: false`.
+ *
+ * @param series - Series to blank out.
+ * @returns Puts back the options the series had when it was blanked.
+ */
+function hideSeriesPaint(series) {
+    switch (series.seriesType()) {
+        case 'Candlestick':
+            return blank(series, {
+                upColor: TRANSPARENT,
+                downColor: TRANSPARENT,
+                borderVisible: false,
+                wickVisible: false,
+            });
+        case 'Bar':
+            return blank(series, {
+                upColor: TRANSPARENT,
+                downColor: TRANSPARENT,
+            });
+        case 'Line':
+            return blank(series, {
+                color: TRANSPARENT,
+                crosshairMarkerVisible: false,
+                pointMarkersVisible: false,
+            });
+        case 'Area':
+            return blank(series, {
+                lineColor: TRANSPARENT,
+                topColor: TRANSPARENT,
+                bottomColor: TRANSPARENT,
+                crosshairMarkerVisible: false,
+                pointMarkersVisible: false,
+            });
+        case 'Baseline':
+            return blank(series, {
+                topLineColor: TRANSPARENT,
+                topFillColor1: TRANSPARENT,
+                topFillColor2: TRANSPARENT,
+                bottomLineColor: TRANSPARENT,
+                bottomFillColor1: TRANSPARENT,
+                bottomFillColor2: TRANSPARENT,
+                crosshairMarkerVisible: false,
+                pointMarkersVisible: false,
+            });
+        case 'Histogram':
+            return blank(series, {
+                color: TRANSPARENT,
+            });
+        default:
+            return blank(series, { visible: false });
+    }
+}
+function blank(series, paint) {
+    const patch = {
+        ...paint,
+        lastValueVisible: false,
+        priceLineVisible: false,
+    };
+    const before = series.options();
+    const snapshot = {};
+    for (const key of Object.keys(patch)) {
+        snapshot[key] = before[key];
+    }
+    series.applyOptions(patch);
+    return () => {
+        series.applyOptions(snapshot);
+    };
+}
+
 /**
  * Pins a bounded indicator (RSI, Stochastic…) to a fixed price range.
  *
@@ -17216,9 +17295,9 @@ function calculateHeikinAshi(bars) {
  * 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:
+ * painted transparent — so indicators bound to it keep computing on the true
+ * OHLC, its price lines and primitives stay on screen, 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);
@@ -17260,10 +17339,16 @@ function applyHeikinAshi(series, chart, options = {}) {
         priceScaleId: sourceOptions.priceScaleId,
         priceFormat: sourceOptions.priceFormat,
     }, resolved.paneIndex);
-    const sourceWasVisible = sourceOptions.visible;
-    if (resolved.hideSource === true) {
-        series.applyOptions({ visible: false });
-    }
+    let restoreSourcePaint = null;
+    const blankSource = (blank) => {
+        if (blank && restoreSourcePaint === null) {
+            restoreSourcePaint = hideSeriesPaint(series);
+        }
+        else if (!blank && restoreSourcePaint !== null) {
+            restoreSourcePaint();
+            restoreSourcePaint = null;
+        }
+    };
     const runtime = bindIndicator({
         _internal_source: series,
         _internal_chart: chart,
@@ -17287,9 +17372,7 @@ function applyHeikinAshi(series, chart, options = {}) {
                 wickUpColor: current.wickUpColor,
                 wickDownColor: current.wickDownColor,
             });
-            series.applyOptions({
-                visible: current.hideSource === true ? false : sourceWasVisible,
-            });
+            blankSource(current.hideSource === true);
         },
     });
     const handle = {
@@ -17299,10 +17382,10 @@ function applyHeikinAshi(series, chart, options = {}) {
         recalculate: runtime.recalculate,
         remove: () => {
             runtime.remove();
-            // The source outlives the indicator, so its visibility is ours to put
+            // The source outlives the indicator, so its paint is ours to put
             // back — otherwise removing a Heikin Ashi overlay leaves a blank chart.
             try {
-                series.applyOptions({ visible: sourceWasVisible });
+                blankSource(false);
             }
             catch (error) {
                 // The series may already be gone if the chart was disposed
@@ -29370,7 +29453,7 @@ const customSeriesDefaultOptions = {
  * Returns the current version as a string. For example `'1.0.0'`.
  */
 function version() {
-    return "2.1.0";
+    return "2.2.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, 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 };
+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, hideSeriesPaint, isBusinessDay, isUTCTimestamp, setSeriesVolumes, setVolumeProfileData, timeFromCoordinate, version };