@luxalgo/vela 0.5.0 → 0.5.2

package/dist/widget.d.cts

@@ -1,10 +1,10 @@
-import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-o1GRKPI_.cjs';
-export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-o1GRKPI_.cjs';
-import { b as VelaOptions, q as DataWindowReadout } from './options-Q-576hIi.cjs';
+import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-Ci_i3IN2.cjs';
+export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-Ci_i3IN2.cjs';
+import { b as VelaOptions, q as DataWindowReadout } from './options-XTBpbx0s.cjs';
 import { K as KeymapManager } from './keymap-CGOz5F5f.cjs';
-import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-LJkz4-sS.cjs';
-export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-LJkz4-sS.cjs';
-import { a as SymbolDescriptor } from './DataProvider-DKNDHpNv.cjs';
+import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-Cf1lVsap.cjs';
+export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-Cf1lVsap.cjs';
+import { a as SymbolDescriptor } from './DataProvider-gnzv-dgc.cjs';
 import { d as SidePanel } from './side-panel-CT9ZwIGz.cjs';
 export { D as DEFAULT_PANEL_MAX_WIDTH, a as DEFAULT_PANEL_MIN_WIDTH, b as DEFAULT_PANEL_WIDTH, S as SidePanelOptions, c as clampPanelWidth } from './side-panel-CT9ZwIGz.cjs';
 
@@ -30,6 +30,7 @@ declare class VelaWidget {
     private shortcutsHelp;
     private readonly contextMenu;
     private readonly symbolPicker;
+    /** Null when the host disabled it (`indicatorPicker: false`). */
     private readonly indicatorPicker;
     private readonly tfQuick;
     private inner;
@@ -53,6 +54,8 @@ declare class VelaWidget {
     private watermarkOn;
     /** Indicator titles (the in-chart legend rows) shown — reapplied across rebuilds. */
     private indicatorTitlesOn;
+    /** Plot values beside the legend titles shown — reapplied across rebuilds. */
+    private indicatorValuesOn;
     private pendingRange;
     /** Symbol already reported as unservable (the core re-reports on every index settle). */
     private unresolvedToasted;
@@ -96,7 +99,30 @@ declare class VelaWidget {
     private indicatorsPromise;
     private destroyed;
     private buildSeq;
+    /** The chrome size class — writes `data-layout` on the root (all mobile CSS keys
+     *  off it) and pushes the mode into the renderer chrome on every change/rebuild. */
+    private layoutCtl;
+    private readonly mobileBar;
+    private readonly drawingPill;
+    private tfDrawer;
+    private drawingsDrawer;
+    private moreDrawer;
+    private timezoneDrawer;
+    private priceScaleDrawer;
+    /** Plot-local y of the last price-axis long-press (targets the pane under the finger). */
+    private priceScalePressY;
+    /** The active range chip id (both bottom bars + the timeframe drawer mirror it). */
+    private activeRangeId;
     constructor(container: HTMLElement | string, opts: VelaWidgetOptions);
+    /** The mode flipped (container resized across the breakpoint, or a coarse-pointer
+     *  change). Close the open surfaces — a desktop card must not linger over the
+     *  mobile chrome (and vice versa) — and re-present the renderer's own chrome. */
+    private onLayoutModeChange;
+    private openTimeframeDrawer;
+    private openDrawingsDrawer;
+    private openMoreDrawer;
+    private openTimezoneDrawer;
+    private openPriceScaleDrawer;
     /** Mount registered attachments not yet mounted on this widget (idempotent per id). */
     private mountAttachments;
     /** The context handed to contributed actions (see `registerWidgetAction`). */
@@ -158,6 +184,8 @@ declare class VelaWidget {
     setWatermarkVisible(visible: boolean): void;
     /** Show/hide the indicator titles — the in-chart legend rows (persisted). */
     setIndicatorTitlesVisible(visible: boolean): void;
+    /** Show/hide the plot values beside every indicator's legend title (persisted). */
+    setIndicatorValuesVisible(visible: boolean): void;
     /** Applied LIVE (renderer feature) — no rebuild; persists across rebuilds. */
     setPriceStyle(style: string): void;
     /** OHLC/change ink in the status line follows the ACTIVE price style's configured
@@ -215,6 +243,12 @@ declare class VelaWidget {
     private persistNow;
 }
 
+/** The current layout's footprint on the canvas (mirrors the workspace's LayoutShape). */
+type LayoutPickerShape = {
+    rows: number;
+    cols: number;
+};
+
 declare function priceStyleLabel(id: string): string;
 interface TopbarOptions {
     symbol: string;
@@ -224,23 +258,28 @@ interface TopbarOptions {
     priceStyle: string;
     onTimeframe: (tf: string) => void;
     onPriceStyle: (style: string) => void;
-    /** Optional workspace LAYOUT dropdown (rendered after the style dropdown when given).
-     *  `options` is read live, so plugin-registered layouts appear automatically. */
+    /** Optional workspace LAYOUT dropdown (rendered after the style dropdown when
+     *  given) — the grid-canvas picker composing uniform grids, with the workspace
+     *  SYNC switches beside it. Everything is read live, so plugin-registered
+     *  layouts and setting flips appear automatically. */
     layout?: {
         current: string;
-        options: () => Array<{
+        /** Current layout's picker-canvas shape (null = not canvas-expressible). */
+        shape: () => LayoutPickerShape | null;
+        /** Registered layouts the canvas cannot express — rendered as labeled rows. */
+        presets: () => Array<{
             id: string;
             label: string;
         }>;
-        onSelect: (id: string) => void;
-        /** Optional TOGGLE rows appended under the layout presets (e.g. the workspace's
-         *  "Sync crosshair"). Re-read on every open/refresh; `onToggle` flips one. */
-        toggles?: () => Array<{
+        onSelectGrid: (rows: number, cols: number) => void;
+        onSelectPreset: (id: string) => void;
+        /** SYNC switch rows (re-read on every open and after each toggle). */
+        syncs: () => Array<{
             id: string;
             label: string;
             checked: boolean;
         }>;
-        onToggle?: (id: string) => void;
+        onToggleSync: (id: string) => void;
     };
     onIndicatorsClick?: () => void;
     /** Unified undo/redo (same stack as Ctrl+Z / Ctrl+Y). Enabled state is pushed with
@@ -258,12 +297,16 @@ declare class Topbar {
     private readonly tfButton;
     private readonly styleButton;
     private layoutButton;
-    private layoutMenu;
+    private layoutPicker;
     private layoutId;
     private readonly tfMenu;
     private readonly styleMenu;
     private readonly tooltips;
     private readonly actionsHost;
+    /** Left-aligned contributed actions (`align: 'left'`) — right after the dropdowns. */
+    private readonly leftActionsHost;
+    /** The hairline after the left cluster — hidden while the cluster is empty. */
+    private readonly leftActionsSep;
     /** The side-panel toggle group — filled by the dock through {@link setPanelButtons}. */
     private readonly panelsHost;
     private undoBtn;
@@ -286,7 +329,6 @@ declare class Topbar {
     /** Reflect the current workspace layout (no-op without the layout dropdown). */
     setLayout(id: string): void;
     private renderLayoutButton;
-    private layoutItems;
     private renderStyleButton;
     /** Re-project the contributed topbar actions (call after registrations change). */
     renderActions(): void;
@@ -342,8 +384,22 @@ declare class Statusline {
     private isUp;
     /** 'ohlc' for bar-shaped styles; 'value' (the single plotted close) for line styles. */
     private readout;
+    /** Fit mode (multi-chart cells): one row, overflowing segments hidden — see {@link setFitMode}. */
+    private fitMode;
+    private fitRO;
     constructor(host: HTMLElement, symbol: string);
     setSymbol(symbol: string): void;
+    /**
+     * Multi-chart cells: keep the line on ONE row whatever the cell width — never wrap.
+     * Segments that don't fit are hidden outright rather than clipped mid-glyph, least
+     * important first: OHLC, then the bar change, the venue/timeframe meta, and the
+     * market badge; the logo + ticker always stay. Re-fits live on host resizes.
+     */
+    setFitMode(on: boolean): void;
+    /** Project the parts config onto the segments (the baseline fit() prunes from). */
+    private syncParts;
+    /** Hide overflowing segments until the row fits its max-width (fit mode only). */
+    private fit;
     /** Shape + color the value readout after the active price style: its own up/down
      *  colors (candle bodies, bar ticks, the line color, …), the direction rule that
      *  picks between them (`isUp` replaces close-vs-open where the style paints by
@@ -372,9 +428,22 @@ declare class Statusline {
 
 declare class Watermark {
     readonly el: HTMLElement;
+    private readonly text;
+    private readonly resizeObserver;
+    /** The host's visibility preference (the persisted watermark toggle). */
+    private shown;
+    /** A bar load is in flight with nothing painted — the loading affordance owns the
+     *  canvas, so the mark stays out of its way. Starts true: the FIRST `load:start`
+     *  fires during chart construction, before any subscriber can see it. */
+    private loading;
     constructor(host: HTMLElement, symbol: string, timeframe: string);
     setVisible(visible: boolean): void;
+    /** Loading and the watermark never share the canvas — hidden while a load is up. */
+    setLoading(loading: boolean): void;
+    private sync;
     update(symbol: string, timeframe: string): void;
+    /** Measure the text at the cap and shrink it to the chart's own width. */
+    private fit;
     destroy(): void;
 }
 
@@ -519,6 +588,9 @@ declare class PanelDock {
     toggle(id: string, open?: boolean): void;
     /** The open panel's id, or null when the column is closed. */
     get openId(): string | null;
+    /** The docked panels in dock order — what a non-topbar chrome (the mobile
+     *  three-dots drawer) lists so every panel stays reachable there too. */
+    list(): ReadonlyArray<SidePanelButton>;
     /** The dock's persistable state, or null when there is nothing worth saving. */
     getState(): PanelsState | null;
     /**
@@ -786,7 +858,7 @@ declare function normalizeTimezone(zone: string): string;
 declare function tzOffset(zone: string, date?: Date): string;
 /** Dropdown row label — UTC omits the offset prefix. */
 declare function tzMenuLabel(zone: string, location: string): string;
-/** Compact label for the bottom-bar button ("UTC", "UTC+2 Paris"). */
+/** Compact label for the bottom-bar button — just the offset ("UTC", "UTC+2", "UTC-9:30"). */
 declare function tzButtonLabel(zone: string): string;
 
 /** Sensible decimal count for a price magnitude (crypto-friendly). */

package/dist/widget.d.ts

@@ -1,10 +1,10 @@
-import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-hX3EUyjG.js';
-export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-hX3EUyjG.js';
-import { b as VelaOptions, q as DataWindowReadout } from './options-Q-576hIi.js';
+import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-b6AVrqqG.js';
+export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-b6AVrqqG.js';
+import { b as VelaOptions, q as DataWindowReadout } from './options-XTBpbx0s.js';
 import { K as KeymapManager } from './keymap-CGOz5F5f.js';
-import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-Dzxz-MQj.js';
-export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-Dzxz-MQj.js';
-import { a as SymbolDescriptor } from './DataProvider-Dzd-Erlk.js';
+import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-Ci3M0xLV.js';
+export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-Ci3M0xLV.js';
+import { a as SymbolDescriptor } from './DataProvider-DTOEXKTI.js';
 import { d as SidePanel } from './side-panel-CT9ZwIGz.js';
 export { D as DEFAULT_PANEL_MAX_WIDTH, a as DEFAULT_PANEL_MIN_WIDTH, b as DEFAULT_PANEL_WIDTH, S as SidePanelOptions, c as clampPanelWidth } from './side-panel-CT9ZwIGz.js';
 
@@ -30,6 +30,7 @@ declare class VelaWidget {
     private shortcutsHelp;
     private readonly contextMenu;
     private readonly symbolPicker;
+    /** Null when the host disabled it (`indicatorPicker: false`). */
     private readonly indicatorPicker;
     private readonly tfQuick;
     private inner;
@@ -53,6 +54,8 @@ declare class VelaWidget {
     private watermarkOn;
     /** Indicator titles (the in-chart legend rows) shown — reapplied across rebuilds. */
     private indicatorTitlesOn;
+    /** Plot values beside the legend titles shown — reapplied across rebuilds. */
+    private indicatorValuesOn;
     private pendingRange;
     /** Symbol already reported as unservable (the core re-reports on every index settle). */
     private unresolvedToasted;
@@ -96,7 +99,30 @@ declare class VelaWidget {
     private indicatorsPromise;
     private destroyed;
     private buildSeq;
+    /** The chrome size class — writes `data-layout` on the root (all mobile CSS keys
+     *  off it) and pushes the mode into the renderer chrome on every change/rebuild. */
+    private layoutCtl;
+    private readonly mobileBar;
+    private readonly drawingPill;
+    private tfDrawer;
+    private drawingsDrawer;
+    private moreDrawer;
+    private timezoneDrawer;
+    private priceScaleDrawer;
+    /** Plot-local y of the last price-axis long-press (targets the pane under the finger). */
+    private priceScalePressY;
+    /** The active range chip id (both bottom bars + the timeframe drawer mirror it). */
+    private activeRangeId;
     constructor(container: HTMLElement | string, opts: VelaWidgetOptions);
+    /** The mode flipped (container resized across the breakpoint, or a coarse-pointer
+     *  change). Close the open surfaces — a desktop card must not linger over the
+     *  mobile chrome (and vice versa) — and re-present the renderer's own chrome. */
+    private onLayoutModeChange;
+    private openTimeframeDrawer;
+    private openDrawingsDrawer;
+    private openMoreDrawer;
+    private openTimezoneDrawer;
+    private openPriceScaleDrawer;
     /** Mount registered attachments not yet mounted on this widget (idempotent per id). */
     private mountAttachments;
     /** The context handed to contributed actions (see `registerWidgetAction`). */
@@ -158,6 +184,8 @@ declare class VelaWidget {
     setWatermarkVisible(visible: boolean): void;
     /** Show/hide the indicator titles — the in-chart legend rows (persisted). */
     setIndicatorTitlesVisible(visible: boolean): void;
+    /** Show/hide the plot values beside every indicator's legend title (persisted). */
+    setIndicatorValuesVisible(visible: boolean): void;
     /** Applied LIVE (renderer feature) — no rebuild; persists across rebuilds. */
     setPriceStyle(style: string): void;
     /** OHLC/change ink in the status line follows the ACTIVE price style's configured
@@ -215,6 +243,12 @@ declare class VelaWidget {
     private persistNow;
 }
 
+/** The current layout's footprint on the canvas (mirrors the workspace's LayoutShape). */
+type LayoutPickerShape = {
+    rows: number;
+    cols: number;
+};
+
 declare function priceStyleLabel(id: string): string;
 interface TopbarOptions {
     symbol: string;
@@ -224,23 +258,28 @@ interface TopbarOptions {
     priceStyle: string;
     onTimeframe: (tf: string) => void;
     onPriceStyle: (style: string) => void;
-    /** Optional workspace LAYOUT dropdown (rendered after the style dropdown when given).
-     *  `options` is read live, so plugin-registered layouts appear automatically. */
+    /** Optional workspace LAYOUT dropdown (rendered after the style dropdown when
+     *  given) — the grid-canvas picker composing uniform grids, with the workspace
+     *  SYNC switches beside it. Everything is read live, so plugin-registered
+     *  layouts and setting flips appear automatically. */
     layout?: {
         current: string;
-        options: () => Array<{
+        /** Current layout's picker-canvas shape (null = not canvas-expressible). */
+        shape: () => LayoutPickerShape | null;
+        /** Registered layouts the canvas cannot express — rendered as labeled rows. */
+        presets: () => Array<{
             id: string;
             label: string;
         }>;
-        onSelect: (id: string) => void;
-        /** Optional TOGGLE rows appended under the layout presets (e.g. the workspace's
-         *  "Sync crosshair"). Re-read on every open/refresh; `onToggle` flips one. */
-        toggles?: () => Array<{
+        onSelectGrid: (rows: number, cols: number) => void;
+        onSelectPreset: (id: string) => void;
+        /** SYNC switch rows (re-read on every open and after each toggle). */
+        syncs: () => Array<{
             id: string;
             label: string;
             checked: boolean;
         }>;
-        onToggle?: (id: string) => void;
+        onToggleSync: (id: string) => void;
     };
     onIndicatorsClick?: () => void;
     /** Unified undo/redo (same stack as Ctrl+Z / Ctrl+Y). Enabled state is pushed with
@@ -258,12 +297,16 @@ declare class Topbar {
     private readonly tfButton;
     private readonly styleButton;
     private layoutButton;
-    private layoutMenu;
+    private layoutPicker;
     private layoutId;
     private readonly tfMenu;
     private readonly styleMenu;
     private readonly tooltips;
     private readonly actionsHost;
+    /** Left-aligned contributed actions (`align: 'left'`) — right after the dropdowns. */
+    private readonly leftActionsHost;
+    /** The hairline after the left cluster — hidden while the cluster is empty. */
+    private readonly leftActionsSep;
     /** The side-panel toggle group — filled by the dock through {@link setPanelButtons}. */
     private readonly panelsHost;
     private undoBtn;
@@ -286,7 +329,6 @@ declare class Topbar {
     /** Reflect the current workspace layout (no-op without the layout dropdown). */
     setLayout(id: string): void;
     private renderLayoutButton;
-    private layoutItems;
     private renderStyleButton;
     /** Re-project the contributed topbar actions (call after registrations change). */
     renderActions(): void;
@@ -342,8 +384,22 @@ declare class Statusline {
     private isUp;
     /** 'ohlc' for bar-shaped styles; 'value' (the single plotted close) for line styles. */
     private readout;
+    /** Fit mode (multi-chart cells): one row, overflowing segments hidden — see {@link setFitMode}. */
+    private fitMode;
+    private fitRO;
     constructor(host: HTMLElement, symbol: string);
     setSymbol(symbol: string): void;
+    /**
+     * Multi-chart cells: keep the line on ONE row whatever the cell width — never wrap.
+     * Segments that don't fit are hidden outright rather than clipped mid-glyph, least
+     * important first: OHLC, then the bar change, the venue/timeframe meta, and the
+     * market badge; the logo + ticker always stay. Re-fits live on host resizes.
+     */
+    setFitMode(on: boolean): void;
+    /** Project the parts config onto the segments (the baseline fit() prunes from). */
+    private syncParts;
+    /** Hide overflowing segments until the row fits its max-width (fit mode only). */
+    private fit;
     /** Shape + color the value readout after the active price style: its own up/down
      *  colors (candle bodies, bar ticks, the line color, …), the direction rule that
      *  picks between them (`isUp` replaces close-vs-open where the style paints by
@@ -372,9 +428,22 @@ declare class Statusline {
 
 declare class Watermark {
     readonly el: HTMLElement;
+    private readonly text;
+    private readonly resizeObserver;
+    /** The host's visibility preference (the persisted watermark toggle). */
+    private shown;
+    /** A bar load is in flight with nothing painted — the loading affordance owns the
+     *  canvas, so the mark stays out of its way. Starts true: the FIRST `load:start`
+     *  fires during chart construction, before any subscriber can see it. */
+    private loading;
     constructor(host: HTMLElement, symbol: string, timeframe: string);
     setVisible(visible: boolean): void;
+    /** Loading and the watermark never share the canvas — hidden while a load is up. */
+    setLoading(loading: boolean): void;
+    private sync;
     update(symbol: string, timeframe: string): void;
+    /** Measure the text at the cap and shrink it to the chart's own width. */
+    private fit;
     destroy(): void;
 }
 
@@ -519,6 +588,9 @@ declare class PanelDock {
     toggle(id: string, open?: boolean): void;
     /** The open panel's id, or null when the column is closed. */
     get openId(): string | null;
+    /** The docked panels in dock order — what a non-topbar chrome (the mobile
+     *  three-dots drawer) lists so every panel stays reachable there too. */
+    list(): ReadonlyArray<SidePanelButton>;
     /** The dock's persistable state, or null when there is nothing worth saving. */
     getState(): PanelsState | null;
     /**
@@ -786,7 +858,7 @@ declare function normalizeTimezone(zone: string): string;
 declare function tzOffset(zone: string, date?: Date): string;
 /** Dropdown row label — UTC omits the offset prefix. */
 declare function tzMenuLabel(zone: string, location: string): string;
-/** Compact label for the bottom-bar button ("UTC", "UTC+2 Paris"). */
+/** Compact label for the bottom-bar button — just the offset ("UTC", "UTC+2", "UTC-9:30"). */
 declare function tzButtonLabel(zone: string): string;
 
 /** Sensible decimal count for a price magnitude (crypto-friendly). */