@luxalgo/vela 0.6.16 → 0.6.17

package/README.md

@@ -32,6 +32,10 @@ touching the rest.
 
 ## What's in the box
 
+<p align="center">
+  <img src=".github/vela-layout.png" alt="Vela package layout" width="100%">
+</p>
+
 - **`@luxalgo/vela`**: the headless chart. Data model, engines, drawings, providers,
   native renderer.
 - **`@luxalgo/vela/workspace`**: the full chart app. One chart or a grid of them under

package/dist/{DataProvider-XLdJB86x.d.ts → DataProvider-B-Jz59Rf.d.ts}

@@ -1,4 +1,4 @@
-import { M as MarketConfig, O as OHLCV, U as Unsubscribe } from './options-bdSAtp7y.js';
+import { M as MarketConfig, O as OHLCV, U as Unsubscribe } from './options-CX1lSYWA.js';
 
 /**
  * Symbol metadata an engine may need (e.g. Pine `syminfo.*`). Free-form beyond

package/dist/{DataProvider-xH2VBcFT.d.cts → DataProvider-OfR3fXg9.d.cts}

@@ -1,4 +1,4 @@
-import { M as MarketConfig, O as OHLCV, U as Unsubscribe } from './options-bdSAtp7y.cjs';
+import { M as MarketConfig, O as OHLCV, U as Unsubscribe } from './options-CX1lSYWA.cjs';
 
 /**
  * Symbol metadata an engine may need (e.g. Pine `syminfo.*`). Free-form beyond

package/dist/{chunk-6DPAYEGO.js → chunk-CAFCLMPF.js}

@@ -151,6 +151,7 @@ registerIcon("star-filled", S('<path d="M8 2.2l1.75 3.55 3.9.55-2.8 2.75.65 3.9L
 registerIcon("grip", S('<circle cx="6" cy="3.5" r="1"/><circle cx="10" cy="3.5" r="1"/><circle cx="6" cy="8" r="1"/><circle cx="10" cy="8" r="1"/><circle cx="6" cy="12.5" r="1"/><circle cx="10" cy="12.5" r="1"/>', 'fill="currentColor" stroke="none"'));
 registerIcon("kebab", S('<circle cx="8" cy="3.2" r="1.2"/><circle cx="8" cy="8" r="1.2"/><circle cx="8" cy="12.8" r="1.2"/>', 'fill="currentColor" stroke="none"'));
 registerIcon("burger", S('<path d="M2.5 4.5h11M2.5 8h11M2.5 11.5h11"/>'));
+registerIcon("info", S('<path d="M8 7.4v4.4"/><circle cx="8" cy="4.6" r="0.9" fill="currentColor" stroke="none"/>'));
 registerIcon("reset", S('<path d="M2 8a6 6 0 1 0 6-6 6.5 6.5 0 0 0-4.5 1.83L2 5.33"/><path d="M2 2v3.33h3.33"/>'));
 registerIcon("pane-collapse", S('<path d="M2.6 9.4h4v4M13.4 6.6h-4v-4"/><path d="m9.4 6.6 4.2-4.2M2.4 13.6l4.2-4.2"/>'));
 registerIcon("pane-expand", S('<path d="M9.8 2.4h3.8v3.8M6.2 13.6H2.4V9.8"/><path d="m13.6 2.4-4.4 4.4M2.4 13.6l4.4-4.4"/>'));

package/dist/{chunk-I77F2SVE.js → chunk-IFJJPXSV.js}

@@ -1,4 +1,4 @@
-import { svg24, NEUTRAL, BEARISH, WARNING, BULLISH, INFO, ACCENT_BRIGHT, VALID, INVALID, MARKER, ACCENT, injectStyles, iconEl } from './chunk-6DPAYEGO.js';
+import { svg24, NEUTRAL, BEARISH, WARNING, BULLISH, INFO, ACCENT_BRIGHT, VALID, INVALID, MARKER, ACCENT, injectStyles, iconEl } from './chunk-CAFCLMPF.js';
 
 // src/core/native-indicators/NativeIndicator.ts
 var REGISTRY = /* @__PURE__ */ new Map();

package/dist/{chunk-SEOO6YG7.js → chunk-OSZDSH7F.js}

@@ -1,8 +1,8 @@
-import { parseSymbol, priceStyleIds, BUILTIN_PRICE_STYLES, tzButtonLabel, TIMEZONES, normalizeTimezone, tzMenuLabel, isGroupRow, defaultMemberOf, groupKeyOf, groupMembers, LEGEND_AT_TOP_ATTR, Vela, TypedEventBus, MultiProviderFeed, registerBuiltinChartTypes, resolveTheme, buildToolbar, createCustomMark, createAttributionMark, DrawingToolbar, applyAttributionMarkTheme, sharedBarStore, timeframeToMs } from './chunk-GIJYO4LO.js';
-import { chartType, resolveTopbarComposition, topbarActionOverride, TOPBAR_BUILTIN_IDS, widgetActions, SidePanel, sidePanels, DEFAULT_PANEL_ORDER, symbolRanking, resolveEngines, legendActionsProviderFor, legendCalloutsProviderFor, statePersistenceHandlers, topbarHas, rendererDefaults, widgetAttachments, getDrawingType, inputDeltas } from './chunk-I77F2SVE.js';
-import { Tooltip, KeymapManager, isEditableTarget, Drawer } from './chunk-Q3TFJNJW.js';
-import { Menu, Dialog, CalloutBubble, applyPlotOverlayTokens, ensureUIHost } from './chunk-MGU3USTP.js';
-import { registerIcon, svg16, injectStyles, iconEl, iconMarkup, iconAt, SESSION_OFF, SESSION_POST, SESSION_PRE, icon, categoricalColor } from './chunk-6DPAYEGO.js';
+import { parseSymbol, priceStyleIds, BUILTIN_PRICE_STYLES, tzButtonLabel, TIMEZONES, normalizeTimezone, tzMenuLabel, isGroupRow, defaultMemberOf, groupKeyOf, groupMembers, LEGEND_AT_TOP_ATTR, normalizeSession, Vela, TypedEventBus, MultiProviderFeed, registerBuiltinChartTypes, resolveTheme, buildToolbar, createCustomMark, createAttributionMark, DrawingToolbar, applyAttributionMarkTheme, sharedBarStore, timeframeToMs } from './chunk-YCD72KGK.js';
+import { chartType, resolveTopbarComposition, topbarActionOverride, TOPBAR_BUILTIN_IDS, widgetActions, SidePanel, sidePanels, DEFAULT_PANEL_ORDER, symbolRanking, resolveEngines, legendActionsProviderFor, legendCalloutsProviderFor, statePersistenceHandlers, topbarHas, rendererDefaults, widgetAttachments, getDrawingType, inputDeltas } from './chunk-IFJJPXSV.js';
+import { Tooltip, KeymapManager, isEditableTarget, Drawer } from './chunk-XCBJU674.js';
+import { Menu, Dialog, CalloutBubble, applyPlotOverlayTokens, ensureUIHost } from './chunk-T5Z5YUCF.js';
+import { registerIcon, svg16, injectStyles, iconEl, iconMarkup, iconAt, SESSION_OFF, SESSION_POST, SESSION_PRE, icon, categoricalColor } from './chunk-CAFCLMPF.js';
 import { baseOf } from './chunk-W4EJWLEO.js';
 
 // src/widget/timeframe.ts
@@ -4826,9 +4826,6 @@ var ChartContextMenu = class {
   }
 };
 
-// src/core/options.ts
-var normalizeSession = (v) => v === "regular" || v === "extended" ? v : void 0;
-
 // src/widget/session-shading.ts
 var DAY_MS = 864e5;
 var MINUTE_MS = 6e4;

package/dist/{chunk-MGU3USTP.js → chunk-T5Z5YUCF.js}

@@ -1,4 +1,4 @@
-import { overlayScrollbarCss, injectStyles, isDarkColor, mix, HIGHLIGHT, ACCENT_BRIGHT, ACCENT, withAlpha, iconAt, iconEl, BULLISH, BEARISH, WARNING, NEUTRAL } from './chunk-6DPAYEGO.js';
+import { overlayScrollbarCss, injectStyles, isDarkColor, mix, HIGHLIGHT, ACCENT_BRIGHT, ACCENT, withAlpha, iconAt, iconEl, BULLISH, BEARISH, WARNING, NEUTRAL } from './chunk-CAFCLMPF.js';
 import { VanillaMachine, normalizeProps, spreadProps } from '@zag-js/vanilla';
 export { normalizeProps, spreadProps } from '@zag-js/vanilla';
 import * as menu from '@zag-js/menu';

package/dist/{chunk-Q3TFJNJW.js → chunk-XCBJU674.js}

@@ -1,5 +1,5 @@
-import { normalizeProps, nextUid, runMachine, spreadProps } from './chunk-MGU3USTP.js';
-import { injectStyles } from './chunk-6DPAYEGO.js';
+import { normalizeProps, nextUid, runMachine, spreadProps } from './chunk-T5Z5YUCF.js';
+import { injectStyles } from './chunk-CAFCLMPF.js';
 import * as tooltip from '@zag-js/tooltip';
 import * as dialog from '@zag-js/dialog';
 

package/dist/{chunk-GIJYO4LO.js → chunk-YCD72KGK.js}

@@ -1,6 +1,6 @@
-import { deserializeDrawing, chartTypes, rendererLayers, foldBaseModulation, registerChartType, rendererDefaults, getDrawingType, settingsRowVisible, normalizeSettingsRow, Magnifier, TextLabel, Callout, resetDrawingSettings, registerNativeIndicator, chartType, getNativeIndicator, nativeIndicatorDescriptors, drawingTypes, settingsRowValueKeys, formatDuration, RegressionChannel, FixedRangeVolumeProfile, SegmentDrawing, ArrowMark, GlyphStamp, RadialFib, FibSpiral, DedekindTessellation, MachFigure, GannSquare, FibRatios, MeasureBox, PositionTool, AnchoredVwap, PatternDrawing, Comment, PriceNote, Signpost, Note, PriceLabel, GANN_SQUARE_ARCS, magnifierTimeframeLabel, lineSegmentIntersection, DEFAULT_DRAWING_COLOR, MAGNIFIER_TIMEFRAME_OPTIONS, GLYPH_OPTIONS, STAMP_SIZE_OPTIONS, LINE_STYLE_OPTIONS, DEDEKIND_CURVATURE_OPTIONS, MACH_NUMBER_OPTIONS, MACH_WAVE_COUNT_OPTIONS, TEXT_SIZE_OPTIONS, createDrawing, inputVisible, tickerModifierIds, CalloutBase, DIRECTION_OPTIONS, stableSeriesId } from './chunk-I77F2SVE.js';
-import { themeTokens, Dialog, closeOpenPopovers, closeWidthPopover, fieldSection, buildFieldControl, fieldSeparator, fieldGrid, fieldRow, blendOver, splitColor, CalloutBubble, Menu, TextArea, Popover, NumberInput, buildColorPicker, isPopoverOpen, eventDismissedPopover, toggleSelectList, openPopoverTrigger, fieldGridColumns, FIELD_GAP_PX, STATIC_TOKENS } from './chunk-MGU3USTP.js';
-import { icon, iconAt, withAlpha, WARNING, ACCENT, NEUTRAL, BEARISH, BULLISH, isDarkColor, SERIES_LINE, CHIP_PLATE, CROSSHAIR, TRADE_EXIT, TRADE_SHORT, TRADE_LONG, overlayScrollbarCss, SLATE_DEEP, VALID, INVALID, SLATE, FIELD_FOCUS_CSS, FIELD_FOCUS_RING, INFO, svg24, svg24Solid } from './chunk-6DPAYEGO.js';
+import { deserializeDrawing, chartTypes, rendererLayers, foldBaseModulation, registerChartType, rendererDefaults, getDrawingType, settingsRowVisible, normalizeSettingsRow, Magnifier, TextLabel, Callout, resetDrawingSettings, registerNativeIndicator, chartType, getNativeIndicator, nativeIndicatorDescriptors, drawingTypes, settingsRowValueKeys, formatDuration, RegressionChannel, FixedRangeVolumeProfile, SegmentDrawing, ArrowMark, GlyphStamp, RadialFib, FibSpiral, DedekindTessellation, MachFigure, GannSquare, FibRatios, MeasureBox, PositionTool, AnchoredVwap, PatternDrawing, Comment, PriceNote, Signpost, Note, PriceLabel, GANN_SQUARE_ARCS, magnifierTimeframeLabel, lineSegmentIntersection, DEFAULT_DRAWING_COLOR, MAGNIFIER_TIMEFRAME_OPTIONS, GLYPH_OPTIONS, STAMP_SIZE_OPTIONS, LINE_STYLE_OPTIONS, DEDEKIND_CURVATURE_OPTIONS, MACH_NUMBER_OPTIONS, MACH_WAVE_COUNT_OPTIONS, TEXT_SIZE_OPTIONS, createDrawing, inputVisible, tickerModifierIds, CalloutBase, DIRECTION_OPTIONS, stableSeriesId } from './chunk-IFJJPXSV.js';
+import { themeTokens, Dialog, closeOpenPopovers, closeWidthPopover, fieldSection, buildFieldControl, fieldSeparator, fieldGrid, fieldRow, blendOver, splitColor, CalloutBubble, Menu, TextArea, Popover, NumberInput, buildColorPicker, isPopoverOpen, eventDismissedPopover, toggleSelectList, openPopoverTrigger, fieldGridColumns, FIELD_GAP_PX, STATIC_TOKENS } from './chunk-T5Z5YUCF.js';
+import { icon, iconAt, withAlpha, WARNING, ACCENT, NEUTRAL, BEARISH, BULLISH, isDarkColor, SERIES_LINE, CHIP_PLATE, CROSSHAIR, TRADE_EXIT, TRADE_SHORT, TRADE_LONG, overlayScrollbarCss, SLATE_DEEP, VALID, INVALID, SLATE, FIELD_FOCUS_CSS, FIELD_FOCUS_RING, INFO, svg24, svg24Solid } from './chunk-CAFCLMPF.js';
 
 // src/core/events/EventBus.ts
 var TypedEventBus = class {
@@ -2368,6 +2368,23 @@ function attachChromeTooltip(anchor, opts) {
     clear();
   };
 }
+function chromeHint(text, opts) {
+  const px = opts.size ?? 16;
+  const el = document.createElement("span");
+  el.className = "vela-hint";
+  el.setAttribute("role", "img");
+  el.setAttribute("aria-label", text);
+  el.innerHTML = iconAt("info", px);
+  el.style.cssText = `flex:0 0 auto;display:inline-flex;align-items:center;justify-content:center;width:${px}px;height:${px}px;border-radius:50%;cursor:help;user-select:none;background:var(--vela-hover);color:var(--vela-fg-muted);transition:background var(--vela-dur-fast) ease,color var(--vela-dur-fast) ease;`;
+  const hover = (on) => {
+    el.style.background = on ? "var(--vela-active)" : "var(--vela-hover)";
+    el.style.color = on ? "var(--vela-fg-bright)" : "var(--vela-fg-muted)";
+  };
+  el.addEventListener("pointerenter", () => hover(true));
+  el.addEventListener("pointerleave", () => hover(false));
+  const dispose = attachChromeTooltip(el, { host: opts.host, theme: opts.theme, text: () => text, wrap: true, delayMs: 250 });
+  return { el, dispose };
+}
 
 // src/renderers/native/drawings/DrawingToolbar.ts
 var TOOLBAR_WIDTH = 44;
@@ -3001,6 +3018,24 @@ function arrowHitHtml(svg) {
   return `<span class="vela-dtb-hit vela-dtb-hit--arrow">${iconSpan(svg, 11)}</span>`;
 }
 
+// src/core/options.ts
+var normalizeSession = (v) => v === "regular" || v === "extended" ? v : void 0;
+var LIVE_BAR_EASE_DEFAULT_MS = 90;
+var LIVE_BAR_EASE_MAX_MS = 1e3;
+function resolveLiveBarEaseMs(value) {
+  if (value === true) return LIVE_BAR_EASE_DEFAULT_MS;
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return 0;
+  return Math.min(value, LIVE_BAR_EASE_MAX_MS);
+}
+function resolveAnimations(animations) {
+  if (typeof animations === "boolean") return { animZoom: animations, animPan: animations, animLiveBar: 0 };
+  return {
+    animZoom: animations?.zoom ?? true,
+    animPan: animations?.pan ?? true,
+    animLiveBar: resolveLiveBarEaseMs(animations?.liveBar)
+  };
+}
+
 // src/core/model/series.ts
 function isLineLikeSeries(spec) {
   return spec.kind !== "candle" && spec.kind !== "bar" && spec.kind !== "markers";
@@ -3373,14 +3408,11 @@ var IndicatorInputsDialog = class {
   buildTextField(id, current, emit) {
     return buildFieldControl({ kind: "text", id, value: current, onChange: emit }).el;
   }
-  /** A hoverable ⓘ affordance carrying an input's `tooltip` (themed chrome tip; wraps). */
+  /** The shared ⓘ hint carrying an input's `tooltip` (see {@link chromeHint}). */
   infoButton(tooltip) {
-    const b = document.createElement("span");
-    b.textContent = "i";
-    this.dialogTips.push(attachChromeTooltip(b, { host: this.host.container, theme: () => this.host.theme(), text: () => tooltip, wrap: true, delayMs: 250 }));
-    b.className = "vela-ind-hint";
-    b.style.cssText = "flex:0 0 auto;display:inline-flex;align-items:center;justify-content:center;width:18px;height:18px;border-radius:50%;font-weight:600;font-size:11px;font-family:inherit;line-height:1;cursor:help;user-select:none;";
-    return b;
+    const { el, dispose } = chromeHint(tooltip, { host: this.host.container, theme: () => this.host.theme(), size: 18 });
+    this.dialogTips.push(dispose);
+    return el;
   }
   /** A dropdown over plain string options (value === label) — a thin case of {@link selectPairs}. */
   select(id, options, current, emit) {
@@ -3817,8 +3849,6 @@ function ensureDialogStyles() {
 ${overlayScrollbarCss(".vela-dialog.vela-ind-dialog *", 9)}
 .vela-ind-tab{font-weight:600;font-size:13px;line-height:20px;transition:color var(--vela-dur-fast) ease,border-color var(--vela-dur-fast) ease;}
 .vela-ind-tab:not(.vela-ind-tab-active):hover{color:var(--vela-fg-bright);}
-.vela-ind-hint{background:var(--vela-hover);color:var(--vela-fg-muted);transition:background var(--vela-dur-fast) ease,color var(--vela-dur-fast) ease;}
-.vela-ind-hint:hover{background:var(--vela-active);color:var(--vela-fg-bright);}
 .vela-ind-ctl,.vela-ind-close{background-color:transparent;color:inherit;transition:color var(--vela-dur-fast) ease,background-color var(--vela-dur-fast) ease;}
 .vela-ind-ctl svg,.vela-ind-close svg{width:${LEGEND_ICON_PX}px;height:${LEGEND_ICON_PX}px;display:block;flex:none;stroke-width:1;}
 .vela-ind-ctl:hover{background-color:var(--vela-hover-strong);}
@@ -5362,7 +5392,8 @@ function mergeConfig(base, patch) {
       labelsVisible: isBool(ps.labelsVisible) ? ps.labelsVisible : base.priceScale.labelsVisible,
       currentPriceLine: isBool(ps.currentPriceLine) ? ps.currentPriceLine : base.priceScale.currentPriceLine,
       priceLabel: isBool(ps.priceLabel) ? ps.priceLabel : base.priceScale.priceLabel,
-      countdown: isBool(ps.countdown) ? ps.countdown : base.priceScale.countdown
+      countdown: isBool(ps.countdown) ? ps.countdown : base.priceScale.countdown,
+      animateLastPrice: isBool(ps.animateLastPrice) ? ps.animateLastPrice : base.priceScale.animateLastPrice
     },
     panes: {
       separatorColor: isColor(panes.separatorColor) ? panes.separatorColor : base.panes.separatorColor
@@ -10149,6 +10180,8 @@ var BUILTIN_SETTINGS_IDS = [
   "symbol.style.baseline.fill-bottom",
   "symbol.style.baseline.base-level",
   "symbol.style.baseline.width",
+  "symbol.animation",
+  "symbol.animation.price-changes",
   "symbol.timezone",
   "scales",
   "scales.price-scale",
@@ -10291,8 +10324,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
 .vela-sd-mobile .vela-select-trigger,.vela-sd-mobile .vela-num input,.vela-sd-mobile .vela-width-field{height:34px;}
 .vela-sd-mobile .vela-sd-close{width:40px;height:40px;}
 .vela-sd-mobile .vela-sd-btn{height:38px;}
-.vela-sd-mobile .vela-sd-row span,.vela-sd-mobile .vela-sd-bool span,.vela-sd-mobile .vela-field-label{white-space:normal !important;}
-`;
+.vela-sd-mobile .vela-sd-row span,.vela-sd-mobile .vela-sd-bool span,.vela-sd-mobile .vela-field-label{white-space:normal !important;}`;
   if (!existing) document.head.appendChild(st);
 }
 var SettingsDialog = class {
@@ -10313,6 +10345,8 @@ var SettingsDialog = class {
     this.themeControl = null;
     /** The built tabs, by title — how `showSection` reaches a pane while the dialog is open. */
     this.tabs = [];
+    this.hintTips = [];
+    // ⓘ tooltip disposers of the open build (see hint)
     /** Active instance-strip tab per chart type — remembered across dialog rebuilds. */
     this.typeActiveInstance = /* @__PURE__ */ new Map();
     /** Active TOC group per structured pane (`<typeId>/<pane>` → group label). */
@@ -10501,6 +10535,13 @@ var SettingsDialog = class {
       body.append(g);
     }
     showActive(config.series.style);
+    body.append(sid(this.sectionTitle("Animation"), "symbol.animation"));
+    body.append(sid(this.boolRow(
+      "Animate price changes",
+      config.priceScale.animateLastPrice,
+      (v) => this.emit({ priceScale: { animateLastPrice: v } }),
+      this.hint("Glide the live bar to each new price instead of snapping.")
+    ), "symbol.animation.price-changes"));
     body.append(sid(this.sectionTitle("Time zone"), "symbol.timezone"));
     body.append(sid(this.selectRowLabeled("Time zone", normalizeTimezone(config.timeScale.timezone), timezoneOptions(config.timeScale.timezone), (v) => this.emit({ timeScale: { timezone: v } })), "symbol.timezone"));
     const renderHostSections = (placement) => {
@@ -10708,6 +10749,8 @@ var SettingsDialog = class {
     this.ui = null;
     this.root = null;
     this.tabs = [];
+    for (const dispose of this.hintTips) dispose();
+    this.hintTips = [];
     ui?.destroy();
   }
   destroy() {
@@ -11121,23 +11164,31 @@ var SettingsDialog = class {
       }).el
     });
   }
-  /** A toggle row: the checkbox sits to the LEFT of its label (never in the control area). */
-  boolRow(label, value, onChange) {
-    return this.toggleRow(label, value, onChange, []);
+  /** A toggle row: the checkbox sits to the LEFT of its label (never in the control area).
+   *  `info` (see {@link hint}) rides after the label. */
+  boolRow(label, value, onChange, info) {
+    return this.toggleRow(label, value, onChange, [], void 0, info);
   }
   /** An enable row: checkbox + label in the label column, dependent controls in the
    *  shared control column; the control group dims and ignores input while the toggle
    *  is off. With `get`, the row re-reads its state on a 'vela-sync' event. */
-  toggleRow(label, value, onToggle, controls, get) {
+  toggleRow(label, value, onToggle, controls, get, info) {
     return fieldRow({
       label,
       labelSize: "sm",
       bool: controls.length === 0,
       toggle: { checked: value, onChange: onToggle, get },
       control: controls,
+      info,
       className: controls.length === 0 ? "vela-sd-bool" : "vela-sd-row"
     });
   }
+  /** The shared ⓘ hint after a row label (see {@link chromeHint}). Disposed with the dialog. */
+  hint(text) {
+    const { el, dispose } = chromeHint(text, { host: this.container, theme: () => this.theme });
+    this.hintTips.push(dispose);
+    return el;
+  }
   numberRow(label, value, min, max, step, onChange) {
     return fieldRow({
       label,
@@ -16491,7 +16542,6 @@ var ZOOM_OUT_MARGIN_BARS = 6;
 var ZOOM_TAU_MS = 70;
 var SCALE_TAU_MS = 80;
 var FLING_TAU_MS = 110;
-var LIVE_BAR_TAU_MS = 90;
 var SCROLL_TO_TAU_MS = 130;
 var FLING_STOP_PX = 0.02;
 var PRICE_SCALE_K = 4e-3;
@@ -16562,9 +16612,13 @@ var NativeRenderer = class {
     /** Drawings layer self-serves Ctrl+Z/Y (see the `historyChords` feature). */
     this.historyChordsEnabled = true;
     this.liveRegion = null;
-    // ── animation state (eased zoom + inertial pan) ──
+    // ── animation state (eased zoom + inertial pan + live-bar glide) ──
     this.animZoom = true;
     this.animPan = true;
+    this.animLiveBarMs = 0;
+    // forming-bar OHLC glide time-constant; 0 = each tick snaps
+    this.animLiveBarOnMs = LIVE_BAR_EASE_DEFAULT_MS;
+    // the duration the settings-dialog on/off toggle restores (last non-zero value configured)
     // Brand default candles.
     this.candleUp = BULLISH;
     this.candleDown = BEARISH;
@@ -16689,7 +16743,7 @@ var NativeRenderer = class {
     this.moveIndicatorCbs = /* @__PURE__ */ new Set();
     this.priceStyleCbs = /* @__PURE__ */ new Set();
     this.name = "native";
-    this.features = ["logScale", "currentPriceLine", "priceLabel", "countdown", "upColor", "downColor", "glow", "animZoom", "animPan", "intro", "zoomAnchor", "axisDrag", "paneResize", "candleZOrder", "candleVisible", "seriesOrder", "highlights", "sessionZones", "gridlines", "axisLabels", "scaleMode", "invertScale", "paneScales", "autoScale", "timezone", "keyboard", "historyChords", "priceStyle", "priceBaseline", "baselinePrice", "settings", "attribution", "dialogHost", "tradeMarkers", "indicatorTitles", "indicatorValues"];
+    this.features = ["logScale", "currentPriceLine", "priceLabel", "countdown", "upColor", "downColor", "glow", "animZoom", "animPan", "animLiveBar", "intro", "zoomAnchor", "axisDrag", "paneResize", "candleZOrder", "candleVisible", "seriesOrder", "highlights", "sessionZones", "gridlines", "axisLabels", "scaleMode", "invertScale", "paneScales", "autoScale", "timezone", "keyboard", "historyChords", "priceStyle", "priceBaseline", "baselinePrice", "settings", "attribution", "dialogHost", "tradeMarkers", "indicatorTitles", "indicatorValues"];
     /** Track cursor proximity to the scroll button on the plot (bubbles from the button too,
      *  so moving onto the button doesn't count as leaving). */
     this.onScrollProximityMove = (e) => {
@@ -16723,6 +16777,7 @@ var NativeRenderer = class {
       this.backendMode = opts.nativeBackend;
       this.animZoom = opts.animZoom;
       this.animPan = opts.animPan;
+      this.setLiveBarEase(resolveLiveBarEaseMs(opts.animLiveBar));
       this.glowAmount = opts.glow;
       this.candleUp = opts.upColor;
       this.candleDown = opts.downColor;
@@ -16772,6 +16827,10 @@ var NativeRenderer = class {
       case "animPan":
         this.animPan = Boolean(value);
         return;
+      case "animLiveBar":
+        this.setLiveBarEase(resolveLiveBarEaseMs(value));
+        return;
+      // affects the next tick only; a glide in flight finishes at the new rate (or snaps at 0)
       case "intro": {
         const s = value === false || value === "none" || value === "off" || value == null ? "" : String(value);
         this.introStyle = s;
@@ -16908,6 +16967,8 @@ var NativeRenderer = class {
         return this.animZoom;
       case "animPan":
         return this.animPan;
+      case "animLiveBar":
+        return this.animLiveBarMs;
       case "intro":
         return this.introStyle;
       case "zoomAnchor":
@@ -17076,7 +17137,8 @@ var NativeRenderer = class {
         labelsVisible: this.scene.showAxisLabels,
         currentPriceLine: this.scene.showPriceLine,
         priceLabel: this.scene.showPriceLabel,
-        countdown: this.scene.showCountdown
+        countdown: this.scene.showCountdown,
+        animateLastPrice: this.animLiveBarMs > 0
       },
       panes: { separatorColor: s.separatorColor ?? t.borderColor },
       trades: {
@@ -17183,6 +17245,7 @@ var NativeRenderer = class {
     this.scene.showPriceLabel = next.priceScale.priceLabel;
     this.scene.showCountdown = next.priceScale.countdown;
     this.syncCountdownTimer();
+    this.animLiveBarMs = next.priceScale.animateLastPrice ? this.animLiveBarOnMs : 0;
     s.separatorColor = keepInherit(s.separatorColor, next.panes.separatorColor, prevTheme.borderColor);
     this.scene.tradeMarkers = {
       visible: next.trades.visible,
@@ -17999,8 +18062,11 @@ var NativeRenderer = class {
     const last = this.bars[n - 1];
     if (last && bar.time === last.time) {
       this.bars[n - 1] = bar;
-      if (this.liveEaseTime !== bar.time) this.syncLiveEase(bar);
-      this.animator.start();
+      if (this.animLiveBarMs <= 0 || this.liveEaseTime !== bar.time) {
+        this.syncLiveEase(bar);
+      } else {
+        this.animator.start();
+      }
     } else if (!last || bar.time > last.time) {
       this.bars.push(bar);
       this.syncLiveEase(bar);
@@ -18012,6 +18078,12 @@ var NativeRenderer = class {
     this.scene.bars = this.bars;
     this.scheduler.invalidate(4 /* Full */);
   }
+  /** Set the live-bar glide duration (0 = off). A non-zero value is also remembered as
+   *  what the config's on/off toggle (`priceScale.animateLastPrice`) switches back on to. */
+  setLiveBarEase(ms) {
+    this.animLiveBarMs = ms;
+    if (ms > 0) this.animLiveBarOnMs = ms;
+  }
   /** Snap the eased forming-bar state to `bar` — no glide (a fresh bar or the first tick of one). */
   syncLiveEase(bar) {
     this.liveEaseTime = bar.time;
@@ -18024,9 +18096,10 @@ var NativeRenderer = class {
     const target = this.bars[this.bars.length - 1];
     if (!target || this.liveEaseTime !== target.time) return false;
     const eps = Math.max(1e-9, Math.abs(target.close) * 1e-6);
-    const nh = easeToward(this.liveEaseHigh, target.high, dtMs, LIVE_BAR_TAU_MS);
-    const nl = easeToward(this.liveEaseLow, target.low, dtMs, LIVE_BAR_TAU_MS);
-    const nc = easeToward(this.liveEaseClose, target.close, dtMs, LIVE_BAR_TAU_MS);
+    const tau = this.animLiveBarMs;
+    const nh = easeToward(this.liveEaseHigh, target.high, dtMs, tau);
+    const nl = easeToward(this.liveEaseLow, target.low, dtMs, tau);
+    const nc = easeToward(this.liveEaseClose, target.close, dtMs, tau);
     const active = Math.abs(nh - target.high) > eps || Math.abs(nl - target.low) > eps || Math.abs(nc - target.close) > eps;
     this.liveEaseHigh = active ? nh : target.high;
     this.liveEaseLow = active ? nl : target.low;
@@ -24341,21 +24414,11 @@ var Vela = class {
     registerClassicIndicators();
     const element = resolveElement(container);
     const theme = resolveTheme(options.theme);
-    let animZoom = true;
-    let animPan = true;
-    if (typeof options.animations === "boolean") {
-      animZoom = options.animations;
-      animPan = options.animations;
-    } else if (options.animations) {
-      animZoom = options.animations.zoom ?? true;
-      animPan = options.animations.pan ?? true;
-    }
     const display = {
       currentPriceLine: options.currentPriceLine ?? true,
       logScale: options.logScale ?? false,
       nativeBackend: options.nativeBackend ?? "auto",
-      animZoom,
-      animPan,
+      ...resolveAnimations(options.animations),
       glow: options.glow ?? 0,
       upColor: options.upColor ?? BULLISH,
       downColor: options.downColor ?? BEARISH,
@@ -24670,4 +24733,4 @@ function resolveElement(container) {
   return element;
 }
 
-export { BUILTIN_PRICE_STYLES, BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LEGEND_AT_TOP_ATTR, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TIMEZONES, TypedEventBus, Vela, applyAttributionMarkTheme, buildToolbar, createAttributionMark, createCustomMark, defaultMemberOf, defaultToolbar, groupKeyOf, groupMembers, isGroupRow, normalizeTimezone, parseSymbol, priceStyleIds, registerBuiltinChartTypes, resolveTheme, sharedBarStore, timeframeToMs, tzButtonLabel, tzMenuLabel, tzOffset };
+export { BUILTIN_PRICE_STYLES, BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LEGEND_AT_TOP_ATTR, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TIMEZONES, TypedEventBus, Vela, applyAttributionMarkTheme, buildToolbar, createAttributionMark, createCustomMark, defaultMemberOf, defaultToolbar, groupKeyOf, groupMembers, isGroupRow, normalizeSession, normalizeTimezone, parseSymbol, priceStyleIds, registerBuiltinChartTypes, resolveTheme, sharedBarStore, timeframeToMs, tzButtonLabel, tzMenuLabel, tzOffset };

package/dist/{contributions-BEkxwA5F.d.cts → contributions-C3b0Sx5P.d.cts}

@@ -1,5 +1,5 @@
-import { u as Millis, ai as InputSchema, ag as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, au as PaneAxis, aH as SeriesSpec, ae as Fill, B as Background, az as PriceLine, a1 as DrawingLine, Z as DrawingBox, a0 as DrawingLabel, a5 as DrawingPolyline, a2 as DrawingLinefill, aa as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, w as DrawingTypeKey, v as SnapMode, a3 as DrawingMode, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, s as DataWindowReadout, n as SymbolPickerFn, aW as PaneInfo, ad as DrawingsOption, a7 as DrawingSeriesGateway, D as Drawing, b as VelaOptions, y as AddIndicatorOptions, at as MarketSwitch, as as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-bdSAtp7y.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-xH2VBcFT.cjs';
+import { u as Millis, aj as InputSchema, ah as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, av as PaneAxis, aI as SeriesSpec, af as Fill, B as Background, aA as PriceLine, a2 as DrawingLine, _ as DrawingBox, a1 as DrawingLabel, a6 as DrawingPolyline, a3 as DrawingLinefill, ab as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, w as DrawingTypeKey, v as SnapMode, a4 as DrawingMode, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, s as DataWindowReadout, n as SymbolPickerFn, aX as PaneInfo, ae as DrawingsOption, a8 as DrawingSeriesGateway, D as Drawing, b as VelaOptions, y as AddIndicatorOptions, au as MarketSwitch, at as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-CX1lSYWA.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-OfR3fXg9.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script

package/dist/{contributions-CoAX7_SF.d.ts → contributions-Swzz10fG.d.ts}

@@ -1,5 +1,5 @@
-import { u as Millis, ai as InputSchema, ag as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, au as PaneAxis, aH as SeriesSpec, ae as Fill, B as Background, az as PriceLine, a1 as DrawingLine, Z as DrawingBox, a0 as DrawingLabel, a5 as DrawingPolyline, a2 as DrawingLinefill, aa as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, w as DrawingTypeKey, v as SnapMode, a3 as DrawingMode, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, s as DataWindowReadout, n as SymbolPickerFn, aW as PaneInfo, ad as DrawingsOption, a7 as DrawingSeriesGateway, D as Drawing, b as VelaOptions, y as AddIndicatorOptions, at as MarketSwitch, as as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-bdSAtp7y.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-XLdJB86x.js';
+import { u as Millis, aj as InputSchema, ah as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, av as PaneAxis, aI as SeriesSpec, af as Fill, B as Background, aA as PriceLine, a2 as DrawingLine, _ as DrawingBox, a1 as DrawingLabel, a6 as DrawingPolyline, a3 as DrawingLinefill, ab as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, w as DrawingTypeKey, v as SnapMode, a4 as DrawingMode, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, s as DataWindowReadout, n as SymbolPickerFn, aX as PaneInfo, ae as DrawingsOption, a8 as DrawingSeriesGateway, D as Drawing, b as VelaOptions, y as AddIndicatorOptions, au as MarketSwitch, at as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-CX1lSYWA.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-B-Jz59Rf.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script