@luxalgo/vela 0.8.3 → 0.8.5

package/dist/{chunk-G7B7ZCBF.js → chunk-WY5H4S4I.js}

@@ -1,4 +1,4 @@
-import { overlayScrollbarCss, isDarkColor, mix, HIGHLIGHT, ACCENT_BRIGHT, ACCENT, withAlpha, injectStyles, announceSurface, holdForExit, iconAt, iconEl, BULLISH, BEARISH, WARNING, NEUTRAL } from './chunk-VHGACEHO.js';
+import { overlayScrollbarCss, isDarkColor, mix, HIGHLIGHT, ACCENT_BRIGHT, ACCENT, withAlpha, injectStyles, announceSurface, holdForExit, iconAt, iconEl, BULLISH, BEARISH, WARNING, NEUTRAL } from './chunk-I2U4NZD2.js';
 import { VanillaMachine, normalizeProps, spreadProps } from '@zag-js/vanilla';
 export { normalizeProps, spreadProps } from '@zag-js/vanilla';
 import * as menu from '@zag-js/menu';

package/dist/{contributions-HGqnNb_P.d.ts → contributions-D8xuYc9U.d.cts}

@@ -1,5 +1,5 @@
-import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, a_ as SeriesSpec, ak as Fill, H as Background, aQ as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-lMUwmRwh.js';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-oH78tYXL.js';
+import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, a_ as SeriesSpec, ak as Fill, H as Background, aQ as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-BI5Tp32b.cjs';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-DdqMxKdl.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -502,7 +502,13 @@ interface NativeIndicatorContext {
     bars(): readonly OHLCV[];
     /** Market-data access (trades / capabilities) for data-driven natives. */
     readonly data: DataControl;
-    /** Push a fresh render output; the chart mounts it (first call) or patches it (subsequent). */
+    /**
+     * Push a fresh render output; the chart mounts it (first call) or patches it (subsequent).
+     * Series payloads are index-aligned: one slot per bar of `bars()` AS IT STANDS AT THE
+     * CALL, first slot on its first bar. The chart keeps an emitted output on those bars
+     * when history later lands in front of them (or the oldest bars are trimmed), until the
+     * next emit replaces it.
+     */
     emit(out: NativeIndicatorOutput): void;
     /**
      * Push a BESPOKE render payload to the renderer's native layer for this indicator's type (for a
@@ -521,7 +527,8 @@ interface NativeIndicatorContext {
 interface NativeIndicator {
     /** Begin: compute + emit the first output. */
     start(ctx: NativeIndicatorContext, inputs: Record<string, InputValue>): void;
-    /** A live tick arrived (bars changed) — recompute + emit. */
+    /** The bars changed — a live tick, older history landing, or the candles re-derived
+     *  by a price style — recompute + emit. */
     onBars(): void;
     /** The viewport changed (scroll/zoom) — for range-aware natives (see `reactsToViewport`). */
     onViewport(range: VisibleRange): void;
@@ -533,7 +540,10 @@ interface NativeIndicator {
     suspend(): void;
     /** Shown again — resume + re-emit. */
     resume(): void;
-    /** Removed — full teardown (clear caches, stop timers). Only ever called after `start`. */
+    /** Removed, or replaced by a fresh instance (a market switch stops it as the switch
+     *  begins) — full teardown (clear caches, stop timers). Only ever called after `start`.
+     *  Pushes made inside `stop()` still land (a layer-backed native clears its channel
+     *  here); once it returns, the context drops every push and emit. */
     stop(): void;
 }
 /**
@@ -555,6 +565,17 @@ interface NativeIndicatorDescriptor {
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
     readonly reactsToViewport?: boolean;
+    /**
+     * Compute only over the chart's COMPLETE history, the way script indicators do. While
+     * the history is still loading (a deep load streaming in, a source healing a cold
+     * symbol, a deeper depth being fetched), the instance is not started — its legend row
+     * shows a loading state, and `ready` / `indicator:added` wait — or, when it already
+     * runs, `onBars()` is held and the previous output stays on its bars. The first
+     * compute (or the re-run) comes once the history completes, so values computed over
+     * a partial history never paint and never repaint. Absent ⇒ the instance starts on
+     * the first bars and `onBars()` fires for every history chunk as it lands.
+     */
+    readonly waitsForHistory?: boolean;
     /** Marks the type as beta — surfaced in the catalog so a host "add indicator" UI can badge it. */
     readonly beta?: boolean;
     /**
@@ -950,6 +971,17 @@ interface VelaEventMap extends Record<string, unknown> {
     "drawing:favorites": {
         favorites: string[];
     };
+    /** A tool's remembered settings changed — the ones its next drawing starts from (the last
+     *  drawing of that type the user styled, a bulk restore, or a reset). Read them back with
+     *  `drawings.toolDefaults()`. */
+    "drawing:defaults": {
+        type: DrawingTypeKey;
+    };
+    /** A tool's saved looks changed (saved, deleted, or a bulk restore) — read them back with
+     *  `drawings.toolTemplates()`. */
+    "drawing:templates": {
+        type: DrawingTypeKey;
+    };
     /** The armed drawing tool changed — toolbar click, one-shot tool finishing (back to
      *  the pointer, `null`), or a programmatic `drawings.setTool`. */
     "drawing:tool": {
@@ -1294,6 +1326,7 @@ interface PaneController {
     removePaneAndIndicators(paneId: string): void;
     collapsePane(paneId: string, collapsed: boolean): void;
     maximizePane(paneId: string | null): void;
+    setPaneHeightWeight(paneId: string, weight: number): void;
     moveIndicator(id: string, target: MoveTarget): void;
 }
 /**
@@ -1316,6 +1349,14 @@ declare class PanesControl {
     collapse(paneId: string, collapsed?: boolean): this;
     /** Maximize one pane to fill the plot, or restore the split (`null`). */
     maximize(paneId: string | null): this;
+    /**
+     * Set a pane's height weight: the panes share the plot height in proportion to their
+     * weights, so `setHeightWeight('price', 6)` next to two study panes at 1 gives the price
+     * pane three quarters of the height. The weight sticks until the user drags a separator
+     * or it is set again; a collapsed pane applies it when expanded. `weight` must be a
+     * positive number.
+     */
+    setHeightWeight(paneId: string, weight: number): this;
     /** Move/merge an indicator to a pane — sugar for `handle.moveTo(...)` by id. */
     moveIndicator(id: string, target: MoveTarget): this;
     private guard;
@@ -1376,7 +1417,10 @@ declare class DrawingController {
     private favs;
     private selectedIds;
     private clipboard;
-    private readonly lastStyle;
+    /** Per-tool remembered settings — the last drawing of each type the user styled seeds the next. */
+    private readonly defaults;
+    /** Per-tool saved looks ("styles"), in the order they were saved. */
+    private templates;
     private readonly subs;
     constructor(renderer: IChartRenderer, events: TypedEventBus<VelaEventMap>, option: DrawingsOption | undefined, seriesGateway?: DrawingSeriesGateway);
     /** Whether the active renderer supports interactive drawings. */
@@ -1398,6 +1442,24 @@ declare class DrawingController {
     /** Replace the whole favorite set (bulk restore) — unknown types are dropped. */
     setFavorites(types: readonly DrawingTypeKey[]): void;
     private pushFavorites;
+    /** Every tool's remembered settings, by type (plain JSON — persist it as-is). */
+    toolDefaults(): Partial<Record<DrawingTypeKey, DrawingToolDefaults>>;
+    /** Replace every tool's remembered settings (restoring persisted prefs). Unknown types and
+     *  malformed entries are dropped; an unchanged set is a no-op and emits nothing. */
+    setToolDefaults(map: Readonly<Record<string, unknown>> | null | undefined): void;
+    /** Forget a tool's remembered settings (every tool's when `type` is omitted) — new drawings
+     *  start from the factory defaults again. */
+    resetToolDefaults(type?: DrawingTypeKey): void;
+    /** Every tool's saved looks, by type (plain JSON — persist it as-is). */
+    toolTemplates(): Partial<Record<DrawingTypeKey, DrawingToolTemplate[]>>;
+    /** Replace every tool's saved looks (restoring persisted prefs). Unknown types and
+     *  malformed entries are dropped; an unchanged set is a no-op and emits nothing. */
+    setToolTemplates(map: Readonly<Record<string, unknown>> | null | undefined): void;
+    /** Save the given settings as a named look for a tool (a same-named one is replaced). */
+    saveToolTemplate(type: DrawingTypeKey, name: string, settings: DrawingToolDefaults): void;
+    /** Delete a tool's saved look by name. */
+    removeToolTemplate(type: DrawingTypeKey, name: string): void;
+    private pushTemplates;
     setToolbar(option: DrawingsOption): void;
     /** Display (or clear) another chart's in-progress placement as a ghost — silently
      *  inert on a renderer without the optional `setExternalGhost` seam. */
@@ -1462,8 +1524,12 @@ declare class DrawingController {
     /** Add clones (fresh ids, fresh mount-order z) as one undo step + select them. */
     private insertClones;
     private resolve;
-    /** Remember a drawing's style as the "last used" for its type (seeds the next one). */
-    private captureStyle;
+    /** `store.update` that remembers the drawing's settings only when the patch changed them:
+     *  moving an older drawing must not hand its look back to the tool. */
+    private updateDrawing;
+    /** Remember a drawing's settings as its tool's defaults (they seed the next one), and
+     *  announce a real change so a host can save it. */
+    private captureDefaults;
     private sync;
     /** Renderer gesture → authoritative store mutation + event. */
     private onIntent;
@@ -1562,6 +1628,21 @@ declare class DrawingsControl {
     setFavorite(type: DrawingTypeKey, on: boolean): this;
     /** Replace the whole favorite set (e.g. restoring persisted prefs). */
     setFavorites(types: readonly DrawingTypeKey[]): this;
+    /** Every tool's remembered settings, by type — what the next drawing of each type starts
+     *  from (its style, text styling and per-type settings such as fib levels). Plain JSON:
+     *  persist it and hand it back to {@link setToolDefaults} on the next load. */
+    toolDefaults(): Partial<Record<DrawingTypeKey, DrawingToolDefaults>>;
+    /** Replace every tool's remembered settings (e.g. restoring persisted prefs). Malformed
+     *  entries and unknown types are dropped. Follow changes on `drawing:defaults`. */
+    setToolDefaults(map: Readonly<Record<string, unknown>>): this;
+    /** Forget one tool's remembered settings (every tool's without an argument). */
+    resetToolDefaults(type?: DrawingTypeKey): this;
+    /** Every tool's saved looks ("styles" in the settings panel), by type. Plain JSON —
+     *  persist it and hand it back to {@link setToolTemplates}. */
+    toolTemplates(): Partial<Record<DrawingTypeKey, DrawingToolTemplate[]>>;
+    /** Replace every tool's saved looks (e.g. restoring persisted prefs). Follow changes on
+     *  `drawing:templates`. */
+    setToolTemplates(map: Readonly<Record<string, unknown>>): this;
     /** Aliases mirroring `renderer.getConfig()/applyConfig()` for symmetry. */
     getConfig(): DrawingsDocument;
     applyConfig(doc: unknown): this;
@@ -1924,6 +2005,8 @@ interface ContextMenuPointer {
     time: number | null;
     /** The kind of pane the pointer is on; null off the plot. */
     paneKind: 'price' | 'study' | null;
+    /** The id of the pane the pointer is on, as `chart.panes.list()` reports it; null off the plot. */
+    paneId: string | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {

package/dist/{contributions-BhOBRenr.d.cts → contributions-P9fBBuY1.d.ts}

@@ -1,5 +1,5 @@
-import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, a_ as SeriesSpec, ak as Fill, H as Background, aQ as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-lMUwmRwh.cjs';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-wbtJ3-Sa.cjs';
+import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, a_ as SeriesSpec, ak as Fill, H as Background, aQ as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-BI5Tp32b.js';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-BUdlkx9I.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -502,7 +502,13 @@ interface NativeIndicatorContext {
     bars(): readonly OHLCV[];
     /** Market-data access (trades / capabilities) for data-driven natives. */
     readonly data: DataControl;
-    /** Push a fresh render output; the chart mounts it (first call) or patches it (subsequent). */
+    /**
+     * Push a fresh render output; the chart mounts it (first call) or patches it (subsequent).
+     * Series payloads are index-aligned: one slot per bar of `bars()` AS IT STANDS AT THE
+     * CALL, first slot on its first bar. The chart keeps an emitted output on those bars
+     * when history later lands in front of them (or the oldest bars are trimmed), until the
+     * next emit replaces it.
+     */
     emit(out: NativeIndicatorOutput): void;
     /**
      * Push a BESPOKE render payload to the renderer's native layer for this indicator's type (for a
@@ -521,7 +527,8 @@ interface NativeIndicatorContext {
 interface NativeIndicator {
     /** Begin: compute + emit the first output. */
     start(ctx: NativeIndicatorContext, inputs: Record<string, InputValue>): void;
-    /** A live tick arrived (bars changed) — recompute + emit. */
+    /** The bars changed — a live tick, older history landing, or the candles re-derived
+     *  by a price style — recompute + emit. */
     onBars(): void;
     /** The viewport changed (scroll/zoom) — for range-aware natives (see `reactsToViewport`). */
     onViewport(range: VisibleRange): void;
@@ -533,7 +540,10 @@ interface NativeIndicator {
     suspend(): void;
     /** Shown again — resume + re-emit. */
     resume(): void;
-    /** Removed — full teardown (clear caches, stop timers). Only ever called after `start`. */
+    /** Removed, or replaced by a fresh instance (a market switch stops it as the switch
+     *  begins) — full teardown (clear caches, stop timers). Only ever called after `start`.
+     *  Pushes made inside `stop()` still land (a layer-backed native clears its channel
+     *  here); once it returns, the context drops every push and emit. */
     stop(): void;
 }
 /**
@@ -555,6 +565,17 @@ interface NativeIndicatorDescriptor {
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
     readonly reactsToViewport?: boolean;
+    /**
+     * Compute only over the chart's COMPLETE history, the way script indicators do. While
+     * the history is still loading (a deep load streaming in, a source healing a cold
+     * symbol, a deeper depth being fetched), the instance is not started — its legend row
+     * shows a loading state, and `ready` / `indicator:added` wait — or, when it already
+     * runs, `onBars()` is held and the previous output stays on its bars. The first
+     * compute (or the re-run) comes once the history completes, so values computed over
+     * a partial history never paint and never repaint. Absent ⇒ the instance starts on
+     * the first bars and `onBars()` fires for every history chunk as it lands.
+     */
+    readonly waitsForHistory?: boolean;
     /** Marks the type as beta — surfaced in the catalog so a host "add indicator" UI can badge it. */
     readonly beta?: boolean;
     /**
@@ -950,6 +971,17 @@ interface VelaEventMap extends Record<string, unknown> {
     "drawing:favorites": {
         favorites: string[];
     };
+    /** A tool's remembered settings changed — the ones its next drawing starts from (the last
+     *  drawing of that type the user styled, a bulk restore, or a reset). Read them back with
+     *  `drawings.toolDefaults()`. */
+    "drawing:defaults": {
+        type: DrawingTypeKey;
+    };
+    /** A tool's saved looks changed (saved, deleted, or a bulk restore) — read them back with
+     *  `drawings.toolTemplates()`. */
+    "drawing:templates": {
+        type: DrawingTypeKey;
+    };
     /** The armed drawing tool changed — toolbar click, one-shot tool finishing (back to
      *  the pointer, `null`), or a programmatic `drawings.setTool`. */
     "drawing:tool": {
@@ -1294,6 +1326,7 @@ interface PaneController {
     removePaneAndIndicators(paneId: string): void;
     collapsePane(paneId: string, collapsed: boolean): void;
     maximizePane(paneId: string | null): void;
+    setPaneHeightWeight(paneId: string, weight: number): void;
     moveIndicator(id: string, target: MoveTarget): void;
 }
 /**
@@ -1316,6 +1349,14 @@ declare class PanesControl {
     collapse(paneId: string, collapsed?: boolean): this;
     /** Maximize one pane to fill the plot, or restore the split (`null`). */
     maximize(paneId: string | null): this;
+    /**
+     * Set a pane's height weight: the panes share the plot height in proportion to their
+     * weights, so `setHeightWeight('price', 6)` next to two study panes at 1 gives the price
+     * pane three quarters of the height. The weight sticks until the user drags a separator
+     * or it is set again; a collapsed pane applies it when expanded. `weight` must be a
+     * positive number.
+     */
+    setHeightWeight(paneId: string, weight: number): this;
     /** Move/merge an indicator to a pane — sugar for `handle.moveTo(...)` by id. */
     moveIndicator(id: string, target: MoveTarget): this;
     private guard;
@@ -1376,7 +1417,10 @@ declare class DrawingController {
     private favs;
     private selectedIds;
     private clipboard;
-    private readonly lastStyle;
+    /** Per-tool remembered settings — the last drawing of each type the user styled seeds the next. */
+    private readonly defaults;
+    /** Per-tool saved looks ("styles"), in the order they were saved. */
+    private templates;
     private readonly subs;
     constructor(renderer: IChartRenderer, events: TypedEventBus<VelaEventMap>, option: DrawingsOption | undefined, seriesGateway?: DrawingSeriesGateway);
     /** Whether the active renderer supports interactive drawings. */
@@ -1398,6 +1442,24 @@ declare class DrawingController {
     /** Replace the whole favorite set (bulk restore) — unknown types are dropped. */
     setFavorites(types: readonly DrawingTypeKey[]): void;
     private pushFavorites;
+    /** Every tool's remembered settings, by type (plain JSON — persist it as-is). */
+    toolDefaults(): Partial<Record<DrawingTypeKey, DrawingToolDefaults>>;
+    /** Replace every tool's remembered settings (restoring persisted prefs). Unknown types and
+     *  malformed entries are dropped; an unchanged set is a no-op and emits nothing. */
+    setToolDefaults(map: Readonly<Record<string, unknown>> | null | undefined): void;
+    /** Forget a tool's remembered settings (every tool's when `type` is omitted) — new drawings
+     *  start from the factory defaults again. */
+    resetToolDefaults(type?: DrawingTypeKey): void;
+    /** Every tool's saved looks, by type (plain JSON — persist it as-is). */
+    toolTemplates(): Partial<Record<DrawingTypeKey, DrawingToolTemplate[]>>;
+    /** Replace every tool's saved looks (restoring persisted prefs). Unknown types and
+     *  malformed entries are dropped; an unchanged set is a no-op and emits nothing. */
+    setToolTemplates(map: Readonly<Record<string, unknown>> | null | undefined): void;
+    /** Save the given settings as a named look for a tool (a same-named one is replaced). */
+    saveToolTemplate(type: DrawingTypeKey, name: string, settings: DrawingToolDefaults): void;
+    /** Delete a tool's saved look by name. */
+    removeToolTemplate(type: DrawingTypeKey, name: string): void;
+    private pushTemplates;
     setToolbar(option: DrawingsOption): void;
     /** Display (or clear) another chart's in-progress placement as a ghost — silently
      *  inert on a renderer without the optional `setExternalGhost` seam. */
@@ -1462,8 +1524,12 @@ declare class DrawingController {
     /** Add clones (fresh ids, fresh mount-order z) as one undo step + select them. */
     private insertClones;
     private resolve;
-    /** Remember a drawing's style as the "last used" for its type (seeds the next one). */
-    private captureStyle;
+    /** `store.update` that remembers the drawing's settings only when the patch changed them:
+     *  moving an older drawing must not hand its look back to the tool. */
+    private updateDrawing;
+    /** Remember a drawing's settings as its tool's defaults (they seed the next one), and
+     *  announce a real change so a host can save it. */
+    private captureDefaults;
     private sync;
     /** Renderer gesture → authoritative store mutation + event. */
     private onIntent;
@@ -1562,6 +1628,21 @@ declare class DrawingsControl {
     setFavorite(type: DrawingTypeKey, on: boolean): this;
     /** Replace the whole favorite set (e.g. restoring persisted prefs). */
     setFavorites(types: readonly DrawingTypeKey[]): this;
+    /** Every tool's remembered settings, by type — what the next drawing of each type starts
+     *  from (its style, text styling and per-type settings such as fib levels). Plain JSON:
+     *  persist it and hand it back to {@link setToolDefaults} on the next load. */
+    toolDefaults(): Partial<Record<DrawingTypeKey, DrawingToolDefaults>>;
+    /** Replace every tool's remembered settings (e.g. restoring persisted prefs). Malformed
+     *  entries and unknown types are dropped. Follow changes on `drawing:defaults`. */
+    setToolDefaults(map: Readonly<Record<string, unknown>>): this;
+    /** Forget one tool's remembered settings (every tool's without an argument). */
+    resetToolDefaults(type?: DrawingTypeKey): this;
+    /** Every tool's saved looks ("styles" in the settings panel), by type. Plain JSON —
+     *  persist it and hand it back to {@link setToolTemplates}. */
+    toolTemplates(): Partial<Record<DrawingTypeKey, DrawingToolTemplate[]>>;
+    /** Replace every tool's saved looks (e.g. restoring persisted prefs). Follow changes on
+     *  `drawing:templates`. */
+    setToolTemplates(map: Readonly<Record<string, unknown>>): this;
     /** Aliases mirroring `renderer.getConfig()/applyConfig()` for symmetry. */
     getConfig(): DrawingsDocument;
     applyConfig(doc: unknown): this;
@@ -1924,6 +2005,8 @@ interface ContextMenuPointer {
     time: number | null;
     /** The kind of pane the pointer is on; null off the plot. */
     paneKind: 'price' | 'study' | null;
+    /** The id of the pane the pointer is on, as `chart.panes.list()` reports it; null off the plot. */
+    paneId: string | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {