@luxalgo/vela 0.7.5 → 0.7.7

package/dist/{chunk-BKHSQ4YM.js → chunk-WTWGEB7K.js}

@@ -2177,7 +2177,8 @@ function addRecent(hex6) {
   recents.unshift(hex6);
   if (recents.length > 10) recents.length = 10;
 }
-function buildColorPicker(color, theme, onChange) {
+function buildColorPicker(color, theme, onChange, options = {}) {
+  const commit = options.commit ?? "live";
   const parsed = splitColor(color);
   let curHex = parsed.hex6;
   let curAlpha = parsed.alpha;
@@ -2260,7 +2261,12 @@ function buildColorPicker(color, theme, onChange) {
     const r = track.getBoundingClientRect();
     curAlpha = Math.max(0, Math.min(1, (clientX - r.left) / r.width));
     paintOpacity();
-    emit();
+    if (commit === "live") emit();
+  };
+  const endDrag = () => {
+    if (!dragging) return;
+    dragging = false;
+    if (commit === "release") emit();
   };
   track.addEventListener("pointerdown", (e) => {
     e.stopPropagation();
@@ -2271,7 +2277,8 @@ function buildColorPicker(color, theme, onChange) {
   track.addEventListener("pointermove", (e) => {
     if (dragging) onDrag(e.clientX);
   });
-  track.addEventListener("pointerup", () => dragging = false);
+  track.addEventListener("pointerup", endDrag);
+  track.addEventListener("pointercancel", endDrag);
   function emit() {
     onChange(combineColor(curHex, curAlpha));
   }
@@ -2294,7 +2301,7 @@ function buildColorPicker(color, theme, onChange) {
   return root;
 }
 function colorField(theme, getVal, onVal, opts) {
-  return new ColorField({ theme, getVal, onVal, shape: opts?.shape, id: opts?.id, popover: opts?.popover }).el;
+  return new ColorField({ theme, getVal, onVal, shape: opts?.shape, id: opts?.id, popover: opts?.popover, commit: opts?.commit }).el;
 }
 var ColorField = class {
   constructor(opts) {
@@ -2303,6 +2310,7 @@ var ColorField = class {
     this.getVal = opts.getVal;
     this.onVal = opts.onVal;
     this.popoverOpts = opts.popover;
+    this.commit = opts.commit;
     const trigger = document.createElement("button");
     trigger.type = "button";
     if (opts.id) trigger.id = opts.id;
@@ -2342,10 +2350,15 @@ var ColorField = class {
       boundary: this.popoverOpts?.boundary,
       zIndex: this.popoverOpts?.zIndex,
       className: "vela-color-field-pop",
-      content: buildColorPicker(this.getVal(), this.theme, (val) => {
-        this.onVal(val);
-        this.paint();
-      })
+      content: buildColorPicker(
+        this.getVal(),
+        this.theme,
+        (val) => {
+          this.onVal(val);
+          this.paint();
+        },
+        { commit: this.commit }
+      )
     });
     pop.show();
   }
@@ -2829,7 +2842,8 @@ function buildFieldControl(desc) {
     const el2 = colorField(desc.theme, desc.get, desc.onChange, {
       shape: "circle",
       id: desc.id,
-      popover: desc.popover
+      popover: desc.popover,
+      commit: desc.commit
     });
     if (desc.title) el2.title = desc.title;
     return { el: el2 };

package/dist/{chunk-MNG5XPLV.js → chunk-ZA2XWTGH.js}

@@ -1,7 +1,7 @@
-import { parseSymbol, priceStyleIds, BUILTIN_PRICE_STYLES, tzButtonLabel, SecondClock, TIMEZONES, normalizeTimezone, tzMenuLabel, isGroupRow, defaultMemberOf, groupKeyOf, groupMembers, LEGEND_AT_TOP_ATTR, normalizeSession, Vela, TypedEventBus, MultiProviderFeed, registerBuiltinChartTypes, resolveTheme, buildToolbar, createCustomMark, createAttributionMark, DrawingToolbar, applyAttributionMarkTheme, sharedBarStore, timeframeToMs } from './chunk-MCLI6B3S.js';
+import { parseSymbol, priceStyleIds, BUILTIN_PRICE_STYLES, tzButtonLabel, SecondClock, resolveTimezone, timezoneMenuRows, isGroupRow, defaultMemberOf, groupKeyOf, groupMembers, LEGEND_AT_TOP_ATTR, normalizeSession, Vela, normalizeTimezone, TypedEventBus, MultiProviderFeed, registerBuiltinChartTypes, resolveTheme, buildToolbar, createCustomMark, createAttributionMark, DrawingToolbar, applyAttributionMarkTheme, sharedBarStore, timeframeToMs } from './chunk-RVQWJOEE.js';
 import { chartType, resolveTopbarComposition, topbarActionOverride, TOPBAR_BUILTIN_IDS, widgetActions, SidePanel, sidePanels, DEFAULT_PANEL_ORDER, symbolRanking, resolveEngines, legendActionsProviderFor, legendCalloutsProviderFor, statePersistenceHandlers, topbarHas, rendererDefaults, widgetAttachments, getDrawingType, inputDeltas } from './chunk-BFA32GOU.js';
-import { Tooltip, KeymapManager, isEditableTarget, Drawer } from './chunk-ZADTVRUO.js';
-import { Menu, Dialog, CalloutBubble, applyPlotOverlayTokens, ensureUIHost } from './chunk-BKHSQ4YM.js';
+import { Tooltip, KeymapManager, isEditableTarget, Drawer } from './chunk-PVGWNF7V.js';
+import { Menu, Dialog, CalloutBubble, applyPlotOverlayTokens, ensureUIHost } from './chunk-WTWGEB7K.js';
 import { registerIcon, svg16, injectStyles, iconEl, iconMarkup, iconAt, SESSION_OFF, SESSION_POST, SESSION_PRE, icon, categoricalColor } from './chunk-CAFCLMPF.js';
 import { baseOf } from './chunk-W4EJWLEO.js';
 
@@ -1087,6 +1087,7 @@ var Bottombar = class {
     this.sessionButtons = /* @__PURE__ */ new Map();
     this.sessionEl = null;
     this.timezone = opts.timezone;
+    this.exchangeTimezone = opts.exchangeTimezone;
     const doc = host.ownerDocument;
     injectStyles(STYLE_ID3, CSS3, doc);
     this.el = doc.createElement("div");
@@ -1110,7 +1111,7 @@ var Bottombar = class {
     this.clockEl = doc.createElement("span");
     this.clockEl.className = "vela-bb-clock";
     this.tzLabelEl = doc.createElement("span");
-    this.tzLabelEl.textContent = tzButtonLabel(this.timezone);
+    this.tzLabelEl.textContent = tzButtonLabel(this.displayZone);
     this.tzButton.append(this.clockEl, this.tzLabelEl);
     const session = doc.createElement("span");
     session.className = "vela-bb-session";
@@ -1145,19 +1146,32 @@ var Bottombar = class {
       placement: "top-end",
       items: this.tzItems(),
       onSelect: (zone) => {
-        this.setTimezone(zone);
+        this.setTimezone(zone, this.exchangeTimezone);
         opts.onTimezone(zone);
       }
     });
     this.tick();
     this.unsubClock = (opts.clock ?? new SecondClock()).onTick(() => this.tick());
   }
-  setTimezone(zone) {
+  /**
+   * Reflect the stored choice AND the active chart's market zone. The clock and the
+   * offset label read the RESOLVED zone, so a workspace on the exchange rule re-labels
+   * when the active cell (or its symbol) changes market — the host re-projects on
+   * both. Idempotent: unchanged inputs leave the menu alone.
+   */
+  setTimezone(zone, exchangeTimezone) {
+    if (zone === this.timezone && exchangeTimezone === this.exchangeTimezone) return;
+    const choiceChanged = zone !== this.timezone;
     this.timezone = zone;
-    this.tzLabelEl.textContent = tzButtonLabel(zone);
-    this.tzMenu.setItems(this.tzItems());
+    this.exchangeTimezone = exchangeTimezone;
+    this.tzLabelEl.textContent = tzButtonLabel(this.displayZone);
+    if (choiceChanged) this.tzMenu.setItems(this.tzItems());
     this.tick();
   }
+  /** The zone the bar's clock and label render in. */
+  get displayZone() {
+    return resolveTimezone(this.timezone, this.exchangeTimezone);
+  }
   /** Highlight (or clear with null) the active range chip — cleared on manual tf changes. */
   setActiveRange(id) {
     for (const [key, b] of this.rangeButtons) {
@@ -1185,11 +1199,7 @@ var Bottombar = class {
     this.el.remove();
   }
   tzItems() {
-    return TIMEZONES.map((t) => ({
-      id: t.value,
-      label: tzMenuLabel(t.value, t.label),
-      checked: t.value === normalizeTimezone(this.timezone)
-    }));
+    return timezoneMenuRows(this.timezone).map((r) => ({ id: r.value, label: r.label, checked: r.checked }));
   }
   tick() {
     try {
@@ -1198,7 +1208,7 @@ var Bottombar = class {
         minute: "2-digit",
         second: "2-digit",
         hour12: false,
-        timeZone: this.timezone
+        timeZone: this.displayZone
       }).format(/* @__PURE__ */ new Date());
     } catch {
       this.clockEl.textContent = "";
@@ -4756,12 +4766,11 @@ function priceAxisItems(s) {
   ];
 }
 function timeAxisItems(timezone) {
-  const active = timezone === "UTC" ? "Etc/UTC" : timezone;
   return [
     {
       id: "timezone",
       label: "Time zone",
-      submenu: TIMEZONES.map((t) => ({ id: `tz:${t.value}`, label: tzMenuLabel(t.value, t.label), checked: t.value === active }))
+      submenu: timezoneMenuRows(timezone).map((r) => ({ id: `tz:${r.value}`, label: r.label, checked: r.checked }))
     },
     settingsItem("time-axis", "More settings\u2026")
   ];
@@ -4882,7 +4891,7 @@ var ChartContextMenu = class {
     } else if (id.startsWith("tz:")) {
       const zone = id.slice("tz:".length);
       if (this.cbs.setTimezone) this.cbs.setTimezone(zone);
-      else chart.renderer.set("timezone", zone);
+      else chart.renderer.set("timezone", resolveTimezone(zone, void 0));
     } else if (id === "auto") {
       chart.renderer.set("autoScale", chart.renderer.get("autoScale") === false);
     } else if (id === "invert") {
@@ -5641,7 +5650,7 @@ var ChartCell = class {
     this.history.onChart(this.inner);
     this.inner.renderer.onConfigChanged(() => {
       const zone = this.inner?.renderer.get("timezone");
-      if (typeof zone === "string" && normalizeTimezone(zone) !== normalizeTimezone(this.deps.timezone())) {
+      if (typeof zone === "string" && normalizeTimezone(zone) !== normalizeTimezone(this.displayTimezone)) {
         this.deps.setTimezone(normalizeTimezone(zone));
       }
       const style = this.priceStyle;
@@ -5683,8 +5692,7 @@ var ChartCell = class {
       this.refreshSessionShading();
     });
     this.inner.on("viewport:changed", (range) => this.sessionShading.updateRange(range));
-    const tz = deps.timezone();
-    if (tz !== "Etc/UTC") this.inner.renderer.set("timezone", tz);
+    this.applyTimezone();
     this.indicatorTitlesOn = seed.indicatorTitles ?? true;
     if (!this.indicatorTitlesOn) this.inner.renderer.set("indicatorTitles", false);
     this.indicatorValuesOn = seed.indicatorValues ?? true;
@@ -5706,7 +5714,7 @@ var ChartCell = class {
         this.statusline?.setSymbol(this.state.symbol);
         this.statusline?.setMeta(this.state.timeframe ?? "60", this.inner.data.displayPrefix(this.state.symbol) ?? this.state.provider ?? "");
       }
-      this.refreshSessionAvailable();
+      this.refreshSymbolMetadata();
       if (this.inner && this.state.symbol) this.marketStatus?.track(this.inner.data, this.state.symbol);
     });
     this.syncStatuslineColors();
@@ -5780,7 +5788,7 @@ var ChartCell = class {
     this.offMarket = this.inner.on("market:changed", ({ symbol: symbol2, timeframe }) => {
       this.projectMarket(symbol2, timeframe);
       this.refreshNativeCatalog();
-      this.refreshSessionAvailable();
+      this.refreshSymbolMetadata();
       if (this.inner) this.marketStatus?.track(this.inner.data, symbol2);
       this.deps.onMarketChanged(this.id);
     });
@@ -5821,7 +5829,35 @@ var ChartCell = class {
     this.deps.onStateDirty();
     void this.inner?.setMarket({ session });
   }
-  refreshSessionAvailable() {
+  /**
+   * The symbol's own trading zone, once its metadata has landed — what the exchange
+   * rule resolves to on this cell (the workspace labels the shared bottom bar with the
+   * ACTIVE cell's). Undefined = unknown or undeclared (the rule then renders UTC).
+   */
+  get exchangeTimezone() {
+    return this.exchangeZone;
+  }
+  /** The IANA zone this cell's axis renders in: the workspace choice, resolved. */
+  get displayTimezone() {
+    return resolveTimezone(this.deps.timezone(), this.exchangeZone);
+  }
+  /**
+   * Push the resolved zone to the renderer — on the workspace choice changing, and on
+   * this cell's market zone changing under the exchange rule. Skips the write when the
+   * renderer already holds it (its config default is the bare `'UTC'` alias).
+   */
+  applyTimezone() {
+    const chart = this.inner;
+    if (!chart) return;
+    const zone = this.displayTimezone;
+    const current = chart.renderer.get("timezone");
+    const held = typeof current === "string" && current ? current : "UTC";
+    if (normalizeTimezone(held) === normalizeTimezone(zone)) return;
+    chart.renderer.set("timezone", zone);
+  }
+  /** Re-read the symbol's metadata: session posture (RTH/ETH toggle, shading) and its
+   *  trading zone (the exchange rule). Async — the workspace re-projects when a verdict lands. */
+  refreshSymbolMetadata() {
     const chart = this.inner;
     const symbol = this.state.symbol;
     if (!chart || !symbol) return;
@@ -5829,7 +5865,13 @@ var ChartCell = class {
       if (this.inner !== chart) return;
       const available = typeof si?.session === "string" && si.session !== "" && si.session !== "24x7";
       const overnight = parseSessionSpec(si)?.overnight === true;
-      if (available !== this.sessionAvailableFlag || overnight !== this.sessionOvernightFlag) {
+      const zone = typeof si?.timezone === "string" && si.timezone !== "" ? si.timezone : void 0;
+      const zoneChanged = zone !== this.exchangeZone;
+      if (zoneChanged) {
+        this.exchangeZone = zone;
+        this.applyTimezone();
+      }
+      if (available !== this.sessionAvailableFlag || overnight !== this.sessionOvernightFlag || zoneChanged) {
         this.sessionAvailableFlag = available;
         this.sessionOvernightFlag = overnight;
         this.deps.onMarketChanged(this.id);
@@ -6288,16 +6330,19 @@ var ChartCell = class {
    * a persistence handler's `restore` runs silently, a user-driven call records.
    */
   addExternalIndicator(entry) {
+    const { id, inputs, props, hidden, ...script } = entry;
     this.addManifestInstance(
-      { ...entry, enabled: true },
-      { external: true, ...entry.inputs ? { inputs: entry.inputs } : {}, ...entry.props ? { props: entry.props } : {}, ...entry.hidden ? { hidden: true } : {} }
+      { ...script, enabled: true },
+      { external: true, ...id !== void 0 ? { id } : {}, ...inputs ? { inputs } : {}, ...props ? { props } : {}, ...hidden ? { hidden: true } : {} }
     );
   }
   /** Add ONE instance of a manifest entry (repeatable — duplicates are legitimate). */
   addManifestInstance(entry, opts = {}) {
     if (this.destroyed) return;
     const values = opts.inputs || opts.props ? { inputs: opts.inputs, props: opts.props } : void 0;
-    const it = { entry, handle: this.addToChart(entry, values), ...opts.external ? { external: true } : {}, ...values ? { values } : {} };
+    const handle = this.addToChart(entry, values, opts.id);
+    if (!handle) return;
+    const it = { entry, handle, id: handle.id, ...opts.external ? { external: true } : {}, ...values ? { values } : {} };
     if (opts.hidden) it.handle?.setVisible(false);
     this.instances.push(it);
     this.deps.onIndicatorsChanged(this.id);
@@ -6306,7 +6351,7 @@ var ChartCell = class {
     this.history.push({
       undo: () => this.dropInstance(snapshot),
       redo: () => {
-        snapshot.handle = this.addToChart(snapshot.entry, snapshot.values);
+        snapshot.handle = this.addToChart(snapshot.entry, snapshot.values, snapshot.id);
         this.instances.push(snapshot);
         this.deps.onIndicatorsChanged(this.id);
       }
@@ -6319,7 +6364,7 @@ var ChartCell = class {
     const snapshot = it;
     this.history.push({
       undo: () => {
-        snapshot.handle = this.addToChart(snapshot.entry, snapshot.values);
+        snapshot.handle = this.addToChart(snapshot.entry, snapshot.values, snapshot.id);
         this.instances.push(snapshot);
         this.deps.onIndicatorsChanged(this.id);
       },
@@ -6409,9 +6454,10 @@ var ChartCell = class {
       this.deps.onIndicatorsChanged(this.id);
     });
   }
-  addToChart(entry, values) {
+  addToChart(entry, values, id) {
     try {
       return this.inner?.addIndicator(entry.script, {
+        ...id !== void 0 ? { id } : {},
         ...entry.language !== void 0 ? { language: entry.language } : {},
         ...values?.inputs ? { inputs: values.inputs } : {},
         ...values?.props ? { props: values.props } : {}
@@ -7731,15 +7777,14 @@ var TimezoneDrawer = class {
     this.drawer.body.replaceChildren();
     const list = doc.createElement("div");
     list.className = "vela-tzd-list";
-    const current = normalizeTimezone(this.opts.timezone());
-    for (const tz of TIMEZONES) {
+    for (const tz of timezoneMenuRows(this.opts.timezone())) {
       const row = doc.createElement("div");
       row.className = "vela-tzd-row";
       const label = doc.createElement("span");
       label.className = "vela-tzd-row-label";
-      label.textContent = tzMenuLabel(tz.value, tz.label);
+      label.textContent = tz.label;
       row.appendChild(label);
-      if (tz.value === current) row.appendChild(iconEl("check", doc));
+      if (tz.checked) row.appendChild(iconEl("check", doc));
       row.addEventListener("click", () => {
         this.opts.onTimezone(tz.value);
         this.drawer.hide();
@@ -8847,13 +8892,23 @@ var VelaWorkspace = class {
       }
     }
   }
-  /** Set the workspace-global display timezone — applied to EVERY cell. */
+  /**
+   * Set the workspace-global display timezone — applied to EVERY cell. An IANA zone,
+   * or `'exchange'` (the exchange rule): each cell then renders in its OWN market's
+   * zone (Chicago for a CME future, New York for a US equity, UTC for crypto), and the
+   * bottom bar follows the active cell's.
+   */
   setTimezone(zone) {
     this.timezone = zone;
-    this.bottombar?.setTimezone(zone);
-    for (const cell of this.cellsById.values()) cell.chart.renderer.set("timezone", zone);
+    this.projectTimezone();
+    for (const cell of this.cellsById.values()) cell.applyTimezone();
     this.markStateDirty();
   }
+  /** Bottom bar ⇐ the stored choice + the ACTIVE cell's market zone (labels the exchange row). */
+  projectTimezone() {
+    const active = this.activeId ? this.cellsById.get(this.activeId) : void 0;
+    this.bottombar?.setTimezone(this.timezone, active?.exchangeTimezone);
+  }
   /**
    * Swap the workspace theme at runtime — `'dark'`, `'light'`, or a full custom theme,
    * applied to the shared chrome (topbar, panels, drawing toolbar) and EVERY cell.
@@ -9058,6 +9113,7 @@ var VelaWorkspace = class {
     this.dock.onChart(cell.chart);
     this.bottombar?.setActiveRange(cell.activeRangeId);
     this.bottombar?.setSession({ session: cell.session, enabled: cell.sessionAvailable });
+    this.projectTimezone();
     this.indicatorPicker?.sync();
     this.glider.stop();
     const d = cell.chart.drawings;
@@ -9642,6 +9698,7 @@ var VelaWorkspace = class {
     this.mobileBar?.setTimeframe(cell.timeframe);
     this.objectTree.setSymbol(cell.symbol);
     this.bottombar?.setSession({ session: cell.session, enabled: cell.sessionAvailable });
+    this.projectTimezone();
     this.bottombar?.setActiveRange(cell.activeRangeId);
   }
   /** Trigger ② — a cell's price style changed: the topbar button/menu only if active.

package/dist/{contributions-DYtiRtES.d.cts → contributions-DF_Ea07m.d.cts}

@@ -1,5 +1,5 @@
-import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-DNBoMKkX.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-Dut6lXGM.cjs';
+import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-D1AJKsn_.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-CGa4KHRa.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -47,6 +47,23 @@ interface StrategyTrade {
     exit?: StrategyFill;
     /** Still open at the last computed bar. */
     open: boolean;
+    /**
+     * Realized P&L of this round trip in account currency, net of commission. Absent
+     * while the trade is open, and for an engine that reports no per-trade ledger.
+     */
+    pnl?: number;
+    /** Commission charged on this trade, in account currency. */
+    commission?: number;
+    /**
+     * Worst / best unrealized excursion of THIS trade from its entry, in account
+     * currency (positive magnitudes). Read `maxDrawdown` as the adverse excursion and
+     * `maxRunup` as the favorable one — the per-trade counterparts of the account-level
+     * {@link StrategyState.maxDrawdown} / {@link StrategyState.maxRunup}. An engine
+     * defines the exact convention (intrabar extremes, commission handling); absent when
+     * it does not track them.
+     */
+    maxDrawdown?: number;
+    maxRunup?: number;
 }
 /** One side of a {@link StrategyTrade}. */
 interface StrategyFill {
@@ -1684,6 +1701,12 @@ interface ExternalIndicatorEntry {
     name: string;
     /** The script source (the recorded undo/redo action re-adds from it). */
     script: string;
+    /** The indicator's id on the chart (see `AddIndicatorOptions.id`) — what a persistence
+     *  handler stores and hands back on restore so the indicator comes back under the id
+     *  its document knows. Omitted: the chart mints one. Either way undo/redo re-add the
+     *  indicator under the id it first ran with. An id already live on the cell's chart
+     *  is rejected (a warning; nothing is added). */
+    id?: string;
     /** Engine language (default: the chart's default engine). */
     language?: string;
     /** Input-value overrides applied at add time (what a persistence handler restores). */

package/dist/{contributions-CEkgJKTU.d.ts → contributions-nKOSeLy8.d.ts}

@@ -1,5 +1,5 @@
-import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-DNBoMKkX.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-DLeFs1gE.js';
+import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-D1AJKsn_.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-CmWUtDVL.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -47,6 +47,23 @@ interface StrategyTrade {
     exit?: StrategyFill;
     /** Still open at the last computed bar. */
     open: boolean;
+    /**
+     * Realized P&L of this round trip in account currency, net of commission. Absent
+     * while the trade is open, and for an engine that reports no per-trade ledger.
+     */
+    pnl?: number;
+    /** Commission charged on this trade, in account currency. */
+    commission?: number;
+    /**
+     * Worst / best unrealized excursion of THIS trade from its entry, in account
+     * currency (positive magnitudes). Read `maxDrawdown` as the adverse excursion and
+     * `maxRunup` as the favorable one — the per-trade counterparts of the account-level
+     * {@link StrategyState.maxDrawdown} / {@link StrategyState.maxRunup}. An engine
+     * defines the exact convention (intrabar extremes, commission handling); absent when
+     * it does not track them.
+     */
+    maxDrawdown?: number;
+    maxRunup?: number;
 }
 /** One side of a {@link StrategyTrade}. */
 interface StrategyFill {
@@ -1684,6 +1701,12 @@ interface ExternalIndicatorEntry {
     name: string;
     /** The script source (the recorded undo/redo action re-adds from it). */
     script: string;
+    /** The indicator's id on the chart (see `AddIndicatorOptions.id`) — what a persistence
+     *  handler stores and hands back on restore so the indicator comes back under the id
+     *  its document knows. Omitted: the chart mints one. Either way undo/redo re-add the
+     *  indicator under the id it first ran with. An id already live on the cell's chart
+     *  is rejected (a warning; nothing is added). */
+    id?: string;
     /** Engine language (default: the chart's default engine). */
     language?: string;
     /** Input-value overrides applied at add time (what a persistence handler restores). */