@luxalgo/vela 0.5.0 → 0.5.2

package/dist/{contributions-o1GRKPI_.d.cts → contributions-Ci_i3IN2.d.cts}

@@ -1,5 +1,5 @@
-import { s as Millis, ab as InputSchema, aa as IndicatorMeta, P as PriceStyle, O as OHLCV, l as InputValue, j as IndicatorModel, i as MoveTarget, ax as SeriesSpec, a8 as Fill, B as Background, ap as PriceLine, _ as DrawingLine, W as DrawingBox, Z as DrawingLabel, a2 as DrawingPolyline, $ as DrawingLinefill, a4 as DrawingTable, f as IndicatorStatus, a as VisibleRange, c as VelaTheme, u as DrawingTypeKey, t as SnapMode, a0 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, n as LegendActionView, U as Unsubscribe, C as CrosshairEvent, q as DataWindowReadout, m as SymbolPickerFn, aJ as PaneInfo, S as SerializedDrawing, a7 as DrawingsOption, D as Drawing, b as VelaOptions, A as AddIndicatorOptions, al as MarketSwitch, ak as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-Q-576hIi.cjs';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-DKNDHpNv.cjs';
+import { s as Millis, ac as InputSchema, ab as IndicatorMeta, P as PriceStyle, O as OHLCV, l as InputValue, j as IndicatorModel, i as MoveTarget, ay as SeriesSpec, a9 as Fill, B as Background, aq as PriceLine, $ as DrawingLine, X as DrawingBox, _ as DrawingLabel, a3 as DrawingPolyline, a0 as DrawingLinefill, a5 as DrawingTable, f as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, u as DrawingTypeKey, t as SnapMode, a1 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, n as LegendActionView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, q as DataWindowReadout, m as SymbolPickerFn, aK as PaneInfo, a8 as DrawingsOption, D as Drawing, b as VelaOptions, w as AddIndicatorOptions, am as MarketSwitch, al as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-XTBpbx0s.cjs';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-gnzv-dgc.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -434,7 +434,13 @@ interface NativeIndicator {
  */
 interface NativeIndicatorDescriptor {
     readonly type: string;
+    /** Full display name (picker, settings header, handle title). */
     readonly title: string;
+    /**
+     * Compact name for the on-chart legend chip. Absent ⇒ {@link title}. The picker and
+     * settings dialog keep the full title either way.
+     */
+    readonly shortTitle?: string;
     readonly paneHint: 'price' | 'new';
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
@@ -571,7 +577,7 @@ interface VelaEventMap extends Record<string, unknown> {
      * previous identity so hosts can re-key per-symbol state (e.g. swap user-drawing
      * documents between symbols).
      */
-    'market:changed': {
+    "market:changed": {
         symbol: string;
         timeframe: string;
         prev: {
@@ -587,7 +593,7 @@ interface VelaEventMap extends Record<string, unknown> {
      * their own visuals here. Exactly one `load:end` follows. A depth-only reload
      * (`bars`) keeps the chart painted and fires neither.
      */
-    'load:start': {
+    "load:start": {
         symbol: string;
         timeframe: string;
         firstLoad: boolean;
@@ -598,39 +604,39 @@ interface VelaEventMap extends Record<string, unknown> {
      * fetch, an empty market, or a parked symbol nothing serves). Counterpart of
      * `load:start`; plugins restore or rebuild their visuals here.
      */
-    'load:end': {
+    "load:end": {
         symbol: string;
         timeframe: string;
         bars: number;
     };
-    'indicator:added': {
+    "indicator:added": {
         id: string;
     };
-    'indicator:removed': {
+    "indicator:removed": {
         id: string;
     };
-    'indicator:error': {
+    "indicator:error": {
         id: string;
         error: Error;
     };
     /** No registered provider can serve the chart symbol — the load is PARKED, not failed:
      *  it resumes by itself if a capable provider registers later. */
-    'data:unresolved': {
+    "data:unresolved": {
         symbol: string;
         providers: string[];
     };
     /** An indicator was moved/merged to another pane (`chart.panes` / legend / object tree). */
-    'indicator:moved': {
+    "indicator:moved": {
         id: string;
         paneId: string;
     };
     /** An indicator was shown/hidden (legend eye, `handle.setVisible`, or object tree). */
-    'indicator:visibility': {
+    "indicator:visibility": {
         id: string;
         visible: boolean;
     };
     /** A pane's layout changed: order, collapse/maximize, creation or removal. */
-    'pane:changed': undefined;
+    "pane:changed": undefined;
     /**
      * The app theme changed — `chart.setTheme(...)` or the in-chart settings dialog's
      * Canvas → Theme row. Payload is the RESOLVED theme; host chrome around the chart
@@ -638,53 +644,60 @@ interface VelaEventMap extends Record<string, unknown> {
      * cosmetic edits (`layout.background` through the config), which deliberately
      * leave the app theme alone.
      */
-    'theme:changed': VelaTheme;
+    "theme:changed": VelaTheme;
     /** A study pane was reordered one slot (`dir`) — carries enough to invert for undo/redo. */
-    'pane:moved': {
+    "pane:moved": {
         paneId: string;
-        dir: 'up' | 'down';
+        dir: "up" | "down";
     };
     /** A user drawing was created (interactively or via `chart.drawings.add`). */
-    'drawing:created': {
+    "drawing:created": {
         id: string;
     };
+    /** An interactive placement is in progress — the ghost's current shape after each
+     *  anchor click / cursor move, `null` when placement ends (finalized or
+     *  cancelled). Transient: nothing is in the store yet. Multi-chart hosts mirror
+     *  it on linked charts via `drawings.setExternalGhost`. */
+    "drawing:draft": {
+        doc: SerializedDrawing | null;
+    };
     /** A user drawing's anchors/style/text changed. */
-    'drawing:edited': {
+    "drawing:edited": {
         id: string;
     };
     /** Selection changed (`id` is null when nothing is selected). */
-    'drawing:selected': {
+    "drawing:selected": {
         id: string | null;
     };
     /** The favorite-tool set changed (star toggles or a bulk restore). */
-    'drawing:favorites': {
+    "drawing:favorites": {
         favorites: string[];
     };
     /** The armed drawing tool changed — toolbar click, one-shot tool finishing (back to
      *  the pointer, `null`), or a programmatic `drawings.setTool`. */
-    'drawing:tool': {
+    "drawing:tool": {
         type: DrawingTypeKey | null;
     };
     /** The magnet snap mode changed (in-chart toolbar or `drawings.setSnapMode`). */
-    'drawing:snap': {
+    "drawing:snap": {
         mode: SnapMode;
     };
     /** Stay-in-drawing-mode changed (in-chart toolbar or `drawings.setStayMode`) — when
      *  on, finishing a drawing leaves the tool armed. */
-    'drawing:stay': {
+    "drawing:stay": {
         on: boolean;
     };
     /** The renderer-local mode changed: measure ruler, eraser, or none — including the
      *  mutual-exclusion exits (arming a tool leaves measure/eraser). */
-    'drawing:mode': {
+    "drawing:mode": {
         mode: DrawingMode;
     };
     /** A user drawing was removed. */
-    'drawing:removed': {
+    "drawing:removed": {
         id: string;
     };
     /** The user requested a drawing's settings popup. */
-    'drawing:settings': {
+    "drawing:settings": {
         id: string;
     };
     /**
@@ -695,11 +708,11 @@ interface VelaEventMap extends Record<string, unknown> {
      * indicator while streaming, and only emitted for engines that expose an execution
      * context. Native (core-computed) indicators never fire it — they run no script.
      */
-    'script:run': ScriptRun;
+    "script:run": ScriptRun;
     /** An indicator's execution context advanced (run finished, or throttled during
      *  streaming) — re-pull `handle.context()` if you consume it. Prefer `script:run`,
      *  which delivers the data rather than a signal to go fetch it. */
-    'context:changed': {
+    "context:changed": {
         id: string;
     };
     /** A live tick: the forming bar was updated or a new bar appended. */
@@ -709,12 +722,12 @@ interface VelaEventMap extends Record<string, unknown> {
      * debounced; the engine re-run debounce is separate). Payload = `{from, to}` in
      * epoch-ms. The seam viewport-sync links between charts build on.
      */
-    'viewport:changed': {
+    "viewport:changed": {
         from: number;
         to: number;
     };
     /** A deep-history backfill chunk landed (`loaded` of `target` bars are on the chart). */
-    'history:progress': {
+    "history:progress": {
         loaded: number;
         target: number;
     };
@@ -724,8 +737,8 @@ interface VelaEventMap extends Record<string, unknown> {
      * the data was non-monotonic — the chart keeps what loaded. Fires exactly once, including
      * for small/offline charts (immediately after their single load).
      */
-    'history:complete': {
-        reason: 'depth' | 'genesis' | 'aborted';
+    "history:complete": {
+        reason: "depth" | "genesis" | "aborted";
         oldestTime: number;
         barsLoaded: number;
     };
@@ -814,6 +827,20 @@ declare class RendererControl {
      * degradation as the sync ghost crosshair.
      */
     setLegendActions(provider: ((indicatorId: string) => LegendActionView[]) | null): void;
+    /**
+     * Replace the indicator legend's fold toggle with a host action (or restore it with
+     * `null`) — multi-chart shells point the chip at their indicator overview instead of
+     * unfolding rows in place. Silent no-op on a renderer without a foldable legend.
+     */
+    setLegendOverviewAction(action: (() => void) | null): this;
+    /** Whether the active renderer can open a per-indicator settings dialog. */
+    get supportsIndicatorSettings(): boolean;
+    /**
+     * Open one indicator's settings dialog — the programmatic twin of the legend gear
+     * (see {@link supportsIndicatorSettings}). Silent no-op without the seam or for an
+     * unknown id.
+     */
+    openIndicatorSettings(indicatorId: string): this;
     /**
      * Export the current chart as a PNG data URL, or null if the active renderer
      * doesn't support it (warns). DOM overlays (tables, legend) are not included.
@@ -844,6 +871,8 @@ declare class RendererControl {
      * public seam host chrome (status lines, data windows) builds on.
      */
     onCrosshairMove(cb: (e: CrosshairEvent) => void): Unsubscribe;
+    /** Touch long-press on a price or time axis strip — silent no-op without the seam. */
+    onAxisLongPress(cb: (e: AxisLongPressEvent) => void): Unsubscribe;
     /**
      * The current data-window readout — the hovered bar's date/time and OHLCV plus every
      * indicator's value there, each already formatted on its pane's scale (the latest bar when
@@ -889,6 +918,10 @@ declare class RendererControl {
         title: string;
         rows: readonly unknown[];
     }>): this;
+    /** Tell the renderer's own chrome which size class the host shell is in —
+     *  `'mobile'` switches its dialogs/toolbars to the touch-first presentation.
+     *  Silent no-op on a renderer without adaptive chrome. */
+    setLayoutMode(mode: 'mobile' | 'desktop'): this;
 }
 
 /** Callback surface `PanesControl` uses to drive the orchestrator. */
@@ -1005,6 +1038,9 @@ declare class DrawingController {
     setFavorites(types: readonly DrawingTypeKey[]): void;
     private pushFavorites;
     setToolbar(option: DrawingsOption): void;
+    /** Display (or clear) another chart's in-progress placement as a ghost — silently
+     *  inert on a renderer without the optional `setExternalGhost` seam. */
+    setExternalGhost(doc: SerializedDrawing | null): void;
     /** Push per-tool shortcut hints (pre-formatted display strings) to the toolbar flyouts. */
     setToolShortcuts(map: Readonly<Partial<Record<DrawingTypeKey, string>>>): void;
     add(type: DrawingTypeKey, init?: AddInit): Drawing | null;
@@ -1108,6 +1144,11 @@ declare class DrawingsControl {
      *  display strings (e.g. `'Alt+T'`, `'⌥T'`) — the host owns the keymap and the
      *  platform formatting, so hints always match the host's actual bindings. */
     setToolShortcuts(map: Readonly<Partial<Record<DrawingTypeKey, string>>>): this;
+    /** Display another chart's in-progress placement as a GHOST at reduced opacity
+     *  (`null` clears it) — how a multi-chart host mirrors `drawing:draft` onto linked
+     *  charts. Never a real drawing: no store entry, no selection, no persistence.
+     *  Silently inert on a renderer without the optional seam. */
+    setExternalGhost(doc: SerializedDrawing | null): this;
     /** Create a drawing programmatically (no clicking). Returns it, or null if unsupported. */
     add(type: DrawingTypeKey, init?: AddInit): Drawing | null;
     remove(id: string): this;
@@ -1385,6 +1426,11 @@ interface WidgetActionDescriptor {
     icon?: string;
     /** Sort key within the contributed group (ascending; default 0). */
     order?: number;
+    /** Topbar only: which cluster the button joins. `'right'` (default) is the
+     *  right-hand tools cluster; `'left'` puts it with the PRIMARY chrome buttons —
+     *  right after the style/layout dropdowns, styled like them (the spot and look of
+     *  the built-in Indicators button, for actions that replace it). */
+    align?: 'left' | 'right';
     /** Runtime gate — omitted ⇒ always shown. */
     when?: (ctx: WidgetContext) => boolean;
     run: (ctx: WidgetContext) => void;

package/dist/{contributions-hX3EUyjG.d.ts → contributions-b6AVrqqG.d.ts}

@@ -1,5 +1,5 @@
-import { s as Millis, ab as InputSchema, aa as IndicatorMeta, P as PriceStyle, O as OHLCV, l as InputValue, j as IndicatorModel, i as MoveTarget, ax as SeriesSpec, a8 as Fill, B as Background, ap as PriceLine, _ as DrawingLine, W as DrawingBox, Z as DrawingLabel, a2 as DrawingPolyline, $ as DrawingLinefill, a4 as DrawingTable, f as IndicatorStatus, a as VisibleRange, c as VelaTheme, u as DrawingTypeKey, t as SnapMode, a0 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, n as LegendActionView, U as Unsubscribe, C as CrosshairEvent, q as DataWindowReadout, m as SymbolPickerFn, aJ as PaneInfo, S as SerializedDrawing, a7 as DrawingsOption, D as Drawing, b as VelaOptions, A as AddIndicatorOptions, al as MarketSwitch, ak as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-Q-576hIi.js';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-Dzd-Erlk.js';
+import { s as Millis, ac as InputSchema, ab as IndicatorMeta, P as PriceStyle, O as OHLCV, l as InputValue, j as IndicatorModel, i as MoveTarget, ay as SeriesSpec, a9 as Fill, B as Background, aq as PriceLine, $ as DrawingLine, X as DrawingBox, _ as DrawingLabel, a3 as DrawingPolyline, a0 as DrawingLinefill, a5 as DrawingTable, f as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, u as DrawingTypeKey, t as SnapMode, a1 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, n as LegendActionView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, q as DataWindowReadout, m as SymbolPickerFn, aK as PaneInfo, a8 as DrawingsOption, D as Drawing, b as VelaOptions, w as AddIndicatorOptions, am as MarketSwitch, al as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-XTBpbx0s.js';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-DTOEXKTI.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -434,7 +434,13 @@ interface NativeIndicator {
  */
 interface NativeIndicatorDescriptor {
     readonly type: string;
+    /** Full display name (picker, settings header, handle title). */
     readonly title: string;
+    /**
+     * Compact name for the on-chart legend chip. Absent ⇒ {@link title}. The picker and
+     * settings dialog keep the full title either way.
+     */
+    readonly shortTitle?: string;
     readonly paneHint: 'price' | 'new';
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
@@ -571,7 +577,7 @@ interface VelaEventMap extends Record<string, unknown> {
      * previous identity so hosts can re-key per-symbol state (e.g. swap user-drawing
      * documents between symbols).
      */
-    'market:changed': {
+    "market:changed": {
         symbol: string;
         timeframe: string;
         prev: {
@@ -587,7 +593,7 @@ interface VelaEventMap extends Record<string, unknown> {
      * their own visuals here. Exactly one `load:end` follows. A depth-only reload
      * (`bars`) keeps the chart painted and fires neither.
      */
-    'load:start': {
+    "load:start": {
         symbol: string;
         timeframe: string;
         firstLoad: boolean;
@@ -598,39 +604,39 @@ interface VelaEventMap extends Record<string, unknown> {
      * fetch, an empty market, or a parked symbol nothing serves). Counterpart of
      * `load:start`; plugins restore or rebuild their visuals here.
      */
-    'load:end': {
+    "load:end": {
         symbol: string;
         timeframe: string;
         bars: number;
     };
-    'indicator:added': {
+    "indicator:added": {
         id: string;
     };
-    'indicator:removed': {
+    "indicator:removed": {
         id: string;
     };
-    'indicator:error': {
+    "indicator:error": {
         id: string;
         error: Error;
     };
     /** No registered provider can serve the chart symbol — the load is PARKED, not failed:
      *  it resumes by itself if a capable provider registers later. */
-    'data:unresolved': {
+    "data:unresolved": {
         symbol: string;
         providers: string[];
     };
     /** An indicator was moved/merged to another pane (`chart.panes` / legend / object tree). */
-    'indicator:moved': {
+    "indicator:moved": {
         id: string;
         paneId: string;
     };
     /** An indicator was shown/hidden (legend eye, `handle.setVisible`, or object tree). */
-    'indicator:visibility': {
+    "indicator:visibility": {
         id: string;
         visible: boolean;
     };
     /** A pane's layout changed: order, collapse/maximize, creation or removal. */
-    'pane:changed': undefined;
+    "pane:changed": undefined;
     /**
      * The app theme changed — `chart.setTheme(...)` or the in-chart settings dialog's
      * Canvas → Theme row. Payload is the RESOLVED theme; host chrome around the chart
@@ -638,53 +644,60 @@ interface VelaEventMap extends Record<string, unknown> {
      * cosmetic edits (`layout.background` through the config), which deliberately
      * leave the app theme alone.
      */
-    'theme:changed': VelaTheme;
+    "theme:changed": VelaTheme;
     /** A study pane was reordered one slot (`dir`) — carries enough to invert for undo/redo. */
-    'pane:moved': {
+    "pane:moved": {
         paneId: string;
-        dir: 'up' | 'down';
+        dir: "up" | "down";
     };
     /** A user drawing was created (interactively or via `chart.drawings.add`). */
-    'drawing:created': {
+    "drawing:created": {
         id: string;
     };
+    /** An interactive placement is in progress — the ghost's current shape after each
+     *  anchor click / cursor move, `null` when placement ends (finalized or
+     *  cancelled). Transient: nothing is in the store yet. Multi-chart hosts mirror
+     *  it on linked charts via `drawings.setExternalGhost`. */
+    "drawing:draft": {
+        doc: SerializedDrawing | null;
+    };
     /** A user drawing's anchors/style/text changed. */
-    'drawing:edited': {
+    "drawing:edited": {
         id: string;
     };
     /** Selection changed (`id` is null when nothing is selected). */
-    'drawing:selected': {
+    "drawing:selected": {
         id: string | null;
     };
     /** The favorite-tool set changed (star toggles or a bulk restore). */
-    'drawing:favorites': {
+    "drawing:favorites": {
         favorites: string[];
     };
     /** The armed drawing tool changed — toolbar click, one-shot tool finishing (back to
      *  the pointer, `null`), or a programmatic `drawings.setTool`. */
-    'drawing:tool': {
+    "drawing:tool": {
         type: DrawingTypeKey | null;
     };
     /** The magnet snap mode changed (in-chart toolbar or `drawings.setSnapMode`). */
-    'drawing:snap': {
+    "drawing:snap": {
         mode: SnapMode;
     };
     /** Stay-in-drawing-mode changed (in-chart toolbar or `drawings.setStayMode`) — when
      *  on, finishing a drawing leaves the tool armed. */
-    'drawing:stay': {
+    "drawing:stay": {
         on: boolean;
     };
     /** The renderer-local mode changed: measure ruler, eraser, or none — including the
      *  mutual-exclusion exits (arming a tool leaves measure/eraser). */
-    'drawing:mode': {
+    "drawing:mode": {
         mode: DrawingMode;
     };
     /** A user drawing was removed. */
-    'drawing:removed': {
+    "drawing:removed": {
         id: string;
     };
     /** The user requested a drawing's settings popup. */
-    'drawing:settings': {
+    "drawing:settings": {
         id: string;
     };
     /**
@@ -695,11 +708,11 @@ interface VelaEventMap extends Record<string, unknown> {
      * indicator while streaming, and only emitted for engines that expose an execution
      * context. Native (core-computed) indicators never fire it — they run no script.
      */
-    'script:run': ScriptRun;
+    "script:run": ScriptRun;
     /** An indicator's execution context advanced (run finished, or throttled during
      *  streaming) — re-pull `handle.context()` if you consume it. Prefer `script:run`,
      *  which delivers the data rather than a signal to go fetch it. */
-    'context:changed': {
+    "context:changed": {
         id: string;
     };
     /** A live tick: the forming bar was updated or a new bar appended. */
@@ -709,12 +722,12 @@ interface VelaEventMap extends Record<string, unknown> {
      * debounced; the engine re-run debounce is separate). Payload = `{from, to}` in
      * epoch-ms. The seam viewport-sync links between charts build on.
      */
-    'viewport:changed': {
+    "viewport:changed": {
         from: number;
         to: number;
     };
     /** A deep-history backfill chunk landed (`loaded` of `target` bars are on the chart). */
-    'history:progress': {
+    "history:progress": {
         loaded: number;
         target: number;
     };
@@ -724,8 +737,8 @@ interface VelaEventMap extends Record<string, unknown> {
      * the data was non-monotonic — the chart keeps what loaded. Fires exactly once, including
      * for small/offline charts (immediately after their single load).
      */
-    'history:complete': {
-        reason: 'depth' | 'genesis' | 'aborted';
+    "history:complete": {
+        reason: "depth" | "genesis" | "aborted";
         oldestTime: number;
         barsLoaded: number;
     };
@@ -814,6 +827,20 @@ declare class RendererControl {
      * degradation as the sync ghost crosshair.
      */
     setLegendActions(provider: ((indicatorId: string) => LegendActionView[]) | null): void;
+    /**
+     * Replace the indicator legend's fold toggle with a host action (or restore it with
+     * `null`) — multi-chart shells point the chip at their indicator overview instead of
+     * unfolding rows in place. Silent no-op on a renderer without a foldable legend.
+     */
+    setLegendOverviewAction(action: (() => void) | null): this;
+    /** Whether the active renderer can open a per-indicator settings dialog. */
+    get supportsIndicatorSettings(): boolean;
+    /**
+     * Open one indicator's settings dialog — the programmatic twin of the legend gear
+     * (see {@link supportsIndicatorSettings}). Silent no-op without the seam or for an
+     * unknown id.
+     */
+    openIndicatorSettings(indicatorId: string): this;
     /**
      * Export the current chart as a PNG data URL, or null if the active renderer
      * doesn't support it (warns). DOM overlays (tables, legend) are not included.
@@ -844,6 +871,8 @@ declare class RendererControl {
      * public seam host chrome (status lines, data windows) builds on.
      */
     onCrosshairMove(cb: (e: CrosshairEvent) => void): Unsubscribe;
+    /** Touch long-press on a price or time axis strip — silent no-op without the seam. */
+    onAxisLongPress(cb: (e: AxisLongPressEvent) => void): Unsubscribe;
     /**
      * The current data-window readout — the hovered bar's date/time and OHLCV plus every
      * indicator's value there, each already formatted on its pane's scale (the latest bar when
@@ -889,6 +918,10 @@ declare class RendererControl {
         title: string;
         rows: readonly unknown[];
     }>): this;
+    /** Tell the renderer's own chrome which size class the host shell is in —
+     *  `'mobile'` switches its dialogs/toolbars to the touch-first presentation.
+     *  Silent no-op on a renderer without adaptive chrome. */
+    setLayoutMode(mode: 'mobile' | 'desktop'): this;
 }
 
 /** Callback surface `PanesControl` uses to drive the orchestrator. */
@@ -1005,6 +1038,9 @@ declare class DrawingController {
     setFavorites(types: readonly DrawingTypeKey[]): void;
     private pushFavorites;
     setToolbar(option: DrawingsOption): void;
+    /** Display (or clear) another chart's in-progress placement as a ghost — silently
+     *  inert on a renderer without the optional `setExternalGhost` seam. */
+    setExternalGhost(doc: SerializedDrawing | null): void;
     /** Push per-tool shortcut hints (pre-formatted display strings) to the toolbar flyouts. */
     setToolShortcuts(map: Readonly<Partial<Record<DrawingTypeKey, string>>>): void;
     add(type: DrawingTypeKey, init?: AddInit): Drawing | null;
@@ -1108,6 +1144,11 @@ declare class DrawingsControl {
      *  display strings (e.g. `'Alt+T'`, `'⌥T'`) — the host owns the keymap and the
      *  platform formatting, so hints always match the host's actual bindings. */
     setToolShortcuts(map: Readonly<Partial<Record<DrawingTypeKey, string>>>): this;
+    /** Display another chart's in-progress placement as a GHOST at reduced opacity
+     *  (`null` clears it) — how a multi-chart host mirrors `drawing:draft` onto linked
+     *  charts. Never a real drawing: no store entry, no selection, no persistence.
+     *  Silently inert on a renderer without the optional seam. */
+    setExternalGhost(doc: SerializedDrawing | null): this;
     /** Create a drawing programmatically (no clicking). Returns it, or null if unsupported. */
     add(type: DrawingTypeKey, init?: AddInit): Drawing | null;
     remove(id: string): this;
@@ -1385,6 +1426,11 @@ interface WidgetActionDescriptor {
     icon?: string;
     /** Sort key within the contributed group (ascending; default 0). */
     order?: number;
+    /** Topbar only: which cluster the button joins. `'right'` (default) is the
+     *  right-hand tools cluster; `'left'` puts it with the PRIMARY chrome buttons —
+     *  right after the style/layout dropdowns, styled like them (the spot and look of
+     *  the built-in Indicators button, for actions that replace it). */
+    align?: 'left' | 'right';
     /** Runtime gate — omitted ⇒ always shown. */
     when?: (ctx: WidgetContext) => boolean;
     run: (ctx: WidgetContext) => void;

package/dist/{history-LJkz4-sS.d.cts → history-Cf1lVsap.d.cts}

@@ -1,6 +1,6 @@
-import { V as VisibleRangePreset } from './options-Q-576hIi.cjs';
-import { D as DataProvider } from './DataProvider-DKNDHpNv.cjs';
-import { S as ScriptingEngine, V as Vela } from './contributions-o1GRKPI_.cjs';
+import { V as VisibleRangePreset } from './options-XTBpbx0s.cjs';
+import { D as DataProvider } from './DataProvider-gnzv-dgc.cjs';
+import { S as ScriptingEngine, V as Vela } from './contributions-Ci_i3IN2.cjs';
 
 interface RangePreset {
     /** Button label. */
@@ -85,8 +85,12 @@ declare function resolveIndicators(config: string | IndicatorManifest | Indicato
 
 /** The linkable dimensions. `crosshair` mirrors the pointer time onto same-group
  *  cells as GHOST crosshairs (renderers without the optional `setExternalCrosshair`
- *  seam simply never display one). */
-type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair';
+ *  seam simply never display one). `drawings` copies each NEWLY CREATED drawing onto
+ *  same-group cells and keeps the set linked: edits and removals of any member
+ *  follow. Link membership is session-scoped and survives a toggle-off (re-enabling
+ *  resumes edit/delete for drawings paired earlier; drawings created while off stay
+ *  independent). After a reload, every drawing is unpaired again. */
+type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair' | 'drawings';
 /**
  * One link's configuration: `false`/absent = off; `true` = ALL cells linked (one
  * implicit group); a record maps cell id → group name, and only cells sharing a group
@@ -98,6 +102,7 @@ interface SyncOptions {
     symbol?: SyncSetting;
     timeframe?: SyncSetting;
     crosshair?: SyncSetting;
+    drawings?: SyncSetting;
 }
 /** Splitter track weights along each grid axis. */
 interface TrackSizes {
@@ -129,6 +134,8 @@ interface CellState {
     watermark?: boolean;
     /** Indicator titles (the in-chart legend rows) visibility — a per-chart display pref. */
     indicatorTitles?: boolean;
+    /** Plot values beside the legend titles visibility — a per-chart display pref. */
+    indicatorValues?: boolean;
     /** The renderer's cosmetic config document (`renderer.getConfig()`). */
     rendererConfig?: unknown;
     /** The user-drawings document (`drawings.toJSON()`). */
@@ -247,6 +254,16 @@ interface VelaShellOptions {
     statusline?: boolean;
     watermark?: boolean;
     bottombar?: boolean;
+    /** The built-in indicator picker's entry points — the topbar button, the mobile-bar
+     *  item, and the `/` shortcut. `false` removes them, for hosts that replace the
+     *  picker with their own indicator UI (e.g. a contributed topbar action opening a
+     *  custom dialog). The `indicators` manifest still resolves and auto-adds. */
+    indicatorPicker?: boolean;
+    /** Chrome size class. `'auto'` (default) follows the CONTAINER width plus a
+     *  coarse-pointer heuristic; `'mobile'` / `'desktop'` pin it. Mobile swaps the
+     *  topbar + desktop bottombar for one touch-first bottom bar, presents pickers
+     *  fullscreen and menus as bottom drawers, and enables the touch chart gestures. */
+    layoutMode?: 'auto' | 'mobile' | 'desktop';
     /** Focus the chart when the shell mounts so keyboard shortcuts work from the first
      *  keystroke — no initial click needed. Default false: an embedded shell must never
      *  steal the page's focus from the host's own controls. */