@fintatech/fintachart 3.1.11 → 3.1.13

package/d.ts/FintaChart.d.ts

@@ -42,6 +42,28 @@ declare module FintaChart {
 }
 declare module FintaChart {
 }
+declare module FintaChart {
+    interface BBRun {
+        text: string;
+        bold: boolean;
+        italic: boolean;
+        underline: boolean;
+        color?: string;
+    }
+    class BBCode {
+        private static readonly MAX_LEN;
+        private static readonly MAX_TAGS;
+        private static readonly MAX_DEPTH;
+        private static readonly MAX_COLOR_LEN;
+        private static readonly NAMED_COLORS;
+        static parse(text: string): BBRun[][];
+        private static literal;
+        private static parseInternal;
+        private static readTag;
+        private static safeColor;
+        private static inByteRange;
+    }
+}
 declare module FintaChart {
 }
 interface Math {
@@ -382,6 +404,11 @@ declare module FintaChart {
          * @param width
          * @param height
          */
+        /**
+         * Upper bound for the device pixel ratio used when sizing canvases.
+         * Lower values trade sharpness for far cheaper fills on mobile.
+         */
+        static dprCap: number;
         static canvasRetina(canvas: HTMLCanvasElement, context: CanvasRenderingContext2D, width: number, height: number): void;
         /**
          * Returns full screen is enabled
@@ -533,6 +560,15 @@ declare module FintaChart {
          * @param value The CSS property value.
          */
         static css(el: HTMLElement, prop: string, value: string | number): void;
+        private static _rectCache;
+        private static _rectCacheStamp;
+        /**
+         * Bounding rect cached within an 8ms frame bucket.
+         *
+         * @param el The element.
+         * @return The (possibly cached) bounding rect.
+         */
+        static cachedBoundingRect(el: HTMLElement): DOMRect;
         /**
          * Converts client (viewport) coordinates to local element coordinates.
          *
@@ -698,6 +734,8 @@ declare module FintaChart {
         destroy(): void;
         /** Enables or disables dragging. */
         setEnabled(enabled: boolean): void;
+        /** Re-clamps the element inside its containment (e.g. after a resize). */
+        reclamp(): void;
     }
     /**
      * Makes an element draggable using native pointer events.
@@ -900,7 +938,7 @@ declare module FintaChart {
          * @param chart
          * @return
          */
-        toolbar(chart?: Chart): Toolbar;
+        toolbar(chart?: Chart | IToolbarConfig): Toolbar;
         /**
          * Returns toolbar drop down button
          *
@@ -2446,6 +2484,10 @@ declare module FintaChart {
          * Event object
          */
         evt: Event;
+        /**
+         * Overrides the native (read-only) `which` button value.
+         */
+        which?: number;
         /**
          * Pane
          */
@@ -2783,6 +2825,9 @@ declare module FintaChart {
          */
         constructor(config?: IContextMenuMotionEventConfig);
         handleEvent(event: IWindowEvent): boolean;
+        /**
+         * Creates lightweight event snapshot.
+         */
         private snapshot;
         private finish;
         private startTimer;
@@ -2895,6 +2940,7 @@ declare module FintaChart {
         private _lastScale;
         private _prevScale;
         private _scaleThreshold;
+        private _wheelDeltaAccum;
         /**
          * Delta
          */
@@ -3770,6 +3816,12 @@ declare module FintaChart {
         set htmlDialogs(value: string);
     }
     const UserAgent: IUserAgent;
+    /**
+     * Updates device mode at runtime.
+     *
+     * @param isMobile Whether the chart should behave as a mobile device.
+     */
+    function setMobile(isMobile: boolean): void;
 }
 declare module FintaChart {
     /**
@@ -3882,6 +3934,7 @@ declare module FintaChart {
         private _lineDashFunc;
         private _canvas;
         private _context;
+        private _linearGradientCache;
         /**
          * Get canvas
          */
@@ -4751,6 +4804,8 @@ declare module FintaChart {
         private _canvasEl;
         private _parentEl;
         private _renderer;
+        private _sizeCache;
+        private _sizeCacheStamp;
         /**
          * The canvas element.
          */
@@ -5348,14 +5403,29 @@ declare module FintaChart {
          * Control Drag Pane's root container
          */
         protected rootContainer: HTMLElement;
-        /**
-         * Draggable controller instance
-         */
-        private _draggableController;
         /**
          * Bound resize handler reference for cleanup
          */
         private _resizeHandler;
+        /**
+         * Whether the pane has been placed at its initial position
+         */
+        private _positioned;
+        /**
+         * Pointer offset from the pane top-left at drag start
+         */
+        private _dragOffsetX;
+        private _dragOffsetY;
+        /**
+         * Bound drag handlers for cleanup
+         */
+        private _onDragStart;
+        private _onDragMove;
+        private _onDragEnd;
+        /**
+         * Drag handle element
+         */
+        private _handleEl;
         get visible(): boolean;
         /**
          * Creates an instance of DragPane.
@@ -5376,7 +5446,18 @@ declare module FintaChart {
          * Shows Control Drag Pane
          */
         protected show(): void;
-        private adjustPosition;
+        /** Returns the offsetParent rect the pane is positioned against. */
+        private parentRect;
+        /** Places the pane near the top-center of the chart. */
+        private placeInitial;
+        private onDragStart;
+        private onDragMove;
+        private onDragEnd;
+        /** Sets absolute position within the offsetParent, clamped inside it. */
+        private applyPosition;
+        private clampIntoViewport;
+        private eventPoint;
+        private teardownDrag;
         private onResize;
     }
 }
@@ -6041,6 +6122,206 @@ declare module FintaChart {
         private unsubscribe;
     }
 }
+declare module FintaChart {
+    class ToolbarCalendar {
+        private _chart;
+        private _element;
+        private _onSelect;
+        private _selected;
+        private _viewYear;
+        private _viewMonth;
+        private _months;
+        private _weekdaysShort;
+        private _clearText;
+        private _todayText;
+        constructor(chart: Chart, host: HTMLElement);
+        get isVisible(): boolean;
+        /**
+         * Shows the calendar for the given selection.
+         *
+         * @param selected Currently selected date, highlighted in the grid.
+         * @param onSelect Invoked with the picked date, or `null` when cleared.
+         */
+        show(selected: Date | null, onSelect: (date: Date | null) => void): void;
+        hide(): void;
+        private _loadLocalization;
+        private _localize;
+        private _splitLocalized;
+        private _render;
+        private _renderHeader;
+        private _renderNavButton;
+        private _renderGrid;
+        private _renderDay;
+        private _renderFooter;
+        private _pick;
+        private _isSameDay;
+        private _shiftMonth;
+    }
+}
+declare module FintaChart {
+    /**
+     * Identifier for a single toolbar button or group.
+     * Names match tooltip hints for discoverability.
+     */
+    enum ToolbarItem {
+        /** Options — hint */
+        Theme = "theme",
+        /** Options alias */
+        Options = "options",
+        /** Instrument — hint */
+        InstrumentSearch = "instrumentSearch",
+        /** Instrument alias */
+        Instrument = "instrument",
+        /** Timeframes — hint */
+        TimeFramePicker = "timeFramePicker",
+        /** Timeframes alias */
+        Timeframes = "timeframes",
+        /** Indicators */
+        Indicators = "indicators",
+        /** Candles — hint for ChartType */
+        ChartType = "chartType",
+        /** Candles alias */
+        Candles = "candles",
+        /** Compare — hint */
+        CompareInstrument = "compareInstrument",
+        /** Compare alias */
+        Compare = "compare",
+        /** Cursor options — hint */
+        CrossHair = "crossHair",
+        /** Cursor alias */
+        Cursor = "cursor",
+        /** CursorOptions alias */
+        CursorOptions = "cursorOptions",
+        /** Templates */
+        Templates = "templates",
+        /** Adjustment — hint */
+        Adjust = "adjust",
+        /** Adjustment alias */
+        Adjustment = "adjustment",
+        /** OHLC Pane — hint */
+        Ohlc = "ohlc",
+        /** OHLC Pane alias */
+        OhlcPane = "ohlcPane",
+        /** OHLC Cards — hint */
+        OhlcCard = "ohlcCard",
+        /** OHLC Cards alias */
+        OhlcCards = "ohlcCards",
+        /** Bar replay — hint */
+        ReplayMode = "replayMode",
+        /** BarReplay alias */
+        BarReplay = "barReplay",
+        /** Trading — hint */
+        TradePanel = "tradePanel",
+        /** Trading alias */
+        Trading = "trading",
+        /** Undo */
+        Undo = "undo",
+        /** Redo */
+        Redo = "redo",
+        /** Save as Image — hint */
+        Snapshot = "snapshot",
+        /** SaveImage alias */
+        SaveImage = "saveImage",
+        /** Export */
+        Export = "export",
+        /** View Mode */
+        ViewMode = "viewMode",
+        /** Trendlines — hint */
+        Geometrical = "geometrical",
+        /** Trendlines alias */
+        Trendlines = "trendlines",
+        /** Shapes — hint */
+        Patterns = "patterns",
+        /** Shapes alias */
+        Shapes = "shapes",
+        /** Scribble — hint name */
+        Scribble = "scribble",
+        /** FreeHand — code name, alias for Scribble */
+        FreeHand = "freeHand",
+        /** Fibonacci tools — hint */
+        Fibonacci = "fibonacci",
+        /** FibonacciTools alias */
+        FibonacciTools = "fibonacciTools",
+        /** Trend Channel Shapes — hint */
+        TrendLines = "trendLines",
+        /** TrendChannelShapes alias */
+        TrendChannelShapes = "trendChannelShapes",
+        /** Etc. Shapes — hint */
+        LabelShapes = "labelShapes",
+        /** EtcShapes alias */
+        EtcShapes = "etcShapes",
+        /** Visible Profile — hint */
+        ProfileDrawing = "profileDrawing",
+        /** ProfileTool alias */
+        ProfileTool = "profileTool",
+        /** Text */
+        Text = "text",
+        /** Bar Marker */
+        BarMarker = "barMarker",
+        /** Balloon */
+        Balloon = "balloon",
+        /** Measure */
+        Measure = "measure",
+        /** Positions */
+        Positions = "positions",
+        /** Zoom — hint */
+        ZoomIn = "zoomIn",
+        /** Zoom alias */
+        Zoom = "zoom",
+        /** In Shape Mode — hint */
+        StayInShapeMode = "stayInShapeMode",
+        /** InShapeMode alias */
+        InShapeMode = "inShapeMode",
+        /** Magnet — hint */
+        MagnetMode = "magnetMode",
+        /** Magnet alias */
+        Magnet = "magnet",
+        /** Lock — hint */
+        LockMode = "lockMode",
+        /** Lock alias */
+        Lock = "lock",
+        /** Hide drawings — hint */
+        HideOptions = "hideOptions",
+        /** HideDrawings alias */
+        HideDrawings = "hideDrawings",
+        /** Remove Selected Shape — hint */
+        Delete = "delete",
+        /** RemoveShape alias */
+        RemoveShape = "removeShape",
+        /** General Shapes — hint */
+        Miscellaneous = "miscellaneous",
+        /** GeneralShapes alias */
+        GeneralShapes = "generalShapes",
+        /** Date Range */
+        DateRange = "dateRange",
+        /** Sessions — hint */
+        TradingSession = "tradingSession",
+        /** Sessions alias */
+        Sessions = "sessions",
+        /** Log scale — hint */
+        ScaleLog = "scaleLog",
+        /** Log alias */
+        Log = "log",
+        /** Percent scale — hint */
+        ScalePercent = "scalePercent",
+        /** Percent alias */
+        Percent = "percent",
+        /** Auto scale — hint */
+        ScaleAuto = "scaleAuto",
+        /** Auto alias */
+        Auto = "auto",
+        /** Scroll to last bar */
+        ScrollToLastBar = "scrollToLastBar"
+    }
+    /** Config can be array or map */
+    type ToolbarHiddenItems = ToolbarItem[] | Partial<Record<ToolbarItem, boolean>>;
+    /** Normalize array or map to array */
+    function toolbarHiddenItemsToArray(input?: ToolbarHiddenItems | null): ToolbarItem[];
+    /**
+     * CSS selector for each ToolbarItem inside Toolbar container.
+     */
+    const ToolbarItemSelectors: Record<ToolbarItem, string>;
+}
 declare module FintaChart {
     /**
      * Represents Toolbar Config
@@ -6059,6 +6340,10 @@ declare module FintaChart {
          * Is show view mode
          */
         showViewMode?: boolean;
+        /**
+         * Toolbar items to hide — array or map
+         */
+        toolbarHiddenItems?: ToolbarHiddenItems;
     }
     /**
      * Provides model of Toolbar
@@ -6080,7 +6365,17 @@ declare module FintaChart {
         private _logScaleBtn;
         private _percentScaleBtn;
         private _lockShapesBtn;
+        private _dateRangeButtons;
+        private _dateRangeMenuItems;
+        private _applyingDateRangePreset;
+        private _dateRangeFrom;
+        private _dateRangeTo;
+        private _openDateRangePopup;
+        private _dateRangeResizeObserver;
+        private _dateRangeInlineWidth;
         private _scalePercentageAdapter;
+        private _toolbarHiddenItems;
+        private _appliedHiddenSelectors;
         onAmountChanged: (quantity: number) => void;
         /**
          * Creates an instance of Toolbar.
@@ -6114,6 +6409,16 @@ declare module FintaChart {
         getSearchInstrumentInput(): HTMLElement;
         lock(): void;
         dispose(): void;
+        /** Get hidden toolbar items */
+        getToolbarHiddenItems(): ToolbarItem[];
+        /** Set hidden toolbar items and reapply */
+        setToolbarHiddenItems(items: ToolbarHiddenItems): void;
+        /** Hide/show toolbar elements via config */
+        private applyToolbarVisibility;
+        private setElementsVisibility;
+        private cleanupToolbarDividers;
+        private findPrevVisibleSibling;
+        private findNextVisibleSibling;
         /**
          * Prepends Toolbar to
          *
@@ -6126,6 +6431,26 @@ declare module FintaChart {
         supportedTimeFramesShow(): void;
         private _createPeriodicityForm;
         private _subscribeToCreateCustomTimeFrame;
+        private _subscribeDateRangeControls;
+        private onDocumentTap;
+        private _subscribeCollapsedDateRange;
+        private _observeDateRangeWidth;
+        private _subscribeCustomDateRange;
+        private updateDateRangeApplyState;
+        private formatDisplayDate;
+        private truncateToDay;
+        private endOfDay;
+        /**
+         * Applies a bottom-toolbar date-range preset (1D, 5D, ..., All).
+         *
+         * @param presetKey
+         */
+        applyDateRangePreset(presetKey: string): void;
+        private applyDateRange;
+        private setActiveDateRangeButton;
+        private closestSupportedTimeFrame;
+        private parseSupportedTimeFrame;
+        private addToDate;
         setTimeFrame(timeFrame: TimeFrame): void;
         /**
          * Refresh toolbar components depend to size
@@ -6136,7 +6461,7 @@ declare module FintaChart {
         /**
          * Update trade panel units value
          *
-         * @param quantity
+         * @param quantity default quantity expressed in units (backend contract)
          */
         updateTradeHandlerUnits(quantity: number): void;
         private activateStayInShapeModeBtn;
@@ -6155,6 +6480,8 @@ declare module FintaChart {
         private onCrossHairChange;
         private onDeleteClick;
         private onHideOptionClick;
+        /** Reflects the hide buttons' active class from real chart state. */
+        private syncHideButtonsState;
         onIndicatorsClick(): void;
         applyIndicator(typeName: string): void;
         private onInstrumentChange;
@@ -6297,6 +6624,13 @@ declare module FintaChart {
         private hideDropDown;
         private init;
         private setValue;
+        /**
+         * Handles a tap/click on the button head, routing to toggle, fire or
+         * drop-down open depending on the button configuration and platform.
+         *
+         * @param e The originating tap/click event.
+         */
+        private handleHeadTap;
         private showDropDown;
         private toggleButton;
         private toggleDropDown;
@@ -7425,6 +7759,10 @@ declare module FintaChart {
          * Cross Hair State's cross hair type
          */
         type: string;
+        /**
+         * Cross Hair State's show bar offset
+         */
+        showBarOffset?: boolean;
     }
     /**
      * Represents Cross Hair Config
@@ -7434,6 +7772,10 @@ declare module FintaChart {
          * Cross Hair Config cross hair type
          */
         type?: string;
+        /**
+         * Cross Hair Config show bar offset
+         */
+        showBarOffset?: boolean;
     }
     enum CrossHairType {
         NONE = "none",
@@ -7468,6 +7810,14 @@ declare module FintaChart {
          * Set Cross Hair's type
          */
         set type(type: string);
+        /**
+         * Get Cross Hair's show bar offset
+         */
+        get showBarOffset(): boolean;
+        /**
+         * Set Cross Hair's show bar offset
+         */
+        set showBarOffset(value: boolean);
         /**
          * Creates an instance of CrossHair.
          *
@@ -8997,6 +9347,20 @@ declare module FintaChart {
     /**
      * Represents indicator state
      */
+    /**
+     * A single indicator plot value for the OHLC card.
+     */
+    interface IIndicatorHoverValue {
+        name: string;
+        color: string;
+        value: string;
+    }
+    interface IIndicatorTitleItem {
+        text: string;
+        tooltip?: string;
+        color?: string;
+        values?: number[];
+    }
     interface IIndicatorState {
         id?: string;
         parentId?: string;
@@ -9093,6 +9457,11 @@ declare module FintaChart {
         private _hovered;
         private _id;
         private _lineLevels;
+        private _indicatorShapes;
+        private _shapesById;
+        private _shapesPanes;
+        private _shapesForcePricePane;
+        private _shapesFullyAttached;
         private _requireDefaults;
         private _optionsTitle;
         private _parametersContextMenu;
@@ -9103,6 +9472,8 @@ declare module FintaChart {
         private _alertTitle;
         private _selected;
         private _titleControls;
+        private _titleItems;
+        private _titleItemViews;
         private _toggleTitleVisibility;
         private _values;
         private _titleContextMenu;
@@ -9148,6 +9519,7 @@ declare module FintaChart {
         get theme(): any;
         set theme(value: any);
         get lineLevels(): any[];
+        get indicatorShapes(): Shape[];
         /**
          * Allow setting dialog state
          */
@@ -9322,6 +9694,17 @@ declare module FintaChart {
          * @param pointY
          */
         addLine(color: string, pointY: number): void;
+        setTitleItems(items: IIndicatorTitleItem[]): void;
+        addShape(state: IShapeState): Shape | null;
+        setIndicatorShapes(states: IShapeState[], opts?: {
+            onPricePane?: boolean;
+        }): void;
+        upsertIndicatorShapes(states: IShapeState[]): void;
+        private removeIndicatorShape;
+        removeIndicatorShapes(): void;
+        private isPixelAnchoredShape;
+        private routeAndAttach;
+        private attachIndicatorShapes;
         /**
          * Add plot
          *
@@ -9418,6 +9801,13 @@ declare module FintaChart {
          */
         updateHoverRecord(record?: number): void;
         getValues(): DataRowsCollection;
+        /**
+         * Per-plot values at a record for the OHLC card.
+         *
+         * @param record Record index; defaults to hovered record.
+         * @return One { name, color, value } per plot.
+         */
+        hoverValues(record?: number): IIndicatorHoverValue[];
         /**
          * Update visibility of title elements
          */
@@ -9455,6 +9845,22 @@ declare module FintaChart {
          * Retrieve if needs custom scale
          */
         protected needsCustomScale(): boolean;
+        /**
+         * Retrieve if the plots must stay out of the vertical auto scale.
+         *
+         * Script-driven indicators report whatever the script emits, which is not
+         * necessarily comparable with the price (a script that keeps `IsOverlay`
+         * on while plotting zeros drags the price scale minimum down to zero).
+         * The scale range also gates zoom and scroll, so such values do not only
+         * squash the candles - they lock the vertical axis as well.
+         *
+         * Only applies while the indicator actually shares the price pane scale:
+         * on its own pane, or bound to its own scale, its plots are the only
+         * input that scale has and excluding them would leave nothing to scale by.
+         *
+         * Override in a subclass to opt a custom indicator back in.
+         */
+        protected excludeFromPriceAutoScale(): boolean;
         /**
          * Refresh item by number
          *
@@ -9467,6 +9873,17 @@ declare module FintaChart {
         private histogramTheme;
         private initIndicator;
         private initPaneTitle;
+        private rebuildTitleItems;
+        /**
+         * Renders BBCode markup (as produced by the script engine's SetTitle) into the legend span.
+         * Falls back to plain text if the markup carries no formatting.
+         */
+        private renderTitleItemText;
+        /**
+         * Tooltips live in a title attribute, which cannot carry markup - keep the text, drop the tags.
+         */
+        private static stripBBCode;
+        private updateTitleItemValues;
         private setCustomScale;
         protected subscribe(): void;
         protected unsubscribe(): void;
@@ -13262,6 +13679,56 @@ declare module FintaChart {
         NORMAL = "normal",
         AUTOSCALED = "autoscaled"
     }
+    /**
+     * Describes the payload of the click events fired by a pane and by the chart.
+     *
+     * Delivered as the `value` field of the event object:
+     * `chart.on(ChartEvent.CLICKED, e => console.log(e.value.price, e.value.date))`
+     */
+    interface IChartClickInfo {
+        /**
+         * The pane the click happened in.
+         */
+        pane: Pane;
+        /**
+         * Whether the clicked pane is the main (price) pane.
+         */
+        isPrimaryPane: boolean;
+        /**
+         * The date under the click position.
+         */
+        date: Date;
+        /**
+         * The formatted date, as shown on the horizontal axis.
+         */
+        dateText: string;
+        /**
+         * The index of the bar (record) under the click position.
+         * May be out of the data range when clicking the empty space right of the last bar.
+         */
+        bar: number;
+        /**
+         * The value of the pane's main vertical scale under the click position.
+         * On the primary pane this is the price, on an indicator pane it is the indicator value.
+         */
+        price: number;
+        /**
+         * The formatted price, as shown on the vertical axis.
+         */
+        priceText: string;
+        /**
+         * The click x coordinate, in chart coordinates.
+         */
+        x: number;
+        /**
+         * The click y coordinate, relative to the clicked pane.
+         */
+        y: number;
+        /**
+         * The original DOM event.
+         */
+        nativeEvent: Event;
+    }
     const PaneEvent: {
         THEME_CHANGED: string;
         X_GRID_VISIBLE_CHANGED: string;
@@ -13274,6 +13741,7 @@ declare module FintaChart {
         OBJECT_REMOVED: string;
         DOUBLE_CLICKED: string;
         CONTEXT_MENU: string;
+        CLICKED: string;
     };
     let formatConfig: any;
     /**
@@ -13540,6 +14008,19 @@ declare module FintaChart {
         containsShape(shape: Shape): boolean;
         dispose(): void;
         paint(): void;
+        /**
+         * Returns true when a shape is fully outside the visible frame and
+         * safe to skip. Extrapolated shapes (lines/rays) and selected shapes
+         * are never culled since they can extend across the viewport.
+         */
+        private isShapeOffscreen;
+        /** Shape types that extend beyond their points and must not be culled. */
+        private static NON_CULLABLE_SHAPES;
+        static pGrid: number;
+        static pObjects: number;
+        static pIndicators: number;
+        static pHover: number;
+        static pWatermark: number;
         /**
          * Executes shapes
          *
@@ -13698,7 +14179,15 @@ declare module FintaChart {
          * @param record
          * @return
          */
+        private _lastHoverKey;
         updateHoverRecord(record?: number): void;
+        /**
+         * Fills the OHLC card indicator rows for the hovered record.
+         *
+         * @param control The card's bar-info control.
+         * @param record  The hovered record index.
+         */
+        private renderOhlcCardIndicators;
         /**
          * Renders the live graphics of an OHLC info card: the volume bar (as a
          * fraction of the max visible volume) and the price sparkline (the last
@@ -13747,6 +14236,13 @@ declare module FintaChart {
         private getHeight;
         private getWidth;
         private onClick;
+        /**
+         * Fires PaneEvent.CLICKED and ChartEvent.CLICKED with the date and the value
+         * under the click position.
+         *
+         * @param event
+         */
+        private invokeClickEvent;
         onContextMenu(motionEvent: MotionEvent, event: IWindowEvent): void;
         private onDoubleClick;
         private onMouseHover;
@@ -15014,6 +15510,12 @@ declare module FintaChart {
         private writeBlobToClipboard;
         private fallbackDownload;
         private showChartMessage;
+        /**
+         * Composites the chart's own canvas layers into one bitmap.
+         * Far cheaper than serializing the whole DOM. Returns null when
+         * no canvases are found so the caller can fall back.
+         */
+        private compositeCanvasLayers;
         private createSnapshot;
         private saveImage;
         /**
@@ -15781,6 +16283,17 @@ declare module FintaChart {
          * Enable scale vertical labels
          */
         enableVerticalAxisLabels: boolean;
+        /**
+         * Keeps the plot out of the vertical auto scale calculation.
+         *
+         * The plot is still painted, but its values never widen the value range
+         * of the scale it is bound to. Intended for plots whose values are not
+         * comparable with the rest of the scale (e.g. a custom script overlay
+         * that reports zeros on the price pane), where letting them participate
+         * would squash the primary data and, because the same range gates
+         * zoom/scroll, lock the axis.
+         */
+        excludeFromAutoScale: boolean;
         /**
          * Stretch pricing lines
          */
@@ -15813,6 +16326,33 @@ declare module FintaChart {
          * Show pricing lines
          */
         showPricingLines: boolean;
+        /**
+         * Number of bars to project into the future beyond the last real bar.
+         * Lines are drawn with a dashed style.
+         */
+        projectionBarsCount?: number;
+        /**
+         * Projection formula type:
+         * - 'trend' (default): linear extrapolation by last two points: Y = Y_last + deltaY * N
+         * - 'flat': horizontal extension Y = Y_last
+         * - 'damped': Y_i = Y_{i-1} + deltaY * gamma^i, gamma in (0.8..0.95)
+         * - 'regression': linear regression Y = a + b*X over last N bars
+         * - 'sma': iterative SMA Y_future = avg(k) over real_or_future values
+         * - 'polynomial': quadratic Y = a*i^2 + b*i + c over last N bars
+         */
+        projectionType?: string;
+        /**
+         * Damping coefficient gamma for 'damped' projection (0.8..0.95, default 0.9)
+         */
+        projectionDamping?: number;
+        /**
+         * Period for regression / polynomial fits (default 20)
+         */
+        projectionRegressionPeriod?: number;
+        /**
+         * Period for SMA projection (default 14)
+         */
+        projectionSmaPeriod?: number;
     }
     /**
      * Represents plot config
@@ -15931,6 +16471,10 @@ declare module FintaChart {
          * Open
          */
         open: number[];
+        /**
+         * Conflation step — draw every Nth bar when sub-pixel.
+         */
+        step: number;
     }
     /**
      * Represents plot defaults
@@ -16061,6 +16605,11 @@ declare module FintaChart {
          */
         get isVolume(): boolean;
         set isVolume(value: boolean);
+        /**
+         * Get is excluded from the vertical auto scale calculation
+         */
+        get excludeFromAutoScale(): boolean;
+        set excludeFromAutoScale(value: boolean);
         /**
          * Creates an instance of Plot.
          *
@@ -16504,6 +17053,7 @@ declare module FintaChart {
         private paintSmoothedAreaLine;
         private paintSmoothShape;
         private paintSmoothedSimpleLine;
+        private paintProjectionLine;
     }
 }
 declare module FintaChart {
@@ -17399,7 +17949,6 @@ declare module FintaChart {
         private updateCoordinateMapper;
         private autoScroll;
         private refresh;
-        private animateZoom;
     }
 }
 declare module FintaChart {
@@ -19404,6 +19953,7 @@ declare module FintaChart {
         private onPress;
         private onMouseHoverInternal;
         private onMoveInternal;
+        private processMoveStep;
         private initMotionEvents;
         private clickHitTest;
         private moveHitTest;
@@ -20654,7 +21204,7 @@ declare module FintaChart {
      */
     class TextShape extends Shape {
         static get type(): string;
-        private _lines;
+        private _parsed;
         /**
          * Creates an instance of TextShape.
          *
@@ -20673,7 +21223,124 @@ declare module FintaChart {
         restoreState(state: IShapeState): void;
         pointsLocalizationKeys(): string[];
         protected paintHovered(oldTheme: any): any;
+        private get baseTextTheme();
         private updateLines;
+        private deriveRunTheme;
+        private measureLineWidth;
+    }
+}
+declare module FintaChart {
+    /**
+     * Describes bar marker shape config.
+     */
+    interface IBarMarkerShapeConfig extends ITextShapeConfig {
+        /**
+         * Marker position relative to the bar: 'above' or 'below'
+         */
+        position?: string;
+        /**
+         * Marker shape: 'dot', 'arrowUp' or 'arrowDown'
+         */
+        marker?: string;
+    }
+    /**
+     * Describes bar marker shape options.
+     */
+    interface IBarMarkerShapeOptions extends ITextShapeOptions {
+        /**
+         * Marker position relative to the bar
+         */
+        position?: string;
+        /**
+         * Marker shape
+         */
+        marker?: string;
+    }
+    /**
+     * Describes bar marker shape defaults.
+     */
+    interface IBarMarkerShapeDefaults extends IShapeDefaults {
+        /**
+         * Default text label
+         */
+        text: string;
+        /**
+         * Default marker position
+         */
+        position: string;
+        /**
+         * Default marker shape
+         */
+        marker: string;
+    }
+    const BarMarkerPosition: {
+        ABOVE: string;
+        BELOW: string;
+    };
+    const BarMarkerKind: {
+        DOT: string;
+        ARROW_UP: string;
+        ARROW_DOWN: string;
+    };
+    /**
+     * Represents a dot (or arrow) with text attached to a bar from above or below.
+     * Uses the Shape Text behavior: click to place on a bar, then edit the text in the settings dialog.
+     *
+     * @category Shapes
+     */
+    class BarMarkerShape extends TextShape {
+        static get type(): string;
+        static get subType(): string;
+        static defaults: IBarMarkerShapeDefaults;
+        /**
+         * Creates an instance of BarMarkerShape.
+         *
+         * @param config
+         */
+        constructor(config?: IBarMarkerShapeConfig);
+        protected get defaults(): IBarMarkerShapeDefaults;
+        /**
+         * Marker position relative to the bar
+         */
+        get position(): string;
+        set position(value: string);
+        /**
+         * Marker shape kind
+         */
+        get marker(): string;
+        set marker(value: string);
+        get resizable(): boolean;
+        set resizable(_value: boolean);
+        get magnetMode(): string;
+        set magnetMode(_value: string);
+        get magnetPoint(): string;
+        set magnetPoint(_value: string);
+        /**
+         * The label text ('E' by default when empty)
+         */
+        get text(): string;
+        set text(value: string);
+        finishNewShape(): void;
+        bounds(): IBounds;
+        paint(): void;
+        hitTest(point: IPoint): boolean;
+        /**
+         * Auto-detects position and color from the bar type:
+         * bullish (close >= open) — green marker above high,
+         * bearish (close < open) — red marker below low.
+         */
+        private getBarDetails;
+        /**
+         * Snaps the shape point to the nearest bar on creation:
+         * X is aligned to the bar center, Y is placed above high (or below low)
+         * depending on the bar direction.
+         */
+        private snapToBar;
+        /**
+         * Computes pixel layout of the marker relative to its bar for the current frame
+         */
+        private markerLayout;
+        protected magnetizePoint(point: IPoint): IPoint;
     }
 }
 declare module FintaChart {
@@ -22079,6 +22746,10 @@ declare module FintaChart {
         private generateList;
         deleteTemplate(key: string): void;
         selectTemplate(key: string): void;
+        /** Fixed-positions the dropdown so the pane cell does not clip it. */
+        private positionDropList;
+        /** Clears inline fixed-positioning so the closed dropdown returns to flow. */
+        private resetDropListPosition;
         private resetFibonacciLevels;
     }
 }
@@ -22880,6 +23551,14 @@ declare module FintaChart {
         private _takeProfitLine;
         private _stTpLine;
         private _selected;
+        /**
+         * Instance text width for kind.
+         */
+        private _kindTextWidth;
+        /**
+         * Instance text width for quantity.
+         */
+        private _quantityTextWidth;
         /**
          * Gets/Set position.
          */
@@ -23589,6 +24268,10 @@ declare module FintaChart {
          * Cross hair type
          */
         crossHair?: string;
+        /**
+         * Cross hair show bar offset
+         */
+        showCrossHairBarOffset?: boolean;
         /**
          * Chart DataFeed
          */
@@ -23703,6 +24386,10 @@ declare module FintaChart {
         showLogoWatermark?: boolean;
         useNewBrandedWatermark?: boolean;
         isChartWidget?: boolean;
+        /**
+         * Toolbar items to hide — array or map
+         */
+        toolbarHiddenItems?: ToolbarHiddenItems;
     }
     /**
      * Represents chart options
@@ -23744,6 +24431,10 @@ declare module FintaChart {
          * Is show chart bar info in title
          */
         showBarInfoInTitle: boolean;
+        /**
+         * Is show indicator legend/titles
+         */
+        showIndicatorLegend?: boolean;
         /**
          * Is show chart instrument watermark
          */
@@ -23864,6 +24555,14 @@ declare module FintaChart {
         Fok = "fok",
         Ioc = "ioc"
     }
+    /**
+     * Rendering quality: trades sharpness for paint speed on weak devices.
+     */
+    enum RenderQuality {
+        LOW = "low",
+        MEDIUM = "medium",
+        HIGH = "high"
+    }
     /**
      * Provides model of min and max
      */
@@ -23960,10 +24659,15 @@ declare module FintaChart {
         CHANGE_VISIBILITY_EXECUTION: string;
         ORDER_FEATURES_CHANGED: string;
         LOGO_WATERMARK_CLICKED: string;
+        CLICKED: string;
     };
     const DEFAULT_BARS_COUNT = 500;
     const DEFAULT_MORE_BARS_COUNT = 1000;
     const DEFAULT_QUANTITY = 1;
+    interface IDateRangeSelection {
+        startDate: Date | null;
+        endDate: Date | null;
+    }
     const version = "2.0.0";
     enum AutoScalePanesKind {
         AllPanes = 0,
@@ -24001,6 +24705,8 @@ declare module FintaChart {
         private _lastObservedWidth;
         private _lastObservedHeight;
         private _resizeRafPending;
+        private _windowResizeRafPending;
+        private _renderQuality;
         private readonly _indicatorAlertsHandler;
         private readonly _addThemeCssClass;
         private readonly _barCountdown;
@@ -24017,11 +24723,21 @@ declare module FintaChart {
         readonly toolbar: Toolbar;
         readonly tradeHandler: ITradeHandlerCallback;
         readonly datafeed: IDatafeedBase;
+        toolbarHiddenItems?: ToolbarHiddenItems;
+        /** Get hidden toolbar items as array */
+        getToolbarHiddenItems(): ToolbarItem[];
+        /** Set hidden toolbar items and update toolbar */
+        setToolbarHiddenItems(items: ToolbarHiddenItems): void;
         undoRedo: UndoRedoController;
         shapeSettings: ShapeSettingsDragPane;
         canLoadMoreBars: boolean;
         hoveredObject: IChartObject;
-        isMoving: boolean;
+        private _isMoving;
+        /**
+         * True while a gesture (shape drag / chart scroll) is in progress.
+         */
+        get isMoving(): boolean;
+        set isMoving(value: boolean);
         _suppressMeasureTool: boolean;
         multiChartRootContainer: HTMLElement;
         preventMouseEvents: boolean;
@@ -24083,12 +24799,20 @@ declare module FintaChart {
         private _lockShapes;
         private _pendingTimeFrameRangeClamp;
         private _pendingInstrumentChangeDateRange;
+        private _pendingDateRangeSelection;
+        private _dateRangeSelectionToken;
         private _lastBid;
         private _lastAsk;
         private _conversionRate;
         private _touchPanActive;
         private _touchPanLastX;
+        private _gestureTimer;
         get isTouchPanActive(): boolean;
+        /**
+         * Caps repaint frequency during gestures (~30fps on mobile).
+         */
+        private updateGestureRefresh;
+        markGestureActive(): void;
         get conversionRate(): {
             ask: number;
             bid: number;
@@ -24133,6 +24857,13 @@ declare module FintaChart {
         get timezone(): ITimezone | null;
         set timezone(data: ITimezone | null);
         constructor(config: IChartConfig);
+        /**
+         * Dev-only on-screen FPS / frame-time meter, shown only on localhost.
+         * A small toggle button is placed at the right edge; clicking it starts
+         * an independent rAF loop that measures the real display frame rate
+         * (independent of the RefreshOptimizer throttle) during pan/zoom/hover.
+         */
+        private setupFpsMeter;
         get isInReplayMode(): boolean;
         get dateTimezoneConverter(): DateTimezoneConverter;
         get smoothLines(): boolean;
@@ -24215,6 +24946,14 @@ declare module FintaChart {
          */
         get crossHairType(): string;
         set crossHairType(value: string);
+        /**
+         * Get cross hair bar offset visibility
+         */
+        get showCrossHairBarOffset(): boolean;
+        /**
+         * Set cross hair bar offset visibility
+         */
+        set showCrossHairBarOffset(value: boolean);
         /**
          * Get chart css size
          */
@@ -24341,6 +25080,10 @@ declare module FintaChart {
          * Get chart root div element (native)
          */
         get rootDivEl(): HTMLElement;
+        /**
+         * Get chart background div element (native)
+         */
+        get backgroundEl(): HTMLElement;
         /**
          * Get chart root div
          */
@@ -24379,6 +25122,14 @@ declare module FintaChart {
          */
         get showBarInfoInTitle(): boolean;
         set showBarInfoInTitle(value: boolean);
+        /**
+         * Get show indicator legend/titles
+         */
+        get showIndicatorLegend(): boolean;
+        /**
+         * Set show indicator legend/titles across all panes
+         */
+        set showIndicatorLegend(value: boolean);
         /**
          * Get is chart show instrument watermark
          */
@@ -24437,6 +25188,15 @@ declare module FintaChart {
          */
         get zoomEnabled(): boolean;
         set zoomEnabled(value: boolean);
+        /**
+         * Rendering quality (sharpness vs paint speed).
+         */
+        get renderQuality(): RenderQuality;
+        set renderQuality(value: RenderQuality);
+        /**
+         * Maps render quality to the DPR cap and max visible bars.
+         */
+        private applyRenderQualityCap;
         /**
          * Get trading session hours type
          */
@@ -24473,7 +25233,10 @@ declare module FintaChart {
          * @param event
          * @return Is event handled
          */
+        static evtCount: number;
+        static evtMs: number;
         onMouseEvents(event: Event): boolean;
+        private onMouseEventsImpl;
         /**
          * Scrolling chart to real time arrow
          */
@@ -24593,6 +25356,19 @@ declare module FintaChart {
          * @return Data range
          */
         dateRange(startDate?: Date, endDate?: Date): any;
+        /**
+         * Shows the specified date range, loading missing history first and
+         * optionally switching the time frame (used by the bottom-toolbar
+         * date-range presets: 1D, 5D, ..., All).
+         *
+         * @param startDate Range start; `null` shows all available history.
+         * @param endDate Range end; defaults to the last loaded bar.
+         * @param timeFrame Optional time frame to switch to before applying the range.
+         */
+        setVisibleDateRange(startDate: Date | null, endDate?: Date | null, timeFrame?: ITimeFrame): void;
+        private estimateDateRangeBarsCount;
+        private applyDateRangeSelection;
+        private waitForBarsRequestComplete;
         /**
          * Alias for `dispose()`. Both names are documented across the
          * public guides; both are supported on the runtime.
@@ -24607,6 +25383,7 @@ declare module FintaChart {
         /**
          * Paints horizontal scale and panes container
          */
+        static lastPaintMs: number;
         paint(): void;
         /**
          * Executes indicator or indicators
@@ -24868,6 +25645,15 @@ declare module FintaChart {
          * @param makeAutoScale
          */
         refreshAsync(makeAutoScale?: boolean): void;
+        private _tickRefreshInterval;
+        private _lastTickRefresh;
+        private _tickRefreshTimer;
+        private _restoreIndicatorsTimer;
+        /**
+         * Throttled refresh for the live-tick path so a busy feed cannot force
+         * a full repaint every frame. User gestures still use refreshAsync.
+         */
+        refreshOnTickAsync(): void;
         autoScalePanes(kind?: AutoScalePanesKind): void;
         /**
          * Sets chart window mode
@@ -24914,7 +25700,11 @@ declare module FintaChart {
          *
          * @param updateInstruments
          */
-        private hasRenderSize;
+        static lastRefreshMs: number;
+        static lastLayoutMs: number;
+        static lastChartTypeMs: number;
+        static lastHScaleMs: number;
+        static lastPanesMs: number;
         refresh(updateInstruments?: boolean): void;
         /**
          * Triggers a repaint after direct property mutations (theme,
@@ -24995,10 +25785,24 @@ declare module FintaChart {
          */
         private ohlcCardRootContainer;
         private showOhlcCard;
+        /**
+         * Places the OHLC card at (left, top) but clamps it so the whole card
+         */
+        private clampOhlcCardPosition;
         private hideOhlcCard;
         toggleOhlcCardButton(show: boolean): void;
         setOhlcCardVariant(variant: string): void;
         private translateClonedShape;
+        /**
+         * Mobile uses touch only; mouse events emulate after taps.
+         */
+        private getInputEvents;
+        /**
+         * Switches input mode at runtime.
+         *
+         * @param mobile True to enable mobile (touch) input mode.
+         */
+        setMobileInputMode(mobile: boolean): void;
         private subscribe;
         private unsubscribe;
         private pointHitShapes;