@luxalgo/vela 0.8.5 → 0.9.0

package/dist/{options-BI5Tp32b.d.cts → options-CpegHml_.d.cts}

@@ -1,3 +1,5 @@
+import { M as MessageLike, T as Translator, m as TextDirection, b as LocalizationOptions } from './types-BlrXRLIR.cjs';
+
 /**
  * Canonical time in Vela: Unix epoch **milliseconds**.
  *
@@ -86,7 +88,11 @@ interface SeriesDisplay {
 interface SeriesBase {
     /** Content-addressed, stable across re-runs of identical source (see identity.ts). */
     id: string;
+    /** The series' name: its identity for engines and hosts (output keys, series ids). */
     title: string;
+    /** What the legend, the data window and the settings show instead of {@link title}, in
+     *  the chart's language. Absent ⇒ {@link title}. */
+    displayTitle?: MessageLike;
     /** Pane this series belongs to; resolved by the orchestrator. */
     paneId: string;
     /** Declared draw-order intent; the renderer owns final z-ordering. */
@@ -381,6 +387,8 @@ interface PriceLine {
     lineStyle?: LineStyle;
     width?: number;
     title?: string;
+    /** {@link title} in the chart's language. Absent ⇒ {@link title}. */
+    displayTitle?: MessageLike;
 }
 /**
  * The renderer-neutral, full description of what to draw. In the engine-owned
@@ -436,8 +444,26 @@ interface TradeExecution {
  * declarations onto this at its boundary). Drives the renderer's settings dialog
  * (the gear settings UI).
  */
+
 type InputType = 'int' | 'float' | 'bool' | 'string' | 'source' | 'color' | 'price' | 'time' | 'session' | 'timeframe' | 'symbol' | 'text_area';
 type InputValue = number | string | boolean;
+/**
+ * The display side of an input: what the settings dialog and the legend SHOW, in the
+ * chart's language. The input's own `title`, `group` and `options` stay what they are
+ * (a script reads them, layouts persist the option values), and this side-car only
+ * changes how they read. Each field is optional and falls back to the identity field.
+ */
+interface InputDisplay {
+    /** Shown instead of `title`. */
+    title?: MessageLike;
+    /** Shown instead of `tooltip`. */
+    tooltip?: MessageLike;
+    /** Shown instead of `group` as the section heading. */
+    group?: MessageLike;
+    /** Shown label per stored option value (`'Close'` → a translated "Close"). Values
+     *  without an entry show as themselves. */
+    options?: Readonly<Record<string, MessageLike>>;
+}
 /**
  * Host-provided symbol picker for the settings dialog's `input.symbol` control. Called when the
  * user activates the field: the host opens its own symbol-selection UI (e.g. the app's ticker
@@ -483,6 +509,8 @@ interface InputSchema {
      *  `inline=` row show while ANY member's gate passes. A hidden input keeps its value. */
     when?: InputWhen;
     tooltip?: string;
+    /** Translatable display text for this input (see {@link InputDisplay}). */
+    display?: InputDisplay;
 }
 /**
  * The DELTAS of a value bag against its schema's declaration defaults — what state
@@ -528,6 +556,11 @@ interface IndicatorModel {
      * `indicator(..., shorttitle=)`.
      */
     shorttitle?: string;
+    /** What the chart SHOWS for {@link title}, in its language (a native indicator's
+     *  translatable name). Absent ⇒ {@link title}. */
+    displayTitle?: MessageLike;
+    /** What the chart shows for {@link shorttitle}. Absent ⇒ {@link shorttitle}. */
+    displayShorttitle?: MessageLike;
     overlay: boolean;
     paneHint: PaneHint;
     /**
@@ -891,11 +924,13 @@ interface DrawingText {
  * renderer's settings popup builds controls generically — adding a new drawing
  * type is a schema entry, not new UI code.
  */
+
 type FieldKind = 'color' | 'number' | 'select' | 'lineStyle' | 'boolean' | 'text' | 'opacity';
 interface SettingsField {
     /** Dot-path into the drawing, e.g. `'style.lineColor'`, `'text.value'`, `'locked'`. */
     path: string;
-    label: string;
+    /** What the settings show; a message reads in the chart's language. */
+    label: MessageLike;
     kind: FieldKind;
     /** number/opacity bounds. */
     min?: number;
@@ -904,7 +939,7 @@ interface SettingsField {
     /** select options. */
     options?: ReadonlyArray<{
         value: string;
-        label: string;
+        label: MessageLike;
     }>;
     /** Cosmetic grouping in the popup. */
     group?: 'line' | 'fill' | 'text' | 'behavior';
@@ -914,6 +949,10 @@ interface SettingsField {
         path: string;
         in: readonly unknown[];
     };
+    /** The label of the one row this field shares with the next one: a color and its line
+     *  style ("Midline" for "Midline color" + "Midline style"), or an upper and a lower color
+     *  ("Bands"). */
+    rowLabel?: MessageLike;
 }
 interface SettingsSchema {
     fields: SettingsField[];
@@ -1046,6 +1085,10 @@ declare abstract class Drawing {
         max: number;
     } | null;
     abstract schema(): SettingsSchema;
+    /** The text a fresh drawing of this type starts with ("Note", "Callout"), as a message,
+     *  or null for a type that seeds none. A new drawing stores its English source; the chart
+     *  that places one interactively writes it in its own language instead. */
+    placeholderText(): MessageLike | null;
     /**
      * Editable per-level config for a rich "gear" settings panel (Fibonacci levels):
      * each entry's `color` / `enabled` / `label` is mutated via a `levels.<i>.<field>`
@@ -1076,6 +1119,7 @@ declare abstract class Drawing {
  */
 interface ToolDefinition {
     type: DrawingTypeKey;
+    /** The tool's name, in the language the definition was built for. */
     label: string;
     /** Inline SVG markup (no DOM). */
     icon: string;
@@ -1098,7 +1142,8 @@ interface ToolbarDefinition {
 /** A developer-supplied explicit group (just type keys; the registry fills the rest). */
 interface ToolbarGroupConfig {
     id: string;
-    label: string;
+    /** The group's name; a message (`msg()`) reads in the chart's language. */
+    label: MessageLike;
     tools: DrawingTypeKey[];
 }
 /** Public `options.drawings` shape. `true` = default toolbar; object = customize. */
@@ -1107,14 +1152,15 @@ type DrawingsOption = boolean | {
     tools?: DrawingTypeKey[];
     groups?: ToolbarGroupConfig[];
 };
-/** The default toolbar — every registered type, grouped into the canonical seven-button layout. */
-declare function defaultToolbar(): ToolbarDefinition;
+/** The default toolbar — every registered type, grouped into the canonical seven-button
+ *  layout, labelled in `i18n`'s language (English without one). */
+declare function defaultToolbar(i18n?: Translator | null): ToolbarDefinition;
 /**
  * Resolve `options.drawings` into a concrete toolbar definition + initial visibility.
  * Default (undefined) ⇒ toolbar VISIBLE; `false` ⇒ subsystem available but toolbar hidden
  * (headless use still works via `chart.drawings.add(...)`); object ⇒ `toolbar ?? true`.
  */
-declare function buildToolbar(option: DrawingsOption | undefined): {
+declare function buildToolbar(option: DrawingsOption | undefined, i18n?: Translator | null): {
     definition: ToolbarDefinition;
     visible: boolean;
 };
@@ -1133,7 +1179,10 @@ interface DrawingToolDefaults {
 /** A named, saved look for one tool (a "style"): applied, it sets the same settings a
  *  remembered default does — style, text styling and per-type settings. */
 interface DrawingToolTemplate {
+    /** The style's name: its identity among the tool's styles. */
     name: string;
+    /** What a built-in style's name reads as in the chart's language. Absent ⇒ {@link name}. */
+    label?: MessageLike;
     settings: DrawingToolDefaults;
 }
 
@@ -1412,6 +1461,11 @@ interface MarkClickEvent {
     group?: string;
 }
 
+/** The language and direction attributes of a renderer's root element (`null` = unset). */
+interface RendererRootAttributes {
+    lang: string | null;
+    dir: TextDirection | null;
+}
 /** What a rendering backend supports — drives graceful degradation + warnings. */
 interface RendererCapabilities {
     panes: boolean;
@@ -1635,6 +1689,14 @@ interface IChartRenderer {
     readFeature(key: string): unknown;
     mount(container: HTMLElement, theme: VelaTheme): void;
     setTheme(theme: VelaTheme): void;
+    /**
+     * Adopt the chart's localization: render text through `i18n` and numbers and dates
+     * through `i18n.format`, then repaint. Called once after `mount` and again after every
+     * `chart.setLocale`. `lang` and `dir` are what the renderer's root element should carry
+     * (`null` = leave the attribute alone, the host page decides). Optional: a renderer
+     * without it keeps English text and formatting.
+     */
+    setLocalization?(i18n: Translator, root: RendererRootAttributes): void;
     resize(): void;
     destroy(): void;
     /**
@@ -1895,7 +1957,7 @@ interface IChartRenderer {
     /** 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;
+        title: MessageLike;
         rows: readonly unknown[];
         id?: string;
     }>): void;
@@ -2013,7 +2075,10 @@ type ThemeName = 'dark' | 'light';
  *  Built-in default: `NativeRenderer`.
  *  from `'vela/renderers/lwc'` and pass it as `options.renderer`. */
 type RendererConstructor = new (opts?: RendererDisplayOptions) => IChartRenderer;
-interface VelaOptions extends MarketConfig {
+/** The chart's options. Its {@link LocalizationOptions} (`locale`, `direction`, `messages`,
+ *  `numberingSystem`, `hourCycle`, `weekStart`, `formatters`) change at runtime through
+ *  `chart.setLocale`. */
+interface VelaOptions extends MarketConfig, LocalizationOptions {
     /** false = static history; true = history + live forming candle. */
     live?: boolean;
     theme?: ThemeName | VelaTheme;
@@ -2268,4 +2333,4 @@ interface AddIndicatorOptions {
     title?: string;
 }
 
-export { type DataWindowGroup as $, type AxisLongPressEvent as A, type ToolbarDefinition as B, type CrosshairEvent as C, Drawing as D, type MarketSnapshot as E, type AddIndicatorOptions as F, type AnimationConfig as G, type Background as H, type InputValue as I, type BoxFontFamily as J, type BoxHAlign as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxTextSize as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type WallClock as W, type BoxVAlign as X, type CandleBarColor as Y, type CandleSeries as Z, type CandleStyle as _, type VisibleRange as a, type SeriesSurface as a$, type DataWindowOHLC as a0, type DataWindowRow as a1, type DirtyRange as a2, type DrawingBox as a3, type DrawingExtend as a4, type DrawingIntent as a5, type DrawingLabel as a6, type DrawingLine as a7, type DrawingLinefill as a8, type DrawingMode as a9, type MarkContentSource as aA, type MarkGlyph as aB, type MarkPanelItem as aC, type MarkShape as aD, type MarkerPoint as aE, type MarkerSeries as aF, type MarketSwitch as aG, type PaneAxis as aH, type PaneAxisBand as aI, type PaneHint as aJ, type PaneKind as aK, type PolylinePoint as aL, type PriceAxisOptions as aM, type PriceAxisTick as aN, type PriceAxisTickContext as aO, type PriceAxisTicksFn as aP, type PriceLine as aQ, type Projector as aR, type ProviderName as aS, type RendererConstructor as aT, type Scene as aU, type SchemaPatch as aV, SecondClock as aW, type SeriesDisplay as aX, type SeriesKind as aY, type SeriesPoint as aZ, type SeriesSpec as a_, type DrawingPoint as aa, type DrawingPolyline as ab, type DrawingSeriesBar as ac, type DrawingSeriesGateway as ad, type DrawingSeriesState as ae, type DrawingStyle as af, type DrawingTable as ag, type DrawingText as ah, type DrawingXLoc as ai, type DrawingsOption as aj, type Fill as ak, type FillGradientStop as al, type IndicatorMeta as am, type InputCondition as an, type InputSchema as ao, type InputType as ap, type InputWhen as aq, type IntroAnimation as ar, type IntroConfig as as, type IntroStyle as at, type LabelStyle as au, type LabelYLoc as av, type LineLikeKind as aw, type LineLikeSeries as ax, type LineLikeStyle as ay, type MarkContent as az, type VelaOptions as b, type SeriesValueDelta as b0, type SettingsField as b1, type SettingsSchema as b2, type SettingsVisibilityPolicy as b3, type TableCell as b4, type TableMerge as b5, type TablePosition as b6, type ToolbarGroupConfig as b7, type TradeExecution as b8, type ValuePatch as b9, buildToolbar as ba, defaultToolbar as bb, inputDeltas as bc, inputVisible as bd, seriesInScale as be, seriesShownOn as bf, type PaneInfo as bg, type DrawingToolDefaults as bh, type DrawingToolTemplate as bi, type VelaTheme as c, type MarketSession as d, type IChartRenderer as e, type RendererDisplayOptions as f, type IndicatorRenderHandle as g, type IndicatorStatus as h, type Pane as i, type PaneAction as j, type MoveTarget as k, type IndicatorModel as l, type ScenePatch as m, type SymbolPickerFn as n, type LegendActionView as o, type LegendCalloutView as p, type InputChangeEvent as q, type ClickEvent as r, type TimelineMark as s, type MarkGroup as t, type MarkClickEvent as u, type DataWindowReadout as v, type IDrawingsRendererPort as w, type Millis as x, type SnapMode as y, type DrawingTypeKey as z };
+export { type CandleStyle as $, type AxisLongPressEvent as A, type DrawingTypeKey as B, type CrosshairEvent as C, Drawing as D, type ToolbarDefinition as E, type MarketSnapshot as F, type AddIndicatorOptions as G, type AnimationConfig as H, type InputValue as I, type Background as J, type BoxFontFamily as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxHAlign as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type WallClock as W, type BoxTextSize as X, type BoxVAlign as Y, type CandleBarColor as Z, type CandleSeries as _, type VisibleRange as a, type SeriesPoint as a$, type DataWindowGroup as a0, type DataWindowOHLC as a1, type DataWindowRow as a2, type DirtyRange as a3, type DrawingBox as a4, type DrawingExtend as a5, type DrawingIntent as a6, type DrawingLabel as a7, type DrawingLine as a8, type DrawingLinefill as a9, type LineLikeStyle as aA, type MarkContent as aB, type MarkContentSource as aC, type MarkGlyph as aD, type MarkPanelItem as aE, type MarkShape as aF, type MarkerPoint as aG, type MarkerSeries as aH, type MarketSwitch as aI, type PaneAxis as aJ, type PaneAxisBand as aK, type PaneHint as aL, type PaneKind as aM, type PolylinePoint as aN, type PriceAxisOptions as aO, type PriceAxisTick as aP, type PriceAxisTickContext as aQ, type PriceAxisTicksFn as aR, type PriceLine as aS, type Projector as aT, type ProviderName as aU, type RendererConstructor as aV, type Scene as aW, type SchemaPatch as aX, SecondClock as aY, type SeriesDisplay as aZ, type SeriesKind as a_, type DrawingMode as aa, type DrawingPoint as ab, type DrawingPolyline as ac, type DrawingSeriesBar as ad, type DrawingSeriesGateway as ae, type DrawingSeriesState as af, type DrawingStyle as ag, type DrawingTable as ah, type DrawingText as ai, type DrawingXLoc as aj, type DrawingsOption as ak, type Fill as al, type FillGradientStop as am, type IndicatorMeta as an, type InputCondition as ao, type InputDisplay as ap, type InputSchema as aq, type InputType as ar, type InputWhen as as, type IntroAnimation as at, type IntroConfig as au, type IntroStyle as av, type LabelStyle as aw, type LabelYLoc as ax, type LineLikeKind as ay, type LineLikeSeries as az, type VelaOptions as b, type SeriesSpec as b0, type SeriesSurface as b1, type SeriesValueDelta as b2, type SettingsField as b3, type SettingsSchema as b4, type SettingsVisibilityPolicy as b5, type TableCell as b6, type TableMerge as b7, type TablePosition as b8, type ToolbarGroupConfig as b9, type TradeExecution as ba, type ValuePatch as bb, buildToolbar as bc, defaultToolbar as bd, inputDeltas as be, inputVisible as bf, seriesInScale as bg, seriesShownOn as bh, type PaneInfo as bi, type DrawingToolDefaults as bj, type DrawingToolTemplate as bk, type VelaTheme as c, type MarketSession as d, type IChartRenderer as e, type RendererDisplayOptions as f, type IndicatorRenderHandle as g, type IndicatorStatus as h, type RendererRootAttributes as i, type Pane as j, type PaneAction as k, type MoveTarget as l, type IndicatorModel as m, type ScenePatch as n, type SymbolPickerFn as o, type LegendActionView as p, type LegendCalloutView as q, type InputChangeEvent as r, type ClickEvent as s, type TimelineMark as t, type MarkGroup as u, type MarkClickEvent as v, type DataWindowReadout as w, type IDrawingsRendererPort as x, type Millis as y, type SnapMode as z };

package/dist/{options-BI5Tp32b.d.ts → options-D4L3_hv_.d.ts}

@@ -1,3 +1,5 @@
+import { M as MessageLike, T as Translator, m as TextDirection, b as LocalizationOptions } from './types-BlrXRLIR.js';
+
 /**
  * Canonical time in Vela: Unix epoch **milliseconds**.
  *
@@ -86,7 +88,11 @@ interface SeriesDisplay {
 interface SeriesBase {
     /** Content-addressed, stable across re-runs of identical source (see identity.ts). */
     id: string;
+    /** The series' name: its identity for engines and hosts (output keys, series ids). */
     title: string;
+    /** What the legend, the data window and the settings show instead of {@link title}, in
+     *  the chart's language. Absent ⇒ {@link title}. */
+    displayTitle?: MessageLike;
     /** Pane this series belongs to; resolved by the orchestrator. */
     paneId: string;
     /** Declared draw-order intent; the renderer owns final z-ordering. */
@@ -381,6 +387,8 @@ interface PriceLine {
     lineStyle?: LineStyle;
     width?: number;
     title?: string;
+    /** {@link title} in the chart's language. Absent ⇒ {@link title}. */
+    displayTitle?: MessageLike;
 }
 /**
  * The renderer-neutral, full description of what to draw. In the engine-owned
@@ -436,8 +444,26 @@ interface TradeExecution {
  * declarations onto this at its boundary). Drives the renderer's settings dialog
  * (the gear settings UI).
  */
+
 type InputType = 'int' | 'float' | 'bool' | 'string' | 'source' | 'color' | 'price' | 'time' | 'session' | 'timeframe' | 'symbol' | 'text_area';
 type InputValue = number | string | boolean;
+/**
+ * The display side of an input: what the settings dialog and the legend SHOW, in the
+ * chart's language. The input's own `title`, `group` and `options` stay what they are
+ * (a script reads them, layouts persist the option values), and this side-car only
+ * changes how they read. Each field is optional and falls back to the identity field.
+ */
+interface InputDisplay {
+    /** Shown instead of `title`. */
+    title?: MessageLike;
+    /** Shown instead of `tooltip`. */
+    tooltip?: MessageLike;
+    /** Shown instead of `group` as the section heading. */
+    group?: MessageLike;
+    /** Shown label per stored option value (`'Close'` → a translated "Close"). Values
+     *  without an entry show as themselves. */
+    options?: Readonly<Record<string, MessageLike>>;
+}
 /**
  * Host-provided symbol picker for the settings dialog's `input.symbol` control. Called when the
  * user activates the field: the host opens its own symbol-selection UI (e.g. the app's ticker
@@ -483,6 +509,8 @@ interface InputSchema {
      *  `inline=` row show while ANY member's gate passes. A hidden input keeps its value. */
     when?: InputWhen;
     tooltip?: string;
+    /** Translatable display text for this input (see {@link InputDisplay}). */
+    display?: InputDisplay;
 }
 /**
  * The DELTAS of a value bag against its schema's declaration defaults — what state
@@ -528,6 +556,11 @@ interface IndicatorModel {
      * `indicator(..., shorttitle=)`.
      */
     shorttitle?: string;
+    /** What the chart SHOWS for {@link title}, in its language (a native indicator's
+     *  translatable name). Absent ⇒ {@link title}. */
+    displayTitle?: MessageLike;
+    /** What the chart shows for {@link shorttitle}. Absent ⇒ {@link shorttitle}. */
+    displayShorttitle?: MessageLike;
     overlay: boolean;
     paneHint: PaneHint;
     /**
@@ -891,11 +924,13 @@ interface DrawingText {
  * renderer's settings popup builds controls generically — adding a new drawing
  * type is a schema entry, not new UI code.
  */
+
 type FieldKind = 'color' | 'number' | 'select' | 'lineStyle' | 'boolean' | 'text' | 'opacity';
 interface SettingsField {
     /** Dot-path into the drawing, e.g. `'style.lineColor'`, `'text.value'`, `'locked'`. */
     path: string;
-    label: string;
+    /** What the settings show; a message reads in the chart's language. */
+    label: MessageLike;
     kind: FieldKind;
     /** number/opacity bounds. */
     min?: number;
@@ -904,7 +939,7 @@ interface SettingsField {
     /** select options. */
     options?: ReadonlyArray<{
         value: string;
-        label: string;
+        label: MessageLike;
     }>;
     /** Cosmetic grouping in the popup. */
     group?: 'line' | 'fill' | 'text' | 'behavior';
@@ -914,6 +949,10 @@ interface SettingsField {
         path: string;
         in: readonly unknown[];
     };
+    /** The label of the one row this field shares with the next one: a color and its line
+     *  style ("Midline" for "Midline color" + "Midline style"), or an upper and a lower color
+     *  ("Bands"). */
+    rowLabel?: MessageLike;
 }
 interface SettingsSchema {
     fields: SettingsField[];
@@ -1046,6 +1085,10 @@ declare abstract class Drawing {
         max: number;
     } | null;
     abstract schema(): SettingsSchema;
+    /** The text a fresh drawing of this type starts with ("Note", "Callout"), as a message,
+     *  or null for a type that seeds none. A new drawing stores its English source; the chart
+     *  that places one interactively writes it in its own language instead. */
+    placeholderText(): MessageLike | null;
     /**
      * Editable per-level config for a rich "gear" settings panel (Fibonacci levels):
      * each entry's `color` / `enabled` / `label` is mutated via a `levels.<i>.<field>`
@@ -1076,6 +1119,7 @@ declare abstract class Drawing {
  */
 interface ToolDefinition {
     type: DrawingTypeKey;
+    /** The tool's name, in the language the definition was built for. */
     label: string;
     /** Inline SVG markup (no DOM). */
     icon: string;
@@ -1098,7 +1142,8 @@ interface ToolbarDefinition {
 /** A developer-supplied explicit group (just type keys; the registry fills the rest). */
 interface ToolbarGroupConfig {
     id: string;
-    label: string;
+    /** The group's name; a message (`msg()`) reads in the chart's language. */
+    label: MessageLike;
     tools: DrawingTypeKey[];
 }
 /** Public `options.drawings` shape. `true` = default toolbar; object = customize. */
@@ -1107,14 +1152,15 @@ type DrawingsOption = boolean | {
     tools?: DrawingTypeKey[];
     groups?: ToolbarGroupConfig[];
 };
-/** The default toolbar — every registered type, grouped into the canonical seven-button layout. */
-declare function defaultToolbar(): ToolbarDefinition;
+/** The default toolbar — every registered type, grouped into the canonical seven-button
+ *  layout, labelled in `i18n`'s language (English without one). */
+declare function defaultToolbar(i18n?: Translator | null): ToolbarDefinition;
 /**
  * Resolve `options.drawings` into a concrete toolbar definition + initial visibility.
  * Default (undefined) ⇒ toolbar VISIBLE; `false` ⇒ subsystem available but toolbar hidden
  * (headless use still works via `chart.drawings.add(...)`); object ⇒ `toolbar ?? true`.
  */
-declare function buildToolbar(option: DrawingsOption | undefined): {
+declare function buildToolbar(option: DrawingsOption | undefined, i18n?: Translator | null): {
     definition: ToolbarDefinition;
     visible: boolean;
 };
@@ -1133,7 +1179,10 @@ interface DrawingToolDefaults {
 /** A named, saved look for one tool (a "style"): applied, it sets the same settings a
  *  remembered default does — style, text styling and per-type settings. */
 interface DrawingToolTemplate {
+    /** The style's name: its identity among the tool's styles. */
     name: string;
+    /** What a built-in style's name reads as in the chart's language. Absent ⇒ {@link name}. */
+    label?: MessageLike;
     settings: DrawingToolDefaults;
 }
 
@@ -1412,6 +1461,11 @@ interface MarkClickEvent {
     group?: string;
 }
 
+/** The language and direction attributes of a renderer's root element (`null` = unset). */
+interface RendererRootAttributes {
+    lang: string | null;
+    dir: TextDirection | null;
+}
 /** What a rendering backend supports — drives graceful degradation + warnings. */
 interface RendererCapabilities {
     panes: boolean;
@@ -1635,6 +1689,14 @@ interface IChartRenderer {
     readFeature(key: string): unknown;
     mount(container: HTMLElement, theme: VelaTheme): void;
     setTheme(theme: VelaTheme): void;
+    /**
+     * Adopt the chart's localization: render text through `i18n` and numbers and dates
+     * through `i18n.format`, then repaint. Called once after `mount` and again after every
+     * `chart.setLocale`. `lang` and `dir` are what the renderer's root element should carry
+     * (`null` = leave the attribute alone, the host page decides). Optional: a renderer
+     * without it keeps English text and formatting.
+     */
+    setLocalization?(i18n: Translator, root: RendererRootAttributes): void;
     resize(): void;
     destroy(): void;
     /**
@@ -1895,7 +1957,7 @@ interface IChartRenderer {
     /** 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;
+        title: MessageLike;
         rows: readonly unknown[];
         id?: string;
     }>): void;
@@ -2013,7 +2075,10 @@ type ThemeName = 'dark' | 'light';
  *  Built-in default: `NativeRenderer`.
  *  from `'vela/renderers/lwc'` and pass it as `options.renderer`. */
 type RendererConstructor = new (opts?: RendererDisplayOptions) => IChartRenderer;
-interface VelaOptions extends MarketConfig {
+/** The chart's options. Its {@link LocalizationOptions} (`locale`, `direction`, `messages`,
+ *  `numberingSystem`, `hourCycle`, `weekStart`, `formatters`) change at runtime through
+ *  `chart.setLocale`. */
+interface VelaOptions extends MarketConfig, LocalizationOptions {
     /** false = static history; true = history + live forming candle. */
     live?: boolean;
     theme?: ThemeName | VelaTheme;
@@ -2268,4 +2333,4 @@ interface AddIndicatorOptions {
     title?: string;
 }
 
-export { type DataWindowGroup as $, type AxisLongPressEvent as A, type ToolbarDefinition as B, type CrosshairEvent as C, Drawing as D, type MarketSnapshot as E, type AddIndicatorOptions as F, type AnimationConfig as G, type Background as H, type InputValue as I, type BoxFontFamily as J, type BoxHAlign as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxTextSize as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type WallClock as W, type BoxVAlign as X, type CandleBarColor as Y, type CandleSeries as Z, type CandleStyle as _, type VisibleRange as a, type SeriesSurface as a$, type DataWindowOHLC as a0, type DataWindowRow as a1, type DirtyRange as a2, type DrawingBox as a3, type DrawingExtend as a4, type DrawingIntent as a5, type DrawingLabel as a6, type DrawingLine as a7, type DrawingLinefill as a8, type DrawingMode as a9, type MarkContentSource as aA, type MarkGlyph as aB, type MarkPanelItem as aC, type MarkShape as aD, type MarkerPoint as aE, type MarkerSeries as aF, type MarketSwitch as aG, type PaneAxis as aH, type PaneAxisBand as aI, type PaneHint as aJ, type PaneKind as aK, type PolylinePoint as aL, type PriceAxisOptions as aM, type PriceAxisTick as aN, type PriceAxisTickContext as aO, type PriceAxisTicksFn as aP, type PriceLine as aQ, type Projector as aR, type ProviderName as aS, type RendererConstructor as aT, type Scene as aU, type SchemaPatch as aV, SecondClock as aW, type SeriesDisplay as aX, type SeriesKind as aY, type SeriesPoint as aZ, type SeriesSpec as a_, type DrawingPoint as aa, type DrawingPolyline as ab, type DrawingSeriesBar as ac, type DrawingSeriesGateway as ad, type DrawingSeriesState as ae, type DrawingStyle as af, type DrawingTable as ag, type DrawingText as ah, type DrawingXLoc as ai, type DrawingsOption as aj, type Fill as ak, type FillGradientStop as al, type IndicatorMeta as am, type InputCondition as an, type InputSchema as ao, type InputType as ap, type InputWhen as aq, type IntroAnimation as ar, type IntroConfig as as, type IntroStyle as at, type LabelStyle as au, type LabelYLoc as av, type LineLikeKind as aw, type LineLikeSeries as ax, type LineLikeStyle as ay, type MarkContent as az, type VelaOptions as b, type SeriesValueDelta as b0, type SettingsField as b1, type SettingsSchema as b2, type SettingsVisibilityPolicy as b3, type TableCell as b4, type TableMerge as b5, type TablePosition as b6, type ToolbarGroupConfig as b7, type TradeExecution as b8, type ValuePatch as b9, buildToolbar as ba, defaultToolbar as bb, inputDeltas as bc, inputVisible as bd, seriesInScale as be, seriesShownOn as bf, type PaneInfo as bg, type DrawingToolDefaults as bh, type DrawingToolTemplate as bi, type VelaTheme as c, type MarketSession as d, type IChartRenderer as e, type RendererDisplayOptions as f, type IndicatorRenderHandle as g, type IndicatorStatus as h, type Pane as i, type PaneAction as j, type MoveTarget as k, type IndicatorModel as l, type ScenePatch as m, type SymbolPickerFn as n, type LegendActionView as o, type LegendCalloutView as p, type InputChangeEvent as q, type ClickEvent as r, type TimelineMark as s, type MarkGroup as t, type MarkClickEvent as u, type DataWindowReadout as v, type IDrawingsRendererPort as w, type Millis as x, type SnapMode as y, type DrawingTypeKey as z };
+export { type CandleStyle as $, type AxisLongPressEvent as A, type DrawingTypeKey as B, type CrosshairEvent as C, Drawing as D, type ToolbarDefinition as E, type MarketSnapshot as F, type AddIndicatorOptions as G, type AnimationConfig as H, type InputValue as I, type Background as J, type BoxFontFamily as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxHAlign as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type WallClock as W, type BoxTextSize as X, type BoxVAlign as Y, type CandleBarColor as Z, type CandleSeries as _, type VisibleRange as a, type SeriesPoint as a$, type DataWindowGroup as a0, type DataWindowOHLC as a1, type DataWindowRow as a2, type DirtyRange as a3, type DrawingBox as a4, type DrawingExtend as a5, type DrawingIntent as a6, type DrawingLabel as a7, type DrawingLine as a8, type DrawingLinefill as a9, type LineLikeStyle as aA, type MarkContent as aB, type MarkContentSource as aC, type MarkGlyph as aD, type MarkPanelItem as aE, type MarkShape as aF, type MarkerPoint as aG, type MarkerSeries as aH, type MarketSwitch as aI, type PaneAxis as aJ, type PaneAxisBand as aK, type PaneHint as aL, type PaneKind as aM, type PolylinePoint as aN, type PriceAxisOptions as aO, type PriceAxisTick as aP, type PriceAxisTickContext as aQ, type PriceAxisTicksFn as aR, type PriceLine as aS, type Projector as aT, type ProviderName as aU, type RendererConstructor as aV, type Scene as aW, type SchemaPatch as aX, SecondClock as aY, type SeriesDisplay as aZ, type SeriesKind as a_, type DrawingMode as aa, type DrawingPoint as ab, type DrawingPolyline as ac, type DrawingSeriesBar as ad, type DrawingSeriesGateway as ae, type DrawingSeriesState as af, type DrawingStyle as ag, type DrawingTable as ah, type DrawingText as ai, type DrawingXLoc as aj, type DrawingsOption as ak, type Fill as al, type FillGradientStop as am, type IndicatorMeta as an, type InputCondition as ao, type InputDisplay as ap, type InputSchema as aq, type InputType as ar, type InputWhen as as, type IntroAnimation as at, type IntroConfig as au, type IntroStyle as av, type LabelStyle as aw, type LabelYLoc as ax, type LineLikeKind as ay, type LineLikeSeries as az, type VelaOptions as b, type SeriesSpec as b0, type SeriesSurface as b1, type SeriesValueDelta as b2, type SettingsField as b3, type SettingsSchema as b4, type SettingsVisibilityPolicy as b5, type TableCell as b6, type TableMerge as b7, type TablePosition as b8, type ToolbarGroupConfig as b9, type TradeExecution as ba, type ValuePatch as bb, buildToolbar as bc, defaultToolbar as bd, inputDeltas as be, inputVisible as bf, seriesInScale as bg, seriesShownOn as bh, type PaneInfo as bi, type DrawingToolDefaults as bj, type DrawingToolTemplate as bk, type VelaTheme as c, type MarketSession as d, type IChartRenderer as e, type RendererDisplayOptions as f, type IndicatorRenderHandle as g, type IndicatorStatus as h, type RendererRootAttributes as i, type Pane as j, type PaneAction as k, type MoveTarget as l, type IndicatorModel as m, type ScenePatch as n, type SymbolPickerFn as o, type LegendActionView as p, type LegendCalloutView as q, type InputChangeEvent as r, type ClickEvent as s, type TimelineMark as t, type MarkGroup as u, type MarkClickEvent as v, type DataWindowReadout as w, type IDrawingsRendererPort as x, type Millis as y, type SnapMode as z };