@luxalgo/vela 0.6.4 → 0.6.6

package/dist/widget.d.cts

@@ -1,288 +1,54 @@
-import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-2bEmCF9S.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-2bEmCF9S.cjs';
-import { b as VelaOptions, d as MarketSession, r as DataWindowReadout } from './options-YdiaaVjt.cjs';
+import { V as Vela, W as WidgetContext, A as SidePanelButton } from './contributions-DNMqrAuw.cjs';
+export { C as CellStateContext, an as DEFAULT_PANEL_ORDER, E as ExternalIndicatorEntry, G as SidePanelDescriptor, H as SidePanelHandle, K as StatePersistenceHandler, Z as WidgetActionDescriptor, _ as WidgetActionTarget, $ as WidgetAttachment, a7 as registerSidePanel, a8 as registerStatePersistence, a9 as registerWidgetAction, aa as registerWidgetAttachment, ac as sidePanels, ad as statePersistenceHandlers, ah as unregisterSidePanel, ai as unregisterStatePersistence, aj as unregisterWidgetAction, ak as unregisterWidgetAttachment, al as widgetActions, am as widgetAttachments } from './contributions-DNMqrAuw.cjs';
+import { b as VelaOptions, d as MarketSession, T as ThemeName, c as VelaTheme, r as DataWindowReadout } from './options-BaVTMXaO.cjs';
+import { b as VelaShellOptions, W as WidgetHistory, a as RangePreset, e as WorkspaceState, P as PanelsState } from './bottombar-DeDXbF_K.cjs';
+export { B as Bottombar, i as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, j as IndicatorManifest, k as IndicatorManifestEntry, l as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, m as WidgetStorage, g as decodeState, h as encodeState, n as localStorageAdapter, r as resolveIndicators, s as sanitizeState } from './bottombar-DeDXbF_K.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-BmyjaVir.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-BmyjaVir.cjs';
-import { a as SymbolDescriptor } from './DataProvider-DrN7ZIou.cjs';
+import { a as SymbolDescriptor } from './DataProvider-DDUYw2qP.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';
 
 interface VelaWidgetOptions extends VelaOptions, VelaShellOptions {
-    /** Mirror symbol/timeframe/style/timezone in the URL query (shareable links). A URL
-     *  param wins over persisted state at load. Default false. */
+    /** @deprecated No longer supported — the option is ignored (a console warning
+     *  says so). Mirror `getState()` into your own URL scheme if you need links. */
     urlState?: boolean;
 }
+/**
+ * @deprecated Use {@link VelaWorkspace} with `layout: false` — the same chart, the
+ * same options, the same persisted state (pass `persist: 'vela-widget'` to keep
+ * reading this class's storage key). This wrapper delegates everything and will be
+ * removed in a future release.
+ */
 declare class VelaWidget {
-    readonly root: HTMLElement;
-    /** The shortcut system — widget modules and plugins register their bindings here. */
-    readonly keymap: KeymapManager;
-    private readonly opts;
-    private readonly chartHost;
-    private readonly topbar;
-    private readonly statusline;
-    /** Keeps the statusline's market badge on the symbol's real calendar (see {@link MarketStatusTracker}). */
-    private readonly marketStatus;
-    /** Keeps the pre/post-market shading on the symbol's real calendar (see {@link SessionShadingTracker}). */
-    private readonly sessionShading;
-    /** Whether the ACTIVE symbol declares real trading sessions (RTH/ETH meaningful) —
-     *  gates the bottombar toggle and the settings dialog's Trading session group. */
-    private sessionsAvailable;
-    private readonly watermark;
-    private readonly bottombar;
-    private readonly objectTree;
-    private readonly dataWindow;
-    /** The side-panel column: the two panels above, plus every contributed one. */
-    private readonly dock;
-    private shortcutsHelp;
-    private readonly contextMenu;
-    private readonly symbolPicker;
-    /** Null when the host disabled it (`indicatorPicker: false`). */
-    private readonly indicatorPicker;
-    private readonly tfQuick;
-    private inner;
-    /** The manifest library (loaded once). */
-    private manifest;
-    /** Live instances — the SAME entry may be added several times. */
-    private instances;
-    /** Native-indicator catalog of the CURRENT chart (refreshed per rebuild/change). */
-    private nativeCatalog;
-    /** Present native types, mirrored SYNC from the chart (see syncPresentNatives). */
-    private presentNatives;
-    private readonly storageKey;
-    private readonly storage;
-    private openDialogs;
-    private readonly onRootKeydown;
-    private symbol;
-    private timeframe;
-    private priceStyle;
-    private timezone;
-    private bars;
-    /** The shown trading session — undefined = the provider default (regular). */
-    private session;
-    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;
-    /** Extra fetch depth the ACTIVE range chip needs — a view concern, kept apart from the
-     *  user's own `bars` setting so a preset never overwrites their preference. */
-    private rangeBars;
-    private toast;
-    private alerts;
-    private alertsMenu;
-    private readonly glider;
-    /** Unified app+drawings undo timeline (Ctrl+Z / Ctrl+Y). Late-resolves the CURRENT
-     *  inner chart so steps recorded before a rebuild never act on a destroyed instance. */
-    readonly history: WidgetHistory;
-    private lastCrossPrice;
-    private lastCrossTime;
-    /** Renderer cosmetic template carried across rebuilds (and persisted when enabled). */
-    private savedConfig;
-    /** User-drawings document carried across rebuilds (and persisted when enabled). */
-    private savedDrawings;
-    /** A restored indicator ledger waiting for the manifest to resolve. */
-    private pendingIndicators;
-    /** Volume presence decided by a RESTORED ledger (null = follow the option). */
-    private ledgerVolume;
-    /** The manifest can no longer change the instance set: it resolved, or no `indicators`
-     *  option exists so nothing will ever resolve. Gates the ledger's pending fallback —
-     *  once settled, a live empty set means "the user removed everything" and persists so. */
-    private manifestSettled;
-    /** The volume auto-add rides the first candles (`load:end`); until then the registry
-     *  can't show it and the persisted ledger reports the INTENT instead. */
-    private volumeMayBePending;
-    /** True when the boot state came from the LEGACY three-key layout — the first
-     *  unified save then drops the old `:config`/`:drawings` sub-keys. */
-    private legacyKeys;
-    private stateTimer;
-    private readonly stateListeners;
-    /** Favorite drawing-tool types — mirrored from chart events, reapplied on rebuilds. */
-    private favs;
-    /** Favorite timeframes — the topbar's quick-switch chips, persisted with the shell. */
-    private tfFavs;
-    /** Mounted attachment disposers (by id), torn down at destroy. */
-    private readonly attachmentDisposers;
-    private readonly onUnload;
-    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;
+    private readonly ws;
     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`). */
+    /** The shell root element (the workspace root; carries `vela-widget` as an alias). */
+    get root(): HTMLElement;
+    get keymap(): KeymapManager;
+    /** The chart's unified undo timeline — resolve it fresh, never cache it. */
+    get history(): WidgetHistory;
+    /** The inner headless chart. */
+    get chart(): Vela;
+    /** A fresh contribution context (the workspace's is a superset of the widget's). */
     context(): WidgetContext;
-    /** The recent engine alerts (topbar bell). */
-    private openAlertsMenu;
-    /** Re-project contributed topbar actions and side panels (after late registrations). */
     refreshActions(): void;
-    /** The inner headless chart of the CURRENT build — becomes a new instance after a
-     *  symbol/timeframe change; don't cache it across awaits. */
-    get chart(): Vela;
-    /** Chrome that must follow the timeframe wherever it changes from (menu, quick entry,
-     *  range chip, API). Keeping it in one place is what stopped the status line from
-     *  drifting out of sync with the topbar. */
-    private syncTimeframeChrome;
-    /**
-     * The venue label to show: the LISTING prefix the resolved symbol's data declares
-     * (`NASDAQ` for AAPL), else the provider that RESOLVED the symbol — never the one
-     * configured or typed. They differ whenever the `provider` option is just a default,
-     * the prefix was a listing venue, or the spelling isn't registered — the status line
-     * must not claim a venue that served nothing.
-     */
-    private providerLabel;
-    setTimeframe(tf: string): void;
-    /**
-     * Switch the shown trading session (RTH/ETH) in place — a full reload, like a
-     * timeframe change (the two sessions are different bar series). No-op on a chart
-     * already showing that session; meaningless on continuous markets (the toggle is
-     * disabled there, but the API tolerates the call — the provider ignores the flag).
-     */
-    setSession(session: MarketSession): void;
-    /** Re-derive the session chrome from the ACTIVE symbol's metadata: the RTH/ETH
-     *  toggle shows (and the settings dialog's Trading session group appears) iff the
-     *  resolved symbol declares a real session vocabulary (not `24x7`); the pre/post
-     *  shading re-derives for the new market either way. */
-    private refreshSessionToggle;
-    /** (Re)derive the pre/post-market shading bands for the current market. The loaded
-     *  depth (bars × timeframe) bounds the calendar fetch; the tracker clamps it. */
-    private refreshSessionShading;
-    /** The session-shade colors live in the renderer CONFIG (persisted with it, edited
-     *  live by the dialog swatch) — the widget only proxies them into its settings rows. */
-    private sessionShadeColor;
-    private setSessionShadeColor;
-    /**
-     * (Re)contribute the widget's settings-dialog sections: status line parts, the fetch
-     * depth, the watermark toggle, and — only while the active symbol HAS sessions — the
-     * Trading session group (RTH/ETH switch + the pre/post-market shading colors) inside
-     * the Symbol tab. Re-run whenever a gate changes (the dialog reads them on open).
-     */
-    private pushSettingsSections;
-    /** Star/unstar a timeframe — the topbar chips and dropdown stars follow, and the
-     *  set persists with the rest of the shell state. */
-    private setTimeframeFavorite;
-    /**
-     * Switch the chart symbol in place. An `EXCHANGE:` prefix pins the venue (the
-     * symbol picker composes one from the row the user pointed at) — a bare ticker
-     * resolves against the registered providers in declaration order.
-     */
     setSymbol(symbol: string): void;
-    /**
-     * Snapshot the COMPLETE widget state as the unified shell document — the SAME
-     * format `VelaWorkspace.getState()` returns, with a single `c1` cell: market,
-     * display prefs, the renderer config document, the user-drawings document, and
-     * the indicator ledger. This is what `persist` writes; hosts build custom flows
-     * on it (server snapshots, share links, templates) — and a saved widget state
-     * drops into a workspace slot as-is.
-     */
-    getState(): WorkspaceState;
-    /**
-     * Restore a state document produced by {@link getState} — or by a WORKSPACE (the
-     * first cell of a multi-cell document applies). Untrusted-safe: malformed fields
-     * are dropped. Applied IN PLACE: the chart instance survives (market switches via
-     * `setMarket`), config/drawings/indicators are replaced. With `urlState` enabled,
-     * URL params still win over the document's market/prefs fields.
-     */
-    applyState(state: unknown): void;
-    /** Subscribe to `state:changed` — the persistable state changed (debounced ~500ms);
-     *  re-pull {@link getState}. Returns an unsubscribe function. */
-    on(event: 'state:changed', handler: () => void): () => void;
-    /** Replace the indicator ledger: natives converge to the listed set (volume
-     *  included — removing it sticks, the core's auto-add respects the opt-out),
-     *  manifest instances are re-created by name — held until the manifest resolves. */
-    private applyIndicatorLedger;
-    /** SYNC boot fallback: a LEGACY three-key payload read at construction. */
-    private bootLegacySync;
-    /** ASYNC boot: resolve the unified document (or migrate a legacy payload), then
-     *  late-apply it — the widget built with option defaults in the meantime. */
-    private bootAsync;
-    /** Show/hide the symbol watermark behind the chart (persisted). */
+    setTimeframe(timeframe: string): void;
+    setSession(session: MarketSession): void;
+    setPriceStyle(style: string): void;
     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
-     *  colors and direction rule (candle bodies by close-vs-open, baseline by position
-     *  against the live baseline price, …) instead of the fixed theme tokens. */
-    private syncStatuslineColors;
-    /** The widget shell (topbar, panels) keeps the app theme; the chart host's tokens
-     *  re-derive from the LIVE plot surface (see {@link applyPlotOverlayTokens}). */
-    private syncPlotOverlayTokens;
-    /**
-     * Swap the widget theme at runtime — `'dark'`, `'light'`, or a full custom theme.
-     * Applied LIVE: the inner chart re-skins through `Vela.setTheme` and its
-     * `theme:changed` event re-tokens the widget chrome (topbar, menus, panels) in
-     * place; the choice also persists into rebuilds. Same switch the user reaches from
-     * chart settings → Canvas → Theme.
-     */
-    setTheme(theme: NonNullable<VelaOptions['theme']>): void;
-    /** Applied LIVE (renderer feature) — no rebuild; persists across rebuilds. */
+    setTheme(theme: ThemeName | VelaTheme): void;
     setTimezone(zone: string): void;
-    /**
-     * Range chip: switch to the preset's timeframe, fetch enough history for its window,
-     * and frame it once ready. The in-place `setMarket` loads the depth, so it also runs
-     * when only the DEPTH grows (same timeframe, deeper window).
-     */
     applyRange(preset: RangePreset): void;
+    /** The unified state document (`layout: '1'`, one cell). */
+    getState(): WorkspaceState;
+    /** Restore a state document IN PLACE — the chart instance survives. */
+    applyState(state: unknown): void;
+    /** Subscribe to `state:changed` (the only widget event — unknown names no-op). */
+    on(event: 'state:changed', handler: () => void): () => void;
     destroy(): void;
-    /** Destroy + recreate the inner chart with the current symbol/timeframe, then
-     *  re-register providers/engines, rebind chrome, and re-add manifest indicators. */
-    private rebuild;
-    /** Refresh the native catalog (supported/present flags) for the current chart. */
-    private refreshNativeCatalog;
-    /** Add a native indicator (single-instance per type — the core dedupes). */
-    private addNative;
-    private removeNative;
-    /** Sync mirror of the chart's present native types — the removal handler diffs
-     *  against it to identify (and record) whichever type was just removed. */
-    private syncPresentNatives;
-    /** Add ONE instance of a manifest entry (repeatable — duplicates are legitimate). */
-    private addInstance;
-    /** Remove one live instance (picker trash). */
-    private removeInstance;
-    private dropInstance;
-    private syncIndicatorCount;
-    private addToChart;
-    /** Bare-typing router: letters → symbol search (seeded), digits → timeframe entry. */
-    private routeTyping;
-    private trackDialog;
-    private downloadScreenshot;
-    /** The persistable state changed: debounce (~500ms), then notify `state:changed`
-     *  listeners and flush — the same cadence as the workspace. */
-    private markStateDirty;
-    /** Write the unified state document through the adapter (persist mode only) — also
-     *  the unload/destroy flush. The first save after a LEGACY boot rewrites the main
-     *  key in the unified format and drops the old `:config`/`:drawings` sub-keys. */
-    private persistNow;
 }
 
 /** The current layout's footprint on the canvas (mirrors the workspace's LayoutShape). */
@@ -521,6 +287,7 @@ declare class SymbolPicker {
     private seed;
     private activeTab;
     private tabs;
+    private visible;
     constructor(opts: SymbolPickerOptions);
     /** Wire where symbols come from (re-called on every widget rebuild). */
     setSource(source: () => readonly SymbolDescriptor[]): void;
@@ -530,7 +297,11 @@ declare class SymbolPicker {
     private select;
     private moveHighlight;
     private renderHighlight;
+    private computeRows;
     private refresh;
+    /** Append the page the grown `visible` just uncovered — rows already on screen stay put. */
+    private grow;
+    private rowEl;
 }
 
 interface IndicatorRow {
@@ -585,9 +356,6 @@ declare class TimeframeQuick {
     private renderHint;
 }
 
-declare function readUrlState(search: string): PersistedState;
-declare function writeUrlState(state: PersistedState): void;
-
 /** What the dock needs from whatever chrome shows its toggles. */
 interface PanelChrome {
     /** Replace the panel toggle group (dock order). `onClick` receives the panel id. */
@@ -917,4 +685,4 @@ declare function fmtPrice(n: number | null | undefined, dp?: number): string;
 /** Signed change + percent ("+123.45 (+1.23%)") from open→close; `''` when unavailable. */
 declare function fmtChange(open: number | null | undefined, close: number | null | undefined): string;
 
-export { type BuiltInPanel, ChartContextMenu, type ContextMenuCallbacks, DataWindow, type DataWindowLine, type DataWindowSection, IndicatorPicker, type IndicatorPickerOptions, type IndicatorRow, ObjectTree, type PanelChrome, PanelDock, type PanelDockDeps, PanelsState, type ParsedTimeframe, PersistedState, RangePreset, ShortcutsHelp, SidePanel, SidePanelButton, Statusline, SymbolPicker, type SymbolPickerOptions, TIMEZONES, TimeframeQuick, type TimeframeQuickOptions, type TimezoneEntry, Topbar, type TopbarOptions, VelaShellOptions, VelaWidget, type VelaWidgetOptions, Watermark, WidgetContext, WorkspaceState, dataWindowSections, decimalsFor, filterSymbols, fmtChange, fmtPrice, normalizeTimezone, parseTimeframe, priceStyleLabel, readUrlState, timeframeLabel, timeframeMs, tzButtonLabel, tzMenuLabel, tzOffset, writeUrlState };
+export { type BuiltInPanel, ChartContextMenu, type ContextMenuCallbacks, DataWindow, type DataWindowLine, type DataWindowSection, IndicatorPicker, type IndicatorPickerOptions, type IndicatorRow, ObjectTree, type PanelChrome, PanelDock, type PanelDockDeps, PanelsState, type ParsedTimeframe, RangePreset, ShortcutsHelp, SidePanel, SidePanelButton, Statusline, SymbolPicker, type SymbolPickerOptions, TIMEZONES, TimeframeQuick, type TimeframeQuickOptions, type TimezoneEntry, Topbar, type TopbarOptions, VelaShellOptions, VelaWidget, type VelaWidgetOptions, Watermark, WidgetContext, WorkspaceState, dataWindowSections, decimalsFor, filterSymbols, fmtChange, fmtPrice, normalizeTimezone, parseTimeframe, priceStyleLabel, timeframeLabel, timeframeMs, tzButtonLabel, tzMenuLabel, tzOffset };