@pipsend/charts 2.3.1 → 2.3.3

package/dist/pipsend-charts.development.mjs

@@ -1,6 +1,6 @@
 /*!
  * @license
- * Pipsend Charts v2.3.1
+ * Pipsend Charts v2.3.3
  * 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;
@@ -15464,9 +15484,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 +15503,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 +15530,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 +15565,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 +15611,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 +15626,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 +19888,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 +19916,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 +19939,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 +20028,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 +23905,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 +24050,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)}%` };
@@ -27190,7 +27124,7 @@ class BrushTool extends DrawingToolBase {
         if (this._private__isOverAnotherDrawing()) {
             return;
         }
-        const point = this._private__toPanePoint(event);
+        const point = this._private__toPanePoint(event, false);
         if (point === null) {
             return;
         }
@@ -27209,7 +27143,7 @@ class BrushTool extends DrawingToolBase {
         if (!this._private__isDrawing) {
             return;
         }
-        const point = this._private__toPanePoint(event);
+        const point = this._private__toPanePoint(event, true);
         if (point === null) {
             return;
         }
@@ -27280,13 +27214,51 @@ class BrushTool extends DrawingToolBase {
         }
         this._private__pointerId = null;
     }
-    _private__toPanePoint(event) {
+    /**
+     * Where a press lands relative to the drawing area, or null if it lands
+     * outside it. `clamp` pins the point to the edge instead, for a stroke that
+     * is already under way.
+     */
+    _private__toPanePoint(event, clamp) {
+        const area = this._private__drawArea();
+        if (area === null) {
+            return null;
+        }
+        const x = event.clientX - area._internal_left;
+        const y = event.clientY - area._internal_top;
+        if (clamp) {
+            return {
+                _internal_x: Math.max(0, Math.min(area._internal_width, x)),
+                _internal_y: Math.max(0, Math.min(area._internal_height, y)),
+            };
+        }
+        if (x < 0 || x > area._internal_width || y < 0 || y > area._internal_height) {
+            return null;
+        }
+        return { _internal_x: x, _internal_y: y };
+    }
+    /**
+     * The pane's element is the whole row, price axis cells included, so its
+     * bounds are not the drawing area's. Taking them for it is what let a press
+     * on an axis start a stroke — and be swallowed, leaving the chart unable to
+     * be stretched while the brush was armed.
+     */
+    _private__drawArea() {
         const paneElement = this._private__paneElement();
         if (paneElement === null) {
             return null;
         }
         const rect = paneElement.getBoundingClientRect();
-        return { _internal_x: event.clientX - rect.left, _internal_y: event.clientY - rect.top };
+        let left = 0;
+        let width = rect.width;
+        // The time scale measures the drawing area; the left axis, when shown, is
+        // what stands between it and the row's edge.
+        const paneWidth = this._chart.timeScale().width();
+        if (paneWidth > 0) {
+            left = this._chart.priceScale('left').width();
+            width = paneWidth;
+        }
+        return { _internal_left: rect.left + left, _internal_top: rect.top, _internal_width: width, _internal_height: rect.height };
     }
     _private__paneElement() {
         try {
@@ -27909,9 +27881,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;
@@ -28063,9 +28032,6 @@ function getPipConfig(symbolOrPrice, price) {
     };
 }
 
-/**
- * Ruler Calculator - Cálculos de distancia, pips, tiempo para mediciones
- */
 class RulerCalculator {
     constructor(pipConfig) {
         this._private__pipConfig = pipConfig;
@@ -28184,10 +28150,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);
@@ -28747,10 +28710,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);
@@ -30645,7 +30605,7 @@ const customSeriesDefaultOptions = {
  * Returns the current version as a string. For example `'1.0.0'`.
  */
 function version() {
-    return "2.3.1";
+    return "2.3.3";
 }
 
 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 };