Bins ordered low→high price. Length is the requested bins (≥ 1).
Index into bins of the Point of Control — the single bin with the
most volume. -1 only when there is no volume at all (every bin empty).
Sum of all bin volumes (finite candle volume that fell inside the range).
Upper price edge of the value area (the priceHigh of its highest bin).
Lower price edge of the value area (the priceLow of its lowest bin).
Horizontal volume distribution over a price range, plus the derived Point-of-Control and Value-Area summary.