@luxalgo/vela 0.6.8 → 0.6.9

package/dist/vela.global.js

@@ -114,6 +114,7 @@ var Vela = (function (exports) {
     constructor(id, title, controller, source) {
       this.controller = controller;
       this.schema = [];
+      this.propsSchema = [];
       this.visibleState = true;
       this.bus = new TypedEventBus();
       this.id = id;
@@ -123,6 +124,9 @@ var Vela = (function (exports) {
     get inputs() {
       return this.schema;
     }
+    get props() {
+      return this.propsSchema;
+    }
     get visible() {
       return this.visibleState;
     }
@@ -132,6 +136,12 @@ var Vela = (function (exports) {
     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);
     }
@@ -151,6 +161,9 @@ var Vela = (function (exports) {
     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;
@@ -164,6 +177,8 @@ var Vela = (function (exports) {
   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,
@@ -183,7 +198,8 @@ var Vela = (function (exports) {
       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) {
@@ -204,7 +220,8 @@ var Vela = (function (exports) {
         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)
       }
     };
   }
@@ -474,11 +491,11 @@ var Vela = (function (exports) {
   );
   registerIcon(
     "market-pre",
-    svg24('<path d="M12 2v8"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m16 6-4 4-4-4"/><path d="M16 18a4 4 0 0 0-8 0"/>')
+    svg24('<path d="M12 2v8"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m8 6 4-4 4 4"/><path d="M16 18a4 4 0 0 0-8 0"/>')
   );
   registerIcon(
     "market-post",
-    svg24('<path d="M12 10V2"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m16 18-4-4-4 4"/><path d="M16 6a4 4 0 0 0-8 0"/>')
+    svg24('<path d="M12 10V2"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m16 14-4 4-4-4"/><path d="M16 6a4 4 0 0 0-8 0"/>')
   );
   registerIcon("market-closed", svg24('<path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"/>'));
   registerIcon(
@@ -7318,7 +7335,9 @@ var Vela = (function (exports) {
       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;
@@ -7998,7 +8017,7 @@ var Vela = (function (exports) {
       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;
     }
@@ -8021,7 +8040,7 @@ var Vela = (function (exports) {
         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;
@@ -8074,6 +8093,19 @@ var Vela = (function (exports) {
       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() {
@@ -8222,6 +8254,10 @@ var Vela = (function (exports) {
         for (const input of prepared.inputs) defaults2[input.key] = input.defval;
         record.inputValues = { ...defaults2, ...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) {
@@ -8245,6 +8281,7 @@ var Vela = (function (exports) {
           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
@@ -8338,6 +8375,9 @@ var Vela = (function (exports) {
       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",
@@ -8346,7 +8386,8 @@ var Vela = (function (exports) {
         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);
@@ -8579,7 +8620,7 @@ var Vela = (function (exports) {
       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));
@@ -8606,16 +8647,17 @@ var Vela = (function (exports) {
     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;
@@ -8768,6 +8810,15 @@ var Vela = (function (exports) {
     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
@@ -16606,13 +16657,6 @@ var Vela = (function (exports) {
     }
   };
 
-  // src/core/model/inputs.ts
-  function inputVisible(when, values) {
-    if (!when) return true;
-    const conds = Array.isArray(when) ? when : [when];
-    return conds.every((c) => c.anyOf ? c.anyOf.some((x) => x === values[c.key]) : values[c.key] === c.equals);
-  }
-
   // src/ui/tokens.ts
   var STATIC_ID = "vela-ui-tokens";
   var STATIC_DECLS = Object.entries(STATIC_TOKENS).map(([k, v]) => `    ${k}: ${v};`).join("\n");
@@ -16858,6 +16902,199 @@ ${STATIC_DECLS}
     }
   };
 
+  // src/ui/components/callout-bubble/controller.ts
+  function closesPanel(item) {
+    return item.close !== false;
+  }
+  function calloutPanelRows(items) {
+    const rows = [];
+    for (const item of items) {
+      if (item.type === "text") {
+        rows.push({ type: "text", text: item.text });
+        continue;
+      }
+      const last2 = rows[rows.length - 1];
+      if (last2 && last2.type === "buttons") last2.buttons.push(item);
+      else rows.push({ type: "buttons", buttons: [item] });
+    }
+    return rows;
+  }
+
+  // src/ui/components/callout-bubble/styles.ts
+  var CALLOUT_STYLE_ID = "vela-ui-callout-bubble";
+  var CALLOUT_CSS = `
+.vela-callout {
+    display: inline-grid;
+    place-items: center;
+    border-radius: 50%;
+    flex: none;
+    line-height: 0;
+    box-sizing: border-box;
+    cursor: default;
+    user-select: none;
+    -webkit-user-select: none;
+}
+.vela-callout[role='button'] { cursor: pointer; }
+.vela-callout svg { display: block; }
+/* The deployed panel \u2014 carries the kit's elevated-card look itself (the popover
+   shell is bare positioning chrome). */
+.vela-callout-panel {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    padding: 10px 12px;
+    max-width: 280px;
+    box-sizing: border-box;
+    background: var(--vela-surface-elev);
+    border: 1px solid var(--vela-border-strong);
+    border-radius: 6px;
+    box-shadow: var(--vela-shadow);
+    color: var(--vela-fg);
+    font: var(--vela-font-size-md) var(--vela-font);
+}
+.vela-callout-title { font-weight: 600; color: var(--vela-fg-bright); }
+.vela-callout-text { color: var(--vela-fg-muted); line-height: 1.45; white-space: pre-line; }
+.vela-callout-actions { display: flex; flex-wrap: wrap; gap: 8px; }
+.vela-callout-btn {
+    cursor: pointer;
+    height: 26px;
+    padding: 0 10px;
+    border-radius: 5px;
+    border: 1px solid var(--vela-border);
+    background: transparent;
+    color: var(--vela-fg);
+    font-size: var(--vela-font-size-md);
+    font-family: inherit;
+    transition: background var(--vela-dur-fast) ease, color var(--vela-dur-fast) ease, opacity var(--vela-dur-fast) ease, border-color var(--vela-dur-fast) ease;
+}
+.vela-callout-btn:hover { background: var(--vela-hover); color: var(--vela-fg-bright); border-color: var(--vela-fg-muted); }
+.vela-callout-btn-primary { border-color: var(--vela-selected-bg); background: var(--vela-selected-bg); color: var(--vela-selected-fg); }
+.vela-callout-btn-primary:hover { background: var(--vela-selected-bg); color: var(--vela-selected-fg); opacity: 0.85; border-color: var(--vela-selected-bg); }
+`;
+
+  // src/ui/components/callout-bubble/view.ts
+  var CalloutBubble = class {
+    constructor(opts) {
+      this.pop = null;
+      this.spec = { icon: opts.icon, background: opts.background, label: opts.label };
+      if (opts.color !== void 0) this.spec.color = opts.color;
+      if (opts.panel !== void 0) this.spec.panel = opts.panel;
+      this.size = opts.size ?? 16;
+      this.host = opts.host;
+      this.theme = opts.theme;
+      this.boundary = opts.boundary;
+      const doc = (opts.host ?? document.body).ownerDocument;
+      injectStyles(CALLOUT_STYLE_ID, CALLOUT_CSS, doc);
+      this.el = doc.createElement("span");
+      this.el.className = "vela-callout";
+      this.el.style.width = `${this.size}px`;
+      this.el.style.height = `${this.size}px`;
+      this.el.addEventListener("click", (e) => {
+        if (!this.spec.panel) return;
+        e.stopPropagation();
+        this.toggle();
+      });
+      this.el.addEventListener("dblclick", (e) => {
+        if (this.spec.panel) e.stopPropagation();
+      });
+      this.el.addEventListener("keydown", (e) => {
+        if (!this.spec.panel || e.key !== "Enter" && e.key !== " ") return;
+        e.preventDefault();
+        this.toggle();
+      });
+      this.dress();
+    }
+    /** Re-dress the bubble (a status change: new icon, tint, label, panel). */
+    set(spec) {
+      this.spec = { ...this.spec, ...spec };
+      if ("panel" in spec) this.pop?.hide();
+      this.dress();
+    }
+    /** Whether the deployed panel is currently open. */
+    get open() {
+      return this.pop?.open ?? false;
+    }
+    destroy() {
+      this.pop?.destroy();
+      this.pop = null;
+      this.el.remove();
+    }
+    dress() {
+      const clickable = this.spec.panel !== void 0;
+      this.el.style.background = this.spec.background;
+      this.el.style.color = this.spec.color ?? "";
+      this.el.innerHTML = iconAt(this.spec.icon, this.size - 4);
+      this.el.setAttribute("aria-label", this.spec.label);
+      if (clickable) {
+        this.el.setAttribute("role", "button");
+        this.el.tabIndex = 0;
+      } else {
+        this.el.removeAttribute("role");
+        this.el.removeAttribute("tabindex");
+      }
+    }
+    toggle() {
+      if (this.pop?.open) {
+        this.pop.hide();
+        return;
+      }
+      const panel = this.spec.panel;
+      if (!panel) return;
+      this.pop?.destroy();
+      this.pop = new Popover({
+        trigger: this.el,
+        gap: 6,
+        content: (body) => this.buildPanel(body, panel),
+        ...this.host ? { host: this.host } : {},
+        ...this.theme ? { theme: this.theme() } : {},
+        ...this.boundary ? { boundary: this.boundary } : {}
+      });
+      this.pop.show();
+    }
+    buildPanel(body, panel) {
+      const doc = body.ownerDocument;
+      const root = doc.createElement("div");
+      root.className = "vela-callout-panel";
+      if (panel.title) {
+        const title = doc.createElement("div");
+        title.className = "vela-callout-title";
+        title.textContent = panel.title;
+        root.appendChild(title);
+      }
+      for (const row of calloutPanelRows(panel.items)) {
+        if (row.type === "text") {
+          const text = doc.createElement("div");
+          text.className = "vela-callout-text";
+          text.textContent = row.text;
+          root.appendChild(text);
+          continue;
+        }
+        const actions = doc.createElement("div");
+        actions.className = "vela-callout-actions";
+        for (const item of row.buttons) {
+          const btn2 = doc.createElement("button");
+          btn2.type = "button";
+          btn2.className = "vela-callout-btn" + (item.primary ? " vela-callout-btn-primary" : "");
+          btn2.textContent = item.label;
+          btn2.addEventListener("click", () => {
+            item.run();
+            if (closesPanel(item)) this.pop?.hide();
+          });
+          actions.appendChild(btn2);
+        }
+        root.appendChild(actions);
+      }
+      body.appendChild(root);
+    }
+  };
+
+  // src/core/model/inputs.ts
+  function inputVisible(when, values) {
+    if (!when) return true;
+    const conds = Array.isArray(when) ? when : [when];
+    return conds.every((c) => c.anyOf ? c.anyOf.some((x) => x === values[c.key]) : values[c.key] === c.equals);
+  }
+
   // src/ui/components/select/controller.ts
   function selectController(opts) {
     const options = opts.options;
@@ -19961,6 +20198,10 @@ ${overlayScrollbarCss(".vela-dialog *")}
   }
 
   // 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) {
@@ -19971,6 +20212,7 @@ ${overlayScrollbarCss(".vela-dialog *")}
       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;
@@ -19993,10 +20235,11 @@ ${overlayScrollbarCss(".vela-dialog *")}
     }
     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)";
@@ -20004,7 +20247,7 @@ ${overlayScrollbarCss(".vela-dialog *")}
       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,
@@ -20036,6 +20279,16 @@ ${overlayScrollbarCss(".vela-dialog *")}
         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 = [];
@@ -20138,9 +20391,10 @@ ${overlayScrollbarCss(".vela-dialog *")}
       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;
@@ -20154,6 +20408,17 @@ ${overlayScrollbarCss(".vela-dialog *")}
           }
         }
       }
+      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
@@ -20171,19 +20436,27 @@ ${overlayScrollbarCss(".vela-dialog *")}
       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. */
@@ -20210,7 +20483,7 @@ ${overlayScrollbarCss(".vela-dialog *")}
       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,
@@ -20219,7 +20492,7 @@ ${overlayScrollbarCss(".vela-dialog *")}
           toggle: {
             id,
             checked: current,
-            onChange: (v) => this.commit(row, lead.key, v)
+            onChange: (v) => this.commit(row, lead, v)
           }
         }));
       }
@@ -20244,8 +20517,8 @@ ${overlayScrollbarCss(".vela-dialog *")}
     }
     /** 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;
       }
@@ -20256,7 +20529,7 @@ ${overlayScrollbarCss(".vela-dialog *")}
           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;
       }
@@ -20819,6 +21092,7 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
   }
 
   // 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;
@@ -20857,10 +21131,14 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
       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 = [];
@@ -21018,6 +21296,42 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
         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);
@@ -21185,6 +21499,7 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
     }
     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;
@@ -21260,13 +21575,13 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
     }
     /** 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;
@@ -21318,6 +21633,9 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
         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;`;
@@ -21334,13 +21652,13 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
         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");
@@ -21380,7 +21698,9 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
       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. */
@@ -21389,9 +21709,11 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
       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
@@ -21473,8 +21795,13 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
     syncRowActions(row) {
       const open2 = row.highlighted;
       row.controlsEl.style.display = open2 || row.hidden ? "inline-flex" : "none";
-      if (open2) row.el.appendChild(row.statusEl);
-      else row.el.insertBefore(row.statusEl, row.valuesEl);
+      if (open2) {
+        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) {
@@ -21492,10 +21819,12 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
     }
     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();
@@ -21515,6 +21844,8 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
       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();
@@ -21869,6 +22200,32 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
     large: 16,
     huge: 20
   };
+  function fontPxOf(size3) {
+    if (typeof size3 === "number") return size3 > 0 ? size3 : SIZE_PX3.auto;
+    return SIZE_PX3[size3] ?? SIZE_PX3.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;
@@ -21889,7 +22246,9 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
     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() {
@@ -21904,39 +22263,36 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
       this.root.remove();
     }
     renderTable(t) {
+      const b = this.paneBounds(t.paneId);
       const wrap2 = document.createElement("div");
       wrap2.style.position = "absolute";
-      this.anchor(wrap2, t.position, this.paneBounds(t.paneId));
+      if (t.frameColor && t.frameWidth > 0) wrap2.style.border = `${t.frameWidth}px solid ${t.frameColor}`;
+      this.anchor(wrap2, 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;
@@ -21945,18 +22301,22 @@ ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
           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_PX3[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);
@@ -22841,8 +23201,14 @@ void main() {
             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) {
@@ -22856,7 +23222,7 @@ void main() {
             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);
@@ -22865,6 +23231,12 @@ void main() {
           }
           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);
@@ -22911,7 +23283,7 @@ void main() {
       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);
@@ -22980,15 +23352,23 @@ void main() {
       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);
         }
       }
     }
@@ -23271,9 +23651,9 @@ void main() {
             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);
@@ -24825,8 +25205,14 @@ void main() {
           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) => {
@@ -24848,7 +25234,7 @@ void main() {
           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);
@@ -24856,6 +25242,13 @@ void main() {
           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);
@@ -25127,9 +25520,9 @@ void main() {
             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);
@@ -25561,6 +25954,8 @@ void main() {
       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.
@@ -25581,8 +25976,13 @@ void main() {
       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);
@@ -25930,13 +26330,35 @@ void main() {
         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":
@@ -25955,8 +26377,7 @@ void main() {
       }
     }
     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");
@@ -26036,9 +26457,9 @@ void main() {
           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;
@@ -26096,38 +26517,51 @@ void main() {
           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);
@@ -26365,6 +26799,8 @@ void main() {
       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;
@@ -26406,6 +26842,7 @@ void main() {
       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)) {
@@ -26515,6 +26952,17 @@ void main() {
         (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) {
@@ -26731,6 +27179,68 @@ void main() {
     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() {
@@ -32522,19 +33032,8 @@ ${overlayScrollbarCss(".vela-sd-pane")}
     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);
     }
@@ -32556,6 +33055,36 @@ ${overlayScrollbarCss(".vela-sd-pane")}
     const span = max2 - min2;
     return { min: min2 - span * MARGIN_BOTTOM, max: max2 + 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 min2 = Infinity;
+    let max2 = -Infinity;
+    const consider = (v) => {
+      if (v != null && Number.isFinite(v)) {
+        if (v < min2) min2 = v;
+        if (v > max2) max2 = 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 min2 === Infinity ? null : { min: min2, max: max2 };
+  }
   function expandScaleByPixels(scale, heightPx, abovePx, belowPx) {
     if (abovePx <= 0 && belowPx <= 0) return scale;
     const content = heightPx - abovePx - belowPx;
@@ -33338,6 +33867,8 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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;
@@ -33348,6 +33879,8 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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) ──
@@ -34456,6 +34989,10 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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,
@@ -34495,9 +35032,10 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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);
@@ -34687,6 +35225,8 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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?.();
@@ -34927,7 +35467,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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") {
@@ -34978,8 +35518,8 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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;
@@ -34989,6 +35529,10 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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);
@@ -35969,7 +36513,11 @@ ${overlayScrollbarCss(".vela-sd-pane")}
         }
         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 or2 = overlaySeriesRange(this.scene.indicators.values(), i0, i1, (id) => this.scene.offsetOf(id));
+          if (or2) dr = dr ? { min: Math.min(dr.min, or2.min), max: Math.max(dr.max, or2.max) } : or2;
+        }
         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);
@@ -36243,6 +36791,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       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;
@@ -37148,6 +37697,19 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   function legendActions() {
     return [...legendRegistry.values()].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
   }
+  var calloutRegistry = /* @__PURE__ */ new Map();
+  function registerLegendCallout(desc) {
+    calloutRegistry.set(desc.id, desc);
+    return () => {
+      if (calloutRegistry.get(desc.id) === desc) calloutRegistry.delete(desc.id);
+    };
+  }
+  function unregisterLegendCallout(id) {
+    calloutRegistry.delete(id);
+  }
+  function legendCallouts() {
+    return [...calloutRegistry.values()].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+  }
   var stateHandlers = /* @__PURE__ */ new Map();
   function registerStatePersistence(handler) {
     stateHandlers.set(handler.key, handler);
@@ -38491,6 +39053,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   exports.iconMarkup = iconMarkup;
   exports.inputVisible = inputVisible;
   exports.legendActions = legendActions;
+  exports.legendCallouts = legendCallouts;
   exports.nativeIndicatorDescriptors = nativeIndicatorDescriptors;
   exports.nativeIndicatorTypes = nativeIndicatorTypes;
   exports.normalizeSettingsRow = normalizeSettingsRow;
@@ -38499,6 +39062,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   exports.registerDrawingType = registerDrawingType;
   exports.registerIcon = registerIcon;
   exports.registerLegendAction = registerLegendAction;
+  exports.registerLegendCallout = registerLegendCallout;
   exports.registerNativeIndicator = registerNativeIndicator;
   exports.registerRendererDefaults = registerRendererDefaults;
   exports.registerRendererLayer = registerRendererLayer;
@@ -38524,6 +39088,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   exports.unregisterChartType = unregisterChartType;
   exports.unregisterDefaultEngine = unregisterDefaultEngine;
   exports.unregisterLegendAction = unregisterLegendAction;
+  exports.unregisterLegendCallout = unregisterLegendCallout;
   exports.unregisterNativeIndicator = unregisterNativeIndicator;
   exports.unregisterRendererDefaults = unregisterRendererDefaults;
   exports.unregisterRendererLayer = unregisterRendererLayer;