@luxalgo/vela 0.8.2 → 0.8.4

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

@@ -1,4 +1,4 @@
-import { overlayScrollbarCss, isDarkColor, mix, HIGHLIGHT, ACCENT_BRIGHT, ACCENT, withAlpha, injectStyles, announceSurface, iconAt, iconEl, BULLISH, BEARISH, WARNING, NEUTRAL } from './chunk-HKNO24GD.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';
@@ -226,6 +226,35 @@ var MENU_CSS = `
     color: var(--vela-fg-bright);
 }
 .vela-menu-item[data-checkmark] { color: var(--vela-fg-bright); }
+/* Badge mode (iconBadges): the row icon sits in a rounded tile and the row grows to fit
+   it. An icon-less row of the same level keeps an invisible slot, so labels align. */
+.vela-menu[data-badges] > .vela-menu-item { padding: 5px 10px 5px 6px; }
+.vela-menu-item .vela-menu-badge {
+    width: 24px;
+    height: 24px;
+    padding: 3px;
+    flex: none;
+    box-sizing: border-box;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: var(--vela-radius-md);
+    background: var(--vela-hover);
+    border: 1px solid var(--vela-border);
+    color: var(--vela-fg-muted);
+    transition: background var(--vela-dur-fast) var(--vela-ease), border-color var(--vela-dur-fast) var(--vela-ease), color var(--vela-dur-fast) var(--vela-ease);
+}
+.vela-menu-item .vela-menu-badge:empty { background: transparent; border-color: transparent; }
+.vela-menu-item .vela-menu-badge .vela-icon { color: inherit; }
+.vela-menu-item[data-highlighted] .vela-menu-badge:not(:empty) { color: var(--vela-fg-bright); }
+/* The selected tile inverts: a bright fill under the surface-colored glyph. After the
+   hover rule, so a selected row keeps its tile while highlighted. */
+.vela-menu-item[data-checked] .vela-menu-badge:not(:empty),
+.vela-menu-item[data-checkmark] .vela-menu-badge:not(:empty) {
+    background: color-mix(in srgb, var(--vela-fg-bright) 83%, var(--vela-surface));
+    border-color: color-mix(in srgb, var(--vela-fg-bright) 40%, transparent);
+    color: var(--vela-surface);
+}
 /* Switch rows (boolean settings in a dropdown): a right-aligned toggle pill \u2014 the
    same control language as the settings dialog's toggles. */
 .vela-menu-switch {
@@ -292,11 +321,14 @@ var Surface = class _Surface {
     this.pinnedAnchor = null;
     /** The open state last announced — see {@link announce}. */
     this.shown = false;
+    /** The list's exit animation after a close; a reopen cancels it. */
+    this.exit = null;
     this.doc = doc;
     this.host = opts.host;
     this.onSelect = opts.onSelect;
     this.onFavorite = opts.onFavorite;
     this.checkmarks = opts.checkmarks === true;
+    this.iconBadges = opts.iconBadges === true;
     this.positioner = doc.createElement("div");
     this.positioner.className = "vela-ui-layer";
     this.list = doc.createElement("ul");
@@ -327,14 +359,30 @@ var Surface = class _Surface {
     if (opts.triggerId && trigger) trigger.id = opts.triggerId;
     this.handle = runMachine(this.ctrl.machine, this.ctrl.props, (service) => {
       const api = this.ctrl.connect(service);
-      if (this.shown && !api.open) this.announce(false);
+      const closing = this.shown && !api.open;
+      if (closing) this.announce(false);
+      if (api.open && this.exit) {
+        this.exit.cancel();
+        this.exit = null;
+      }
       if (trigger) spreadProps(trigger, api.getTriggerProps(), this.mid);
       spreadProps(this.positioner, api.getPositionerProps(), this.mid);
       spreadProps(this.list, api.getContentProps(), this.mid);
       this.project(api);
+      if (closing) this.holdExit();
       if (api.open && !this.shown) this.announce(true);
     });
   }
+  /** Keep the just-closed list up through its exit animation. `spreadProps` re-applies
+   *  `hidden` only when the machine's value for it changes, so the list stays shown until
+   *  the exit ends — or until a reopen, which projects `hidden: false` itself. */
+  holdExit() {
+    this.list.hidden = false;
+    this.exit = holdForExit(this.list, () => {
+      this.exit = null;
+      if (!this.shown) this.list.hidden = true;
+    });
+  }
   get api() {
     return this.ctrl.connect(this.handle.service);
   }
@@ -358,6 +406,7 @@ var Surface = class _Surface {
   destroy() {
     for (const sub of this.subs.values()) sub.destroy();
     this.subs.clear();
+    this.exit?.finish();
     this.handle.stop();
     if (this.shown) this.announce(false);
     this.positioner.remove();
@@ -384,6 +433,10 @@ var Surface = class _Surface {
     const doc = this.doc;
     this.list.replaceChildren();
     const markable = this.checkmarks && this.items.some((i) => !(i.submenu && i.submenu.length > 0) && !i.toggle && i.checked !== void 0);
+    const iconic = this.items.some((i) => !!i.icon);
+    const badged = this.iconBadges && iconic;
+    if (badged) this.list.dataset.badges = "1";
+    else delete this.list.dataset.badges;
     for (const item of this.items) {
       if (item.separatorBefore) {
         const sep = doc.createElement("li");
@@ -409,7 +462,16 @@ var Surface = class _Surface {
       } else if (!branch && !item.toggle && item.checked) {
         li.dataset.checked = "1";
       }
-      if (item.icon) li.appendChild(iconEl(item.icon, doc));
+      if (badged) {
+        const badge = doc.createElement("span");
+        badge.className = "vela-menu-badge";
+        if (item.icon) badge.appendChild(iconEl(item.icon, doc));
+        li.appendChild(badge);
+      } else if (item.icon) {
+        li.appendChild(iconEl(item.icon, doc));
+      } else if (iconic) {
+        li.appendChild(iconEl("", doc));
+      }
       const label = doc.createElement("span");
       label.className = "vela-menu-label";
       label.textContent = item.label;
@@ -457,6 +519,7 @@ var Surface = class _Surface {
           onSelect: this.onSelect,
           onFavorite: this.onFavorite,
           checkmarks: this.checkmarks,
+          iconBadges: this.iconBadges,
           id: `${this.mid}--${item.id}`
         });
         sub.setItems(item.submenu ?? []);
@@ -482,7 +545,8 @@ var Menu = class {
       id: opts.id,
       minWidth: opts.minWidth,
       onFavorite: opts.onFavorite,
-      checkmarks: opts.checkmarks
+      checkmarks: opts.checkmarks,
+      iconBadges: opts.iconBadges
     });
     this.root.setItems(opts.items);
   }
@@ -586,6 +650,7 @@ var POPOVER_CSS = `
 
 // src/ui/components/popover/view.ts
 var open = null;
+var leaving = /* @__PURE__ */ new Set();
 function closeOpenPopovers() {
   open?.hide();
 }
@@ -613,6 +678,8 @@ var Popover = class {
     this.shown = false;
     /** The pending removal of a fading-out shell; a show() that reuses the shell cancels it. */
     this.leaveTimer = null;
+    /** The shell's exit animation before it leaves the DOM; a show() that reuses the shell cancels it. */
+    this.exit = null;
     const doc = opts.trigger.ownerDocument;
     injectStyles(POPOVER_STYLE_ID, POPOVER_CSS, doc);
     this.trigger = opts.trigger;
@@ -649,6 +716,10 @@ var Popover = class {
       clearTimeout(this.leaveTimer);
       this.leaveTimer = null;
     }
+    this.exit?.cancel();
+    this.exit = null;
+    leaving.delete(this);
+    for (const p of [...leaving]) if (p.trigger === this.trigger) p.exit?.finish();
     ensureUIHost(this.el, this.inheritsTokens ? void 0 : this.theme);
     if (this.fadeMs > 0) {
       this.el.style.transition = `opacity ${this.fadeMs}ms ease`;
@@ -705,7 +776,12 @@ var Popover = class {
         this.el.remove();
       }, this.fadeMs);
     } else {
-      this.el.remove();
+      this.exit = holdForExit(this.el, () => {
+        this.exit = null;
+        leaving.delete(this);
+        this.el.remove();
+      });
+      if (this.exit) leaving.add(this);
     }
     if (open === this) open = null;
     this.ctrl.onClose?.();
@@ -717,6 +793,7 @@ var Popover = class {
   }
   destroy() {
     this.hide();
+    this.exit?.finish();
   }
   reposition() {
     if (this.shown) this.place();
@@ -1394,6 +1471,9 @@ var Dialog = class {
   constructor(opts = {}) {
     this.opener = null;
     this.wasOpen = false;
+    /** The panel and scrim's exit animation after a close; a reopen cancels it. */
+    this.exit = null;
+    this.destroyed = false;
     const doc = (opts.host ?? document.body).ownerDocument;
     injectStyles(DIALOG_STYLE_ID, DIALOG_CSS, doc);
     const host = opts.host ?? doc.body;
@@ -1490,19 +1570,57 @@ var Dialog = class {
     const mid = String(this.ctrl.props.id);
     this.handle = runMachine(this.ctrl.machine, this.ctrl.props, (service) => {
       const api = this.ctrl.connect(service);
-      if (this.wasOpen && !api.open) this.announce(false);
+      const closing = this.wasOpen && !api.open;
+      if (closing) this.announce(false);
       spreadProps(this.backdrop, api.getBackdropProps(), mid);
       spreadProps(this.positioner, api.getPositionerProps(), mid);
       spreadProps(this.panel, api.getContentProps(), mid);
       spreadProps(title, api.getTitleProps(), mid);
       spreadProps(close, api.getCloseTriggerProps(), mid);
-      this.backdrop.style.display = api.open ? "" : "none";
-      this.positioner.style.display = api.open ? "" : "none";
+      if (api.open) {
+        this.exit?.cancel();
+        this.exit = null;
+        this.setShown(true);
+      } else if (closing) {
+        this.holdExit();
+      } else if (!this.exit) {
+        this.setShown(false);
+      }
       if (api.open && !this.wasOpen) this.announce(true);
       if (this.wasOpen && !api.open) this.restoreOpener();
       this.wasOpen = api.open;
     });
   }
+  setShown(shown) {
+    this.backdrop.style.display = shown ? "" : "none";
+    this.positioner.style.display = shown ? "" : "none";
+  }
+  /** Keep the just-closed dialog up through its exit animation, then hide it — or
+   *  remove it, when it was destroyed meanwhile. `spreadProps` re-applies the close
+   *  props' `hidden` only when its value changes, so lifting it keeps the panel and
+   *  scrim up until the exit ends. The positioner spans the viewport: inert, it lets
+   *  clicks through to the page while the panel animates out. */
+  holdExit() {
+    const held = [this.panel, this.backdrop];
+    for (const el of held) el.hidden = false;
+    this.exit = holdForExit(
+      held,
+      () => {
+        this.exit = null;
+        if (this.destroyed) {
+          this.detach();
+        } else if (!this.open) {
+          for (const el of held) el.hidden = true;
+          this.setShown(false);
+        }
+      },
+      { inert: [this.positioner] }
+    );
+  }
+  detach() {
+    this.backdrop.remove();
+    this.positioner.remove();
+  }
   /** Closing hands focus back to whatever opened it (Escape, the ✕, hide(), or a
    *  teardown that outruns the machine's close notification). */
   restoreOpener() {
@@ -1531,15 +1649,16 @@ var Dialog = class {
     return el?.closest(".vela-popover, .vela-menu") != null;
   }
   destroy() {
+    if (this.wasOpen && !this.open) this.handle.flush();
     if (this.open) this.hide();
     this.handle.stop();
+    this.destroyed = true;
     if (this.wasOpen) {
       this.wasOpen = false;
       this.announce(false);
     }
     this.restoreOpener();
-    this.backdrop.remove();
-    this.positioner.remove();
+    if (!this.exit) this.detach();
   }
 };
 

package/dist/{contributions-Cgm9RJYP.d.cts → contributions-BY3zSYiZ.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, aW as SeriesSpec, ak as Fill, H as Background, aM 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, bc 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-NAUHiQEC.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-COGDs9Xg.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-CSXbjMM5.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-Byo8pEv0.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -905,6 +905,21 @@ interface VelaEventMap extends Record<string, unknown> {
      * leave the app theme alone.
      */
     "theme:changed": VelaTheme;
+    /**
+     * The base price style is switching `from` → `to` (candles, line, area, a chart-type
+     * id, …). Fires synchronously BEFORE the chart repaints in the new style, whatever
+     * the path: the topbar style menu, `ctx.setPriceStyle`,
+     * `chart.renderer.set('priceStyle', …)`, the settings dialog, `applyConfig` and
+     * config templates, or a state restore. Never fires for the style the chart was
+     * created with, nor for a set to the style already shown. While it runs the chart
+     * still shows `from`, so a listener can capture the outgoing frame
+     * (`chart.renderer.screenshotCanvas()`) to animate the switch. Listeners must not
+     * change the price style again from inside it.
+     */
+    "priceStyle:change": {
+        from: string;
+        to: string;
+    };
     /** A study pane was reordered one slot (`dir`) — carries enough to invert for undo/redo. */
     "pane:moved": {
         paneId: string;
@@ -935,6 +950,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": {
@@ -1361,7 +1387,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. */
@@ -1383,6 +1412,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. */
@@ -1447,8 +1494,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;
@@ -1547,6 +1598,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;
@@ -1889,6 +1955,26 @@ interface WidgetContext {
      *  `state:changed` + storage write follows). Only needed for state with no shell
      *  event of its own — indicator adds/removals already trigger the save cycle. */
     stateChanged(): void;
+    /** Where the right-click that opened a context menu landed. Set on the context handed
+     *  to `context:*` actions (`when` and `run`); absent everywhere else. */
+    pointer?: ContextMenuPointer;
+}
+/**
+ * What the chart's crosshair reported when a context menu opened ({@link WidgetContext.pointer}),
+ * on the chart that received the right-click — in a workspace, the cell under the pointer.
+ * Captured once at open: moving through the menu before picking a row does not change it.
+ * The axis menus get what the crosshair reports over the axis: off the plot, `price` and
+ * `paneKind` are null, while `time` still names the bar column under the pointer (on the
+ * time axis, the bar above the click; null past the last bar).
+ */
+interface ContextMenuPointer {
+    /** The value under the pointer on the pane it landed on: a price on the price pane, an
+     *  indicator value on a study pane (see `paneKind`). Null off the plot. */
+    price: number | null;
+    /** Open time of the bar under the pointer; null off the bars. */
+    time: number | null;
+    /** The kind of pane the pointer is on; null off the plot. */
+    paneKind: 'price' | 'study' | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {
@@ -1930,7 +2016,12 @@ interface WidgetActionDescriptor {
      *  one the flag is ignored (with a console warning) and the label renders. The piece
      *  that makes a `'screenshot'` slot override pixel-faithful to the native button. */
     iconOnly?: boolean;
-    /** Sort key within the contributed group (ascending; default 0). */
+    /** Sort key (ascending; default 0; ties keep registration order). On the topbar it orders
+     *  the contributed group. In a context menu (`context:*`) contributed rows sort TOGETHER
+     *  with the menu's built-in rows, which sit at the ranks of `CONTEXT_MENU_BUILTIN_ORDER`:
+     *  the built-in actions below 0 and the settings row at 1000. So an action without
+     *  `order` lands after the built-in actions and before the settings row, `order: -100`
+     *  leads the menu, and on a tie the built-in row comes first. */
     order?: number;
     /** Topbar only: which cluster the button joins. `'right'` (default) is the
      *  right-hand tools cluster; `'left'` puts it with the PRIMARY chrome buttons —
@@ -2249,4 +2340,4 @@ declare function unregisterDefaultEngine(language: string): void;
  *  language. The shell layers (widget, workspace cell) register exactly this result. */
 declare function resolveEngines(overrides?: Record<string, EngineFactory>): Record<string, EngineFactory>;
 
-export { type ScriptRunResult as $, type NativeIndicatorContext as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type NativeIndicatorDescriptor as G, type NativeIndicatorInfo as H, type IndicatorHandle as I, type NativeIndicatorOutput as J, type PreparedScript as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, RendererControl as Q, type ReplayState as R, type ScriptingEngine as S, ReplayControl as T, type ReplayEndReason as U, Vela as V, type WidgetContext as W, type ReplayStartOptions as X, type RunIndicatorResult as Y, type SceneInspection as Z, type ScriptRunCause as _, type ReplayBounds as a, type SidePanelButton as a0, type SidePanelDescriptor as a1, type SidePanelHandle as a2, type SidePanelHeader as a3, type StatePersistenceHandler as a4, type StrategyFill as a5, type StrategyState as a6, type StrategyTrade as a7, type SymbolRankingHook as a8, TypedEventBus as a9, unregisterLegendCallout as aA, unregisterNativeIndicator as aB, unregisterSidePanel as aC, unregisterStatePersistence as aD, unregisterWidgetAction as aE, unregisterWidgetAttachment as aF, widgetActions as aG, widgetAttachments as aH, DEFAULT_PANEL_ORDER as aI, type VelaDeps as aa, type VisibleBarRange as ab, type WidgetActionDescriptor as ac, type WidgetActionTarget as ad, type WidgetAttachment as ae, getNativeIndicator as af, legendActions as ag, legendCallouts as ah, nativeIndicatorDescriptors as ai, nativeIndicatorTypes as aj, registerDefaultEngine as ak, registerLegendAction as al, registerLegendCallout as am, registerNativeIndicator as an, registerSidePanel as ao, registerStatePersistence as ap, registerSymbolRanking as aq, registerWidgetAction as ar, registerWidgetAttachment as as, resolveEngines as at, sidePanels as au, statePersistenceHandlers as av, symbolRanking as aw, topbarActionOverride as ax, unregisterDefaultEngine as ay, unregisterLegendAction as az, type VelaEventMap as b, type ScriptRun as c, type Resolved as d, type ReplayTick as e, DataControl as f, type ReplayTickSource as g, type CodeUpdateResult as h, type ContextSelect as i, DrawingsControl as j, type EngineAlert as k, type EngineCapabilities as l, type EngineContextSnapshot as m, type EngineFactory as n, type EngineWarning as o, type ExecutionHandlers as p, type ExecutionMarket as q, type ExecutionRequest as r, type ExecutionSession as s, type IndicatorEventMap as t, type IndicatorSummary as u, type LegendCalloutContent as v, type LegendCalloutDescriptor as w, type LegendCalloutItem as x, type LegendCalloutSpec as y, type LegendIndicatorInfo as z };
+export { type ScriptRunCause as $, type LegendIndicatorInfo as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type NativeIndicatorContext as G, type NativeIndicatorDescriptor as H, type IndicatorHandle as I, type NativeIndicatorInfo as J, type NativeIndicatorOutput as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type PreparedScript as Q, type ReplayState as R, type ScriptingEngine as S, RendererControl as T, ReplayControl as U, Vela as V, type WidgetContext as W, type ReplayEndReason as X, type ReplayStartOptions as Y, type RunIndicatorResult as Z, type SceneInspection as _, type ReplayBounds as a, type ScriptRunResult as a0, type SidePanelButton as a1, type SidePanelDescriptor as a2, type SidePanelHandle as a3, type SidePanelHeader as a4, type StatePersistenceHandler as a5, type StrategyFill as a6, type StrategyState as a7, type StrategyTrade as a8, type SymbolRankingHook as a9, unregisterLegendAction as aA, unregisterLegendCallout as aB, unregisterNativeIndicator as aC, unregisterSidePanel as aD, unregisterStatePersistence as aE, unregisterWidgetAction as aF, unregisterWidgetAttachment as aG, widgetActions as aH, widgetAttachments as aI, DEFAULT_PANEL_ORDER as aJ, TypedEventBus as aa, type VelaDeps as ab, type VisibleBarRange as ac, type WidgetActionDescriptor as ad, type WidgetActionTarget as ae, type WidgetAttachment as af, getNativeIndicator as ag, legendActions as ah, legendCallouts as ai, nativeIndicatorDescriptors as aj, nativeIndicatorTypes as ak, registerDefaultEngine as al, registerLegendAction as am, registerLegendCallout as an, registerNativeIndicator as ao, registerSidePanel as ap, registerStatePersistence as aq, registerSymbolRanking as ar, registerWidgetAction as as, registerWidgetAttachment as at, resolveEngines as au, sidePanels as av, statePersistenceHandlers as aw, symbolRanking as ax, topbarActionOverride as ay, unregisterDefaultEngine as az, type VelaEventMap as b, type ScriptRun as c, type Resolved as d, type ReplayTick as e, DataControl as f, type ReplayTickSource as g, type CodeUpdateResult as h, type ContextMenuPointer as i, type ContextSelect as j, DrawingsControl as k, type EngineAlert as l, type EngineCapabilities as m, type EngineContextSnapshot as n, type EngineFactory as o, type EngineWarning as p, type ExecutionHandlers as q, type ExecutionMarket as r, type ExecutionRequest as s, type ExecutionSession as t, type IndicatorEventMap as u, type IndicatorSummary as v, type LegendCalloutContent as w, type LegendCalloutDescriptor as x, type LegendCalloutItem as y, type LegendCalloutSpec as z };

package/dist/{contributions-bWgwyiVi.d.ts → contributions-DOm40g5-.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, aW as SeriesSpec, ak as Fill, H as Background, aM 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, bc 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-NAUHiQEC.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-DpOWZD8F.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-CSXbjMM5.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-Bw58CjYy.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -905,6 +905,21 @@ interface VelaEventMap extends Record<string, unknown> {
      * leave the app theme alone.
      */
     "theme:changed": VelaTheme;
+    /**
+     * The base price style is switching `from` → `to` (candles, line, area, a chart-type
+     * id, …). Fires synchronously BEFORE the chart repaints in the new style, whatever
+     * the path: the topbar style menu, `ctx.setPriceStyle`,
+     * `chart.renderer.set('priceStyle', …)`, the settings dialog, `applyConfig` and
+     * config templates, or a state restore. Never fires for the style the chart was
+     * created with, nor for a set to the style already shown. While it runs the chart
+     * still shows `from`, so a listener can capture the outgoing frame
+     * (`chart.renderer.screenshotCanvas()`) to animate the switch. Listeners must not
+     * change the price style again from inside it.
+     */
+    "priceStyle:change": {
+        from: string;
+        to: string;
+    };
     /** A study pane was reordered one slot (`dir`) — carries enough to invert for undo/redo. */
     "pane:moved": {
         paneId: string;
@@ -935,6 +950,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": {
@@ -1361,7 +1387,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. */
@@ -1383,6 +1412,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. */
@@ -1447,8 +1494,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;
@@ -1547,6 +1598,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;
@@ -1889,6 +1955,26 @@ interface WidgetContext {
      *  `state:changed` + storage write follows). Only needed for state with no shell
      *  event of its own — indicator adds/removals already trigger the save cycle. */
     stateChanged(): void;
+    /** Where the right-click that opened a context menu landed. Set on the context handed
+     *  to `context:*` actions (`when` and `run`); absent everywhere else. */
+    pointer?: ContextMenuPointer;
+}
+/**
+ * What the chart's crosshair reported when a context menu opened ({@link WidgetContext.pointer}),
+ * on the chart that received the right-click — in a workspace, the cell under the pointer.
+ * Captured once at open: moving through the menu before picking a row does not change it.
+ * The axis menus get what the crosshair reports over the axis: off the plot, `price` and
+ * `paneKind` are null, while `time` still names the bar column under the pointer (on the
+ * time axis, the bar above the click; null past the last bar).
+ */
+interface ContextMenuPointer {
+    /** The value under the pointer on the pane it landed on: a price on the price pane, an
+     *  indicator value on a study pane (see `paneKind`). Null off the plot. */
+    price: number | null;
+    /** Open time of the bar under the pointer; null off the bars. */
+    time: number | null;
+    /** The kind of pane the pointer is on; null off the plot. */
+    paneKind: 'price' | 'study' | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {
@@ -1930,7 +2016,12 @@ interface WidgetActionDescriptor {
      *  one the flag is ignored (with a console warning) and the label renders. The piece
      *  that makes a `'screenshot'` slot override pixel-faithful to the native button. */
     iconOnly?: boolean;
-    /** Sort key within the contributed group (ascending; default 0). */
+    /** Sort key (ascending; default 0; ties keep registration order). On the topbar it orders
+     *  the contributed group. In a context menu (`context:*`) contributed rows sort TOGETHER
+     *  with the menu's built-in rows, which sit at the ranks of `CONTEXT_MENU_BUILTIN_ORDER`:
+     *  the built-in actions below 0 and the settings row at 1000. So an action without
+     *  `order` lands after the built-in actions and before the settings row, `order: -100`
+     *  leads the menu, and on a tie the built-in row comes first. */
     order?: number;
     /** Topbar only: which cluster the button joins. `'right'` (default) is the
      *  right-hand tools cluster; `'left'` puts it with the PRIMARY chrome buttons —
@@ -2249,4 +2340,4 @@ declare function unregisterDefaultEngine(language: string): void;
  *  language. The shell layers (widget, workspace cell) register exactly this result. */
 declare function resolveEngines(overrides?: Record<string, EngineFactory>): Record<string, EngineFactory>;
 
-export { type ScriptRunResult as $, type NativeIndicatorContext as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type NativeIndicatorDescriptor as G, type NativeIndicatorInfo as H, type IndicatorHandle as I, type NativeIndicatorOutput as J, type PreparedScript as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, RendererControl as Q, type ReplayState as R, type ScriptingEngine as S, ReplayControl as T, type ReplayEndReason as U, Vela as V, type WidgetContext as W, type ReplayStartOptions as X, type RunIndicatorResult as Y, type SceneInspection as Z, type ScriptRunCause as _, type ReplayBounds as a, type SidePanelButton as a0, type SidePanelDescriptor as a1, type SidePanelHandle as a2, type SidePanelHeader as a3, type StatePersistenceHandler as a4, type StrategyFill as a5, type StrategyState as a6, type StrategyTrade as a7, type SymbolRankingHook as a8, TypedEventBus as a9, unregisterLegendCallout as aA, unregisterNativeIndicator as aB, unregisterSidePanel as aC, unregisterStatePersistence as aD, unregisterWidgetAction as aE, unregisterWidgetAttachment as aF, widgetActions as aG, widgetAttachments as aH, DEFAULT_PANEL_ORDER as aI, type VelaDeps as aa, type VisibleBarRange as ab, type WidgetActionDescriptor as ac, type WidgetActionTarget as ad, type WidgetAttachment as ae, getNativeIndicator as af, legendActions as ag, legendCallouts as ah, nativeIndicatorDescriptors as ai, nativeIndicatorTypes as aj, registerDefaultEngine as ak, registerLegendAction as al, registerLegendCallout as am, registerNativeIndicator as an, registerSidePanel as ao, registerStatePersistence as ap, registerSymbolRanking as aq, registerWidgetAction as ar, registerWidgetAttachment as as, resolveEngines as at, sidePanels as au, statePersistenceHandlers as av, symbolRanking as aw, topbarActionOverride as ax, unregisterDefaultEngine as ay, unregisterLegendAction as az, type VelaEventMap as b, type ScriptRun as c, type Resolved as d, type ReplayTick as e, DataControl as f, type ReplayTickSource as g, type CodeUpdateResult as h, type ContextSelect as i, DrawingsControl as j, type EngineAlert as k, type EngineCapabilities as l, type EngineContextSnapshot as m, type EngineFactory as n, type EngineWarning as o, type ExecutionHandlers as p, type ExecutionMarket as q, type ExecutionRequest as r, type ExecutionSession as s, type IndicatorEventMap as t, type IndicatorSummary as u, type LegendCalloutContent as v, type LegendCalloutDescriptor as w, type LegendCalloutItem as x, type LegendCalloutSpec as y, type LegendIndicatorInfo as z };
+export { type ScriptRunCause as $, type LegendIndicatorInfo as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type NativeIndicatorContext as G, type NativeIndicatorDescriptor as H, type IndicatorHandle as I, type NativeIndicatorInfo as J, type NativeIndicatorOutput as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type PreparedScript as Q, type ReplayState as R, type ScriptingEngine as S, RendererControl as T, ReplayControl as U, Vela as V, type WidgetContext as W, type ReplayEndReason as X, type ReplayStartOptions as Y, type RunIndicatorResult as Z, type SceneInspection as _, type ReplayBounds as a, type ScriptRunResult as a0, type SidePanelButton as a1, type SidePanelDescriptor as a2, type SidePanelHandle as a3, type SidePanelHeader as a4, type StatePersistenceHandler as a5, type StrategyFill as a6, type StrategyState as a7, type StrategyTrade as a8, type SymbolRankingHook as a9, unregisterLegendAction as aA, unregisterLegendCallout as aB, unregisterNativeIndicator as aC, unregisterSidePanel as aD, unregisterStatePersistence as aE, unregisterWidgetAction as aF, unregisterWidgetAttachment as aG, widgetActions as aH, widgetAttachments as aI, DEFAULT_PANEL_ORDER as aJ, TypedEventBus as aa, type VelaDeps as ab, type VisibleBarRange as ac, type WidgetActionDescriptor as ad, type WidgetActionTarget as ae, type WidgetAttachment as af, getNativeIndicator as ag, legendActions as ah, legendCallouts as ai, nativeIndicatorDescriptors as aj, nativeIndicatorTypes as ak, registerDefaultEngine as al, registerLegendAction as am, registerLegendCallout as an, registerNativeIndicator as ao, registerSidePanel as ap, registerStatePersistence as aq, registerSymbolRanking as ar, registerWidgetAction as as, registerWidgetAttachment as at, resolveEngines as au, sidePanels as av, statePersistenceHandlers as aw, symbolRanking as ax, topbarActionOverride as ay, unregisterDefaultEngine as az, type VelaEventMap as b, type ScriptRun as c, type Resolved as d, type ReplayTick as e, DataControl as f, type ReplayTickSource as g, type CodeUpdateResult as h, type ContextMenuPointer as i, type ContextSelect as j, DrawingsControl as k, type EngineAlert as l, type EngineCapabilities as m, type EngineContextSnapshot as n, type EngineFactory as o, type EngineWarning as p, type ExecutionHandlers as q, type ExecutionMarket as r, type ExecutionRequest as s, type ExecutionSession as t, type IndicatorEventMap as u, type IndicatorSummary as v, type LegendCalloutContent as w, type LegendCalloutDescriptor as x, type LegendCalloutItem as y, type LegendCalloutSpec as z };