@luxalgo/vela 0.5.0

package/dist/history-Dzxz-MQj.d.ts

@@ -0,0 +1,298 @@
+import { V as VisibleRangePreset } from './options-Q-576hIi.js';
+import { D as DataProvider } from './DataProvider-Dzd-Erlk.js';
+import { S as ScriptingEngine, V as Vela } from './contributions-hX3EUyjG.js';
+
+interface RangePreset {
+    /** Button label. */
+    id: string;
+    /** Timeframe to switch to for this range. */
+    tf: string;
+    /** The core visible-range preset framed once the chart is ready. */
+    preset: VisibleRangePreset;
+    /**
+     * Bars the window needs AT `tf` — the fetch budget for the rebuild. Without it the
+     * chart loads its default depth and the framed window is clipped to whatever
+     * history happens to be loaded (a "1D" that only shows 16 hours). Includes a small
+     * margin; `ALL` asks for as much history as the provider will serve.
+     */
+    bars: number;
+}
+/**
+ * Range chips — each pairs a timeframe, a visible window, and the fetch depth that
+ * window needs. Resolutions follow the reference: the shorter the range, the finer the
+ * bars (1 day of 1-minute bars … 5 years of weekly bars).
+ */
+declare const RANGE_PRESETS: readonly RangePreset[];
+interface BottombarOptions {
+    timezone: string;
+    onRange: (preset: RangePreset) => void;
+    onTimezone: (zone: string) => void;
+    onSettingsClick?: () => void;
+}
+declare class Bottombar {
+    readonly el: HTMLElement;
+    private readonly clockEl;
+    private readonly tzLabelEl;
+    private readonly tzButton;
+    private readonly tzMenu;
+    private readonly settingsTip;
+    private readonly rangeButtons;
+    private timezone;
+    private timer;
+    constructor(host: HTMLElement, opts: BottombarOptions);
+    setTimezone(zone: string): void;
+    /** Highlight (or clear with null) the active range chip — cleared on manual tf changes. */
+    setActiveRange(id: string | null): void;
+    destroy(): void;
+    private tzItems;
+    private tick;
+}
+
+interface IndicatorManifestEntry {
+    name: string;
+    /** Inline script source (one of script/url required). */
+    script?: string;
+    /** Fetch the source from here instead (resolved relative to the manifest URL). */
+    url?: string;
+    /** Engine language (default: the chart's default engine). */
+    language?: string;
+    /** Add to the chart at startup (default true). Disabled entries only appear in pickers. */
+    enabled?: boolean;
+    /** Picker grouping (default 'Indicators'). */
+    category?: string;
+}
+type IndicatorManifest = IndicatorManifestEntry[] | {
+    indicators: IndicatorManifestEntry[];
+};
+/** A manifest entry with its source resolved and ready for `chart.addIndicator`. */
+interface ResolvedIndicator {
+    name: string;
+    script: string;
+    language?: string;
+    enabled: boolean;
+    category?: string;
+}
+/** An async manifest source — called once at resolution time. The escape hatch for
+ *  manifests that a URL can't express: a filesystem read, an authenticated API, a
+ *  bundler dynamic import. A rejection behaves like a failing manifest URL. */
+type IndicatorLoader = () => Promise<IndicatorManifest>;
+/** Load the indicator list: a manifest object, a URL string returning the manifest JSON,
+ *  or an async loader function returning the manifest. Entries with `url` sources are
+ *  fetched here too (relative to the manifest URL when there is one). Entries that fail
+ *  to resolve are dropped with a console warning — one broken script must not take the
+ *  chart down. */
+declare function resolveIndicators(config: string | IndicatorManifest | IndicatorLoader, fetchImpl?: typeof fetch): Promise<ResolvedIndicator[]>;
+
+/** The linkable dimensions. `crosshair` mirrors the pointer time onto same-group
+ *  cells as GHOST crosshairs (renderers without the optional `setExternalCrosshair`
+ *  seam simply never display one). */
+type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair';
+/**
+ * One link's configuration: `false`/absent = off; `true` = ALL cells linked (one
+ * implicit group); a record maps cell id → group name, and only cells sharing a group
+ * follow each other (a cell absent from the record is unlinked).
+ */
+type SyncSetting = boolean | Readonly<Record<string, string>>;
+interface SyncOptions {
+    viewport?: SyncSetting;
+    symbol?: SyncSetting;
+    timeframe?: SyncSetting;
+    crosshair?: SyncSetting;
+}
+/** Splitter track weights along each grid axis. */
+interface TrackSizes {
+    cols?: number[];
+    rows?: number[];
+}
+/**
+ * The docked side panels — a SHELL-level pref (one dock serves every cell of a workspace).
+ * `open` is the single panel showing (the dock is exclusive); `widths` holds only the columns
+ * the user actually resized, by panel id, so a panel's declared width stays in charge until
+ * then. Absent altogether in documents written before the dock existed.
+ */
+interface PanelsState {
+    open?: string;
+    widths?: Record<string, number>;
+}
+/** Per-chart (per-cell) state: the market, the display prefs, the content documents,
+ *  and the indicator ledger. The widget's whole chart state is ONE of these. */
+interface CellState {
+    symbol?: string;
+    /** The symbol's venue. Mirrors the symbol's own `EXCHANGE:` prefix on new saves;
+     *  pre-prefix documents stored it beside a BARE symbol — {@link prefixedSymbol}
+     *  welds the two back into the one canonical form at restore time. */
+    provider?: string;
+    timeframe?: string;
+    priceStyle?: string;
+    bars?: number;
+    /** Symbol watermark visibility — a per-chart display pref. */
+    watermark?: boolean;
+    /** Indicator titles (the in-chart legend rows) visibility — a per-chart display pref. */
+    indicatorTitles?: boolean;
+    /** The renderer's cosmetic config document (`renderer.getConfig()`). */
+    rendererConfig?: unknown;
+    /** The user-drawings document (`drawings.toJSON()`). */
+    drawings?: unknown;
+    /** The indicator ledger: manifest entries by name + present native types. */
+    indicators?: {
+        manifest: string[];
+        natives: string[];
+    };
+}
+/** One entry of the document's `charts` array: a chart's state plus its cell IDENTITY. */
+interface ChartState extends CellState {
+    /** The cell's durable identity — its declared name (`btc`), or `c<N>` for a slot no
+     *  entry declared. Unique within the document; array position restores slot order. */
+    id: string;
+}
+/** The versioned shell-state document — everything `applyState` restores. */
+interface WorkspaceState {
+    version: 1;
+    /** The layout id — always `'1'` for a widget. Restoring an id that is not
+     *  registered keeps the current layout — register custom layouts
+     *  (`registerLayout`) before applying a saved state. */
+    layout: string;
+    /** Splitter track weights, per layout id (workspace only). */
+    trackSizes?: Record<string, TrackSizes>;
+    activeCellId?: string;
+    /** Sync links (workspace only). */
+    sync?: SyncOptions;
+    /** Shared display timezone. */
+    timezone?: string;
+    /** Favorite drawing-tool types — a SHARED preference (one star set per shell). */
+    favorites?: string[];
+    /** The docked side panels: which one is open, and the widths the user dragged. */
+    panels?: PanelsState;
+    /** Per-chart state, one entry per SLOT (a single `c1` entry for the widget).
+     *  Ids are unique — the codec drops id-less entries and keeps the LAST duplicate. */
+    charts: ChartState[];
+}
+declare function encodeState(state: WorkspaceState): string;
+/** Parse + sanitize a persisted payload. Null on anything unusable (wrong version,
+ *  not JSON, not an object) — malformed FIELDS are dropped, never thrown on. */
+declare function decodeState(raw: string): WorkspaceState | null;
+/**
+ * Validate an untrusted state document field by field (the `applyState` gate). Unknown
+ * or malformed fields are dropped; nested renderer-config / drawings documents pass
+ * through OPAQUELY — their own consumers (`applyConfig`, `fromJSON`) validate them.
+ */
+declare function sanitizeState(doc: unknown): WorkspaceState | null;
+
+/** The storage contract BOTH shells persist through (the widget and the workspace —
+ *  one name, one shape). Methods may be synchronous or return promises. */
+interface VelaStorage {
+    get(key: string): string | null | Promise<string | null>;
+    set(key: string, value: string): void | Promise<void>;
+    remove?(key: string): void | Promise<void>;
+}
+/** @deprecated Use {@link VelaStorage} — same contract, shell-neutral name. */
+type WidgetStorage = VelaStorage;
+/**
+ * The default adapter — window.localStorage, silent on quota/privacy failures.
+ *
+ * `storageKey` pins the PHYSICAL localStorage entry: every read/write lands on that
+ * one name, whatever logical key the shell passes — the way to choose where the state
+ * lives without touching the `persist` option (one shell instance per adapter then;
+ * two shells sharing a pinned adapter would overwrite each other). Omitted, the
+ * shell's own key is used as-is (the historical behavior).
+ */
+declare function localStorageAdapter(storageKey?: string): WidgetStorage;
+interface PersistedState {
+    symbol?: string;
+    timeframe?: string;
+    priceStyle?: string;
+    timezone?: string;
+    bars?: string;
+    watermark?: string;
+    /** Comma-joined favorite drawing-tool types. */
+    favorites?: string;
+}
+/** Parse a LEGACY prefs payload (never throws — junk yields `{}`). */
+declare function parsePersisted(raw: string | null): PersistedState;
+/** Load the persisted state — synchronous result for sync storages, else a promise. */
+declare function loadPersisted(storage: WidgetStorage, storageKey: string): PersistedState | Promise<PersistedState>;
+/** Save (fire-and-forget — async adapter failures are the adapter's concern). */
+declare function savePersisted(storage: WidgetStorage, storageKey: string, state: PersistedState): void;
+/**
+ * LEGACY migration — convert the widget's pre-unified three-key layout (prefs under
+ * the main key, renderer config under `<key>:config`, drawings under `<key>:drawings`)
+ * into ONE unified state document (the same format the workspace persists, with a
+ * single `c1` cell). Null when the payload holds no usable state. Pure — the caller
+ * reads the keys, then rewrites the main key and drops the legacy sub-keys.
+ */
+declare function legacyWidgetState(prefs: PersistedState, rawConfig: string | null, rawDrawings: string | null): WorkspaceState | null;
+
+/** What a shell (widget or workspace) accepts BEYOND the chart options themselves. */
+interface VelaShellOptions {
+    /** Provider factories, keyed by provider name. The shell owns the call cycle: the
+     *  widget re-instantiates on each chart rebuild; the workspace instantiates once
+     *  onto its single shared feed. */
+    providers?: Record<string, () => DataProvider>;
+    /** Scripting-engine factories, keyed by language — ONE instance per chart (the
+     *  widget's chart, each workspace cell), so a worker engine gets its own thread and
+     *  dies with its chart. Return a shared instance from the factory to opt into one
+     *  engine for everything. Merged OVER the app-level `registerDefaultEngine`
+     *  registry — an instance factory wins for its language. */
+    engines?: Record<string, () => ScriptingEngine>;
+    /** Indicator manifest: inline, a URL returning it, or an ASYNC LOADER function
+     *  (`() => Promise<manifest>` — filesystem reads, authenticated APIs, dynamic
+     *  imports). Resolved ONCE; entries with `enabled: true` auto-add to every FRESH
+     *  chart (restored cells re-add their own recorded set instead). */
+    indicators?: string | IndicatorManifest | IndicatorLoader;
+    /** Topbar timeframe presets (chart timeframe values). */
+    timeframes?: string[];
+    /** Display timezone (IANA; default 'Etc/UTC') — one zone for the whole shell. */
+    timezone?: string;
+    /** Chrome toggles (all default true). */
+    statusline?: boolean;
+    watermark?: boolean;
+    bottombar?: boolean;
+    /** Focus the chart when the shell mounts so keyboard shortcuts work from the first
+     *  keystroke — no initial click needed. Default false: an embedded shell must never
+     *  steal the page's focus from the host's own controls. */
+    autofocus?: boolean;
+    /** Bring the shell back AS YOU LEFT IT: persist the full state document
+     *  (`getState()`) and restore it at construction. `true` uses the shell's default
+     *  key ('vela-widget' / 'vela-workspace'); a string is the storage key. */
+    persist?: boolean | string;
+    /** Storage backend for `persist` — defaults to localStorage in BOTH shells. Inject
+     *  any {@link VelaStorage} (sync or async) for custom backends (REST, IndexedDB, …)
+     *  or the exported in-memory adapter for session-lived state. */
+    storage?: VelaStorage;
+}
+
+interface HistoryAction {
+    undo(): void;
+    redo(): void;
+}
+declare class WidgetHistory {
+    private readonly getChart;
+    private readonly undoStack;
+    private readonly redoStack;
+    private readonly listeners;
+    private unsubs;
+    private muted;
+    /** `getChart` late-resolves the CURRENT chart: drawing steps recorded before a chart
+     *  rebuild must undo on the chart that exists when the user presses Ctrl+Z, not on a
+     *  destroyed instance captured at record time. */
+    constructor(getChart?: () => Vela | null);
+    /** Record a reversible action (a fresh edit forks history: redo branch clears). */
+    push(action: HistoryAction): void;
+    undo(): void;
+    redo(): void;
+    /** Run `fn` without recording — for programmatic state application (setState,
+     *  ledger restore), whose indicator/drawing events are not user edits. */
+    silently(fn: () => void): void;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    onChange(cb: () => void): () => void;
+    /** (Re)bind to a chart: drawing edits enter the unified stack as delegate steps. */
+    onChart(chart: Vela): void;
+    destroy(): void;
+    private pushDrawingStep;
+    /** Replaying an action must not re-record the drawing events it triggers. */
+    private mutedRun;
+    private notify;
+}
+
+export { Bottombar as B, type CellState as C, type IndicatorLoader as I, type PanelsState as P, type ResolvedIndicator as R, type SyncSetting as S, type TrackSizes as T, type VelaStorage as V, WidgetHistory as W, type RangePreset as a, type VelaShellOptions as b, type SyncOptions as c, type SyncKind as d, type WorkspaceState as e, type ChartState as f, decodeState as g, encodeState as h, type PersistedState as i, type BottombarOptions as j, type IndicatorManifest as k, type IndicatorManifestEntry as l, RANGE_PRESETS as m, type WidgetStorage as n, legacyWidgetState as o, loadPersisted as p, localStorageAdapter as q, parsePersisted as r, sanitizeState as s, resolveIndicators as t, savePersisted as u };

package/dist/history-LJkz4-sS.d.cts

@@ -0,0 +1,298 @@
+import { V as VisibleRangePreset } from './options-Q-576hIi.cjs';
+import { D as DataProvider } from './DataProvider-DKNDHpNv.cjs';
+import { S as ScriptingEngine, V as Vela } from './contributions-o1GRKPI_.cjs';
+
+interface RangePreset {
+    /** Button label. */
+    id: string;
+    /** Timeframe to switch to for this range. */
+    tf: string;
+    /** The core visible-range preset framed once the chart is ready. */
+    preset: VisibleRangePreset;
+    /**
+     * Bars the window needs AT `tf` — the fetch budget for the rebuild. Without it the
+     * chart loads its default depth and the framed window is clipped to whatever
+     * history happens to be loaded (a "1D" that only shows 16 hours). Includes a small
+     * margin; `ALL` asks for as much history as the provider will serve.
+     */
+    bars: number;
+}
+/**
+ * Range chips — each pairs a timeframe, a visible window, and the fetch depth that
+ * window needs. Resolutions follow the reference: the shorter the range, the finer the
+ * bars (1 day of 1-minute bars … 5 years of weekly bars).
+ */
+declare const RANGE_PRESETS: readonly RangePreset[];
+interface BottombarOptions {
+    timezone: string;
+    onRange: (preset: RangePreset) => void;
+    onTimezone: (zone: string) => void;
+    onSettingsClick?: () => void;
+}
+declare class Bottombar {
+    readonly el: HTMLElement;
+    private readonly clockEl;
+    private readonly tzLabelEl;
+    private readonly tzButton;
+    private readonly tzMenu;
+    private readonly settingsTip;
+    private readonly rangeButtons;
+    private timezone;
+    private timer;
+    constructor(host: HTMLElement, opts: BottombarOptions);
+    setTimezone(zone: string): void;
+    /** Highlight (or clear with null) the active range chip — cleared on manual tf changes. */
+    setActiveRange(id: string | null): void;
+    destroy(): void;
+    private tzItems;
+    private tick;
+}
+
+interface IndicatorManifestEntry {
+    name: string;
+    /** Inline script source (one of script/url required). */
+    script?: string;
+    /** Fetch the source from here instead (resolved relative to the manifest URL). */
+    url?: string;
+    /** Engine language (default: the chart's default engine). */
+    language?: string;
+    /** Add to the chart at startup (default true). Disabled entries only appear in pickers. */
+    enabled?: boolean;
+    /** Picker grouping (default 'Indicators'). */
+    category?: string;
+}
+type IndicatorManifest = IndicatorManifestEntry[] | {
+    indicators: IndicatorManifestEntry[];
+};
+/** A manifest entry with its source resolved and ready for `chart.addIndicator`. */
+interface ResolvedIndicator {
+    name: string;
+    script: string;
+    language?: string;
+    enabled: boolean;
+    category?: string;
+}
+/** An async manifest source — called once at resolution time. The escape hatch for
+ *  manifests that a URL can't express: a filesystem read, an authenticated API, a
+ *  bundler dynamic import. A rejection behaves like a failing manifest URL. */
+type IndicatorLoader = () => Promise<IndicatorManifest>;
+/** Load the indicator list: a manifest object, a URL string returning the manifest JSON,
+ *  or an async loader function returning the manifest. Entries with `url` sources are
+ *  fetched here too (relative to the manifest URL when there is one). Entries that fail
+ *  to resolve are dropped with a console warning — one broken script must not take the
+ *  chart down. */
+declare function resolveIndicators(config: string | IndicatorManifest | IndicatorLoader, fetchImpl?: typeof fetch): Promise<ResolvedIndicator[]>;
+
+/** The linkable dimensions. `crosshair` mirrors the pointer time onto same-group
+ *  cells as GHOST crosshairs (renderers without the optional `setExternalCrosshair`
+ *  seam simply never display one). */
+type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair';
+/**
+ * One link's configuration: `false`/absent = off; `true` = ALL cells linked (one
+ * implicit group); a record maps cell id → group name, and only cells sharing a group
+ * follow each other (a cell absent from the record is unlinked).
+ */
+type SyncSetting = boolean | Readonly<Record<string, string>>;
+interface SyncOptions {
+    viewport?: SyncSetting;
+    symbol?: SyncSetting;
+    timeframe?: SyncSetting;
+    crosshair?: SyncSetting;
+}
+/** Splitter track weights along each grid axis. */
+interface TrackSizes {
+    cols?: number[];
+    rows?: number[];
+}
+/**
+ * The docked side panels — a SHELL-level pref (one dock serves every cell of a workspace).
+ * `open` is the single panel showing (the dock is exclusive); `widths` holds only the columns
+ * the user actually resized, by panel id, so a panel's declared width stays in charge until
+ * then. Absent altogether in documents written before the dock existed.
+ */
+interface PanelsState {
+    open?: string;
+    widths?: Record<string, number>;
+}
+/** Per-chart (per-cell) state: the market, the display prefs, the content documents,
+ *  and the indicator ledger. The widget's whole chart state is ONE of these. */
+interface CellState {
+    symbol?: string;
+    /** The symbol's venue. Mirrors the symbol's own `EXCHANGE:` prefix on new saves;
+     *  pre-prefix documents stored it beside a BARE symbol — {@link prefixedSymbol}
+     *  welds the two back into the one canonical form at restore time. */
+    provider?: string;
+    timeframe?: string;
+    priceStyle?: string;
+    bars?: number;
+    /** Symbol watermark visibility — a per-chart display pref. */
+    watermark?: boolean;
+    /** Indicator titles (the in-chart legend rows) visibility — a per-chart display pref. */
+    indicatorTitles?: boolean;
+    /** The renderer's cosmetic config document (`renderer.getConfig()`). */
+    rendererConfig?: unknown;
+    /** The user-drawings document (`drawings.toJSON()`). */
+    drawings?: unknown;
+    /** The indicator ledger: manifest entries by name + present native types. */
+    indicators?: {
+        manifest: string[];
+        natives: string[];
+    };
+}
+/** One entry of the document's `charts` array: a chart's state plus its cell IDENTITY. */
+interface ChartState extends CellState {
+    /** The cell's durable identity — its declared name (`btc`), or `c<N>` for a slot no
+     *  entry declared. Unique within the document; array position restores slot order. */
+    id: string;
+}
+/** The versioned shell-state document — everything `applyState` restores. */
+interface WorkspaceState {
+    version: 1;
+    /** The layout id — always `'1'` for a widget. Restoring an id that is not
+     *  registered keeps the current layout — register custom layouts
+     *  (`registerLayout`) before applying a saved state. */
+    layout: string;
+    /** Splitter track weights, per layout id (workspace only). */
+    trackSizes?: Record<string, TrackSizes>;
+    activeCellId?: string;
+    /** Sync links (workspace only). */
+    sync?: SyncOptions;
+    /** Shared display timezone. */
+    timezone?: string;
+    /** Favorite drawing-tool types — a SHARED preference (one star set per shell). */
+    favorites?: string[];
+    /** The docked side panels: which one is open, and the widths the user dragged. */
+    panels?: PanelsState;
+    /** Per-chart state, one entry per SLOT (a single `c1` entry for the widget).
+     *  Ids are unique — the codec drops id-less entries and keeps the LAST duplicate. */
+    charts: ChartState[];
+}
+declare function encodeState(state: WorkspaceState): string;
+/** Parse + sanitize a persisted payload. Null on anything unusable (wrong version,
+ *  not JSON, not an object) — malformed FIELDS are dropped, never thrown on. */
+declare function decodeState(raw: string): WorkspaceState | null;
+/**
+ * Validate an untrusted state document field by field (the `applyState` gate). Unknown
+ * or malformed fields are dropped; nested renderer-config / drawings documents pass
+ * through OPAQUELY — their own consumers (`applyConfig`, `fromJSON`) validate them.
+ */
+declare function sanitizeState(doc: unknown): WorkspaceState | null;
+
+/** The storage contract BOTH shells persist through (the widget and the workspace —
+ *  one name, one shape). Methods may be synchronous or return promises. */
+interface VelaStorage {
+    get(key: string): string | null | Promise<string | null>;
+    set(key: string, value: string): void | Promise<void>;
+    remove?(key: string): void | Promise<void>;
+}
+/** @deprecated Use {@link VelaStorage} — same contract, shell-neutral name. */
+type WidgetStorage = VelaStorage;
+/**
+ * The default adapter — window.localStorage, silent on quota/privacy failures.
+ *
+ * `storageKey` pins the PHYSICAL localStorage entry: every read/write lands on that
+ * one name, whatever logical key the shell passes — the way to choose where the state
+ * lives without touching the `persist` option (one shell instance per adapter then;
+ * two shells sharing a pinned adapter would overwrite each other). Omitted, the
+ * shell's own key is used as-is (the historical behavior).
+ */
+declare function localStorageAdapter(storageKey?: string): WidgetStorage;
+interface PersistedState {
+    symbol?: string;
+    timeframe?: string;
+    priceStyle?: string;
+    timezone?: string;
+    bars?: string;
+    watermark?: string;
+    /** Comma-joined favorite drawing-tool types. */
+    favorites?: string;
+}
+/** Parse a LEGACY prefs payload (never throws — junk yields `{}`). */
+declare function parsePersisted(raw: string | null): PersistedState;
+/** Load the persisted state — synchronous result for sync storages, else a promise. */
+declare function loadPersisted(storage: WidgetStorage, storageKey: string): PersistedState | Promise<PersistedState>;
+/** Save (fire-and-forget — async adapter failures are the adapter's concern). */
+declare function savePersisted(storage: WidgetStorage, storageKey: string, state: PersistedState): void;
+/**
+ * LEGACY migration — convert the widget's pre-unified three-key layout (prefs under
+ * the main key, renderer config under `<key>:config`, drawings under `<key>:drawings`)
+ * into ONE unified state document (the same format the workspace persists, with a
+ * single `c1` cell). Null when the payload holds no usable state. Pure — the caller
+ * reads the keys, then rewrites the main key and drops the legacy sub-keys.
+ */
+declare function legacyWidgetState(prefs: PersistedState, rawConfig: string | null, rawDrawings: string | null): WorkspaceState | null;
+
+/** What a shell (widget or workspace) accepts BEYOND the chart options themselves. */
+interface VelaShellOptions {
+    /** Provider factories, keyed by provider name. The shell owns the call cycle: the
+     *  widget re-instantiates on each chart rebuild; the workspace instantiates once
+     *  onto its single shared feed. */
+    providers?: Record<string, () => DataProvider>;
+    /** Scripting-engine factories, keyed by language — ONE instance per chart (the
+     *  widget's chart, each workspace cell), so a worker engine gets its own thread and
+     *  dies with its chart. Return a shared instance from the factory to opt into one
+     *  engine for everything. Merged OVER the app-level `registerDefaultEngine`
+     *  registry — an instance factory wins for its language. */
+    engines?: Record<string, () => ScriptingEngine>;
+    /** Indicator manifest: inline, a URL returning it, or an ASYNC LOADER function
+     *  (`() => Promise<manifest>` — filesystem reads, authenticated APIs, dynamic
+     *  imports). Resolved ONCE; entries with `enabled: true` auto-add to every FRESH
+     *  chart (restored cells re-add their own recorded set instead). */
+    indicators?: string | IndicatorManifest | IndicatorLoader;
+    /** Topbar timeframe presets (chart timeframe values). */
+    timeframes?: string[];
+    /** Display timezone (IANA; default 'Etc/UTC') — one zone for the whole shell. */
+    timezone?: string;
+    /** Chrome toggles (all default true). */
+    statusline?: boolean;
+    watermark?: boolean;
+    bottombar?: boolean;
+    /** Focus the chart when the shell mounts so keyboard shortcuts work from the first
+     *  keystroke — no initial click needed. Default false: an embedded shell must never
+     *  steal the page's focus from the host's own controls. */
+    autofocus?: boolean;
+    /** Bring the shell back AS YOU LEFT IT: persist the full state document
+     *  (`getState()`) and restore it at construction. `true` uses the shell's default
+     *  key ('vela-widget' / 'vela-workspace'); a string is the storage key. */
+    persist?: boolean | string;
+    /** Storage backend for `persist` — defaults to localStorage in BOTH shells. Inject
+     *  any {@link VelaStorage} (sync or async) for custom backends (REST, IndexedDB, …)
+     *  or the exported in-memory adapter for session-lived state. */
+    storage?: VelaStorage;
+}
+
+interface HistoryAction {
+    undo(): void;
+    redo(): void;
+}
+declare class WidgetHistory {
+    private readonly getChart;
+    private readonly undoStack;
+    private readonly redoStack;
+    private readonly listeners;
+    private unsubs;
+    private muted;
+    /** `getChart` late-resolves the CURRENT chart: drawing steps recorded before a chart
+     *  rebuild must undo on the chart that exists when the user presses Ctrl+Z, not on a
+     *  destroyed instance captured at record time. */
+    constructor(getChart?: () => Vela | null);
+    /** Record a reversible action (a fresh edit forks history: redo branch clears). */
+    push(action: HistoryAction): void;
+    undo(): void;
+    redo(): void;
+    /** Run `fn` without recording — for programmatic state application (setState,
+     *  ledger restore), whose indicator/drawing events are not user edits. */
+    silently(fn: () => void): void;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    onChange(cb: () => void): () => void;
+    /** (Re)bind to a chart: drawing edits enter the unified stack as delegate steps. */
+    onChart(chart: Vela): void;
+    destroy(): void;
+    private pushDrawingStep;
+    /** Replaying an action must not re-record the drawing events it triggers. */
+    private mutedRun;
+    private notify;
+}
+
+export { Bottombar as B, type CellState as C, type IndicatorLoader as I, type PanelsState as P, type ResolvedIndicator as R, type SyncSetting as S, type TrackSizes as T, type VelaStorage as V, WidgetHistory as W, type RangePreset as a, type VelaShellOptions as b, type SyncOptions as c, type SyncKind as d, type WorkspaceState as e, type ChartState as f, decodeState as g, encodeState as h, type PersistedState as i, type BottombarOptions as j, type IndicatorManifest as k, type IndicatorManifestEntry as l, RANGE_PRESETS as m, type WidgetStorage as n, legacyWidgetState as o, loadPersisted as p, localStorageAdapter as q, parsePersisted as r, sanitizeState as s, resolveIndicators as t, savePersisted as u };

package/dist/icons-BZYbJXSV.d.cts

@@ -0,0 +1,10 @@
+/** Register (or replace) an icon's raw `<svg>` markup under an id. */
+declare function registerIcon(id: string, svg: string): void;
+/** The raw `<svg>` markup for an id, or null. */
+declare function iconMarkup(id: string): string | null;
+/** Tier A: a 16×16 chrome icon. `extra` overrides root attributes (e.g. a filled variant). */
+declare function svg16(body: string, extra?: string): string;
+/** Tier B: a 24×24 drawing-tool icon. `extra` overrides root attributes. */
+declare function svg24(body: string, extra?: string): string;
+
+export { svg24 as a, iconMarkup as i, registerIcon as r, svg16 as s };

package/dist/icons-BZYbJXSV.d.ts

@@ -0,0 +1,10 @@
+/** Register (or replace) an icon's raw `<svg>` markup under an id. */
+declare function registerIcon(id: string, svg: string): void;
+/** The raw `<svg>` markup for an id, or null. */
+declare function iconMarkup(id: string): string | null;
+/** Tier A: a 16×16 chrome icon. `extra` overrides root attributes (e.g. a filled variant). */
+declare function svg16(body: string, extra?: string): string;
+/** Tier B: a 24×24 drawing-tool icon. `extra` overrides root attributes. */
+declare function svg24(body: string, extra?: string): string;
+
+export { svg24 as a, iconMarkup as i, registerIcon as r, svg16 as s };