@luxalgo/vela 0.5.0 → 0.5.1

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { D as DrawingsDocument, R as Resolved } from './contributions-o1GRKPI_.cjs';
-export { B as BarsChangeReason, C as ContextSelect, b as DataControl, c as DrawingsControl, E as EngineAlert, d as EngineCapabilities, e as EngineContextSnapshot, f as EngineFactory, g as EngineWarning, h as ExecutionHandlers, i as ExecutionMarket, j as ExecutionRequest, k as ExecutionSession, F as FetchSeries, l as IndicatorEventMap, I as IndicatorHandle, m as IndicatorSummary, L as LegendActionDescriptor, n as LegendIndicatorInfo, N as NativeIndicator, o as NativeIndicatorContext, p as NativeIndicatorDescriptor, q as NativeIndicatorInfo, r as NativeIndicatorOutput, P as ParsedSymbol, s as PreparedScript, t as RendererControl, u as RunIndicatorResult, v as SceneInspection, a as ScriptRun, w as ScriptRunCause, x as ScriptRunResult, S as ScriptingEngine, y as SidePanelButton, z as SidePanelDescriptor, A as SidePanelHandle, G as SidePanelHeader, H as StrategyFill, J as StrategyState, K as StrategyTrade, T as TypedEventBus, V as Vela, M as VelaDeps, O as VelaEventMap, Q as VisibleBarRange, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, W as WidgetContext, Z as getNativeIndicator, _ as legendActions, $ as nativeIndicatorDescriptors, a0 as nativeIndicatorTypes, a1 as registerDefaultEngine, a2 as registerLegendAction, a3 as registerNativeIndicator, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a7 as resolveEngines, a8 as sidePanels, a9 as unregisterDefaultEngine, aa as unregisterLegendAction, ab as unregisterNativeIndicator, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-o1GRKPI_.cjs';
-import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, d as RendererDisplayOptions, e as IndicatorRenderHandle, f as IndicatorStatus, c as VelaTheme, O as OHLCV, g as Pane, h as PaneAction, i as MoveTarget, j as IndicatorModel, k as ScenePatch, l as InputValue, m as SymbolPickerFn, n as LegendActionView, o as InputChangeEvent, T as ThemeName, C as CrosshairEvent, p as ClickEvent, a as VisibleRange, q as DataWindowReadout, r as IDrawingsRendererPort, s as Millis, t as SnapMode, u as DrawingTypeKey, v as ToolbarDefinition, M as MarketConfig } from './options-Q-576hIi.cjs';
-export { A as AddIndicatorOptions, B as Background, w as BoxFontFamily, x as BoxHAlign, y as BoxTextSize, z as BoxVAlign, E as CandleBarColor, F as CandleSeries, G as CandleStyle, H as DataWindowGroup, J as DataWindowOHLC, K as DataWindowRow, Q as DirtyRange, W as DrawingBox, X as DrawingExtend, Y as DrawingIntent, Z as DrawingLabel, _ as DrawingLine, $ as DrawingLinefill, a0 as DrawingMode, a1 as DrawingPoint, a2 as DrawingPolyline, a3 as DrawingStyle, a4 as DrawingTable, a5 as DrawingText, a6 as DrawingXLoc, a7 as DrawingsOption, a8 as Fill, a9 as FillGradientStop, aa as IndicatorMeta, ab as InputSchema, ac as InputType, ad as LabelStyle, ae as LabelYLoc, af as LineLikeKind, ag as LineLikeSeries, ah as LineLikeStyle, ai as MarkerPoint, aj as MarkerSeries, ak as MarketSnapshot, al as MarketSwitch, am as PaneHint, an as PaneKind, ao as PolylinePoint, ap as PriceLine, aq as Projector, ar as ProviderName, as as RendererConstructor, at as Scene, au as SchemaPatch, av as SeriesKind, aw as SeriesPoint, ax as SeriesSpec, ay as SeriesValueDelta, az as SettingsField, aA as SettingsSchema, aB as TableCell, aC as TableMerge, aD as TablePosition, aE as ToolbarGroupConfig, aF as TradeExecution, aG as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aH as buildToolbar, aI as defaultToolbar } from './options-Q-576hIi.cjs';
-import { M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, S as SymbolInfo, b as ProviderCapabilities, B as BarRange } from './DataProvider-DKNDHpNv.cjs';
-export { A as ACCENT, a as ACCENT_BRIGHT, B as BEARISH, b as BULLISH, c as BarTransform, C as CATEGORICAL, d as CROSSHAIR, e as ChartTypeDefinition, f as ChartTypeSettingsSection, D as DrawingTypeMeta, H as HIGHLIGHT, I as INFO, g as INVALID, h as IdentifiableKind, M as MARKER, N as NEUTRAL, R as RendererLayerArgs, i as RendererLayerDefinition, j as RendererLayerInstance, S as SERIES_LINE, k as SESSION_OFF, l as SESSION_POST, m as SESSION_PRE, n as SLATE, o as SLATE_DEEP, p as SeriesDataEngine, q as SeriesDataEngineHost, r as SettingsRowDescriptor, T as TRADE_EXIT, s as TRADE_LONG, t as TRADE_SHORT, V as VALID, W as WARNING, u as categoricalColor, v as chartType, w as chartTypes, x as createDrawing, y as deserializeDrawing, z as drawingTypes, E as getDrawingType, F as registerChartType, G as registerDrawingType, J as registerRendererDefaults, K as registerRendererLayer, L as rendererDefaults, O as rendererLayers, P as stableSeriesId, Q as tickerModifierIds, U as unregisterChartType, X as unregisterRendererDefaults, Y as unregisterRendererLayer } from './plugin-D94muTV-.cjs';
+import { D as DrawingsDocument, R as Resolved } from './contributions-BlV3kb0O.cjs';
+export { B as BarsChangeReason, C as ContextSelect, b as DataControl, c as DrawingsControl, E as EngineAlert, d as EngineCapabilities, e as EngineContextSnapshot, f as EngineFactory, g as EngineWarning, h as ExecutionHandlers, i as ExecutionMarket, j as ExecutionRequest, k as ExecutionSession, F as FetchSeries, l as IndicatorEventMap, I as IndicatorHandle, m as IndicatorSummary, L as LegendActionDescriptor, n as LegendIndicatorInfo, N as NativeIndicator, o as NativeIndicatorContext, p as NativeIndicatorDescriptor, q as NativeIndicatorInfo, r as NativeIndicatorOutput, P as ParsedSymbol, s as PreparedScript, t as RendererControl, u as RunIndicatorResult, v as SceneInspection, a as ScriptRun, w as ScriptRunCause, x as ScriptRunResult, S as ScriptingEngine, y as SidePanelButton, z as SidePanelDescriptor, A as SidePanelHandle, G as SidePanelHeader, H as StrategyFill, J as StrategyState, K as StrategyTrade, T as TypedEventBus, V as Vela, M as VelaDeps, O as VelaEventMap, Q as VisibleBarRange, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, W as WidgetContext, Z as getNativeIndicator, _ as legendActions, $ as nativeIndicatorDescriptors, a0 as nativeIndicatorTypes, a1 as registerDefaultEngine, a2 as registerLegendAction, a3 as registerNativeIndicator, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a7 as resolveEngines, a8 as sidePanels, a9 as unregisterDefaultEngine, aa as unregisterLegendAction, ab as unregisterNativeIndicator, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-BlV3kb0O.cjs';
+import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, d as RendererDisplayOptions, e as IndicatorRenderHandle, f as IndicatorStatus, c as VelaTheme, O as OHLCV, g as Pane, h as PaneAction, i as MoveTarget, j as IndicatorModel, k as ScenePatch, l as InputValue, m as SymbolPickerFn, n as LegendActionView, o as InputChangeEvent, T as ThemeName, C as CrosshairEvent, p as ClickEvent, a as VisibleRange, q as DataWindowReadout, r as IDrawingsRendererPort, s as Millis, t as SnapMode, u as DrawingTypeKey, v as ToolbarDefinition, M as MarketConfig } from './options-DbQholFV.cjs';
+export { A as AddIndicatorOptions, B as Background, w as BoxFontFamily, x as BoxHAlign, y as BoxTextSize, z as BoxVAlign, E as CandleBarColor, F as CandleSeries, G as CandleStyle, H as DataWindowGroup, J as DataWindowOHLC, K as DataWindowRow, Q as DirtyRange, W as DrawingBox, X as DrawingExtend, Y as DrawingIntent, Z as DrawingLabel, _ as DrawingLine, $ as DrawingLinefill, a0 as DrawingMode, a1 as DrawingPoint, a2 as DrawingPolyline, a3 as DrawingStyle, a4 as DrawingTable, a5 as DrawingText, a6 as DrawingXLoc, a7 as DrawingsOption, a8 as Fill, a9 as FillGradientStop, aa as IndicatorMeta, ab as InputSchema, ac as InputType, ad as LabelStyle, ae as LabelYLoc, af as LineLikeKind, ag as LineLikeSeries, ah as LineLikeStyle, ai as MarkerPoint, aj as MarkerSeries, ak as MarketSnapshot, al as MarketSwitch, am as PaneHint, an as PaneKind, ao as PolylinePoint, ap as PriceLine, aq as Projector, ar as ProviderName, as as RendererConstructor, at as Scene, au as SchemaPatch, av as SeriesKind, aw as SeriesPoint, ax as SeriesSpec, ay as SeriesValueDelta, az as SettingsField, aA as SettingsSchema, aB as TableCell, aC as TableMerge, aD as TablePosition, aE as ToolbarGroupConfig, aF as TradeExecution, aG as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aH as buildToolbar, aI as defaultToolbar } from './options-DbQholFV.cjs';
+import { M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, S as SymbolInfo, b as ProviderCapabilities, B as BarRange } from './DataProvider-BBQ3Hr21.cjs';
+export { A as ACCENT, a as ACCENT_BRIGHT, B as BEARISH, b as BULLISH, c as BarTransform, d as BasePaintingModulation, C as CATEGORICAL, e as CROSSHAIR, f as ChartTypeDefinition, g as ChartTypeSettingsInstance, h as ChartTypeSettingsSection, i as ChartTypeSettingsSubsection, D as DrawingTypeMeta, H as HIGHLIGHT, I as INFO, j as INVALID, k as IdentifiableKind, M as MARKER, N as NEUTRAL, R as RendererLayerArgs, l as RendererLayerDefinition, m as RendererLayerInstance, S as SERIES_LINE, n as SESSION_OFF, o as SESSION_POST, p as SESSION_PRE, q as SLATE, r as SLATE_DEEP, s as SeriesDataEngine, t as SeriesDataEngineHost, u as SettingsRowCondition, v as SettingsRowDescriptor, w as SettingsRowSwatch, x as SettingsRowWhen, y as SettingsSelectOption, T as TRADE_EXIT, z as TRADE_LONG, E as TRADE_SHORT, V as VALID, W as WARNING, F as categoricalColor, G as chartType, J as chartTypes, K as createDrawing, L as deserializeDrawing, O as drawingTypes, P as getDrawingType, Q as registerChartType, U as registerDrawingType, X as registerRendererDefaults, Y as registerRendererLayer, Z as rendererDefaults, _ as rendererLayers, $ as stableSeriesId, a0 as tickerModifierIds, a1 as unregisterChartType, a2 as unregisterRendererDefaults, a3 as unregisterRendererLayer } from './plugin-O34MbXf-.cjs';
 export { D as DEFAULT_PANEL_MAX_WIDTH, a as DEFAULT_PANEL_MIN_WIDTH, b as DEFAULT_PANEL_WIDTH, S as SidePanelOptions, c as clampPanelWidth } from './side-panel-CT9ZwIGz.cjs';
 export { i as iconMarkup, r as registerIcon } from './icons-BZYbJXSV.cjs';
 export { a as KeyBindingDescriptor, R as ResolvedBinding } from './keymap-CGOz5F5f.cjs';
@@ -543,6 +543,10 @@ declare class NativeRenderer implements IChartRenderer {
      *  but pinned to the stable surface background, text, and border, so custom plot cosmetics
      *  never recolor the toolbar, gutters, or drawing UI chrome. */
     private chromeTheme;
+    /** The colors the axis-scale gutters (price + time) paint with: the LIVE chart background
+     *  (`layout.background`) and its contrast-corrected text, so the scales read as part of the
+     *  plot. Only the toolbar/dialog chrome stays on the stable app-theme surface. */
+    private axisSurface;
     mount(container: HTMLElement, theme: VelaTheme): void;
     /**
      * Create + mount the L0 geometry backend and return its canvas. Picks WebGL2
@@ -741,6 +745,10 @@ declare class NativeRenderer implements IChartRenderer {
     /** One group per indicator (name = indicator title), each with a row per drawable plot. */
     private dataWindowGroups;
     private renderFrame;
+    /** Repaint the SDK layers that opted into cursor tracking (their own canvas only). */
+    private repaintCursorLayers;
+    /** One frame's args for an SDK renderer layer (shared by the data + cursor paint paths). */
+    private extLayerArgs;
     /** Paint the below-data (L-1) + geometry (L0) + chrome (L1) layers from the current scene/coords. */
     private paintData;
     /** Build the data→pixel projector user drawings resolve their anchors through. */
@@ -838,10 +846,12 @@ declare class NativeRenderer implements IChartRenderer {
     private collapsedMasterMap;
     /** Reserve `px` of left gutter for the docked drawings toolbar (0 releases it) + re-lay-out the plot. */
     private setToolbarGutter;
-    /** Publish the gutter on the mount container as `--vela-toolbar-gutter`, so host
-     *  overlays sharing that container (a status line, a custom legend) can anchor to
-     *  the plot's left edge without reaching into the renderer's DOM. */
-    private publishToolbarGutter;
+    /** Publish the gutters on the mount container as `--vela-toolbar-gutter` (left,
+     *  drawings toolbar) and `--vela-scale-gutter` (right, the full price-scale width
+     *  incl. merged own-scale columns), so host overlays sharing that container (a
+     *  status line, a watermark, a custom legend) can anchor to the plot's edges
+     *  without reaching into the renderer's DOM. */
+    private publishGutters;
     /** The built-in mark, or the host's own when one is set. */
     private buildAttributionEl;
     /** Swap the mark in place — the content kind changed (built-in ↔ host-supplied). */
@@ -871,6 +881,11 @@ interface DrawingToolbarOptions {
     /** Collapse/expand notification — a docked host resizes its gutter reservation to
      *  {@link TOOLBAR_COLLAPSED_WIDTH} / the full width (a static bar reflows on its own). */
     onCollapse?: (collapsed: boolean) => void;
+    /** When given, a drawings-sync toggle renders below the stay button: enabled, every
+     *  NEWLY CREATED drawing is copied onto the other linked charts and the set stays
+     *  linked — edits and removals follow (a multi-chart host's concern — a
+     *  single-chart bar omits the callback and never shows it). */
+    onDrawingsSync?: (on: boolean) => void;
 }
 /**
  * The vertical drawing toolbar (renderer chrome), docked as a flush bar in the left gutter. Each
@@ -879,8 +894,10 @@ interface DrawingToolbarOptions {
  * cursor button returns to select/idle; measure/eraser modes sit at the bottom, and the magnet is a
  * cell whose chevron opens an Off/Weak/Strong menu (its icon toggles the last-used strength on/off).
  * Below the magnet, a stay-in-drawing-mode toggle keeps tools armed after each placement.
- * Hover and active tints are CSS-driven (`:hover` + `[data-active]`) so they never lag. Tooltips
- * appear after a 2s hover. Pure vanilla DOM on the host (a `pointer-events:auto` island).
+ * Hover and active tints are CSS-driven (`:hover` + `[data-active]`) so they never lag. Every
+ * icon carries a themed tooltip (the chrome default 700ms dwell); a group cell's tip names the
+ * tool its icon arms (the last-used one). Pure vanilla DOM on the host (a `pointer-events:auto`
+ * island).
  */
 declare class DrawingToolbar {
     private readonly host;
@@ -917,6 +934,8 @@ declare class DrawingToolbar {
     private eraserActive;
     private stayBtn;
     private stayActive;
+    private syncBtn;
+    private syncActive;
     private collapseBtn;
     private collapsed;
     private visible;
@@ -928,6 +947,7 @@ declare class DrawingToolbar {
     private readonly width;
     private readonly dock;
     private readonly onCollapse;
+    private readonly onDrawingsSync;
     constructor(host: HTMLElement, theme: VelaTheme, onArm: (type: DrawingTypeKey | null) => void, onMagnet?: (mode: SnapMode) => void, onMeasure?: () => void, onEraser?: () => void, onToggleFavorite?: (type: DrawingTypeKey, on: boolean) => void, onStayMode?: (on: boolean) => void, options?: DrawingToolbarOptions);
     /** Live divider/border ink — the option override, else the current theme's border
      *  (so a theme swap re-inks the bar without a rebuild option). */
@@ -986,6 +1006,11 @@ declare class DrawingToolbar {
     /** Reflect stay-in-drawing-mode externally without notifying back. */
     setStayMode(on: boolean): void;
     private paintStay;
+    /** Toggle drawings sync on/off and notify the host. */
+    private toggleDrawingsSync;
+    /** Reflect drawings sync externally (e.g. set through the API) without notifying back. */
+    setDrawingsSyncMode(on: boolean): void;
+    private paintDrawingsSync;
     /** Create the positioned flyout panel anchored to a cell, register it as open, and start the
      *  outside-dismiss. Callers fill it with items. */
     private beginFlyout;

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { D as DrawingsDocument, R as Resolved } from './contributions-hX3EUyjG.js';
-export { B as BarsChangeReason, C as ContextSelect, b as DataControl, c as DrawingsControl, E as EngineAlert, d as EngineCapabilities, e as EngineContextSnapshot, f as EngineFactory, g as EngineWarning, h as ExecutionHandlers, i as ExecutionMarket, j as ExecutionRequest, k as ExecutionSession, F as FetchSeries, l as IndicatorEventMap, I as IndicatorHandle, m as IndicatorSummary, L as LegendActionDescriptor, n as LegendIndicatorInfo, N as NativeIndicator, o as NativeIndicatorContext, p as NativeIndicatorDescriptor, q as NativeIndicatorInfo, r as NativeIndicatorOutput, P as ParsedSymbol, s as PreparedScript, t as RendererControl, u as RunIndicatorResult, v as SceneInspection, a as ScriptRun, w as ScriptRunCause, x as ScriptRunResult, S as ScriptingEngine, y as SidePanelButton, z as SidePanelDescriptor, A as SidePanelHandle, G as SidePanelHeader, H as StrategyFill, J as StrategyState, K as StrategyTrade, T as TypedEventBus, V as Vela, M as VelaDeps, O as VelaEventMap, Q as VisibleBarRange, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, W as WidgetContext, Z as getNativeIndicator, _ as legendActions, $ as nativeIndicatorDescriptors, a0 as nativeIndicatorTypes, a1 as registerDefaultEngine, a2 as registerLegendAction, a3 as registerNativeIndicator, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a7 as resolveEngines, a8 as sidePanels, a9 as unregisterDefaultEngine, aa as unregisterLegendAction, ab as unregisterNativeIndicator, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-hX3EUyjG.js';
-import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, d as RendererDisplayOptions, e as IndicatorRenderHandle, f as IndicatorStatus, c as VelaTheme, O as OHLCV, g as Pane, h as PaneAction, i as MoveTarget, j as IndicatorModel, k as ScenePatch, l as InputValue, m as SymbolPickerFn, n as LegendActionView, o as InputChangeEvent, T as ThemeName, C as CrosshairEvent, p as ClickEvent, a as VisibleRange, q as DataWindowReadout, r as IDrawingsRendererPort, s as Millis, t as SnapMode, u as DrawingTypeKey, v as ToolbarDefinition, M as MarketConfig } from './options-Q-576hIi.js';
-export { A as AddIndicatorOptions, B as Background, w as BoxFontFamily, x as BoxHAlign, y as BoxTextSize, z as BoxVAlign, E as CandleBarColor, F as CandleSeries, G as CandleStyle, H as DataWindowGroup, J as DataWindowOHLC, K as DataWindowRow, Q as DirtyRange, W as DrawingBox, X as DrawingExtend, Y as DrawingIntent, Z as DrawingLabel, _ as DrawingLine, $ as DrawingLinefill, a0 as DrawingMode, a1 as DrawingPoint, a2 as DrawingPolyline, a3 as DrawingStyle, a4 as DrawingTable, a5 as DrawingText, a6 as DrawingXLoc, a7 as DrawingsOption, a8 as Fill, a9 as FillGradientStop, aa as IndicatorMeta, ab as InputSchema, ac as InputType, ad as LabelStyle, ae as LabelYLoc, af as LineLikeKind, ag as LineLikeSeries, ah as LineLikeStyle, ai as MarkerPoint, aj as MarkerSeries, ak as MarketSnapshot, al as MarketSwitch, am as PaneHint, an as PaneKind, ao as PolylinePoint, ap as PriceLine, aq as Projector, ar as ProviderName, as as RendererConstructor, at as Scene, au as SchemaPatch, av as SeriesKind, aw as SeriesPoint, ax as SeriesSpec, ay as SeriesValueDelta, az as SettingsField, aA as SettingsSchema, aB as TableCell, aC as TableMerge, aD as TablePosition, aE as ToolbarGroupConfig, aF as TradeExecution, aG as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aH as buildToolbar, aI as defaultToolbar } from './options-Q-576hIi.js';
-import { M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, S as SymbolInfo, b as ProviderCapabilities, B as BarRange } from './DataProvider-Dzd-Erlk.js';
-export { A as ACCENT, a as ACCENT_BRIGHT, B as BEARISH, b as BULLISH, c as BarTransform, C as CATEGORICAL, d as CROSSHAIR, e as ChartTypeDefinition, f as ChartTypeSettingsSection, D as DrawingTypeMeta, H as HIGHLIGHT, I as INFO, g as INVALID, h as IdentifiableKind, M as MARKER, N as NEUTRAL, R as RendererLayerArgs, i as RendererLayerDefinition, j as RendererLayerInstance, S as SERIES_LINE, k as SESSION_OFF, l as SESSION_POST, m as SESSION_PRE, n as SLATE, o as SLATE_DEEP, p as SeriesDataEngine, q as SeriesDataEngineHost, r as SettingsRowDescriptor, T as TRADE_EXIT, s as TRADE_LONG, t as TRADE_SHORT, V as VALID, W as WARNING, u as categoricalColor, v as chartType, w as chartTypes, x as createDrawing, y as deserializeDrawing, z as drawingTypes, E as getDrawingType, F as registerChartType, G as registerDrawingType, J as registerRendererDefaults, K as registerRendererLayer, L as rendererDefaults, O as rendererLayers, P as stableSeriesId, Q as tickerModifierIds, U as unregisterChartType, X as unregisterRendererDefaults, Y as unregisterRendererLayer } from './plugin-aGUD1epn.js';
+import { D as DrawingsDocument, R as Resolved } from './contributions-6N0rbrPC.js';
+export { B as BarsChangeReason, C as ContextSelect, b as DataControl, c as DrawingsControl, E as EngineAlert, d as EngineCapabilities, e as EngineContextSnapshot, f as EngineFactory, g as EngineWarning, h as ExecutionHandlers, i as ExecutionMarket, j as ExecutionRequest, k as ExecutionSession, F as FetchSeries, l as IndicatorEventMap, I as IndicatorHandle, m as IndicatorSummary, L as LegendActionDescriptor, n as LegendIndicatorInfo, N as NativeIndicator, o as NativeIndicatorContext, p as NativeIndicatorDescriptor, q as NativeIndicatorInfo, r as NativeIndicatorOutput, P as ParsedSymbol, s as PreparedScript, t as RendererControl, u as RunIndicatorResult, v as SceneInspection, a as ScriptRun, w as ScriptRunCause, x as ScriptRunResult, S as ScriptingEngine, y as SidePanelButton, z as SidePanelDescriptor, A as SidePanelHandle, G as SidePanelHeader, H as StrategyFill, J as StrategyState, K as StrategyTrade, T as TypedEventBus, V as Vela, M as VelaDeps, O as VelaEventMap, Q as VisibleBarRange, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, W as WidgetContext, Z as getNativeIndicator, _ as legendActions, $ as nativeIndicatorDescriptors, a0 as nativeIndicatorTypes, a1 as registerDefaultEngine, a2 as registerLegendAction, a3 as registerNativeIndicator, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a7 as resolveEngines, a8 as sidePanels, a9 as unregisterDefaultEngine, aa as unregisterLegendAction, ab as unregisterNativeIndicator, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-6N0rbrPC.js';
+import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, d as RendererDisplayOptions, e as IndicatorRenderHandle, f as IndicatorStatus, c as VelaTheme, O as OHLCV, g as Pane, h as PaneAction, i as MoveTarget, j as IndicatorModel, k as ScenePatch, l as InputValue, m as SymbolPickerFn, n as LegendActionView, o as InputChangeEvent, T as ThemeName, C as CrosshairEvent, p as ClickEvent, a as VisibleRange, q as DataWindowReadout, r as IDrawingsRendererPort, s as Millis, t as SnapMode, u as DrawingTypeKey, v as ToolbarDefinition, M as MarketConfig } from './options-DbQholFV.js';
+export { A as AddIndicatorOptions, B as Background, w as BoxFontFamily, x as BoxHAlign, y as BoxTextSize, z as BoxVAlign, E as CandleBarColor, F as CandleSeries, G as CandleStyle, H as DataWindowGroup, J as DataWindowOHLC, K as DataWindowRow, Q as DirtyRange, W as DrawingBox, X as DrawingExtend, Y as DrawingIntent, Z as DrawingLabel, _ as DrawingLine, $ as DrawingLinefill, a0 as DrawingMode, a1 as DrawingPoint, a2 as DrawingPolyline, a3 as DrawingStyle, a4 as DrawingTable, a5 as DrawingText, a6 as DrawingXLoc, a7 as DrawingsOption, a8 as Fill, a9 as FillGradientStop, aa as IndicatorMeta, ab as InputSchema, ac as InputType, ad as LabelStyle, ae as LabelYLoc, af as LineLikeKind, ag as LineLikeSeries, ah as LineLikeStyle, ai as MarkerPoint, aj as MarkerSeries, ak as MarketSnapshot, al as MarketSwitch, am as PaneHint, an as PaneKind, ao as PolylinePoint, ap as PriceLine, aq as Projector, ar as ProviderName, as as RendererConstructor, at as Scene, au as SchemaPatch, av as SeriesKind, aw as SeriesPoint, ax as SeriesSpec, ay as SeriesValueDelta, az as SettingsField, aA as SettingsSchema, aB as TableCell, aC as TableMerge, aD as TablePosition, aE as ToolbarGroupConfig, aF as TradeExecution, aG as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aH as buildToolbar, aI as defaultToolbar } from './options-DbQholFV.js';
+import { M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, S as SymbolInfo, b as ProviderCapabilities, B as BarRange } from './DataProvider-DGesjOJT.js';
+export { A as ACCENT, a as ACCENT_BRIGHT, B as BEARISH, b as BULLISH, c as BarTransform, d as BasePaintingModulation, C as CATEGORICAL, e as CROSSHAIR, f as ChartTypeDefinition, g as ChartTypeSettingsInstance, h as ChartTypeSettingsSection, i as ChartTypeSettingsSubsection, D as DrawingTypeMeta, H as HIGHLIGHT, I as INFO, j as INVALID, k as IdentifiableKind, M as MARKER, N as NEUTRAL, R as RendererLayerArgs, l as RendererLayerDefinition, m as RendererLayerInstance, S as SERIES_LINE, n as SESSION_OFF, o as SESSION_POST, p as SESSION_PRE, q as SLATE, r as SLATE_DEEP, s as SeriesDataEngine, t as SeriesDataEngineHost, u as SettingsRowCondition, v as SettingsRowDescriptor, w as SettingsRowSwatch, x as SettingsRowWhen, y as SettingsSelectOption, T as TRADE_EXIT, z as TRADE_LONG, E as TRADE_SHORT, V as VALID, W as WARNING, F as categoricalColor, G as chartType, J as chartTypes, K as createDrawing, L as deserializeDrawing, O as drawingTypes, P as getDrawingType, Q as registerChartType, U as registerDrawingType, X as registerRendererDefaults, Y as registerRendererLayer, Z as rendererDefaults, _ as rendererLayers, $ as stableSeriesId, a0 as tickerModifierIds, a1 as unregisterChartType, a2 as unregisterRendererDefaults, a3 as unregisterRendererLayer } from './plugin-TN3n-9YN.js';
 export { D as DEFAULT_PANEL_MAX_WIDTH, a as DEFAULT_PANEL_MIN_WIDTH, b as DEFAULT_PANEL_WIDTH, S as SidePanelOptions, c as clampPanelWidth } from './side-panel-CT9ZwIGz.js';
 export { i as iconMarkup, r as registerIcon } from './icons-BZYbJXSV.js';
 export { a as KeyBindingDescriptor, R as ResolvedBinding } from './keymap-CGOz5F5f.js';
@@ -543,6 +543,10 @@ declare class NativeRenderer implements IChartRenderer {
      *  but pinned to the stable surface background, text, and border, so custom plot cosmetics
      *  never recolor the toolbar, gutters, or drawing UI chrome. */
     private chromeTheme;
+    /** The colors the axis-scale gutters (price + time) paint with: the LIVE chart background
+     *  (`layout.background`) and its contrast-corrected text, so the scales read as part of the
+     *  plot. Only the toolbar/dialog chrome stays on the stable app-theme surface. */
+    private axisSurface;
     mount(container: HTMLElement, theme: VelaTheme): void;
     /**
      * Create + mount the L0 geometry backend and return its canvas. Picks WebGL2
@@ -741,6 +745,10 @@ declare class NativeRenderer implements IChartRenderer {
     /** One group per indicator (name = indicator title), each with a row per drawable plot. */
     private dataWindowGroups;
     private renderFrame;
+    /** Repaint the SDK layers that opted into cursor tracking (their own canvas only). */
+    private repaintCursorLayers;
+    /** One frame's args for an SDK renderer layer (shared by the data + cursor paint paths). */
+    private extLayerArgs;
     /** Paint the below-data (L-1) + geometry (L0) + chrome (L1) layers from the current scene/coords. */
     private paintData;
     /** Build the data→pixel projector user drawings resolve their anchors through. */
@@ -838,10 +846,12 @@ declare class NativeRenderer implements IChartRenderer {
     private collapsedMasterMap;
     /** Reserve `px` of left gutter for the docked drawings toolbar (0 releases it) + re-lay-out the plot. */
     private setToolbarGutter;
-    /** Publish the gutter on the mount container as `--vela-toolbar-gutter`, so host
-     *  overlays sharing that container (a status line, a custom legend) can anchor to
-     *  the plot's left edge without reaching into the renderer's DOM. */
-    private publishToolbarGutter;
+    /** Publish the gutters on the mount container as `--vela-toolbar-gutter` (left,
+     *  drawings toolbar) and `--vela-scale-gutter` (right, the full price-scale width
+     *  incl. merged own-scale columns), so host overlays sharing that container (a
+     *  status line, a watermark, a custom legend) can anchor to the plot's edges
+     *  without reaching into the renderer's DOM. */
+    private publishGutters;
     /** The built-in mark, or the host's own when one is set. */
     private buildAttributionEl;
     /** Swap the mark in place — the content kind changed (built-in ↔ host-supplied). */
@@ -871,6 +881,11 @@ interface DrawingToolbarOptions {
     /** Collapse/expand notification — a docked host resizes its gutter reservation to
      *  {@link TOOLBAR_COLLAPSED_WIDTH} / the full width (a static bar reflows on its own). */
     onCollapse?: (collapsed: boolean) => void;
+    /** When given, a drawings-sync toggle renders below the stay button: enabled, every
+     *  NEWLY CREATED drawing is copied onto the other linked charts and the set stays
+     *  linked — edits and removals follow (a multi-chart host's concern — a
+     *  single-chart bar omits the callback and never shows it). */
+    onDrawingsSync?: (on: boolean) => void;
 }
 /**
  * The vertical drawing toolbar (renderer chrome), docked as a flush bar in the left gutter. Each
@@ -879,8 +894,10 @@ interface DrawingToolbarOptions {
  * cursor button returns to select/idle; measure/eraser modes sit at the bottom, and the magnet is a
  * cell whose chevron opens an Off/Weak/Strong menu (its icon toggles the last-used strength on/off).
  * Below the magnet, a stay-in-drawing-mode toggle keeps tools armed after each placement.
- * Hover and active tints are CSS-driven (`:hover` + `[data-active]`) so they never lag. Tooltips
- * appear after a 2s hover. Pure vanilla DOM on the host (a `pointer-events:auto` island).
+ * Hover and active tints are CSS-driven (`:hover` + `[data-active]`) so they never lag. Every
+ * icon carries a themed tooltip (the chrome default 700ms dwell); a group cell's tip names the
+ * tool its icon arms (the last-used one). Pure vanilla DOM on the host (a `pointer-events:auto`
+ * island).
  */
 declare class DrawingToolbar {
     private readonly host;
@@ -917,6 +934,8 @@ declare class DrawingToolbar {
     private eraserActive;
     private stayBtn;
     private stayActive;
+    private syncBtn;
+    private syncActive;
     private collapseBtn;
     private collapsed;
     private visible;
@@ -928,6 +947,7 @@ declare class DrawingToolbar {
     private readonly width;
     private readonly dock;
     private readonly onCollapse;
+    private readonly onDrawingsSync;
     constructor(host: HTMLElement, theme: VelaTheme, onArm: (type: DrawingTypeKey | null) => void, onMagnet?: (mode: SnapMode) => void, onMeasure?: () => void, onEraser?: () => void, onToggleFavorite?: (type: DrawingTypeKey, on: boolean) => void, onStayMode?: (on: boolean) => void, options?: DrawingToolbarOptions);
     /** Live divider/border ink — the option override, else the current theme's border
      *  (so a theme swap re-inks the bar without a rebuild option). */
@@ -986,6 +1006,11 @@ declare class DrawingToolbar {
     /** Reflect stay-in-drawing-mode externally without notifying back. */
     setStayMode(on: boolean): void;
     private paintStay;
+    /** Toggle drawings sync on/off and notify the host. */
+    private toggleDrawingsSync;
+    /** Reflect drawings sync externally (e.g. set through the API) without notifying back. */
+    setDrawingsSyncMode(on: boolean): void;
+    private paintDrawingsSync;
     /** Create the positioned flyout panel anchored to a cell, register it as open, and start the
      *  outside-dismiss. Callers fill it with items. */
     private beginFlyout;

package/dist/index.js

@@ -1,5 +1,5 @@
 export { stableSeriesId } from './chunk-Q3XQHLIH.js';
-export { BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TypedEventBus, Vela, buildToolbar, defaultToolbar, resolveTheme, sharedBarStore, timeframeToMs } from './chunk-KCCZNKH7.js';
-export { DEFAULT_PANEL_MAX_WIDTH, DEFAULT_PANEL_MIN_WIDTH, DEFAULT_PANEL_WIDTH, Drawing, chartType, chartTypes, clampPanelWidth, createDrawing, deserializeDrawing, drawingTypes, getDrawingType, getNativeIndicator, legendActions, nativeIndicatorDescriptors, nativeIndicatorTypes, registerChartType, registerDefaultEngine, registerDrawingType, registerLegendAction, registerNativeIndicator, registerRendererDefaults, registerRendererLayer, registerSidePanel, registerWidgetAction, registerWidgetAttachment, rendererDefaults, rendererLayers, resolveEngines, sidePanels, tickerModifierIds, unregisterChartType, unregisterDefaultEngine, unregisterLegendAction, unregisterNativeIndicator, unregisterRendererDefaults, unregisterRendererLayer, unregisterSidePanel, unregisterWidgetAction, unregisterWidgetAttachment, widgetActions, widgetAttachments } from './chunk-7UFX5ZIG.js';
-import './chunk-KM6LHB3Y.js';
-export { ACCENT, ACCENT_BRIGHT, BEARISH, BULLISH, CATEGORICAL, CROSSHAIR, HIGHLIGHT, INFO, INVALID, MARKER, NEUTRAL, SERIES_LINE, SESSION_OFF, SESSION_POST, SESSION_PRE, SLATE, SLATE_DEEP, TRADE_EXIT, TRADE_LONG, TRADE_SHORT, VALID, WARNING, categoricalColor, iconMarkup, registerIcon } from './chunk-GYD2THPV.js';
+export { BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TypedEventBus, Vela, buildToolbar, defaultToolbar, resolveTheme, sharedBarStore, timeframeToMs } from './chunk-FNOMKHEZ.js';
+export { DEFAULT_PANEL_MAX_WIDTH, DEFAULT_PANEL_MIN_WIDTH, DEFAULT_PANEL_WIDTH, Drawing, chartType, chartTypes, clampPanelWidth, createDrawing, deserializeDrawing, drawingTypes, getDrawingType, getNativeIndicator, legendActions, nativeIndicatorDescriptors, nativeIndicatorTypes, registerChartType, registerDefaultEngine, registerDrawingType, registerLegendAction, registerNativeIndicator, registerRendererDefaults, registerRendererLayer, registerSidePanel, registerWidgetAction, registerWidgetAttachment, rendererDefaults, rendererLayers, resolveEngines, sidePanels, tickerModifierIds, unregisterChartType, unregisterDefaultEngine, unregisterLegendAction, unregisterNativeIndicator, unregisterRendererDefaults, unregisterRendererLayer, unregisterSidePanel, unregisterWidgetAction, unregisterWidgetAttachment, widgetActions, widgetAttachments } from './chunk-S6F6SQ2L.js';
+import './chunk-ULIX6AE2.js';
+export { ACCENT, ACCENT_BRIGHT, BEARISH, BULLISH, CATEGORICAL, CROSSHAIR, HIGHLIGHT, INFO, INVALID, MARKER, NEUTRAL, SERIES_LINE, SESSION_OFF, SESSION_POST, SESSION_PRE, SLATE, SLATE_DEEP, TRADE_EXIT, TRADE_LONG, TRADE_SHORT, VALID, WARNING, categoricalColor, iconMarkup, registerIcon } from './chunk-EP6NDJYK.js';

package/dist/{options-Q-576hIi.d.cts → options-DbQholFV.d.cts}

@@ -885,6 +885,15 @@ type DrawingMode = 'measure' | 'eraser' | null;
 type DrawingIntent = {
     kind: 'arm';
     type: DrawingTypeKey | null;
+}
+/** Placement in progress: the ghost's current shape after every anchor click and
+ *  cursor move; `null` when placement ends (finalized OR cancelled). No store
+ *  mutation — the core only re-emits it (`drawing:draft`) so a multi-chart host
+ *  can mirror the ghost live. Optional — a renderer that never emits it simply
+ *  syncs at completion. */
+ | {
+    kind: 'draft';
+    doc: SerializedDrawing | null;
 } | {
     kind: 'create';
     doc: SerializedDrawing;
@@ -978,6 +987,11 @@ interface IDrawingsRendererPort {
     setMode?(mode: DrawingMode): void;
     /** Open a drawing's settings popup (selecting it too) — the programmatic twin of a click on it. */
     openSettings(id: string): void;
+    /** Display another chart's in-progress placement as a GHOST at reduced opacity
+     *  (`null` clears it) — the drawings-sync twin of `setExternalCrosshair`. Never a
+     *  store drawing: no selection, no hit-testing, no persistence. Optional — a
+     *  renderer without it simply never previews remote placements. */
+    setExternalGhost?(doc: SerializedDrawing | null): void;
     /**
      * The pane's SERIES stack in z terms, for renderers whose drawings share one draw-order
      * space with the series (`drawingDepth`): the extremes ("bring to front" beats `front`,

package/dist/{options-Q-576hIi.d.ts → options-DbQholFV.d.ts}

@@ -885,6 +885,15 @@ type DrawingMode = 'measure' | 'eraser' | null;
 type DrawingIntent = {
     kind: 'arm';
     type: DrawingTypeKey | null;
+}
+/** Placement in progress: the ghost's current shape after every anchor click and
+ *  cursor move; `null` when placement ends (finalized OR cancelled). No store
+ *  mutation — the core only re-emits it (`drawing:draft`) so a multi-chart host
+ *  can mirror the ghost live. Optional — a renderer that never emits it simply
+ *  syncs at completion. */
+ | {
+    kind: 'draft';
+    doc: SerializedDrawing | null;
 } | {
     kind: 'create';
     doc: SerializedDrawing;
@@ -978,6 +987,11 @@ interface IDrawingsRendererPort {
     setMode?(mode: DrawingMode): void;
     /** Open a drawing's settings popup (selecting it too) — the programmatic twin of a click on it. */
     openSettings(id: string): void;
+    /** Display another chart's in-progress placement as a GHOST at reduced opacity
+     *  (`null` clears it) — the drawings-sync twin of `setExternalCrosshair`. Never a
+     *  store drawing: no selection, no hit-testing, no persistence. Optional — a
+     *  renderer without it simply never previews remote placements. */
+    setExternalGhost?(doc: SerializedDrawing | null): void;
     /**
      * The pane's SERIES stack in z terms, for renderers whose drawings share one draw-order
      * space with the series (`drawingDepth`): the extremes ("bring to front" beats `front`,

package/dist/{plugin-D94muTV-.d.cts → plugin-O34MbXf-.d.cts}

@@ -1,9 +1,9 @@
-import { u as DrawingTypeKey, a3 as DrawingStyle, S as SerializedDrawing, D as Drawing, av as SeriesKind, O as OHLCV, c as VelaTheme } from './options-Q-576hIi.cjs';
-import { b as DataControl } from './contributions-o1GRKPI_.cjs';
+import { u as DrawingTypeKey, a3 as DrawingStyle, S as SerializedDrawing, D as Drawing, av as SeriesKind, O as OHLCV, c as VelaTheme } from './options-DbQholFV.cjs';
+import { b as DataControl } from './contributions-BlV3kb0O.cjs';
 import './side-panel-CT9ZwIGz.cjs';
 import './icons-BZYbJXSV.cjs';
 import './keymap-CGOz5F5f.cjs';
-import './DataProvider-DKNDHpNv.cjs';
+import './DataProvider-BBQ3Hr21.cjs';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
@@ -242,12 +242,70 @@ interface ChartTypeDefinition {
      */
     basePainting?: 'candles' | 'none';
 }
-/** One declarative settings row. To add a NEW kind, see docs/architecture/settings-rows.md. */
+/**
+ * A declarative visibility condition on another row's CURRENT value (stored value,
+ * or that row's `defval` while unset). Pure data — the dialog evaluates it live as
+ * the user edits, so dependent rows appear/disappear without a rebuild.
+ * `anyOf` wins over `equals` when both are given.
+ */
+interface SettingsRowCondition {
+    key: string;
+    equals?: boolean | string | number;
+    anyOf?: readonly (boolean | string | number)[];
+}
+/** A row's visibility gate: one condition, or several AND-ed together. */
+type SettingsRowWhen = SettingsRowCondition | readonly SettingsRowCondition[];
+/**
+ * An inline color swatch on a toggle row — the color(s) the toggle governs, edited
+ * right on the toggle's row (dimmed while the toggle is off) instead of a
+ * conditionally revealed row below. Each swatch stores under its own bag key.
+ */
+interface SettingsRowSwatch {
+    key: string;
+    /** Names the color for the swatch's tooltip (`'Highlight color'`). */
+    label: string;
+    defval: string;
+}
+/**
+ * One declarative settings row. To add a NEW kind, see docs/architecture/settings-rows.md.
+ *
+ * `heading` titles a GROUP of rows: the heading plus everything after it up to the next
+ * heading. In a flat `rows` section headings render as inline group titles; inside
+ * `instances`/`subsections` they become entries of the pane's group TOC (see
+ * {@link ChartTypeSettingsSection}).
+ *
+ * `header` is an in-pane subgroup title: same visual as a flat heading, but inside a
+ * structured pane it stays in the rows column (does NOT become a TOC entry). Use it to
+ * cluster rows inside a TOC group (e.g. Colors / Values under Display).
+ *
+ * Any row may carry `when` — it is shown only while the condition holds.
+ *
+ * `range` is a min–max pair on one row (two number inputs storing under `minKey` /
+ * `maxKey`, both seeded from the shared `defval`). When `placeholder` is given, an
+ * input holding the default value renders EMPTY showing the placeholder, and clearing
+ * an input stores the default back — so the placeholder names the "unset" state
+ * (`'Off'` for a 0-disables filter bound).
+ */
+/**
+ * A select option: a bare string (value = label) or a `[value, label]` pair when the
+ * stored id differs from the human-readable text (`['bidAskProfile', 'Bid × Ask Profile']`).
+ */
+type SettingsSelectOption = string | readonly [value: string, label: string];
 type SettingsRowDescriptor = {
+    kind: 'heading';
+    label: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'header';
+    label: string;
+    when?: SettingsRowWhen;
+} | {
     kind: 'toggle';
     key: string;
     label: string;
     defval: boolean;
+    colors?: readonly SettingsRowSwatch[];
+    when?: SettingsRowWhen;
 } | {
     kind: 'number';
     key: string;
@@ -256,25 +314,89 @@ type SettingsRowDescriptor = {
     min?: number;
     max?: number;
     step?: number;
+    when?: SettingsRowWhen;
 } | {
     kind: 'color';
     key: string;
     label: string;
     defval: string;
+    when?: SettingsRowWhen;
 } | {
     kind: 'select';
     key: string;
     label: string;
-    options: readonly string[];
+    options: readonly SettingsSelectOption[];
     defval: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'range';
+    label: string;
+    minKey: string;
+    maxKey: string;
+    defval: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    placeholder?: string;
+    when?: SettingsRowWhen;
 };
+/**
+ * One tab of a section's INSTANCE STRIP — a repeated block of settings (e.g. one of
+ * several overlays a style can paint). The dialog shows a tab per PRESENT instance,
+ * a dashed `+` that turns on the next absent one, and an `×` on the active removable
+ * tab that turns it off. Presence is the boolean at `enableKey` (stored in the same
+ * per-type bag as every other value); an instance without `enableKey` is always
+ * present and not removable — the base instance.
+ */
+interface ChartTypeSettingsInstance {
+    label: string;
+    /** Boolean bag key controlling presence; omitted = always present, not removable. */
+    enableKey?: string;
+    rows: readonly SettingsRowDescriptor[];
+}
+/** An indented sub-entry under the section's rail tab, with its own pane of rows. */
+interface ChartTypeSettingsSubsection {
+    title: string;
+    rows: readonly SettingsRowDescriptor[];
+    /**
+     * Boolean bag key that masters this pane. While it is false, every row EXCEPT the
+     * one whose `key` matches stays visible but grayed out (not hidden) — so users can
+     * still browse and preview settings with the feature off. The matching toggle is
+     * typically the first row of the Display group.
+     */
+    enableKey?: string;
+}
+/**
+ * A chart type's settings tab. Two forms:
+ *
+ * - **Flat**: `rows` only — rendered as one scrollable pane, `heading` rows as inline
+ *   group titles (the historical form).
+ * - **Structured**: `instances` (and optionally `subsections`) — the pane opens with an
+ *   instance TAB STRIP, and each instance's rows are organized by a GROUP TOC on the
+ *   left built from its `heading` rows (rows before the first heading always show above
+ *   the groups; selecting a TOC entry shows only that group's rows). `subsections` add
+ *   indented rail entries under the section's tab, each a pane with the same TOC
+ *   treatment. A TOC entry hides itself while every row of its group is hidden by
+ *   `when` gates.
+ *
+ * All values — every instance and subsection included — live in the ONE per-type bag
+ * (`config.chartTypes[<id>]`), so consumers keep receiving a single flat object.
+ */
 interface ChartTypeSettingsSection {
     /** Section heading in the settings dialog. */
     title: string;
-    rows: readonly SettingsRowDescriptor[];
+    /** Flat form. Ignored when `instances` is declared. */
+    rows?: readonly SettingsRowDescriptor[];
+    /** Structured form: the pane's instance tab strip. */
+    instances?: readonly ChartTypeSettingsInstance[];
+    /** Indented sub-entries under this section's rail tab. */
+    subsections?: readonly ChartTypeSettingsSubsection[];
     /** `'active'` (default): shown only while this chart type is the active price style;
      *  `'always'`: shown whenever the type is registered. */
     visibility?: 'always' | 'active';
+    /** Rail position: `'end'` (default, after the built-in tabs) or `'after-symbol'`
+     *  (directly under the Symbol tab). Subsections follow their parent. */
+    placement?: 'after-symbol' | 'end';
 }
 /** Register (or replace) a chart type. */
 declare function registerChartType(def: ChartTypeDefinition): void;
@@ -323,6 +445,23 @@ interface RendererLayerArgs {
     priceStyle: string;
     /** Frame clock (ms) for pulses/fades; monotonic within a session. */
     nowMs: number;
+    /** Plot-relative pointer position, or null when the pointer is off the plot. Layers
+     *  that hover-test set `repaintOnCursor` on their definition so pointer moves repaint
+     *  them (only data-tier frames repaint layers otherwise). */
+    cursor: {
+        x: number;
+        y: number;
+    } | null;
+}
+/** How the active style's layer dims/slims the BASE painting under it (see
+ *  {@link RendererLayerInstance.modulateBase}). Omitted fields keep their defaults. */
+interface BasePaintingModulation {
+    /** Candle body width multiplier, (0..1] (1 = full width). */
+    candleBodyScale?: number;
+    /** Candle body-fill opacity, [0..1] (wick + border keep their own opacity). */
+    candleBodyAlpha?: number;
+    /** Gridline opacity, [0..1] (fade the grid as a reveal-under layer opens). */
+    gridAlpha?: number;
 }
 /** One live layer instance (per mounted renderer). */
 interface RendererLayerInstance {
@@ -332,6 +471,14 @@ interface RendererLayerInstance {
     render(args: RendererLayerArgs): void;
     /** Return true while the layer needs CONTINUOUS frames (a pulse/fade) — keeps the animator alive. */
     animating?(): boolean;
+    /**
+     * How the base painting (candles, grid) should be dimmed/slimmed under this layer for
+     * the CURRENT frame — a gradual counterpart of the chart type's all-or-nothing
+     * `basePainting: 'none'`. Called after `render`, only for the layer whose id matches
+     * the active price style; returning null (or omitting the method) leaves the base
+     * painting untouched. Values are clamped by the renderer.
+     */
+    modulateBase?(args: RendererLayerArgs): BasePaintingModulation | null;
     /** The renderer unmounted — release everything (the canvas itself is removed by the renderer). */
     destroy?(): void;
 }
@@ -342,6 +489,9 @@ interface RendererLayerDefinition {
     /** Stacking: `'below-data'` = behind the candles (reveal-under styles); `'above-data'` =
      *  over the candles, under the chrome/axes. Default `'above-data'`. */
     placement?: 'below-data' | 'above-data';
+    /** Repaint this layer when the pointer moves (hover hit-testing UIs). Off by default:
+     *  pointer moves normally repaint only the crosshair overlay, not the layers. */
+    repaintOnCursor?: boolean;
     /** Instance factory — called once per mounted renderer. */
     create(): RendererLayerInstance;
 }
@@ -402,4 +552,4 @@ declare const CATEGORICAL: readonly string[];
 /** Pick a stable categorical color for a string key (same key ⇒ same color). */
 declare function categoricalColor(key: string): string;
 
-export { ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, getDrawingType as E, registerChartType as F, registerDrawingType as G, HIGHLIGHT as H, INFO as I, registerRendererDefaults as J, registerRendererLayer as K, rendererDefaults as L, MARKER as M, NEUTRAL as N, rendererLayers as O, stableSeriesId as P, tickerModifierIds as Q, type RendererLayerArgs as R, SERIES_LINE as S, TRADE_EXIT as T, unregisterChartType as U, VALID as V, WARNING as W, unregisterRendererDefaults as X, unregisterRendererLayer as Y, ACCENT_BRIGHT as a, BULLISH as b, type BarTransform as c, CROSSHAIR as d, type ChartTypeDefinition as e, type ChartTypeSettingsSection as f, INVALID as g, type IdentifiableKind as h, type RendererLayerDefinition as i, type RendererLayerInstance as j, SESSION_OFF as k, SESSION_POST as l, SESSION_PRE as m, SLATE as n, SLATE_DEEP as o, type SeriesDataEngine as p, type SeriesDataEngineHost as q, type SettingsRowDescriptor as r, TRADE_LONG as s, TRADE_SHORT as t, categoricalColor as u, chartType as v, chartTypes as w, createDrawing as x, deserializeDrawing as y, drawingTypes as z };
+export { stableSeriesId as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, TRADE_SHORT as E, categoricalColor as F, chartType as G, HIGHLIGHT as H, INFO as I, chartTypes as J, createDrawing as K, deserializeDrawing as L, MARKER as M, NEUTRAL as N, drawingTypes as O, getDrawingType as P, registerChartType as Q, type RendererLayerArgs as R, SERIES_LINE as S, TRADE_EXIT as T, registerDrawingType as U, VALID as V, WARNING as W, registerRendererDefaults as X, registerRendererLayer as Y, rendererDefaults as Z, rendererLayers as _, ACCENT_BRIGHT as a, tickerModifierIds as a0, unregisterChartType as a1, unregisterRendererDefaults as a2, unregisterRendererLayer as a3, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CROSSHAIR as e, type ChartTypeDefinition as f, type ChartTypeSettingsInstance as g, type ChartTypeSettingsSection as h, type ChartTypeSettingsSubsection as i, INVALID as j, type IdentifiableKind as k, type RendererLayerDefinition as l, type RendererLayerInstance as m, SESSION_OFF as n, SESSION_POST as o, SESSION_PRE as p, SLATE as q, SLATE_DEEP as r, type SeriesDataEngine as s, type SeriesDataEngineHost as t, type SettingsRowCondition as u, type SettingsRowDescriptor as v, type SettingsRowSwatch as w, type SettingsRowWhen as x, type SettingsSelectOption as y, TRADE_LONG as z };