@pipsend/charts 2.3.2 → 2.3.4

package/dist/pipsend-charts.development.mjs

@@ -1,6 +1,6 @@
 /*!
  * @license
- * Pipsend Charts v2.3.2
+ * Pipsend Charts v2.3.4
  * Copyright (c) 2026 Pipsend
  * Licensed under MIT License
  * Built on TradingView Lightweight Charts™ (Apache 2.0)
@@ -2484,6 +2484,22 @@ class SeriesBarColorer {
         // Used to avoid binary search if bars are already known
         return this._private__styleGetter(this._private__findBar, this._private__series._internal_options(), barIndex, precomputedBars);
     }
+    /**
+     * Like `barStyle`, but returns null instead of throwing when the bar is
+     * gone.
+     *
+     * Recolouring walks items that were laid out against the data as it was. A
+     * bar that has since disappeared is not an error there: the view is about
+     * to be rebuilt from the new data anyway. Letting it throw took down
+     * whatever asked for the repaint — including `setData`, which left the
+     * series without its data and the pane empty until the page was reloaded.
+     */
+    _internal_barStyleOrNull(barIndex, precomputedBars) {
+        if (precomputedBars === undefined && this._private__series._internal_bars()._internal_valueAt(barIndex) === null) {
+            return null;
+        }
+        return this._internal_barStyle(barIndex, precomputedBars);
+    }
 }
 
 /**
@@ -11032,10 +11048,14 @@ class SeriesPaneViewBase {
         return this._internal__itemsVisibleRange === null ? null : this._internal__renderer;
     }
     _internal__updateOptions() {
-        this._internal__items = this._internal__items.map((item) => ({
-            ...item,
-            ...this._internal__series._internal_barColorer()._internal_barStyle(item._internal_time),
-        }));
+        const colorer = this._internal__series._internal_barColorer();
+        this._internal__items = this._internal__items.map((item) => {
+            // An item whose bar is gone keeps the colour it had. Throwing here
+            // took down whatever asked for the repaint — `setData` among them,
+            // which left the series without its data and the pane empty.
+            const style = colorer._internal_barStyleOrNull(item._internal_time);
+            return style === null ? item : { ...item, ...style };
+        });
     }
     _internal__clearVisibleRange() {
         this._internal__itemsVisibleRange = null;
@@ -11112,7 +11132,7 @@ class SeriesCustomPaneView extends SeriesPaneViewBase {
             return {
                 _internal_time: row._internal_index,
                 _internal_x: NaN,
-                ...colorer._internal_barStyle(row._internal_index),
+                ...colorer._internal_barStyle(row._internal_index, { _internal_value: row }),
                 _internal_originalData: row._internal_data,
             };
         });
@@ -12430,7 +12450,9 @@ class LinePaneViewBase extends SeriesPaneViewBase {
         const colorer = this._internal__series._internal_barColorer();
         this._internal__items = this._internal__series._internal_bars()._internal_rows().map((row) => {
             const value = row._internal_value[3 /* PlotRowValueIndex.Close */];
-            return this._internal__createRawItem(row._internal_index, value, colorer);
+            // The row travels with the point: without it the colorer looks it up
+            // again by index, and that lookup could fail and take the repaint down.
+            return this._internal__createRawItem(row._internal_index, value, colorer, row);
         });
     }
 }
@@ -12598,10 +12620,10 @@ class SeriesLinePaneView extends LinePaneViewBase {
         super(...arguments);
         this._internal__renderer = new PaneRendererLine();
     }
-    _internal__createRawItem(time, price, colorer) {
+    _internal__createRawItem(time, price, colorer, row) {
         return {
             ...this._internal__createRawItemBase(time, price),
-            ...colorer._internal_barStyle(time),
+            ...colorer._internal_barStyle(time, { _internal_value: row }),
         };
     }
     _internal__prepareRendererData() {
@@ -13075,10 +13097,10 @@ class SeriesBaselinePaneView extends LinePaneViewBase {
         this._private__baselineLineRenderer = new PaneRendererBaselineLine();
         this._internal__renderer._internal_setRenderers([this._private__baselineAreaRenderer, this._private__baselineLineRenderer]);
     }
-    _internal__createRawItem(time, price, colorer) {
+    _internal__createRawItem(time, price, colorer, row) {
         return {
             ...this._internal__createRawItemBase(time, price),
-            ...colorer._internal_barStyle(time),
+            ...colorer._internal_barStyle(time, { _internal_value: row }),
         };
     }
     _internal__prepareRendererData() {
@@ -13198,10 +13220,10 @@ class SeriesAreaPaneView extends LinePaneViewBase {
         this._private__lineRenderer = new PaneRendererLine();
         this._internal__renderer._internal_setRenderers([this._private__areaRenderer, this._private__lineRenderer]);
     }
-    _internal__createRawItem(time, price, colorer) {
+    _internal__createRawItem(time, price, colorer, row) {
         return {
             ...this._internal__createRawItemBase(time, price),
-            ...colorer._internal_barStyle(time),
+            ...colorer._internal_barStyle(time, { _internal_value: row }),
         };
     }
     _internal__prepareRendererData() {
@@ -13394,6 +13416,9 @@ class BarsPaneViewBase extends SeriesPaneViewBase {
     }
     _internal__fillRawPoints() {
         const colorer = this._internal__series._internal_barColorer();
+        // The row goes to the colorer as it is. Asking for the style by index
+        // alone made it look the row up again, and that second lookup could come
+        // back empty and throw, taking the whole repaint down with it.
         this._internal__items = this._internal__series._internal_bars()._internal_rows().map((row) => this._internal__createRawItem(row._internal_index, row, colorer));
     }
 }
@@ -13406,7 +13431,7 @@ class SeriesBarsPaneView extends BarsPaneViewBase {
     _internal__createRawItem(time, bar, colorer) {
         return {
             ...this._internal__createDefaultItem(time, bar, colorer),
-            ...colorer._internal_barStyle(time),
+            ...colorer._internal_barStyle(time, { _internal_value: bar }),
         };
     }
     _internal__prepareRendererData() {
@@ -13599,7 +13624,7 @@ class SeriesCandlesticksPaneView extends BarsPaneViewBase {
     _internal__createRawItem(time, bar, colorer) {
         return {
             ...this._internal__createDefaultItem(time, bar, colorer),
-            ...colorer._internal_barStyle(time),
+            ...colorer._internal_barStyle(time, { _internal_value: bar }),
         };
     }
     _internal__prepareRendererData() {
@@ -13767,10 +13792,10 @@ class SeriesHistogramPaneView extends LinePaneViewBase {
         super(...arguments);
         this._internal__renderer = new PaneRendererHistogram();
     }
-    _internal__createRawItem(time, price, colorer) {
+    _internal__createRawItem(time, price, colorer, row) {
         return {
             ...this._internal__createRawItemBase(time, price),
-            ...colorer._internal_barStyle(time),
+            ...colorer._internal_barStyle(time, { _internal_value: row }),
         };
     }
     _internal__prepareRendererData() {
@@ -15464,9 +15489,6 @@ function createUpDownMarkers(series, options = {}) {
     return wrapper;
 }
 
-/**
- * Gestor de marcadores de posiciones de trading
- */
 class PositionMarkersManager {
     constructor(series, options) {
         this._private__markersPlugin = null;
@@ -15486,30 +15508,20 @@ class PositionMarkersManager {
         };
         this._private__markersPlugin = createSeriesMarkers(series);
     }
-    /**
-     * Agrega una posición al gráfico
-     */
     addPosition(position) {
         this._private__positions.push(position);
         this._private__updateMarkers();
     }
-    /**
-     * Agrega múltiples posiciones al gráfico
-     */
     addPositions(positions) {
         this._private__positions.push(...positions);
         this._private__updateMarkers();
     }
-    /**
-     * Establece las posiciones (reemplaza las existentes)
-     */
+    /** Replaces every position currently on the chart. */
     setPositions(positions) {
         this._private__positions = [...positions];
         this._private__updateMarkers();
     }
-    /**
-     * Cierra una posición abierta agregando el punto de salida
-     */
+    /** Closes an open position by giving it an exit point. */
     closePosition(id, exit, exitText) {
         const position = this._private__positions.find(p => p.id === id);
         if (position) {
@@ -15523,29 +15535,17 @@ class PositionMarkersManager {
             this._private__updateMarkers();
         }
     }
-    /**
-     * Elimina una posición por ID
-     */
     removePosition(id) {
         this._private__positions = this._private__positions.filter(p => p.id !== id);
         this._private__updateMarkers();
     }
-    /**
-     * Limpia todas las posiciones
-     */
     clearPositions() {
         this._private__positions = [];
         this._private__updateMarkers();
     }
-    /**
-     * Obtiene todas las posiciones actuales
-     */
     getPositions() {
         return this._private__positions;
     }
-    /**
-     * Actualiza las opciones del gestor
-     */
     applyOptions(options) {
         if (options.longColors) {
             this._private__options.longColors = {
@@ -15570,9 +15570,6 @@ class PositionMarkersManager {
         }
         this._private__updateMarkers();
     }
-    /**
-     * Convierte las posiciones a marcadores de serie
-     */
     _private__positionsToMarkers() {
         const markers = [];
         for (const position of this._private__positions) {
@@ -15619,18 +15616,12 @@ class PositionMarkersManager {
         }
         return markers;
     }
-    /**
-     * Actualiza los marcadores en el gráfico
-     */
     _private__updateMarkers() {
         if (this._private__markersPlugin) {
             const markers = this._private__positionsToMarkers();
             this._private__markersPlugin.setMarkers(markers);
         }
     }
-    /**
-     * Desconecta el plugin y limpia recursos
-     */
     detach() {
         if (this._private__markersPlugin) {
             this._private__markersPlugin.detach();
@@ -15640,47 +15631,18 @@ class PositionMarkersManager {
     }
 }
 /**
- * Crea un gestor de marcadores de posiciones de trading
- *
- * @param series - Serie a la que se adjuntarán los marcadores
- * @param positions - Posiciones iniciales (opcional)
- * @param options - Opciones de configuración (opcional)
- * @returns Instancia del gestor de posiciones
+ * Marks trades on a series with an arrow at the entry and, once closed, at the
+ * exit.
  *
  * @example
  * ```typescript
- * // Crear el gestor
- * const positionMarkers = createPositionMarkers(candleSeries);
- *
- * // Agregar una posición long
- * positionMarkers.addPosition({
- *   type: 'long',
- *   entry: { time: '2023-01-01', price: 100.50 },
- *   exit: { time: '2023-01-05', price: 105.20 },
- *   id: 'pos-1'
- * });
- *
- * // Agregar una posición short
- * positionMarkers.addPosition({
- *   type: 'short',
- *   entry: { time: '2023-01-10', price: 110.00 },
- *   exit: { time: '2023-01-15', price: 107.50 },
- *   id: 'pos-2'
- * });
- *
- * // Agregar múltiples posiciones
- * positionMarkers.setPositions([
- *   {
+ * const markers = createPositionMarkers(candleSeries);
+ * markers.addPosition({
  *     type: 'long',
- *     entry: { time: '2023-02-01', price: 95.00 },
- *     exit: { time: '2023-02-10', price: 98.50 }
- *   },
- *   {
- *     type: 'short',
- *     entry: { time: '2023-02-15', price: 102.00 },
- *     exit: { time: '2023-02-20', price: 99.00 }
- *   }
- * ]);
+ *     entry: { time: '2023-01-01', price: 100.50 },
+ *     exit: { time: '2023-01-05', price: 105.20 },
+ *     id: 'pos-1',
+ * });
  * ```
  */
 function createPositionMarkers(series, positions, options) {
@@ -19931,9 +19893,6 @@ function createTradingLine(series, chart, options) {
     return new DraggablePriceLine(chart, series, lineOptions);
 }
 
-/**
- * Interactive Line Manager - Permite crear líneas haciendo clic en el gráfico
- */
 class InteractiveLineManager {
     constructor(chart, series) {
         this._private__container = null;
@@ -19962,10 +19921,9 @@ class InteractiveLineManager {
         return price === null ? 0 : price;
     }
     /**
-     * Activa el modo de creación de líneas por clic
-     * @param mode - Tipo de línea a crear
-     * @param customOptions - Opciones personalizadas para líneas custom
-     * @returns Promesa que se resuelve cuando el usuario hace clic
+     * Arms the chart so the next click drops a line.
+     *
+     * @returns The line, once the user has clicked.
      */
     enableClickToCreate(mode, customOptions) {
         if (!this._private__container) {
@@ -19986,9 +19944,6 @@ class InteractiveLineManager {
             this._private__container.addEventListener('click', this._private__clickHandler);
         });
     }
-    /**
-     * Desactiva el modo de creación por clic
-     */
     disableClickToCreate() {
         if (this._private__container && this._private__clickHandler) {
             this._private__container.removeEventListener('click', this._private__clickHandler);
@@ -20078,31 +20033,21 @@ class InteractiveLineManager {
         }
         return new DraggablePriceLine(this._private__chart, this._private__series, options);
     }
-    /**
-     * Obtiene el modo actual de creación
-     */
     getCreationMode() {
         return this._private__creationMode;
     }
-    /**
-     * Verifica si está en modo de creación
-     */
     isCreating() {
         return this._private__creationMode !== null;
     }
 }
 /**
- * Crea un manager interactivo para añadir líneas con clics
- * @param chart - Chart instance
- * @param series - Series instance
- * @returns InteractiveLineManager
+ * Lets the user place draggable lines by clicking the chart.
+ *
  * @example
  * ```typescript
  * const manager = createInteractiveLineManager(chart, candleSeries);
- *
- * // Activar modo de creación
  * const line = await manager.enableClickToCreate('stop-loss', {
- *     onDragEnd: (price) => console.log('SL:', price)
+ *     onDragEnd: (price) => console.log('SL:', price),
  * });
  * ```
  */
@@ -23965,9 +23910,6 @@ function createVerticalLineTool(context, options) {
     return new VerticalLineTool(context, options);
 }
 
-/**
- * Fibonacci Calculator - Cálculos de niveles de retroceso de Fibonacci
- */
 /**
  * Standard Fibonacci retracement ratios
  */
@@ -24113,10 +24055,7 @@ class FibonacciPaneView {
     }
 }
 
-/**
- * Fibonacci Retracement Tool - Herramienta para dibujar niveles de Fibonacci
- * Muestra niveles estándar: 0%, 23.6%, 38.2%, 50%, 61.8%, 78.6%, 100%
- */
+/** Draws 0, 23.6, 38.2, 50, 61.8, 78.6 and 100% unless `levels` says otherwise. */
 /** A ratio and the label it is shown with, derived rather than stored. */
 function toRatio(ratio) {
     return { _internal_ratio: ratio, _internal_label: `${(ratio * 100).toFixed(1)}%` };
@@ -27947,9 +27886,6 @@ function createTextTool(context, options) {
     return new TextTool(context, options);
 }
 
-/**
- * Position Calculator - Cálculos de P&L, pips, R:R para trading
- */
 class PositionCalculator {
     constructor(pipConfig) {
         this._private__pipConfig = pipConfig;
@@ -28101,9 +28037,6 @@ function getPipConfig(symbolOrPrice, price) {
     };
 }
 
-/**
- * Ruler Calculator - Cálculos de distancia, pips, tiempo para mediciones
- */
 class RulerCalculator {
     constructor(pipConfig) {
         this._private__pipConfig = pipConfig;
@@ -28222,10 +28155,7 @@ class RulerPaneView {
     }
 }
 
-/**
- * Measurement Ruler Tool - Herramienta para medir distancia entre dos puntos
- * Muestra pips, porcentaje, tiempo transcurrido y número de barras
- */
+/** Measures two points: pips, percent, elapsed time and bar count. */
 class RulerTool extends DrawingToolBase {
     constructor(context, options) {
         super(context, 'ruler-tool', options);
@@ -28785,10 +28715,7 @@ class PositionPaneView {
     }
 }
 
-/**
- * Position Tool - Herramienta unificada para marcar posiciones long/short
- * Muestra dos rectángulos ajustables (profit/loss) con línea vertical conectora
- */
+/** Two adjustable boxes, profit and loss, joined by a vertical connector. */
 class PositionTool extends DrawingToolBase {
     constructor(context, options) {
         super(context, 'position-tool', options);
@@ -30683,7 +30610,7 @@ const customSeriesDefaultOptions = {
  * Returns the current version as a string. For example `'1.0.0'`.
  */
 function version() {
-    return "2.3.2";
+    return "2.3.4";
 }
 
 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, PositionLine, 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, createPositionLine, createPositionMarkers, createPositionTool, createRectangleTool, createRulerTool, createSeriesMarkers, createTextTool, createTextWatermark, createTradingLine, createTradingSessionsIndicator, createTrendLineTool, createUpDownMarkers, createVerticalLineTool, createVolumeProfileIndicator, createYieldCurveChart, customSeriesDefaultOptions, defaultHorzScaleBehavior, getPipConfig, hideSeriesPaint, isBusinessDay, isUTCTimestamp, setSeriesVolumes, setVolumeProfileData, timeFromCoordinate, version };