@barchart/chart-lib 2.81.1 → 2.183.2

{package → chart-lib}/barchart.chart.d.ts

@@ -16,6 +16,20 @@ declare module "@barchart/chart-lib" {
      */
     export function formatPriceWithDecimals(price: number, decimals: number): string;
 
+    /**
+     * Helps if you need to know whether there's open interest for a symbol
+     * @param symbol A symbol name
+     * @returns True if the symbol has open interest
+     */
+    export function hasOpenInterest(symbol: string): boolean;
+
+    /**
+     *
+     * @param symbols An array of symbol names
+     * @returns {MetaData} A combination of sorts of the individual `MetaData` for each of the symbols; for example, if you had an expression involving 3 symbols the combined `MetaData` would have max decimals of all the symbols involved.
+     */
+    export function getCombinedMetaData(symbols: string[]): MetaData;
+
     export type FundamentalType =
         | "AccountsPayable"
         | "AccruedExpenses"
@@ -114,6 +128,18 @@ declare module "@barchart/chart-lib" {
 
     export type StudyFieldId =
         | "MA"
+        | "MA1"
+        | "MA2"
+        | "MA3"
+        | "MA4"
+        | "MA5"
+        | "MA6"
+        | "MA7"
+        | "MA8"
+        | "MA9"
+        | "MA10"
+        | "MAS"
+        | "MAL"
         | "EMA"
         | "MAHI"
         | "MALO"
@@ -243,7 +269,7 @@ declare module "@barchart/chart-lib" {
         | "TR"
         | "IMPVOL"
         | "CTM"
-        | "GPMI"
+        | "CPMI"
         | "CTLTM"
         | "CTLTMF"
         | "DEMA"
@@ -283,7 +309,7 @@ declare module "@barchart/chart-lib" {
         | "LINRLOW"
         | "CSHO"
         | "CSHB"
-        | "GTPI"
+        | "CTPI"
         | "TCHRE"
         | "PCTCHG"
         | "ATRMA"
@@ -293,12 +319,34 @@ declare module "@barchart/chart-lib" {
         | "VSTOPLOW"
         | "SUPTR"
         | "BARCOLIX"
+        | "BARKIND"
         | "CONVLN"
         | "BASELN"
         | "LEADSP1"
         | "LEADSP2"
         | "LAGGSP"
-        | "VWAP";
+        | "VWAP"
+        | "VWAPSD1U"
+        | "VWAPSD1L"
+        | "VWAPSD2U"
+        | "VWAPSD2L"
+        | "PLVI"
+        | "MNVI"
+        | "DIFA"
+        | "DOSCH"
+        | "DOSCS"
+        | "BOLLSQ"
+        | "TTMSQZON"
+        | "TTMSQZOFF"
+        | "TTMSQZOSC"
+        | "CRS"
+        | "CRSAVG"
+        | "JPIB"
+        | "JPIS"
+        | "DRS"
+        | "MRS"
+        | "PMO"
+        | "PMOS";
 
     export type GeneralFieldId =
         | "DateTime"
@@ -328,6 +376,8 @@ declare module "@barchart/chart-lib" {
 
     export type StudyId =
         | "MA"
+        | "MACDSIG"
+        | "MASIG"
         | "MAEXP"
         | "MAHLC"
         | "MACD"
@@ -353,6 +403,7 @@ declare module "@barchart/chart-lib" {
         | "BBANDS"
         | "BWIDTH"
         | "BPERC"
+        | "BSQUEEZE"
         | "OBVOL"
         | "ATR"
         | "ADX"
@@ -406,7 +457,7 @@ declare module "@barchart/chart-lib" {
         | "PIVPTS"
         | "IMPVOL"
         | "CTM"
-        | "GPMI"
+        | "CPMI"
         | "DEMA"
         | "TEMA"
         | "TSI"
@@ -422,7 +473,7 @@ declare module "@barchart/chart-lib" {
         | "LINRCHN"
         | "CSHO"
         | "CSHB"
-        | "GTPI"
+        | "CTPI"
         | "TCHRE"
         | "PCTCHG"
         | "OPINT"
@@ -431,7 +482,19 @@ declare module "@barchart/chart-lib" {
         | "VSTOP"
         | "SUPTR"
         | "ICHCLD"
-        | "VWAP";
+        | "VWAP"
+        | "VOIN"
+        | "DIFA"
+        | "DOSC"
+        | "MARIB"
+        | "HASMO"
+        | "TTMSQZ"
+        | "CRS"
+        | "JPI"
+        | "CTTP"
+        | "DRS"
+        | "MRS"
+        | "PMO";
 
     type PlotType =
         | "Symbol"
@@ -644,6 +707,10 @@ declare module "@barchart/chart-lib" {
         annotationTraits?: AnnotationTraitsModel;
         /** Obsolete, please ignore. */
         curveTraits?: any[];
+        /** Will be `true` when all annotations are not supposed to move; their other properties, like line width, fill color etc. can still be changed.
+         * @default false
+         */
+        allAnnotationsLocked: boolean;
     };
 
     export type AnnotationModel = {
@@ -715,8 +782,11 @@ declare module "@barchart/chart-lib" {
         CH_CHTNEEDSCONTEXTMENU: string;
         CH_ANNSELECTIONCHANGED: string;
         CH_ANNPOINTPICKED: string;
+        CH_ANNMODIFIEDBYTOOL: string;
         CH_PANEHEIGHTSCHANGED: string;
         CH_PANESREORDERED: string;
+        CH_AXISSCALECHANGED: string;
+        CH_CHTLAYOUTCHANGED: string;
         CH_NODATAFORMAINSYMBOL: string;
         CH_CARDPLOTCLICKED: string;
         CH_CARDPLOTREMOVED: string;
@@ -726,13 +796,15 @@ declare module "@barchart/chart-lib" {
         CH_ZOOMCHANGED: string;
         CH_ALL_DATA_PROJECTED: string;
         CH_API_ACTIONS_RECEIVED: string;
+        DF_ALL: string;
+        DF_STREAMRECONNECTED: string;
         TS_ALL: string;
         TS_LOADING: string;
         TS_MANYCHANGED: string;
         TS_DATAPOINTADDED: string;
         TS_DATAPOINTCHANGED: string;
+        TS_TIMELINECORRECTION: string;
         TS_EVENTSCHANGED: string;
-        TS_LAST_POINT_UPDATED: string;
         MD_ALL: string;
         MD_CHANGED: string;
         RT_ALL: string;
@@ -770,6 +842,7 @@ declare module "@barchart/chart-lib" {
                 typeName: string;
                 name: string;
                 description?: string;
+                exchange?: string;
                 error?: string;
                 id: string;
                 events: {
@@ -795,7 +868,14 @@ declare module "@barchart/chart-lib" {
 
     const Topics: ITopics;
 
-    export type FeedMode = "Unspecified" | "GBE" | "cmdtyView" | "DemoSite" | "InternalFeed" | "Widget" | "FreeWidget";
+    export type FeedMode =
+        | "Unspecified"
+        | "GBE"
+        | "cmdtyView"
+        | "DemoSite"
+        | "InternalFeed"
+        | "Widget"
+        | "FreeWidget";
 
     type BaseUrl = {
         instruments: string;
@@ -843,8 +923,20 @@ declare module "@barchart/chart-lib" {
 
     type HostingModel = "Page" | "Application";
 
+    type Environment = "Browser" | "NodeJs";
+
+    /**
+     * How should volume bars be colored:
+     * - `OpenToClose` same as main plot with `CurveAttribute` set to `OpenVsClose`
+     * - `CloseToClose` same as main plot with `CurveAttribute` set to `ChangeBased`
+     *
+     * By default, this is unset and the volume coloring will be identical to the main plot's bar coloring. This value  will only be used when the main plot does _not_ have any bar coloring set (for example, when the main plot is a line or an area plot).
+     */
+    export type DefaultVolumeBarColoring = "OpenToClose" | "CloseToClose";
+
     /** The configuration is extensively documented at our documentation site. */
     interface Config {
+        environment?: Environment;
         validateInput?: boolean;
         throttleMillis?: number;
         isAlt64?: boolean;
@@ -864,9 +956,13 @@ declare module "@barchart/chart-lib" {
         baseUrl?: BaseUrl;
         overrides?: Overrides;
         noDataText?: string;
+        useAllFieldsForComparison?: boolean;
         credentials?: ICredentials;
         apiKey?: string;
+        defaultVolumeBarColoring?: DefaultVolumeBarColoring;
+        colorfulAnnotations?: boolean;
         fetch?(kind: UrlKind, relativeUrl: string): Promise<string>;
+        getCustomEventPopup(view: any): CustomEventPopup | null;
     }
 
     /** How should the chart be initialized on startup (if at all). Please note that this is suited for cases where the `template` is already made such that it matches the type of the main plot. This is not an issue: if the template doesn't match (main plot is set to a different kind of plot) the main plot will be replaced by the desired plot with all the values set to their defaults. */
@@ -941,6 +1037,11 @@ declare module "@barchart/chart-lib" {
         data: string;
     };
 
+    /** Additional attributes sometimes needed for drawing.
+     * - `ChangeBased`: when coloring bars, we need to know if the price movement was up or down; use the `Change` field to decide. Also known as 'Close-to-Close'.
+     * - `OpenVsClose`: like preceding phrase, but use `Open` and `Close` field values of the bar to decide. Also known as 'Open-to-Close'.
+     * The two attibutes are mutually exclusive, but we _may_ add new attributes which will be independent.
+     */
     type CurveAttribute = "ChangeBased" | "OpenVsClose";
 
     type CurveZone = {
@@ -954,11 +1055,6 @@ declare module "@barchart/chart-lib" {
 
     /** Curve is the second most important concept of the chart. It's a smallest drawable unit of time-series data. Most plots consist of several curves, each using a portion of the time-series fields associated with the plot. */
     export interface Curve {
-        /** Additional attributes sometimes needed for drawing.
-         * - `ChangeBased`: when deciding whether the price movement was up or down, use the `Change` field to decide.
-         * - `OpenVsClose`: like preceding phrase, but use `Open` and `Close` field values of the two consequtive bars to decide whether the trend is up or down.
-         * The preceding two attibutes are mutually exclusive, but this is not a rule, just an accident.
-         */
         attributes?: CurveAttribute[];
         /** The way the curve is drawn. */
         style?: CurveStyle;
@@ -1056,11 +1152,21 @@ declare module "@barchart/chart-lib" {
         context: { period: string } | { range: { from?: number; to?: number } } | { density: number };
     }
 
+    export interface CrosshairProperties {
+        color: string;
+        dashStyle?: DashStyle;
+    }
+
+    export interface ICrosshairContext {
+        crosshair: Orientation;
+        horizontal?: CrosshairProperties;
+        vertical?: CrosshairProperties;
+        haloTracking?: boolean;
+    }
+
     export interface CrosshairAccessor {
         id: string;
-        context: {
-            crosshair: Orientation;
-        };
+        context: ICrosshairContext | { id: "Get" };
     }
 
     export type Orientation = "vertical" | "horizontal" | "both" | "none";
@@ -1103,6 +1209,7 @@ declare module "@barchart/chart-lib" {
     export interface OtherAccessor {
         id: string;
         context: {
+            id?: "Get" | "Update";
             /**
              * Deprecated. Use comparisonMode instead
              */
@@ -1115,6 +1222,7 @@ declare module "@barchart/chart-lib" {
             showNavigator?: boolean;
             plotHover?: boolean;
             showGoToLatest?: boolean;
+            allAnnotationsLocked?: boolean;
         };
     }
 
@@ -1156,6 +1264,7 @@ declare module "@barchart/chart-lib" {
         id: string;
         context: {
             plots?: ICompareItem[];
+            alignOnExpirations?: boolean;
         };
     }
 
@@ -1173,6 +1282,7 @@ declare module "@barchart/chart-lib" {
             id: "Delete" | "Update" | "Duplicate" | "List";
             uid?: string;
             visible?: boolean;
+            locked?: boolean;
             traits?: AnnotationTraits;
             extras?: {
                 [k: string]: any;
@@ -1217,6 +1327,11 @@ declare module "@barchart/chart-lib" {
                 textColor?: string;
                 crosshairColor?: string;
             };
+            fontSize?: {
+                chart?: number;
+                xAxis?: number;
+                yAxis?: number;
+            };
         };
     }
 
@@ -1324,14 +1439,18 @@ declare module "@barchart/chart-lib" {
 
     export type AnnotationId =
         | "Line"
+        | "Ray"
+        | "GannLine"
         | "VerticalLine"
         | "HorizontalLine"
         | "FiftyPercentLine"
         | "LongPosition"
         | "ShortPosition"
         | "FibonacciRetracement"
+        | "TrendBasedFibExtension"
         | "FibonacciFan"
         | "FibonacciArcs"
+        | "FibonacciChannel"
         | "GannFan"
         | "SpeedResistanceFan"
         | "SpeedResistanceArcs"
@@ -1343,23 +1462,35 @@ declare module "@barchart/chart-lib" {
         | "SymbolArrowDown"
         | "SymbolArrowRight"
         | "SymbolArrowLeft"
+        | "SymbolArrowHorizontal"
+        | "SymbolArrowVertical"
         | "SymbolArcDown"
         | "SymbolArcUp"
         | "SymbolThumbsUp"
         | "SymbolThumbsDown"
+        | "SymbolZero"
         | "SymbolOne"
         | "SymbolTwo"
         | "SymbolThree"
         | "SymbolFour"
         | "SymbolFive"
+        | "SymbolSix"
+        | "SymbolSeven"
+        | "SymbolEight"
+        | "SymbolNine"
         | "SymbolQuestion"
         | "SymbolFishHook"
         | "FibonacciTimeZones"
         | "Text"
-        | "ComputedText";
+        | "ComputedText"
+        | "DateRange"
+        | "PriceRange"
+        | "DatePriceRange"
+        | "GannBox"
+        | "GannSquare";
 
     export interface AnnotationPoint {
-        /** Price (y) coordianate. */
+        /** Price (y) coordinate. */
         price: number;
         /** Time (x) coordinate. Number because it is a JavaScript Date, milliseconds since Unix epoch. */
         time: number;
@@ -1373,10 +1504,12 @@ declare module "@barchart/chart-lib" {
         points: AnnotationPoint[];
         traits: AnnotationTraits;
         visible: boolean;
+        locked: boolean;
     }
 
     export interface AnnotationTraits {
         line?: LineTrait;
+        line2?: LineTrait;
         fill?: FillTrait;
 
         fill2?: FillTrait;
@@ -1396,6 +1529,15 @@ declare module "@barchart/chart-lib" {
         showPercentDiff?: boolean;
 
         showTrendline?: boolean;
+        drawBorder?: boolean;
+        showLeftLabels?: boolean;
+        showRightLabels?: boolean;
+        showTopLabels?: boolean;
+        showBottomLabels?: boolean;
+        showAngles?: boolean;
+        reverse?: boolean;
+        showRangesRatio?: boolean;
+
         factors?: Array<{ shown: boolean; value: number }>;
     }
 
@@ -1406,6 +1548,8 @@ declare module "@barchart/chart-lib" {
         traits: AnnotationTraits;
         extras: any;
         points: AnnotationPoint[];
+        locked: boolean;
+        visible: boolean;
         chart: ChartAccessor;
     }
 
@@ -1413,6 +1557,55 @@ declare module "@barchart/chart-lib" {
 
     export type RenderTo = string | HTMLElement;
 
+    /**
+     * Base class for the custom event popups. If you need to show custom events on a chart, you will likely
+     * want to derive from this class and then override @func showValue and @func hideValue methods
+     */
+    export class CustomEventPopup {
+        /** For internal use only */
+        view: any;
+        /** The date of the event */
+        date: Date;
+        /** The value of the event; opaque, chart does not interpret this in any way */
+        value: any;
+        /** Whether the popup is currently shown on the screen */
+        visible: boolean;
+        /** The popup HTML elements hosting the content */
+        popupElement: HTMLElement;
+        constructor(view: any);
+        /** Initial DOM setup; override if you need any additional initialization */
+        initialize();
+        /** Called when a value needs to be "shown"; basically means you should populate the DOM with the
+         * content, won't be called if the @member value doesn't change
+         */
+        showValue();
+        /** Called when hiding the popup, in case you need to do anything (most often you don't) */
+        hideValue();
+    }
+
+    /**
+     * Creates a DOM element and appends it into the @see element
+     * @param element DOM element to append the newly created element into
+     * @param nodeName Name of the DOM element to create
+     * @returns Newly created DOM element
+     */
+    export function appendDOMElement<N extends keyof HTMLElementTagNameMap>(
+        element: HTMLElement,
+        nodeName: N
+    ): HTMLElement;
+    /**
+     * Apply styles to a given DOM element
+     * @param element Element to style
+     * @param styles Key-value paris of styles to apply
+     */
+    export function styleDOMElement(element: HTMLElement, styles: object): void;
+    /**
+     * Apply attributes to a given DOM element
+     * @param element DOM element whose attributes are to be set
+     * @param attributes Key-value pairs of attributes and values to apply
+     */
+    export function setAttributesDOMElement(element: HTMLElement, attributes: object): void;
+
     /** Chart accessor is the main API entry point, it essentially _is_ the chart. */
     export class ChartAccessor {
         /** The only parameter for construction is `headless` which if set to `true` will create a chart without any kind of visual representation. This form of a chart is useful for template editors which don't render any content. */
@@ -1447,6 +1640,16 @@ declare module "@barchart/chart-lib" {
         print(options: { title: TitleOptions }): void;
         /** Reserved for internal use. */
         fromModel(model: ChartModel): void;
+        /** Returns `true` if @see undo method could be called in order to undo the last change to an annotation */
+        canUndo: boolean;
+        /** Returns `true` if @see redo method could be called in order to redo the last change to an annotation */
+        canRedo: boolean;
+        /** Reverts the last change made to any annotation */
+        undo(): void;
+        /** Does again the last change undone to an annotation */
+        redo(): void;
+        /** Starts (or resets) the interactive zoom */
+        zoom(zoomIn: boolean);
     }
 
     export enum SeriesKind {
@@ -1727,7 +1930,7 @@ declare module "@barchart/chart-lib" {
 
     /** Built-in feed for mini chart widgets, no streaming data but does cache timeseries data. */
     class MiniWidgetDataFeed extends BaseDataFeed {}
-    
+
     /** Built-in feed, use if you have a contract with Barchart to use our data. This one _does_ provide streaming data. */
     class MarketDataFeed extends BaseDataFeed {
         connection?: any;
@@ -1743,6 +1946,9 @@ declare module "@barchart/chart-lib" {
     /** So you don't have to store the instance of the data feed - just call this method. The data feed is your root entry point to all APIs. */
     function getFeed<T extends BaseDataFeed>(): T | null;
 
+    /** Shuts down the data feed, severing any and all connections to server(s). For performance reasons, should almost never be called. */
+    function shutdownFeed(): void;
+
     export interface IChartOutline {
         isTemplate: boolean;
         isDefinition: boolean;
@@ -1892,10 +2098,12 @@ declare module "@barchart/chart-lib" {
         | "HollowCandles"
         | "HeikinAshi"
         | "ElderImpulseSystem"
-        | "Renko";
-    /*| "LineBreak"
+        | "Renko"
+        | "Range"
+        | "LineBreak"
         | "Kagi"
-        | "PointAndFigure";*/
+        | "PointAndFigure"
+        | "Baseline";
 
     interface Taxonomies {
         studies: Study[];
@@ -1993,7 +2201,7 @@ declare module "@barchart/chart-lib" {
          * @default false
          */
         showPrevious?: boolean;
-        type: "symbol";
+        type: "Symbol";
         /** The main plot is the central focal point of the chart - by default, all studies are based off of the main plot's time-series data, for example.
          * This is `false` for all "secondary" plots when we're comparing multiple plots together.
          * @default false
@@ -2095,6 +2303,7 @@ declare module "@barchart/chart-lib" {
 
     export interface SymbolPlot extends Plot {
         main: boolean;
+        inputs?: StudyInput[];
     }
 
     export interface FundamentalPlot extends Plot {
@@ -2149,19 +2358,10 @@ declare module "@barchart/chart-lib" {
         a: number;
     }
 
-    interface INetwork {
-        isPrivateAddress(host: string): boolean;
-        isRunningLocally(): boolean;
-        getThisDomainName(): string;
-        buildURL(host: string, query: object): string;
-        buildCheckURL(qps1: string?, qps2: string?): string;
-    }
-    // reserved for internal use
-    export const Network: INetwork;
-
     export {
         initFeed,
         getFeed,
+        shutdownFeed,
         getChartOutline,
         BarchartSiteDataFeed,
         MarketDataFeed,