@luxalgo/vela 0.8.4 → 0.9.0

package/dist/{contributions-BY3zSYiZ.d.ts → contributions-BjefWpxQ.d.ts}

@@ -1,5 +1,6 @@
-import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, a_ as SeriesSpec, ak as Fill, H as Background, aQ as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-CSXbjMM5.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-Byo8pEv0.js';
+import { y as Millis, aq as InputSchema, an as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, m as IndicatorModel, l as MoveTarget, aJ as PaneAxis, b0 as SeriesSpec, al as Fill, J as Background, aS as PriceLine, a8 as DrawingLine, a4 as DrawingBox, a7 as DrawingLabel, ac as DrawingPolyline, a9 as DrawingLinefill, ah as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, B as DrawingTypeKey, z as SnapMode, aa as DrawingMode, v as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, p as LegendActionView, q as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, s as ClickEvent, A as AxisLongPressEvent, w as DataWindowReadout, o as SymbolPickerFn, W as WallClock, bi as PaneInfo, ak as DrawingsOption, ae as DrawingSeriesGateway, bj as DrawingToolDefaults, bk as DrawingToolTemplate, D as Drawing, t as TimelineMark, u as MarkGroup, b as VelaOptions, G as AddIndicatorOptions, aI as MarketSwitch, F as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-D4L3_hv_.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-BGlB1zSc.js';
+import { M as MessageLike, T as Translator, c as LocaleChangedEvent, b as LocalizationOptions } from './types-BlrXRLIR.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -502,7 +503,13 @@ interface NativeIndicatorContext {
     bars(): readonly OHLCV[];
     /** Market-data access (trades / capabilities) for data-driven natives. */
     readonly data: DataControl;
-    /** Push a fresh render output; the chart mounts it (first call) or patches it (subsequent). */
+    /**
+     * Push a fresh render output; the chart mounts it (first call) or patches it (subsequent).
+     * Series payloads are index-aligned: one slot per bar of `bars()` AS IT STANDS AT THE
+     * CALL, first slot on its first bar. The chart keeps an emitted output on those bars
+     * when history later lands in front of them (or the oldest bars are trimmed), until the
+     * next emit replaces it.
+     */
     emit(out: NativeIndicatorOutput): void;
     /**
      * Push a BESPOKE render payload to the renderer's native layer for this indicator's type (for a
@@ -521,7 +528,8 @@ interface NativeIndicatorContext {
 interface NativeIndicator {
     /** Begin: compute + emit the first output. */
     start(ctx: NativeIndicatorContext, inputs: Record<string, InputValue>): void;
-    /** A live tick arrived (bars changed) — recompute + emit. */
+    /** The bars changed — a live tick, older history landing, or the candles re-derived
+     *  by a price style — recompute + emit. */
     onBars(): void;
     /** The viewport changed (scroll/zoom) — for range-aware natives (see `reactsToViewport`). */
     onViewport(range: VisibleRange): void;
@@ -533,7 +541,10 @@ interface NativeIndicator {
     suspend(): void;
     /** Shown again — resume + re-emit. */
     resume(): void;
-    /** Removed — full teardown (clear caches, stop timers). Only ever called after `start`. */
+    /** Removed, or replaced by a fresh instance (a market switch stops it as the switch
+     *  begins) — full teardown (clear caches, stop timers). Only ever called after `start`.
+     *  Pushes made inside `stop()` still land (a layer-backed native clears its channel
+     *  here); once it returns, the context drops every push and emit. */
     stop(): void;
 }
 /**
@@ -543,18 +554,30 @@ interface NativeIndicator {
  */
 interface NativeIndicatorDescriptor {
     readonly type: string;
-    /** Full display name (picker, settings header, handle title). */
-    readonly title: string;
+    /** Full display name (picker, settings header, handle title). A message (`msg()`)
+     *  reads in the chart's language. */
+    readonly title: MessageLike;
     /**
      * Compact name for the on-chart legend chip, the settings-dialog header and the
      * object tree's indicator rows.
      * Absent ⇒ {@link title}. The picker keeps the full title either way.
      */
-    readonly shortTitle?: string;
+    readonly shortTitle?: MessageLike;
     readonly paneHint: 'price' | 'new';
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
     readonly reactsToViewport?: boolean;
+    /**
+     * Compute only over the chart's COMPLETE history, the way script indicators do. While
+     * the history is still loading (a deep load streaming in, a source healing a cold
+     * symbol, a deeper depth being fetched), the instance is not started — its legend row
+     * shows a loading state, and `ready` / `indicator:added` wait — or, when it already
+     * runs, `onBars()` is held and the previous output stays on its bars. The first
+     * compute (or the re-run) comes once the history completes, so values computed over
+     * a partial history never paint and never repaint. Absent ⇒ the instance starts on
+     * the first bars and `onBars()` fires for every history chunk as it lands.
+     */
+    readonly waitsForHistory?: boolean;
     /** Marks the type as beta — surfaced in the catalog so a host "add indicator" UI can badge it. */
     readonly beta?: boolean;
     /**
@@ -607,12 +630,19 @@ interface NativeIndicatorInfo {
 declare function registerNativeIndicator(descriptor: NativeIndicatorDescriptor): void;
 /** Remove a registered native-indicator type (mainly for tests). */
 declare function unregisterNativeIndicator(type: string): void;
-/** Look up a registered native-indicator descriptor (undefined if the type isn't registered). */
-declare function getNativeIndicator(type: string): NativeIndicatorDescriptor | undefined;
+/** A registered descriptor as the read APIs hand it out: its names as plain text. */
+type ResolvedNativeIndicatorDescriptor = NativeIndicatorDescriptor & {
+    readonly title: string;
+    readonly shortTitle?: string;
+};
+/** Look up a registered native-indicator descriptor (undefined if the type isn't registered).
+ *  Its names read in `i18n`'s language (English without one). */
+declare function getNativeIndicator(type: string, i18n?: Translator): ResolvedNativeIndicatorDescriptor | undefined;
 /** All registered native-indicator types (for a host "add native indicator" menu). */
 declare function nativeIndicatorTypes(): string[];
-/** All registered native-indicator descriptors (for building a catalog with metadata + capability). */
-declare function nativeIndicatorDescriptors(): NativeIndicatorDescriptor[];
+/** All registered native-indicator descriptors (for building a catalog with metadata +
+ *  capability), their names in `i18n`'s language (English without one). */
+declare function nativeIndicatorDescriptors(i18n?: Translator): ResolvedNativeIndicatorDescriptor[];
 
 /**
  * Why a script computed. The distinction that matters most is `'tick'` vs `'bar'`: a tick
@@ -905,6 +935,12 @@ interface VelaEventMap extends Record<string, unknown> {
      * leave the app theme alone.
      */
     "theme:changed": VelaTheme;
+    /**
+     * The chart's localization changed through `chart.setLocale(...)` — after the chart has
+     * re-rendered its text and numbers. Carries the resolved locale and chrome direction so
+     * host chrome around the chart can follow.
+     */
+    "locale:changed": LocaleChangedEvent;
     /**
      * The base price style is switching `from` → `to` (candles, line, area, a chart-type
      * id, …). Fires synchronously BEFORE the chart repaints in the new style, whatever
@@ -1264,7 +1300,7 @@ declare class RendererControl {
     /** Contribute host settings tabs (callback rows) to the renderer's settings dialog —
      *  e.g. the widget's Status line toggles. Silent no-op without a dialog. */
     setSettingsSections(sections: ReadonlyArray<{
-        title: string;
+        title: MessageLike;
         rows: readonly unknown[];
         id?: string;
     }>): this;
@@ -1305,6 +1341,7 @@ interface PaneController {
     removePaneAndIndicators(paneId: string): void;
     collapsePane(paneId: string, collapsed: boolean): void;
     maximizePane(paneId: string | null): void;
+    setPaneHeightWeight(paneId: string, weight: number): void;
     moveIndicator(id: string, target: MoveTarget): void;
 }
 /**
@@ -1327,6 +1364,14 @@ declare class PanesControl {
     collapse(paneId: string, collapsed?: boolean): this;
     /** Maximize one pane to fill the plot, or restore the split (`null`). */
     maximize(paneId: string | null): this;
+    /**
+     * Set a pane's height weight: the panes share the plot height in proportion to their
+     * weights, so `setHeightWeight('price', 6)` next to two study panes at 1 gives the price
+     * pane three quarters of the height. The weight sticks until the user drags a separator
+     * or it is set again; a collapsed pane applies it when expanded. `weight` must be a
+     * positive number.
+     */
+    setHeightWeight(paneId: string, weight: number): this;
     /** Move/merge an indicator to a pane — sugar for `handle.moveTo(...)` by id. */
     moveIndicator(id: string, target: MoveTarget): this;
     private guard;
@@ -1372,10 +1417,14 @@ interface AddInit {
  */
 declare class DrawingController {
     private readonly events;
+    /** The chart's translator: the toolbar reaches the renderer labelled in its language. */
+    private readonly i18n;
     private readonly store;
     private readonly history;
     private readonly port;
     private readonly enabled;
+    /** The toolbar as last configured — re-read in the chart's language on {@link relocalize}. */
+    private toolbarOption;
     private activeTool;
     /** Mirror of the renderer's sticky magnet mode (the renderer default is 'off'). */
     private snapMode;
@@ -1392,7 +1441,9 @@ declare class DrawingController {
     /** Per-tool saved looks ("styles"), in the order they were saved. */
     private templates;
     private readonly subs;
-    constructor(renderer: IChartRenderer, events: TypedEventBus<VelaEventMap>, option: DrawingsOption | undefined, seriesGateway?: DrawingSeriesGateway);
+    constructor(renderer: IChartRenderer, events: TypedEventBus<VelaEventMap>, option: DrawingsOption | undefined, seriesGateway?: DrawingSeriesGateway, 
+    /** The chart's translator: the toolbar reaches the renderer labelled in its language. */
+    i18n?: () => Translator | null);
     /** Whether the active renderer supports interactive drawings. */
     get supported(): boolean;
     setTool(type: DrawingTypeKey | null): void;
@@ -1431,6 +1482,8 @@ declare class DrawingController {
     removeToolTemplate(type: DrawingTypeKey, name: string): void;
     private pushTemplates;
     setToolbar(option: DrawingsOption): void;
+    /** The chart's language changed: hand the renderer the toolbar relabelled in it. */
+    relocalize(): 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;
@@ -1734,7 +1787,27 @@ declare class Vela {
     private readonly drawingsControl;
     private readonly marksControl;
     private readonly replayControl;
+    private readonly localeState;
+    private readonly rendererPort;
     constructor(container: HTMLElement | string, options?: VelaOptions, deps?: VelaDeps);
+    /**
+     * The chart's translator: its resolved locale and direction, `t()` for messages, and
+     * `format` for numbers and dates in the chart's locale. The same object for the
+     * chart's lifetime; it reads the new settings after {@link setLocale}.
+     */
+    get i18n(): Translator;
+    /**
+     * Change the chart's language, direction or formatting at runtime — a locale tag
+     * (`chart.setLocale('de')`) or any {@link LocalizationOptions} fields. Fields you pass
+     * replace their current value (an explicit `undefined` restores the default); the
+     * others are kept. The chart re-renders its text, axes and readouts in place (no
+     * indicator re-run) and emits `locale:changed`. Register the locale's pack
+     * (`registerLocale`) first for translated text.
+     */
+    setLocale(next: string | LocalizationOptions): this;
+    /** Hand the renderer the translator and the root attributes the host asked for: `lang`
+     *  once a locale is set, `dir` once a direction is (unset, the host page decides). */
+    private pushLocalization;
     /**
      * Register a scripting engine so `addIndicator({ language })` can run that
      * language. Vela ships NO engine — install the one you need (Pine Script:
@@ -1939,6 +2012,10 @@ interface WidgetContext {
      *  (Dialog/Menu/Tooltip) from an action; without an explicit host they portal to
      *  the body, OUTSIDE the theme variables. A multi-chart shell hands its own root. */
     host: HTMLElement;
+    /** The shell's translator: `i18n.t(msg(...))` for text an action or panel renders,
+     *  `i18n.format` for its numbers and dates, `i18n.direction` for its layout. It follows
+     *  `setLocale`; listen to the shell's `locale:changed` to re-render. */
+    i18n: Translator;
     /** The widget's feedback pill (bottom-center, auto-hides). */
     toast(message: string, kind?: 'info' | 'success' | 'error'): void;
     /** Add a SCRIPT indicator to the active chart THROUGH THE SHELL — unlike the raw
@@ -1975,6 +2052,8 @@ interface ContextMenuPointer {
     time: number | null;
     /** The kind of pane the pointer is on; null off the plot. */
     paneKind: 'price' | 'study' | null;
+    /** The id of the pane the pointer is on, as `chart.panes.list()` reports it; null off the plot. */
+    paneId: string | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {
@@ -2005,8 +2084,9 @@ interface WidgetActionDescriptor {
     id: string;
     target: WidgetActionTarget;
     /** Always required, even icon-only: it is the button's aria-label and tooltip, the
-     *  mobile drawer row's text, and the context-menu item's label. */
-    label: string;
+     *  mobile drawer row's text, and the context-menu item's label. A message
+     *  (`msg(id, 'English')`) follows the shell's language; a plain string shows as is. */
+    label: MessageLike;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon?: string;
     /** Topbar only: render the DESKTOP button icon-only, like the built-in tools — the
@@ -2072,7 +2152,7 @@ interface SidePanelHeader {
     slot: HTMLElement;
     /** Replace the header title (an empty string hides it). The topbar toggle keeps the
      *  DECLARED `title` as its tooltip. */
-    setTitle(title: string): void;
+    setTitle(title: MessageLike): void;
     /** Whether the panel covers every chart right now (see `maximizable`). */
     readonly maximized: boolean;
     /** Maximize the panel over the shell's charts, or restore it — what its header button
@@ -2092,8 +2172,8 @@ interface SidePanelHeader {
 interface SidePanelDescriptor {
     /** Stable id — re-registering an id replaces it. Also the key its width persists under. */
     id: string;
-    /** Header title, and the tooltip of its topbar button. */
-    title: string;
+    /** Header title, and the tooltip of its topbar button. A message follows the shell's language. */
+    title: MessageLike;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon: string;
     /** Sort key among the panel buttons (ascending; default 100 — after the built-ins). */
@@ -2176,7 +2256,8 @@ interface LegendActionDescriptor {
     id: string;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon: string;
-    tooltip: string;
+    /** Hover text. A message follows the chart's language. */
+    tooltip: MessageLike;
     /** Sort key within the contributed group (ascending; default 0). */
     order?: number;
     /** Per-indicator gate — omitted ⇒ shown on every row. */
@@ -2193,10 +2274,10 @@ declare function legendActions(): LegendActionDescriptor[];
  *  indicator — the same signature as a legend action's `run`. */
 type LegendCalloutItem = {
     type: 'text';
-    text: string;
+    text: MessageLike;
 } | {
     type: 'button';
-    label: string;
+    label: MessageLike;
     /** Emphasized (selection-colored) button — the panel's main action. */
     primary?: boolean;
     /** Close the panel after `run` (default true). */
@@ -2205,7 +2286,7 @@ type LegendCalloutItem = {
 };
 /** The panel a clickable callout deploys: an optional heading over ordered blocks. */
 interface LegendCalloutContent {
-    title?: string;
+    title?: MessageLike;
     items: LegendCalloutItem[];
 }
 /** A callout's resolved presentation for one row — what {@link LegendCalloutDescriptor.callout} returns. */
@@ -2216,8 +2297,8 @@ interface LegendCalloutSpec {
     background: string;
     /** Icon ink (default: the legend row's text color). */
     color?: string;
-    /** Hover text; also the bubble's accessible name. */
-    tooltip: string;
+    /** Hover text; also the bubble's accessible name. A message follows the chart's language. */
+    tooltip: MessageLike;
     /** Deployed panel — presence makes the bubble clickable. */
     content?: LegendCalloutContent;
 }

package/dist/{contributions-DOm40g5-.d.cts → contributions-CpCJisTC.d.cts}

@@ -1,5 +1,6 @@
-import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, a_ as SeriesSpec, ak as Fill, H as Background, aQ as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-CSXbjMM5.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-Bw58CjYy.cjs';
+import { y as Millis, aq as InputSchema, an as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, m as IndicatorModel, l as MoveTarget, aJ as PaneAxis, b0 as SeriesSpec, al as Fill, J as Background, aS as PriceLine, a8 as DrawingLine, a4 as DrawingBox, a7 as DrawingLabel, ac as DrawingPolyline, a9 as DrawingLinefill, ah as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, B as DrawingTypeKey, z as SnapMode, aa as DrawingMode, v as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, p as LegendActionView, q as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, s as ClickEvent, A as AxisLongPressEvent, w as DataWindowReadout, o as SymbolPickerFn, W as WallClock, bi as PaneInfo, ak as DrawingsOption, ae as DrawingSeriesGateway, bj as DrawingToolDefaults, bk as DrawingToolTemplate, D as Drawing, t as TimelineMark, u as MarkGroup, b as VelaOptions, G as AddIndicatorOptions, aI as MarketSwitch, F as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-CpegHml_.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-zJGp58kb.cjs';
+import { M as MessageLike, T as Translator, c as LocaleChangedEvent, b as LocalizationOptions } from './types-BlrXRLIR.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -502,7 +503,13 @@ interface NativeIndicatorContext {
     bars(): readonly OHLCV[];
     /** Market-data access (trades / capabilities) for data-driven natives. */
     readonly data: DataControl;
-    /** Push a fresh render output; the chart mounts it (first call) or patches it (subsequent). */
+    /**
+     * Push a fresh render output; the chart mounts it (first call) or patches it (subsequent).
+     * Series payloads are index-aligned: one slot per bar of `bars()` AS IT STANDS AT THE
+     * CALL, first slot on its first bar. The chart keeps an emitted output on those bars
+     * when history later lands in front of them (or the oldest bars are trimmed), until the
+     * next emit replaces it.
+     */
     emit(out: NativeIndicatorOutput): void;
     /**
      * Push a BESPOKE render payload to the renderer's native layer for this indicator's type (for a
@@ -521,7 +528,8 @@ interface NativeIndicatorContext {
 interface NativeIndicator {
     /** Begin: compute + emit the first output. */
     start(ctx: NativeIndicatorContext, inputs: Record<string, InputValue>): void;
-    /** A live tick arrived (bars changed) — recompute + emit. */
+    /** The bars changed — a live tick, older history landing, or the candles re-derived
+     *  by a price style — recompute + emit. */
     onBars(): void;
     /** The viewport changed (scroll/zoom) — for range-aware natives (see `reactsToViewport`). */
     onViewport(range: VisibleRange): void;
@@ -533,7 +541,10 @@ interface NativeIndicator {
     suspend(): void;
     /** Shown again — resume + re-emit. */
     resume(): void;
-    /** Removed — full teardown (clear caches, stop timers). Only ever called after `start`. */
+    /** Removed, or replaced by a fresh instance (a market switch stops it as the switch
+     *  begins) — full teardown (clear caches, stop timers). Only ever called after `start`.
+     *  Pushes made inside `stop()` still land (a layer-backed native clears its channel
+     *  here); once it returns, the context drops every push and emit. */
     stop(): void;
 }
 /**
@@ -543,18 +554,30 @@ interface NativeIndicator {
  */
 interface NativeIndicatorDescriptor {
     readonly type: string;
-    /** Full display name (picker, settings header, handle title). */
-    readonly title: string;
+    /** Full display name (picker, settings header, handle title). A message (`msg()`)
+     *  reads in the chart's language. */
+    readonly title: MessageLike;
     /**
      * Compact name for the on-chart legend chip, the settings-dialog header and the
      * object tree's indicator rows.
      * Absent ⇒ {@link title}. The picker keeps the full title either way.
      */
-    readonly shortTitle?: string;
+    readonly shortTitle?: MessageLike;
     readonly paneHint: 'price' | 'new';
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
     readonly reactsToViewport?: boolean;
+    /**
+     * Compute only over the chart's COMPLETE history, the way script indicators do. While
+     * the history is still loading (a deep load streaming in, a source healing a cold
+     * symbol, a deeper depth being fetched), the instance is not started — its legend row
+     * shows a loading state, and `ready` / `indicator:added` wait — or, when it already
+     * runs, `onBars()` is held and the previous output stays on its bars. The first
+     * compute (or the re-run) comes once the history completes, so values computed over
+     * a partial history never paint and never repaint. Absent ⇒ the instance starts on
+     * the first bars and `onBars()` fires for every history chunk as it lands.
+     */
+    readonly waitsForHistory?: boolean;
     /** Marks the type as beta — surfaced in the catalog so a host "add indicator" UI can badge it. */
     readonly beta?: boolean;
     /**
@@ -607,12 +630,19 @@ interface NativeIndicatorInfo {
 declare function registerNativeIndicator(descriptor: NativeIndicatorDescriptor): void;
 /** Remove a registered native-indicator type (mainly for tests). */
 declare function unregisterNativeIndicator(type: string): void;
-/** Look up a registered native-indicator descriptor (undefined if the type isn't registered). */
-declare function getNativeIndicator(type: string): NativeIndicatorDescriptor | undefined;
+/** A registered descriptor as the read APIs hand it out: its names as plain text. */
+type ResolvedNativeIndicatorDescriptor = NativeIndicatorDescriptor & {
+    readonly title: string;
+    readonly shortTitle?: string;
+};
+/** Look up a registered native-indicator descriptor (undefined if the type isn't registered).
+ *  Its names read in `i18n`'s language (English without one). */
+declare function getNativeIndicator(type: string, i18n?: Translator): ResolvedNativeIndicatorDescriptor | undefined;
 /** All registered native-indicator types (for a host "add native indicator" menu). */
 declare function nativeIndicatorTypes(): string[];
-/** All registered native-indicator descriptors (for building a catalog with metadata + capability). */
-declare function nativeIndicatorDescriptors(): NativeIndicatorDescriptor[];
+/** All registered native-indicator descriptors (for building a catalog with metadata +
+ *  capability), their names in `i18n`'s language (English without one). */
+declare function nativeIndicatorDescriptors(i18n?: Translator): ResolvedNativeIndicatorDescriptor[];
 
 /**
  * Why a script computed. The distinction that matters most is `'tick'` vs `'bar'`: a tick
@@ -905,6 +935,12 @@ interface VelaEventMap extends Record<string, unknown> {
      * leave the app theme alone.
      */
     "theme:changed": VelaTheme;
+    /**
+     * The chart's localization changed through `chart.setLocale(...)` — after the chart has
+     * re-rendered its text and numbers. Carries the resolved locale and chrome direction so
+     * host chrome around the chart can follow.
+     */
+    "locale:changed": LocaleChangedEvent;
     /**
      * The base price style is switching `from` → `to` (candles, line, area, a chart-type
      * id, …). Fires synchronously BEFORE the chart repaints in the new style, whatever
@@ -1264,7 +1300,7 @@ declare class RendererControl {
     /** Contribute host settings tabs (callback rows) to the renderer's settings dialog —
      *  e.g. the widget's Status line toggles. Silent no-op without a dialog. */
     setSettingsSections(sections: ReadonlyArray<{
-        title: string;
+        title: MessageLike;
         rows: readonly unknown[];
         id?: string;
     }>): this;
@@ -1305,6 +1341,7 @@ interface PaneController {
     removePaneAndIndicators(paneId: string): void;
     collapsePane(paneId: string, collapsed: boolean): void;
     maximizePane(paneId: string | null): void;
+    setPaneHeightWeight(paneId: string, weight: number): void;
     moveIndicator(id: string, target: MoveTarget): void;
 }
 /**
@@ -1327,6 +1364,14 @@ declare class PanesControl {
     collapse(paneId: string, collapsed?: boolean): this;
     /** Maximize one pane to fill the plot, or restore the split (`null`). */
     maximize(paneId: string | null): this;
+    /**
+     * Set a pane's height weight: the panes share the plot height in proportion to their
+     * weights, so `setHeightWeight('price', 6)` next to two study panes at 1 gives the price
+     * pane three quarters of the height. The weight sticks until the user drags a separator
+     * or it is set again; a collapsed pane applies it when expanded. `weight` must be a
+     * positive number.
+     */
+    setHeightWeight(paneId: string, weight: number): this;
     /** Move/merge an indicator to a pane — sugar for `handle.moveTo(...)` by id. */
     moveIndicator(id: string, target: MoveTarget): this;
     private guard;
@@ -1372,10 +1417,14 @@ interface AddInit {
  */
 declare class DrawingController {
     private readonly events;
+    /** The chart's translator: the toolbar reaches the renderer labelled in its language. */
+    private readonly i18n;
     private readonly store;
     private readonly history;
     private readonly port;
     private readonly enabled;
+    /** The toolbar as last configured — re-read in the chart's language on {@link relocalize}. */
+    private toolbarOption;
     private activeTool;
     /** Mirror of the renderer's sticky magnet mode (the renderer default is 'off'). */
     private snapMode;
@@ -1392,7 +1441,9 @@ declare class DrawingController {
     /** Per-tool saved looks ("styles"), in the order they were saved. */
     private templates;
     private readonly subs;
-    constructor(renderer: IChartRenderer, events: TypedEventBus<VelaEventMap>, option: DrawingsOption | undefined, seriesGateway?: DrawingSeriesGateway);
+    constructor(renderer: IChartRenderer, events: TypedEventBus<VelaEventMap>, option: DrawingsOption | undefined, seriesGateway?: DrawingSeriesGateway, 
+    /** The chart's translator: the toolbar reaches the renderer labelled in its language. */
+    i18n?: () => Translator | null);
     /** Whether the active renderer supports interactive drawings. */
     get supported(): boolean;
     setTool(type: DrawingTypeKey | null): void;
@@ -1431,6 +1482,8 @@ declare class DrawingController {
     removeToolTemplate(type: DrawingTypeKey, name: string): void;
     private pushTemplates;
     setToolbar(option: DrawingsOption): void;
+    /** The chart's language changed: hand the renderer the toolbar relabelled in it. */
+    relocalize(): 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;
@@ -1734,7 +1787,27 @@ declare class Vela {
     private readonly drawingsControl;
     private readonly marksControl;
     private readonly replayControl;
+    private readonly localeState;
+    private readonly rendererPort;
     constructor(container: HTMLElement | string, options?: VelaOptions, deps?: VelaDeps);
+    /**
+     * The chart's translator: its resolved locale and direction, `t()` for messages, and
+     * `format` for numbers and dates in the chart's locale. The same object for the
+     * chart's lifetime; it reads the new settings after {@link setLocale}.
+     */
+    get i18n(): Translator;
+    /**
+     * Change the chart's language, direction or formatting at runtime — a locale tag
+     * (`chart.setLocale('de')`) or any {@link LocalizationOptions} fields. Fields you pass
+     * replace their current value (an explicit `undefined` restores the default); the
+     * others are kept. The chart re-renders its text, axes and readouts in place (no
+     * indicator re-run) and emits `locale:changed`. Register the locale's pack
+     * (`registerLocale`) first for translated text.
+     */
+    setLocale(next: string | LocalizationOptions): this;
+    /** Hand the renderer the translator and the root attributes the host asked for: `lang`
+     *  once a locale is set, `dir` once a direction is (unset, the host page decides). */
+    private pushLocalization;
     /**
      * Register a scripting engine so `addIndicator({ language })` can run that
      * language. Vela ships NO engine — install the one you need (Pine Script:
@@ -1939,6 +2012,10 @@ interface WidgetContext {
      *  (Dialog/Menu/Tooltip) from an action; without an explicit host they portal to
      *  the body, OUTSIDE the theme variables. A multi-chart shell hands its own root. */
     host: HTMLElement;
+    /** The shell's translator: `i18n.t(msg(...))` for text an action or panel renders,
+     *  `i18n.format` for its numbers and dates, `i18n.direction` for its layout. It follows
+     *  `setLocale`; listen to the shell's `locale:changed` to re-render. */
+    i18n: Translator;
     /** The widget's feedback pill (bottom-center, auto-hides). */
     toast(message: string, kind?: 'info' | 'success' | 'error'): void;
     /** Add a SCRIPT indicator to the active chart THROUGH THE SHELL — unlike the raw
@@ -1975,6 +2052,8 @@ interface ContextMenuPointer {
     time: number | null;
     /** The kind of pane the pointer is on; null off the plot. */
     paneKind: 'price' | 'study' | null;
+    /** The id of the pane the pointer is on, as `chart.panes.list()` reports it; null off the plot. */
+    paneId: string | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {
@@ -2005,8 +2084,9 @@ interface WidgetActionDescriptor {
     id: string;
     target: WidgetActionTarget;
     /** Always required, even icon-only: it is the button's aria-label and tooltip, the
-     *  mobile drawer row's text, and the context-menu item's label. */
-    label: string;
+     *  mobile drawer row's text, and the context-menu item's label. A message
+     *  (`msg(id, 'English')`) follows the shell's language; a plain string shows as is. */
+    label: MessageLike;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon?: string;
     /** Topbar only: render the DESKTOP button icon-only, like the built-in tools — the
@@ -2072,7 +2152,7 @@ interface SidePanelHeader {
     slot: HTMLElement;
     /** Replace the header title (an empty string hides it). The topbar toggle keeps the
      *  DECLARED `title` as its tooltip. */
-    setTitle(title: string): void;
+    setTitle(title: MessageLike): void;
     /** Whether the panel covers every chart right now (see `maximizable`). */
     readonly maximized: boolean;
     /** Maximize the panel over the shell's charts, or restore it — what its header button
@@ -2092,8 +2172,8 @@ interface SidePanelHeader {
 interface SidePanelDescriptor {
     /** Stable id — re-registering an id replaces it. Also the key its width persists under. */
     id: string;
-    /** Header title, and the tooltip of its topbar button. */
-    title: string;
+    /** Header title, and the tooltip of its topbar button. A message follows the shell's language. */
+    title: MessageLike;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon: string;
     /** Sort key among the panel buttons (ascending; default 100 — after the built-ins). */
@@ -2176,7 +2256,8 @@ interface LegendActionDescriptor {
     id: string;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon: string;
-    tooltip: string;
+    /** Hover text. A message follows the chart's language. */
+    tooltip: MessageLike;
     /** Sort key within the contributed group (ascending; default 0). */
     order?: number;
     /** Per-indicator gate — omitted ⇒ shown on every row. */
@@ -2193,10 +2274,10 @@ declare function legendActions(): LegendActionDescriptor[];
  *  indicator — the same signature as a legend action's `run`. */
 type LegendCalloutItem = {
     type: 'text';
-    text: string;
+    text: MessageLike;
 } | {
     type: 'button';
-    label: string;
+    label: MessageLike;
     /** Emphasized (selection-colored) button — the panel's main action. */
     primary?: boolean;
     /** Close the panel after `run` (default true). */
@@ -2205,7 +2286,7 @@ type LegendCalloutItem = {
 };
 /** The panel a clickable callout deploys: an optional heading over ordered blocks. */
 interface LegendCalloutContent {
-    title?: string;
+    title?: MessageLike;
     items: LegendCalloutItem[];
 }
 /** A callout's resolved presentation for one row — what {@link LegendCalloutDescriptor.callout} returns. */
@@ -2216,8 +2297,8 @@ interface LegendCalloutSpec {
     background: string;
     /** Icon ink (default: the legend row's text color). */
     color?: string;
-    /** Hover text; also the bubble's accessible name. */
-    tooltip: string;
+    /** Hover text; also the bubble's accessible name. A message follows the chart's language. */
+    tooltip: MessageLike;
     /** Deployed panel — presence makes the bubble clickable. */
     content?: LegendCalloutContent;
 }