lightweight-charts-drawing 0.2.4 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.3.0 (02/10/2026)
+
+### Added
+
+- `fibLevelAt(d, pts, cursor, w, coords)` (`src/core/scene/fib.ts`): the fib
+  retracement / trend-based extension level line under the cursor (within
+  6 px): its index in the level list, y, x-range and level text x. For hosts
+  that edit a level's text on the chart. Not exported from the package entry.
+
+### Changed
+
+- Anchored VWAP: an unset `fillBackground` draws the band #1 fill (TradingView
+  factory: on, transparency 95). Before, only `fillBackground: true` drew it.
+- Triangle pattern, head and shoulders: an unset `transparency` is the factory
+  85 (was 80), and transparency 100 draws no fill (was a 0.15 opacity
+  fallback).
+
+### Fixed
+
+- `VERSION` matches the package version (it stayed at 0.2.4 in 0.2.5).
+
+## 0.2.5 (01/10/2026)
+
+### Added
+
+- Volume profiles (fixed range, anchored): `DrawingStyle.vp`
+  (`VolumeProfileStyle`) with the study settings: rows layout (number of
+  rows / ticks per row) and row size, volume (Up/Down, Total, Delta), value
+  area volume, extend right (fixed range), histogram visibility, row values,
+  width (% of the box), placement, up / down and value area colours, VAH /
+  VAL / POC lines, developing POC and VA lines, histogram box colour.
+  Defaults: `volumeProfileDefaults(kind)`, merged settings:
+  `volumeProfileStyle(kind, style)`.
+
+### Changed
+
+- Pitchfan: each level is drawn with its own width and line style.
+- Info line: `extendLeft` / `extendRight` continue the line to the pane edges.
+- Highlighter: drawn at its width (no 12 px minimum).
+
 ## 0.2.4 (01/10/2026)
 
 ### Added
@@ -144,7 +184,7 @@ runtime (`src/runtime`). Breaking: the 0.1 API is removed.
 
 - The volume-based tools need bars with a volume: pass them with the
   `bars` option (series data usually has none).
-- Checks behind this release (in `docs/port-opentrader/`): the renderers
+- Checks behind this release: the renderers
   match OpenTrader's on 430 golden fixtures, the canvas renderer matches the
   SVG output on 774 fixtures (0.05 % of drawn pixels differ, text
   anti-aliasing), and all 86 tools pass a real-mouse survey (place, select,

package/dist/index.d.ts

@@ -624,6 +624,10 @@ export declare type DrawingStyle = {
     vwapUpper?: RegressionLine[];
     vwapLower?: RegressionLine[];
     vwapPriceLabel?: boolean;
+    /** Fixed range / anchored volume profile settings (the reference VbP
+     *  study: Inputs + Style tab). Unset = the kind's factory settings
+     *  (`volumeProfileDefaults` in specs). */
+    vp?: VolumeProfileStyle;
 };
 
 /** Draws `items` on `ctx` (current transform = CSS pixels). */
@@ -1359,7 +1363,50 @@ declare type UnitVisibility = {
     to: number;
 };
 
-export declare const VERSION = "0.2.4";
+export declare const VERSION = "0.3.0";
+
+/** Volume profile tools: the reference VbPFixed / VbPAnchored study
+ *  defaults (24 rows, Up/Down, 70% value area, histogram 30% of the box,
+ *  POC 2 px on, VAH / VAL 2 px off, developing plots 1 px off) with the
+ *  dark-theme colours of its themed colour list (cold gray 200 lines and
+ *  values, sky blue 400 at 50 / 75 % up, berry pink 400 at 50 / 75 % down,
+ *  sky blue 500 developing VA, sky blue 400 at 5 % box). Fixed range draws
+ *  from the left edge, anchored from the right. */
+export declare function volumeProfileDefaults(kind: DrawingKind): VolumeProfileStyle;
+
+/** Volume profile tool settings (reference VbPFixed / VbPAnchored study).
+ *  Inputs: rows layout (number of rows or ticks per row) and row size,
+ *  volume (Up/Down, Total, Delta), value area volume (%), extend right
+ *  (fixed range only). Style: the histogram (visible, values, width % of
+ *  the box, placement, up / down and value area up / down colours), the
+ *  VAH / VAL / POC lines, the developing POC and VA plots and the
+ *  histogram box colour. */
+export declare type VolumeProfileStyle = {
+    rowsLayout: "rows" | "ticks";
+    rows: number;
+    volume: "upDown" | "total" | "delta";
+    vaVolume: number;
+    extendRight: boolean;
+    visible: boolean;
+    showValues: boolean;
+    valuesColor: string;
+    percentWidth: number;
+    placement: "left" | "right";
+    upColor: string;
+    downColor: string;
+    vaUpColor: string;
+    vaDownColor: string;
+    vah: RegressionLine;
+    val: RegressionLine;
+    poc: RegressionLine;
+    developingPoc: RegressionLine;
+    developingVah: RegressionLine;
+    developingVal: RegressionLine;
+    boxColor: string;
+};
+
+/** The drawing's volume profile settings over the factory ones. */
+export declare function volumeProfileStyle(kind: DrawingKind, s: DrawingStyle): VolumeProfileStyle;
 
 declare type WithId<T> = T & {
     id: string;