openalgo-charts 2.4.6 → 2.4.7

package/README.md

@@ -4,12 +4,12 @@
 
 **A from-scratch, dependency-free HTML5-canvas charting engine for OpenAlgo.**
 
-Professional interactive charts, 105 built-in indicators plus your own custom ones, 85 drawing tools, order flow, market replay, linked chart grids, on-chart trading, vector SVG export and an optional WebGL2 backend. Nine lazy-loaded tiers, zero runtime dependencies, 91.55 kB Brotli for the base engine, and a one-call widget tier that adds the toolbar, drawing rail, dialogs and shortcuts.
+Professional interactive charts, 105 built-in indicators plus your own custom ones, 85 drawing tools, order flow, market replay, linked chart grids, on-chart trading, vector SVG export and an optional WebGL2 backend. Nine lazy-loaded tiers, zero runtime dependencies, 92.83 kB Brotli for the base engine, and a one-call widget tier that adds the toolbar, drawing rail, dialogs and shortcuts.
 
 [![npm version](https://img.shields.io/npm/v/openalgo-charts.svg?color=cb3837&label=npm)](https://www.npmjs.com/package/openalgo-charts)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
-[![bundle](https://img.shields.io/badge/brotli-91.55%20kB%20base%20%C2%B7%20245.21%20kB%20all%20tiers-brightgreen.svg)](#size-budget)
-[![tests](https://img.shields.io/badge/engine%20tests-5804%20passing-brightgreen.svg)](#develop)
+[![bundle](https://img.shields.io/badge/brotli-92.83%20kB%20base%20%C2%B7%20246.52%20kB%20all%20tiers-brightgreen.svg)](#size-budget)
+[![tests](https://img.shields.io/badge/engine%20tests-5841%20passing-brightgreen.svg)](#develop)
 [![dependencies](https://img.shields.io/badge/runtime%20deps-0-brightgreen.svg)](#principles)
 
 [**Documentation**](https://marketcalls.github.io/openalgo-charts/)  ·  [**Live examples**](https://marketcalls.github.io/openalgo-charts/examples)  ·  [**Getting started**](./docs/getting-started.md)  ·  [**Migrating to 2.0**](./docs/migrating-to-2.md)  ·  [**Architecture**](./ARCHITECTURE.md)
@@ -53,17 +53,16 @@ Every chart in the [live gallery](https://marketcalls.github.io/openalgo-charts/
 
 ## Install
 
-Current version: **2.4.6**.
+Current version: **2.4.7**.
 
-This release adds optional study source buttons, candle-anchored signal markers
-and configurable legend controls. It fixes missing markers at plot gaps, marker
-price scales and transparent legend readings. Existing studies keep plot anchoring
-by default; hosts opt in to price anchoring and supply their own source editor.
-See the [2.4.6 changelog](./CHANGELOG.md#246).
+Drag a price or study-threshold alert line to preview a new level, then release
+to save it once. Escape cancels the draft; range bounds stay ordered. Stored
+thresholds and live evaluation remain unchanged during preview. See the
+[2.4.7 changelog](./CHANGELOG.md#247) and the [live example](https://marketcalls.github.io/openalgo-charts/examples/#alert-threshold-dragging).
 
-To try these controls locally, run the [yfinance reference host](./examples/yfinance/README.md)
-and add **Source signal sample** from Indicators. Its source button opens the
-host-owned code, and Readout settings include **Legend button size** for each chart.
+To try dragging locally, run the [yfinance reference host](./examples/yfinance/README.md),
+create a price alert from the chart context menu, and drag its dashed line or
+**Alert** badge. Study and range alerts use the same controls.
 
 ```bash
 npm install openalgo-charts
@@ -92,7 +91,7 @@ in front of npm rather than being places you upload to. A chart is one HTML file
 ```html
 <div id="chart" style="width:100vw;height:100vh"></div>
 <script type="module">
-  import { createChart } from 'https://unpkg.com/openalgo-charts@2.4.6/dist/openalgo-charts.mjs';
+  import { createChart } from 'https://unpkg.com/openalgo-charts@2.4.7/dist/openalgo-charts.mjs';
   const chart = createChart(document.getElementById('chart'), { timezone: 'Asia/Kolkata' });
   chart.addSeries('candlestick').setData(bars);
 </script>
@@ -134,17 +133,17 @@ Import only what you use. Each tier is a separate bundle that registers into the
 
 | Import | Contents | Brotli |
 |---|---|---|
-| `openalgo-charts` | Engine, 13 chart types, panes &amp; scales, primitives, registries, chart state, chart linking, bar cache, interval registry, trading overlay, SVG export, render backend port, OpenAlgo feeds | 91.55 kB |
+| `openalgo-charts` | Engine, 13 chart types, panes &amp; scales, primitives, registries, chart state, chart linking, bar cache, interval registry, trading overlay, SVG export, render backend port, OpenAlgo feeds | 92.83 kB |
 | `openalgo-charts/indicators` | 105 built-in indicators, the `registerIndicator` contract for your own, and the Tier-2 (external-data) contract | 29.84 kB |
 | `openalgo-charts/draw` | 85 drawing tools + a headless drawing controller, clipboard, settings schema, level palette, freehand geometry and SVG icons | 35.43 kB |
 | `openalgo-charts/transform` | Heikin Ashi, Renko, Range bars, Line Break, Point &amp; Figure, Kagi, and symbol arithmetic (`AAPL/MSFT`) | 4.50 kB |
 | `openalgo-charts/profile` | Volume Profile, Market Profile (TPO) with compact pixel letters, Footprint, order flow | 14.96 kB |
 | `openalgo-charts/trade` | Order / position / bracket tools + DOM ladder | 8.01 kB |
 | `openalgo-charts/webgl` | WebGL2 series backend: batched, analytically anti-aliased GPU rendering of the standard chart types behind `renderer: 'auto'`, with a session-long fallback to the 2D path | 6.39 kB |
-| `openalgo-charts/widget` | The chart with its chrome in one call: `createWidget` adds a top bar, the drawing rail, a status line, the settings and indicator dialogs, drawing properties, a right-click menu, a keymap with a `?` panel and optional layout persistence. The only tier that ships DOM | 49.00 kB |
+| `openalgo-charts/widget` | The chart with its chrome in one call: `createWidget` adds a top bar, the drawing rail, a status line, the settings and indicator dialogs, drawing properties, a right-click menu, a keymap with a `?` panel and optional layout persistence. The only tier that ships DOM | 49.03 kB |
 | `openalgo-charts/workspace` | Validated workspace and indicator-template documents, named catalogs with revision checks, asynchronous storage and an IndexedDB adapter; no DOM | 5.52 kB |
 
-Everything together is **245.21 kB Brotli**; a widget terminal with built-in indicators (base + draw + indicators + widget) is 205.83 kB. Figures are measured from the 2.4.6 release build. The trade tier is 8.01 kB on its own; base + trade costs 99.56 kB. Sizes use decimal kB.
+Everything together is **246.52 kB Brotli**; a widget terminal with built-in indicators (base + draw + indicators + widget) is 207.13 kB. Figures are measured from the 2.4.7 release build. The trade tier is 8.01 kB on its own; base + trade costs 100.84 kB. Sizes use decimal kB.
 
 ## What's built
 
@@ -449,17 +448,17 @@ Enforced in CI by [`size-limit`](./.size-limit.json). Nothing is excluded, becau
 
 | Bundle | Limit | Actual |
 |---|---|---|
-| Base engine | 92 kB | 91.55 kB |
-| Base + trade | 100 kB | 99.56 kB |
+| Base engine | 93.5 kB | 92.83 kB |
+| Base + trade | 101.5 kB | 100.84 kB |
 | Indicators tier | 30 kB | 29.84 kB |
 | Draw tier | 36 kB | 35.43 kB |
 | Transform tier | 6 kB | 4.50 kB |
 | Profile tier | 15 kB | 14.96 kB |
 | WebGL2 tier | 7 kB | 6.39 kB |
-| Widget tier | 49.25 kB | 49.00 kB |
-| Widget terminal (base + draw + indicators + widget) | 206 kB | 205.83 kB |
+| Widget tier | 49.25 kB | 49.03 kB |
+| Widget terminal (base + draw + indicators + widget) | 207.75 kB | 207.13 kB |
 | Workspace tier | 6 kB | 5.52 kB |
-| **Everything** | 245.5 kB | 245.21 kB |
+| **Everything** | 247.25 kB | 246.52 kB |
 
 ## Documentation
 
@@ -504,7 +503,7 @@ See [Contributing](./CONTRIBUTING.md) for setup, targeted checks, documentation
 ```bash
 npm install        # install dev toolchain
 npm run typecheck  # strict TypeScript check
-npm test           # engine unit tests (Vitest): 5804 across 246 files
+npm test           # engine unit tests (Vitest): 5841 across 246 files
 npm run test:demo  # reference-host tests: 401 across 31 files
 npm run test:endurance # node endurance-harness tests: 7 cases
 npm run build      # Rollup -> dist/ (minified ESM per tier + types)
@@ -523,7 +522,7 @@ npm run verify     # lint + types + unit + endurance harness + build + demo + dt
 
 ## Status &amp; limitations
 
-Version **2.4.6**. All engine build phases are implemented. Upgrading a 1.9.x host: [Migrating to 2.0](./docs/migrating-to-2.md).
+Version **2.4.7**. All engine build phases are implemented. Upgrading a 1.9.x host: [Migrating to 2.0](./docs/migrating-to-2.md).
 
 Known gaps, stated plainly:
 

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { TradingCapabilitySource as TradingCapabilitySource$1 } from 'openalgo-charts';
 
 /** Library version string. Matches package.json (including locally prepared releases). */
-declare const VERSION = "2.4.6";
+declare const VERSION = "2.4.7";
 /** Returns the current library version. */
 declare function version(): string;
 
@@ -812,6 +812,8 @@ interface PrimitiveHit {
      * declares it here, and the drag callbacks receive time as well as price.
      */
     draggable?: boolean;
+    /** Opt into Escape cancellation without a release. Listen for `drag:cancel` to discard the preview. */
+    cancelOnEscape?: boolean;
 }
 /** Injected when a primitive is attached; lets it request a repaint. */
 interface PrimitiveHost {
@@ -4339,7 +4341,7 @@ interface PointerSample {
 }
 /**
  * What the engine reports about the physical pointer behind a gesture.
- * `crosshair:move`, `click`, `drag` and `drag:end` all carry these keys.
+ * `crosshair:move`, `click`, `drag:start`, `drag` and `drag:end` all carry these keys.
  */
 interface PointerInfo {
     modifiers: PointerModifiers;
@@ -4393,7 +4395,7 @@ interface ChartDragEvent extends PointerInfo {
      */
     samples: PointerSample[];
 }
-/** Payload of the `drag:end` event: the release that finished a primitive drag. */
+/** Payload of `drag:start` (press) and `drag:end` (release) for a primitive drag. */
 interface ChartDragEndEvent extends PointerInfo {
     id: string;
     price: number;
@@ -4634,6 +4636,7 @@ declare class Chart {
     /** Pressure at the press; a click reports this, since its release always reads 0. */
     private _downPressure;
     private _dragId;
+    private _dragCancelOnEscape;
     private _hoverId;
     /** Whether that primitive draws below the overlay, so leaving it must repaint the base. */
     private _hoverOnBase;
@@ -5506,6 +5509,7 @@ declare class Chart {
     private readonly _onDblClick;
     private _beginPinch;
     private _updatePinch;
+    private _cancelPrimitiveDrag;
     private readonly _onKeyDown;
     /** Scope gating: hover keeps keys chart-local; global always acts. */
     private _shortcutsActive;
@@ -9579,7 +9583,14 @@ declare class AlertController {
     private _replay;
     private _destroyed;
     private _revision;
+    private _drag;
     constructor(_chart: AlertChartHost, options?: AlertControllerOptions);
+    private _dragAvailability;
+    private _dragPrice;
+    private _startDrag;
+    private _cancelDrag;
+    /** Market evaluation keeps the committed source until a moved, owned gesture ends. */
+    private _onDrag;
     add(input: AlertInput): Alert;
     update(id: string, patch: AlertPatch): Alert | undefined;
     remove(id: string): boolean;