@pipsend/charts 1.2.2 → 1.3.1

package/dist/typings.d.ts

@@ -22,10 +22,50 @@ declare abstract class DrawingToolBase implements IDrawingTool {
 	unlock(): void;
 	isLocked(): boolean;
 	isVisible(): boolean;
+	/** Series the tool is attached to. */
+	series(): ISeriesApi<SeriesType>;
 	getState(): DrawingToolState;
 	abstract remove(): void;
-	abstract serialize(): SerializedDrawingTool;
 	protected abstract _update(): void;
+	/**
+	 * Identity and shared state live here, so no tool can forget to save them:
+	 * a hidden or locked drawing used to come back visible and unlocked, and
+	 * every id changed on restore.
+	 */
+	serialize(): SerializedDrawingTool;
+	/** Reapply what `serialize()` stored on top of a freshly created tool. */
+	applySerializedState(data: SerializedDrawingTool): void;
+	/** The tool's own geometry and style. */
+	protected abstract _serializeShape(): SerializedDrawingTool;
+	/**
+	 * Interaction contract.
+	 *
+	 * These were optional in practice: the manager looked them up at runtime and
+	 * skipped whatever a tool happened not to implement, so a missing method
+	 * showed up as a tool that silently could not be hovered or moved. Declared
+	 * here, the compiler is the one that notices.
+	 */
+	/** Whether the point is over the tool at all. */
+	abstract hitTest(x: number, y: number): boolean;
+	/**
+	 * Which part of the tool is under the point — a handle, or the body when the
+	 * whole object can be dragged. Null when the point grabs nothing.
+	 */
+	abstract hitTestEndpoint(x: number, y: number): DrawingPart | null;
+	/**
+	 * Primary colour of the tool, so a single control can restyle any of them.
+	 * Tools that colour per level or per segment apply it to all of them.
+	 */
+	abstract setColor(color: string): void;
+	abstract color(): string;
+	abstract setHovered(hovered: boolean): void;
+	abstract isHovered(): boolean;
+	abstract setSelected(selected: boolean): void;
+	abstract isSelected(): boolean;
+	/** Begin a drag of `part`, anchored at the point the pointer grabbed. */
+	abstract startDrag(part: any, grab: DragAnchor): void;
+	abstract updateDrag(time: Time, price: number): void;
+	abstract stopDrag(): void;
 }
 declare const areaSeries: SeriesDefinition<"Area">;
 declare const barSeries: SeriesDefinition<"Bar">;
@@ -43,6 +83,7 @@ declare enum DrawingToolState {
 export declare class ArrowTool extends DrawingToolBase {
 	private _arrowOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
@@ -62,9 +103,18 @@ export declare class ArrowTool extends DrawingToolBase {
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
 	private _drawArrowHead;
 	private _drawCircle;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	private _distanceToLineSegment;
 	hitTestEndpoint(x: number, y: number): number | null;
@@ -74,66 +124,94 @@ export declare class ArrowTool extends DrawingToolBase {
 	getPoints(): ArrowPoint[];
 	addPoint(point: ArrowPoint): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
 }
+/**
+ * Freehand stroke.
+ *
+ * While drawing, points are sampled and rendered in screen coordinates and only
+ * converted to time and price when the stroke ends. The previous version did
+ * the opposite — it converted every sample as it arrived and drained them from
+ * a buffer one per 16 ms timer tick — so a fast stroke kept drawing seconds
+ * after the pointer stopped. Sampling is distance based, which keeps the point
+ * count low enough for dragging and hit testing to stay cheap afterwards.
+ */
 export declare class BrushTool extends DrawingToolBase {
 	private _brushOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
+	private _drawingModeActive;
 	private _isDrawing;
-	private _currentStroke;
-	private _mouseDownHandler;
-	private _mouseMoveHandler;
-	private _mouseUpHandler;
-	private _chartElement;
-	private _pointBuffer;
-	private _smoothingInterval;
+	private _livePoints;
+	private _repaintQueued;
+	private _element;
+	private _pointerId;
+	private _pointerDown;
+	private _pointerMove;
+	private _pointerUp;
+	/** What the engine reports under the pointer, so a press meant for an
+	 * existing drawing is not swallowed by a new stroke. */
+	private _hoveredExternalId;
+	private _crosshairHandler;
 	private _isDragging;
-	private _dragStartPoint;
+	private _grab;
+	private _moveStartPoints;
 	constructor(context: DrawingContext, options: BrushToolOptions);
-	private _initializeDrawingMode;
-	private _startSmoothingInterval;
-	private _stopSmoothingInterval;
-	private _processBuffer;
-	private _flushBuffer;
-	private _cleanupDrawingHandlers;
-	private _getPointFromMouseEvent;
-	private _createPrimitive;
-	private _createPaneView;
-	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
-	private _drawPolyline;
-	private _drawSmoothCurve;
+	startDrawingMode(): void;
 	stopDrawingMode(): void;
 	isDrawingModeActive(): boolean;
-	setSelected(selected: boolean): void;
-	isSelected(): boolean;
-	setHovered(hovered: boolean): void;
+	private _onPointerDown;
+	private _onPointerMove;
+	private _onPointerUp;
+	/**
+	 * Screen samples become time and price once, at the end of the stroke.
+	 */
+	private _finishStroke;
+	private _isOverAnotherDrawing;
+	private _releasePointer;
+	private _toPanePoint;
+	private _paneElement;
+	/** At most one repaint per frame, however fast the samples arrive. */
+	private _queueRepaint;
+	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
+	private _drawEndpoint;
+	private _screenPath;
 	hitTest(x: number, y: number): boolean;
-	private _distanceToLineSegment;
-	getPoints(): BrushPoint[];
 	hitTestEndpoint(x: number, y: number): "stroke" | null;
-	startDrag(target: "stroke"): void;
-	stopDrag(): void;
+	startDrag(target: "stroke", grab: DragAnchor): void;
 	updateDrag(time: Time, price: number): void;
-	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	stopDrag(): void;
+	setColor(color: string): void;
+	color(): string;
+	setSelected(selected: boolean): void;
+	isSelected(): boolean;
+	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	private _createPrimitive;
+	private _hitTestPrimitive;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
+	protected _serializeShape(): SerializedDrawingTool;
+	getPoints(): readonly BrushPoint[];
 }
 export declare class CircleTool extends DrawingToolBase {
 	private _circleOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
 	private _isDragging;
 	private _dragTarget;
+	private _grab;
+	private _moveStart;
 	private _isDrawing;
 	private _clickHandler;
 	private _mouseMoveHandler;
@@ -147,59 +225,58 @@ export declare class CircleTool extends DrawingToolBase {
 	private _drawEdgeHandles;
 	private _drawLabel;
 	private _hexToRgba;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	hitTestEndpoint(x: number, y: number): "center" | "edge" | null;
-	startDrag(target: "center" | "edge"): void;
+	startDrag(target: "center" | "edge", grab: DragAnchor): void;
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
 }
 /**
- * Draggable Price Line - Línea de precio que se puede arrastrar y/o hacer click
- */
-export declare class DraggablePriceLine {
-	private _chart;
-	private _series;
+ * A price line that can be dragged and clicked.
+ *
+ * Input is not handled here: every line on a chart shares a single
+ * TradingLineController, which is what guarantees that one gesture moves one
+ * line. Hit testing comes from the engine — the line's id travels as the price
+ * line's `externalId` — so the hit area matches what is drawn.
+ */
+export declare class DraggablePriceLine implements ControllableLine {
+	private readonly _chart;
+	private readonly _series;
+	private readonly _id;
 	private _priceLine;
 	private _options;
-	private _isDragging;
-	private _container;
-	private _unsubscribeHandlers;
 	private _isHovering;
 	private _originalColor;
-	private _mouseDownPos;
-	private _mouseDownOnLine;
+	private _priceBeforeDrag;
 	constructor(chart: IChartApi, series: ISeriesApi<SeriesType>, options: DraggablePriceLineOptions);
-	/**
-	 * Resolve the effective title: formatTitle(price) wins over the static title.
-	 */
-	private _resolveTitle;
-	private _createPriceLine;
-	private _setupInteractionHandlers;
-	private _getPriceFromY;
-	/**
-	 * Verifica si el mouse está EN la línea (no cerca, sino exactamente sobre ella)
-	 * Usa la API de coordenadas del chart para precisión consistente
-	 * @param e - Mouse event
-	 * @param price - Precio calculado desde la posición Y
-	 */
-	private _isOnLine;
-	/**
-	 * Verifica si el mouse está en el área del gráfico (no en el price axis)
-	 */
-	private _isInChartArea;
-	/**
-	 * Activa/desactiva el estado de hover (línea negra)
-	 */
-	private _setHoverState;
-	private _updatePrice;
+	id(): string;
+	paneIndex(): number;
+	isDraggable(): boolean;
+	isClickable(): boolean;
+	setHovered(hovered: boolean): void;
+	priceAt(paneY: number): number | null;
+	beginDrag(): void;
+	dragTo(price: number): void;
+	commitDrag(): void;
+	cancelDrag(): void;
+	click(): void;
 	/**
 	 * Update the price line options. Any subset of options can be passed.
 	 * Title is recomputed from `formatTitle` if available, otherwise from `title`.
@@ -210,22 +287,19 @@ export declare class DraggablePriceLine {
 	 * line's price (e.g. live PnL on a fixed entry line). Bypasses formatTitle.
 	 */
 	setTitle(text: string): void;
-	/**
-	 * Get current price
-	 */
 	getPrice(): number;
 	/**
 	 * Set price programmatically. Triggers formatTitle if configured.
 	 */
 	setPrice(price: number): void;
-	/**
-	 * Remove the price line and cleanup
-	 */
 	remove(): void;
+	getPriceLine(): IPriceLine | null;
 	/**
-	 * Get the underlying price line
+	 * Resolve the effective title: formatTitle(price) wins over the static title.
 	 */
-	getPriceLine(): IPriceLine | null;
+	private _resolveTitle;
+	private _createPriceLine;
+	private _updatePrice;
 }
 /**
  * Central manager for all drawing tools - TradingView style
@@ -233,6 +307,13 @@ export declare class DraggablePriceLine {
  */
 export declare class DrawingToolsManager {
 	private _chart;
+	private _series;
+	/** Snapshots of the drawings, newest last. */
+	private _past;
+	private _future;
+	/** State as of the last committed change, the one undo goes back to. */
+	private _committed;
+	private _restoring;
 	private _tools;
 	private _selectedToolId;
 	private _hoveredToolId;
@@ -241,16 +322,25 @@ export declare class DrawingToolsManager {
 	private _clickHandler;
 	private _keyboardHandler;
 	private _mouseMoveHandler;
-	private _mouseDownHandler;
-	private _mouseUpHandler;
-	private _toolIdCounter;
+	private _pointerDownHandler;
+	private _pointerUpHandler;
+	private _pointerCancelHandler;
+	private _pointerId;
+	/** A press that grabbed a tool already selected it; its click must not undo that. */
+	private _gestureHandled;
+	/** Latest pointer position in pane coordinates, from the engine. */
+	private _panePoint;
+	private _interactionsBeforeDrag;
+	private readonly _selectionChanged;
 	private _isDragging;
 	private _draggedToolId;
-	constructor(chart: IChartApi, _series: ISeriesApi<any>, options?: DrawingToolsManagerOptions);
+	constructor(chart: IChartApi, series: ISeriesApi<any>, options?: DrawingToolsManagerOptions);
 	/**
 	 * Start drawing a new tool of the specified type
 	 */
 	startDrawing(type: DrawingToolType): void;
+	/** Tool type currently armed for drawing, if any. */
+	activeDrawingType(): DrawingToolType | null;
 	/**
 	 * Stop drawing mode
 	 */
@@ -258,6 +348,11 @@ export declare class DrawingToolsManager {
 	/**
 	 * Add a tool to the manager
 	 */
+	/**
+	 * Tools are keyed by their own id. They used to be filed under a counter
+	 * instead, so the id a tool reported and the one the manager answered to
+	 * were different, and neither survived a restore.
+	 */
 	addTool(tool: DrawingToolBase, id?: string): string;
 	/**
 	 * Remove a tool by ID
@@ -267,6 +362,42 @@ export declare class DrawingToolsManager {
 	 * Select a tool by ID
 	 */
 	selectTool(id: string): boolean;
+	/**
+	 * Single place where the selection changes, so every path — clicking,
+	 * grabbing, deleting, clearing — reports it exactly once.
+	 */
+	private _applySelection;
+	/**
+	 * Commits the current drawings as a step that can be undone.
+	 *
+	 * Called by the manager on the changes it sees — adding, removing, clearing
+	 * and finishing a drag. Anything the app changes on a tool directly, such as
+	 * its colour, should call this afterwards.
+	 */
+	recordChange(): void;
+	canUndo(): boolean;
+	canRedo(): boolean;
+	undo(): boolean;
+	redo(): boolean;
+	private _applySnapshot;
+	/**
+	 * Notifies every selection change, so consumers do not have to poll for it.
+	 */
+	subscribeSelectionChanged(handler: (selection: DrawingSelection) => void): void;
+	unsubscribeSelectionChanged(handler: (selection: DrawingSelection) => void): void;
+	/**
+	 * Screen box of the selected tool, recomputed on demand: it moves whenever
+	 * the chart is panned or zoomed.
+	 */
+	selectionBounds(): DrawingBounds | null;
+	/**
+	 * 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;
+	/** Panes below the first one are offset inside the chart element. */
+	private _paneOffsetOf;
+	private _emitSelection;
 	/**
 	 * Deselect all tools
 	 */
@@ -328,12 +459,35 @@ export declare class DrawingToolsManager {
 	private _detachEventHandlers;
 	private _handleClick;
 	private _handleMouseMove;
-	private _handleMouseDown;
-	private _handleMouseUp;
+	/**
+	 * Resolve the tool behind an `externalId` reported by the engine's hit test.
+	 * Ids carry the hovered part after `#`. Returns null for ids belonging to
+	 * other primitives.
+	 */
+	private _findToolByExternalId;
+	private _handlePointerDown;
+	private _handlePointerUp;
+	/**
+	 * Pane element of a tool's series. The engine asserts the series has a pane,
+	 * so the lookup is guarded.
+	 */
+	private _paneElementOf;
+	/**
+	 * Resolve what a pointer event lands on without relying on a previous hover.
+	 * Coordinates come from each tool's own pane, so tools in secondary panes
+	 * are hit tested correctly. Overlaps resolve to the first match here, unlike
+	 * the hover path, which the engine arbitrates by z-order.
+	 */
+	private _hitAtEvent;
+	private _releasePointer;
 	private _disableChartInteractions;
 	private _enableChartInteractions;
 	private _handleKeyboard;
-	private _findToolAtPoint;
+	/**
+	 * Pointer position in time/price space, used as the anchor of a drag gesture.
+	 * Returns null when the price cannot be resolved, in which case no drag starts.
+	 */
+	private _anchorAt;
 	private _deselectAll;
 }
 export declare class FibonacciCalculator {
@@ -381,6 +535,7 @@ export declare class FibonacciCalculator {
 export declare class FibonacciExtensionTool extends DrawingToolBase {
 	private _fibOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
@@ -398,9 +553,18 @@ export declare class FibonacciExtensionTool extends DrawingToolBase {
 	setPoint2(point: FibonacciExtensionPoint): void;
 	setPoint3(point: FibonacciExtensionPoint): void;
 	isComplete(): boolean;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	hitTestEndpoint(x: number, y: number): "point1" | "point2" | "point3" | null;
 	startDrag(target: "point1" | "point2" | "point3"): void;
@@ -415,7 +579,7 @@ export declare class FibonacciExtensionTool extends DrawingToolBase {
 	}>;
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
@@ -423,6 +587,7 @@ export declare class FibonacciExtensionTool extends DrawingToolBase {
 export declare class FibonacciFanTool extends DrawingToolBase {
 	private _fanOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
@@ -441,9 +606,18 @@ export declare class FibonacciFanTool extends DrawingToolBase {
 	private _drawLine;
 	private _drawEndpoint;
 	private _drawLabel;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	private _distanceToLineSegment;
 	hitTestEndpoint(x: number, y: number): "point1" | "point2" | null;
@@ -451,7 +625,7 @@ export declare class FibonacciFanTool extends DrawingToolBase {
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
@@ -464,11 +638,13 @@ export declare class FibonacciTool extends DrawingToolBase {
 	private _fibOptions;
 	private _calculator;
 	private _primitive;
+	private _repaint;
 	private _metrics;
 	private _paneView;
 	private _drawingManager;
 	private _isComplete;
 	private _isSelected;
+	private _isHovered;
 	private _previewPoint;
 	private _isDragging;
 	private _draggedEndpoint;
@@ -484,7 +660,7 @@ export declare class FibonacciTool extends DrawingToolBase {
 	getMetrics(): FibonacciMetrics | null;
 	getLevels(): FibonacciLevel[];
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	useExtendedLevels(extended: boolean): void;
 	private _initializeInteractiveMode;
 	private _drawPreview;
@@ -494,9 +670,20 @@ export declare class FibonacciTool extends DrawingToolBase {
 	private _handleDragMove;
 	startDrag(endpoint: "point1" | "point2"): void;
 	stopDrag(): void;
+	updateDrag(time: Time, price: number): void;
 	hitTestEndpoint(x: number, y: number): "point1" | "point2" | null;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
+	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
 	isSelected(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	remove(): void;
 	destroy(): void;
@@ -506,9 +693,14 @@ export declare class FibonacciTool extends DrawingToolBase {
 export declare class GanttTool extends DrawingToolBase {
 	private _ganttOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
+	private _isDragging;
+	private _dragSegmentIndex;
+	private _grab;
+	private _moveStart;
 	private _hoveredSegmentIndex;
 	constructor(context: DrawingContext, options: GanttToolOptions);
 	private _createPrimitive;
@@ -521,12 +713,28 @@ export declare class GanttTool extends DrawingToolBase {
 	addSegment(segment: GanttSegment): void;
 	removeSegment(index: number): void;
 	getSegments(): GanttSegment[];
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor.
+	 */
+	private _hitTestPrimitive;
+	/**
+	 * Segments are dragged as a whole along the time axis; the hovered one is
+	 * resolved by `hitTest`, which records its index.
+	 */
+	hitTestEndpoint(x: number, y: number): "move" | null;
+	startDrag(target: "move", grab: DragAnchor): void;
+	updateDrag(time: Time, price: number): void;
+	stopDrag(): void;
 	hitTest(x: number, y: number): boolean;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
@@ -534,28 +742,40 @@ export declare class GanttTool extends DrawingToolBase {
 export declare class HorizontalLineTool extends DrawingToolBase {
 	private _hLineOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
 	private _isDragging;
+	private _grab;
+	private _moveStartPrice;
 	constructor(context: DrawingContext, options: HorizontalLineToolOptions);
 	private _createPrimitive;
 	private _createPaneView;
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
 	private _drawLabel;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	hitTestEndpoint(x: number, y: number): "line" | null;
-	startDrag(target: "line"): void;
+	startDrag(target: "line", grab: DragAnchor): void;
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
 	getPrice(): number | undefined;
 	setPrice(price: number): void;
 	setLabel(text: string): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
@@ -572,6 +792,10 @@ export declare class InteractiveLineManager {
 	private _customOptions;
 	constructor(chart: IChartApi, series: ISeriesApi<SeriesType>);
 	private _setupContainer;
+	/**
+	 * Y is measured against the series' own pane, so lines created on a pane
+	 * below the main one land on the price the user clicked.
+	 */
 	private _getPriceFromMouseEvent;
 	/**
 	 * Activa el modo de creación de líneas por clic
@@ -698,14 +922,15 @@ export declare class PositionTool extends DrawingToolBase {
 	private _positionOptions;
 	private _calculator;
 	private _primitive;
+	private _repaint;
 	private _metrics;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
 	private _isDragging;
 	private _dragTarget;
-	private _dragStartPrice;
-	private _dragStartTime;
+	private _grab;
+	private _moveStart;
 	private _profitRect;
 	private _lossRect;
 	constructor(context: DrawingContext, options: PositionToolOptions);
@@ -740,16 +965,24 @@ export declare class PositionTool extends DrawingToolBase {
 	 * Set entry price
 	 */
 	setEntryPrice(price: number): void;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	hitTestEndpoint(x: number, y: number): "tp" | "sl" | "tp-right" | "sl-right" | "entry" | "move" | null;
-	startDrag(target: "tp" | "sl" | "tp-right" | "sl-right" | "entry" | "move"): void;
+	startDrag(target: "tp" | "sl" | "tp-right" | "sl-right" | "entry" | "move", grab: DragAnchor): void;
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
-	private _getTimeDelta;
 	private _addTimeDelta;
 	private _requestUpdate;
 	protected _update(): void;
@@ -758,11 +991,13 @@ export declare class PositionTool extends DrawingToolBase {
 export declare class RectangleTool extends DrawingToolBase {
 	private _rectOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
 	private _isDragging;
 	private _dragTarget;
+	private _grab;
 	private _dragStartPoint1;
 	private _dragStartPoint2;
 	private _isDrawing;
@@ -777,16 +1012,25 @@ export declare class RectangleTool extends DrawingToolBase {
 	private _drawCornerHandles;
 	private _drawLabel;
 	private _hexToRgba;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	hitTestEndpoint(x: number, y: number): "corner1" | "corner2" | "corner3" | "corner4" | "body" | null;
-	startDrag(target: "corner1" | "corner2" | "corner3" | "corner4" | "body"): void;
+	startDrag(target: "corner1" | "corner2" | "corner3" | "corner4" | "body", grab: DragAnchor): void;
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
@@ -839,11 +1083,13 @@ export declare class RulerTool extends DrawingToolBase {
 	private _rulerOptions;
 	private _calculator;
 	private _primitive;
+	private _repaint;
 	private _metrics;
 	private _paneView;
 	private _drawingManager;
 	private _isComplete;
 	private _isSelected;
+	private _isHovered;
 	private _previewPoint;
 	private _isDragging;
 	private _draggedEndpoint;
@@ -873,20 +1119,31 @@ export declare class RulerTool extends DrawingToolBase {
 	 * Stop dragging
 	 */
 	stopDrag(): void;
+	updateDrag(time: Time, price: number): void;
 	/**
 	 * Check if a point is near an endpoint
 	 */
 	hitTestEndpoint(x: number, y: number): "point1" | "point2" | null;
 	private _requestUpdate;
 	protected _update(): void;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
+	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
 	isSelected(): boolean;
 	isComplete(): boolean;
 	/**
 	 * Hit test - check if a point is near the ruler line
 	 * Returns true if the point is within tolerance distance from the line
 	 */
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	/**
 	 * Calculate distance from a point to a line segment
@@ -896,10 +1153,14 @@ export declare class RulerTool extends DrawingToolBase {
 export declare class TextTool extends DrawingToolBase {
 	private _textOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
 	private _isDragging;
+	private _dragTarget;
+	private _grab;
+	private _moveStart;
 	private _isEditing;
 	private _clickOutsideHandler;
 	constructor(context: DrawingContext, options: TextToolOptions);
@@ -915,19 +1176,28 @@ export declare class TextTool extends DrawingToolBase {
 	private _requestUpdate;
 	protected _update(): void;
 	isComplete(): boolean;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
 	setEditing(editing: boolean): void;
 	isEditing(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	hitTestEndpoint(x: number, y: number): "anchor" | null;
-	startDrag(target: "anchor" | "body"): void;
+	startDrag(target: "anchor" | "body", grab: DragAnchor): void;
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
 	private _hexToRgba;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	remove(): void;
 }
 export declare class TradingSessionsIndicator {
@@ -963,11 +1233,13 @@ export declare class TradingSessionsIndicator {
 export declare class TrendLineTool extends DrawingToolBase {
 	private _trendOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
 	private _isDragging;
 	private _dragTarget;
+	private _grab;
 	private _dragStartPoint1;
 	private _dragStartPoint2;
 	private _isComplete;
@@ -979,17 +1251,26 @@ export declare class TrendLineTool extends DrawingToolBase {
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
 	private _drawPreview;
 	private _drawEndpoint;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
+	isHovered(): boolean;
 	setHovered(hovered: boolean): void;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Geometry comes from
+	 * `hitTestEndpoint` so there is a single implementation of it.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	private _distanceToLineSegment;
 	hitTestEndpoint(x: number, y: number): "point1" | "point2" | "line" | null;
-	startDrag(target: "point1" | "point2" | "line"): void;
+	startDrag(target: "point1" | "point2" | "line", grab: DragAnchor): void;
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
@@ -997,28 +1278,40 @@ export declare class TrendLineTool extends DrawingToolBase {
 export declare class VerticalLineTool extends DrawingToolBase {
 	private _vLineOptions;
 	private _primitive;
+	private _repaint;
 	private _paneView;
 	private _isSelected;
 	private _isHovered;
 	private _isDragging;
+	private _grab;
+	private _moveStartTime;
 	constructor(context: DrawingContext, options: VerticalLineToolOptions);
 	private _createPrimitive;
 	private _createPaneView;
 	drawToCanvas(ctx: CanvasRenderingContext2D, horizontalPixelRatio: number, verticalPixelRatio: number): void;
 	private _drawLabel;
+	setColor(color: string): void;
+	color(): string;
 	setSelected(selected: boolean): void;
 	isSelected(): boolean;
 	setHovered(hovered: boolean): void;
+	isHovered(): boolean;
+	/**
+	 * Hit test reported to the chart engine, which arbitrates between overlapping
+	 * primitives by z-order and owns the cursor. Handles come first so they win
+	 * over the body of the object.
+	 */
+	private _hitTestPrimitive;
 	hitTest(x: number, y: number): boolean;
 	hitTestEndpoint(x: number, y: number): "line" | null;
-	startDrag(target: "line"): void;
+	startDrag(target: "line", grab: DragAnchor): void;
 	stopDrag(): void;
 	updateDrag(time: Time, price: number): void;
 	getTime(): Time | undefined;
 	setTime(time: Time): void;
 	setLabel(text: string): void;
 	isVisible(): boolean;
-	serialize(): SerializedDrawingTool;
+	protected _serializeShape(): SerializedDrawingTool;
 	private _requestUpdate;
 	protected _update(): void;
 	remove(): void;
@@ -1261,7 +1554,10 @@ export declare enum TrackingModeExitMode {
  * @param options - ATR configuration
  * @returns The ATR line series
  */
-export declare function applyATR(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: ATROptions): ISeriesApi<"Line">;
+export declare function applyATR(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: ATROptions): {
+	series: ISeriesApi<"Line">;
+	remove(): void;
+};
 /**
  * Apply Bollinger Bands indicator to a series
  * @param series - Source series
@@ -1273,6 +1569,7 @@ export declare function applyBollingerBands(series: ISeriesApi<SeriesType>, char
 	upper: ISeriesApi<"Line">;
 	middle: ISeriesApi<"Line">;
 	lower: ISeriesApi<"Line">;
+	remove(): void;
 };
 /**
  * Apply EMA (Exponential Moving Average) indicator to a series
@@ -1281,7 +1578,10 @@ export declare function applyBollingerBands(series: ISeriesApi<SeriesType>, char
  * @param options - EMA configuration options
  * @returns The EMA line series
  */
-export declare function applyEMA(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: EMAOptions): ISeriesApi<"Line">;
+export declare function applyEMA(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: EMAOptions): {
+	series: ISeriesApi<"Line">;
+	remove(): void;
+};
 /**
  * Apply MACD indicator to a series
  * @param series - Source series
@@ -1293,6 +1593,7 @@ export declare function applyMACD(series: ISeriesApi<SeriesType>, chart: IChartA
 	macd: ISeriesApi<"Line">;
 	signal: ISeriesApi<"Line">;
 	histogram: ISeriesApi<"Histogram">;
+	remove(): void;
 };
 /**
  * Apply OBV (On-Balance Volume) indicator to a series
@@ -1301,7 +1602,10 @@ export declare function applyMACD(series: ISeriesApi<SeriesType>, chart: IChartA
  * @param options - OBV configuration
  * @returns The OBV line series
  */
-export declare function applyOBV(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: OBVOptions): ISeriesApi<"Line">;
+export declare function applyOBV(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: OBVOptions): {
+	series: ISeriesApi<"Line">;
+	remove(): void;
+};
 /**
  * Apply RSI indicator to a series
  * @param series - Source series to calculate RSI from
@@ -1309,7 +1613,10 @@ export declare function applyOBV(series: ISeriesApi<SeriesType>, chart: IChartAp
  * @param options - RSI configuration options
  * @returns The RSI line series
  */
-export declare function applyRSI(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: RSIOptions): ISeriesApi<"Line">;
+export declare function applyRSI(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: RSIOptions): {
+	series: ISeriesApi<"Line">;
+	remove(): void;
+};
 /**
  * Apply SMA (Simple Moving Average) indicator to a series
  * @param series - Source series to calculate SMA from
@@ -1317,7 +1624,10 @@ export declare function applyRSI(series: ISeriesApi<SeriesType>, chart: IChartAp
  * @param options - SMA configuration options
  * @returns The SMA line series
  */
-export declare function applySMA(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: SMAOptions): ISeriesApi<"Line">;
+export declare function applySMA(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: SMAOptions): {
+	series: ISeriesApi<"Line">;
+	remove(): void;
+};
 /**
  * Apply Stochastic Oscillator indicator to a series
  * @param series - Source series
@@ -1328,6 +1638,7 @@ export declare function applySMA(series: ISeriesApi<SeriesType>, chart: IChartAp
 export declare function applyStochastic(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: StochasticOptions): {
 	k: ISeriesApi<"Line">;
 	d: ISeriesApi<"Line">;
+	remove(): void;
 };
 /**
  * Apply Volume indicator to a series
@@ -1337,7 +1648,10 @@ export declare function applyStochastic(series: ISeriesApi<SeriesType>, chart: I
  * @param options - Volume configuration
  * @returns The Volume histogram series
  */
-export declare function applyVolume(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: VolumeOptions): ISeriesApi<"Histogram">;
+export declare function applyVolume(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: VolumeOptions): {
+	series: ISeriesApi<"Histogram">;
+	remove(): void;
+};
 /**
  * Apply WMA (Weighted Moving Average) indicator to a series
  * @param series - Source series to calculate WMA from
@@ -1345,14 +1659,21 @@ export declare function applyVolume(series: ISeriesApi<SeriesType>, chart: IChar
  * @param options - WMA configuration options
  * @returns The WMA line series
  */
-export declare function applyWMA(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: WMAOptions): ISeriesApi<"Line">;
+export declare function applyWMA(series: ISeriesApi<SeriesType>, chart: IChartApi, options?: WMAOptions): {
+	series: ISeriesApi<"Line">;
+	remove(): void;
+};
 /**
  * Automatically calculate pip configuration based on price
  * This is completely generic and works for any instrument
  */
 export declare function calculatePipConfig(price: number): PipConfig;
+/**
+ * Horizontal coordinate of a time, including times beyond the last bar.
+ */
+export declare function coordinateFromTime(chart: IChartApi, series: ISeriesApi<SeriesType>, time: Time | undefined | null): number | null;
 export declare function createArrowTool(context: DrawingContext, options: ArrowToolOptions): ArrowTool;
-export declare function createBrushTool(context: DrawingContext, options: BrushToolOptions): BrushTool;
+export declare function createBrushTool(context: DrawingContext, options?: BrushToolOptions): BrushTool;
 /**
  * This function is the simplified main entry point of the Lightweight Charting Library with time points for the horizontal scale.
  *
@@ -1693,11 +2014,17 @@ export declare function setVolumeProfileData(indicator: VolumeProfileIndicator,
 	time: Time;
 	volume: number;
 }>): void;
+/**
+ * Time at a horizontal coordinate, extrapolated past the last bar.
+ */
+export declare function timeFromCoordinate(chart: IChartApi, series: ISeriesApi<SeriesType>, x: number): Time | null;
 /**
  * Returns the current version as a string. For example `'1.0.0'`.
  */
 export declare function version(): string;
 export interface ATROptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	period?: number;
 	color?: string;
 }
@@ -2122,6 +2449,8 @@ export interface BaselineStyleOptions {
 	lastPriceAnimation: LastPriceAnimationMode;
 }
 export interface BollingerBandsOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	period?: number;
 	stdDev?: number;
 	colorUpper?: string;
@@ -2136,7 +2465,10 @@ export interface BrushToolOptions extends DrawingToolOptions {
 	points?: BrushPoint[];
 	color?: string;
 	lineWidth?: number;
+	/** Draw the stroke as curves through the sampled points. */
 	smoothing?: boolean;
+	/** Minimum distance in pixels between sampled points. */
+	sampleDistance?: number;
 	onUpdate?: () => void;
 	onRemove?: () => void;
 	onComplete?: () => void;
@@ -2358,6 +2690,23 @@ export interface CircleToolOptions extends DrawingToolOptions {
 	onUpdate?: () => void;
 	onRemove?: () => void;
 }
+/**
+ * What the controller needs from a line to drive it. Kept to plain values and
+ * public methods so the build-time property mangler cannot rename them apart.
+ */
+export interface ControllableLine {
+	id(): string;
+	paneIndex(): number;
+	isDraggable(): boolean;
+	isClickable(): boolean;
+	setHovered(hovered: boolean): void;
+	priceAt(paneY: number): number | null;
+	beginDrag(): void;
+	dragTo(price: number): void;
+	commitDrag(): void;
+	cancelDrag(): void;
+	click(): void;
+}
 /** Structure describing a crosshair line (vertical or horizontal) */
 export interface CrosshairLineOptions {
 	/**
@@ -2478,6 +2827,18 @@ export interface CustomStyleOptions {
 	 */
 	color: string;
 }
+/**
+ * Pointer position captured when a drag gesture starts. Whole-object moves are
+ * computed as an offset from this anchor, so the object keeps its position
+ * relative to the cursor instead of snapping one of its points under it.
+ *
+ * `time` is null when the gesture starts past the last bar, where the time scale
+ * has no value to report; in that case the object only moves vertically.
+ */
+export interface DragAnchor {
+	time: Time | null;
+	price: number;
+}
 export interface DraggablePriceLineOptions {
 	price: number;
 	color: string;
@@ -2486,13 +2847,14 @@ export interface DraggablePriceLineOptions {
 	title?: string;
 	axisLabelVisible?: boolean;
 	draggable?: boolean;
+	/** Colour applied while the pointer is over the line. */
+	hoverColor?: string;
 	onDragStart?: (price: number) => void;
 	onDragMove?: (price: number) => void;
 	onDragEnd?: (price: number) => void;
 	/**
-	 * Fires when the user clicks the line without dragging it.
-	 * Triggered on mouseup if the mouse moved less than CLICK_TOLERANCE_PX
-	 * from the initial mousedown position. Works regardless of `draggable`.
+	 * Fires when the user clicks the line without dragging it. Works regardless
+	 * of `draggable`.
 	 */
 	onClick?: (price: number) => void;
 	/**
@@ -2507,6 +2869,16 @@ 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.
+ */
+export interface DrawingBounds {
+	left: number;
+	top: number;
+	right: number;
+	bottom: number;
+}
 /**
  * Context passed to drawing tools
  */
@@ -2514,6 +2886,11 @@ export interface DrawingContext {
 	chart: IChartApi;
 	series: ISeriesApi<SeriesType>;
 }
+/** Payload of a selection change. Null id means nothing is selected. */
+export interface DrawingSelection {
+	id: string | null;
+	bounds: DrawingBounds | null;
+}
 /**
  * Base options for all drawing tools
  */
@@ -2543,6 +2920,8 @@ export interface DrawingUtils {
 	readonly setLineStyle: (ctx: CanvasRenderingContext2D, lineStyle: LineStyle) => void;
 }
 export interface EMAOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	period?: number;
 	color?: string;
 }
@@ -4726,6 +5105,8 @@ export interface LocalizationOptionsBase {
 	tickmarksPercentageFormatter?: TickmarksPercentageFormatterFn;
 }
 export interface MACDOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	fastPeriod?: number;
 	slowPeriod?: number;
 	signalPeriod?: number;
@@ -4778,6 +5159,8 @@ export interface MouseEventParams<HorzScaleItem = Time> {
 	sourceEvent?: TouchMouseEventData;
 }
 export interface OBVOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	color?: string;
 	data?: any[];
 }
@@ -5238,6 +5621,8 @@ export interface PrimitiveHoveredItem {
 	isBackground?: boolean;
 }
 export interface RSIOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	period?: number;
 	color?: string;
 }
@@ -5293,6 +5678,8 @@ export interface RulerToolOptions extends DrawingToolOptions {
 	onRemove?: () => void;
 }
 export interface SMAOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	period?: number;
 	color?: string;
 	lineWidth?: number;
@@ -5302,7 +5689,13 @@ export interface SMAOptions {
  * with everything needed to recreate a tool.
  */
 export interface SerializedDrawingTool {
+	/** Identity of the tool, so it survives a save and restore. */
+	id?: string;
 	type: string;
+	/** Hidden tools used to come back visible. */
+	visible?: boolean;
+	/** Locked tools used to come back unlocked. */
+	locked?: boolean;
 	points: Array<{
 		price: number;
 		time: Time | null;
@@ -5758,6 +6151,8 @@ export interface SolidColor {
 	color: string;
 }
 export interface StochasticOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	kPeriod?: number;
 	dPeriod?: number;
 	colorK?: string;
@@ -6118,6 +6513,8 @@ export interface VerticalLineToolOptions extends DrawingToolOptions {
 	onRemove?: () => void;
 }
 export interface VolumeOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	colorUp?: string;
 	colorDown?: string;
 }
@@ -6141,6 +6538,8 @@ export interface VolumeProfileOptions {
 	position?: "left" | "right";
 }
 export interface WMAOptions {
+	/** Pane the indicator is drawn in. Defaults to its historical value. */
+	paneIndex?: number;
 	period?: number;
 	color?: string;
 }
@@ -6324,6 +6723,11 @@ export type DataItem<HorzScaleItem> = SeriesDataItemTypeMap<HorzScaleItem>[Serie
 export type DeepPartial<T> = {
 	[P in keyof T]?: T[P] extends (infer U)[] ? DeepPartial<U>[] : T[P] extends readonly (infer X)[] ? readonly DeepPartial<X>[] : DeepPartial<T[P]>;
 };
+/**
+ * A grabbable part of a tool: a named handle ('point1', 'body', 'tp'…) or an
+ * index, as the arrow and gantt tools report.
+ */
+export type DrawingPart = string | number;
 export type DrawingToolType = "ruler" | "fibonacci" | "position" | "trendline" | "rectangle";
 /**
  * Green component of the RGB color value