@luxalgo/vela 0.7.4 → 0.7.6

package/dist/{contributions-CspPrMAJ.d.ts → contributions-C7Wsm_S9.d.ts}

@@ -1,5 +1,5 @@
-import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-XVpfr9HV.js';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-CVpN5sCq.js';
+import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-D1AJKsn_.js';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-CmWUtDVL.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -1391,7 +1391,11 @@ declare class MarksController {
      * a persisted chart restores — so it warns + no-ops on a renderer without it.
      */
     setGroupVisible(id: string, visible: boolean): void;
-    /** A group's effective visibility: the user's (persisted) choice, else the group's declared default, else visible. */
+    /**
+     * A group's effective visibility: its own switch — the user's (persisted) choice, else
+     * the declared default, else visible — AND every ancestor's, so a child under a
+     * switched-off parent reads hidden whatever its own choice says.
+     */
     isGroupVisible(id: string): boolean;
     destroy(): void;
     private sync;
@@ -1680,6 +1684,12 @@ interface ExternalIndicatorEntry {
     name: string;
     /** The script source (the recorded undo/redo action re-adds from it). */
     script: string;
+    /** The indicator's id on the chart (see `AddIndicatorOptions.id`) — what a persistence
+     *  handler stores and hands back on restore so the indicator comes back under the id
+     *  its document knows. Omitted: the chart mints one. Either way undo/redo re-add the
+     *  indicator under the id it first ran with. An id already live on the cell's chart
+     *  is rejected (a warning; nothing is added). */
+    id?: string;
     /** Engine language (default: the chart's default engine). */
     language?: string;
     /** Input-value overrides applied at add time (what a persistence handler restores). */

package/dist/{contributions-DpZeu7KP.d.cts → contributions-D6p1RB38.d.cts}

@@ -1,5 +1,5 @@
-import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-XVpfr9HV.cjs';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-RF1axuy1.cjs';
+import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-D1AJKsn_.cjs';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-CGa4KHRa.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -1391,7 +1391,11 @@ declare class MarksController {
      * a persisted chart restores — so it warns + no-ops on a renderer without it.
      */
     setGroupVisible(id: string, visible: boolean): void;
-    /** A group's effective visibility: the user's (persisted) choice, else the group's declared default, else visible. */
+    /**
+     * A group's effective visibility: its own switch — the user's (persisted) choice, else
+     * the declared default, else visible — AND every ancestor's, so a child under a
+     * switched-off parent reads hidden whatever its own choice says.
+     */
     isGroupVisible(id: string): boolean;
     destroy(): void;
     private sync;
@@ -1680,6 +1684,12 @@ interface ExternalIndicatorEntry {
     name: string;
     /** The script source (the recorded undo/redo action re-adds from it). */
     script: string;
+    /** The indicator's id on the chart (see `AddIndicatorOptions.id`) — what a persistence
+     *  handler stores and hands back on restore so the indicator comes back under the id
+     *  its document knows. Omitted: the chart mints one. Either way undo/redo re-add the
+     *  indicator under the id it first ran with. An id already live on the cell's chart
+     *  is rejected (a warning; nothing is added). */
+    id?: string;
     /** Engine language (default: the chart's default engine). */
     language?: string;
     /** Input-value overrides applied at add time (what a persistence handler restores). */

package/dist/index.cjs

@@ -129,10 +129,18 @@ var IndicatorRegistry = class {
     this.records = /* @__PURE__ */ new Map();
     this.counter = 0;
   }
-  /** Allocate a unique, stable per-instance id. */
-  nextId(prefix = "ind") {
-    this.counter += 1;
-    return `${prefix}-${this.counter}`;
+  /**
+   * Mint a unique per-instance id. Host-supplied ids share the namespace, so a minted
+   * id skips anything already recorded — and anything `taken` reports live elsewhere
+   * (a handle the orchestrator holds outside the records, e.g. a fail-soft native).
+   */
+  nextId(prefix = "ind", taken = () => false) {
+    let id;
+    do {
+      this.counter += 1;
+      id = `${prefix}-${this.counter}`;
+    } while (this.records.has(id) || taken(id));
+    return id;
   }
   add(record) {
     this.records.set(record.id, record);
@@ -7140,6 +7148,42 @@ var DrawingController = class {
   }
 };
 
+// src/core/marks/visibility.ts
+function markGroupOwnVisible(choices, groupId, groups) {
+  const chosen = choices[groupId];
+  if (typeof chosen === "boolean") return chosen;
+  return groups.find((g) => g.id === groupId)?.visible !== false;
+}
+function markGroupVisible(choices, groupId, groups) {
+  if (groupId === void 0) return true;
+  const seen = /* @__PURE__ */ new Set();
+  let id = groupId;
+  while (id !== void 0 && !seen.has(id)) {
+    seen.add(id);
+    if (!markGroupOwnVisible(choices, id, groups)) return false;
+    const parent = groups.find((g) => g.id === id)?.parent;
+    id = parent !== void 0 && groups.some((g) => g.id === parent) ? parent : void 0;
+  }
+  return true;
+}
+function markGroupRows(groups) {
+  const ids = new Set(groups.map((g) => g.id));
+  const out = [];
+  const placed = /* @__PURE__ */ new Set();
+  const place = (group, depth) => {
+    if (placed.has(group.id)) return;
+    placed.add(group.id);
+    out.push({ group, depth });
+    for (const child of groups) if (child.parent === group.id && child.id !== group.id) place(child, depth + 1);
+  };
+  for (const g of groups) {
+    const parentKnown = g.parent !== void 0 && ids.has(g.parent) && g.parent !== g.id;
+    if (!parentKnown) place(g, 0);
+  }
+  for (const g of groups) place(g, 0);
+  return out;
+}
+
 // src/core/marks/MarksController.ts
 var MarksController = class {
   constructor(renderer, events) {
@@ -7184,6 +7228,7 @@ var MarksController = class {
   defineGroup(group) {
     if (!group || typeof group.id !== "string" || group.id.length === 0) throw new Error("[vela] marks.defineGroup: `id` must be a non-empty string");
     if (typeof group.label !== "string") throw new Error(`[vela] marks.defineGroup: group "${group.id}" needs a string \`label\``);
+    if (group.parent !== void 0 && (typeof group.parent !== "string" || group.parent.length === 0)) throw new Error(`[vela] marks.defineGroup: group "${group.id}" has a \`parent\` that is not a group id`);
     this.groups.set(group.id, { ...group });
     this.sync();
   }
@@ -7203,12 +7248,16 @@ var MarksController = class {
     }
     this.renderer.applyFeature("marks", { groups: { [id]: visible } });
   }
-  /** A group's effective visibility: the user's (persisted) choice, else the group's declared default, else visible. */
+  /**
+   * A group's effective visibility: its own switch — the user's (persisted) choice, else
+   * the declared default, else visible — AND every ancestor's, so a child under a
+   * switched-off parent reads hidden whatever its own choice says.
+   */
   isGroupVisible(id) {
     const state = this.renderer.readFeature("marks");
-    const chosen = state?.groups?.[id];
-    if (typeof chosen === "boolean") return chosen;
-    return this.groups.get(id)?.visible !== false;
+    const groups = {};
+    for (const [gid, v] of Object.entries(state?.groups ?? {})) if (typeof v === "boolean") groups[gid] = v;
+    return markGroupVisible(groups, id, [...this.groups.values()]);
   }
   destroy() {
     for (const unsub of this.subs) unsub();
@@ -8636,7 +8685,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
     this.engines.set(language, engine);
   }
   addIndicator(source, options = {}) {
-    const id = this.registry.nextId();
+    const id = this.claimIndicatorId(options.id);
     const title = options.title ?? "Indicator";
     const handle = new IndicatorHandleImpl(id, title, this, source);
     this.handles.set(id, handle);
@@ -8658,7 +8707,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
       const existing = this.registry.all().find((r) => r.native?.type === type);
       if (existing) return this.handles.get(existing.id) ?? new IndicatorHandleImpl(existing.id, existing.title, this, void 0, type);
     }
-    const id = this.registry.nextId("native");
+    const id = this.registry.nextId("native", (candidate) => this.handles.has(candidate));
     const title = descriptor?.title ?? type;
     const handle = new IndicatorHandleImpl(id, title, this, void 0, type);
     this.handles.set(id, handle);
@@ -8936,6 +8985,24 @@ var EngineOrchestrator = class _EngineOrchestrator {
     this.events.clear();
   }
   // ── internals ───────────────────────────────────────────────
+  /**
+   * The id a new script indicator runs under: the host's when supplied, else a minted
+   * one. A host id is opaque but must be a non-empty string, and it must not be live
+   * on this chart — a duplicate is a programming error surfaced synchronously, never
+   * renamed behind the caller's back (the whole point of supplying one is that
+   * `handle.id` equals what was passed). "Live" reads both the records and the handle
+   * map: a fail-soft handle never enters the registry but still owns its id.
+   */
+  claimIndicatorId(requested) {
+    if (requested === void 0) return this.registry.nextId("ind", (candidate) => this.handles.has(candidate));
+    if (typeof requested !== "string" || requested.length === 0) {
+      throw new TypeError("[vela] addIndicator: `id` must be a non-empty string");
+    }
+    if (this.handles.has(requested) || this.registry.get(requested)) {
+      throw new Error(`[vela] addIndicator: indicator id "${requested}" is already live on this chart`);
+    }
+    return requested;
+  }
   async startIndicator(id, source, options, handle) {
     try {
       await this.readyPromise;
@@ -15958,6 +16025,17 @@ function hasOwnCandlePaint(style) {
   for (const t of chartTypes()) if (t.id === style) return (t.basePainting ?? "candles") === "candles";
   return false;
 }
+var CANDLE_OVERRIDE_KEYS = [
+  "candleUpColor",
+  "candleDownColor",
+  "candleBodyVisible",
+  "candleBorderVisible",
+  "candleBorderUpColor",
+  "candleBorderDownColor",
+  "candleWickVisible",
+  "candleWickUpColor",
+  "candleWickDownColor"
+];
 function candleOverrideFor(style, bags) {
   if (!hasOwnCandlePaint(style)) return null;
   const bag = bags[style] ?? {};
@@ -16029,7 +16107,7 @@ function clampLevel(v) {
 function clampSpacing(v) {
   return v < 0.1 ? 0.1 : v > 10 ? 10 : v;
 }
-function factoryResetConfig(factory) {
+function factoryResetConfig(factory, priceStyle = factory.series.style) {
   const bag = {};
   for (const t of chartTypes()) {
     const section = t.settings;
@@ -16051,10 +16129,16 @@ function factoryResetConfig(factory) {
     if (!section.instances) addRows(section.rows);
     bag[t.id] = defaults2;
   }
+  for (const t of chartTypes()) {
+    if (!hasOwnCandlePaint(t.id)) continue;
+    const defaults2 = bag[t.id] ?? {};
+    for (const key of CANDLE_OVERRIDE_KEYS) defaults2[key] = null;
+    bag[t.id] = defaults2;
+  }
   for (const [typeId, vals] of Object.entries(factory.chartTypes)) {
     bag[typeId] = { ...bag[typeId] ?? {}, ...vals };
   }
-  return { ...factory, chartTypes: bag };
+  return { ...factory, chartTypes: bag, series: { ...factory.series, style: priceStyle } };
 }
 function mergeConfig(base, patch) {
   const p = asObject(patch);
@@ -18433,11 +18517,8 @@ function mergeMarksState(base, patch) {
   for (const [id, v] of Object.entries(g)) if (typeof v === "boolean") groups[id] = v;
   return { visible: typeof p.visible === "boolean" ? p.visible : base.visible, groups };
 }
-function markGroupVisible(state, groupId, groups) {
-  if (groupId === void 0) return true;
-  const chosen = state.groups[groupId];
-  if (typeof chosen === "boolean") return chosen;
-  return groups.find((g) => g.id === groupId)?.visible !== false;
+function markGroupVisible2(state, groupId, groups) {
+  return markGroupVisible(state.groups, groupId, groups);
 }
 
 // src/renderers/native/core/SceneGraph.ts
@@ -20613,13 +20694,29 @@ function paintMarkLane(ctx, layout, deps) {
       const img = deps.icons.get(mark.glyph.icon, ink, symbolPx, deps.dpr);
       if (img) ctx.drawImage(img, center.x - symbolPx / 2, center.y - symbolPx / 2, symbolPx, symbolPx);
     } else if (mark.glyph.letter) {
+      const letter = mark.glyph.letter.slice(0, 2);
       ctx.fillStyle = ink;
-      ctx.font = `600 ${Math.round(size * 0.58)}px ${deps.fontFamily}`;
-      ctx.fillText(mark.glyph.letter.slice(0, 2), center.x, center.y + 0.5);
+      let px = letterFontPx(size, letter);
+      ctx.font = `600 ${px}px ${deps.fontFamily}`;
+      if (letter.length > 1) {
+        px = fitLetterPx(px, ctx.measureText(letter).width, symbolInnerWidth(shape, size));
+        ctx.font = `600 ${px}px ${deps.fontFamily}`;
+      }
+      ctx.fillText(letter, center.x, center.y + 0.5);
     }
   }
   ctx.restore();
 }
+function letterFontPx(size, letter) {
+  return Math.round(size * (letter.length > 1 ? 0.38 : 0.58));
+}
+function symbolInnerWidth(shape, size) {
+  return (shape === "pin" ? size * 0.82 : size) - 3;
+}
+function fitLetterPx(px, width, inner) {
+  if (!(width > inner) || !(width > 0)) return px;
+  return Math.max(4, Math.floor(px * inner / width));
+}
 function traceShape(ctx, shape, x, y, size) {
   const r = size / 2;
   ctx.beginPath();
@@ -20821,7 +20918,7 @@ var ChromeRenderer = class {
     this.markLayout = layoutMarkLane({
       marks: scene.timelineMarks,
       groups: scene.markGroups,
-      hidden: (groupId) => !markGroupVisible(scene.marks, groupId, scene.markGroups),
+      hidden: (groupId) => !markGroupVisible2(scene.marks, groupId, scene.markGroups),
       barTimes: this.barTimes(scene),
       intervalMs: coords.barInterval,
       xOf: (bar) => coords.logicalToX(bar),
@@ -21588,6 +21685,10 @@ ${overlayScrollbarCss(".vela-sd-pane")}
    muted and non-interactive. Applied to each row's children so it survives display:contents;
    !important beats the inline opacity on labels. */
 .vela-sd-soft>*{opacity:0.4 !important;pointer-events:none !important;}
+/* A mark group nested under a parent group on the Events tab: indented one step per level
+   (--vela-sd-depth). The indent rides the first child (the switch) as a MARGIN \u2014 padding
+   would push the switch's own tick out of its box. */
+.vela-sd-nested>*:first-child{margin-left:calc(var(--vela-sd-depth,1)*24px);}
 /* \u2500\u2500 mobile presentation (.vela-sd-mobile on the scrim; structural sizes are inline in open()) \u2500\u2500
    The tab rail becomes a burger-opened overlay sidebar; the group TOC becomes a sticky
    row of horizontally scrollable tabs; the instance strip scrolls instead of wrapping;
@@ -21636,6 +21737,8 @@ var SettingsDialog = class {
     this.hostSections = [];
     /** The timeline-mark groups (defined + named by marks) — one checkbox each on the Events tab. */
     this.markGroups = [];
+    /** A group's OWN switch (what its checkbox shows) — a child under an off parent keeps its own state. */
+    this.markGroupOwnVisible = () => true;
     this.markGroupVisible = () => true;
     /** The Canvas → Theme row: current app theme + where a pick is raised. The row is a
      *  host callback, NOT a config patch — the app theme stays out of the persisted
@@ -21653,6 +21756,9 @@ var SettingsDialog = class {
     this.activeSection = null;
     /** Mobile chrome: fullscreen card, burger-opened section sidebar, TOC as top tabs. */
     this.mobileLayout = false;
+    /** Opens/closes the mobile section sidebar of the CURRENT build (the burger in the
+     *  shell header outlives pane rebuilds, so it reaches the rail through here). */
+    this.toggleRail = null;
     /** The visibility policy: setting ids hidden by the host (subtree semantics). */
     this.hiddenSettings = /* @__PURE__ */ new Set();
     if (getComputedStyle(container).position === "static") container.style.position = "relative";
@@ -21662,7 +21768,8 @@ var SettingsDialog = class {
     this.hostSections = sections;
   }
   /** The timeline-mark groups and their current visibility — the Events tab's rows on next open. */
-  setMarkGroups(groups, visible) {
+  setMarkGroups(groups, visible, ownVisible = visible) {
+    this.markGroupOwnVisible = ownVisible;
     this.markGroups = groups;
     this.markGroupVisible = visible;
   }
@@ -21728,7 +21835,6 @@ var SettingsDialog = class {
     this.onReset = onReset ?? null;
     ensureControlStyles();
     const mobile = this.mobileLayout;
-    let toggleRail = null;
     let burger;
     if (mobile) {
       burger = document.createElement("button");
@@ -21736,8 +21842,83 @@ var SettingsDialog = class {
       burger.className = "vela-sd-burger";
       burger.innerHTML = iconAt("burger", 16);
       burger.title = "Sections";
-      burger.addEventListener("click", () => toggleRail?.());
+      burger.addEventListener("click", () => this.toggleRail?.());
+    }
+    const ui = new Dialog({
+      host: this.container,
+      title: "Chart settings",
+      // Non-modal: a live-edit dialog must leave the page interactive — a modal
+      // machine locks pointer events on the whole body, killing the chart, the
+      // legend, and the body-portaled popovers (color picker, select lists).
+      modal: false,
+      contained: true,
+      align: "top",
+      draggable: !mobile,
+      flush: true,
+      className: "vela-dialog--settings",
+      headerStart: burger,
+      closeOnBackdrop: true,
+      footer: (foot) => {
+        foot.style.cssText = `padding:10px 14px;display:flex;align-items:center;justify-content:flex-start;gap:8px;`;
+        const resetBtn = document.createElement("button");
+        resetBtn.type = "button";
+        resetBtn.textContent = "Reset defaults";
+        resetBtn.className = "vela-sd-btn";
+        resetBtn.addEventListener("click", () => this.onReset?.());
+        foot.appendChild(resetBtn);
+      },
+      // A close signal may only close ITS OWN dialog: the machine reports the exit
+      // asynchronously, so a close-then-reopen in one tick would otherwise see the
+      // old instance's signal tear down the freshly opened one.
+      onOpenChange: (open2) => {
+        if (!open2 && this.ui === ui) this.close();
+      }
+    });
+    if (mobile) ui.positioner.classList.add("vela-sd-mobile");
+    ui.positioner.style.paddingTop = mobile ? "0" : "8vh";
+    this.root = ui.positioner;
+    this.ui = ui;
+    const panes = this.buildContent(ui, config, section, mobile);
+    ui.show();
+    this.layoutPanes(panes);
+  }
+  /**
+   * Re-seed every control of an OPEN dialog from `config`, in place: the shell stays
+   * (no close/open transition), only the tab rail and panes rebuild, landing back on
+   * the current tab. The reset path — the restored values must show without the
+   * dialog re-entering. No-op while closed.
+   */
+  refresh(config) {
+    const ui = this.ui;
+    if (!ui) return;
+    closeOpenPopovers();
+    closeWidthPopover();
+    for (const dispose of this.hintTips) dispose();
+    this.hintTips = [];
+    this.config = config;
+    ui.body.replaceChildren();
+    this.layoutPanes(this.buildContent(ui, config, this.activeSection ?? void 0, this.mobileLayout));
+  }
+  /** Structured chart-type panes (instance strip / group TOC) own their layout and
+   *  tag their rows hosts instead; each host gets its own field grid. Runs on a SHOWN
+   *  dialog — the grids measure their labels. */
+  layoutPanes(panes) {
+    for (const el of panes) {
+      const hosts = [...el.querySelectorAll("[data-sd-rows-host]")];
+      if (hosts.length === 0) {
+        this.layoutSettingsGrids(el);
+        continue;
+      }
+      for (const h of hosts) this.layoutSettingsGrids(h);
     }
+  }
+  /**
+   * Build the tab rail + one pane per section into `ui.body` (the linear `body` of
+   * section markers and rows is split afterwards), select `section` (the active
+   * style's own tab when none is asked for), and return the pane elements for
+   * {@link layoutPanes}.
+   */
+  buildContent(ui, config, section, mobile) {
     const body = document.createElement("div");
     body.style.cssText = "display:flex;flex-direction:column;gap:0;";
     const sid = (el, id) => {
@@ -21941,9 +22122,28 @@ var SettingsDialog = class {
     if (this.markGroups.length > 0) {
       body.append(sid(this.section("Events"), MARKS_SETTINGS_ID));
       body.append(sid(this.sectionTitle("Visible events"), MARKS_GROUPS_SETTINGS_ID));
-      for (const g of this.markGroups) {
-        body.append(sid(this.boolRow(g.label, this.markGroupVisible(g.id), (v) => this.emit({ marks: { groups: { [g.id]: v } } })), markGroupSettingsId(g.id)));
+      const rowsById = /* @__PURE__ */ new Map();
+      const rows = markGroupRows(this.markGroups);
+      const refreshDimming = () => {
+        for (const { group } of rows) {
+          const el = rowsById.get(group.id);
+          if (!el || group.parent === void 0) continue;
+          el.classList.toggle("vela-sd-soft", !this.markGroupVisible(group.parent));
+        }
+      };
+      for (const { group: g, depth } of rows) {
+        const row = this.boolRow(g.label, this.markGroupOwnVisible(g.id), (v) => {
+          this.emit({ marks: { groups: { [g.id]: v } } });
+          refreshDimming();
+        });
+        if (depth > 0) {
+          row.classList.add("vela-sd-nested");
+          row.style.setProperty("--vela-sd-depth", String(depth));
+        }
+        rowsById.set(g.id, row);
+        body.append(sid(row, markGroupSettingsId(g.id)));
       }
+      refreshDimming();
     }
     renderChartTypeSections("end");
     renderHostSections("end");
@@ -21971,8 +22171,8 @@ var SettingsDialog = class {
     if (mobile) {
       railScrim = document.createElement("div");
       railScrim.className = "vela-sd-railscrim";
-      railScrim.addEventListener("click", () => toggleRail?.());
-      toggleRail = (open2) => {
+      railScrim.addEventListener("click", () => this.toggleRail?.());
+      this.toggleRail = (open2) => {
         const on = open2 ?? !rail.classList.contains("open");
         rail.classList.toggle("open", on);
         railScrim?.classList.toggle("open", on);
@@ -22012,35 +22212,6 @@ var SettingsDialog = class {
       });
       if (hidActive) activate(0);
     };
-    const ui = new Dialog({
-      host: this.container,
-      title: "Chart settings",
-      // Non-modal: a live-edit dialog must leave the page interactive — a modal
-      // machine locks pointer events on the whole body, killing the chart, the
-      // legend, and the body-portaled popovers (color picker, select lists).
-      modal: false,
-      contained: true,
-      align: "top",
-      draggable: !mobile,
-      flush: true,
-      className: "vela-dialog--settings",
-      headerStart: burger,
-      closeOnBackdrop: true,
-      footer: (foot) => {
-        foot.style.cssText = `padding:10px 14px;display:flex;align-items:center;justify-content:flex-start;gap:8px;`;
-        const resetBtn = document.createElement("button");
-        resetBtn.type = "button";
-        resetBtn.textContent = "Reset defaults";
-        resetBtn.className = "vela-sd-btn";
-        resetBtn.addEventListener("click", () => this.onReset?.());
-        foot.appendChild(resetBtn);
-      },
-      onOpenChange: (open2) => {
-        if (!open2) this.close();
-      }
-    });
-    if (mobile) ui.positioner.classList.add("vela-sd-mobile");
-    ui.positioner.style.paddingTop = mobile ? "0" : "8vh";
     const activate = (idx) => {
       panes.forEach((p, i) => {
         p.el.style.display = i === idx ? "block" : "none";
@@ -22049,7 +22220,7 @@ var SettingsDialog = class {
       this.activeSection = panes[idx]?.title ?? null;
       if (mobile) {
         ui.titleEl.textContent = panes[idx]?.title ?? "Chart settings";
-        toggleRail?.(false);
+        this.toggleRail?.(false);
       }
     };
     panes.forEach((p, i) => {
@@ -22064,17 +22235,7 @@ var SettingsDialog = class {
     shell.append(rail, paneHost);
     if (railScrim) shell.append(railScrim);
     ui.body.appendChild(shell);
-    this.root = ui.positioner;
-    this.ui = ui;
-    ui.show();
-    for (const p of panes) {
-      const hosts = [...p.el.querySelectorAll("[data-sd-rows-host]")];
-      if (hosts.length === 0) {
-        this.layoutSettingsGrids(p.el);
-        continue;
-      }
-      for (const h of hosts) this.layoutSettingsGrids(h);
-    }
+    return panes.map((p) => p.el);
   }
   close() {
     closeOpenPopovers();
@@ -22082,6 +22243,7 @@ var SettingsDialog = class {
     const ui = this.ui;
     this.ui = null;
     this.root = null;
+    this.toggleRail = null;
     this.tabs = [];
     for (const dispose of this.hintTips) dispose();
     this.hintTips = [];
@@ -30181,7 +30343,11 @@ var NativeRenderer = class {
     }
     this.settingsDialog.setTheme(this.theme);
     this.settingsDialog.setHostSections(this.hostSettingsSections);
-    this.settingsDialog.setMarkGroups(this.markGroupsInUse(), (id) => markGroupVisible(this.scene.marks, id, this.scene.markGroups));
+    this.settingsDialog.setMarkGroups(
+      this.markGroupsForEventsTab(),
+      (id) => markGroupVisible2(this.scene.marks, id, this.scene.markGroups),
+      (id) => markGroupOwnVisible(this.scene.marks.groups, id, this.scene.markGroups)
+    );
     this.settingsDialog.setHiddenSettings(this.hiddenSettings);
     this.syncThemeControl();
     this.settingsDialog.toggle(
@@ -30189,13 +30355,24 @@ var NativeRenderer = class {
       (patch) => this.applyConfig(patch),
       (json) => this.applyConfig(json),
       () => {
-        if (this.factoryConfig) this.applyConfig(factoryResetConfig(this.factoryConfig));
-        this.settingsDialog?.close();
-        this.openSettingsDialog();
+        if (this.factoryConfig) this.applyConfig(this.factoryResetDocument(this.factoryConfig));
+        this.settingsDialog?.refresh(this.getConfig());
       },
       section
     );
   }
+  /**
+   * The document "Reset defaults" applies: every setting back to its first-run value,
+   * with two things that are NOT settings held or resolved here — the price style
+   * stays the one the user is looking at, and the timeline-mark groups (an additive
+   * merge, like the type bags) are named back to their host-declared visibility.
+   */
+  factoryResetDocument(factory) {
+    const doc = factoryResetConfig(factory, this.scene.priceStyle);
+    const groups = { ...doc.marks.groups };
+    for (const g of this.markGroupsInUse()) groups[g.id] = g.visible !== false;
+    return { ...doc, marks: { ...doc.marks, groups } };
+  }
   /** Close the in-chart dialogs (indicator settings + chart-settings gear). No-op when none are open. */
   closeDialogs() {
     this.inputsUI?.closeOpenDialog();
@@ -31258,6 +31435,15 @@ var NativeRenderer = class {
   markGroupsInUse() {
     return effectiveMarkGroups(this.scene.timelineMarks, this.scene.markGroups);
   }
+  /**
+   * The groups as the Events tab lists them: nested only under a DEFINED parent. The
+   * painter's visibility chain resolves parents against the defined groups alone, so a
+   * parent that marks merely name must not nest (and dim) a child the painter still shows.
+   */
+  markGroupsForEventsTab() {
+    const defined = new Set(this.scene.markGroups.map((g) => g.id));
+    return this.markGroupsInUse().map((g) => g.parent !== void 0 && !defined.has(g.parent) ? { ...g, parent: void 0 } : g);
+  }
   onViewportChange(cb) {
     this.viewportCbs.add(cb);
     return () => this.viewportCbs.delete(cb);
@@ -35427,6 +35613,7 @@ function registerClassicIndicators() {
 }
 
 // src/Vela.ts
+var asError = (err) => err instanceof Error ? err : new Error(String(err));
 var Vela = class {
   constructor(container, options = {}, deps = {}) {
     registerBuiltinChartTypes();
@@ -35550,7 +35737,12 @@ var Vela = class {
    * fetch from — the same relationship `script:run` has to `context:changed`.
    */
   runScript(source, options) {
-    const handle = this.addIndicator(source, options);
+    let handle;
+    try {
+      handle = this.addIndicator(source, options);
+    } catch (err) {
+      return Promise.resolve({ ok: false, run: null, error: asError(err), onUpdate: () => () => void 0, remove: () => void 0 });
+    }
     const updates = /* @__PURE__ */ new Set();
     const drop = () => {
       try {
@@ -35594,7 +35786,12 @@ var Vela = class {
     });
   }
   runIndicator(source, options) {
-    const handle = this.addIndicator(source, options);
+    let handle;
+    try {
+      handle = this.addIndicator(source, options);
+    } catch (err) {
+      return Promise.resolve({ ok: false, handle: null, error: asError(err), context: null });
+    }
     return new Promise((resolve) => {
       const offReady = handle.on("ready", () => {
         offReady();