@barchart/chart-lib 2.260.1 → 2.260.3

chart-lib/barchart.chart.d.ts

@@ -537,33 +537,32 @@ declare module "@barchart/chart-lib" {
         | "IncomeStatement"
         | "Seasonal";
 
-    export type AggregationUnit = "Tick" | "Intraday" | "Day" | "Week" | "Month" | "Quarter" | "Year";
-    export type AggregationSpec =
-        | "None"
-        | "Nearest"
-        | "Continue"
-        | "FormT"
-        | "PerCount"
-        | "PerVolume"
-        | "PerRange"
-        | "PerSeconds";
-
-    export type Aggregation = {
+    export enum AggregationUnit {
+        Tick,
+        Intraday,
+        Day,
+        Week,
+        Month,
+        Quarter,
+        Year,
+    }
+
+    export enum AggregationSpec {
+        None,
+        Nearest,
+        Continue,
+        FormT,
+        PerCount,
+        PerVolume,
+        PerRange,
+        PerSeconds,
+    }
+
+    interface AggregationCommon {
         /** Number of days/weeks etc. the data is aggregated over
          * @default 1
          */
         size?: number;
-        /** The unit (or time period) of aggregation
-         * @default "Day"
-         */
-        unit?: AggregationUnit;
-        /** Additional info about the aggregation
-         * @default "None"
-         */
-        spec?: AggregationSpec;
-        /** If the volume is per contract or total (futures only)
-         * @default false
-         */
         isContractVolume?: boolean;
         /** Turn off (false) or on (true) dividends adjustment for stock data.
          * @default false
@@ -581,7 +580,52 @@ declare module "@barchart/chart-lib" {
          * @default "combined"
          */
         contractRoll?: "expiration" | "combined";
-    };
+    }
+
+    export interface AggregationModel extends AggregationCommon {
+        /** The unit (or time period) of aggregation
+         * @default "Day"
+         */
+        unit?: keyof typeof AggregationUnit;
+        /** Additional info about the aggregation
+         * @default "None"
+         */
+        spec?: keyof typeof AggregationSpec;
+        /** If the volume is per contract or total (futures only)
+         * @default false
+         */
+    }
+
+    export class Aggregation implements AggregationCommon {
+        constructor(
+            unit: AggregationUnit,
+            size: number,
+            spec: AggregationSpec,
+            isContractVolume: boolean,
+            dividendsAdjust: boolean,
+            backAdjust: boolean,
+            daysToExpiration: number,
+            contractRoll: string
+        );
+        unit: AggregationUnit;
+        spec: AggregationSpec;
+        size: number;
+        isContractVolume: boolean;
+        dividendsAdjust: boolean;
+        backAdjust: boolean;
+        daysToExpiration: number;
+        contractRoll: "expiration" | "combined";
+        duplicate(): Aggregation;
+        getHashKey(): string;
+        toShortString(): string;
+        unitToString(): string;
+        describe(): string;
+        hasSpec: boolean;
+        isEndOfDay: boolean;
+        isTick: boolean;
+        isIntraday: boolean;
+        isMultiContract: boolean;
+    }
 
     /** A range of values, values are typically inclusive. */
     interface Range {
@@ -785,7 +829,7 @@ declare module "@barchart/chart-lib" {
 
     export type DataModel = {
         /** The way the data is aggregated across time. */
-        aggregation: Aggregation;
+        aggregation: AggregationModel;
         /** Maximum number of data points to load in a first chunk (sent as-is to historical server); there is no default in the model, internally defaults to 640. */
         maxDataPoints?: number;
         /** If set, the range of time the historical data will be limited to (if supported by the historical server). */
@@ -1078,6 +1122,61 @@ declare module "@barchart/chart-lib" {
         studyProvider?: StudyProvider;
     };
 
+    export function makeStudy(studyId: string, options: StudyOptions, innerSeries: TimeSeries): StudySeries;
+    export function getStudyOptions(
+        model: StudyPlotModel & { target: string },
+        agg: Aggregation,
+        curves?: Curve[]
+    ): StudyOptions;
+
+    export enum ExpressionMissingBar {
+        UsePrevious,
+        UseNext,
+        UseNone,
+    }
+
+    export enum ExpressionRecompute {
+        Minimum,
+        Everything,
+        Manual,
+    }
+
+    export enum ExpressionNoDataApproach {
+        NoAction,
+        IgnoreTimelineOnly,
+        ModelTransformRequired,
+    }
+
+    export type Operator = "+" | "-" | "*" | "/" | "^" | "sym" | "num" | "grp";
+
+    export type ExprNodeOrVal = ExprNode | NodeValue;
+
+    export type ExprNode = {
+        op: Operator;
+        left: ExprNodeOrVal;
+        right: ExprNodeOrVal;
+    };
+
+    type NodeValue = string | number | null;
+
+    export type ExprPolicy = {
+        mapper: (series: TimeSeries) => string;
+        loadMoreData: boolean;
+        recompute: ExpressionRecompute;
+        missing: ExpressionMissingBar;
+        stretch: (symbol: string) => boolean;
+        fieldMap: Map<Field, Field>;
+        noDataApproach: ExpressionNoDataApproach;
+        modelTransform: (withData: string[], withoutData: string[]) => ExprNode | null;
+        skipLeadingEmpty: boolean;
+    };
+
+    export function makeExpression(
+        model: ExprNode,
+        innerSeries: TimeSeries[],
+        policy: ExprPolicy
+    ): CalculableTimeSeries;
+
     /** The configuration is extensively documented at our documentation site. */
     interface Config {
         environment?: Environment;
@@ -1319,7 +1418,7 @@ declare module "@barchart/chart-lib" {
 
     export interface AggregationAccessor {
         id: string;
-        context: Aggregation;
+        context: AggregationModel;
     }
 
     export interface PeriodAccessor {
@@ -1760,13 +1859,13 @@ declare module "@barchart/chart-lib" {
         popupElement: HTMLElement;
         constructor(view: any);
         /** Initial DOM setup; override if you need any additional initialization */
-        initialize();
+        initialize(): void;
         /** 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();
+        showValue(): void;
         /** Called when hiding the popup, in case you need to do anything (most often you don't) */
-        hideValue();
+        hideValue(): void;
     }
 
     /**
@@ -1844,13 +1943,13 @@ declare module "@barchart/chart-lib" {
         /** Does again the last change undone to an annotation */
         redo(): void;
         /** Pause the undo/redo mechanism */
-        pauseUndoRedo();
+        pauseUndoRedo(): void;
         /** Resume the undo/redo mechanism
          * @param acceptLastChange Apply the last change while the undo/redo was paused
          * */
-        resumeUndoRedo(acceptLastChange: boolean);
+        resumeUndoRedo(acceptLastChange: boolean): void;
         /** Starts (or resets) the interactive zoom */
-        zoom(zoomIn: boolean);
+        zoom(zoomIn: boolean): void;
         /** Resets the chart to default template and re-applies current main plot */
         reset(preserveTheme: boolean): void;
         /** Reserved for internal use. */
@@ -1858,7 +1957,7 @@ declare module "@barchart/chart-lib" {
     }
 
     export enum SeriesKind {
-        Normal = 0,
+        Normal,
         Forward,
         HistoricalForward,
         Study,
@@ -2003,7 +2102,7 @@ declare module "@barchart/chart-lib" {
 
     /** Describes the chunk of the timeseries data. If specified, `Head` means older in time (first in a "list" of chunks) and `Tail` means newer in time (last in a "list" of chunks). */
     export enum ChunkPart {
-        Unspecified = 0,
+        Unspecified,
         Head,
         Tail,
     }
@@ -2094,6 +2193,7 @@ declare module "@barchart/chart-lib" {
          * @returns A string representation of the price.
          */
         format(price: number, field: Field, options: any): string;
+        shutdown(): void;
     }
 
     export interface IMetaDataSource {
@@ -2233,12 +2333,14 @@ declare module "@barchart/chart-lib" {
      */
     function parseExpression(text: string, useCache?: boolean): ExpressionSuccess | ExpressionError;
 
+    export type ValueProviderFunc = (symbol: string, field?: string) => number | null;
+
     /** If you would like to evaluate an expression yourself.
      * @param model Same as @see model property of the @see ExpressionSuccess
      * @param valueProvider A function which, given a symbol name, returns a price.
      * @returns The computed value of the expression.
      */
-    function evaluateExpression(model: ExpressionInternalModel, valueProvider: (string) => number): number;
+    function evaluateExpression(model: ExpressionInternalModel, valueProvider: ValueProviderFunc): number;
 
     interface StudyMetaRange {
         min: number;