hyperprop-charting-library 0.1.144 → 0.1.145

package/dist/hyperprop-charting-library.cjs

@@ -10548,6 +10548,22 @@ function createChart(element, options = {}) {
     if (event.altKey || event.ctrlKey || event.metaKey) {
       return;
     }
+    if (replay && keyboard.replay !== false) {
+      if (event.key === "ArrowRight" || event.key === "ArrowLeft") {
+        const direction = event.key === "ArrowRight" ? 1 : -1;
+        replayStep(direction * (event.shiftKey ? 10 : 1));
+        emit(direction > 0 ? "replay-step-forward" : "replay-step-back");
+        event.preventDefault();
+        return;
+      }
+      if (event.key === " " || event.key === "Spacebar") {
+        if (replay.playing) replayPause();
+        else replayPlay();
+        emit("replay-toggle-play");
+        event.preventDefault();
+        return;
+      }
+    }
     switch (event.key) {
       case "Delete":
       case "Backspace": {
@@ -10959,7 +10975,11 @@ function createChart(element, options = {}) {
   const replayStep = (bars = 1) => {
     if (!replay) return;
     const step = Math.trunc(bars) || 1;
-    const next = clamp(replay.cursor + step, 0, replay.fullRaw.length - 1);
+    replaySeek(replay.cursor + step);
+  };
+  const replaySeek = (index) => {
+    if (!replay || !Number.isFinite(index)) return;
+    const next = clamp(Math.round(index), 0, replay.fullRaw.length - 1);
     if (next === replay.cursor) return;
     replay.cursor = next;
     applyReplaySlice();
@@ -11592,6 +11612,7 @@ function createChart(element, options = {}) {
     startReplay,
     stopReplay,
     replayStep,
+    replaySeek,
     replayPlay,
     replayPause,
     setReplaySpeed,

package/dist/hyperprop-charting-library.d.ts

@@ -561,7 +561,7 @@ interface ChartContextMenuEvent {
     };
 }
 /** Built-in keyboard actions, reported after the chart applies them. */
-type ChartKeyboardAction = "delete-drawing" | "cancel" | "undo" | "redo" | "pan-left" | "pan-right" | "pan-up" | "pan-down" | "zoom-in" | "zoom-out" | "reset-viewport" | "scroll-to-realtime";
+type ChartKeyboardAction = "delete-drawing" | "cancel" | "undo" | "redo" | "pan-left" | "pan-right" | "pan-up" | "pan-down" | "zoom-in" | "zoom-out" | "reset-viewport" | "scroll-to-realtime" | "replay-step-forward" | "replay-step-back" | "replay-toggle-play";
 interface ChartKeyboardShortcutEvent {
     action: ChartKeyboardAction;
     /** The originating `KeyboardEvent.key`. */
@@ -583,6 +583,12 @@ interface KeyboardOptions {
     deleteSelectedDrawing?: boolean;
     /** Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z (or Ctrl+Y). Default true. */
     undoRedo?: boolean;
+    /**
+     * While replay is running, arrows step the tape (Shift steps 10) and Space
+     * toggles playback, instead of panning. Only applies during replay.
+     * Default true.
+     */
+    replay?: boolean;
 }
 /**
  * Deep zoom-out rendering. Once bars are narrower than `thresholdPx`, several
@@ -1035,6 +1041,11 @@ interface ChartInstance {
     stopReplay: () => void;
     /** Reveal `bars` more bars (negative rewinds). Default 1. */
     replayStep: (bars?: number) => void;
+    /**
+     * Jump straight to a bar index, for a scrubber or a "replay from here"
+     * action. Clamped to the series; playback continues from where it lands.
+     */
+    replaySeek: (index: number) => void;
     replayPlay: (speed?: number) => void;
     replayPause: () => void;
     /** Bars revealed per second. */

package/dist/hyperprop-charting-library.js

@@ -10512,6 +10512,22 @@ function createChart(element, options = {}) {
     if (event.altKey || event.ctrlKey || event.metaKey) {
       return;
     }
+    if (replay && keyboard.replay !== false) {
+      if (event.key === "ArrowRight" || event.key === "ArrowLeft") {
+        const direction = event.key === "ArrowRight" ? 1 : -1;
+        replayStep(direction * (event.shiftKey ? 10 : 1));
+        emit(direction > 0 ? "replay-step-forward" : "replay-step-back");
+        event.preventDefault();
+        return;
+      }
+      if (event.key === " " || event.key === "Spacebar") {
+        if (replay.playing) replayPause();
+        else replayPlay();
+        emit("replay-toggle-play");
+        event.preventDefault();
+        return;
+      }
+    }
     switch (event.key) {
       case "Delete":
       case "Backspace": {
@@ -10923,7 +10939,11 @@ function createChart(element, options = {}) {
   const replayStep = (bars = 1) => {
     if (!replay) return;
     const step = Math.trunc(bars) || 1;
-    const next = clamp(replay.cursor + step, 0, replay.fullRaw.length - 1);
+    replaySeek(replay.cursor + step);
+  };
+  const replaySeek = (index) => {
+    if (!replay || !Number.isFinite(index)) return;
+    const next = clamp(Math.round(index), 0, replay.fullRaw.length - 1);
     if (next === replay.cursor) return;
     replay.cursor = next;
     applyReplaySlice();
@@ -11556,6 +11576,7 @@ function createChart(element, options = {}) {
     startReplay,
     stopReplay,
     replayStep,
+    replaySeek,
     replayPlay,
     replayPause,
     setReplaySpeed,

package/dist/index.cjs

@@ -10548,6 +10548,22 @@ function createChart(element, options = {}) {
     if (event.altKey || event.ctrlKey || event.metaKey) {
       return;
     }
+    if (replay && keyboard.replay !== false) {
+      if (event.key === "ArrowRight" || event.key === "ArrowLeft") {
+        const direction = event.key === "ArrowRight" ? 1 : -1;
+        replayStep(direction * (event.shiftKey ? 10 : 1));
+        emit(direction > 0 ? "replay-step-forward" : "replay-step-back");
+        event.preventDefault();
+        return;
+      }
+      if (event.key === " " || event.key === "Spacebar") {
+        if (replay.playing) replayPause();
+        else replayPlay();
+        emit("replay-toggle-play");
+        event.preventDefault();
+        return;
+      }
+    }
     switch (event.key) {
       case "Delete":
       case "Backspace": {
@@ -10959,7 +10975,11 @@ function createChart(element, options = {}) {
   const replayStep = (bars = 1) => {
     if (!replay) return;
     const step = Math.trunc(bars) || 1;
-    const next = clamp(replay.cursor + step, 0, replay.fullRaw.length - 1);
+    replaySeek(replay.cursor + step);
+  };
+  const replaySeek = (index) => {
+    if (!replay || !Number.isFinite(index)) return;
+    const next = clamp(Math.round(index), 0, replay.fullRaw.length - 1);
     if (next === replay.cursor) return;
     replay.cursor = next;
     applyReplaySlice();
@@ -11592,6 +11612,7 @@ function createChart(element, options = {}) {
     startReplay,
     stopReplay,
     replayStep,
+    replaySeek,
     replayPlay,
     replayPause,
     setReplaySpeed,

package/dist/index.d.cts

@@ -561,7 +561,7 @@ interface ChartContextMenuEvent {
     };
 }
 /** Built-in keyboard actions, reported after the chart applies them. */
-type ChartKeyboardAction = "delete-drawing" | "cancel" | "undo" | "redo" | "pan-left" | "pan-right" | "pan-up" | "pan-down" | "zoom-in" | "zoom-out" | "reset-viewport" | "scroll-to-realtime";
+type ChartKeyboardAction = "delete-drawing" | "cancel" | "undo" | "redo" | "pan-left" | "pan-right" | "pan-up" | "pan-down" | "zoom-in" | "zoom-out" | "reset-viewport" | "scroll-to-realtime" | "replay-step-forward" | "replay-step-back" | "replay-toggle-play";
 interface ChartKeyboardShortcutEvent {
     action: ChartKeyboardAction;
     /** The originating `KeyboardEvent.key`. */
@@ -583,6 +583,12 @@ interface KeyboardOptions {
     deleteSelectedDrawing?: boolean;
     /** Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z (or Ctrl+Y). Default true. */
     undoRedo?: boolean;
+    /**
+     * While replay is running, arrows step the tape (Shift steps 10) and Space
+     * toggles playback, instead of panning. Only applies during replay.
+     * Default true.
+     */
+    replay?: boolean;
 }
 /**
  * Deep zoom-out rendering. Once bars are narrower than `thresholdPx`, several
@@ -1035,6 +1041,11 @@ interface ChartInstance {
     stopReplay: () => void;
     /** Reveal `bars` more bars (negative rewinds). Default 1. */
     replayStep: (bars?: number) => void;
+    /**
+     * Jump straight to a bar index, for a scrubber or a "replay from here"
+     * action. Clamped to the series; playback continues from where it lands.
+     */
+    replaySeek: (index: number) => void;
     replayPlay: (speed?: number) => void;
     replayPause: () => void;
     /** Bars revealed per second. */

package/dist/index.d.ts

@@ -561,7 +561,7 @@ interface ChartContextMenuEvent {
     };
 }
 /** Built-in keyboard actions, reported after the chart applies them. */
-type ChartKeyboardAction = "delete-drawing" | "cancel" | "undo" | "redo" | "pan-left" | "pan-right" | "pan-up" | "pan-down" | "zoom-in" | "zoom-out" | "reset-viewport" | "scroll-to-realtime";
+type ChartKeyboardAction = "delete-drawing" | "cancel" | "undo" | "redo" | "pan-left" | "pan-right" | "pan-up" | "pan-down" | "zoom-in" | "zoom-out" | "reset-viewport" | "scroll-to-realtime" | "replay-step-forward" | "replay-step-back" | "replay-toggle-play";
 interface ChartKeyboardShortcutEvent {
     action: ChartKeyboardAction;
     /** The originating `KeyboardEvent.key`. */
@@ -583,6 +583,12 @@ interface KeyboardOptions {
     deleteSelectedDrawing?: boolean;
     /** Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z (or Ctrl+Y). Default true. */
     undoRedo?: boolean;
+    /**
+     * While replay is running, arrows step the tape (Shift steps 10) and Space
+     * toggles playback, instead of panning. Only applies during replay.
+     * Default true.
+     */
+    replay?: boolean;
 }
 /**
  * Deep zoom-out rendering. Once bars are narrower than `thresholdPx`, several
@@ -1035,6 +1041,11 @@ interface ChartInstance {
     stopReplay: () => void;
     /** Reveal `bars` more bars (negative rewinds). Default 1. */
     replayStep: (bars?: number) => void;
+    /**
+     * Jump straight to a bar index, for a scrubber or a "replay from here"
+     * action. Clamped to the series; playback continues from where it lands.
+     */
+    replaySeek: (index: number) => void;
     replayPlay: (speed?: number) => void;
     replayPause: () => void;
     /** Bars revealed per second. */

package/dist/index.js

@@ -10512,6 +10512,22 @@ function createChart(element, options = {}) {
     if (event.altKey || event.ctrlKey || event.metaKey) {
       return;
     }
+    if (replay && keyboard.replay !== false) {
+      if (event.key === "ArrowRight" || event.key === "ArrowLeft") {
+        const direction = event.key === "ArrowRight" ? 1 : -1;
+        replayStep(direction * (event.shiftKey ? 10 : 1));
+        emit(direction > 0 ? "replay-step-forward" : "replay-step-back");
+        event.preventDefault();
+        return;
+      }
+      if (event.key === " " || event.key === "Spacebar") {
+        if (replay.playing) replayPause();
+        else replayPlay();
+        emit("replay-toggle-play");
+        event.preventDefault();
+        return;
+      }
+    }
     switch (event.key) {
       case "Delete":
       case "Backspace": {
@@ -10923,7 +10939,11 @@ function createChart(element, options = {}) {
   const replayStep = (bars = 1) => {
     if (!replay) return;
     const step = Math.trunc(bars) || 1;
-    const next = clamp(replay.cursor + step, 0, replay.fullRaw.length - 1);
+    replaySeek(replay.cursor + step);
+  };
+  const replaySeek = (index) => {
+    if (!replay || !Number.isFinite(index)) return;
+    const next = clamp(Math.round(index), 0, replay.fullRaw.length - 1);
     if (next === replay.cursor) return;
     replay.cursor = next;
     applyReplaySlice();
@@ -11556,6 +11576,7 @@ function createChart(element, options = {}) {
     startReplay,
     stopReplay,
     replayStep,
+    replaySeek,
     replayPlay,
     replayPause,
     setReplaySpeed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperprop-charting-library",
-  "version": "0.1.144",
+  "version": "0.1.145",
   "description": "Lightweight TypeScript charting core",
   "type": "module",
   "main": "./dist/hyperprop-charting-library.cjs",