@luxalgo/vela 0.6.4 → 0.6.6

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-CkiStRaI.cjs';
+import { D as DrawingsDocument, R as Resolved } from './contributions-DNMqrAuw.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, 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, O as StrategyState, Q as StrategyTrade, T as TypedEventBus, V as Vela, U as VelaDeps, X as VelaEventMap, Y as VisibleBarRange, Z as WidgetActionDescriptor, _ as WidgetActionTarget, $ as WidgetAttachment, W as WidgetContext, a0 as getNativeIndicator, a1 as legendActions, a2 as nativeIndicatorDescriptors, a3 as nativeIndicatorTypes, a4 as registerDefaultEngine, a5 as registerLegendAction, a6 as registerNativeIndicator, a7 as registerSidePanel, a8 as registerStatePersistence, a9 as registerWidgetAction, aa as registerWidgetAttachment, ab as resolveEngines, ac as sidePanels, ad as statePersistenceHandlers, ae as unregisterDefaultEngine, af as unregisterLegendAction, ag as unregisterNativeIndicator, ah as unregisterSidePanel, ai as unregisterStatePersistence, aj as unregisterWidgetAction, ak as unregisterWidgetAttachment, al as widgetActions, am as widgetAttachments } from './contributions-DNMqrAuw.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-DDUYw2qP.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-CN8U2__Q.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,9 +348,12 @@ 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;
+    /** Last applied layer-canvas order (ids below + above the data canvas) — re-slotted only on change. */
+    private layerOrderSig;
     private attributionEl;
     private attributionEnabled;
     /** Host-supplied mark shown INSTEAD of the built-in one (`attribution: '<html>'`). */
@@ -426,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;
@@ -674,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;
@@ -800,6 +819,8 @@ declare class NativeRenderer implements IChartRenderer {
     private renderFrame;
     /** Repaint the SDK layers that opted into cursor tracking (their own canvas only). */
     private repaintCursorLayers;
+    /** Blank one SDK layer canvas (a collapsed host pane suppresses the layer's painting). */
+    private clearLayerCanvas;
     /** 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. */
@@ -857,10 +878,33 @@ declare class NativeRenderer implements IChartRenderer {
     private paneMasterTitle;
     /** The pane a bespoke-layer native indicator (volume/vpvr) currently lives in (null = not mounted). */
     private nativeLayerPane;
+    /** The mounted native indicator that OWNS an SDK layer — the one whose type equals the
+     *  layer id (the id doubles as the data channel, so the pairing is the SDK's own
+     *  contract). Null for chart-type channels and while the owner is hidden (a hidden
+     *  indicator leaves the scene; its cleared data channel paints nothing anyway). */
+    private layerOwner;
+    /** The pane an SDK layer paints on: its owner's pane, else the price pane. */
+    private layerPane;
+    /** The SDK layer canvases split around the data canvas, each side back-to-front:
+     *  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 (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
+     *  every data frame; a no-op when the signature is unchanged. Re-inserting an
+     *  absolutely-positioned, pointer-transparent canvas repaints nothing by itself. */
+    private syncLayerCanvasOrder;
     /** True when an active volume layer is this study pane's ONLY content — so its scale should
      *  come from volume, not the empty {0,1} placeholder. (In the price pane, or alongside a real
      *  series, volume stays a bottom overlay and the master scale wins.) */
     private volumeOwnsPane;
+    /** True when this study pane's master content is only SDK-layer natives (series-less
+     *  models whose type names a mounted layer) — its scale then follows the visible bars
+     *  (see the call site). Any real master series takes over the scale as usual. */
+    private layerNativesOwnPane;
     /** Per-pane scale state for a host UI (e.g. a price-axis context menu): the pane's pixel
      *  band (`top`/`height`, so a click y maps to a pane) plus its current axis `mode`/`log`.
      *  Top-to-bottom order. Every pane is independent — the price pane from the scene setting,
@@ -1115,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
@@ -1141,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;

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-BeCMF1VQ.js';
+import { D as DrawingsDocument, R as Resolved } from './contributions-BqCIsbaP.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, 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, O as StrategyState, Q as StrategyTrade, T as TypedEventBus, V as Vela, U as VelaDeps, X as VelaEventMap, Y as VisibleBarRange, Z as WidgetActionDescriptor, _ as WidgetActionTarget, $ as WidgetAttachment, W as WidgetContext, a0 as getNativeIndicator, a1 as legendActions, a2 as nativeIndicatorDescriptors, a3 as nativeIndicatorTypes, a4 as registerDefaultEngine, a5 as registerLegendAction, a6 as registerNativeIndicator, a7 as registerSidePanel, a8 as registerStatePersistence, a9 as registerWidgetAction, aa as registerWidgetAttachment, ab as resolveEngines, ac as sidePanels, ad as statePersistenceHandlers, ae as unregisterDefaultEngine, af as unregisterLegendAction, ag as unregisterNativeIndicator, ah as unregisterSidePanel, ai as unregisterStatePersistence, aj as unregisterWidgetAction, ak as unregisterWidgetAttachment, al as widgetActions, am as widgetAttachments } from './contributions-BqCIsbaP.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-JJq7M2it.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-WnvNNJOp.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,9 +348,12 @@ 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;
+    /** Last applied layer-canvas order (ids below + above the data canvas) — re-slotted only on change. */
+    private layerOrderSig;
     private attributionEl;
     private attributionEnabled;
     /** Host-supplied mark shown INSTEAD of the built-in one (`attribution: '<html>'`). */
@@ -426,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;
@@ -674,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;
@@ -800,6 +819,8 @@ declare class NativeRenderer implements IChartRenderer {
     private renderFrame;
     /** Repaint the SDK layers that opted into cursor tracking (their own canvas only). */
     private repaintCursorLayers;
+    /** Blank one SDK layer canvas (a collapsed host pane suppresses the layer's painting). */
+    private clearLayerCanvas;
     /** 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. */
@@ -857,10 +878,33 @@ declare class NativeRenderer implements IChartRenderer {
     private paneMasterTitle;
     /** The pane a bespoke-layer native indicator (volume/vpvr) currently lives in (null = not mounted). */
     private nativeLayerPane;
+    /** The mounted native indicator that OWNS an SDK layer — the one whose type equals the
+     *  layer id (the id doubles as the data channel, so the pairing is the SDK's own
+     *  contract). Null for chart-type channels and while the owner is hidden (a hidden
+     *  indicator leaves the scene; its cleared data channel paints nothing anyway). */
+    private layerOwner;
+    /** The pane an SDK layer paints on: its owner's pane, else the price pane. */
+    private layerPane;
+    /** The SDK layer canvases split around the data canvas, each side back-to-front:
+     *  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 (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
+     *  every data frame; a no-op when the signature is unchanged. Re-inserting an
+     *  absolutely-positioned, pointer-transparent canvas repaints nothing by itself. */
+    private syncLayerCanvasOrder;
     /** True when an active volume layer is this study pane's ONLY content — so its scale should
      *  come from volume, not the empty {0,1} placeholder. (In the price pane, or alongside a real
      *  series, volume stays a bottom overlay and the master scale wins.) */
     private volumeOwnsPane;
+    /** True when this study pane's master content is only SDK-layer natives (series-less
+     *  models whose type names a mounted layer) — its scale then follows the visible bars
+     *  (see the call site). Any real master series takes over the scale as usual. */
+    private layerNativesOwnPane;
     /** Per-pane scale state for a host UI (e.g. a price-axis context menu): the pane's pixel
      *  band (`top`/`height`, so a click y maps to a pane) plus its current axis `mode`/`log`.
      *  Top-to-bottom order. Every pane is independent — the price pane from the scene setting,
@@ -1115,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
@@ -1141,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;

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-6FA4TDUF.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-JQFO2WMU.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, registerStatePersistence, registerWidgetAction, registerWidgetAttachment, rendererDefaults, rendererLayers, resolveEngines, settingsRowValueKeys, sidePanels, statePersistenceHandlers, tickerModifierIds, unregisterChartType, unregisterDefaultEngine, unregisterLegendAction, unregisterNativeIndicator, unregisterRendererDefaults, unregisterRendererLayer, unregisterSidePanel, unregisterStatePersistence, unregisterWidgetAction, unregisterWidgetAttachment, widgetActions, widgetAttachments } from './chunk-OEUGUXL7.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 };