@luxalgo/vela 0.8.4 → 0.9.0

package/dist/{plugin-BDxUhGO3.d.ts → plugin-DTmulpKM.d.ts}

@@ -1,16 +1,51 @@
-import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aY as SeriesKind, c as VelaTheme } from './options-CSXbjMM5.js';
-import { f as DataControl } from './contributions-BY3zSYiZ.js';
-import './side-panel-_2UK1gSm.js';
+import { i as MessageDescriptor, a as MessageArgs, L as LocalePack, b as LocalizationOptions, T as Translator, M as MessageLike } from './types-BlrXRLIR.js';
+import { B as DrawingTypeKey, ag as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, a_ as SeriesKind, c as VelaTheme } from './options-D4L3_hv_.js';
+import { f as DataControl } from './contributions-BjefWpxQ.js';
+import './side-panel-CYmH1Opm.js';
 import './icons-BZYbJXSV.js';
-import './keymap-CGOz5F5f.js';
-import './DataProvider-Byo8pEv0.js';
+import './keymap-UolhuXH1.js';
+import './DataProvider-BGlB1zSc.js';
+
+/** Values a message interpolates. */
+type MessageValues = Readonly<Record<string, string | number>>;
+
+/**
+ * Declare a translatable message: a stable, dotted id and its English text in ICU message
+ * syntax (`'{count, plural, one {# bar} other {# bars}}'`). The descriptor is inert data;
+ * a translator's `t()` resolves it. The build extracts every `msg()` call with literal
+ * arguments into the English catalog, so keep both arguments string literals.
+ */
+declare function msg(id: string, defaultMessage: string): MessageDescriptor;
+/**
+ * A message with values bound to its arguments, for display text declared before its
+ * values are known to the code that renders it (`withValues(BAND, { n: 2 })` reads
+ * "Band #2"). A translator formats the bound values; values passed to `t()` win.
+ */
+declare function withValues(message: MessageDescriptor, values: MessageArgs): MessageDescriptor;
+
+/**
+ * Register a locale pack: a locale tag and its messages (id → ICU message). Several packs
+ * may share a tag (the core's, a plugin's, the host's); for the same id the pack
+ * registered last wins. Registration is a call, never an import side effect. Returns the
+ * disposer that removes this pack again.
+ */
+declare function registerLocale(pack: LocalePack): () => void;
+/** The tags of every registered pack, in registration order (duplicates collapsed). */
+declare function registeredLocales(): string[];
+
+/**
+ * A standalone translator for UI built outside a chart (a kit component, a host panel).
+ * Charts, workspaces and widgets carry their own as `i18n`.
+ */
+declare function createTranslator(options?: LocalizationOptions): Translator;
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
     type: DrawingTypeKey;
     /** Toolbar group id (e.g. `'lines'`, `'shapes'`, `'annotations'`). */
     group: string;
-    label: string;
+    /** The tool's name (toolbar, settings, object tree); a message reads in the chart's language. */
+    label: MessageLike;
     /** Inline SVG markup for the toolbar button — no DOM, renderer paints it. */
     icon: string;
     defaultStyle: DrawingStyle;
@@ -20,7 +55,7 @@ interface DrawingTypeMeta {
     coversSeries?: boolean;
     /** One short sentence prompting the placement gesture, shown by the renderer at the
      *  bottom of the chart while the tool is armed and no placement has started yet. */
-    placementHint?: string;
+    placementHint?: MessageLike;
     /** Build an instance from a (partial) serialized record. Serves create + deserialize. */
     create(init: Partial<SerializedDrawing> & {
         paneId: string;
@@ -29,8 +64,15 @@ interface DrawingTypeMeta {
 /** Register (or replace) a drawing type. Built-ins register at module load; new
  *  types (fibs/patterns) call this — no base/port/facade change. */
 declare function registerDrawingType(meta: DrawingTypeMeta): void;
-declare function getDrawingType(type: string): DrawingTypeMeta | undefined;
-declare function drawingTypes(): DrawingTypeMeta[];
+/** A registered type as the read APIs hand it out: its label and hint as plain text. */
+type ResolvedDrawingTypeMeta = DrawingTypeMeta & {
+    label: string;
+    placementHint?: string;
+};
+/** A registered drawing type, its label and hint in `i18n`'s language (English without one). */
+declare function getDrawingType(type: string, i18n?: Translator): ResolvedDrawingTypeMeta | undefined;
+/** Every registered drawing type, labels in `i18n`'s language (English without one). */
+declare function drawingTypes(i18n?: Translator): ResolvedDrawingTypeMeta[];
 /** Build a fresh drawing of `type` on `paneId`, seeding the type's default style. */
 declare function createDrawing(type: DrawingTypeKey, init: Partial<SerializedDrawing> & {
     paneId: string;
@@ -184,17 +226,23 @@ interface SeriesDataEngineHost {
 }
 /**
  * A per-chart data engine behind a chart type: created on first entry into the style,
- * suspended/resumed as the user switches styles, stopped when the chart is destroyed.
+ * suspended/resumed as the user switches styles, replaced by a fresh engine when the
+ * market or the replay state changes, stopped when the chart is destroyed.
  * All methods are fire-and-forget from the chart's point of view — the engine owns its
- * own scheduling and pushes results through the host channels.
+ * own scheduling and pushes results through the host channels. The host forwards pushes
+ * only from the chart's current, unsuspended engine: work still in flight when the
+ * engine is suspended or stopped never reaches the scene.
  */
 interface SeriesDataEngine {
     start(host: SeriesDataEngineHost): void;
-    /** The style was left — stop fetching/pushing, keep state for a cheap resume. */
+    /** The style was left, or a market switch began — stop fetching/pushing, keep state
+     *  for a cheap resume. Host pushes are dropped from here until `resume()`. */
     suspend(): void;
-    /** The style was re-entered. */
+    /** The style was re-entered — re-push what the layer shows (nothing pushed while
+     *  suspended reached it). */
     resume(): void;
-    /** The chart is going away — release everything. */
+    /** The chart is going away, or the engine is being replaced — release everything.
+     *  Its host drops every push from here on. */
     stop(): void;
     /** The visible range changed (pan/zoom) while the style is active. */
     onViewport?(range: {
@@ -216,8 +264,9 @@ interface SeriesDataEngine {
 interface ChartTypeDefinition {
     /** The price-style id (`'heikinashi'`; a plugin might register `'footprint'`, `'renko'`…). */
     id: string;
-    /** Human-readable label for style pickers. Defaults to the id. */
-    label?: string;
+    /** Human-readable label for style pickers. Defaults to the id. A message (`msg()`)
+     *  reads in the chart's language. */
+    label?: MessageLike;
     /** Raw `<svg>` markup for style pickers (surfaced as icon id `style-<id>`). */
     icon?: string;
     /** Optional SETTINGS SECTION rendered inside the chart-settings dialog — declarative
@@ -264,7 +313,7 @@ type SettingsRowWhen = SettingsRowCondition | readonly SettingsRowCondition[];
 interface SettingsRowSwatch {
     key: string;
     /** Names the color for the swatch's tooltip (`'Highlight color'`). */
-    label: string;
+    label: MessageLike;
     defval: string;
     /**
      * Optional visibility gate, evaluated live against the values bag exactly like a
@@ -284,7 +333,7 @@ interface SettingsRowSwatch {
 interface SettingsRowWidth {
     key: string;
     /** Names the control for its tooltip (`'Line width'`). */
-    label: string;
+    label: MessageLike;
     defval: number;
 }
 /**
@@ -296,7 +345,7 @@ interface SettingsRowWidth {
 interface SettingsRowInlineNumber {
     key: string;
     /** Names the input for its tooltip (`'Value area (%)'`). */
-    label: string;
+    label: MessageLike;
     defval: number;
     min?: number;
     max?: number;
@@ -306,7 +355,7 @@ interface SettingsRowInlineNumber {
  * A select option: a bare string (value = label) or a `[value, label]` pair when the
  * stored id differs from the human-readable text (`['bidAskProfile', 'Bid × Ask Profile']`).
  */
-type SettingsSelectOption = string | readonly [value: string, label: string];
+type SettingsSelectOption = string | readonly [value: string, label: MessageLike];
 /**
  * One INLINE CONTROL on a composite `row` — the composable unit every value row is
  * made of. Each keyed control stores under its own bag key; `label` names it for the
@@ -328,35 +377,35 @@ type SettingsSelectOption = string | readonly [value: string, label: string];
 type SettingsInlineControl = {
     kind: 'number';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: number;
     min?: number;
     max?: number;
     step?: number;
-    placeholder?: string;
+    placeholder?: MessageLike;
     when?: SettingsRowWhen;
 } | {
     kind: 'color';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'width';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: number;
     when?: SettingsRowWhen;
 } | {
     kind: 'select';
     key: string;
-    label: string;
+    label: MessageLike;
     options: readonly SettingsSelectOption[];
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'hint';
-    text: string;
+    text: MessageLike;
 };
 /**
  * One declarative settings row. To add a NEW inline control kind, see
@@ -388,15 +437,15 @@ type SettingsInlineControl = {
  */
 type SettingsRowDescriptor = {
     kind: 'heading';
-    label: string;
+    label: MessageLike;
     when?: SettingsRowWhen;
 } | {
     kind: 'header';
-    label: string;
+    label: MessageLike;
     when?: SettingsRowWhen;
 } | {
     kind: 'row';
-    label: string;
+    label: MessageLike;
     toggle?: {
         key: string;
         defval: boolean;
@@ -406,7 +455,7 @@ type SettingsRowDescriptor = {
 } | {
     kind: 'toggle';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: boolean;
     number?: SettingsRowInlineNumber;
     colors?: readonly SettingsRowSwatch[];
@@ -415,7 +464,7 @@ type SettingsRowDescriptor = {
 } | {
     kind: 'number';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: number;
     min?: number;
     max?: number;
@@ -424,26 +473,26 @@ type SettingsRowDescriptor = {
 } | {
     kind: 'color';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'select';
     key: string;
-    label: string;
+    label: MessageLike;
     options: readonly SettingsSelectOption[];
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'range';
-    label: string;
+    label: MessageLike;
     minKey: string;
     maxKey: string;
     defval: number;
     min?: number;
     max?: number;
     step?: number;
-    placeholder?: string;
+    placeholder?: MessageLike;
     when?: SettingsRowWhen;
 };
 /** A value-carrying row (everything except the key-less `heading`/`header` titles). */
@@ -452,7 +501,7 @@ type SettingsValueRow = Exclude<SettingsRowDescriptor, {
 }>;
 /** The canonical row shape every {@link SettingsValueRow} reduces to (the `row` kind's fields). */
 interface NormalizedSettingsRow {
-    label: string;
+    label: MessageLike;
     toggle?: {
         key: string;
         defval: boolean;
@@ -488,14 +537,14 @@ declare function settingsRowValueKeys(r: SettingsRowDescriptor): SettingsRowValu
  * present and not removable — the base instance.
  */
 interface ChartTypeSettingsInstance {
-    label: string;
+    label: MessageLike;
     /** Boolean bag key controlling presence; omitted = always present, not removable. */
     enableKey?: string;
     rows: readonly SettingsRowDescriptor[];
 }
 /** An indented sub-entry under the section's rail tab, with its own pane of rows. */
 interface ChartTypeSettingsSubsection {
-    title: string;
+    title: MessageLike;
     rows: readonly SettingsRowDescriptor[];
     /**
      * Boolean bag key that masters this pane. While it is false, every row EXCEPT the
@@ -524,7 +573,7 @@ interface ChartTypeSettingsSubsection {
  */
 interface ChartTypeSettingsSection {
     /** Section heading in the settings dialog. */
-    title: string;
+    title: MessageLike;
     /** Flat form. Ignored when `instances` is declared. */
     rows?: readonly SettingsRowDescriptor[];
     /** How `rows` are presented: `'flat'` (default) renders headings as inline group
@@ -618,6 +667,9 @@ interface RendererLayerArgs {
         x: number;
         y: number;
     } | null;
+    /** The chart's translator: `i18n.t(msg(...))` for text a layer paints, and
+     *  `i18n.format` for its numbers and dates, in the chart's locale. */
+    i18n: Translator;
 }
 /** How a layer dims/slims the BASE painting under it (see
  *  {@link RendererLayerInstance.modulateBase}). Omitted fields keep their defaults. */
@@ -728,4 +780,4 @@ declare const CATEGORICAL: readonly string[];
 /** Pick a stable categorical color for a string key (same key ⇒ same color). */
 declare function categoricalColor(key: string): string;
 
-export { getDrawingType as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, type SettingsRowInlineNumber as E, type SettingsRowSwatch as F, type SettingsRowValueKey as G, HIGHLIGHT as H, INFO as I, type SettingsRowWhen as J, type SettingsRowWidth as K, type SettingsValueRow as L, MARKER as M, NEUTRAL as N, TRADE_LONG as O, TRADE_SHORT as P, categoricalColor as Q, type RendererLayerArgs as R, type SettingsSelectOption as S, TRADE_EXIT as T, chartType as U, VALID as V, WARNING as W, chartTypes as X, createDrawing as Y, deserializeDrawing as Z, drawingTypes as _, ACCENT_BRIGHT as a, normalizeSettingsRow as a0, registerChartType as a1, registerDrawingType as a2, registerRendererDefaults as a3, registerRendererLayer as a4, rendererDefaults as a5, rendererLayers as a6, settingsRowValueKeys as a7, stableSeriesId as a8, tickerModifierIds as a9, unregisterChartType as aa, unregisterRendererDefaults as ab, unregisterRendererLayer as ac, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CHIP_PLATE as e, CROSSHAIR as f, type ChartTypeDefinition as g, type ChartTypeSettingsInstance as h, type ChartTypeSettingsSection as i, type ChartTypeSettingsSubsection as j, INVALID as k, type IdentifiableKind as l, type NormalizedSettingsRow as m, type RendererLayerDefinition as n, type RendererLayerInstance as o, SERIES_LINE as p, SESSION_OFF as q, SESSION_POST as r, SESSION_PRE as s, SLATE as t, SLATE_DEEP as u, type SeriesDataEngine as v, type SeriesDataEngineHost as w, type SettingsInlineControl as x, type SettingsRowCondition as y, type SettingsRowDescriptor as z };
+export { deserializeDrawing as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, type SettingsRowDescriptor as E, type SettingsRowInlineNumber as F, type SettingsRowSwatch as G, HIGHLIGHT as H, INFO as I, type SettingsRowValueKey as J, type SettingsRowWhen as K, type SettingsRowWidth as L, MARKER as M, NEUTRAL as N, type SettingsValueRow as O, TRADE_LONG as P, TRADE_SHORT as Q, type RendererLayerArgs as R, type SettingsSelectOption as S, TRADE_EXIT as T, categoricalColor as U, VALID as V, WARNING as W, chartType as X, chartTypes as Y, createDrawing as Z, createTranslator as _, ACCENT_BRIGHT as a, drawingTypes as a0, getDrawingType as a1, msg as a2, normalizeSettingsRow as a3, registerChartType as a4, registerDrawingType as a5, registerLocale as a6, registerRendererDefaults as a7, registerRendererLayer as a8, registeredLocales as a9, rendererDefaults as aa, rendererLayers as ab, settingsRowValueKeys as ac, stableSeriesId as ad, tickerModifierIds as ae, unregisterChartType as af, unregisterRendererDefaults as ag, unregisterRendererLayer as ah, withValues as ai, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CHIP_PLATE as e, CROSSHAIR as f, type ChartTypeDefinition as g, type ChartTypeSettingsInstance as h, type ChartTypeSettingsSection as i, type ChartTypeSettingsSubsection as j, INVALID as k, type IdentifiableKind as l, type MessageValues as m, type NormalizedSettingsRow as n, type RendererLayerDefinition as o, type RendererLayerInstance as p, SERIES_LINE as q, SESSION_OFF as r, SESSION_POST as s, SESSION_PRE as t, SLATE as u, SLATE_DEEP as v, type SeriesDataEngine as w, type SeriesDataEngineHost as x, type SettingsInlineControl as y, type SettingsRowCondition as z };

package/dist/{plugin-CiQVyETg.d.cts → plugin-DpNp4aBi.d.cts}

@@ -1,16 +1,51 @@
-import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aY as SeriesKind, c as VelaTheme } from './options-CSXbjMM5.cjs';
-import { f as DataControl } from './contributions-DOm40g5-.cjs';
-import './side-panel-_2UK1gSm.cjs';
+import { i as MessageDescriptor, a as MessageArgs, L as LocalePack, b as LocalizationOptions, T as Translator, M as MessageLike } from './types-BlrXRLIR.cjs';
+import { B as DrawingTypeKey, ag as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, a_ as SeriesKind, c as VelaTheme } from './options-CpegHml_.cjs';
+import { f as DataControl } from './contributions-CpCJisTC.cjs';
+import './side-panel-BqUnpfev.cjs';
 import './icons-BZYbJXSV.cjs';
-import './keymap-CGOz5F5f.cjs';
-import './DataProvider-Bw58CjYy.cjs';
+import './keymap-B9_FLhfJ.cjs';
+import './DataProvider-zJGp58kb.cjs';
+
+/** Values a message interpolates. */
+type MessageValues = Readonly<Record<string, string | number>>;
+
+/**
+ * Declare a translatable message: a stable, dotted id and its English text in ICU message
+ * syntax (`'{count, plural, one {# bar} other {# bars}}'`). The descriptor is inert data;
+ * a translator's `t()` resolves it. The build extracts every `msg()` call with literal
+ * arguments into the English catalog, so keep both arguments string literals.
+ */
+declare function msg(id: string, defaultMessage: string): MessageDescriptor;
+/**
+ * A message with values bound to its arguments, for display text declared before its
+ * values are known to the code that renders it (`withValues(BAND, { n: 2 })` reads
+ * "Band #2"). A translator formats the bound values; values passed to `t()` win.
+ */
+declare function withValues(message: MessageDescriptor, values: MessageArgs): MessageDescriptor;
+
+/**
+ * Register a locale pack: a locale tag and its messages (id → ICU message). Several packs
+ * may share a tag (the core's, a plugin's, the host's); for the same id the pack
+ * registered last wins. Registration is a call, never an import side effect. Returns the
+ * disposer that removes this pack again.
+ */
+declare function registerLocale(pack: LocalePack): () => void;
+/** The tags of every registered pack, in registration order (duplicates collapsed). */
+declare function registeredLocales(): string[];
+
+/**
+ * A standalone translator for UI built outside a chart (a kit component, a host panel).
+ * Charts, workspaces and widgets carry their own as `i18n`.
+ */
+declare function createTranslator(options?: LocalizationOptions): Translator;
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
     type: DrawingTypeKey;
     /** Toolbar group id (e.g. `'lines'`, `'shapes'`, `'annotations'`). */
     group: string;
-    label: string;
+    /** The tool's name (toolbar, settings, object tree); a message reads in the chart's language. */
+    label: MessageLike;
     /** Inline SVG markup for the toolbar button — no DOM, renderer paints it. */
     icon: string;
     defaultStyle: DrawingStyle;
@@ -20,7 +55,7 @@ interface DrawingTypeMeta {
     coversSeries?: boolean;
     /** One short sentence prompting the placement gesture, shown by the renderer at the
      *  bottom of the chart while the tool is armed and no placement has started yet. */
-    placementHint?: string;
+    placementHint?: MessageLike;
     /** Build an instance from a (partial) serialized record. Serves create + deserialize. */
     create(init: Partial<SerializedDrawing> & {
         paneId: string;
@@ -29,8 +64,15 @@ interface DrawingTypeMeta {
 /** Register (or replace) a drawing type. Built-ins register at module load; new
  *  types (fibs/patterns) call this — no base/port/facade change. */
 declare function registerDrawingType(meta: DrawingTypeMeta): void;
-declare function getDrawingType(type: string): DrawingTypeMeta | undefined;
-declare function drawingTypes(): DrawingTypeMeta[];
+/** A registered type as the read APIs hand it out: its label and hint as plain text. */
+type ResolvedDrawingTypeMeta = DrawingTypeMeta & {
+    label: string;
+    placementHint?: string;
+};
+/** A registered drawing type, its label and hint in `i18n`'s language (English without one). */
+declare function getDrawingType(type: string, i18n?: Translator): ResolvedDrawingTypeMeta | undefined;
+/** Every registered drawing type, labels in `i18n`'s language (English without one). */
+declare function drawingTypes(i18n?: Translator): ResolvedDrawingTypeMeta[];
 /** Build a fresh drawing of `type` on `paneId`, seeding the type's default style. */
 declare function createDrawing(type: DrawingTypeKey, init: Partial<SerializedDrawing> & {
     paneId: string;
@@ -184,17 +226,23 @@ interface SeriesDataEngineHost {
 }
 /**
  * A per-chart data engine behind a chart type: created on first entry into the style,
- * suspended/resumed as the user switches styles, stopped when the chart is destroyed.
+ * suspended/resumed as the user switches styles, replaced by a fresh engine when the
+ * market or the replay state changes, stopped when the chart is destroyed.
  * All methods are fire-and-forget from the chart's point of view — the engine owns its
- * own scheduling and pushes results through the host channels.
+ * own scheduling and pushes results through the host channels. The host forwards pushes
+ * only from the chart's current, unsuspended engine: work still in flight when the
+ * engine is suspended or stopped never reaches the scene.
  */
 interface SeriesDataEngine {
     start(host: SeriesDataEngineHost): void;
-    /** The style was left — stop fetching/pushing, keep state for a cheap resume. */
+    /** The style was left, or a market switch began — stop fetching/pushing, keep state
+     *  for a cheap resume. Host pushes are dropped from here until `resume()`. */
     suspend(): void;
-    /** The style was re-entered. */
+    /** The style was re-entered — re-push what the layer shows (nothing pushed while
+     *  suspended reached it). */
     resume(): void;
-    /** The chart is going away — release everything. */
+    /** The chart is going away, or the engine is being replaced — release everything.
+     *  Its host drops every push from here on. */
     stop(): void;
     /** The visible range changed (pan/zoom) while the style is active. */
     onViewport?(range: {
@@ -216,8 +264,9 @@ interface SeriesDataEngine {
 interface ChartTypeDefinition {
     /** The price-style id (`'heikinashi'`; a plugin might register `'footprint'`, `'renko'`…). */
     id: string;
-    /** Human-readable label for style pickers. Defaults to the id. */
-    label?: string;
+    /** Human-readable label for style pickers. Defaults to the id. A message (`msg()`)
+     *  reads in the chart's language. */
+    label?: MessageLike;
     /** Raw `<svg>` markup for style pickers (surfaced as icon id `style-<id>`). */
     icon?: string;
     /** Optional SETTINGS SECTION rendered inside the chart-settings dialog — declarative
@@ -264,7 +313,7 @@ type SettingsRowWhen = SettingsRowCondition | readonly SettingsRowCondition[];
 interface SettingsRowSwatch {
     key: string;
     /** Names the color for the swatch's tooltip (`'Highlight color'`). */
-    label: string;
+    label: MessageLike;
     defval: string;
     /**
      * Optional visibility gate, evaluated live against the values bag exactly like a
@@ -284,7 +333,7 @@ interface SettingsRowSwatch {
 interface SettingsRowWidth {
     key: string;
     /** Names the control for its tooltip (`'Line width'`). */
-    label: string;
+    label: MessageLike;
     defval: number;
 }
 /**
@@ -296,7 +345,7 @@ interface SettingsRowWidth {
 interface SettingsRowInlineNumber {
     key: string;
     /** Names the input for its tooltip (`'Value area (%)'`). */
-    label: string;
+    label: MessageLike;
     defval: number;
     min?: number;
     max?: number;
@@ -306,7 +355,7 @@ interface SettingsRowInlineNumber {
  * A select option: a bare string (value = label) or a `[value, label]` pair when the
  * stored id differs from the human-readable text (`['bidAskProfile', 'Bid × Ask Profile']`).
  */
-type SettingsSelectOption = string | readonly [value: string, label: string];
+type SettingsSelectOption = string | readonly [value: string, label: MessageLike];
 /**
  * One INLINE CONTROL on a composite `row` — the composable unit every value row is
  * made of. Each keyed control stores under its own bag key; `label` names it for the
@@ -328,35 +377,35 @@ type SettingsSelectOption = string | readonly [value: string, label: string];
 type SettingsInlineControl = {
     kind: 'number';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: number;
     min?: number;
     max?: number;
     step?: number;
-    placeholder?: string;
+    placeholder?: MessageLike;
     when?: SettingsRowWhen;
 } | {
     kind: 'color';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'width';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: number;
     when?: SettingsRowWhen;
 } | {
     kind: 'select';
     key: string;
-    label: string;
+    label: MessageLike;
     options: readonly SettingsSelectOption[];
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'hint';
-    text: string;
+    text: MessageLike;
 };
 /**
  * One declarative settings row. To add a NEW inline control kind, see
@@ -388,15 +437,15 @@ type SettingsInlineControl = {
  */
 type SettingsRowDescriptor = {
     kind: 'heading';
-    label: string;
+    label: MessageLike;
     when?: SettingsRowWhen;
 } | {
     kind: 'header';
-    label: string;
+    label: MessageLike;
     when?: SettingsRowWhen;
 } | {
     kind: 'row';
-    label: string;
+    label: MessageLike;
     toggle?: {
         key: string;
         defval: boolean;
@@ -406,7 +455,7 @@ type SettingsRowDescriptor = {
 } | {
     kind: 'toggle';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: boolean;
     number?: SettingsRowInlineNumber;
     colors?: readonly SettingsRowSwatch[];
@@ -415,7 +464,7 @@ type SettingsRowDescriptor = {
 } | {
     kind: 'number';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: number;
     min?: number;
     max?: number;
@@ -424,26 +473,26 @@ type SettingsRowDescriptor = {
 } | {
     kind: 'color';
     key: string;
-    label: string;
+    label: MessageLike;
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'select';
     key: string;
-    label: string;
+    label: MessageLike;
     options: readonly SettingsSelectOption[];
     defval: string;
     when?: SettingsRowWhen;
 } | {
     kind: 'range';
-    label: string;
+    label: MessageLike;
     minKey: string;
     maxKey: string;
     defval: number;
     min?: number;
     max?: number;
     step?: number;
-    placeholder?: string;
+    placeholder?: MessageLike;
     when?: SettingsRowWhen;
 };
 /** A value-carrying row (everything except the key-less `heading`/`header` titles). */
@@ -452,7 +501,7 @@ type SettingsValueRow = Exclude<SettingsRowDescriptor, {
 }>;
 /** The canonical row shape every {@link SettingsValueRow} reduces to (the `row` kind's fields). */
 interface NormalizedSettingsRow {
-    label: string;
+    label: MessageLike;
     toggle?: {
         key: string;
         defval: boolean;
@@ -488,14 +537,14 @@ declare function settingsRowValueKeys(r: SettingsRowDescriptor): SettingsRowValu
  * present and not removable — the base instance.
  */
 interface ChartTypeSettingsInstance {
-    label: string;
+    label: MessageLike;
     /** Boolean bag key controlling presence; omitted = always present, not removable. */
     enableKey?: string;
     rows: readonly SettingsRowDescriptor[];
 }
 /** An indented sub-entry under the section's rail tab, with its own pane of rows. */
 interface ChartTypeSettingsSubsection {
-    title: string;
+    title: MessageLike;
     rows: readonly SettingsRowDescriptor[];
     /**
      * Boolean bag key that masters this pane. While it is false, every row EXCEPT the
@@ -524,7 +573,7 @@ interface ChartTypeSettingsSubsection {
  */
 interface ChartTypeSettingsSection {
     /** Section heading in the settings dialog. */
-    title: string;
+    title: MessageLike;
     /** Flat form. Ignored when `instances` is declared. */
     rows?: readonly SettingsRowDescriptor[];
     /** How `rows` are presented: `'flat'` (default) renders headings as inline group
@@ -618,6 +667,9 @@ interface RendererLayerArgs {
         x: number;
         y: number;
     } | null;
+    /** The chart's translator: `i18n.t(msg(...))` for text a layer paints, and
+     *  `i18n.format` for its numbers and dates, in the chart's locale. */
+    i18n: Translator;
 }
 /** How a layer dims/slims the BASE painting under it (see
  *  {@link RendererLayerInstance.modulateBase}). Omitted fields keep their defaults. */
@@ -728,4 +780,4 @@ declare const CATEGORICAL: readonly string[];
 /** Pick a stable categorical color for a string key (same key ⇒ same color). */
 declare function categoricalColor(key: string): string;
 
-export { getDrawingType as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, type SettingsRowInlineNumber as E, type SettingsRowSwatch as F, type SettingsRowValueKey as G, HIGHLIGHT as H, INFO as I, type SettingsRowWhen as J, type SettingsRowWidth as K, type SettingsValueRow as L, MARKER as M, NEUTRAL as N, TRADE_LONG as O, TRADE_SHORT as P, categoricalColor as Q, type RendererLayerArgs as R, type SettingsSelectOption as S, TRADE_EXIT as T, chartType as U, VALID as V, WARNING as W, chartTypes as X, createDrawing as Y, deserializeDrawing as Z, drawingTypes as _, ACCENT_BRIGHT as a, normalizeSettingsRow as a0, registerChartType as a1, registerDrawingType as a2, registerRendererDefaults as a3, registerRendererLayer as a4, rendererDefaults as a5, rendererLayers as a6, settingsRowValueKeys as a7, stableSeriesId as a8, tickerModifierIds as a9, unregisterChartType as aa, unregisterRendererDefaults as ab, unregisterRendererLayer as ac, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CHIP_PLATE as e, CROSSHAIR as f, type ChartTypeDefinition as g, type ChartTypeSettingsInstance as h, type ChartTypeSettingsSection as i, type ChartTypeSettingsSubsection as j, INVALID as k, type IdentifiableKind as l, type NormalizedSettingsRow as m, type RendererLayerDefinition as n, type RendererLayerInstance as o, SERIES_LINE as p, SESSION_OFF as q, SESSION_POST as r, SESSION_PRE as s, SLATE as t, SLATE_DEEP as u, type SeriesDataEngine as v, type SeriesDataEngineHost as w, type SettingsInlineControl as x, type SettingsRowCondition as y, type SettingsRowDescriptor as z };
+export { deserializeDrawing as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, type SettingsRowDescriptor as E, type SettingsRowInlineNumber as F, type SettingsRowSwatch as G, HIGHLIGHT as H, INFO as I, type SettingsRowValueKey as J, type SettingsRowWhen as K, type SettingsRowWidth as L, MARKER as M, NEUTRAL as N, type SettingsValueRow as O, TRADE_LONG as P, TRADE_SHORT as Q, type RendererLayerArgs as R, type SettingsSelectOption as S, TRADE_EXIT as T, categoricalColor as U, VALID as V, WARNING as W, chartType as X, chartTypes as Y, createDrawing as Z, createTranslator as _, ACCENT_BRIGHT as a, drawingTypes as a0, getDrawingType as a1, msg as a2, normalizeSettingsRow as a3, registerChartType as a4, registerDrawingType as a5, registerLocale as a6, registerRendererDefaults as a7, registerRendererLayer as a8, registeredLocales as a9, rendererDefaults as aa, rendererLayers as ab, settingsRowValueKeys as ac, stableSeriesId as ad, tickerModifierIds as ae, unregisterChartType as af, unregisterRendererDefaults as ag, unregisterRendererLayer as ah, withValues as ai, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CHIP_PLATE as e, CROSSHAIR as f, type ChartTypeDefinition as g, type ChartTypeSettingsInstance as h, type ChartTypeSettingsSection as i, type ChartTypeSettingsSubsection as j, INVALID as k, type IdentifiableKind as l, type MessageValues as m, type NormalizedSettingsRow as n, type RendererLayerDefinition as o, type RendererLayerInstance as p, SERIES_LINE as q, SESSION_OFF as r, SESSION_POST as s, SESSION_PRE as t, SLATE as u, SLATE_DEEP as v, type SeriesDataEngine as w, type SeriesDataEngineHost as x, type SettingsInlineControl as y, type SettingsRowCondition as z };