@luxalgo/vela 0.5.0 → 0.5.1

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 } from './options-Q-576hIi.cjs';
-import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as RangePreset, T as TrackSizes, b as VelaShellOptions, c as SyncOptions, d as SyncKind, e as WorkspaceState } from './history-LJkz4-sS.cjs';
-export { f as ChartState, P as PanelsState, g as decodeState, h as encodeState, s as sanitizeState } from './history-LJkz4-sS.cjs';
+import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, c as VelaTheme, N as NativeBackend } from './options-DbQholFV.cjs';
+import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as RangePreset, T as TrackSizes, b as VelaShellOptions, c as SyncOptions, d as SyncKind, e as WorkspaceState } from './history-DX3Zne3a.cjs';
+export { f as ChartState, P as PanelsState, g as decodeState, h as encodeState, s as sanitizeState } from './history-DX3Zne3a.cjs';
 import { K as KeymapManager } from './keymap-CGOz5F5f.cjs';
-import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, a as ScriptRun } from './contributions-o1GRKPI_.cjs';
-import { M as MarketDataFeed } from './DataProvider-DKNDHpNv.cjs';
+import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, a as ScriptRun } from './contributions-BlV3kb0O.cjs';
+import { M as MarketDataFeed } from './DataProvider-BBQ3Hr21.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[];
@@ -279,6 +279,32 @@ declare function layoutDefinition(id: string): LayoutDefinition | undefined;
 declare function layouts(): LayoutDefinition[];
 /** Register the built-in presets (idempotent — called by the workspace entry point). */
 declare function registerBuiltinLayouts(): void;
+/** Picker canvas bound — dynamic layouts stay within a 4×4 grid (16 cells, the
+ *  workspace's dormant-state pool capacity). */
+declare const GRID_PICKER_MAX = 4;
+/**
+ * The layout for a UNIFORM rows×cols grid (Grid picker mode), clamped to the
+ * picker canvas. Geometry matching a registered classic preset returns that preset
+ * (id `'4'`, `'2h'`, …); anything else synthesizes a `g<rows>x<cols>` definition.
+ */
+declare function layoutForGrid(rows: number, cols: number): LayoutDefinition;
+/**
+ * Resolve a layout id to its definition, synthesizing the picker's dynamic ids
+ * (`g<rows>x<cols>`) when they are not registered — the boot path for persisted
+ * picks. Unknown ids stay undefined.
+ */
+declare function ensureLayout(id: string): LayoutDefinition | undefined;
+/** A layout's shape on the picker canvas. */
+type LayoutShape = {
+    rows: number;
+    cols: number;
+};
+/**
+ * The picker-canvas shape of a layout: `{rows, cols}` for uniform grids, `null`
+ * when the layout is not expressible on the canvas (bespoke plugin presets) —
+ * pickers list those as labeled rows instead.
+ */
+declare function layoutShape(def: LayoutDefinition): LayoutShape | null;
 /** Inline styles for the grid container + each cell — PURE (the workspace applies them). */
 declare function gridStyles(def: LayoutDefinition, trackSizes?: TrackSizes): {
     container: Record<string, string>;
@@ -317,8 +343,10 @@ interface VelaWorkspaceOptions extends Omit<VelaOptions, 'height'>, VelaShellOpt
     /** Sync links between cells: per kind, `true` = all cells, or a `{cellId: group}`
      *  record (only same-group cells follow each other). `crosshair` mirrors the
      *  pointer time as ghost crosshairs on the followers (also toggleable from the
-     *  layout dropdown). Default: everything off. Change at runtime via
-     *  `ws.sync.set(kind, setting)`. */
+     *  layout dropdown); `drawings` copies each newly created drawing onto the
+     *  followers and keeps the set linked — edits and removals follow (also
+     *  toggleable from the shared drawing toolbar). Default: everything off.
+     *  Change at runtime via `ws.sync.set(kind, setting)`. */
     sync?: SyncOptions;
     /** Above this many cells, EVERY cell uses the canvas2d backend (uniform look inside
      *  the browser's WebGL-context budget; glow is unavailable there). Default 8; an
@@ -408,6 +436,15 @@ declare class VelaWorkspace {
     /** Re-entrance guard around one propagation tick: followers' synchronous echoes
      *  (their setVisibleRange re-emits viewport:changed) must not re-propagate. */
     private syncBusy;
+    /** Same guard for the drawings link: the propagated mutations' own `drawing:*`
+     *  events fire synchronously inside the propagation loop and must not fan out again. */
+    private drawingSyncBusy;
+    /** LINKED drawings (the drawings sync): one map per synced set (cellId → that
+     *  cell's drawing id), reachable from every member under its `cellId\0drawingId`
+     *  key — any member finds its peers to push edits/removals onto. Survives a
+     *  toggle-off (propagation freezes while the setting is off; re-enabling resumes
+     *  edit/delete for these pairs). Cleared on reload / `applyState`. */
+    private readonly drawingLinks;
     private manifest;
     /** The shared manifest can no longer change instance sets — resolved, or no
      *  `indicators` option so nothing ever will. Gates the cells' ledger fallback. */
@@ -528,6 +565,27 @@ declare class VelaWorkspace {
      * interval is left alone, so cross-timeframe groups settle instead of oscillating.
      */
     private propagateViewport;
+    /**
+     * Copy a freshly created drawing onto the origin's same-group followers (fresh ids
+     * through `drawings.add` — anchors are time+price, so the copy lands at the same
+     * spot whatever the follower shows) and register the whole set as LINKED: edits
+     * and removals of any member follow while the link is on ({@link drawingLinks}).
+     * The busy guard stops the copies' own `drawing:created` events from fanning out.
+     */
+    private propagateDrawing;
+    /** Mirror an in-progress placement (its current ghost, `null` = placement ended)
+     *  onto the origin's same-group followers — the live half of the drawings link;
+     *  the created copy replaces the ghosts when the placement completes. One-way by
+     *  contract (an external ghost never re-emits drafts), so no busy guard needed. */
+    private propagateDraft;
+    /** Push a linked drawing's edited CONTENT (anchors, style, text, per-type props)
+     *  onto its same-group peers — any member propagates, not just the original. */
+    private propagateDrawingEdit;
+    /** Remove a linked drawing's peers with it. The removed member always leaves its
+     *  link group (whatever the setting); peers are only deleted while the link is on.
+     *  A propagated peer removal re-enters here under the busy guard and just cleans
+     *  its own link key. */
+    private propagateDrawingRemoval;
     /**
      * Push an origin cell's symbol/timeframe onto its same-group followers (fired from
      * `market:changed`). Convergence comes from IDEMPOTENCE, not the guard: a follower's
@@ -576,4 +634,4 @@ declare function resizeTracks(weights: readonly number[], index: number, deltaPx
  */
 declare function trackOffsets(weights: readonly number[], sizePx: number, gapPx: number): number[];
 
-export { type CellBoot, type CellChartDefaults, type CellNativeInfo, type CellSeed, CellState, ChartCell, type LayoutDefinition, type PooledCellState, SyncKind, SyncOptions, SyncSetting, TrackSizes, VelaWorkspace, type VelaWorkspaceOptions, type WorkspaceEventMap, type WorkspaceScriptRun, WorkspaceState, type WorkspaceStorage, type WorkspaceWidgetContext, activeAfterLayout, evenTracks, gridStyles, layoutDefinition, layouts, memoryStorageAdapter, rangesWithin, registerBuiltinLayouts, registerLayout, resizeTracks, syncTargets, trackOffsets, unregisterLayout };
+export { type CellBoot, type CellChartDefaults, type CellNativeInfo, type CellSeed, CellState, ChartCell, GRID_PICKER_MAX, type LayoutDefinition, type LayoutShape, type PooledCellState, SyncKind, SyncOptions, SyncSetting, TrackSizes, VelaWorkspace, type VelaWorkspaceOptions, type WorkspaceEventMap, type WorkspaceScriptRun, WorkspaceState, type WorkspaceStorage, type WorkspaceWidgetContext, activeAfterLayout, ensureLayout, evenTracks, gridStyles, layoutDefinition, layoutForGrid, layoutShape, layouts, memoryStorageAdapter, rangesWithin, registerBuiltinLayouts, registerLayout, resizeTracks, syncTargets, trackOffsets, unregisterLayout };

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 } from './options-Q-576hIi.js';
-import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as RangePreset, T as TrackSizes, b as VelaShellOptions, c as SyncOptions, d as SyncKind, e as WorkspaceState } from './history-Dzxz-MQj.js';
-export { f as ChartState, P as PanelsState, g as decodeState, h as encodeState, s as sanitizeState } from './history-Dzxz-MQj.js';
+import { O as OHLCV, V as VisibleRangePreset, a as VisibleRange, b as VelaOptions, c as VelaTheme, N as NativeBackend } from './options-DbQholFV.js';
+import { S as SyncSetting, V as VelaStorage, C as CellState, W as WidgetHistory, R as ResolvedIndicator, a as RangePreset, T as TrackSizes, b as VelaShellOptions, c as SyncOptions, d as SyncKind, e as WorkspaceState } from './history-BTd52YMA.js';
+export { f as ChartState, P as PanelsState, g as decodeState, h as encodeState, s as sanitizeState } from './history-BTd52YMA.js';
 import { K as KeymapManager } from './keymap-CGOz5F5f.js';
-import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, a as ScriptRun } from './contributions-hX3EUyjG.js';
-import { M as MarketDataFeed } from './DataProvider-Dzd-Erlk.js';
+import { I as IndicatorHandle, S as ScriptingEngine, W as WidgetContext, V as Vela, a as ScriptRun } from './contributions-6N0rbrPC.js';
+import { M as MarketDataFeed } from './DataProvider-DGesjOJT.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[];
@@ -279,6 +279,32 @@ declare function layoutDefinition(id: string): LayoutDefinition | undefined;
 declare function layouts(): LayoutDefinition[];
 /** Register the built-in presets (idempotent — called by the workspace entry point). */
 declare function registerBuiltinLayouts(): void;
+/** Picker canvas bound — dynamic layouts stay within a 4×4 grid (16 cells, the
+ *  workspace's dormant-state pool capacity). */
+declare const GRID_PICKER_MAX = 4;
+/**
+ * The layout for a UNIFORM rows×cols grid (Grid picker mode), clamped to the
+ * picker canvas. Geometry matching a registered classic preset returns that preset
+ * (id `'4'`, `'2h'`, …); anything else synthesizes a `g<rows>x<cols>` definition.
+ */
+declare function layoutForGrid(rows: number, cols: number): LayoutDefinition;
+/**
+ * Resolve a layout id to its definition, synthesizing the picker's dynamic ids
+ * (`g<rows>x<cols>`) when they are not registered — the boot path for persisted
+ * picks. Unknown ids stay undefined.
+ */
+declare function ensureLayout(id: string): LayoutDefinition | undefined;
+/** A layout's shape on the picker canvas. */
+type LayoutShape = {
+    rows: number;
+    cols: number;
+};
+/**
+ * The picker-canvas shape of a layout: `{rows, cols}` for uniform grids, `null`
+ * when the layout is not expressible on the canvas (bespoke plugin presets) —
+ * pickers list those as labeled rows instead.
+ */
+declare function layoutShape(def: LayoutDefinition): LayoutShape | null;
 /** Inline styles for the grid container + each cell — PURE (the workspace applies them). */
 declare function gridStyles(def: LayoutDefinition, trackSizes?: TrackSizes): {
     container: Record<string, string>;
@@ -317,8 +343,10 @@ interface VelaWorkspaceOptions extends Omit<VelaOptions, 'height'>, VelaShellOpt
     /** Sync links between cells: per kind, `true` = all cells, or a `{cellId: group}`
      *  record (only same-group cells follow each other). `crosshair` mirrors the
      *  pointer time as ghost crosshairs on the followers (also toggleable from the
-     *  layout dropdown). Default: everything off. Change at runtime via
-     *  `ws.sync.set(kind, setting)`. */
+     *  layout dropdown); `drawings` copies each newly created drawing onto the
+     *  followers and keeps the set linked — edits and removals follow (also
+     *  toggleable from the shared drawing toolbar). Default: everything off.
+     *  Change at runtime via `ws.sync.set(kind, setting)`. */
     sync?: SyncOptions;
     /** Above this many cells, EVERY cell uses the canvas2d backend (uniform look inside
      *  the browser's WebGL-context budget; glow is unavailable there). Default 8; an
@@ -408,6 +436,15 @@ declare class VelaWorkspace {
     /** Re-entrance guard around one propagation tick: followers' synchronous echoes
      *  (their setVisibleRange re-emits viewport:changed) must not re-propagate. */
     private syncBusy;
+    /** Same guard for the drawings link: the propagated mutations' own `drawing:*`
+     *  events fire synchronously inside the propagation loop and must not fan out again. */
+    private drawingSyncBusy;
+    /** LINKED drawings (the drawings sync): one map per synced set (cellId → that
+     *  cell's drawing id), reachable from every member under its `cellId\0drawingId`
+     *  key — any member finds its peers to push edits/removals onto. Survives a
+     *  toggle-off (propagation freezes while the setting is off; re-enabling resumes
+     *  edit/delete for these pairs). Cleared on reload / `applyState`. */
+    private readonly drawingLinks;
     private manifest;
     /** The shared manifest can no longer change instance sets — resolved, or no
      *  `indicators` option so nothing ever will. Gates the cells' ledger fallback. */
@@ -528,6 +565,27 @@ declare class VelaWorkspace {
      * interval is left alone, so cross-timeframe groups settle instead of oscillating.
      */
     private propagateViewport;
+    /**
+     * Copy a freshly created drawing onto the origin's same-group followers (fresh ids
+     * through `drawings.add` — anchors are time+price, so the copy lands at the same
+     * spot whatever the follower shows) and register the whole set as LINKED: edits
+     * and removals of any member follow while the link is on ({@link drawingLinks}).
+     * The busy guard stops the copies' own `drawing:created` events from fanning out.
+     */
+    private propagateDrawing;
+    /** Mirror an in-progress placement (its current ghost, `null` = placement ended)
+     *  onto the origin's same-group followers — the live half of the drawings link;
+     *  the created copy replaces the ghosts when the placement completes. One-way by
+     *  contract (an external ghost never re-emits drafts), so no busy guard needed. */
+    private propagateDraft;
+    /** Push a linked drawing's edited CONTENT (anchors, style, text, per-type props)
+     *  onto its same-group peers — any member propagates, not just the original. */
+    private propagateDrawingEdit;
+    /** Remove a linked drawing's peers with it. The removed member always leaves its
+     *  link group (whatever the setting); peers are only deleted while the link is on.
+     *  A propagated peer removal re-enters here under the busy guard and just cleans
+     *  its own link key. */
+    private propagateDrawingRemoval;
     /**
      * Push an origin cell's symbol/timeframe onto its same-group followers (fired from
      * `market:changed`). Convergence comes from IDEMPOTENCE, not the guard: a follower's
@@ -576,4 +634,4 @@ declare function resizeTracks(weights: readonly number[], index: number, deltaPx
  */
 declare function trackOffsets(weights: readonly number[], sizePx: number, gapPx: number): number[];
 
-export { type CellBoot, type CellChartDefaults, type CellNativeInfo, type CellSeed, CellState, ChartCell, type LayoutDefinition, type PooledCellState, SyncKind, SyncOptions, SyncSetting, TrackSizes, VelaWorkspace, type VelaWorkspaceOptions, type WorkspaceEventMap, type WorkspaceScriptRun, WorkspaceState, type WorkspaceStorage, type WorkspaceWidgetContext, activeAfterLayout, evenTracks, gridStyles, layoutDefinition, layouts, memoryStorageAdapter, rangesWithin, registerBuiltinLayouts, registerLayout, resizeTracks, syncTargets, trackOffsets, unregisterLayout };
+export { type CellBoot, type CellChartDefaults, type CellNativeInfo, type CellSeed, CellState, ChartCell, GRID_PICKER_MAX, type LayoutDefinition, type LayoutShape, type PooledCellState, SyncKind, SyncOptions, SyncSetting, TrackSizes, VelaWorkspace, type VelaWorkspaceOptions, type WorkspaceEventMap, type WorkspaceScriptRun, WorkspaceState, type WorkspaceStorage, type WorkspaceWidgetContext, activeAfterLayout, ensureLayout, evenTracks, gridStyles, layoutDefinition, layoutForGrid, layoutShape, layouts, memoryStorageAdapter, rangesWithin, registerBuiltinLayouts, registerLayout, resizeTracks, syncTargets, trackOffsets, unregisterLayout };