acttrader-charts 1.0.0 → 1.0.2

package/README.md

@@ -1,4 +1,4 @@
-# @acttrader/stockchart
+# acttrader-charts
 
 A performant, zero-dependency stock charting library built on Canvas 2D.
 Dual ESM/CJS output, TypeScript-first.
@@ -10,7 +10,7 @@ Dual ESM/CJS output, TypeScript-first.
 ## Installation
 
 ```bash
-npm install @acttrader/stockchart
+npm install acttrader-charts
 ```
 
 ---
@@ -18,7 +18,7 @@ npm install @acttrader/stockchart
 ## Basic Usage
 
 ```ts
-import { ChartEngine } from '@acttrader/stockchart';
+import { ChartEngine } from 'acttrader-charts';
 
 const chart = new ChartEngine({
     container: document.getElementById('chart')!,
@@ -62,7 +62,7 @@ const chart = new ChartEngine({
 ### Adding Indicators
 
 ```ts
-import { SMA, EMA, RSI } from '@acttrader/stockchart';
+import { SMA, EMA, RSI } from 'acttrader-charts';
 
 chart.addIndicator(new SMA(20, '#f59e0b'));      // overlay
 chart.addIndicator(new RSI(14, '#818cf8'));      // sub-pane
@@ -83,7 +83,7 @@ Keyboard shortcuts: `Escape` cancel / deselect · `Delete`/`Backspace` remove se
 ### Real-time Streaming
 
 ```ts
-import { WebSocketAdapter } from '@acttrader/stockchart';
+import { WebSocketAdapter } from 'acttrader-charts';
 
 const adapter = new WebSocketAdapter(
     'wss://feed.example.com/ticks',
@@ -249,7 +249,7 @@ new ChartEngine({ ..., durationTimeframeMap: { '1Y': '4h', '5Y': '1D' } });
 All values are optional; unset keys fall back to `DEFAULT_UI_CONFIG`.
 
 ```ts
-import { DEFAULT_UI_CONFIG } from '@acttrader/stockchart';
+import { DEFAULT_UI_CONFIG } from 'acttrader-charts';
 ```
 
 | Component key | Configurable properties |
@@ -265,7 +265,7 @@ import { DEFAULT_UI_CONFIG } from '@acttrader/stockchart';
 **Example:**
 
 ```ts
-import { resolveUiConfig } from '@acttrader/stockchart';
+import { resolveUiConfig } from 'acttrader-charts';
 
 new ChartEngine({
     container,
@@ -285,7 +285,7 @@ import {
     DEFAULT_PRICE_AXIS_CONFIG,
     DEFAULT_CROSSHAIR_CONFIG,
     // ...
-} from '@acttrader/stockchart';
+} from 'acttrader-charts';
 ```
 
 ### `ChartLabels` — i18n / translation
@@ -293,7 +293,7 @@ import {
 All user-visible strings can be overridden for translation. Only keys you supply are replaced; the rest fall back to `DEFAULT_LABELS` (English).
 
 ```ts
-import { DEFAULT_LABELS, resolveLabels } from '@acttrader/stockchart';
+import { DEFAULT_LABELS, resolveLabels } from 'acttrader-charts';
 ```
 
 Pass overrides directly in `ChartConfig`:
@@ -378,8 +378,8 @@ new ChartEngine({
 ### `ChartTheme` — colors
 
 ```ts
-import { DARK_THEME, LIGHT_THEME } from '@acttrader/stockchart';
-import type { ChartTheme } from '@acttrader/stockchart';
+import { DARK_THEME, LIGHT_THEME } from 'acttrader-charts';
+import type { ChartTheme } from 'acttrader-charts';
 ```
 
 Pass a full or partial theme object to customize colors:
@@ -491,7 +491,7 @@ chart.setState(state);
 Use together with the `stateChange` event to persist chart config per symbol:
 
 ```ts
-import type { ChartState } from '@acttrader/stockchart';
+import type { ChartState } from 'acttrader-charts';
 
 chart.on('stateChange', ({ symbol, state }) => {
     localStorage.setItem(`chart:${symbol}`, JSON.stringify(state));
@@ -637,7 +637,7 @@ chart.on('tradeLevelConfirmed',({ label, type }) => {});
 Implement `IIndicator` and pass it to `addIndicator()`:
 
 ```ts
-import type { IIndicator, OHLCVBar, IndicatorResult } from '@acttrader/stockchart';
+import type { IIndicator, OHLCVBar, IndicatorResult } from 'acttrader-charts';
 
 class MyIndicator implements IIndicator {
     name       = 'MyInd';

package/dist/{MACD-BmvUIYwI.d.cts → MACD-K2nBudgk.d.cts}

@@ -617,6 +617,34 @@ interface ChartConfig {
      * Default: `2`.
      */
     mobileBarDivisor?: 2 | 3 | 4;
+    /**
+     * Initial number of candles visible when the chart first loads (desktop).
+     * On mobile this value is further divided by `mobileBarDivisor` unless
+     * `defaultMobileVisibleBars` is also set.
+     * Default: `80`.
+     *
+     * @deprecated Use `targetCandleWidth` instead. The chart will automatically
+     * calculate the appropriate number of visible bars based on the canvas width.
+     * This option remains as an explicit override when a fixed bar count is needed.
+     */
+    defaultVisibleBars?: number;
+    /**
+     * Initial number of candles visible when the chart first loads on
+     * touch/mobile devices. When set, overrides the `mobileBarDivisor` logic.
+     * Default: `defaultVisibleBars / mobileBarDivisor`.
+     *
+     * @deprecated Use `targetCandleWidth` instead. The chart will automatically
+     * calculate the appropriate number of visible bars based on the canvas width.
+     * This option remains as an explicit override when a fixed bar count is needed.
+     */
+    defaultMobileVisibleBars?: number;
+    /**
+     * Target pixel width per candle slot used to auto-calculate the initial
+     * number of visible bars from the canvas width. Ignored when
+     * `defaultVisibleBars` is explicitly provided.
+     * Default: `10`.
+     */
+    targetCandleWidth?: number;
     /**
      * Which side of the quote to use for candle close/high/low during live
      * tick updates. Defaults to `'bid'` (forex convention). Set to `'ask'`
@@ -726,6 +754,8 @@ type DrawingToolType = "horizontalLine" | "verticalLine" | "trendLine" | "rectan
 interface DrawingPoint {
     barIndex: number;
     price: number;
+    /** Unix-ms timestamp of the bar at this point — used to re-anchor drawings after data reload. */
+    timestamp?: number;
 }
 /** A resize handle on a drawing — identifies which point can be dragged */
 interface DrawingHandle {

package/dist/{MACD-BmvUIYwI.d.ts → MACD-K2nBudgk.d.ts}

@@ -617,6 +617,34 @@ interface ChartConfig {
      * Default: `2`.
      */
     mobileBarDivisor?: 2 | 3 | 4;
+    /**
+     * Initial number of candles visible when the chart first loads (desktop).
+     * On mobile this value is further divided by `mobileBarDivisor` unless
+     * `defaultMobileVisibleBars` is also set.
+     * Default: `80`.
+     *
+     * @deprecated Use `targetCandleWidth` instead. The chart will automatically
+     * calculate the appropriate number of visible bars based on the canvas width.
+     * This option remains as an explicit override when a fixed bar count is needed.
+     */
+    defaultVisibleBars?: number;
+    /**
+     * Initial number of candles visible when the chart first loads on
+     * touch/mobile devices. When set, overrides the `mobileBarDivisor` logic.
+     * Default: `defaultVisibleBars / mobileBarDivisor`.
+     *
+     * @deprecated Use `targetCandleWidth` instead. The chart will automatically
+     * calculate the appropriate number of visible bars based on the canvas width.
+     * This option remains as an explicit override when a fixed bar count is needed.
+     */
+    defaultMobileVisibleBars?: number;
+    /**
+     * Target pixel width per candle slot used to auto-calculate the initial
+     * number of visible bars from the canvas width. Ignored when
+     * `defaultVisibleBars` is explicitly provided.
+     * Default: `10`.
+     */
+    targetCandleWidth?: number;
     /**
      * Which side of the quote to use for candle close/high/low during live
      * tick updates. Defaults to `'bid'` (forex convention). Set to `'ask'`
@@ -726,6 +754,8 @@ type DrawingToolType = "horizontalLine" | "verticalLine" | "trendLine" | "rectan
 interface DrawingPoint {
     barIndex: number;
     price: number;
+    /** Unix-ms timestamp of the bar at this point — used to re-anchor drawings after data reload. */
+    timestamp?: number;
 }
 /** A resize handle on a drawing — identifies which point can be dragged */
 interface DrawingHandle {