openalgo-charts 1.0.25 → 1.0.27

package/README.md

@@ -102,7 +102,7 @@ draw.setTool('trend-line');   // the next two clicks place it
 Headless by design — no toolbar, no dialogs. Placement with live preview, selection, whole-shape and per-anchor dragging, magnet snap to O/H/L/C, undo/redo (a drag is one step), and persistence. Anchors are `{ time, price }`, never pixels, so they survive zoom and resolve inside collapsed session gaps and past the last bar.
 
 ### Panes & legends
-Draggable pane dividers, move / maximize / remove, and TradingView-style pane legends showing one reading per plot in that plot's own colour, with inline show-hide / settings / move / delete controls revealed on hover.
+Draggable pane dividers, move / maximize / remove, and pane legends showing one reading per plot in that plot's own colour, with inline show-hide / settings / move / delete controls revealed on hover.
 
 ### Trading
 Order, position, and bracket lines with live P&L, one-click and drag-to-modify, OCO, validation, an order state machine, analyzer (sandbox) mode, and a depth-of-market ladder (5 to 200 levels).
@@ -145,7 +145,7 @@ cd website && npm install && npm run dev    # http://localhost:3000/openalgo-cha
 
 ## Examples
 
-Runnable demos in [`examples/`](./examples), including a full **yfinance terminal** ([`examples/yfinance`](./examples/yfinance)) with a TradingView-style shell: symbol search, interval pills, chart-type picker, indicator menu, a vertical drawing rail, a floating properties bar, generated indicator settings, and layout persistence.
+Runnable demos in [`examples/`](./examples), including a full **yfinance terminal** ([`examples/yfinance`](./examples/yfinance)) with a full terminal shell: symbol search, interval pills, chart-type picker, indicator menu, a vertical drawing rail, a floating properties bar, generated indicator settings, and layout persistence.
 
 ```bash
 npm run build

package/dist/index.d.ts

@@ -128,6 +128,14 @@ declare const DEFAULT_PRICE_SCALE_OPTIONS: PriceScaleOptions;
 /**
  * Pure: compute a price range from data extremes plus top/bottom margins.
  * Returns a padded [min,max]; widens a degenerate (flat) range so it's drawable.
+ *
+ * The margins are fractions of the **pane height**, so the data band occupies
+ * the `1 - marginTop - marginBottom` left between them. Padding the data span
+ * by the margin instead — which is what this did — makes the reserved space
+ * depend on how tall the data happens to be: an overlay asking for `0.82` to
+ * sit in the bottom 18% got `high + 0.82 * span`, leaving its bars 55% of the
+ * pane. The difference only shows at large margins; at the 0.1 default the two
+ * readings land within a few percent of each other.
  */
 declare function autoscaleRange(low: number, high: number, marginTop: number, marginBottom: number): PriceRange;
 declare class PriceScale {
@@ -1045,6 +1053,16 @@ declare class PriceLine implements IPrimitive {
     setPrice(price: number): void;
     /** Update the info segment text (e.g. live position P&L); repaints. */
     setLeftLabel(text: string): void;
+    /**
+     * Restyle in place; repaints. `id` is the hit-test handle the chart routes
+     * clicks and drags through, so it is not patchable — swapping it under a
+     * live drag would strand the gesture.
+     *
+     * A last-price line is the case this exists for: it has to follow the tick
+     * direction, and only `setPrice` was updatable, so the colour was stuck at
+     * whatever it was constructed with.
+     */
+    setOptions(patch: Partial<Omit<PriceLineOptions, 'id'>>): void;
     /**
      * Show a dimmed reference line at the pre-drag price while the user drags
      * (pass the original price on drag start, null on drag end to clear).
@@ -1061,7 +1079,7 @@ declare class PriceLine implements IPrimitive {
 }
 
 /**
- * Pane legend (ARCHITECTURE.md §8) — the TradingView-style row at the top-left
+ * Pane legend (ARCHITECTURE.md §8) — the row at the top-left
  * of a pane: a color swatch, the source's name, its parameters, the value under
  * the crosshair, and inline action buttons on the right.
  *
@@ -1808,7 +1826,7 @@ interface ChartOptions {
      */
     timeFormatter?: (utcSeconds: number, tickMark?: TickMarkType) => string;
     /**
-     * Hover-revealed zoom / step controls above the time axis (TradingView-style).
+     * Hover-revealed zoom / step controls above the time axis, as terminals show.
      * `true` by default — they stay invisible until the pointer nears the bottom
      * of the chart. Pass `false` to drop them, or an options object to restyle.
      */
@@ -2587,7 +2605,7 @@ declare class LogoWatermark implements IPrimitive {
 }
 
 /**
- * Inline Buy/Sell button panel (ARCHITECTURE.md §9). A TradingView-style trade
+ * Inline Buy/Sell button panel (ARCHITECTURE.md §9). An on-chart trade
  * panel docked inside the plot: a SELL button (bid), a quantity chip, and a BUY
  * button (ask), drawn on the overlay canvas so it stays fixed while the chart
  * pans/zooms. Clicks hit-test to `${id}:sell` / `${id}:buy` / `${id}:qty`, which