@luxalgo/vela 0.7.0 → 0.7.2

package/dist/workspace.d.cts

@@ -1,9 +1,9 @@
-import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, I as InputValue, c as VelaTheme, N as NativeBackend, d as MarketSession } from './options-ex2_gtKp.cjs';
-import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as StatuslinePart, b as RangePreset, T as TrackSizes, c as VelaShellOptions, d as SyncOptions, e as SyncKind, f as WorkspaceState } from './statusline-model-cRhPBLPO.cjs';
-export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-model-cRhPBLPO.cjs';
+import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, I as InputValue, c as VelaTheme, N as NativeBackend, d as MarketSession } from './options-C7b_Qssu.cjs';
+import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as StatuslinePart, b as RangePreset, T as TrackSizes, c as VelaShellOptions, d as SyncOptions, e as SyncKind, f as WorkspaceState } from './statusline-model-DUKt7_TQ.cjs';
+export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-model-DUKt7_TQ.cjs';
 import { K as KeymapManager } from './keymap-CGOz5F5f.cjs';
-import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, E as ExternalIndicatorEntry, a as ScriptRun } from './contributions-Cv2Mutvn.cjs';
-import { M as MarketDataFeed } from './DataProvider-Ck2qyS_9.cjs';
+import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, E as ExternalIndicatorEntry, a as ScriptRun } from './contributions-CcBFe-91.cjs';
+import { M as MarketDataFeed } from './DataProvider-D5uMiJYz.cjs';
 
 /** The cells that follow `originId` under `setting` — PURE (never includes the origin). */
 declare function syncTargets(originId: string, setting: SyncSetting | undefined, cellIds: readonly string[]): string[];
@@ -285,7 +285,8 @@ declare class ChartCell {
      *  the workspace flips this with the layout (see Statusline.setFitMode). */
     setStatuslineFit(on: boolean): void;
     /** The workspace shell keeps the app theme; the cell host's tokens re-derive from
-     *  the LIVE plot surface (see {@link applyPlotOverlayTokens}). */
+     *  the LIVE plot surface for overlay ink (statusline, watermark). Menus portal to
+     *  `.vela-ui` and keep the app-theme surface (see {@link applyPlotOverlayTokens}). */
     private syncPlotOverlayTokens;
     /**
      * Frame a bottombar range chip: switch to its timeframe, fetch the depth its window
@@ -655,6 +656,17 @@ declare class VelaWorkspace {
     private readonly persistKey;
     private readonly storage;
     private stateTimer;
+    /** Re-entrance guard for {@link flushPendingState}: a `state:changed` subscriber that
+     *  calls back into the workspace (`destroy()` on save is the obvious one) must not
+     *  re-enter the flush and recurse. */
+    private emitting;
+    /** False until the constructor finishes. Boot is not an edit: seeding the sync
+     *  settings marks state dirty, so without this a workspace mounted and torn down
+     *  inside the debounce window would flush and tell the host the user had changed
+     *  something — a save of the default document over whatever was stored. */
+    private booted;
+    /** A page unload gets the same flush as a teardown — the pending edit reaches the
+     *  host, the timer is cleared, and a `destroy()` that follows adds no second write. */
     private readonly onUnload;
     /** Re-entrance guard around one propagation tick: followers' synchronous echoes
      *  (their setVisibleRange re-emits viewport:changed) must not re-propagate. */
@@ -834,6 +846,27 @@ declare class VelaWorkspace {
     /** Debounced dirty mark: one `state:changed` (+ one storage write in persist mode)
      *  per burst of edits, flushed hard on unload/destroy. */
     private markStateDirty;
+    /**
+     * Push a pending debounced change out NOW, for a teardown or a page unload — the
+     * two moments the 500ms timer would otherwise never reach.
+     *
+     * Dropping it was a silent data loss: the timer carries BOTH halves of the dirty
+     * signal — the `state:changed` event and the storage write — so a host that saves
+     * from that event (a server-backed host, where `persistNow` is a no-op for want of
+     * a `persistKey`) simply never heard about the user's last edit.
+     *
+     * Idempotent and re-entrancy safe, which the ordering here buys:
+     *  - a no-op unless a timer is actually pending, so a teardown with nothing
+     *    outstanding stays silent and never invents an edit;
+     *  - the timer is cleared FIRST, so nothing survives this call and a second call
+     *    does nothing — `destroy()` after an unload flush adds no second write;
+     *  - the state is snapshotted BEFORE the handlers run, and that snapshot is what
+     *    gets persisted, so storage and the host are told the same thing even if a
+     *    handler mutates state while it runs;
+     *  - `emitting` is held across the emit, so a handler calling back in (a host that
+     *    tears down on save is the obvious one) cannot re-enter this and recurse.
+     */
+    private flushPendingState;
     /** Write the current state through the storage adapter now (fire-and-forget). */
     private persistNow;
     private resolveLayout;

package/dist/workspace.d.ts

@@ -1,9 +1,9 @@
-import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, I as InputValue, c as VelaTheme, N as NativeBackend, d as MarketSession } from './options-ex2_gtKp.js';
-import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as StatuslinePart, b as RangePreset, T as TrackSizes, c as VelaShellOptions, d as SyncOptions, e as SyncKind, f as WorkspaceState } from './statusline-model-BXoU4Kua.js';
-export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-model-BXoU4Kua.js';
+import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, I as InputValue, c as VelaTheme, N as NativeBackend, d as MarketSession } from './options-C7b_Qssu.js';
+import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as StatuslinePart, b as RangePreset, T as TrackSizes, c as VelaShellOptions, d as SyncOptions, e as SyncKind, f as WorkspaceState } from './statusline-model-D8NL7o4L.js';
+export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-model-D8NL7o4L.js';
 import { K as KeymapManager } from './keymap-CGOz5F5f.js';
-import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, E as ExternalIndicatorEntry, a as ScriptRun } from './contributions-BjQ7hyIx.js';
-import { M as MarketDataFeed } from './DataProvider-Bu9E5Zh5.js';
+import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, E as ExternalIndicatorEntry, a as ScriptRun } from './contributions-BbhbZd3c.js';
+import { M as MarketDataFeed } from './DataProvider-BALR0qPq.js';
 
 /** The cells that follow `originId` under `setting` — PURE (never includes the origin). */
 declare function syncTargets(originId: string, setting: SyncSetting | undefined, cellIds: readonly string[]): string[];
@@ -285,7 +285,8 @@ declare class ChartCell {
      *  the workspace flips this with the layout (see Statusline.setFitMode). */
     setStatuslineFit(on: boolean): void;
     /** The workspace shell keeps the app theme; the cell host's tokens re-derive from
-     *  the LIVE plot surface (see {@link applyPlotOverlayTokens}). */
+     *  the LIVE plot surface for overlay ink (statusline, watermark). Menus portal to
+     *  `.vela-ui` and keep the app-theme surface (see {@link applyPlotOverlayTokens}). */
     private syncPlotOverlayTokens;
     /**
      * Frame a bottombar range chip: switch to its timeframe, fetch the depth its window
@@ -655,6 +656,17 @@ declare class VelaWorkspace {
     private readonly persistKey;
     private readonly storage;
     private stateTimer;
+    /** Re-entrance guard for {@link flushPendingState}: a `state:changed` subscriber that
+     *  calls back into the workspace (`destroy()` on save is the obvious one) must not
+     *  re-enter the flush and recurse. */
+    private emitting;
+    /** False until the constructor finishes. Boot is not an edit: seeding the sync
+     *  settings marks state dirty, so without this a workspace mounted and torn down
+     *  inside the debounce window would flush and tell the host the user had changed
+     *  something — a save of the default document over whatever was stored. */
+    private booted;
+    /** A page unload gets the same flush as a teardown — the pending edit reaches the
+     *  host, the timer is cleared, and a `destroy()` that follows adds no second write. */
     private readonly onUnload;
     /** Re-entrance guard around one propagation tick: followers' synchronous echoes
      *  (their setVisibleRange re-emits viewport:changed) must not re-propagate. */
@@ -834,6 +846,27 @@ declare class VelaWorkspace {
     /** Debounced dirty mark: one `state:changed` (+ one storage write in persist mode)
      *  per burst of edits, flushed hard on unload/destroy. */
     private markStateDirty;
+    /**
+     * Push a pending debounced change out NOW, for a teardown or a page unload — the
+     * two moments the 500ms timer would otherwise never reach.
+     *
+     * Dropping it was a silent data loss: the timer carries BOTH halves of the dirty
+     * signal — the `state:changed` event and the storage write — so a host that saves
+     * from that event (a server-backed host, where `persistNow` is a no-op for want of
+     * a `persistKey`) simply never heard about the user's last edit.
+     *
+     * Idempotent and re-entrancy safe, which the ordering here buys:
+     *  - a no-op unless a timer is actually pending, so a teardown with nothing
+     *    outstanding stays silent and never invents an edit;
+     *  - the timer is cleared FIRST, so nothing survives this call and a second call
+     *    does nothing — `destroy()` after an unload flush adds no second write;
+     *  - the state is snapshotted BEFORE the handlers run, and that snapshot is what
+     *    gets persisted, so storage and the host are told the same thing even if a
+     *    handler mutates state while it runs;
+     *  - `emitting` is held across the emit, so a handler calling back in (a host that
+     *    tears down on save is the obvious one) cannot re-enter this and recurse.
+     */
+    private flushPendingState;
     /** Write the current state through the storage adapter now (fire-and-forget). */
     private persistNow;
     private resolveLayout;

package/dist/workspace.js

@@ -1,7 +1,7 @@
-export { ChartCell, GRID_PICKER_MAX, VelaWorkspace, activeAfterLayout, decodeState, encodeState, ensureLayout, evenTracks, gridStyles, layoutDefinition, layoutForGrid, layoutShape, layouts, memoryStorageAdapter, rangesWithin, registerBuiltinLayouts, registerLayout, resizeTracks, sanitizeState, syncTargets, trackOffsets, unregisterLayout } from './chunk-A347YL2P.js';
-import './chunk-A4G64KVF.js';
-import './chunk-IFJJPXSV.js';
-import './chunk-UHXG5J7C.js';
-import './chunk-CZRNTHD6.js';
+export { ChartCell, GRID_PICKER_MAX, VelaWorkspace, activeAfterLayout, decodeState, encodeState, ensureLayout, evenTracks, gridStyles, layoutDefinition, layoutForGrid, layoutShape, layouts, memoryStorageAdapter, rangesWithin, registerBuiltinLayouts, registerLayout, resizeTracks, sanitizeState, syncTargets, trackOffsets, unregisterLayout } from './chunk-QBWLINWL.js';
+import './chunk-PTNO3YK2.js';
+import './chunk-BFA32GOU.js';
+import './chunk-ZADTVRUO.js';
+import './chunk-BKHSQ4YM.js';
 import './chunk-CAFCLMPF.js';
 import './chunk-W4EJWLEO.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxalgo/vela",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Open-source charting library with a native high-performance renderer, drawing tools, pluggable chart types and pluggable scripting engines.",
   "license": "Apache-2.0",
   "homepage": "https://luxalgo.com/vela",