@luxalgo/vela 0.6.5 → 0.6.7

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { D as DrawingsDocument, R as Resolved } from './contributions-2bEmCF9S.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-2bEmCF9S.cjs';
-import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, e as RendererDisplayOptions, f as IndicatorRenderHandle, g as IndicatorStatus, c as VelaTheme, O as OHLCV, h as Pane, i as PaneAction, j as MoveTarget, k as IndicatorModel, l as ScenePatch, m as InputValue, n as SymbolPickerFn, o as LegendActionView, p as InputChangeEvent, T as ThemeName, C as CrosshairEvent, q as ClickEvent, A as AxisLongPressEvent, a as VisibleRange, r as DataWindowReadout, s as IDrawingsRendererPort, t as Millis, u as SnapMode, v as DrawingTypeKey, w as ToolbarDefinition, M as MarketConfig } from './options-YdiaaVjt.cjs';
-export { x as AddIndicatorOptions, B as Background, y as BoxFontFamily, z as BoxHAlign, E as BoxTextSize, F as BoxVAlign, G as CandleBarColor, H as CandleSeries, J as CandleStyle, K as DataWindowGroup, Q as DataWindowOHLC, W as DataWindowRow, X as DirtyRange, Y as DrawingBox, Z as DrawingExtend, _ as DrawingIntent, $ as DrawingLabel, a0 as DrawingLine, a1 as DrawingLinefill, a2 as DrawingMode, a3 as DrawingPoint, a4 as DrawingPolyline, a5 as DrawingStyle, a6 as DrawingTable, a7 as DrawingText, a8 as DrawingXLoc, a9 as DrawingsOption, aa as Fill, ab as FillGradientStop, ac as IndicatorMeta, ad as InputCondition, ae as InputSchema, af as InputType, ag as InputWhen, ah as LabelStyle, ai as LabelYLoc, aj as LineLikeKind, ak as LineLikeSeries, al as LineLikeStyle, am as MarkerPoint, an as MarkerSeries, ao as MarketSnapshot, ap as MarketSwitch, aq as PaneHint, ar as PaneKind, as as PolylinePoint, at as PriceLine, au as Projector, av as ProviderName, aw as RendererConstructor, ax as Scene, ay as SchemaPatch, az as SeriesKind, aA as SeriesPoint, aB as SeriesSpec, aC as SeriesValueDelta, aD as SettingsField, aE as SettingsSchema, aF as TableCell, aG as TableMerge, aH as TablePosition, aI as ToolbarGroupConfig, aJ as TradeExecution, aK as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aL as buildToolbar, aM as defaultToolbar, aN as inputVisible } from './options-YdiaaVjt.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-DrN7ZIou.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, l as NormalizedSettingsRow, R as RendererLayerArgs, m as RendererLayerDefinition, n as RendererLayerInstance, S as SERIES_LINE, o as SESSION_OFF, p as SESSION_POST, q as SESSION_PRE, r as SLATE, s as SLATE_DEEP, t as SeriesDataEngine, u as SeriesDataEngineHost, v as SettingsInlineControl, w as SettingsRowCondition, x as SettingsRowDescriptor, y as SettingsRowInlineNumber, z as SettingsRowSwatch, E as SettingsRowValueKey, F as SettingsRowWhen, G as SettingsRowWidth, J as SettingsSelectOption, K as SettingsValueRow, T as TRADE_EXIT, L as TRADE_LONG, O as TRADE_SHORT, V as VALID, W as WARNING, P as categoricalColor, Q as chartType, U as chartTypes, X as createDrawing, Y as deserializeDrawing, Z as drawingTypes, _ as getDrawingType, $ as normalizeSettingsRow, a0 as registerChartType, a1 as registerDrawingType, a2 as registerRendererDefaults, a3 as registerRendererLayer, a4 as rendererDefaults, a5 as rendererLayers, a6 as settingsRowValueKeys, a7 as stableSeriesId, a8 as tickerModifierIds, a9 as unregisterChartType, aa as unregisterRendererDefaults, ab as unregisterRendererLayer } from './plugin-DO_DX0gp.cjs';
+import { D as DrawingsDocument, R as Resolved } from './contributions-Hv4_cOJo.cjs';
+export { B as BarsChangeReason, C as CellStateContext, b as ContextSelect, c as DataControl, d as DrawingsControl, e as EngineAlert, f as EngineCapabilities, g as EngineContextSnapshot, h as EngineFactory, i as EngineWarning, j as ExecutionHandlers, k as ExecutionMarket, l as ExecutionRequest, m as ExecutionSession, E as ExternalIndicatorEntry, F as FetchSeries, n as IndicatorEventMap, I as IndicatorHandle, o as IndicatorSummary, L as LegendActionDescriptor, p as LegendIndicatorInfo, N as NativeIndicator, q as NativeIndicatorContext, r as NativeIndicatorDescriptor, s as NativeIndicatorInfo, t as NativeIndicatorOutput, O as OVERRIDABLE_TOPBAR_IDS, P as ParsedSymbol, u as PreparedScript, v as RendererControl, w as RunIndicatorResult, x as SceneInspection, a as ScriptRun, y as ScriptRunCause, z as ScriptRunResult, S as ScriptingEngine, A as SidePanelButton, G as SidePanelDescriptor, H as SidePanelHandle, J as SidePanelHeader, K as StatePersistenceHandler, M as StrategyFill, Q as StrategyState, T as StrategyTrade, U as SymbolRankingHook, X as TypedEventBus, V as Vela, Y as VelaDeps, Z as VelaEventMap, _ as VisibleBarRange, $ as WidgetActionDescriptor, a0 as WidgetActionTarget, a1 as WidgetAttachment, W as WidgetContext, a2 as getNativeIndicator, a3 as legendActions, a4 as nativeIndicatorDescriptors, a5 as nativeIndicatorTypes, a6 as registerDefaultEngine, a7 as registerLegendAction, a8 as registerNativeIndicator, a9 as registerSidePanel, aa as registerStatePersistence, ab as registerSymbolRanking, ac as registerWidgetAction, ad as registerWidgetAttachment, ae as resolveEngines, af as sidePanels, ag as statePersistenceHandlers, ah as symbolRanking, ai as topbarActionOverride, aj as unregisterDefaultEngine, ak as unregisterLegendAction, al as unregisterNativeIndicator, am as unregisterSidePanel, an as unregisterStatePersistence, ao as unregisterWidgetAction, ap as unregisterWidgetAttachment, aq as widgetActions, ar as widgetAttachments } from './contributions-Hv4_cOJo.cjs';
+import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, e as RendererDisplayOptions, f as IndicatorRenderHandle, g as IndicatorStatus, c as VelaTheme, O as OHLCV, h as Pane, i as PaneAction, j as MoveTarget, k as IndicatorModel, l as ScenePatch, m as InputValue, n as SymbolPickerFn, o as LegendActionView, p as InputChangeEvent, T as ThemeName, C as CrosshairEvent, q as ClickEvent, A as AxisLongPressEvent, a as VisibleRange, r as DataWindowReadout, s as IDrawingsRendererPort, t as Millis, u as SnapMode, v as DrawingTypeKey, w as ToolbarDefinition, M as MarketConfig } from './options-BaVTMXaO.cjs';
+export { x as AddIndicatorOptions, B as Background, y as BoxFontFamily, z as BoxHAlign, E as BoxTextSize, F as BoxVAlign, G as CandleBarColor, H as CandleSeries, J as CandleStyle, K as DataWindowGroup, Q as DataWindowOHLC, W as DataWindowRow, X as DirtyRange, Y as DrawingBox, Z as DrawingExtend, _ as DrawingIntent, $ as DrawingLabel, a0 as DrawingLine, a1 as DrawingLinefill, a2 as DrawingMode, a3 as DrawingPoint, a4 as DrawingPolyline, a5 as DrawingStyle, a6 as DrawingTable, a7 as DrawingText, a8 as DrawingXLoc, a9 as DrawingsOption, aa as Fill, ab as FillGradientStop, ac as IndicatorMeta, ad as InputCondition, ae as InputSchema, af as InputType, ag as InputWhen, ah as LabelStyle, ai as LabelYLoc, aj as LineLikeKind, ak as LineLikeSeries, al as LineLikeStyle, am as MarkerPoint, an as MarkerSeries, ao as MarketSnapshot, ap as MarketSwitch, aq as PaneAxis, ar as PaneAxisBand, as as PaneHint, at as PaneKind, au as PolylinePoint, av as PriceLine, aw as Projector, ax as ProviderName, ay as RendererConstructor, az as Scene, aA as SchemaPatch, aB as SeriesKind, aC as SeriesPoint, aD as SeriesSpec, aE as SeriesValueDelta, aF as SettingsField, aG as SettingsSchema, aH as SettingsVisibilityPolicy, aI as TableCell, aJ as TableMerge, aK as TablePosition, aL as ToolbarGroupConfig, aM as TradeExecution, aN as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aO as buildToolbar, aP as defaultToolbar, aQ as inputVisible } from './options-BaVTMXaO.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-BsQM2WNH.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, l as NormalizedSettingsRow, R as RendererLayerArgs, m as RendererLayerDefinition, n as RendererLayerInstance, S as SERIES_LINE, o as SESSION_OFF, p as SESSION_POST, q as SESSION_PRE, r as SLATE, s as SLATE_DEEP, t as SeriesDataEngine, u as SeriesDataEngineHost, v as SettingsInlineControl, w as SettingsRowCondition, x as SettingsRowDescriptor, y as SettingsRowInlineNumber, z as SettingsRowSwatch, E as SettingsRowValueKey, F as SettingsRowWhen, G as SettingsRowWidth, J as SettingsSelectOption, K as SettingsValueRow, T as TRADE_EXIT, L as TRADE_LONG, O as TRADE_SHORT, V as VALID, W as WARNING, P as categoricalColor, Q as chartType, U as chartTypes, X as createDrawing, Y as deserializeDrawing, Z as drawingTypes, _ as getDrawingType, $ as normalizeSettingsRow, a0 as registerChartType, a1 as registerDrawingType, a2 as registerRendererDefaults, a3 as registerRendererLayer, a4 as rendererDefaults, a5 as rendererLayers, a6 as settingsRowValueKeys, a7 as stableSeriesId, a8 as tickerModifierIds, a9 as unregisterChartType, aa as unregisterRendererDefaults, ab as unregisterRendererLayer } from './plugin-BXhDHTYn.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';
@@ -284,26 +284,32 @@ interface ChartConfig {
  */
 /** A host-contributed settings row: callback-based (the host owns the state).
  *  `heading` opens a titled group inside the tab (an in-pane section title);
- *  `color` is a swatch opening the themed picker (any CSS color, alpha included). */
+ *  `color` is a swatch opening the themed picker (any CSS color, alpha included).
+ *  `id` is the row's stable visibility id (defaults to the label's slug) — hiding a
+ *  heading's id hides its whole group (see `settings-visibility.ts`). */
 type HostSettingsRow = {
     kind: 'heading';
     label: string;
+    id?: string;
 } | {
     kind: 'toggle';
     label: string;
     get: () => boolean;
     set: (v: boolean) => void;
+    id?: string;
 } | {
     kind: 'select';
     label: string;
     options: readonly string[];
     get: () => string;
     set: (v: string) => void;
+    id?: string;
 } | {
     kind: 'color';
     label: string;
     get: () => string;
     set: (v: string) => void;
+    id?: string;
 };
 /** A host-contributed settings tab (see `RendererControl.setSettingsSections`). */
 interface HostSettingsSection {
@@ -312,6 +318,8 @@ interface HostSettingsSection {
     /** Tab position: own tab after Symbol (default), end of the rail, or rows INSIDE
      *  the Symbol tab itself (`'symbol'` — e.g. the widget's watermark toggle). */
     placement?: 'after-symbol' | 'end' | 'symbol';
+    /** Stable visibility id (defaults to the title's slug). Row ids scope under it. */
+    id?: string;
 }
 
 /**
@@ -331,6 +339,7 @@ declare class NativeRenderer implements IChartRenderer {
     private plot;
     private toolbarGutter;
     private mountContainer;
+    private backdropCanvas;
     private dataCanvas;
     private volumeCanvas;
     private vpvrCanvas;
@@ -339,6 +348,7 @@ declare class NativeRenderer implements IChartRenderer {
     private cursorCanvas;
     private overlayRoot;
     private userDrawings;
+    private readonly backdropRenderer;
     private readonly volumeRenderer;
     /** SDK renderer layers instantiated at mount ({@link registerRendererLayer}). */
     private extLayers;
@@ -428,6 +438,9 @@ declare class NativeRenderer implements IChartRenderer {
     private readonly paneActionCbs;
     private hoverLogical;
     private settingsDialog;
+    /** The host's visibility policy (setting ids hidden from the dialog) — instance
+     *  state, never part of the persisted config. */
+    private hiddenSettings;
     /** Where modal dialogs mount — a HOST override (multi-chart shells pass their root
      *  so dialogs center globally instead of clipping inside one cell). Null = the plot. */
     private dialogHost;
@@ -676,6 +689,10 @@ declare class NativeRenderer implements IChartRenderer {
      *  whenever the latest bars are off-screen (touch has no cursor proximity). */
     setLayoutMode(mode: 'mobile' | 'desktop'): void;
     setSettingsSections(sections: HostSettingsSection[]): void;
+    setSettingsVisibility(policy: {
+        hidden?: readonly string[];
+    }): void;
+    listSettingsIds(): string[];
     onChartTypeSettingsChange(cb: (typeId: string, values: Record<string, unknown>) => void): Unsubscribe;
     onConfigChanged(cb: () => void): Unsubscribe;
     onThemeSelect(cb: (theme: ThemeName) => void): Unsubscribe;
@@ -872,8 +889,8 @@ declare class NativeRenderer implements IChartRenderer {
      *  owned layers by their owner's z key against the candles' (an indicator restacked
      *  below the candles takes its layer canvas along), unowned by declared placement. */
     private orderedLayerCanvases;
-    /** The full canvas pile in paint order (layers + data/volume/vpvr) — what the DOM
-     *  stacking and the screenshot compositor must both follow. */
+    /** The full canvas pile in paint order (backdrop + layers + data/volume/vpvr) — what
+     *  the DOM stacking and the screenshot compositor must both follow. */
     private canvasPile;
     /** Re-slot the SDK layer canvases in the plot when the computed order changed (a z
      *  write, a restored config, an indicator mount/remove/restack). Runs at the top of
@@ -1142,8 +1159,12 @@ declare class BarStore {
     /** Earliest bar-open time fetched for a series — what the cache actually covers. */
     private readonly coveredFrom;
     private currentSymbol?;
-    /** Symbols protected from the current-symbol purge (multi-chart cells). Empty = legacy single-chart behavior. */
+    /** Symbols protected from the current-symbol purge (multi-chart cells) — the UNION
+     *  of every owner's declaration. Empty = legacy single-chart behavior. */
     private retained;
+    /** Per-owner declarations behind {@link retained} — several shells on one page must
+     *  not clobber (or, on destroy, evict) each other's protected symbols. */
+    private readonly retainedByOwner;
     get(key: string): OHLCV[] | undefined;
     /**
      * Record that the series is covered back to `from`. Tracks the EARLIEST such
@@ -1168,13 +1189,16 @@ declare class BarStore {
      * Declare the set of symbols a multi-chart workspace is displaying (CANONICAL
      * tickers, post-registry resolution — `chart.data.resolve(sym).ticker`). These
      * survive every {@link retainSymbol} purge, so cells loading different symbols
-     * stop evicting each other's history. Replaces the previous set and purges
-     * anything now outside `symbols ∪ {currentSymbol}` immediately. An empty set
-     * restores the legacy single-chart policy. Note: SECONDARY symbols a script
-     * fetches (`request.security` cross-symbol) are not in this set and still drop
-     * on cross-cell loads — correctness is unaffected (they re-fetch on demand).
+     * stop evicting each other's history. Replaces the previous set FOR THAT OWNER
+     * (pass the shell instance as `owner`; several shells on one page keep separate
+     * declarations, the effective set is their union) and purges anything now outside
+     * the union ∪ {currentSymbol} immediately. An empty set releases the owner's
+     * declaration — with no owners left, the legacy single-chart policy is back.
+     * Note: SECONDARY symbols a script fetches (`request.security` cross-symbol) are
+     * not in this set and still drop on cross-cell loads — correctness is unaffected
+     * (they re-fetch on demand).
      */
-    retain(symbols: ReadonlySet<string>): void;
+    retain(symbols: ReadonlySet<string>, owner?: unknown): void;
     /** Drop every series whose symbol is neither `current` nor retained. */
     private purgeOutside;
     clear(): void;
@@ -1217,6 +1241,10 @@ declare class MultiProviderFeed implements MarketDataFeed {
     canonicalSymbol(raw: string): string | null;
     /** The registered provider INSTANCE under `name` (undefined if unknown). */
     providerInstance(name: string): DataProvider | undefined;
+    /** The icon URL for a DESCRIPTOR — its owning provider's `resolveSymbolIcon` (picker rows). */
+    symbolIconOf(d: SymbolDescriptor): string | undefined;
+    /** The icon URL for a raw SYMBOL string — resolve, then route (statusline, object tree). */
+    symbolIcon(raw: string): string | undefined;
     symbols(name?: string): SymbolDescriptor[];
     /** Told when a symbol stays unservable by everything registered (the load is parked). */
     onUnresolved(cb: (info: {

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { D as DrawingsDocument, R as Resolved } from './contributions-DatoAzMx.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-DatoAzMx.js';
-import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, e as RendererDisplayOptions, f as IndicatorRenderHandle, g as IndicatorStatus, c as VelaTheme, O as OHLCV, h as Pane, i as PaneAction, j as MoveTarget, k as IndicatorModel, l as ScenePatch, m as InputValue, n as SymbolPickerFn, o as LegendActionView, p as InputChangeEvent, T as ThemeName, C as CrosshairEvent, q as ClickEvent, A as AxisLongPressEvent, a as VisibleRange, r as DataWindowReadout, s as IDrawingsRendererPort, t as Millis, u as SnapMode, v as DrawingTypeKey, w as ToolbarDefinition, M as MarketConfig } from './options-YdiaaVjt.js';
-export { x as AddIndicatorOptions, B as Background, y as BoxFontFamily, z as BoxHAlign, E as BoxTextSize, F as BoxVAlign, G as CandleBarColor, H as CandleSeries, J as CandleStyle, K as DataWindowGroup, Q as DataWindowOHLC, W as DataWindowRow, X as DirtyRange, Y as DrawingBox, Z as DrawingExtend, _ as DrawingIntent, $ as DrawingLabel, a0 as DrawingLine, a1 as DrawingLinefill, a2 as DrawingMode, a3 as DrawingPoint, a4 as DrawingPolyline, a5 as DrawingStyle, a6 as DrawingTable, a7 as DrawingText, a8 as DrawingXLoc, a9 as DrawingsOption, aa as Fill, ab as FillGradientStop, ac as IndicatorMeta, ad as InputCondition, ae as InputSchema, af as InputType, ag as InputWhen, ah as LabelStyle, ai as LabelYLoc, aj as LineLikeKind, ak as LineLikeSeries, al as LineLikeStyle, am as MarkerPoint, an as MarkerSeries, ao as MarketSnapshot, ap as MarketSwitch, aq as PaneHint, ar as PaneKind, as as PolylinePoint, at as PriceLine, au as Projector, av as ProviderName, aw as RendererConstructor, ax as Scene, ay as SchemaPatch, az as SeriesKind, aA as SeriesPoint, aB as SeriesSpec, aC as SeriesValueDelta, aD as SettingsField, aE as SettingsSchema, aF as TableCell, aG as TableMerge, aH as TablePosition, aI as ToolbarGroupConfig, aJ as TradeExecution, aK as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aL as buildToolbar, aM as defaultToolbar, aN as inputVisible } from './options-YdiaaVjt.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-BmHkcwvJ.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, l as NormalizedSettingsRow, R as RendererLayerArgs, m as RendererLayerDefinition, n as RendererLayerInstance, S as SERIES_LINE, o as SESSION_OFF, p as SESSION_POST, q as SESSION_PRE, r as SLATE, s as SLATE_DEEP, t as SeriesDataEngine, u as SeriesDataEngineHost, v as SettingsInlineControl, w as SettingsRowCondition, x as SettingsRowDescriptor, y as SettingsRowInlineNumber, z as SettingsRowSwatch, E as SettingsRowValueKey, F as SettingsRowWhen, G as SettingsRowWidth, J as SettingsSelectOption, K as SettingsValueRow, T as TRADE_EXIT, L as TRADE_LONG, O as TRADE_SHORT, V as VALID, W as WARNING, P as categoricalColor, Q as chartType, U as chartTypes, X as createDrawing, Y as deserializeDrawing, Z as drawingTypes, _ as getDrawingType, $ as normalizeSettingsRow, a0 as registerChartType, a1 as registerDrawingType, a2 as registerRendererDefaults, a3 as registerRendererLayer, a4 as rendererDefaults, a5 as rendererLayers, a6 as settingsRowValueKeys, a7 as stableSeriesId, a8 as tickerModifierIds, a9 as unregisterChartType, aa as unregisterRendererDefaults, ab as unregisterRendererLayer } from './plugin-Bcone6Vh.js';
+import { D as DrawingsDocument, R as Resolved } from './contributions-Z12BrWCy.js';
+export { B as BarsChangeReason, C as CellStateContext, b as ContextSelect, c as DataControl, d as DrawingsControl, e as EngineAlert, f as EngineCapabilities, g as EngineContextSnapshot, h as EngineFactory, i as EngineWarning, j as ExecutionHandlers, k as ExecutionMarket, l as ExecutionRequest, m as ExecutionSession, E as ExternalIndicatorEntry, F as FetchSeries, n as IndicatorEventMap, I as IndicatorHandle, o as IndicatorSummary, L as LegendActionDescriptor, p as LegendIndicatorInfo, N as NativeIndicator, q as NativeIndicatorContext, r as NativeIndicatorDescriptor, s as NativeIndicatorInfo, t as NativeIndicatorOutput, O as OVERRIDABLE_TOPBAR_IDS, P as ParsedSymbol, u as PreparedScript, v as RendererControl, w as RunIndicatorResult, x as SceneInspection, a as ScriptRun, y as ScriptRunCause, z as ScriptRunResult, S as ScriptingEngine, A as SidePanelButton, G as SidePanelDescriptor, H as SidePanelHandle, J as SidePanelHeader, K as StatePersistenceHandler, M as StrategyFill, Q as StrategyState, T as StrategyTrade, U as SymbolRankingHook, X as TypedEventBus, V as Vela, Y as VelaDeps, Z as VelaEventMap, _ as VisibleBarRange, $ as WidgetActionDescriptor, a0 as WidgetActionTarget, a1 as WidgetAttachment, W as WidgetContext, a2 as getNativeIndicator, a3 as legendActions, a4 as nativeIndicatorDescriptors, a5 as nativeIndicatorTypes, a6 as registerDefaultEngine, a7 as registerLegendAction, a8 as registerNativeIndicator, a9 as registerSidePanel, aa as registerStatePersistence, ab as registerSymbolRanking, ac as registerWidgetAction, ad as registerWidgetAttachment, ae as resolveEngines, af as sidePanels, ag as statePersistenceHandlers, ah as symbolRanking, ai as topbarActionOverride, aj as unregisterDefaultEngine, ak as unregisterLegendAction, al as unregisterNativeIndicator, am as unregisterSidePanel, an as unregisterStatePersistence, ao as unregisterWidgetAction, ap as unregisterWidgetAttachment, aq as widgetActions, ar as widgetAttachments } from './contributions-Z12BrWCy.js';
+import { D as Drawing, S as SerializedDrawing, U as Unsubscribe, L as LineStyle, P as PriceStyle, I as IChartRenderer, R as RendererCapabilities, e as RendererDisplayOptions, f as IndicatorRenderHandle, g as IndicatorStatus, c as VelaTheme, O as OHLCV, h as Pane, i as PaneAction, j as MoveTarget, k as IndicatorModel, l as ScenePatch, m as InputValue, n as SymbolPickerFn, o as LegendActionView, p as InputChangeEvent, T as ThemeName, C as CrosshairEvent, q as ClickEvent, A as AxisLongPressEvent, a as VisibleRange, r as DataWindowReadout, s as IDrawingsRendererPort, t as Millis, u as SnapMode, v as DrawingTypeKey, w as ToolbarDefinition, M as MarketConfig } from './options-BaVTMXaO.js';
+export { x as AddIndicatorOptions, B as Background, y as BoxFontFamily, z as BoxHAlign, E as BoxTextSize, F as BoxVAlign, G as CandleBarColor, H as CandleSeries, J as CandleStyle, K as DataWindowGroup, Q as DataWindowOHLC, W as DataWindowRow, X as DirtyRange, Y as DrawingBox, Z as DrawingExtend, _ as DrawingIntent, $ as DrawingLabel, a0 as DrawingLine, a1 as DrawingLinefill, a2 as DrawingMode, a3 as DrawingPoint, a4 as DrawingPolyline, a5 as DrawingStyle, a6 as DrawingTable, a7 as DrawingText, a8 as DrawingXLoc, a9 as DrawingsOption, aa as Fill, ab as FillGradientStop, ac as IndicatorMeta, ad as InputCondition, ae as InputSchema, af as InputType, ag as InputWhen, ah as LabelStyle, ai as LabelYLoc, aj as LineLikeKind, ak as LineLikeSeries, al as LineLikeStyle, am as MarkerPoint, an as MarkerSeries, ao as MarketSnapshot, ap as MarketSwitch, aq as PaneAxis, ar as PaneAxisBand, as as PaneHint, at as PaneKind, au as PolylinePoint, av as PriceLine, aw as Projector, ax as ProviderName, ay as RendererConstructor, az as Scene, aA as SchemaPatch, aB as SeriesKind, aC as SeriesPoint, aD as SeriesSpec, aE as SeriesValueDelta, aF as SettingsField, aG as SettingsSchema, aH as SettingsVisibilityPolicy, aI as TableCell, aJ as TableMerge, aK as TablePosition, aL as ToolbarGroupConfig, aM as TradeExecution, aN as ValuePatch, b as VelaOptions, V as VisibleRangePreset, aO as buildToolbar, aP as defaultToolbar, aQ as inputVisible } from './options-BaVTMXaO.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-BSLlBpB9.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, l as NormalizedSettingsRow, R as RendererLayerArgs, m as RendererLayerDefinition, n as RendererLayerInstance, S as SERIES_LINE, o as SESSION_OFF, p as SESSION_POST, q as SESSION_PRE, r as SLATE, s as SLATE_DEEP, t as SeriesDataEngine, u as SeriesDataEngineHost, v as SettingsInlineControl, w as SettingsRowCondition, x as SettingsRowDescriptor, y as SettingsRowInlineNumber, z as SettingsRowSwatch, E as SettingsRowValueKey, F as SettingsRowWhen, G as SettingsRowWidth, J as SettingsSelectOption, K as SettingsValueRow, T as TRADE_EXIT, L as TRADE_LONG, O as TRADE_SHORT, V as VALID, W as WARNING, P as categoricalColor, Q as chartType, U as chartTypes, X as createDrawing, Y as deserializeDrawing, Z as drawingTypes, _ as getDrawingType, $ as normalizeSettingsRow, a0 as registerChartType, a1 as registerDrawingType, a2 as registerRendererDefaults, a3 as registerRendererLayer, a4 as rendererDefaults, a5 as rendererLayers, a6 as settingsRowValueKeys, a7 as stableSeriesId, a8 as tickerModifierIds, a9 as unregisterChartType, aa as unregisterRendererDefaults, ab as unregisterRendererLayer } from './plugin-9koBjc5H.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';
@@ -284,26 +284,32 @@ interface ChartConfig {
  */
 /** A host-contributed settings row: callback-based (the host owns the state).
  *  `heading` opens a titled group inside the tab (an in-pane section title);
- *  `color` is a swatch opening the themed picker (any CSS color, alpha included). */
+ *  `color` is a swatch opening the themed picker (any CSS color, alpha included).
+ *  `id` is the row's stable visibility id (defaults to the label's slug) — hiding a
+ *  heading's id hides its whole group (see `settings-visibility.ts`). */
 type HostSettingsRow = {
     kind: 'heading';
     label: string;
+    id?: string;
 } | {
     kind: 'toggle';
     label: string;
     get: () => boolean;
     set: (v: boolean) => void;
+    id?: string;
 } | {
     kind: 'select';
     label: string;
     options: readonly string[];
     get: () => string;
     set: (v: string) => void;
+    id?: string;
 } | {
     kind: 'color';
     label: string;
     get: () => string;
     set: (v: string) => void;
+    id?: string;
 };
 /** A host-contributed settings tab (see `RendererControl.setSettingsSections`). */
 interface HostSettingsSection {
@@ -312,6 +318,8 @@ interface HostSettingsSection {
     /** Tab position: own tab after Symbol (default), end of the rail, or rows INSIDE
      *  the Symbol tab itself (`'symbol'` — e.g. the widget's watermark toggle). */
     placement?: 'after-symbol' | 'end' | 'symbol';
+    /** Stable visibility id (defaults to the title's slug). Row ids scope under it. */
+    id?: string;
 }
 
 /**
@@ -331,6 +339,7 @@ declare class NativeRenderer implements IChartRenderer {
     private plot;
     private toolbarGutter;
     private mountContainer;
+    private backdropCanvas;
     private dataCanvas;
     private volumeCanvas;
     private vpvrCanvas;
@@ -339,6 +348,7 @@ declare class NativeRenderer implements IChartRenderer {
     private cursorCanvas;
     private overlayRoot;
     private userDrawings;
+    private readonly backdropRenderer;
     private readonly volumeRenderer;
     /** SDK renderer layers instantiated at mount ({@link registerRendererLayer}). */
     private extLayers;
@@ -428,6 +438,9 @@ declare class NativeRenderer implements IChartRenderer {
     private readonly paneActionCbs;
     private hoverLogical;
     private settingsDialog;
+    /** The host's visibility policy (setting ids hidden from the dialog) — instance
+     *  state, never part of the persisted config. */
+    private hiddenSettings;
     /** Where modal dialogs mount — a HOST override (multi-chart shells pass their root
      *  so dialogs center globally instead of clipping inside one cell). Null = the plot. */
     private dialogHost;
@@ -676,6 +689,10 @@ declare class NativeRenderer implements IChartRenderer {
      *  whenever the latest bars are off-screen (touch has no cursor proximity). */
     setLayoutMode(mode: 'mobile' | 'desktop'): void;
     setSettingsSections(sections: HostSettingsSection[]): void;
+    setSettingsVisibility(policy: {
+        hidden?: readonly string[];
+    }): void;
+    listSettingsIds(): string[];
     onChartTypeSettingsChange(cb: (typeId: string, values: Record<string, unknown>) => void): Unsubscribe;
     onConfigChanged(cb: () => void): Unsubscribe;
     onThemeSelect(cb: (theme: ThemeName) => void): Unsubscribe;
@@ -872,8 +889,8 @@ declare class NativeRenderer implements IChartRenderer {
      *  owned layers by their owner's z key against the candles' (an indicator restacked
      *  below the candles takes its layer canvas along), unowned by declared placement. */
     private orderedLayerCanvases;
-    /** The full canvas pile in paint order (layers + data/volume/vpvr) — what the DOM
-     *  stacking and the screenshot compositor must both follow. */
+    /** The full canvas pile in paint order (backdrop + layers + data/volume/vpvr) — what
+     *  the DOM stacking and the screenshot compositor must both follow. */
     private canvasPile;
     /** Re-slot the SDK layer canvases in the plot when the computed order changed (a z
      *  write, a restored config, an indicator mount/remove/restack). Runs at the top of
@@ -1142,8 +1159,12 @@ declare class BarStore {
     /** Earliest bar-open time fetched for a series — what the cache actually covers. */
     private readonly coveredFrom;
     private currentSymbol?;
-    /** Symbols protected from the current-symbol purge (multi-chart cells). Empty = legacy single-chart behavior. */
+    /** Symbols protected from the current-symbol purge (multi-chart cells) — the UNION
+     *  of every owner's declaration. Empty = legacy single-chart behavior. */
     private retained;
+    /** Per-owner declarations behind {@link retained} — several shells on one page must
+     *  not clobber (or, on destroy, evict) each other's protected symbols. */
+    private readonly retainedByOwner;
     get(key: string): OHLCV[] | undefined;
     /**
      * Record that the series is covered back to `from`. Tracks the EARLIEST such
@@ -1168,13 +1189,16 @@ declare class BarStore {
      * Declare the set of symbols a multi-chart workspace is displaying (CANONICAL
      * tickers, post-registry resolution — `chart.data.resolve(sym).ticker`). These
      * survive every {@link retainSymbol} purge, so cells loading different symbols
-     * stop evicting each other's history. Replaces the previous set and purges
-     * anything now outside `symbols ∪ {currentSymbol}` immediately. An empty set
-     * restores the legacy single-chart policy. Note: SECONDARY symbols a script
-     * fetches (`request.security` cross-symbol) are not in this set and still drop
-     * on cross-cell loads — correctness is unaffected (they re-fetch on demand).
+     * stop evicting each other's history. Replaces the previous set FOR THAT OWNER
+     * (pass the shell instance as `owner`; several shells on one page keep separate
+     * declarations, the effective set is their union) and purges anything now outside
+     * the union ∪ {currentSymbol} immediately. An empty set releases the owner's
+     * declaration — with no owners left, the legacy single-chart policy is back.
+     * Note: SECONDARY symbols a script fetches (`request.security` cross-symbol) are
+     * not in this set and still drop on cross-cell loads — correctness is unaffected
+     * (they re-fetch on demand).
      */
-    retain(symbols: ReadonlySet<string>): void;
+    retain(symbols: ReadonlySet<string>, owner?: unknown): void;
     /** Drop every series whose symbol is neither `current` nor retained. */
     private purgeOutside;
     clear(): void;
@@ -1217,6 +1241,10 @@ declare class MultiProviderFeed implements MarketDataFeed {
     canonicalSymbol(raw: string): string | null;
     /** The registered provider INSTANCE under `name` (undefined if unknown). */
     providerInstance(name: string): DataProvider | undefined;
+    /** The icon URL for a DESCRIPTOR — its owning provider's `resolveSymbolIcon` (picker rows). */
+    symbolIconOf(d: SymbolDescriptor): string | undefined;
+    /** The icon URL for a raw SYMBOL string — resolve, then route (statusline, object tree). */
+    symbolIcon(raw: string): string | undefined;
     symbols(name?: string): SymbolDescriptor[];
     /** Told when a symbol stays unservable by everything registered (the load is parked). */
     onUnresolved(cb: (info: {

package/dist/index.js

@@ -1,5 +1,5 @@
 export { stableSeriesId } from './chunk-AOGZBKUE.js';
-export { BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TypedEventBus, Vela, buildToolbar, defaultToolbar, resolveTheme, sharedBarStore, timeframeToMs } from './chunk-FQBT4NFM.js';
-export { DEFAULT_PANEL_MAX_WIDTH, DEFAULT_PANEL_MIN_WIDTH, DEFAULT_PANEL_WIDTH, Drawing, chartType, chartTypes, clampPanelWidth, createDrawing, deserializeDrawing, drawingTypes, getDrawingType, getNativeIndicator, inputVisible, legendActions, nativeIndicatorDescriptors, nativeIndicatorTypes, normalizeSettingsRow, registerChartType, registerDefaultEngine, registerDrawingType, registerLegendAction, registerNativeIndicator, registerRendererDefaults, registerRendererLayer, registerSidePanel, registerWidgetAction, registerWidgetAttachment, rendererDefaults, rendererLayers, resolveEngines, settingsRowValueKeys, sidePanels, tickerModifierIds, unregisterChartType, unregisterDefaultEngine, unregisterLegendAction, unregisterNativeIndicator, unregisterRendererDefaults, unregisterRendererLayer, unregisterSidePanel, unregisterWidgetAction, unregisterWidgetAttachment, widgetActions, widgetAttachments } from './chunk-BEJ57HP4.js';
+export { BarStore, CachingDataFeed, DARK_THEME, DataControl, DrawingStore, DrawingToolbar, DrawingsControl, LIGHT_THEME, MultiProviderFeed, NativeRenderer, RendererControl, TypedEventBus, Vela, buildToolbar, defaultToolbar, resolveTheme, sharedBarStore, timeframeToMs } from './chunk-6WFKTAT4.js';
+export { DEFAULT_PANEL_MAX_WIDTH, DEFAULT_PANEL_MIN_WIDTH, DEFAULT_PANEL_WIDTH, Drawing, OVERRIDABLE_TOPBAR_IDS, chartType, chartTypes, clampPanelWidth, createDrawing, deserializeDrawing, drawingTypes, getDrawingType, getNativeIndicator, inputVisible, legendActions, nativeIndicatorDescriptors, nativeIndicatorTypes, normalizeSettingsRow, registerChartType, registerDefaultEngine, registerDrawingType, registerLegendAction, registerNativeIndicator, registerRendererDefaults, registerRendererLayer, registerSidePanel, registerStatePersistence, registerSymbolRanking, registerWidgetAction, registerWidgetAttachment, rendererDefaults, rendererLayers, resolveEngines, settingsRowValueKeys, sidePanels, statePersistenceHandlers, symbolRanking, tickerModifierIds, topbarActionOverride, unregisterChartType, unregisterDefaultEngine, unregisterLegendAction, unregisterNativeIndicator, unregisterRendererDefaults, unregisterRendererLayer, unregisterSidePanel, unregisterStatePersistence, unregisterWidgetAction, unregisterWidgetAttachment, widgetActions, widgetAttachments } from './chunk-L3I2CCYO.js';
 import './chunk-OICPLNU7.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-PN5KWFZ4.js';

package/dist/{options-YdiaaVjt.d.cts → options-BaVTMXaO.d.cts}

@@ -434,6 +434,17 @@ interface IndicatorMeta {
 }
 /** Where an indicator's plots are placed. */
 type PaneHint = 'price' | 'new';
+/** One label of a categorical pane axis: `frac` is the label's center as a fraction of
+ *  the pane's height (0 = top, 1 = bottom). */
+interface PaneAxisBand {
+    frac: number;
+    label: string;
+}
+/** A pane's value-axis override (see {@link IndicatorModel.paneAxis}): `'none'` = a
+ *  blank axis; band labels = a categorical axis, one label per content band/row. */
+type PaneAxis = 'none' | {
+    bands: PaneAxisBand[];
+};
 /**
  * Everything one `addIndicator()` produces — the unit the orchestrator mounts
  * on the renderer. Renderer-neutral.
@@ -458,6 +469,17 @@ interface IndicatorModel {
     native?: {
         type: string;
     };
+    /**
+     * Value-axis override for the pane this indicator OWNS — declared by content that is
+     * not value-mapped (e.g. a bespoke renderer layer painting in pixel bands), where a
+     * derived price scale would label meaningless numbers. `'none'` leaves the axis blank;
+     * band labels place text at fractions of the pane's height (a categorical axis — one
+     * label per band/row, e.g. `frac: 0.25` centers a label in the top quarter). Either way
+     * the renderer draws no price ticks, no horizontal gridlines, and no crosshair value
+     * chip in that pane. Only honored while such indicators are the pane's sole content —
+     * any real series merged into the pane takes the scale (and its labels) back over.
+     */
+    paneAxis?: PaneAxis;
     /** Resolved pane id, filled in by the orchestrator after routing. */
     paneId?: string;
     /**
@@ -1417,11 +1439,22 @@ interface IChartRenderer {
     /** A chart type's SDK settings changed (dialog edit / applyConfig) — the core forwards
      *  them to the type's data engine. */
     onChartTypeSettingsChange?(cb: (typeId: string, values: Record<string, unknown>) => void): Unsubscribe;
-    /** Host-app settings tabs (callback rows) shown by the renderer's settings dialog. */
+    /** Host-app settings tabs (callback rows) shown by the renderer's settings dialog.
+     *  `id` names a section for the visibility policy (defaults to the title's slug). */
     setSettingsSections?(sections: ReadonlyArray<{
         title: string;
         rows: readonly unknown[];
+        id?: string;
     }>): void;
+    /** Settings-dialog visibility policy: `hidden` lists setting ids to hide (a tab, a
+     *  group, or a row — subtree semantics). Presentation-only: hidden values keep
+     *  being stored and applied. Optional — a renderer without a settings dialog omits it. */
+    setSettingsVisibility?(policy: {
+        hidden?: readonly string[];
+    }): void;
+    /** Every addressable setting id of this chart (built-ins, chart-type sections,
+     *  host sections) — the discovery surface for the visibility policy. */
+    listSettingsIds?(): string[];
     /**
      * The host shell's chrome size class. `'mobile'` asks the renderer's own chrome
      * (dialogs, toolbars, buttons) for its touch-first presentation — fullscreen
@@ -1562,6 +1595,19 @@ interface VelaOptions extends MarketConfig {
      *  price pane, on their own scale (they never affect the price autoscale). Added
      *  automatically on chart creation (native renderer) — pass `false` to opt out. */
     volume?: boolean;
+    /** Settings-dialog visibility policy. Default: everything visible. `hidden` lists
+     *  setting ids to hide — a tab (`'canvas'`), a group (`'canvas.grid'`), or a single
+     *  row (`'canvas.grid.vertical'`); an id hides its whole subtree, and a tab with
+     *  nothing left disappears from the rail. Hiding is presentation-only: hidden
+     *  values keep being stored and applied. Enumerate the addressable ids of a live
+     *  chart with `chart.renderer.listSettingsIds()`; the catalog is documented in
+     *  docs/user/options.md. */
+    settings?: SettingsVisibilityPolicy;
+}
+/** Settings-dialog visibility policy (see `VelaOptions.settings`). */
+interface SettingsVisibilityPolicy {
+    /** Setting ids to hide — a tab, a group, or a row; an id hides its subtree. */
+    hidden?: readonly string[];
 }
 /** Per-feature native-renderer animation toggles. */
 interface AnimationConfig {
@@ -1637,4 +1683,4 @@ interface AddIndicatorOptions {
     title?: string;
 }
 
-export { type DrawingLabel as $, type AxisLongPressEvent as A, type Background as B, type CrosshairEvent as C, Drawing as D, type BoxTextSize as E, type BoxVAlign as F, type CandleBarColor as G, type CandleSeries as H, type IChartRenderer as I, type CandleStyle as J, type DataWindowGroup as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type DataWindowOHLC as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type DataWindowRow as W, type DirtyRange as X, type DrawingBox as Y, type DrawingExtend as Z, type DrawingIntent as _, type VisibleRange as a, type DrawingLine as a0, type DrawingLinefill as a1, type DrawingMode as a2, type DrawingPoint as a3, type DrawingPolyline as a4, type DrawingStyle as a5, type DrawingTable as a6, type DrawingText as a7, type DrawingXLoc as a8, type DrawingsOption as a9, type SeriesPoint as aA, type SeriesSpec as aB, type SeriesValueDelta as aC, type SettingsField as aD, type SettingsSchema as aE, type TableCell as aF, type TableMerge as aG, type TablePosition as aH, type ToolbarGroupConfig as aI, type TradeExecution as aJ, type ValuePatch as aK, buildToolbar as aL, defaultToolbar as aM, inputVisible as aN, type PaneInfo as aO, type Fill as aa, type FillGradientStop as ab, type IndicatorMeta as ac, type InputCondition as ad, type InputSchema as ae, type InputType as af, type InputWhen as ag, type LabelStyle as ah, type LabelYLoc as ai, type LineLikeKind as aj, type LineLikeSeries as ak, type LineLikeStyle as al, type MarkerPoint as am, type MarkerSeries as an, type MarketSnapshot as ao, type MarketSwitch as ap, type PaneHint as aq, type PaneKind as ar, type PolylinePoint as as, type PriceLine as at, type Projector as au, type ProviderName as av, type RendererConstructor as aw, type Scene as ax, type SchemaPatch as ay, type SeriesKind as az, type VelaOptions as b, type VelaTheme as c, type MarketSession as d, type RendererDisplayOptions as e, type IndicatorRenderHandle as f, type IndicatorStatus as g, type Pane as h, type PaneAction as i, type MoveTarget as j, type IndicatorModel as k, type ScenePatch as l, type InputValue as m, type SymbolPickerFn as n, type LegendActionView as o, type InputChangeEvent as p, type ClickEvent as q, type DataWindowReadout as r, type IDrawingsRendererPort as s, type Millis as t, type SnapMode as u, type DrawingTypeKey as v, type ToolbarDefinition as w, type AddIndicatorOptions as x, type BoxFontFamily as y, type BoxHAlign as z };
+export { type DrawingLabel as $, type AxisLongPressEvent as A, type Background as B, type CrosshairEvent as C, Drawing as D, type BoxTextSize as E, type BoxVAlign as F, type CandleBarColor as G, type CandleSeries as H, type IChartRenderer as I, type CandleStyle as J, type DataWindowGroup as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type DataWindowOHLC as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type DataWindowRow as W, type DirtyRange as X, type DrawingBox as Y, type DrawingExtend as Z, type DrawingIntent as _, type VisibleRange as a, type DrawingLine as a0, type DrawingLinefill as a1, type DrawingMode as a2, type DrawingPoint as a3, type DrawingPolyline as a4, type DrawingStyle as a5, type DrawingTable as a6, type DrawingText as a7, type DrawingXLoc as a8, type DrawingsOption as a9, type SchemaPatch as aA, type SeriesKind as aB, type SeriesPoint as aC, type SeriesSpec as aD, type SeriesValueDelta as aE, type SettingsField as aF, type SettingsSchema as aG, type SettingsVisibilityPolicy as aH, type TableCell as aI, type TableMerge as aJ, type TablePosition as aK, type ToolbarGroupConfig as aL, type TradeExecution as aM, type ValuePatch as aN, buildToolbar as aO, defaultToolbar as aP, inputVisible as aQ, type PaneInfo as aR, type Fill as aa, type FillGradientStop as ab, type IndicatorMeta as ac, type InputCondition as ad, type InputSchema as ae, type InputType as af, type InputWhen as ag, type LabelStyle as ah, type LabelYLoc as ai, type LineLikeKind as aj, type LineLikeSeries as ak, type LineLikeStyle as al, type MarkerPoint as am, type MarkerSeries as an, type MarketSnapshot as ao, type MarketSwitch as ap, type PaneAxis as aq, type PaneAxisBand as ar, type PaneHint as as, type PaneKind as at, type PolylinePoint as au, type PriceLine as av, type Projector as aw, type ProviderName as ax, type RendererConstructor as ay, type Scene as az, type VelaOptions as b, type VelaTheme as c, type MarketSession as d, type RendererDisplayOptions as e, type IndicatorRenderHandle as f, type IndicatorStatus as g, type Pane as h, type PaneAction as i, type MoveTarget as j, type IndicatorModel as k, type ScenePatch as l, type InputValue as m, type SymbolPickerFn as n, type LegendActionView as o, type InputChangeEvent as p, type ClickEvent as q, type DataWindowReadout as r, type IDrawingsRendererPort as s, type Millis as t, type SnapMode as u, type DrawingTypeKey as v, type ToolbarDefinition as w, type AddIndicatorOptions as x, type BoxFontFamily as y, type BoxHAlign as z };

package/dist/{options-YdiaaVjt.d.ts → options-BaVTMXaO.d.ts}

@@ -434,6 +434,17 @@ interface IndicatorMeta {
 }
 /** Where an indicator's plots are placed. */
 type PaneHint = 'price' | 'new';
+/** One label of a categorical pane axis: `frac` is the label's center as a fraction of
+ *  the pane's height (0 = top, 1 = bottom). */
+interface PaneAxisBand {
+    frac: number;
+    label: string;
+}
+/** A pane's value-axis override (see {@link IndicatorModel.paneAxis}): `'none'` = a
+ *  blank axis; band labels = a categorical axis, one label per content band/row. */
+type PaneAxis = 'none' | {
+    bands: PaneAxisBand[];
+};
 /**
  * Everything one `addIndicator()` produces — the unit the orchestrator mounts
  * on the renderer. Renderer-neutral.
@@ -458,6 +469,17 @@ interface IndicatorModel {
     native?: {
         type: string;
     };
+    /**
+     * Value-axis override for the pane this indicator OWNS — declared by content that is
+     * not value-mapped (e.g. a bespoke renderer layer painting in pixel bands), where a
+     * derived price scale would label meaningless numbers. `'none'` leaves the axis blank;
+     * band labels place text at fractions of the pane's height (a categorical axis — one
+     * label per band/row, e.g. `frac: 0.25` centers a label in the top quarter). Either way
+     * the renderer draws no price ticks, no horizontal gridlines, and no crosshair value
+     * chip in that pane. Only honored while such indicators are the pane's sole content —
+     * any real series merged into the pane takes the scale (and its labels) back over.
+     */
+    paneAxis?: PaneAxis;
     /** Resolved pane id, filled in by the orchestrator after routing. */
     paneId?: string;
     /**
@@ -1417,11 +1439,22 @@ interface IChartRenderer {
     /** A chart type's SDK settings changed (dialog edit / applyConfig) — the core forwards
      *  them to the type's data engine. */
     onChartTypeSettingsChange?(cb: (typeId: string, values: Record<string, unknown>) => void): Unsubscribe;
-    /** Host-app settings tabs (callback rows) shown by the renderer's settings dialog. */
+    /** Host-app settings tabs (callback rows) shown by the renderer's settings dialog.
+     *  `id` names a section for the visibility policy (defaults to the title's slug). */
     setSettingsSections?(sections: ReadonlyArray<{
         title: string;
         rows: readonly unknown[];
+        id?: string;
     }>): void;
+    /** Settings-dialog visibility policy: `hidden` lists setting ids to hide (a tab, a
+     *  group, or a row — subtree semantics). Presentation-only: hidden values keep
+     *  being stored and applied. Optional — a renderer without a settings dialog omits it. */
+    setSettingsVisibility?(policy: {
+        hidden?: readonly string[];
+    }): void;
+    /** Every addressable setting id of this chart (built-ins, chart-type sections,
+     *  host sections) — the discovery surface for the visibility policy. */
+    listSettingsIds?(): string[];
     /**
      * The host shell's chrome size class. `'mobile'` asks the renderer's own chrome
      * (dialogs, toolbars, buttons) for its touch-first presentation — fullscreen
@@ -1562,6 +1595,19 @@ interface VelaOptions extends MarketConfig {
      *  price pane, on their own scale (they never affect the price autoscale). Added
      *  automatically on chart creation (native renderer) — pass `false` to opt out. */
     volume?: boolean;
+    /** Settings-dialog visibility policy. Default: everything visible. `hidden` lists
+     *  setting ids to hide — a tab (`'canvas'`), a group (`'canvas.grid'`), or a single
+     *  row (`'canvas.grid.vertical'`); an id hides its whole subtree, and a tab with
+     *  nothing left disappears from the rail. Hiding is presentation-only: hidden
+     *  values keep being stored and applied. Enumerate the addressable ids of a live
+     *  chart with `chart.renderer.listSettingsIds()`; the catalog is documented in
+     *  docs/user/options.md. */
+    settings?: SettingsVisibilityPolicy;
+}
+/** Settings-dialog visibility policy (see `VelaOptions.settings`). */
+interface SettingsVisibilityPolicy {
+    /** Setting ids to hide — a tab, a group, or a row; an id hides its subtree. */
+    hidden?: readonly string[];
 }
 /** Per-feature native-renderer animation toggles. */
 interface AnimationConfig {
@@ -1637,4 +1683,4 @@ interface AddIndicatorOptions {
     title?: string;
 }
 
-export { type DrawingLabel as $, type AxisLongPressEvent as A, type Background as B, type CrosshairEvent as C, Drawing as D, type BoxTextSize as E, type BoxVAlign as F, type CandleBarColor as G, type CandleSeries as H, type IChartRenderer as I, type CandleStyle as J, type DataWindowGroup as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type DataWindowOHLC as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type DataWindowRow as W, type DirtyRange as X, type DrawingBox as Y, type DrawingExtend as Z, type DrawingIntent as _, type VisibleRange as a, type DrawingLine as a0, type DrawingLinefill as a1, type DrawingMode as a2, type DrawingPoint as a3, type DrawingPolyline as a4, type DrawingStyle as a5, type DrawingTable as a6, type DrawingText as a7, type DrawingXLoc as a8, type DrawingsOption as a9, type SeriesPoint as aA, type SeriesSpec as aB, type SeriesValueDelta as aC, type SettingsField as aD, type SettingsSchema as aE, type TableCell as aF, type TableMerge as aG, type TablePosition as aH, type ToolbarGroupConfig as aI, type TradeExecution as aJ, type ValuePatch as aK, buildToolbar as aL, defaultToolbar as aM, inputVisible as aN, type PaneInfo as aO, type Fill as aa, type FillGradientStop as ab, type IndicatorMeta as ac, type InputCondition as ad, type InputSchema as ae, type InputType as af, type InputWhen as ag, type LabelStyle as ah, type LabelYLoc as ai, type LineLikeKind as aj, type LineLikeSeries as ak, type LineLikeStyle as al, type MarkerPoint as am, type MarkerSeries as an, type MarketSnapshot as ao, type MarketSwitch as ap, type PaneHint as aq, type PaneKind as ar, type PolylinePoint as as, type PriceLine as at, type Projector as au, type ProviderName as av, type RendererConstructor as aw, type Scene as ax, type SchemaPatch as ay, type SeriesKind as az, type VelaOptions as b, type VelaTheme as c, type MarketSession as d, type RendererDisplayOptions as e, type IndicatorRenderHandle as f, type IndicatorStatus as g, type Pane as h, type PaneAction as i, type MoveTarget as j, type IndicatorModel as k, type ScenePatch as l, type InputValue as m, type SymbolPickerFn as n, type LegendActionView as o, type InputChangeEvent as p, type ClickEvent as q, type DataWindowReadout as r, type IDrawingsRendererPort as s, type Millis as t, type SnapMode as u, type DrawingTypeKey as v, type ToolbarDefinition as w, type AddIndicatorOptions as x, type BoxFontFamily as y, type BoxHAlign as z };
+export { type DrawingLabel as $, type AxisLongPressEvent as A, type Background as B, type CrosshairEvent as C, Drawing as D, type BoxTextSize as E, type BoxVAlign as F, type CandleBarColor as G, type CandleSeries as H, type IChartRenderer as I, type CandleStyle as J, type DataWindowGroup as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type DataWindowOHLC as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type DataWindowRow as W, type DirtyRange as X, type DrawingBox as Y, type DrawingExtend as Z, type DrawingIntent as _, type VisibleRange as a, type DrawingLine as a0, type DrawingLinefill as a1, type DrawingMode as a2, type DrawingPoint as a3, type DrawingPolyline as a4, type DrawingStyle as a5, type DrawingTable as a6, type DrawingText as a7, type DrawingXLoc as a8, type DrawingsOption as a9, type SchemaPatch as aA, type SeriesKind as aB, type SeriesPoint as aC, type SeriesSpec as aD, type SeriesValueDelta as aE, type SettingsField as aF, type SettingsSchema as aG, type SettingsVisibilityPolicy as aH, type TableCell as aI, type TableMerge as aJ, type TablePosition as aK, type ToolbarGroupConfig as aL, type TradeExecution as aM, type ValuePatch as aN, buildToolbar as aO, defaultToolbar as aP, inputVisible as aQ, type PaneInfo as aR, type Fill as aa, type FillGradientStop as ab, type IndicatorMeta as ac, type InputCondition as ad, type InputSchema as ae, type InputType as af, type InputWhen as ag, type LabelStyle as ah, type LabelYLoc as ai, type LineLikeKind as aj, type LineLikeSeries as ak, type LineLikeStyle as al, type MarkerPoint as am, type MarkerSeries as an, type MarketSnapshot as ao, type MarketSwitch as ap, type PaneAxis as aq, type PaneAxisBand as ar, type PaneHint as as, type PaneKind as at, type PolylinePoint as au, type PriceLine as av, type Projector as aw, type ProviderName as ax, type RendererConstructor as ay, type Scene as az, type VelaOptions as b, type VelaTheme as c, type MarketSession as d, type RendererDisplayOptions as e, type IndicatorRenderHandle as f, type IndicatorStatus as g, type Pane as h, type PaneAction as i, type MoveTarget as j, type IndicatorModel as k, type ScenePatch as l, type InputValue as m, type SymbolPickerFn as n, type LegendActionView as o, type InputChangeEvent as p, type ClickEvent as q, type DataWindowReadout as r, type IDrawingsRendererPort as s, type Millis as t, type SnapMode as u, type DrawingTypeKey as v, type ToolbarDefinition as w, type AddIndicatorOptions as x, type BoxFontFamily as y, type BoxHAlign as z };

package/dist/{plugin-Bcone6Vh.d.ts → plugin-9koBjc5H.d.ts}

@@ -1,9 +1,9 @@
-import { v as DrawingTypeKey, a5 as DrawingStyle, S as SerializedDrawing, D as Drawing, az as SeriesKind, O as OHLCV, c as VelaTheme } from './options-YdiaaVjt.js';
-import { b as DataControl } from './contributions-DatoAzMx.js';
+import { v as DrawingTypeKey, a5 as DrawingStyle, S as SerializedDrawing, D as Drawing, aB as SeriesKind, O as OHLCV, c as VelaTheme } from './options-BaVTMXaO.js';
+import { c as DataControl } from './contributions-Z12BrWCy.js';
 import './side-panel-CT9ZwIGz.js';
 import './icons-BZYbJXSV.js';
 import './keymap-CGOz5F5f.js';
-import './DataProvider-BmHkcwvJ.js';
+import './DataProvider-BSLlBpB9.js';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
@@ -643,7 +643,9 @@ interface RendererLayerDefinition {
     /** Stacking: `'below-data'` = behind the candles (reveal-under styles); `'above-data'` =
      *  over the candles, under the chrome/axes. Default `'above-data'`. A layer owned by a
      *  native indicator (its type equals the layer id) follows that indicator's z key in
-     *  the pane stacking instead (`seriesOrder` / the object tree), mounting in front. */
+     *  the pane stacking instead (`seriesOrder` / the object tree), mounting in front.
+     *  Either way the gridlines stay BELOW every layer (they live on the backdrop canvas
+     *  at the bottom of the pile) — no stacking puts a layer behind the grid. */
     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. */

package/dist/{plugin-DO_DX0gp.d.cts → plugin-BXhDHTYn.d.cts}

@@ -1,9 +1,9 @@
-import { v as DrawingTypeKey, a5 as DrawingStyle, S as SerializedDrawing, D as Drawing, az as SeriesKind, O as OHLCV, c as VelaTheme } from './options-YdiaaVjt.cjs';
-import { b as DataControl } from './contributions-2bEmCF9S.cjs';
+import { v as DrawingTypeKey, a5 as DrawingStyle, S as SerializedDrawing, D as Drawing, aB as SeriesKind, O as OHLCV, c as VelaTheme } from './options-BaVTMXaO.cjs';
+import { c as DataControl } from './contributions-Hv4_cOJo.cjs';
 import './side-panel-CT9ZwIGz.cjs';
 import './icons-BZYbJXSV.cjs';
 import './keymap-CGOz5F5f.cjs';
-import './DataProvider-DrN7ZIou.cjs';
+import './DataProvider-BsQM2WNH.cjs';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
@@ -643,7 +643,9 @@ interface RendererLayerDefinition {
     /** Stacking: `'below-data'` = behind the candles (reveal-under styles); `'above-data'` =
      *  over the candles, under the chrome/axes. Default `'above-data'`. A layer owned by a
      *  native indicator (its type equals the layer id) follows that indicator's z key in
-     *  the pane stacking instead (`seriesOrder` / the object tree), mounting in front. */
+     *  the pane stacking instead (`seriesOrder` / the object tree), mounting in front.
+     *  Either way the gridlines stay BELOW every layer (they live on the backdrop canvas
+     *  at the bottom of the pile) — no stacking puts a layer behind the grid. */
     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. */