lightweight-charts-drawing 0.5.1 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 0.6.1 (15/10/2026)
+
+### Added
+
+- `makeCoords(..., getFuture)` (optional 6th argument, `FutureAxis`): bars
+  after the last bar on the symbol's trading calendar, given by the host
+  (`slots(time, lastTime)`, `time(k, lastTime)`). With it a point placed after
+  the last bar takes the open time of its nearest future bar, a future time is
+  drawn on the future bar that holds it (`timeToX`, `xToTime`,
+  `timeToBarIndex`, `barIndexToTime`, `timeToXFallback`). Without it, calendar
+  time with the median bar interval as before.
+
+## 0.6.0 (13/10/2026)
+
+### Added
+
+- `Coords.lowerTimeframe` (optional): bars of the chart symbol on a lower
+  timeframe (`bars(resolution, from)`, `barEnd(time)`, `seconds`). The fixed
+  range and anchored volume profiles are built from them (timeframe by the
+  span of the range: the first of 1, 5, 15, 30, 60, 240 minutes or 1 day
+  giving fewer than 5000 bars) and fall back to the chart bars without it.
+- Core `kinds/vbp-engine`: the volume profile engine (rows, allocation,
+  direction, POC, value area, lower-timeframe choice) shared with the
+  OpenTrader profile studies.
+
+### Changed
+
+- Volume profiles follow the reference rules: high / low rounded to the tick,
+  "Number Of Rows" picks the ticks per row whose row count is closest to the
+  input (rows may pass the high), "Ticks Per Row" rows sit on multiples of the
+  row size, a doji's direction comes from the previous close, the value area
+  adds the larger neighbour row only while it fits in the value area volume,
+  and the POC of equal rows is the one closest to the middle.
+
 ## 0.5.1 (08/10/2026)
 
 ### Added

package/dist/index.d.ts

@@ -114,6 +114,8 @@ export declare type Coords = {
         timeZone: string;
         intraday: boolean;
     };
+    /** Lower-timeframe bars of the chart symbol (volume profile drawings); optional. */
+    lowerTimeframe?: LowerTimeframe;
 };
 
 declare type Ctx = CanvasRenderingContext2D;
@@ -690,6 +692,16 @@ declare type FourPoint = {
  *  finalized with a double-click (the spec carries `variableLength: true`). */
 declare type FreehandKind = "polyline" | "path" | "brush" | "highlighter";
 
+/** Bars after the last bar on the symbol's trading calendar (the host knows the sessions). The time scale continues
+ *  after the last bar with the bars the symbol would open: the rest of the session, then the next sessions (nights,
+ *  weekends and holidays skipped). Times are epoch seconds. */
+declare type FutureAxis = {
+    /** Future bars that open after `lastTime` and at or before `time` (0 = still on the last bar). */
+    slots: (time: number, lastTime: number) => number;
+    /** Open time of the k-th future bar (k >= 1), null past the host's range. */
+    time: (k: number, lastTime: number) => number | null;
+};
+
 /** One regression trend line (TV study plot style). */
 /** Gann level line (TV levels.N: color, width, visible). */
 declare type GannLine = {
@@ -795,6 +807,18 @@ export declare type LoadedImage = {
     height: number;
 };
 
+/** Bars of the chart symbol on a lower timeframe (the volume profiles are built from them, as the reference
+ *  app's volume profile study). Optional: without it the profiles use the chart bars. */
+declare type LowerTimeframe = {
+    /** Bars on `resolution` ("1", "5", "15", "30", "60", "240", "1D", "1S") from `from` (epoch seconds) on;
+     *  undefined while they load (the host redraws the drawings when they arrive). */
+    bars: (resolution: string, from: number) => OHLC[] | undefined;
+    /** End (epoch seconds) of the chart bar starting at `time`: its interval, a daily bar's session close. */
+    barEnd: (time: number) => number;
+    /** The chart interval is in seconds (its profiles use 1-second bars). */
+    seconds: boolean;
+};
+
 export declare type MagnetMode = "off" | "weak" | "strong";
 
 export declare function makeCoords(chart: IChartApi, series: ISeriesApi<SeriesType>, getRaw: () => OHLC[], 
@@ -803,7 +827,9 @@ export declare function makeCoords(chart: IChartApi, series: ISeriesApi<SeriesTy
 getIndicatorValues?: (sec: number | null) => number[], getTimeInfo?: () => {
     timeZone: string;
     intraday: boolean;
-}): Coords;
+}, 
+/** Future bars on the trading calendar; null (or absent) = calendar time extrapolated with the bar interval. */
+getFuture?: () => FutureAxis | null): Coords;
 
 /** Point-count migration (10/07/2026): several kinds moved to TV's point
  *  models. Old saved drawings are padded/synthesized best-effort so they keep
@@ -1273,8 +1299,9 @@ export declare type TimeAxisLabel = {
 /** Shared time→x with the off-bar fallback, for non-drawing renderers (event
  *  markers, etc.) that paint at arbitrary times. Mirrors the `timeToX` method:
  *  try lightweight-charts' exact mapping first, then the gap-aware logical
- *  interpolation. `sec` is UNIX seconds. Returns null with no data. */
-export declare function timeToXFallback(chart: IChartApi, sec: number, bars: OHLC[]): number | null;
+ *  interpolation (future bars on `future` when given). `sec` is UNIX seconds.
+ *  Returns null with no data. */
+export declare function timeToXFallback(chart: IChartApi, sec: number, bars: OHLC[], future?: FutureAxis | null): number | null;
 
 /** TV _onAnchoredChange: anchoring stores the current screen point as pane
  *  fractions; unanchoring turns the fixed point back into a data point (bar