@luxalgo/vela 0.6.8 → 0.6.9

package/dist/{chunk-SQETIBFU.js → chunk-6WDDVMBJ.js}

@@ -1,6 +1,6 @@
-import { deserializeDrawing, chartTypes, rendererLayers, foldBaseModulation, registerChartType, rendererDefaults, getDrawingType, settingsRowVisible, normalizeSettingsRow, TextLabel, Callout, resetDrawingSettings, registerNativeIndicator, chartType, getNativeIndicator, nativeIndicatorDescriptors, drawingTypes, settingsRowValueKeys, formatDuration, RegressionChannel, FixedRangeVolumeProfile, SegmentDrawing, ArrowMark, GlyphStamp, RadialFib, FibSpiral, DedekindTessellation, MachFigure, GannSquare, FibRatios, MeasureBox, PositionTool, AnchoredVwap, PatternDrawing, Comment, PriceNote, Signpost, Note, PriceLabel, GANN_SQUARE_ARCS, lineSegmentIntersection, DEFAULT_DRAWING_COLOR, GLYPH_OPTIONS, STAMP_SIZE_OPTIONS, LINE_STYLE_OPTIONS, DEDEKIND_CURVATURE_OPTIONS, MACH_NUMBER_OPTIONS, MACH_WAVE_COUNT_OPTIONS, TEXT_SIZE_OPTIONS, createDrawing, inputVisible, tickerModifierIds, CalloutBase, DIRECTION_OPTIONS } from './chunk-L3I2CCYO.js';
-import { themeTokens, Dialog, closeOpenPopovers, closeWidthPopover, fieldSection, buildFieldControl, fieldSeparator, fieldGrid, fieldRow, blendOver, splitColor, Menu, TextArea, Popover, NumberInput, buildColorPicker, isPopoverOpen, eventDismissedPopover, toggleSelectList, openPopoverTrigger, fieldGridColumns, FIELD_GAP_PX, STATIC_TOKENS } from './chunk-OICPLNU7.js';
-import { icon, iconAt, withAlpha, WARNING, ACCENT, NEUTRAL, BEARISH, BULLISH, isDarkColor, SERIES_LINE, SLATE, CROSSHAIR, TRADE_EXIT, TRADE_SHORT, TRADE_LONG, overlayScrollbarCss, SLATE_DEEP, VALID, INVALID, FIELD_FOCUS_CSS, FIELD_FOCUS_RING, svg24, svg24Solid } from './chunk-PN5KWFZ4.js';
+import { deserializeDrawing, chartTypes, rendererLayers, foldBaseModulation, registerChartType, rendererDefaults, getDrawingType, settingsRowVisible, normalizeSettingsRow, TextLabel, Callout, resetDrawingSettings, registerNativeIndicator, chartType, getNativeIndicator, nativeIndicatorDescriptors, drawingTypes, settingsRowValueKeys, formatDuration, RegressionChannel, FixedRangeVolumeProfile, SegmentDrawing, ArrowMark, GlyphStamp, RadialFib, FibSpiral, DedekindTessellation, MachFigure, GannSquare, FibRatios, MeasureBox, PositionTool, AnchoredVwap, PatternDrawing, Comment, PriceNote, Signpost, Note, PriceLabel, GANN_SQUARE_ARCS, lineSegmentIntersection, DEFAULT_DRAWING_COLOR, GLYPH_OPTIONS, STAMP_SIZE_OPTIONS, LINE_STYLE_OPTIONS, DEDEKIND_CURVATURE_OPTIONS, MACH_NUMBER_OPTIONS, MACH_WAVE_COUNT_OPTIONS, TEXT_SIZE_OPTIONS, createDrawing, inputVisible, tickerModifierIds, CalloutBase, DIRECTION_OPTIONS } from './chunk-EQCHJZOT.js';
+import { themeTokens, Dialog, closeOpenPopovers, closeWidthPopover, fieldSection, buildFieldControl, fieldSeparator, fieldGrid, fieldRow, blendOver, splitColor, CalloutBubble, Menu, TextArea, Popover, NumberInput, buildColorPicker, isPopoverOpen, eventDismissedPopover, toggleSelectList, openPopoverTrigger, fieldGridColumns, FIELD_GAP_PX, STATIC_TOKENS } from './chunk-FCVIG7JG.js';
+import { icon, iconAt, withAlpha, WARNING, ACCENT, NEUTRAL, BEARISH, BULLISH, isDarkColor, SERIES_LINE, SLATE, CROSSHAIR, TRADE_EXIT, TRADE_SHORT, TRADE_LONG, overlayScrollbarCss, SLATE_DEEP, VALID, INVALID, FIELD_FOCUS_CSS, FIELD_FOCUS_RING, svg24, svg24Solid } from './chunk-WFSZBX3R.js';
 
 // src/core/events/EventBus.ts
 var TypedEventBus = class {
@@ -428,6 +428,15 @@ var RendererControl = class {
   setLegendActions(provider) {
     this.renderer.setLegendActions?.(provider);
   }
+  /**
+   * Wire the legend rows' HOST-CONTRIBUTED callout bubbles (the shells route the
+   * plugin registry through this; see `registerLegendCallout`). Silent on a renderer
+   * without the seam — contributed callouts simply never show there, same graceful
+   * degradation as {@link setLegendActions}.
+   */
+  setLegendCallouts(provider) {
+    this.renderer.setLegendCallouts?.(provider);
+  }
   /**
    * Replace the indicator legend's fold toggle with a host action (or restore it with
    * `null`) — multi-chart shells point the chip at their indicator overview instead of
@@ -2898,6 +2907,10 @@ function isLineLikeSeries(spec) {
 }
 
 // src/renderers/shared/IndicatorInputsDialog.ts
+var PROPS_TAB = "Properties";
+function bagOf(row, decl) {
+  return decl.prop ? row.propValues : row.values;
+}
 var SOURCES = ["close", "open", "high", "low", "hl2", "hlc3", "ohlc4", "volume"];
 var IndicatorInputsDialog = class {
   constructor(host) {
@@ -2908,6 +2921,7 @@ var IndicatorInputsDialog = class {
     this.openId = null;
     this.row = null;
     this.snapshot = null;
+    this.propSnapshot = null;
     this.dialogTips = [];
     /** Re-applies every `when` gate against current values; set while the dialog is open. */
     this.refreshVisibility = null;
@@ -2930,10 +2944,11 @@ var IndicatorInputsDialog = class {
   }
   open(row) {
     this.close();
-    if (row.inputs.length === 0) return;
+    if (row.inputs.length === 0 && row.props.length === 0) return;
     this.row = row;
     this.openId = row.id;
     this.snapshot = { ...row.values };
+    this.propSnapshot = { ...row.propValues };
     ensureDialogStyles();
     const t = this.host.theme();
     const border = "var(--vela-border)";
@@ -2941,7 +2956,7 @@ var IndicatorInputsDialog = class {
     const host = this.host.dialogHost() ?? this.host.container;
     const ui = new Dialog({
       host,
-      title: row.settingsTitle,
+      title: row.title,
       // Non-modal: live-edit dialog — a modal machine locks pointer events on the
       // whole body, killing the chart and the body-portaled popovers.
       modal: false,
@@ -2973,6 +2988,16 @@ var IndicatorInputsDialog = class {
       text: () => "Close"
     }));
     const tabDefs = tabInputs(row.inputs);
+    if (row.props.length > 0) {
+      const propDecls = row.props.map((p) => {
+        const d = { ...p, prop: true };
+        delete d.tab;
+        return d;
+      });
+      const existing = tabDefs.find((t2) => t2.name === PROPS_TAB);
+      if (existing) existing.inputs.push(...propDecls);
+      else tabDefs.push({ name: PROPS_TAB, inputs: propDecls });
+    }
     const tabs = document.createElement("div");
     tabs.style.cssText = `display:flex;gap:12px;padding:0 20px;border-bottom:1px solid ${border};flex:0 0 auto;`;
     const tabEls = [];
@@ -3075,9 +3100,10 @@ var IndicatorInputsDialog = class {
     this.openId = null;
     this.row = null;
     this.snapshot = null;
+    this.propSnapshot = null;
     ui?.destroy();
   }
-  /** Restore every input to its open-time value (re-running the indicator), then close. */
+  /** Restore every input and prop to its open-time value (re-running the indicator), then close. */
   revertAndClose() {
     const row = this.row;
     const snap = this.snapshot;
@@ -3091,6 +3117,17 @@ var IndicatorInputsDialog = class {
         }
       }
     }
+    const propSnap = this.propSnapshot;
+    if (row && propSnap) {
+      for (const p of row.props) {
+        const snapped = propSnap[p.key];
+        const before = snapped !== void 0 ? snapped : p.defval;
+        if (row.propValues[p.key] !== before) {
+          row.propValues[p.key] = before;
+          this.host.onChange?.({ indicatorId: row.id, key: p.key, value: before, kind: "prop" });
+        }
+      }
+    }
     this.close();
   }
   /** The footer's reset button — same chip as Cancel, pinned to the LEFT edge
@@ -3108,19 +3145,27 @@ var IndicatorInputsDialog = class {
     const row = this.row;
     if (!row) return;
     const snap = this.snapshot;
+    const propSnap = this.propSnapshot;
     for (const inp of row.inputs) {
       if (row.values[inp.key] !== inp.defval) {
         row.values[inp.key] = inp.defval;
         this.host.onChange?.({ indicatorId: row.id, key: inp.key, value: inp.defval });
       }
     }
+    for (const p of row.props) {
+      if (row.propValues[p.key] !== p.defval) {
+        row.propValues[p.key] = p.defval;
+        this.host.onChange?.({ indicatorId: row.id, key: p.key, value: p.defval, kind: "prop" });
+      }
+    }
     this.open(row);
     if (snap) this.snapshot = snap;
+    if (propSnap) this.propSnapshot = propSnap;
   }
   /** Write one edit through: store it, notify the host, and re-apply the `when` gates. */
-  commit(row, key, value) {
-    row.values[key] = value;
-    this.host.onChange?.({ indicatorId: row.id, key, value });
+  commit(row, decl, value) {
+    bagOf(row, decl)[decl.key] = value;
+    this.host.onChange?.({ indicatorId: row.id, key: decl.key, value, ...decl.prop ? { kind: "prop" } : {} });
     this.refreshVisibility?.();
   }
   /** One settings row (or several `inline=` inputs) placed into a section's grid. */
@@ -3147,7 +3192,7 @@ var IndicatorInputsDialog = class {
     const id = idOf(lead);
     const info = lead.tooltip ? this.infoButton(lead.tooltip) : void 0;
     if (lead.type === "bool") {
-      const current = Boolean(row.values[lead.key] ?? lead.defval);
+      const current = Boolean(bagOf(row, lead)[lead.key] ?? lead.defval);
       return append(fieldRow({
         label: nameOf(lead),
         id,
@@ -3156,7 +3201,7 @@ var IndicatorInputsDialog = class {
         toggle: {
           id,
           checked: current,
-          onChange: (v) => this.commit(row, lead.key, v)
+          onChange: (v) => this.commit(row, lead, v)
         }
       }));
     }
@@ -3181,8 +3226,8 @@ var IndicatorInputsDialog = class {
   }
   /** Build the typed control for one input, committing edits live via `onChange`. */
   buildControl(row, inp, id) {
-    const current = row.values[inp.key] ?? inp.defval;
-    const emit = (value) => this.commit(row, inp.key, value);
+    const current = bagOf(row, inp)[inp.key] ?? inp.defval;
+    const emit = (value) => this.commit(row, inp, value);
     if (inp.type === "bool") {
       return buildFieldControl({ kind: "switch", id, checked: Boolean(current), onChange: (v) => emit(v) }).el;
     }
@@ -3193,7 +3238,7 @@ var IndicatorInputsDialog = class {
         kind: "color",
         id,
         theme: this.host.theme(),
-        get: () => String(row.values[inp.key] ?? inp.defval),
+        get: () => String(bagOf(row, inp)[inp.key] ?? inp.defval),
         onChange: (v) => emit(v)
       }).el;
     }
@@ -3756,6 +3801,7 @@ function timeParts(ts) {
 }
 
 // src/renderers/shared/InputsUI.ts
+var LEGEND_AT_TOP_ATTR = "data-vela-pane-at-top";
 var STATUS_KEYFRAMES = "@keyframes vela-ind-pulse{0%,100%{opacity:1;transform:scale(1)}50%{opacity:.3;transform:scale(.6)}}";
 var LEGEND_ICON_PX2 = 16;
 var LEGEND_CTL_PX = 18;
@@ -3794,10 +3840,14 @@ var InputsUI = class {
     this.moveApi = null;
     /** Host-contributed legend actions, resolved PER ROW at render time (see setLegendActions). */
     this.legendActions = null;
+    /** Host-contributed callout bubbles, resolved PER ROW at render time (see setLegendCallouts). */
+    this.legendCallouts = null;
     /** Chrome-tooltip disposers, per row id — a tip open at removal must not outlive its row. */
     this.rowTips = /* @__PURE__ */ new Map();
     /** Same, for the contributed extras only (rebuilt independently by setLegendActions). */
     this.extrasTips = /* @__PURE__ */ new Map();
+    /** Same, for the contributed callouts only (rebuilt independently by setLegendCallouts). */
+    this.calloutTips = /* @__PURE__ */ new Map();
     /** Open "Move to" menu (kept so it can be torn down). */
     this.moveMenu = null;
     this.moveTargets = [];
@@ -3955,6 +4005,42 @@ var InputsUI = class {
       extrasEl.appendChild(btn2);
     }
   }
+  /**
+   * Wire the host-contributed callout bubbles. Same contract as
+   * {@link setLegendActions}: re-calling replaces the provider and re-projects the
+   * rows already on screen.
+   */
+  setLegendCallouts(provider) {
+    this.legendCallouts = provider;
+    for (const row of this.rows.values()) this.renderCallouts(row);
+  }
+  /** (Re)build one row's callout bubbles — tinted icon circles beside the title whose
+   *  click (when the view carries content) deploys a panel of text and actions. */
+  renderCallouts(row) {
+    this.disposeTips(this.calloutTips, row.id);
+    for (const bubble of row.callouts) bubble.destroy();
+    row.callouts = [];
+    row.calloutsEl.replaceChildren();
+    const views = this.legendCallouts?.(row.id) ?? [];
+    row.calloutsEl.style.display = views.length > 0 ? "inline-flex" : "none";
+    for (const view of views) {
+      const bubble = new CalloutBubble({
+        icon: view.icon,
+        background: view.background,
+        ...view.color !== void 0 ? { color: view.color } : {},
+        label: view.tooltip,
+        ...view.content !== void 0 ? { panel: view.content } : {},
+        // The panel portals into the plot host and self-tokens: it must work on
+        // a bare chart, where no `.vela-ui` token ancestor exists.
+        host: this.container,
+        theme: () => this.theme
+      });
+      bubble.el.dataset.legendCallout = view.id;
+      this.tip(this.calloutTips, row.id, bubble.el, view.tooltip);
+      row.callouts.push(bubble);
+      row.calloutsEl.appendChild(bubble.el);
+    }
+  }
   /** Reposition the per-pane legend containers after a layout change. */
   reposition() {
     for (const [paneId, lg] of this.legends) this.positionLegend(lg, paneId);
@@ -4122,6 +4208,7 @@ var InputsUI = class {
   }
   positionLegend(lg, paneId) {
     const bounds = this.paneBoundsOf ? this.paneBoundsOf(paneId) : { top: 0, height: Infinity };
+    lg.toggleAttribute(LEGEND_AT_TOP_ATTR, bounds.top === 0);
     lg.style.display = bounds.height < 4 || !this.titlesVisible ? "none" : "flex";
     const collapsed = this.paneCollapse.has(paneId);
     const masterId = this.paneCollapse.get(paneId) ?? null;
@@ -4197,13 +4284,13 @@ var InputsUI = class {
   }
   /** Create or update an indicator's legend row (in the legend for its pane). */
   upsert(id, title, inputs, values, paneId = "price", opts = {}) {
-    const settingsTitle = opts.settingsTitle ?? title;
     const existing = this.rows.get(id);
     if (existing) {
       existing.title = title;
-      existing.settingsTitle = settingsTitle;
       existing.inputs = inputs;
       existing.values = { ...values };
+      existing.props = opts.props ?? [];
+      existing.propValues = { ...opts.propValues ?? {} };
       existing.titleEl.textContent = title;
       if (existing.paneId !== paneId) {
         existing.paneId = paneId;
@@ -4255,6 +4342,9 @@ var InputsUI = class {
       titleWrap.appendChild(beta);
     }
     el.appendChild(titleWrap);
+    const calloutsEl = document.createElement("span");
+    calloutsEl.style.cssText = `display:none;align-items:center;gap:4px;flex:none;margin-left:${LEGEND_TITLE_STATUS_GAP_PX}px;`;
+    el.appendChild(calloutsEl);
     el.appendChild(statusEl);
     const valuesEl = document.createElement("span");
     valuesEl.style.cssText = `display:none;align-items:center;gap:5px;margin-left:${LEGEND_TITLE_VALUES_GAP_PX}px;white-space:nowrap;font-variant-numeric:tabular-nums;`;
@@ -4271,13 +4361,13 @@ var InputsUI = class {
       eye.className = "vela-ind-ctl";
       eye.style.cssText = LEGEND_CTL_CSS;
       eye.addEventListener("click", () => {
-        const row = this.rows.get(id);
-        this.onToggleVisible?.(id, Boolean(row?.hidden));
+        const row2 = this.rows.get(id);
+        this.onToggleVisible?.(id, Boolean(row2?.hidden));
       });
       controlsEl.appendChild(eye);
       eyeEl = eye;
     }
-    if (inputs.length > 0) {
+    if (inputs.length > 0 || (opts.props ?? []).length > 0) {
       const gear = document.createElement("button");
       gear.type = "button";
       gear.setAttribute("aria-label", "Settings");
@@ -4317,7 +4407,9 @@ var InputsUI = class {
     controlsEl.appendChild(close);
     el.appendChild(controlsEl);
     this.attach(this.legendFor(paneId), el, !!opts.native);
-    this.rows.set(id, { id, title, settingsTitle, inputs, values: { ...values }, el, titleEl, statusEl, valuesEl, plotValues: [], plotValuesKey: "", showValues: null, highlighted: false, paneId, hidden: false, eyeEl, controlsEl, extrasEl, native: !!opts.native });
+    const row = { id, title, inputs, values: { ...values }, props: opts.props ?? [], propValues: { ...opts.propValues ?? {} }, el, titleEl, statusEl, valuesEl, plotValues: [], plotValuesKey: "", showValues: null, highlighted: false, paneId, hidden: false, eyeEl, controlsEl, extrasEl, calloutsEl, callouts: [], native: !!opts.native };
+    this.rows.set(id, row);
+    this.renderCallouts(row);
     this.syncFoldToggle();
   }
   /** Place a row in its pane's legend — native rows PREPEND (pinned to the top), Pine rows append. */
@@ -4326,9 +4418,11 @@ var InputsUI = class {
     else container.appendChild(el);
   }
   /** Reflect programmatic input changes (so a re-opened dialog shows current values). */
-  setValues(id, values) {
+  setValues(id, values, props) {
     const row = this.rows.get(id);
-    if (row) row.values = { ...row.values, ...values };
+    if (!row) return;
+    row.values = { ...row.values, ...values };
+    if (props) row.propValues = { ...row.propValues, ...props };
   }
   /**
    * Reflect an indicator's live status in its legend row: `'loading'` shows three pulsing
@@ -4410,8 +4504,13 @@ var InputsUI = class {
   syncRowActions(row) {
     const open = row.highlighted;
     row.controlsEl.style.display = open || row.hidden ? "inline-flex" : "none";
-    if (open) row.el.appendChild(row.statusEl);
-    else row.el.insertBefore(row.statusEl, row.valuesEl);
+    if (open) {
+      row.el.appendChild(row.statusEl);
+      row.el.appendChild(row.calloutsEl);
+    } else {
+      row.el.insertBefore(row.statusEl, row.valuesEl);
+      row.el.insertBefore(row.calloutsEl, row.statusEl);
+    }
     for (const child of Array.from(row.controlsEl.children)) {
       if (!(child instanceof HTMLElement) || child === row.eyeEl) continue;
       if (child === row.extrasEl) {
@@ -4429,10 +4528,12 @@ var InputsUI = class {
   }
   remove(id) {
     const row = this.rows.get(id);
+    for (const bubble of row?.callouts ?? []) bubble.destroy();
     row?.el.remove();
     this.rows.delete(id);
     this.disposeTips(this.rowTips, id);
     this.disposeTips(this.extrasTips, id);
+    this.disposeTips(this.calloutTips, id);
     if (this.selectedId === id) this.selectedId = null;
     if (this.inputsDialog.openId === id) this.inputsDialog.close();
     this.syncFoldToggle();
@@ -4452,6 +4553,8 @@ var InputsUI = class {
     this.rowMenu = null;
     for (const id of [...this.rowTips.keys()]) this.disposeTips(this.rowTips, id);
     for (const id of [...this.extrasTips.keys()]) this.disposeTips(this.extrasTips, id);
+    for (const id of [...this.calloutTips.keys()]) this.disposeTips(this.calloutTips, id);
+    for (const row of this.rows.values()) for (const bubble of row.callouts) bubble.destroy();
     for (const lg of this.legends.values()) lg.remove();
     this.legends.clear();
     this.rows.clear();
@@ -4806,6 +4909,32 @@ var SIZE_PX = {
   large: 16,
   huge: 20
 };
+function fontPxOf(size) {
+  if (typeof size === "number") return size > 0 ? size : SIZE_PX.auto;
+  return SIZE_PX[size] ?? SIZE_PX.auto;
+}
+function tableHasContent(t) {
+  return t.cells.some((row) => row?.some((c) => c != null && !c.merged));
+}
+function mergeRenderPlan(t) {
+  const span = /* @__PURE__ */ new Map();
+  const omit = /* @__PURE__ */ new Set();
+  for (const m of t.merges) {
+    span.set(`${m.startRow}:${m.startCol}`, { cs: m.endCol - m.startCol + 1, rs: m.endRow - m.startRow + 1 });
+    for (let r = m.startRow; r <= m.endRow; r += 1) {
+      for (let c = m.startCol; c <= m.endCol; c += 1) {
+        if (r !== m.startRow || c !== m.startCol) omit.add(`${r}:${c}`);
+      }
+    }
+  }
+  for (let r = 0; r < t.rows; r += 1) {
+    for (let c = 0; c < t.columns; c += 1) {
+      if (t.cells[r]?.[c]?.merged && !span.has(`${r}:${c}`)) omit.add(`${r}:${c}`);
+    }
+  }
+  for (const key of span.keys()) omit.delete(key);
+  return { span, omit };
+}
 var TableOverlay = class {
   constructor(container, theme, paneBounds) {
     this.container = container;
@@ -4826,7 +4955,9 @@ var TableOverlay = class {
   update(tables) {
     this.lastTables = tables;
     this.root.replaceChildren();
-    for (const t of tables) this.root.appendChild(this.renderTable(t));
+    for (const t of tables) {
+      if (tableHasContent(t)) this.root.appendChild(this.renderTable(t));
+    }
   }
   /** Re-render at the current pane geometry — after layout settles or on resize. */
   reposition() {
@@ -4841,39 +4972,36 @@ var TableOverlay = class {
     this.root.remove();
   }
   renderTable(t) {
+    const b = this.paneBounds(t.paneId);
     const wrap = document.createElement("div");
     wrap.style.position = "absolute";
-    this.anchor(wrap, t.position, this.paneBounds(t.paneId));
+    if (t.frameColor && t.frameWidth > 0) wrap.style.border = `${t.frameWidth}px solid ${t.frameColor}`;
+    this.anchor(wrap, t.position, b);
     const table = document.createElement("table");
     Object.assign(table.style, {
       borderCollapse: "collapse",
       background: t.bgColor ?? "transparent",
       fontFamily: this.theme.fontFamily || "sans-serif",
-      // Frame as an inset shadow (not a `border`) so it stays independent of the
-      // collapsed cell borders even when frame_width != border_width.
-      boxShadow: t.frameColor && t.frameWidth > 0 ? `inset 0 0 0 ${t.frameWidth}px ${t.frameColor}` : "none",
       border: "none",
       tableLayout: "auto",
       // Re-enable pointer events on the table only (root is none) so cell tooltips work.
       pointerEvents: "auto"
     });
-    const span = /* @__PURE__ */ new Map();
-    const skip = /* @__PURE__ */ new Set();
-    for (const m of t.merges) {
-      span.set(`${m.startRow}:${m.startCol}`, { cs: m.endCol - m.startCol + 1, rs: m.endRow - m.startRow + 1 });
-      for (let r = m.startRow; r <= m.endRow; r += 1) {
-        for (let c = m.startCol; c <= m.endCol; c += 1) {
-          if (r !== m.startRow || c !== m.startCol) skip.add(`${r}:${c}`);
-        }
-      }
-    }
+    const { span, omit } = mergeRenderPlan(t);
+    const plotW = Math.max(0, (this.root.clientWidth || this.container.clientWidth) - b.rightAxis);
+    const paneH = b.height;
     const cellBorder = t.borderColor && t.borderWidth > 0 ? `${t.borderWidth}px solid ${t.borderColor}` : "none";
     for (let r = 0; r < t.rows; r += 1) {
       const tr = document.createElement("tr");
       for (let c = 0; c < t.columns; c += 1) {
+        if (omit.has(`${r}:${c}`)) continue;
         const cell = t.cells[r]?.[c] ?? null;
-        if (skip.has(`${r}:${c}`) || cell?.merged) continue;
         const td = document.createElement("td");
+        if (cell === null) {
+          Object.assign(td.style, { padding: "0", border: "none" });
+          tr.appendChild(td);
+          continue;
+        }
         const sp = span.get(`${r}:${c}`);
         if (sp) {
           if (sp.cs > 1) td.colSpan = sp.cs;
@@ -4882,18 +5010,22 @@ var TableOverlay = class {
         Object.assign(td.style, {
           border: cellBorder,
           padding: "2px 6px",
-          background: cell?.bgColor ?? "transparent",
-          color: cell?.textColor ?? this.theme.textColor,
-          textAlign: cell?.hAlign ?? "center",
-          verticalAlign: cell?.vAlign === "top" ? "top" : cell?.vAlign === "bottom" ? "bottom" : "middle",
-          fontSize: `${SIZE_PX[cell?.textSize ?? "normal"]}px`,
-          fontFamily: cell?.fontFamily === "monospace" ? "monospace" : "inherit",
-          fontWeight: cell?.bold ? "bold" : "normal",
-          fontStyle: cell?.italic ? "italic" : "normal",
-          whiteSpace: "pre-line"
+          background: cell.bgColor ?? "transparent",
+          color: cell.textColor ?? this.theme.textColor,
+          textAlign: cell.hAlign,
+          verticalAlign: cell.vAlign === "top" ? "top" : cell.vAlign === "bottom" ? "bottom" : "middle",
+          fontSize: `${fontPxOf(cell.textSize)}px`,
+          fontFamily: cell.fontFamily === "monospace" ? "monospace" : "inherit",
+          fontWeight: cell.bold ? "bold" : "normal",
+          fontStyle: cell.italic ? "italic" : "normal",
+          // Pine cell text never wraps; `\n` still breaks lines. Wrapping
+          // used to collapse unicode sparklines and ━━━ dividers.
+          whiteSpace: "pre"
         });
-        if (cell?.tooltip) td.title = cell.tooltip;
-        td.textContent = cell?.text ?? "";
+        if (cell.width) td.style.width = `${cell.width / 100 * plotW}px`;
+        if (cell.height) td.style.height = `${cell.height / 100 * paneH}px`;
+        if (cell.tooltip) td.title = cell.tooltip;
+        td.textContent = cell.text ?? "";
         tr.appendChild(td);
       }
       table.appendChild(tr);
@@ -5778,8 +5910,14 @@ var WebGL2Backend = class {
           return sc === pane.scale ? pane : { ...pane, scale: sc };
         };
         b.alpha = this.modelAlpha;
-        for (const m of models) for (const bgSpan of m.backgrounds) this.emitBackground(b, bgSpan, pane, coords);
-        for (const m of models) for (const f of m.fills) this.emitFill(b, m, f, effPane(m), coords, i0, i1, scene.offsetOf(m.id));
+        for (const m of models) for (const bgSpan of m.backgrounds) if (bgSpan.overlay !== true) this.emitBackground(b, bgSpan, pane, coords);
+        for (const m of models) for (const f of m.fills) if (f.overlay !== true) this.emitFill(b, m, f, effPane(m), coords, i0, i1, scene.offsetOf(m.id));
+        if (isPrice) {
+          for (const m of scene.indicators.values()) {
+            for (const bgSpan of m.backgrounds) if (bgSpan.overlay === true) this.emitBackground(b, bgSpan, pane, coords);
+            for (const f of m.fills) if (f.overlay === true) this.emitFill(b, m, f, pane, coords, i0, i1, scene.offsetOf(m.id));
+          }
+        }
         const drawCandles = isPrice && !scene.candlesHidden;
         let candleDrawn = false;
         for (const m of models) {
@@ -5793,7 +5931,7 @@ var WebGL2Backend = class {
           b.alpha = this.modelAlpha;
           const off = scene.offsetOf(m.id);
           const mp = effPane(m);
-          for (const s of m.series) this.emitSeries(b, s, mp, coords, i0, i1, theme, off);
+          for (const s of m.series) if (s.overlay !== true) this.emitSeries(b, s, mp, coords, i0, i1, theme, off);
         }
         if (drawCandles && !candleDrawn) {
           drawSlicesUpTo(scene.candleZ);
@@ -5802,6 +5940,12 @@ var WebGL2Backend = class {
         }
         drawSlicesUpTo(Infinity);
         b.alpha = this.modelAlpha;
+        if (isPrice) {
+          for (const m of scene.indicators.values()) {
+            const off = scene.offsetOf(m.id);
+            for (const s of m.series) if (s.overlay === true) this.emitSeries(b, s, pane, coords, i0, i1, theme, off);
+          }
+        }
         for (const m of models) {
           const mp = effPane(m);
           for (const pl of m.priceLines) this.emitHline(b, pl, mp, coords, dataW, theme);
@@ -5848,7 +5992,7 @@ var WebGL2Backend = class {
     for (const pane of scene.orderedPanes()) {
       const b = this.glowBatch;
       b.reset();
-      this.emitGlowSources(b, scene.indicatorsForPane(pane.id), pane, coords, i0, i1, (id) => scene.offsetOf(id));
+      this.emitGlowSources(b, scene, pane, coords, i0, i1);
       if (b.vertexCount === 0) continue;
       const topH = Math.round(pane.bounds.top * dpr * 0.5);
       const botH = Math.round((pane.bounds.top + pane.bounds.height) * dpr * 0.5);
@@ -5917,15 +6061,23 @@ var WebGL2Backend = class {
     gl.bindVertexArray(null);
     return true;
   }
-  /** The "neon" elements that glow: line/area/step lines + point markers (not candles/fills/bars). */
-  emitGlowSources(b, models, pane, coords, i0, i1, offsetOf = () => 0) {
-    for (const m of models) {
-      const off = offsetOf(m.id);
-      for (const s of m.series) {
-        if (!isLineLikeSeries(s) || s.visible === false) continue;
-        if (s.kind === "histogram" || s.kind === "columns") continue;
-        if (s.kind === "circles" || s.kind === "cross") this.emitPointMarkers(b, s, pane, coords, i0, i1, off);
-        else this.emitPolyline(b, s, pane, coords, i0, i1, s.kind === "step", off);
+  /** The "neon" elements that glow: line/area/step lines + point markers (not candles/fills/bars).
+   *  Routing mirrors the main pass: own series per pane, force_overlay series on the price pane. */
+  emitGlowSources(b, scene, pane, coords, i0, i1) {
+    const emitOne = (s, off) => {
+      if (!isLineLikeSeries(s) || s.visible === false) return;
+      if (s.kind === "histogram" || s.kind === "columns") return;
+      if (s.kind === "circles" || s.kind === "cross") this.emitPointMarkers(b, s, pane, coords, i0, i1, off);
+      else this.emitPolyline(b, s, pane, coords, i0, i1, s.kind === "step", off);
+    };
+    for (const m of scene.indicatorsForPane(pane.id)) {
+      const off = scene.offsetOf(m.id);
+      for (const s of m.series) if (s.overlay !== true) emitOne(s, off);
+    }
+    if (pane.kind === "price") {
+      for (const m of scene.indicators.values()) {
+        const off = scene.offsetOf(m.id);
+        for (const s of m.series) if (s.overlay === true) emitOne(s, off);
       }
     }
   }
@@ -6208,9 +6360,9 @@ var WebGL2Backend = class {
           b.alpha = this.candleBodyAlpha;
           b.rect(g.bodyX, bodyTop, g.bodyW, bodyH, c);
         }
-        if (cs.borderVisible || bc || fading && cs.bodyVisible) {
+        if (cs.borderVisible || fading && cs.bodyVisible) {
           b.alpha = this.candleStructureAlpha;
-          const bord = cs.borderVisible || bc ? parseColor((isUp ? cs.borderUpColor : cs.borderDownColor) ?? dir) : c;
+          const bord = cs.borderVisible ? parseColor((isUp ? cs.borderUpColor : cs.borderDownColor) ?? bodyColorStr) : c;
           const bw = Math.max(0, g.bodyW - 1);
           const bh = Math.max(0, bodyH - 1);
           b.rectStroke(g.bodyX + 0.5, bodyTop + 0.5, bw, bh, 1, bord);
@@ -7762,8 +7914,14 @@ var Canvas2dBackend = class {
         return sc === pane.scale ? pane : { ...pane, scale: sc };
       };
       ctx.globalAlpha = this.modelAlpha;
-      for (const m of models) for (const bg of m.backgrounds) this.drawBackground(ctx, bg, pane, coords);
-      for (const m of models) for (const f of m.fills) this.drawFill(ctx, m, f, effPane(m), coords, i0, i1, scene.offsetOf(m.id));
+      for (const m of models) for (const bg of m.backgrounds) if (bg.overlay !== true) this.drawBackground(ctx, bg, pane, coords);
+      for (const m of models) for (const f of m.fills) if (f.overlay !== true) this.drawFill(ctx, m, f, effPane(m), coords, i0, i1, scene.offsetOf(m.id));
+      if (isPrice) {
+        for (const m of scene.indicators.values()) {
+          for (const bg of m.backgrounds) if (bg.overlay === true) this.drawBackground(ctx, bg, pane, coords);
+          for (const f of m.fills) if (f.overlay === true) this.drawFill(ctx, m, f, pane, coords, i0, i1, scene.offsetOf(m.id));
+        }
+      }
       const slices = scene.drawingSlices.get(pane.id) ?? [];
       let si = 0;
       const drawSlicesUpTo = (z) => {
@@ -7785,7 +7943,7 @@ var Canvas2dBackend = class {
         ctx.globalAlpha = this.modelAlpha;
         const off = scene.offsetOf(m.id);
         const mp = effPane(m);
-        for (const s of m.series) this.drawSeries(ctx, s, mp, coords, i0, i1, theme, off);
+        for (const s of m.series) if (s.overlay !== true) this.drawSeries(ctx, s, mp, coords, i0, i1, theme, off);
       }
       if (drawCandles && !candleDrawn) {
         drawSlicesUpTo(scene.candleZ);
@@ -7793,6 +7951,13 @@ var Canvas2dBackend = class {
         this.drawPriceSeries(ctx, scene, i0, i1, coords, pane, theme, barColorMap, dataW);
       }
       drawSlicesUpTo(Infinity);
+      if (isPrice) {
+        ctx.globalAlpha = this.modelAlpha;
+        for (const m of scene.indicators.values()) {
+          const off = scene.offsetOf(m.id);
+          for (const s of m.series) if (s.overlay === true) this.drawSeries(ctx, s, pane, coords, i0, i1, theme, off);
+        }
+      }
       ctx.globalAlpha = this.modelAlpha;
       for (const m of models) {
         const mp = effPane(m);
@@ -8064,9 +8229,9 @@ var Canvas2dBackend = class {
           ctx.fillStyle = color;
           ctx.fillRect(g.bodyX, top, g.bodyW, bodyH);
         }
-        if (cs.borderVisible || bc || fading && cs.bodyVisible) {
+        if (cs.borderVisible || fading && cs.bodyVisible) {
           ctx.globalAlpha = this.candleStructureAlpha;
-          ctx.strokeStyle = cs.borderVisible || bc ? (up ? cs.borderUpColor : cs.borderDownColor) ?? dir : color;
+          ctx.strokeStyle = cs.borderVisible ? (up ? cs.borderUpColor : cs.borderDownColor) ?? color : color;
           ctx.lineWidth = 1;
           const bw = Math.max(0, g.bodyW - 1);
           const bh = Math.max(0, bodyH - 1);
@@ -8498,6 +8663,8 @@ var DrawingSceneRenderer = class {
     this.set = set;
     /** measureText width cache, keyed by `${font} ${text}`, persists across frames. */
     this.widthCache = /* @__PURE__ */ new Map();
+    /** Tooltip hit-rects captured while drawing the CURRENT set (rebuilt per render). */
+    this.tipRegions = [];
     /**
      * Index offset of the CURRENT set's model: its `xloc:'bar_index'` coordinates count
      * from the model's anchor bar, so they shift by this to land on chart logical indices.
@@ -8518,8 +8685,13 @@ var DrawingSceneRenderer = class {
     const s = this.set;
     return !s.lines.length && !s.boxes.length && !s.labels.length && !s.polylines.length && !s.linefills.length;
   }
+  /** Tooltip hit-rects of the labels drawn by the LAST `render` call (same coords as `ctx`). */
+  labelTipRegions() {
+    return this.tipRegions;
+  }
   /** Draw the whole set into `ctx` using the supplied coordinate closures. */
   render(ctx, W, H, xOf, yOf) {
+    this.tipRegions = [];
     if (this.isEmpty()) return;
     ctx.save();
     this.drawLinefills(ctx, W, H, xOf, yOf);
@@ -8867,13 +9039,35 @@ var DrawingSceneRenderer = class {
       if (this.isPointShape(lb.style)) {
         if (!lb.noFill) this.drawLabelShape(ctx, lb.style, px, py, fontPx, color);
         if (lb.text) this.drawLabelText(ctx, lb, px, py + fontPx, fontPx);
-      } else if (lb.style === "none" || lb.style === "text_outline" || lb.noFill) {
-        if (lb.text) this.drawLabelText(ctx, lb, px, py, fontPx, lb.style === "text_outline");
+        if (lb.tooltip) {
+          const r = Math.max(4, fontPx * 0.6) + 3;
+          this.tipRegions.push({ left: px - r, top: py - r, right: px + r, bottom: py + r, text: lb.tooltip });
+        }
+      } else if (lb.style === "none" || lb.style === "text_outline") {
+        if (lb.text) {
+          this.drawLabelText(ctx, lb, px, py, fontPx, lb.style === "text_outline");
+          if (lb.tooltip) this.tipRegions.push(this.textRegion(ctx, lb, px, py, fontPx, lb.tooltip));
+        }
       } else {
-        this.drawBubble(ctx, lb, px, py, fontPx, color);
+        const r = this.drawBubble(ctx, lb, px, py, fontPx, color);
+        if (lb.tooltip) this.tipRegions.push({ left: r.x, top: r.y, right: r.x + r.w, bottom: r.y + r.h, text: lb.tooltip });
       }
     }
   }
+  /** Canvas font for a label's text — family + Pine `text_formatting` (bold/italic). */
+  labelFont(lb, fontPx) {
+    const family = lb.fontFamily === "monospace" ? "monospace" : this.deps.theme.fontFamily || "sans-serif";
+    return `${lb.italic ? "italic " : ""}${lb.bold ? "bold " : ""}${fontPx}px ${family}`;
+  }
+  /** Hover rect of a text-only label (style none/text_outline/noFill), centered like drawLabelText. */
+  textRegion(ctx, lb, cx, cy, fontPx, text) {
+    const font = this.labelFont(lb, fontPx);
+    const lines = (lb.text ?? "").split("\n");
+    const w = Math.max(1, ...lines.map((l) => this.measure(ctx, font, l)));
+    const h = fontPx * 1.25 * lines.length;
+    const left = lb.textAlign === "left" ? cx : lb.textAlign === "right" ? cx - w : cx - w / 2;
+    return { left, top: cy - h / 2, right: left + w, bottom: cy + h / 2, text };
+  }
   isPointShape(style) {
     switch (style) {
       case "circle":
@@ -8892,8 +9086,7 @@ var DrawingSceneRenderer = class {
     }
   }
   drawLabelText(ctx, lb, cx, cy, fontPx, outline = false) {
-    const family = lb.fontFamily === "monospace" ? "monospace" : this.deps.theme.fontFamily || "sans-serif";
-    ctx.font = `${fontPx}px ${family}`;
+    ctx.font = this.labelFont(lb, fontPx);
     ctx.textAlign = lb.textAlign === "left" ? "left" : lb.textAlign === "right" ? "right" : "center";
     ctx.textBaseline = "middle";
     const lines = lb.text.split("\n");
@@ -8973,9 +9166,9 @@ var DrawingSceneRenderer = class {
         ctx.fill();
     }
   }
+  /** Draw a bubble label; returns the bubble body rect (for tooltip hit-testing). */
   drawBubble(ctx, lb, px, py, fontPx, color) {
-    const family = lb.fontFamily === "monospace" ? "monospace" : this.deps.theme.fontFamily || "sans-serif";
-    ctx.font = `${fontPx}px ${family}`;
+    ctx.font = this.labelFont(lb, fontPx);
     const lines = (lb.text ?? "").split("\n");
     const padX = 6;
     const padY = 4;
@@ -9033,38 +9226,51 @@ var DrawingSceneRenderer = class {
         by = py - h - ptr;
         pointer = "down";
     }
-    ctx.fillStyle = color;
-    this.roundRect(ctx, bx, by, w, h, 4);
-    ctx.fill();
-    if (pointer !== "none") {
-      ctx.beginPath();
-      if (pointer === "down") {
-        ctx.moveTo(px - ptr, by + h);
-        ctx.lineTo(px + ptr, by + h);
-        ctx.lineTo(px, py);
-      } else if (pointer === "up") {
-        ctx.moveTo(px - ptr, by);
-        ctx.lineTo(px + ptr, by);
-        ctx.lineTo(px, py);
-      } else if (pointer === "left") {
-        ctx.moveTo(bx, py - ptr);
-        ctx.lineTo(bx, py + ptr);
-        ctx.lineTo(px, py);
-      } else {
-        ctx.moveTo(bx + w, py - ptr);
-        ctx.lineTo(bx + w, py + ptr);
-        ctx.lineTo(px, py);
-      }
-      ctx.closePath();
+    if (!lb.noFill) {
+      ctx.fillStyle = color;
+      this.roundRect(ctx, bx, by, w, h, 4);
       ctx.fill();
+      if (pointer !== "none") {
+        ctx.beginPath();
+        if (pointer === "down") {
+          ctx.moveTo(px - ptr, by + h);
+          ctx.lineTo(px + ptr, by + h);
+          ctx.lineTo(px, py);
+        } else if (pointer === "up") {
+          ctx.moveTo(px - ptr, by);
+          ctx.lineTo(px + ptr, by);
+          ctx.lineTo(px, py);
+        } else if (pointer === "left") {
+          ctx.moveTo(bx, py - ptr);
+          ctx.lineTo(bx, py + ptr);
+          ctx.lineTo(px, py);
+        } else {
+          ctx.moveTo(bx + w, py - ptr);
+          ctx.lineTo(bx + w, py + ptr);
+          ctx.lineTo(px, py);
+        }
+        ctx.closePath();
+        ctx.fill();
+      }
     }
     if (lb.text) {
-      ctx.fillStyle = lb.textColor ?? contrastColor(color);
-      ctx.textAlign = "center";
+      ctx.fillStyle = lb.textColor ?? (lb.noFill ? this.deps.theme.textColor : contrastColor(color));
       ctx.textBaseline = "middle";
+      let tx;
+      if (lb.textAlign === "left") {
+        ctx.textAlign = "left";
+        tx = bx + padX;
+      } else if (lb.textAlign === "right") {
+        ctx.textAlign = "right";
+        tx = bx + w - padX;
+      } else {
+        ctx.textAlign = "center";
+        tx = bx + w / 2;
+      }
       const startY = by + padY + lineH / 2;
-      for (let i = 0; i < lines.length; i += 1) ctx.fillText(lines[i], bx + w / 2, startY + i * lineH);
+      for (let i = 0; i < lines.length; i += 1) ctx.fillText(lines[i], tx, startY + i * lineH);
     }
+    return { x: bx, y: by, w, h };
   }
   roundRect(ctx, x, y, w, h, r) {
     const rr = Math.min(r, w / 2, h / 2);
@@ -9302,6 +9508,8 @@ var ChromeRenderer = class {
     this.axisTextColor = DARK_THEME.textColor;
     // Shared Pine-drawing renderer (line/box/label/polyline/linefill); widthCache persists.
     this.drawScene = new DrawingSceneRenderer({ timeToLogical: () => 0, barAt: () => null, theme: {} });
+    // Tooltip hit-rects of every label drawn this frame, in plot coords (rebuilt per render).
+    this.labelTips = [];
   }
   mount(canvas) {
     this.canvas = canvas;
@@ -9343,6 +9551,7 @@ var ChromeRenderer = class {
     const dataW = coords.width;
     const dataH = coords.height;
     this.axisTextColor = surface?.textColor ?? theme.textColor;
+    this.labelTips = [];
     ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
     ctx.clearRect(0, 0, fullW, fullH);
     if (surface && (fullW > dataW || fullH > dataH)) {
@@ -9452,6 +9661,17 @@ var ChromeRenderer = class {
       (price) => coords.priceToY(price, pane.scale, pane.bounds) - pane.bounds.top
     );
     ctx.restore();
+    for (const r of this.drawScene.labelTipRegions()) {
+      this.labelTips.push({ ...r, top: r.top + pane.bounds.top, bottom: r.bottom + pane.bounds.top });
+    }
+  }
+  /** Tooltip of the topmost label under a plot-space point, or null. Fed by the last render. */
+  labelTooltipAt(x, y) {
+    for (let i = this.labelTips.length - 1; i >= 0; i -= 1) {
+      const r = this.labelTips[i];
+      if (x >= r.left && x <= r.right && y >= r.top && y <= r.bottom) return r.text;
+    }
+    return null;
   }
   // ── axes ──
   drawPriceAxes(ctx, scene, coords, theme, dataW, panes) {
@@ -9668,6 +9888,68 @@ function formatCountdown(ms) {
   return h > 0 ? `${h}:${pad(m)}:${pad(s)}` : `${pad(m)}:${pad(s)}`;
 }
 
+// src/renderers/native/chrome/LabelTooltip.ts
+var HOVER_DELAY_MS = 350;
+var LabelTooltip = class {
+  constructor(plot, deps) {
+    this.plot = plot;
+    this.deps = deps;
+    this.tip = null;
+    this.timer = null;
+    /** Text of the currently open OR armed tip — dedupes moves inside one label. */
+    this.current = null;
+    this.onMove = (e) => {
+      if (e.pointerType !== "mouse") return;
+      const rect = this.plot.getBoundingClientRect();
+      const x = e.clientX - rect.left;
+      const y = e.clientY - rect.top;
+      const text = this.deps.lookup(x, y);
+      if (!text) {
+        this.clear();
+        return;
+      }
+      if (text === this.current) return;
+      this.clear();
+      this.current = text;
+      this.timer = window.setTimeout(() => this.show(text, x, y), HOVER_DELAY_MS);
+    };
+    this.onLeave = () => {
+      this.clear();
+    };
+    plot.addEventListener("pointermove", this.onMove);
+    plot.addEventListener("pointerleave", this.onLeave);
+    plot.addEventListener("pointerdown", this.onLeave);
+  }
+  destroy() {
+    this.plot.removeEventListener("pointermove", this.onMove);
+    this.plot.removeEventListener("pointerleave", this.onLeave);
+    this.plot.removeEventListener("pointerdown", this.onLeave);
+    this.clear();
+  }
+  show(text, x, y) {
+    const doc = this.plot.ownerDocument;
+    const tip = doc.createElement("div");
+    tip.textContent = text;
+    tip.style.cssText = "position:absolute;z-index:var(--vela-z-tooltip);pointer-events:none;background:var(--vela-bg);border:1px solid var(--vela-border);color:var(--vela-fg);border-radius:var(--vela-radius-md);padding:4px 9px;box-shadow:var(--vela-shadow);font:var(--vela-font-size-md) var(--vela-font);max-width:260px;";
+    applyChromeTokens(tip, this.deps.theme());
+    this.plot.appendChild(tip);
+    const pw = this.plot.clientWidth;
+    const ph = this.plot.clientHeight;
+    tip.style.left = `${Math.max(0, Math.min(x + 12, pw - tip.offsetWidth - 4))}px`;
+    tip.style.top = `${Math.max(0, Math.min(y + 16, ph - tip.offsetHeight - 4))}px`;
+    this.tip = tip;
+  }
+  clear() {
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    this.tip?.remove();
+    this.tip = null;
+    this.current = null;
+  }
+};
+
 // src/renderers/native/chrome/CrosshairRenderer.ts
 var CrosshairRenderer = class {
   constructor() {
@@ -14745,19 +15027,8 @@ function computePaneScale(models, bars, includeCandles, i0, i1, drawings, log =
   for (const model of models) {
     const off = offsetOf(model.id);
     for (const s of model.series) {
-      if (s.kind === "candle" || s.kind === "bar") {
-        for (let i = i0; i <= i1; i += 1) {
-          const b = s.bars[i - off];
-          if (b) {
-            consider(b.high);
-            consider(b.low);
-          }
-        }
-      } else if (isLineLikeSeries(s)) {
-        for (let i = i0; i <= i1; i += 1) consider(s.points[i - off]?.value);
-        if (s.kind === "histogram" || s.kind === "columns") consider(s.style?.base ?? 0);
-        else if (s.style?.base != null) consider(s.style.base);
-      }
+      if (s.overlay === true) continue;
+      considerSeries(s, i0, i1, off, consider);
     }
     for (const pl of model.priceLines) consider(pl.price);
   }
@@ -14779,6 +15050,36 @@ function computePaneScale(models, bars, includeCandles, i0, i1, drawings, log =
   const span = max - min;
   return { min: min - span * MARGIN_BOTTOM, max: max + span * MARGIN_TOP };
 }
+function considerSeries(s, i0, i1, off, consider) {
+  if (s.kind === "candle" || s.kind === "bar") {
+    for (let i = i0; i <= i1; i += 1) {
+      const b = s.bars[i - off];
+      if (b) {
+        consider(b.high);
+        consider(b.low);
+      }
+    }
+  } else if (isLineLikeSeries(s)) {
+    for (let i = i0; i <= i1; i += 1) consider(s.points[i - off]?.value);
+    if (s.kind === "histogram" || s.kind === "columns") consider(s.style?.base ?? 0);
+    else if (s.style?.base != null) consider(s.style.base);
+  }
+}
+function overlaySeriesRange(models, i0, i1, offsetOf = () => 0) {
+  let min = Infinity;
+  let max = -Infinity;
+  const consider = (v) => {
+    if (v != null && Number.isFinite(v)) {
+      if (v < min) min = v;
+      if (v > max) max = v;
+    }
+  };
+  for (const model of models) {
+    const off = offsetOf(model.id);
+    for (const s of model.series) if (s.overlay === true) considerSeries(s, i0, i1, off, consider);
+  }
+  return min === Infinity ? null : { min, max };
+}
 function expandScaleByPixels(scale, heightPx, abovePx, belowPx) {
   if (abovePx <= 0 && belowPx <= 0) return scale;
   const content = heightPx - abovePx - belowPx;
@@ -15535,6 +15836,8 @@ var NativeRenderer = class {
     this.glowAmount = 0;
     // WebGL2 neon-glow intensity (canvas2d ignores it)
     this.chrome = new ChromeRenderer();
+    /** Hover tooltips for Pine labels (canvas hit-rects collected by the chrome layer). */
+    this.labelTooltip = null;
     this.crosshairLayer = new CrosshairRenderer();
     /** 1 Hz repaint pump so the price-axis countdown-to-bar-close ticks; null when off. */
     this.countdownTimer = null;
@@ -15545,6 +15848,8 @@ var NativeRenderer = class {
     this.indicatorValuesOn = true;
     /** Host-contributed legend actions — held here so a rebuild of the legend re-wires them. */
     this.legendActionsProvider = null;
+    /** Host-contributed legend callouts — held here so a rebuild of the legend re-wires them. */
+    this.legendCalloutsProvider = null;
     /** Host override of the legend's fold toggle — held here so a remount re-applies it. */
     this.legendOverviewAction = null;
     // ── keyboard navigation / accessibility (item 11) ──
@@ -16653,6 +16958,10 @@ var NativeRenderer = class {
     this.plot.appendChild(this.scrollButton);
     this.plot.addEventListener("pointermove", this.onScrollProximityMove);
     this.plot.addEventListener("pointerleave", this.onScrollProximityLeave);
+    this.labelTooltip = new LabelTooltip(this.plot, {
+      theme: () => this.chromeTheme(),
+      lookup: (x, y) => this.chrome.labelTooltipAt(x, y)
+    });
     this.userDrawings = new UserDrawingController(this.wrapper, this.plot, this.drawingsCanvas, {
       projector: () => this.drawingProjector(),
       dpr: () => this.coords.dpr,
@@ -16692,9 +17001,10 @@ var NativeRenderer = class {
     this.inputsUI.setDialogHost(this.dialogHost);
     this.inputsUI.setSymbolPicker(this.symbolPicker);
     this.inputsUI.setLegendActions(this.legendActionsProvider);
+    this.inputsUI.setLegendCallouts(this.legendCalloutsProvider);
     this.inputsUI.setLegendOverviewAction(this.legendOverviewAction);
     this.inputsUI.setOnChange((c) => {
-      for (const cb of this.inputChangeCbs) cb({ indicatorId: c.indicatorId, key: c.key, value: c.value });
+      for (const cb of this.inputChangeCbs) cb({ indicatorId: c.indicatorId, key: c.key, value: c.value, ...c.kind ? { kind: c.kind } : {} });
     });
     this.inputsUI.setOnRemove((id) => {
       for (const cb of this.removeIndicatorCbs) cb(id);
@@ -16884,6 +17194,8 @@ var NativeRenderer = class {
     this.settingsButton = null;
     this.plot?.removeEventListener("pointermove", this.onScrollProximityMove);
     this.plot?.removeEventListener("pointerleave", this.onScrollProximityLeave);
+    this.labelTooltip?.destroy();
+    this.labelTooltip = null;
     this.scrollButton?.remove();
     this.scrollButton = null;
     for (const l of this.extLayers) l.instance.destroy?.();
@@ -17124,7 +17436,7 @@ var NativeRenderer = class {
     else this.scene.assignIndicatorZ(model.id);
     this.inputsUI.upsert(model.id, model.shorttitle ?? model.title, model.inputs, model.inputValues, model.paneId, {
       native: !!model.native,
-      ...model.shorttitle ? { settingsTitle: model.title } : {}
+      ...model.props ? { props: model.props, propValues: model.propValues ?? {} } : {}
     });
     this.syncTables(model);
     if (model.native?.type === "volume") {
@@ -17175,8 +17487,8 @@ var NativeRenderer = class {
     this.paneControls?.refresh();
     this.scheduler.invalidate(4 /* Full */);
   }
-  setIndicatorInputs(handle, values) {
-    this.inputsUI.setValues(handle.id, values);
+  setIndicatorInputs(handle, values, props) {
+    this.inputsUI.setValues(handle.id, values, props);
   }
   setSymbolPicker(picker) {
     this.symbolPicker = picker;
@@ -17186,6 +17498,10 @@ var NativeRenderer = class {
     this.legendActionsProvider = provider;
     this.inputsUI?.setLegendActions(provider);
   }
+  setLegendCallouts(provider) {
+    this.legendCalloutsProvider = provider;
+    this.inputsUI?.setLegendCallouts(provider);
+  }
   setLegendOverviewAction(action) {
     this.legendOverviewAction = action;
     this.inputsUI?.setLegendOverviewAction(action);
@@ -18166,7 +18482,11 @@ var NativeRenderer = class {
       }
       const models = this.scene.indicatorsForPane(pane.id);
       const masterModels = models.filter((m) => m.ownScale !== true);
-      const dr = this.chrome.paneDrawingsRange(masterModels, this.scene, pane === pricePane, vr);
+      let dr = this.chrome.paneDrawingsRange(masterModels, this.scene, pane === pricePane, vr);
+      if (pane === pricePane) {
+        const or = overlaySeriesRange(this.scene.indicators.values(), i0, i1, (id) => this.scene.offsetOf(id));
+        if (or) dr = dr ? { min: Math.min(dr.min, or.min), max: Math.max(dr.max, or.max) } : or;
+      }
       const includeCandles = pane.kind === "price" && !this.scene.candlesHidden;
       pane.scaleTarget = computePaneScale(masterModels, this.bars, includeCandles, i0, i1, dr, paneLogScale(this.scene, pane), (id) => this.scene.offsetOf(id));
       pane.percentBaseline = pane.kind === "price" ? this.bars[i0]?.close ?? 0 : this.firstVisibleValue(masterModels, i0);
@@ -18440,6 +18760,7 @@ var NativeRenderer = class {
     for (const m of models) {
       const off = this.scene.offsetOf(m.id);
       for (const s of m.series) {
+        if (s.overlay === true) continue;
         if (isLineLikeSeries(s)) {
           const v = s.points[i0 - off]?.value;
           if (v != null && Number.isFinite(v)) return v;
@@ -18820,6 +19141,7 @@ var IndicatorHandleImpl = class {
   constructor(id, title, controller, source) {
     this.controller = controller;
     this.schema = [];
+    this.propsSchema = [];
     this.visibleState = true;
     this.bus = new TypedEventBus();
     this.id = id;
@@ -18829,6 +19151,9 @@ var IndicatorHandleImpl = class {
   get inputs() {
     return this.schema;
   }
+  get props() {
+    return this.propsSchema;
+  }
   get visible() {
     return this.visibleState;
   }
@@ -18838,6 +19163,12 @@ var IndicatorHandleImpl = class {
   setInputs(values) {
     this.controller.applyInputs(this.id, values);
   }
+  setProp(key, value) {
+    this.controller.applyProps(this.id, { [key]: value });
+  }
+  setProps(values) {
+    this.controller.applyProps(this.id, values);
+  }
   setVisible(visible) {
     this.controller.setVisible(this.id, visible);
   }
@@ -18857,6 +19188,9 @@ var IndicatorHandleImpl = class {
   setSchema(schema) {
     this.schema = schema;
   }
+  setPropsSchema(schema) {
+    this.propsSchema = schema;
+  }
   /** Sync the public `visible` getter when the orchestrator changes visibility (API or legend eye). */
   setVisibleState(visible) {
     this.visibleState = visible;
@@ -18870,6 +19204,8 @@ var IndicatorHandleImpl = class {
 function summarizeModel(model) {
   const series = {};
   for (const s of model.series) series[s.kind] = (series[s.kind] ?? 0) + 1;
+  const countOverlay = (items) => items?.filter((i) => i.overlay === true).length ?? 0;
+  const forcedOverlay = countOverlay(model.series) + countOverlay(model.fills) + countOverlay(model.backgrounds) + countOverlay(model.lines) + countOverlay(model.boxes) + countOverlay(model.labels) + countOverlay(model.polylines) + countOverlay(model.linefills) + countOverlay(model.tables);
   return {
     id: model.id,
     title: model.title,
@@ -18889,7 +19225,8 @@ function summarizeModel(model) {
     tables: model.tables?.length ?? 0,
     barColors: model.barColors?.length ?? 0,
     trades: model.trades?.length ?? 0,
-    inputs: model.inputs.length
+    inputs: model.inputs.length,
+    forcedOverlay
   };
 }
 function inspectModels(models) {
@@ -18910,7 +19247,8 @@ function inspectModels(models) {
       linefills: sum((s) => s.linefills),
       tables: sum((s) => s.tables),
       barColors: sum((s) => s.barColors),
-      trades: sum((s) => s.trades)
+      trades: sum((s) => s.trades),
+      forcedOverlay: sum((s) => s.forcedOverlay)
     }
   };
 }
@@ -19054,7 +19392,9 @@ var EngineOrchestrator = class _EngineOrchestrator {
     for (const engine of engines) this.registerEngine(engine.language, engine);
     this.defaultLanguage = config.defaultLanguage;
     this.renderer.mount(container, config.theme);
-    this.renderer.onInputChange((e) => this.applyInputs(e.indicatorId, { [e.key]: e.value }));
+    this.renderer.onInputChange(
+      (e) => e.kind === "prop" ? this.applyProps(e.indicatorId, { [e.key]: e.value }) : this.applyInputs(e.indicatorId, { [e.key]: e.value })
+    );
     this.renderer.onRemoveIndicator((id) => this.removeIndicator(id));
     this.renderer.onToggleIndicatorVisible?.((id, visible) => this.setVisible(id, visible));
     this.paneActionUnsub = this.renderer.onPaneAction?.((a) => this.handlePaneAction(a)) ?? null;
@@ -19734,7 +20074,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
     const title = options.title ?? "Indicator";
     const handle = new IndicatorHandleImpl(id, title, this, source);
     this.handles.set(id, handle);
-    this.registry.add({ id, title, source, options, inputValues: { ...options.inputs ?? {} } });
+    this.registry.add({ id, title, source, options, inputValues: { ...options.inputs ?? {} }, propValues: { ...options.props ?? {} } });
     void this.startIndicator(id, source, options, handle);
     return handle;
   }
@@ -19757,7 +20097,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
       return handle;
     }
     const inputValues = { ...descriptor.defaultInputs(), ...options.inputs ?? {} };
-    this.registry.add({ id, title, source: type, inputValues, native: { type, instance: descriptor.create(), descriptor } });
+    this.registry.add({ id, title, source: type, inputValues, propValues: {}, native: { type, instance: descriptor.create(), descriptor } });
     handle.setSchema(descriptor.inputsSchema());
     void this.startNativeIndicator(id, handle);
     return handle;
@@ -19810,6 +20150,19 @@ var EngineOrchestrator = class _EngineOrchestrator {
     if (record.session) record.session.update(record.inputValues);
     else if (record.native && !record.hidden) record.native.instance.setInputs(record.inputValues);
   }
+  /** IndicatorController: re-run an indicator with merged declaration-prop overrides.
+   *  Same lifecycle as {@link applyInputs} — a prop change replays the whole script.
+   *  Script indicators only: natives have no declaration props. */
+  applyProps(id, values) {
+    const record = this.registry.get(id);
+    if (!record?.session) return;
+    record.propValues = { ...record.propValues, ...values };
+    if (record.renderHandle) this.renderer.setIndicatorInputs(record.renderHandle, record.inputValues, record.propValues);
+    record.pendingStructural = true;
+    if (!record.hidden) this.setLoading(record, true);
+    record.pendingCause = "inputs";
+    record.session.update(record.inputValues, record.propValues);
+  }
   /** IndicatorController: tear down an indicator and (if now empty) its pane. */
   /** Live handles of every indicator on the chart (script + native), insertion order. */
   listIndicators() {
@@ -19958,6 +20311,10 @@ var EngineOrchestrator = class _EngineOrchestrator {
       for (const input of prepared.inputs) defaults[input.key] = input.defval;
       record.inputValues = { ...defaults, ...record.inputValues };
       handle.setSchema(prepared.inputs);
+      const propDefaults = {};
+      for (const prop of prepared.props ?? []) propDefaults[prop.key] = prop.defval;
+      record.propValues = { ...propDefaults, ...record.propValues };
+      handle.setPropsSchema(prepared.props ?? []);
       this.mountLoadingPlaceholder(id, record);
       this.executeIndicator(id, handle);
     } catch (err) {
@@ -19981,6 +20338,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
         getBars: () => this.bars,
         fetchSeries: (sym, tf, range) => this.fetchSeries(sym, tf, range),
         inputs: record.inputValues,
+        props: record.propValues,
         visibleRange: this.currentVisibleRange(),
         mode,
         // Mid-backfill session starts (add / re-show / price-style re-execute) let the
@@ -20074,6 +20432,9 @@ var EngineOrchestrator = class _EngineOrchestrator {
     const meta = record.prepared.meta;
     const model = {
       id,
+      // Deliberately the FULL title, never a shorttitle: while the script loads the
+      // legend identifies it by its full name; the compact shorttitle arrives with
+      // the first computed model and takes over from there.
       title: record.options?.title ?? meta.title,
       overlay: meta.overlay,
       paneHint: meta.overlay ? "price" : "new",
@@ -20082,7 +20443,8 @@ var EngineOrchestrator = class _EngineOrchestrator {
       backgrounds: [],
       priceLines: [],
       inputs: record.prepared.inputs,
-      inputValues: record.inputValues
+      inputValues: record.inputValues,
+      ...record.prepared.props ? { props: record.prepared.props, propValues: record.propValues } : {}
     };
     const paneId = this.routePane(id, model, record.options ?? {});
     this.placeModel(model, id, paneId);
@@ -20315,7 +20677,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
     record.model = model;
     if (record.pendingStructural) {
       record.renderHandle = this.renderer.mountIndicator(model);
-      this.renderer.setIndicatorInputs(record.renderHandle, record.inputValues);
+      this.renderer.setIndicatorInputs(record.renderHandle, record.inputValues, record.propValues);
       record.pendingStructural = false;
     } else {
       this.renderer.updateIndicator(record.renderHandle, modelToValuePatch(model));
@@ -20342,16 +20704,17 @@ var EngineOrchestrator = class _EngineOrchestrator {
   placeModel(model, id, paneId) {
     model.id = id;
     model.paneId = paneId;
-    for (const series of model.series) series.paneId = paneId;
-    for (const fill of model.fills) fill.paneId = paneId;
-    for (const bg of model.backgrounds) bg.paneId = paneId;
+    const paneOf = (item) => item.overlay === true ? "price" : paneId;
+    for (const series of model.series) series.paneId = paneOf(series);
+    for (const fill of model.fills) fill.paneId = paneOf(fill);
+    for (const bg of model.backgrounds) bg.paneId = paneOf(bg);
     for (const line of model.priceLines) line.paneId = paneId;
-    if (model.lines) for (const ln of model.lines) ln.paneId = paneId;
-    if (model.boxes) for (const bx of model.boxes) bx.paneId = paneId;
-    if (model.labels) for (const lb of model.labels) lb.paneId = paneId;
-    if (model.polylines) for (const pl of model.polylines) pl.paneId = paneId;
-    if (model.linefills) for (const lf of model.linefills) lf.paneId = paneId;
-    if (model.tables) for (const tb of model.tables) tb.paneId = paneId;
+    if (model.lines) for (const ln of model.lines) ln.paneId = paneOf(ln);
+    if (model.boxes) for (const bx of model.boxes) bx.paneId = paneOf(bx);
+    if (model.labels) for (const lb of model.labels) lb.paneId = paneOf(lb);
+    if (model.polylines) for (const pl of model.polylines) pl.paneId = paneOf(pl);
+    if (model.linefills) for (const lf of model.linefills) lf.paneId = paneOf(lf);
+    if (model.tables) for (const tb of model.tables) tb.paneId = paneOf(tb);
   }
   emitContextChanged(id) {
     if (!this.registry.get(id)?.session?.getContext) return;
@@ -21011,4 +21374,4 @@ function resolveElement(container) {
   return element;
 }
 
-export { BUILTIN_PRICE_STYLES, BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TIMEZONES, TypedEventBus, Vela, applyAttributionMarkTheme, buildToolbar, createAttributionMark, createCustomMark, defaultToolbar, normalizeTimezone, parseSymbol, priceStyleIds, registerBuiltinChartTypes, resolveTheme, sharedBarStore, timeframeToMs, tzButtonLabel, tzMenuLabel, tzOffset };
+export { BUILTIN_PRICE_STYLES, BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LEGEND_AT_TOP_ATTR, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TIMEZONES, TypedEventBus, Vela, applyAttributionMarkTheme, buildToolbar, createAttributionMark, createCustomMark, defaultToolbar, normalizeTimezone, parseSymbol, priceStyleIds, registerBuiltinChartTypes, resolveTheme, sharedBarStore, timeframeToMs, tzButtonLabel, tzMenuLabel, tzOffset };