@tradecanvas/core 0.5.0 → 0.6.0

package/README.md

@@ -30,20 +30,36 @@ Multi-layer canvas rendering for optimal performance -- only dirty layers repain
 - `RenderLoop` -- requestAnimationFrame loop with dirty tracking
 - `DPRManager` -- device pixel ratio handling for crisp rendering
 
-### Chart Renderers (11 types)
+### Chart Renderers (12 types)
 
-`CandlestickRenderer`, `HollowCandleRenderer`, `BarRenderer`, `LineRenderer`, `AreaRenderer`, `BaselineRenderer`, `RenkoRenderer`, `KagiRenderer`, `PointAndFigureRenderer`, `VolumeRenderer`, `CompareRenderer`
+`CandlestickRenderer`, `HollowCandleRenderer`, `BarRenderer`, `LineRenderer`, `AreaRenderer`, `BaselineRenderer`, `RenkoRenderer`, `KagiRenderer`, `PointAndFigureRenderer`, `VolumeRenderer`, `CompareRenderer`. Range bars reuse `CandlestickRenderer` against transformed data.
 
-Data transforms: `toHeikinAshi`, `toRenko`, `toLineBreak`, `toKagi`, `toPointAndFigure`
+Data transforms: `toHeikinAshi`, `toRenko`, `toLineBreak`, `toKagi`, `toPointAndFigure`, `toRangeBars`
 
-### Indicators (26 built-in)
+### Indicators (33 built-in)
 
-**Overlay** (on price chart): SMA, EMA, Bollinger Bands, Keltner Channel, Donchian Channel, Ichimoku Cloud, Parabolic SAR, Supertrend, VWAP
+**Overlay** (on price chart): SMA, EMA, Hull MA, Bollinger Bands, Keltner Channel, Donchian Channel, Ichimoku Cloud, Parabolic SAR, Supertrend, VWAP, Anchored VWAP, Pivot Points (Classic), ZigZag, Linear Regression Channel
 
-**Panel** (separate sub-chart): RSI, MACD, Stochastic, ATR, ADX, CCI, CMF, MFI, OBV, ROC, TSI, Williams %R, Volume Profile, VROC, Standard Deviation, Accumulation/Distribution, Aroon
+**Panel** (separate sub-chart): RSI, MACD, Stochastic, ATR, ADX, CCI, CMF, MFI, OBV, ROC, TSI, Williams %R, Awesome Oscillator, Chaikin Oscillator, Volume Profile, VROC, Standard Deviation, Accumulation/Distribution, Aroon
+
+Indicator parameters are read through `getNumberParam` / `getIntParam` helpers, so invalid values (NaN, Infinity, missing keys, non-numeric strings) safely fall back to defaults instead of producing NaN-laced calculations.
 
 Extensible via `IndicatorBase` for custom indicators.
 
+### Web Worker offload
+
+`IndicatorWorkerHost` wraps a `Worker` and exposes a Promise-based `calculate()` so heavy charts can run indicator math off the main thread:
+
+```ts
+import { IndicatorWorkerHost } from '@tradecanvas/core'
+
+const worker = new Worker(new URL('./dist/indicator.worker.js', import.meta.url), { type: 'module' })
+const host = new IndicatorWorkerHost(worker)
+const output = await host.calculate('rsi', config, bars)
+```
+
+Pass `null` instead of a worker for synchronous fallback (SSR, tests). The shipped `indicator.worker.js` registers all 33 built-in indicators and supports `calculate` and `ping` requests.
+
 ### Drawing Tools (23)
 
 Trendline, Horizontal/Vertical Lines, Ray, Extended Line, Parallel Channel, Fibonacci Retracement/Extension, Rectangle, Ellipse, Triangle, Arrow, Pitchfork, Gann Fan/Box, Elliott Wave, Regression Channel, Date/Price Range, Measure, Anchored VWAP, Volume Profile Range, Text Annotation

package/dist/charts/transforms/index.d.ts

@@ -4,4 +4,6 @@ export type { RenkoConfig } from './renko.js';
 export { toLineBreak } from './lineBreak.js';
 export { toKagi } from './kagi.js';
 export { toPointAndFigure } from './pointAndFigure.js';
+export { toRangeBars } from './rangeBars.js';
+export type { RangeBarsConfig } from './rangeBars.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/charts/transforms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/charts/transforms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/charts/transforms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/charts/transforms/rangeBars.d.ts

@@ -0,0 +1,18 @@
+import { DataSeries } from '@tradecanvas/commons';
+export interface RangeBarsConfig {
+    /** Price distance per range bar. Each bar is closed when (high - low) >= rangeSize. */
+    rangeSize: number;
+}
+/**
+ * Transform OHLC data into fixed-range bars. Each bar's price range
+ * (high - low) is capped at `rangeSize`; a new bar starts as soon as the cap
+ * is met. Like Renko, range bars have no time axis — emitted timestamps are
+ * monotonically incremented to preserve ordering for the renderer.
+ *
+ * Approximation: input is OHLC, not tick-level. We replay each bar's
+ * extremes in the order implied by its candle direction (up bar:
+ * low→high→close; down bar: high→low→close) which is the standard
+ * approach for OHLC-derived range bars.
+ */
+export declare function toRangeBars(data: DataSeries, config: RangeBarsConfig): DataSeries;
+//# sourceMappingURL=rangeBars.d.ts.map

package/dist/charts/transforms/rangeBars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rangeBars.d.ts","sourceRoot":"","sources":["../../../src/charts/transforms/rangeBars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,UAAU,CA4CjF"}

package/dist/drawings/tools/TextAnnotation.d.ts

@@ -1,5 +1,10 @@
 import { DrawingState, Point, ViewportState } from '@tradecanvas/commons';
 import { DrawingBase } from '../DrawingBase.js';
+/**
+ * Pull annotation text from `style.text`, then `meta.text`, then a literal default.
+ * Pure helper — exported so it can be unit-tested without a canvas.
+ */
+export declare function resolveAnnotationText(state: DrawingState, fallback?: string): string;
 export declare class TextAnnotationTool extends DrawingBase {
     descriptor: {
         type: "text";

package/dist/drawings/tools/TextAnnotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextAnnotation.d.ts","sourceRoot":"","sources":["../../../src/drawings/tools/TextAnnotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,UAAU;;;;MAA+D;IAEzE,MAAM,CAAC,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAwB5G,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAOhG"}
+{"version":3,"file":"TextAnnotation.d.ts","sourceRoot":"","sources":["../../../src/drawings/tools/TextAnnotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,SAAS,GAAG,MAAM,CAOpF;AAED,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,UAAU;;;;MAA+D;IAEzE,MAAM,CAAC,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAwB5G,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAOhG"}

package/dist/features/ChartState.d.ts

@@ -28,6 +28,7 @@ export interface ChartSnapshot {
     positions: TradingPosition[];
     alerts: PriceAlert[];
 }
+export declare function validateSnapshot(raw: unknown): ChartSnapshot;
 export declare class ChartStateManager {
     /**
      * Capture current chart state as a serializable snapshot.
@@ -50,7 +51,11 @@ export declare class ChartStateManager {
     }): ChartSnapshot;
     /** Serialize to JSON string */
     static serialize(snapshot: ChartSnapshot): string;
-    /** Deserialize from JSON string */
+    /**
+     * Deserialize from JSON string. Validates the top-level shape and filters
+     * malformed array entries instead of trusting `JSON.parse`. Missing or
+     * wrong-typed fields fall back to safe defaults so older saves still load.
+     */
     static deserialize(json: string): ChartSnapshot;
     /** Save to localStorage */
     static saveToStorage(key: string, snapshot: ChartSnapshot): void;

package/dist/features/ChartState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChartState.d.ts","sourceRoot":"","sources":["../../src/features/ChartState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC1G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IAGrB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAGF,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IAGJ,QAAQ,EAAE,YAAY,EAAE,CAAC;IAGzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,SAAS,EAAE,eAAe,EAAE,CAAC;IAG7B,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAID,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE;QACpB,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC;QAClC,SAAS,CAAC,EAAE,MAAM,YAAY,EAAE,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,eAAe,EAAE,CAAC;QACvC,SAAS,CAAC,EAAE,MAAM,UAAU,EAAE,CAAC;QAC/B,QAAQ,EAAE,MAAM,KAAK,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,EAAE,CAAC;KAC7F,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,aAAa;IAiBxF,+BAA+B;IAC/B,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM;IAIjD,mCAAmC;IACnC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAQ/C,2BAA2B;IAC3B,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIhE,6BAA6B;IAC7B,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAKzD,4BAA4B;IAC5B,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,SAAwB,GAAG,IAAI;IAYpF,uCAAuC;IACvC,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;CAc9C"}
+{"version":3,"file":"ChartState.d.ts","sourceRoot":"","sources":["../../src/features/ChartState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC1G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IAGrB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAGF,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IAGJ,QAAQ,EAAE,YAAY,EAAE,CAAC;IAGzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,SAAS,EAAE,eAAe,EAAE,CAAC;IAG7B,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAiED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAkE5D;AAgBD,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE;QACpB,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC;QAClC,SAAS,CAAC,EAAE,MAAM,YAAY,EAAE,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,eAAe,EAAE,CAAC;QACvC,SAAS,CAAC,EAAE,MAAM,UAAU,EAAE,CAAC;QAC/B,QAAQ,EAAE,MAAM,KAAK,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,EAAE,CAAC;KAC7F,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,aAAa;IAiBxF,+BAA+B;IAC/B,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM;IAIjD;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAK/C,2BAA2B;IAC3B,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIhE,6BAA6B;IAC7B,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAKzD,4BAA4B;IAC5B,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,SAAwB,GAAG,IAAI;IAYpF,uCAAuC;IACvC,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;CAc9C"}