lightweight-charts-drawing 0.2.4 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 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 +163,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). */
@@ -1361,6 +1365,49 @@ declare type UnitVisibility = {
 
 export declare const VERSION = "0.2.4";
 
+/** 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;
     style: DrawingStyle;