hyperprop-charting-library 0.1.145 → 0.1.147

package/docs/API.md

@@ -625,6 +625,7 @@ link.click();
 
 - `startReplay(options?: ReplayStartOptions): void` / `stopReplay(): void`
 - `replayStep(bars?: number): void` — negative rewinds.
+- `replaySeek(index: number): void` — absolute jump, clamped to the series.
 - `replayPlay(speed?: number): void` / `replayPause(): void` / `setReplaySpeed(speed: number): void`
 - `getReplayState(): ReplayState` / `onReplayStateChange(handler)`
 
@@ -644,6 +645,70 @@ link.click();
 
 ---
 
+## Futures desk indicators
+
+Three built-ins aimed at intraday futures work. All three are overlays on the
+main pane, and the last two need a session spec (`setSession`) — without one
+they have no notion of a trading day and render nothing.
+
+### `volume-profile`
+
+Volume distribution across price, with point of control and value area.
+
+```ts
+chart.addIndicator("volume-profile", { scope: "visible", rows: 40, widthPercent: 28 });
+chart.addIndicator("volume-profile", { scope: "session" }); // one per trading day
+```
+
+`scope: "visible"` profiles whatever is on screen and follows pan/zoom, drawn
+against the price axis; `scope: "session"` draws a separate profile inside each
+trading day's bars, skipping any session too narrow to read. Rows are split
+into buy and sell volume by each bar's own direction, shaded brighter inside
+the value area. Inputs: `rows`, `widthPercent`, `placement`
+(`"right" | "left"`, visible scope only), `valueAreaPercent`, `upColor`,
+`downColor`, `valueAreaOpacity`, `outsideOpacity`, `showPoc`, `pocColor`,
+`showValueArea`, `valueAreaColor`, `showLabels`.
+
+OHLCV bars carry no intrabar detail, so each bar's volume is spread evenly over
+the rows its high–low range touches — the same approximation TradingView makes
+when building a profile from candles rather than ticks.
+
+### `session-levels`
+
+The reference prices marked up before the open: prior-day high/low/close
+(PDH/PDL/PDC), overnight high/low (ONH/ONL), the opening range (ORH/ORL) and
+optionally the initial balance (IBH/IBL, first hour).
+
+```ts
+chart.setSession({ spec: "cme-futures" });
+chart.addIndicator("session-levels", { openingRangeMinutes: 30, showInitialBalance: true });
+```
+
+Cash-session bounds are inputs (`rthStart` / `rthEnd`, default 09:30–16:00)
+rather than being read from the chart's session spec: a CME futures session
+runs 18:00–17:00, but the levels traders mark are relative to the 09:30 equity
+open inside it. Everything in the current session outside those hours counts as
+overnight.
+
+### `anchored-vwap`
+
+VWAP measured from a bar you choose rather than the session open.
+
+```ts
+chart.addIndicator("anchored-vwap", {
+  anchorTime: "2026-07-14T13:30:00Z", // epoch ms or ISO
+  showBands: true,
+  bandMultiplier: 2
+});
+```
+
+Without an `anchorTime` it anchors to the most recent session start, which is
+just the session VWAP. Add one instance per anchor; hosts typically expose this
+as a "start here" action on the bar under the cursor. Volume-less feeds fall
+back to an unweighted running average rather than flatlining.
+
+---
+
 ## Time zones and trading sessions
 
 Timestamps are rendered in whatever zone you choose, and the chart can be told
@@ -724,6 +789,7 @@ chart.startReplay({ fromTimeMs: Date.parse("2026-07-14T13:30:00Z"), speed: 4 });
 chart.replayPlay();          // 4 bars per second
 chart.replayStep(1);         // or step by hand
 chart.replayStep(-1);        // rewind
+chart.replaySeek(1200);      // jump straight to a bar (scrubbers, "replay from here")
 chart.onReplayStateChange((s) => {
   label.textContent = `${s.index + 1}/${s.total}${s.atEnd ? " (end)" : ""}`;
 });
@@ -734,6 +800,16 @@ Live bars arriving during replay are buffered rather than shown, and are all
 present when replay stops. Without `fromIndex`/`fromTimeMs` replay starts 70%
 of the way through the series.
 
+While replay is active the chart also takes the arrow keys and Space: arrows
+step the tape (Shift steps 10) instead of panning, and Space toggles playback.
+Both revert to normal as soon as replay stops, and `keyboard.replay: false`
+turns them off. Stepping one bar at a time is the wrong tool for covering
+distance, so pair them with `replaySeek` for a scrubber:
+
+```ts
+scrubber.oninput = () => chart.replaySeek(Number(scrubber.value));
+```
+
 ---
 
 ## Price alerts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperprop-charting-library",
-  "version": "0.1.145",
+  "version": "0.1.147",
   "description": "Lightweight TypeScript charting core",
   "type": "module",
   "main": "./dist/hyperprop-charting-library.cjs",
@@ -22,7 +22,7 @@
     "build": "tsup src/index.ts --format esm,cjs --dts --clean && cp \"./dist/index.js\" \"./dist/hyperprop-charting-library.js\" && cp \"./dist/index.cjs\" \"./dist/hyperprop-charting-library.cjs\" && cp \"./dist/index.d.ts\" \"./dist/hyperprop-charting-library.d.ts\"",
     "dev": "tsup src/index.ts --format esm,cjs --dts --watch --onSuccess \"cp ./dist/index.js ./dist/hyperprop-charting-library.js && cp ./dist/index.cjs ./dist/hyperprop-charting-library.cjs && cp ./dist/index.d.ts ./dist/hyperprop-charting-library.d.ts\"",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npx tsx src/time.test.mjs"
+    "test": "npx tsx src/time.test.mjs && npx tsx src/indicators.test.mjs"
   },
   "devDependencies": {
     "tsup": "^8.5.0"