@pipsend/charts 2.3.13 → 2.3.15

package/dist/typings.d.ts

@@ -37,6 +37,11 @@ declare abstract class DrawingToolBase implements IDrawingTool {
 	isVisible(): boolean;
 	/** Series the tool is attached to. */
 	series(): ISeriesApi<SeriesType>;
+	/**
+	 * Box the selection toolbar anchors to, in pane pixels. Null falls back to
+	 * the serialized points, which cannot place a line across the whole pane.
+	 */
+	selectionBox(): DrawingBounds | null;
 	getState(): DrawingToolState;
 	abstract remove(): void;
 	protected abstract _update(): void;
@@ -292,7 +297,9 @@ export declare class CrossLineTool extends DrawingToolBase {
 	private _grab;
 	private _moveStartTime;
 	private _moveStartPrice;
+	private _placement;
 	constructor(context: DrawingContext, options: CrossLineToolOptions);
+	isComplete(): boolean;
 	private _createPrimitive;
 	private _requestUpdate;
 	protected _update(): void;
@@ -464,11 +471,13 @@ export declare class DrawingToolsManager {
 	 * the chart is panned or zoomed.
 	 */
 	selectionBounds(): DrawingBounds | null;
+	/** Relative to the chart element; the tool's box is relative to its pane. */
+	private _boundsOf;
 	/**
 	 * Bounds come from the tool's own serialized points, so this works for every
 	 * tool without each one having to report a box.
 	 */
-	private _boundsOf;
+	private _boxFromPoints;
 	/** Panes below the first one are offset inside the chart element. */
 	private _paneOffsetOf;
 	private _emitSelection;
@@ -632,6 +641,7 @@ export declare class FibonacciExtensionTool extends DrawingToolBase {
 	private _isHovered;
 	private _isDragging;
 	private _dragTarget;
+	private _placement;
 	constructor(context: DrawingContext, options: FibonacciExtensionOptions);
 	private _createPrimitive;
 	private _createPaneView;
@@ -798,7 +808,11 @@ export declare class GanttTool extends DrawingToolBase {
 	private _grab;
 	private _moveStart;
 	private _hoveredSegmentIndex;
+	private _placement;
 	constructor(context: DrawingContext, options: GanttToolOptions);
+	private _placeAt;
+	isComplete(): boolean;
+	selectionBox(): DrawingBounds | null;
 	private _createPrimitive;
 	private _createPaneView;
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
@@ -845,7 +859,11 @@ export declare class HorizontalLineTool extends DrawingToolBase {
 	private _isDragging;
 	private _grab;
 	private _moveStartPrice;
+	private _placement;
 	constructor(context: DrawingContext, options: HorizontalLineToolOptions);
+	private _placeAt;
+	isComplete(): boolean;
+	selectionBox(): DrawingBounds | null;
 	private _createPrimitive;
 	private _createPaneView;
 	/** Where the line starts, in CSS pixels. Zero unless it is a ray. */
@@ -1242,6 +1260,7 @@ export declare class PositionTool extends DrawingToolBase {
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
+	private _placement;
 	private _isDragging;
 	private _dragTarget;
 	private _grab;
@@ -1249,6 +1268,9 @@ export declare class PositionTool extends DrawingToolBase {
 	private _profitRect;
 	private _lossRect;
 	constructor(context: DrawingContext, options: PositionToolOptions);
+	private _placeAt;
+	isComplete(): boolean;
+	private _span;
 	private _createPrimitive;
 	private _createPaneView;
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
@@ -1482,6 +1504,7 @@ export declare class TextTool extends DrawingToolBase {
 	private _moveStart;
 	private _isEditing;
 	private _clickOutsideHandler;
+	private _placement;
 	constructor(context: DrawingContext, options: TextToolOptions);
 	private _setupClickOutsideHandler;
 	private _createPrimitive;
@@ -1637,7 +1660,10 @@ export declare class VerticalLineTool extends DrawingToolBase {
 	private _isDragging;
 	private _grab;
 	private _moveStartTime;
+	private _placement;
 	constructor(context: DrawingContext, options: VerticalLineToolOptions);
+	isComplete(): boolean;
+	selectionBox(): DrawingBounds | null;
 	private _createPrimitive;
 	private _createPaneView;
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
@@ -3324,6 +3350,8 @@ export interface ControllableLine {
 export interface CrossLineToolOptions extends DrawingToolOptions {
 	time?: Time;
 	price?: number;
+	/** Waits for a click that sets the time and the price. */
+	interactive?: boolean;
 	lineColor?: string;
 	lineWidth?: number;
 	lineStyle?: "solid" | "dashed" | "dotted";
@@ -3508,8 +3536,7 @@ export interface DraggablePriceLineOptions {
 	formatTitle?: (price: number) => string;
 }
 /**
- * Where a tool sits on screen, in pixels relative to the chart element, so a
- * floating UI can be anchored to it.
+ * Where a tool sits on screen, in pixels, so a floating UI can be anchored to it.
  */
 export interface DrawingBounds {
 	left: number;
@@ -3582,6 +3609,7 @@ export interface FibonacciExtensionOptions extends DrawingToolOptions {
 	lineWidth?: number;
 	showLabels?: boolean;
 	extendLines?: boolean;
+	/** Waits for three clicks that set its points in order. */
 	interactive?: boolean;
 	onUpdate?: () => void;
 	onRemove?: () => void;
@@ -3663,6 +3691,8 @@ export interface GanttSegment {
 }
 export interface GanttToolOptions extends DrawingToolOptions {
 	segments?: GanttSegment[];
+	/** Waits for a click that sets where the segments start, and in which row. */
+	interactive?: boolean;
 	rowHeight?: number;
 	rowSpacing?: number;
 	fillOpacity?: number;
@@ -3820,6 +3850,7 @@ export interface HistogramStyleOptions {
 }
 export interface HorizontalLineToolOptions extends DrawingToolOptions {
 	price?: number;
+	/** Waits for a click that sets the level, and the start of a ray. */
 	interactive?: boolean;
 	/**
 	 * Where the line starts. Left undefined it spans the whole chart; set, the
@@ -6320,11 +6351,13 @@ export interface PositionMetrics {
 export interface PositionToolOptions extends DrawingToolOptions {
 	entryPrice: number;
 	entryTime: Time;
+	/** Right edge of the box. Without it the box spans a fifth of the pane. */
 	endTime?: Time;
 	stopLoss?: number;
 	takeProfit?: number;
 	quantity?: number;
 	pipConfig?: PipConfig;
+	/** Waits for a click to place the entry; stop and target keep their distance from it. */
 	interactive?: boolean;
 	profitColor?: string;
 	lossColor?: string;
@@ -7268,9 +7301,13 @@ export interface TextToolOptions extends DrawingToolOptions {
 	anchor?: TextToolAnchor;
 	pointer?: boolean;
 	borderRadius?: number;
+	/** Waits for a click that sets `time` and `price`. */
+	interactive?: boolean;
 	onUpdate?: () => void;
 	onRemove?: () => void;
 	onTextChange?: (text: string) => void;
+	/** Called once an interactive text has been placed. */
+	onComplete?: () => void;
 }
 export interface TextWatermarkLineOptions {
 	/**
@@ -7604,6 +7641,7 @@ export interface VerticalGradientColor {
 }
 export interface VerticalLineToolOptions extends DrawingToolOptions {
 	time?: Time;
+	/** Waits for a click that sets the time. */
 	interactive?: boolean;
 	lineColor?: string;
 	lineWidth?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "private": false,
-  "version": "2.3.13",
+  "version": "2.3.15",
   "name": "@pipsend/charts",
   "author": "Pipsend",
   "license": "SEE LICENSE IN LICENSE",