@barchart/chart-lib 2.401.0 → 2.403.0

chart-lib/barchart.chart.d.ts

@@ -1310,6 +1310,8 @@ declare module "@barchart/chart-lib" {
         defaultVolumeBarColoring?: DefaultBarColoring;
         defaultMainPlotBarColoring?: DefaultBarColoring;
         colorfulAnnotations?: boolean;
+        /** Opt in to enhanced annotation selection and overlap interactions. Omitted or false preserves legacy behavior. */
+        annotationManipulation?: boolean;
         fetch?(kind: UrlKind, relativeUrl: string): Promise<string>;
         getCustomEventPopup(view: any): CustomEventPopup | null;
     }
@@ -1553,7 +1555,8 @@ declare module "@barchart/chart-lib" {
         | ThemeAccessor
         | ClearAccessor
         | MovePlotAccessor
-        | PinPlotAccessor;
+        | PinPlotAccessor
+        | AnnotationManipulationAccessor;
 
     export interface ClearAccessor {
         id: "Clear";
@@ -1803,6 +1806,27 @@ declare module "@barchart/chart-lib" {
 
     export type PinPlotAxis = "PrimaryAxis" | "SecondaryAxis" | "NoAxis";
 
+    /** Selection is transient; positions are zero-based, back to front within an axis. */
+    export interface AnnotationManipulationAccessor {
+        id: "AnnotationManipulation";
+        context: {
+            id?: "Get" | "Update";
+            uid?: string;
+            selected?: boolean;
+            preview?: boolean;
+            position?: number | "Front" | "Back";
+        };
+    }
+
+    export interface AnnotationManipulationState {
+        uid: string;
+        paneIndex: number;
+        axisIndex: number;
+        position: number;
+        selected: boolean;
+        preview: boolean;
+    }
+
     export interface PinPlotAccessor {
         id: "PinPlot";
         context: {
@@ -2081,6 +2105,15 @@ declare module "@barchart/chart-lib" {
         factors?: Array<{ shown: boolean; value: number }>;
     }
 
+    export interface IAnnotationCandidate extends Omit<
+        IAnnotationData,
+        "offset" | "wasSelected" | "candidates" | "toolChange" | "orderOnly"
+    > {
+        paneIndex: number;
+        axisIndex: number;
+        position: number;
+    }
+
     export interface IAnnotationData {
         uid: string;
         id: string;
@@ -2092,6 +2125,14 @@ declare module "@barchart/chart-lib" {
         visible: boolean;
         chart: ChartAccessor;
         canFlip?: boolean;
+        /** Context-menu target was selected before the triggering gesture. */
+        wasSelected?: boolean;
+        /** Context-menu candidates in front-to-back order. */
+        candidates?: IAnnotationCandidate[];
+        /** Present on CH_ANNMODIFIEDBYTOOL. */
+        toolChange?: string;
+        /** Ordering is local; do not synchronize this notification as a drawing edit. */
+        orderOnly?: boolean;
     }
 
     export function getAnnotationTraits(annId: string): AnnotationTraits;
@@ -2757,6 +2798,8 @@ declare module "@barchart/chart-lib" {
     }
 
     export interface StudyInput {
+        /** Discrete numeric input; normalized with Math.ceil at the model boundary. */
+        integer?: boolean;
         /** Name of the input parameter. */
         name: string;
         /** Value of the input parameter. */
@@ -2858,6 +2901,8 @@ declare module "@barchart/chart-lib" {
         balanceSheets: BalanceSheet[];
         studyFields: StudyField[];
         curveStyles: CurveStyle[];
+        /** Input defaults, including integer declarations, for configurable curve styles. */
+        curveStyleInputs: Partial<Record<CurveStyle, StudyInput[]>>;
         annotations: AnnotationConfig[];
     }