@luxalgo/vela 0.6.9 → 0.6.11

package/dist/workspace.d.cts

@@ -1,9 +1,9 @@
-import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, c as VelaTheme, N as NativeBackend, d as MarketSession } from './options-FM0peknS.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-DOPiT6I6.cjs';
-export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-DOPiT6I6.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-yp7sA96q.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-DTHZUFqK.cjs';
+export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-DTHZUFqK.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-C1U2Krwg.cjs';
-import { M as MarketDataFeed } from './DataProvider-8Z95Q-RJ.cjs';
+import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, E as ExternalIndicatorEntry, a as ScriptRun } from './contributions-CO01zWve.cjs';
+import { M as MarketDataFeed } from './DataProvider-p0TEyhlX.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[];
@@ -101,6 +101,19 @@ interface CellDeps {
     manifestSettled(): boolean;
     /** Report a pointer-down/focus in this cell (the workspace sets it active). */
     activate(id: string): void;
+    /** Whether the grid holds more than one cell — gates the cluster's maximize
+     *  button and its drag handle (a lone chart has neither use). */
+    multiCell(): boolean;
+    /** Is this cell the one the workspace currently maximizes over the grid? */
+    isMaximized(id: string): boolean;
+    /** Maximize this cell over the whole grid, or restore the grid when it already is. */
+    toggleMaximize(id: string): void;
+    /** Drag-handle hit-test: the OTHER live cell under a viewport point (never `id`). */
+    cellDragTarget(id: string, x: number, y: number): string | null;
+    /** Live drop-target highlight while a grip drag is underway (null clears). */
+    previewDropTarget(id: string | null): void;
+    /** Commit a grip drag: the two cells trade slots in the grid. */
+    dropCell(id: string, targetId: string): void;
     /** The cell's market changed in place (chrome/retention refresh upstream). */
     onMarketChanged(id: string): void;
     /** The cell's price style changed in place (topbar icon/menu refresh upstream). */
@@ -115,6 +128,17 @@ interface CellDeps {
     /** The shell's toast surface (unresolved-symbol notices land there). */
     toast(message: string, kind: 'info' | 'success' | 'error', durationMs?: number): void;
 }
+/** One live manifest/external instance and, when it deviates from declaration
+ *  defaults, the values it was restored with or dropped holding. */
+interface CellInstance {
+    entry: ResolvedIndicator;
+    handle: IndicatorHandle | null;
+    external?: boolean;
+    values?: {
+        inputs?: Record<string, InputValue>;
+        props?: Record<string, InputValue>;
+    };
+}
 declare class ChartCell {
     readonly id: string;
     private readonly deps;
@@ -127,11 +151,7 @@ declare class ChartCell {
      *  rather than the shell manifest — they share the undo/redo and picker plumbing
      *  but stay OUT of the persisted ledger (their names would never resolve against
      *  the manifest); persisting them is their plugin's job (`registerStatePersistence`). */
-    readonly instances: Array<{
-        entry: ResolvedIndicator;
-        handle: IndicatorHandle | null;
-        external?: boolean;
-    }>;
+    readonly instances: CellInstance[];
     /** The native-indicator catalog with this cell's live supported/present flags. */
     nativeCatalog: CellNativeInfo[];
     /** Last crosshair position in this cell (the alt+H/alt+V shortcuts anchor here). */
@@ -151,6 +171,8 @@ declare class ChartCell {
     /** Keeps the pre/post-market shading on the symbol's real calendar (see {@link SessionShadingTracker}). */
     private readonly sessionShading;
     private readonly watermark;
+    /** Bottom-center hover cluster, pinned to the price plot: drag handle, zoom in/out, maximize/restore, reset view. */
+    private readonly cellControls;
     private readonly contextMenu;
     private readonly offMarket;
     /** The cell's durable market state — the seed vocabulary plus the venue mirror the
@@ -266,6 +288,13 @@ declare class ChartCell {
      * needs, and keep it framed (re-asserted once the deeper history is painted).
      */
     applyRange(preset: RangePreset): void;
+    /** Reset this cell's view: re-enable auto scale and frame the full history —
+     *  the same action the chart context menu offers. */
+    resetView(): void;
+    /** Rebuild the view-controls cluster (the maximize gate or state changed). */
+    refreshControls(): void;
+    /** Mobile flips the per-cell cluster off (the shell's mobile bar replaces it). */
+    setControlsSuspended(on: boolean): void;
     /** Make this cell the active one and put keyboard focus on its chart surface. */
     focus(): void;
     /** Download this cell's chart as a PNG (named after its market). */
@@ -317,6 +346,8 @@ declare class ChartCell {
     addManifestInstance(entry: ResolvedIndicator, opts?: {
         record?: boolean;
         external?: boolean;
+        inputs?: Record<string, InputValue>;
+        props?: Record<string, InputValue>;
     }): void;
     private removeInstance;
     private dropInstance;
@@ -518,6 +549,10 @@ interface WorkspaceEventMap extends Record<string, unknown> {
     'layout:changed': {
         layout: string;
     };
+    /** A cell was maximized over the whole grid, or the grid restored (`id: null`). */
+    'cell:maximized': {
+        id: string | null;
+    };
     'cell:created': {
         id: string;
     };
@@ -547,6 +582,9 @@ declare class VelaWorkspace {
      *  slots beyond the list get auto identities. Grows, never reorders. */
     private order;
     private activeId;
+    /** The cell maximized over the whole grid (null = normal grid). TRANSIENT view
+     *  state — never persisted; any structural change (layout, applyState) restores. */
+    private maximizedId;
     private cellBackend;
     /** `layout: false` — the grid is pinned to the one-cell layout, the layout picker
      *  and sync switches never render, and `setLayout` no-ops. */
@@ -714,6 +752,32 @@ declare class VelaWorkspace {
      * the pool so the backend stays uniform.
      */
     setLayout(layout: string | LayoutDefinition): void;
+    /** The identity of the cell maximized over the whole grid, or null. */
+    get maximizedCell(): string | null;
+    /**
+     * Maximize one cell over the whole grid, or restore the layout with `null`. Pure
+     * presentation: the other cells stay alive underneath — charts, subscriptions and
+     * state untouched — so restoring is instant. The maximized cell becomes the active
+     * one. Transient view state (also reachable from each cell's bottom-center view
+     * cluster): switching layouts or applying a state document restores the grid.
+     */
+    maximizeCell(id: string | null): void;
+    /** The mobile bar's maximize stop: one press isolates the ACTIVE chart over the
+     *  grid; while something is already isolated — the chart, or a pane inside it
+     *  (mobile's double-tap) — the press restores that instead. Every branch re-syncs
+     *  the stop on its own (`maximizeCell` directly, `panes.maximize` via its
+     *  synchronous `pane:changed`). */
+    private toggleMobileMaximize;
+    /** Keep the mobile bar's maximize stop truthful: lit (inverse chip, restore
+     *  glyph) while the active chart covers the grid OR one of its panes is
+     *  maximized — the state a double-tap toggles is otherwise invisible on mobile. */
+    private syncMobileMaximize;
+    /**
+     * Trade the SLOTS of two live cells — the grid arrangement changes, the cells
+     * themselves (charts, indicators, drawings, the active flag) stay untouched.
+     * What each cell's drag handle commits; also callable directly by hosts.
+     */
+    swapCells(a: string, b: string): void;
     resize(): void;
     /** Show a toast over the grid — the same surface the shell's own notices use
      *  (alerts, script errors) and the one contributions reach via `ctx.toast`. */
@@ -738,6 +802,35 @@ declare class VelaWorkspace {
      *  Geometry is keyed by SLOT (`perCell[slot.id]`); the cell living there is
      *  `order[i]` — the identity/position decoupling in one line. */
     private applyGrid;
+    /** Overlay the maximize presentation on the freshly applied grid: EVERY cell spans
+     *  the full track grid — the maximized one on top, the siblings invisible beneath
+     *  it (their charts stay alive — restoring is instant). The siblings must span too:
+     *  left in their slots they would auto-flow into implicit zero-height rows, whose
+     *  gaps steal height from the maximized cell and collapse their renderers to 0.
+     *  The splitter strips and the active ring hide via the `data-maximized` rules. */
+    private applyMaximizePresentation;
+    /** Rebuild every cell's view cluster (the maximize gate or state changed). */
+    private refreshCellControls;
+    /** Drop the transient maximize on a structural change (layout switch, state
+     *  document) — WITH the event, so hosts tracking `cell:maximized` never drift
+     *  from `maximizedCell`. The caller's own grid re-apply paints the restore. */
+    private clearMaximized;
+    /** The live cell under a viewport point, excluding `excludeId` and any host a
+     *  maximize has hidden — the drag handle's hit-test. */
+    private cellAtPoint;
+    /** Mark one cell as the live drop target of a grip drag (null clears all) —
+     *  the `data-drop-target` stylesheet rule paints the dashed preview ring. */
+    private setDropTarget;
+    /** The cell whose bottom-left corner the grid's attribution mark floats in — the
+     *  maximized cell while one covers the grid, else the bottom-left slot's cell. */
+    private bottomLeftCell;
+    /** Keep the shared attribution mark inside the BOTTOM-LEFT visible cell: its
+     *  offsets ride that cell's renderer-published `--vela-bottom-gutter` /
+     *  `--vela-toolbar-gutter`, so collapsed pane strips push the mark up without any
+     *  bookkeeping here. Re-run after anything that changes which host that is
+     *  (layout switch, maximize, cell rebuild); a destroyed host drops the mark from
+     *  the DOM, and this re-mount brings it back. */
+    private mountAttributionMark;
     /** Create the cells the current layout wants but don't exist yet (pool-first).
      *  A slot's CELL IDENTITY is `order[i]` (declaration order — never the slot's own
      *  positional id); slots past the declared list mint an auto identity once. */

package/dist/workspace.d.ts

@@ -1,9 +1,9 @@
-import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, c as VelaTheme, N as NativeBackend, d as MarketSession } from './options-FM0peknS.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-zdF4eZLr.js';
-export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-zdF4eZLr.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-yp7sA96q.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-CHPDuKNp.js';
+export { g as ChartState, P as PanelsState, h as decodeState, i as encodeState, s as sanitizeState } from './statusline-CHPDuKNp.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-D7PVZO2i.js';
-import { M as MarketDataFeed } from './DataProvider-DExJrfut.js';
+import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, E as ExternalIndicatorEntry, a as ScriptRun } from './contributions-Bbe2R-mQ.js';
+import { M as MarketDataFeed } from './DataProvider-BBf-jc6W.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[];
@@ -101,6 +101,19 @@ interface CellDeps {
     manifestSettled(): boolean;
     /** Report a pointer-down/focus in this cell (the workspace sets it active). */
     activate(id: string): void;
+    /** Whether the grid holds more than one cell — gates the cluster's maximize
+     *  button and its drag handle (a lone chart has neither use). */
+    multiCell(): boolean;
+    /** Is this cell the one the workspace currently maximizes over the grid? */
+    isMaximized(id: string): boolean;
+    /** Maximize this cell over the whole grid, or restore the grid when it already is. */
+    toggleMaximize(id: string): void;
+    /** Drag-handle hit-test: the OTHER live cell under a viewport point (never `id`). */
+    cellDragTarget(id: string, x: number, y: number): string | null;
+    /** Live drop-target highlight while a grip drag is underway (null clears). */
+    previewDropTarget(id: string | null): void;
+    /** Commit a grip drag: the two cells trade slots in the grid. */
+    dropCell(id: string, targetId: string): void;
     /** The cell's market changed in place (chrome/retention refresh upstream). */
     onMarketChanged(id: string): void;
     /** The cell's price style changed in place (topbar icon/menu refresh upstream). */
@@ -115,6 +128,17 @@ interface CellDeps {
     /** The shell's toast surface (unresolved-symbol notices land there). */
     toast(message: string, kind: 'info' | 'success' | 'error', durationMs?: number): void;
 }
+/** One live manifest/external instance and, when it deviates from declaration
+ *  defaults, the values it was restored with or dropped holding. */
+interface CellInstance {
+    entry: ResolvedIndicator;
+    handle: IndicatorHandle | null;
+    external?: boolean;
+    values?: {
+        inputs?: Record<string, InputValue>;
+        props?: Record<string, InputValue>;
+    };
+}
 declare class ChartCell {
     readonly id: string;
     private readonly deps;
@@ -127,11 +151,7 @@ declare class ChartCell {
      *  rather than the shell manifest — they share the undo/redo and picker plumbing
      *  but stay OUT of the persisted ledger (their names would never resolve against
      *  the manifest); persisting them is their plugin's job (`registerStatePersistence`). */
-    readonly instances: Array<{
-        entry: ResolvedIndicator;
-        handle: IndicatorHandle | null;
-        external?: boolean;
-    }>;
+    readonly instances: CellInstance[];
     /** The native-indicator catalog with this cell's live supported/present flags. */
     nativeCatalog: CellNativeInfo[];
     /** Last crosshair position in this cell (the alt+H/alt+V shortcuts anchor here). */
@@ -151,6 +171,8 @@ declare class ChartCell {
     /** Keeps the pre/post-market shading on the symbol's real calendar (see {@link SessionShadingTracker}). */
     private readonly sessionShading;
     private readonly watermark;
+    /** Bottom-center hover cluster, pinned to the price plot: drag handle, zoom in/out, maximize/restore, reset view. */
+    private readonly cellControls;
     private readonly contextMenu;
     private readonly offMarket;
     /** The cell's durable market state — the seed vocabulary plus the venue mirror the
@@ -266,6 +288,13 @@ declare class ChartCell {
      * needs, and keep it framed (re-asserted once the deeper history is painted).
      */
     applyRange(preset: RangePreset): void;
+    /** Reset this cell's view: re-enable auto scale and frame the full history —
+     *  the same action the chart context menu offers. */
+    resetView(): void;
+    /** Rebuild the view-controls cluster (the maximize gate or state changed). */
+    refreshControls(): void;
+    /** Mobile flips the per-cell cluster off (the shell's mobile bar replaces it). */
+    setControlsSuspended(on: boolean): void;
     /** Make this cell the active one and put keyboard focus on its chart surface. */
     focus(): void;
     /** Download this cell's chart as a PNG (named after its market). */
@@ -317,6 +346,8 @@ declare class ChartCell {
     addManifestInstance(entry: ResolvedIndicator, opts?: {
         record?: boolean;
         external?: boolean;
+        inputs?: Record<string, InputValue>;
+        props?: Record<string, InputValue>;
     }): void;
     private removeInstance;
     private dropInstance;
@@ -518,6 +549,10 @@ interface WorkspaceEventMap extends Record<string, unknown> {
     'layout:changed': {
         layout: string;
     };
+    /** A cell was maximized over the whole grid, or the grid restored (`id: null`). */
+    'cell:maximized': {
+        id: string | null;
+    };
     'cell:created': {
         id: string;
     };
@@ -547,6 +582,9 @@ declare class VelaWorkspace {
      *  slots beyond the list get auto identities. Grows, never reorders. */
     private order;
     private activeId;
+    /** The cell maximized over the whole grid (null = normal grid). TRANSIENT view
+     *  state — never persisted; any structural change (layout, applyState) restores. */
+    private maximizedId;
     private cellBackend;
     /** `layout: false` — the grid is pinned to the one-cell layout, the layout picker
      *  and sync switches never render, and `setLayout` no-ops. */
@@ -714,6 +752,32 @@ declare class VelaWorkspace {
      * the pool so the backend stays uniform.
      */
     setLayout(layout: string | LayoutDefinition): void;
+    /** The identity of the cell maximized over the whole grid, or null. */
+    get maximizedCell(): string | null;
+    /**
+     * Maximize one cell over the whole grid, or restore the layout with `null`. Pure
+     * presentation: the other cells stay alive underneath — charts, subscriptions and
+     * state untouched — so restoring is instant. The maximized cell becomes the active
+     * one. Transient view state (also reachable from each cell's bottom-center view
+     * cluster): switching layouts or applying a state document restores the grid.
+     */
+    maximizeCell(id: string | null): void;
+    /** The mobile bar's maximize stop: one press isolates the ACTIVE chart over the
+     *  grid; while something is already isolated — the chart, or a pane inside it
+     *  (mobile's double-tap) — the press restores that instead. Every branch re-syncs
+     *  the stop on its own (`maximizeCell` directly, `panes.maximize` via its
+     *  synchronous `pane:changed`). */
+    private toggleMobileMaximize;
+    /** Keep the mobile bar's maximize stop truthful: lit (inverse chip, restore
+     *  glyph) while the active chart covers the grid OR one of its panes is
+     *  maximized — the state a double-tap toggles is otherwise invisible on mobile. */
+    private syncMobileMaximize;
+    /**
+     * Trade the SLOTS of two live cells — the grid arrangement changes, the cells
+     * themselves (charts, indicators, drawings, the active flag) stay untouched.
+     * What each cell's drag handle commits; also callable directly by hosts.
+     */
+    swapCells(a: string, b: string): void;
     resize(): void;
     /** Show a toast over the grid — the same surface the shell's own notices use
      *  (alerts, script errors) and the one contributions reach via `ctx.toast`. */
@@ -738,6 +802,35 @@ declare class VelaWorkspace {
      *  Geometry is keyed by SLOT (`perCell[slot.id]`); the cell living there is
      *  `order[i]` — the identity/position decoupling in one line. */
     private applyGrid;
+    /** Overlay the maximize presentation on the freshly applied grid: EVERY cell spans
+     *  the full track grid — the maximized one on top, the siblings invisible beneath
+     *  it (their charts stay alive — restoring is instant). The siblings must span too:
+     *  left in their slots they would auto-flow into implicit zero-height rows, whose
+     *  gaps steal height from the maximized cell and collapse their renderers to 0.
+     *  The splitter strips and the active ring hide via the `data-maximized` rules. */
+    private applyMaximizePresentation;
+    /** Rebuild every cell's view cluster (the maximize gate or state changed). */
+    private refreshCellControls;
+    /** Drop the transient maximize on a structural change (layout switch, state
+     *  document) — WITH the event, so hosts tracking `cell:maximized` never drift
+     *  from `maximizedCell`. The caller's own grid re-apply paints the restore. */
+    private clearMaximized;
+    /** The live cell under a viewport point, excluding `excludeId` and any host a
+     *  maximize has hidden — the drag handle's hit-test. */
+    private cellAtPoint;
+    /** Mark one cell as the live drop target of a grip drag (null clears all) —
+     *  the `data-drop-target` stylesheet rule paints the dashed preview ring. */
+    private setDropTarget;
+    /** The cell whose bottom-left corner the grid's attribution mark floats in — the
+     *  maximized cell while one covers the grid, else the bottom-left slot's cell. */
+    private bottomLeftCell;
+    /** Keep the shared attribution mark inside the BOTTOM-LEFT visible cell: its
+     *  offsets ride that cell's renderer-published `--vela-bottom-gutter` /
+     *  `--vela-toolbar-gutter`, so collapsed pane strips push the mark up without any
+     *  bookkeeping here. Re-run after anything that changes which host that is
+     *  (layout switch, maximize, cell rebuild); a destroyed host drops the mark from
+     *  the DOM, and this re-mount brings it back. */
+    private mountAttributionMark;
     /** Create the cells the current layout wants but don't exist yet (pool-first).
      *  A slot's CELL IDENTITY is `order[i]` (declaration order — never the slot's own
      *  positional id); slots past the declared list mint an auto identity once. */

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-STHSKXOR.js';
-import './chunk-6WDDVMBJ.js';
-import './chunk-EQCHJZOT.js';
-import './chunk-62SVGONC.js';
-import './chunk-FCVIG7JG.js';
-import './chunk-WFSZBX3R.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-IO3NYSQV.js';
+import './chunk-73PEA4MU.js';
+import './chunk-MTLJKZDZ.js';
+import './chunk-G77Y7LK2.js';
+import './chunk-MHY7MVXH.js';
+import './chunk-KG4YT3TI.js';
 import './chunk-W4EJWLEO.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxalgo/vela",
-  "version": "0.6.9",
+  "version": "0.6.11",
   "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",