hyperprop-charting-library 0.1.122 → 0.1.123

package/dist/hyperprop-charting-library.cjs

@@ -222,6 +222,7 @@ var DEFAULT_OPTIONS = {
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
   timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -3639,7 +3640,8 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - last.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - last.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       return formatDuration(countdownMs);
     };
@@ -3893,7 +3895,8 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - lastPoint.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - lastPoint.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       const countdownText = formatDuration(countdownMs);
       const prevFont = ctx.font;

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

@@ -45,6 +45,14 @@ interface ChartOptions {
      * futures data with sparse back-month eras). 0/undefined = infer.
      */
     timeStepMs?: number;
+    /**
+     * Correction added to the machine's clock for time-sensitive rendering
+     * (bar-close countdowns): exchangeNow ≈ Date.now() + clockOffsetMs. Hosts
+     * should derive it from exchange-stamped ticks; without it a skewed local
+     * clock freezes the countdown at one full interval (bars arrive stamped
+     * "in the future") or makes it run visibly early/late.
+     */
+    clockOffsetMs?: number;
     pinOutOfRangeLines?: boolean;
     doubleClickEnabled?: boolean;
     doubleClickAction?: "reset" | "placeLimitOrder";

package/dist/hyperprop-charting-library.js

@@ -196,6 +196,7 @@ var DEFAULT_OPTIONS = {
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
   timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -3613,7 +3614,8 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - last.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - last.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       return formatDuration(countdownMs);
     };
@@ -3867,7 +3869,8 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - lastPoint.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - lastPoint.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       const countdownText = formatDuration(countdownMs);
       const prevFont = ctx.font;

package/dist/index.cjs

@@ -222,6 +222,7 @@ var DEFAULT_OPTIONS = {
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
   timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -3639,7 +3640,8 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - last.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - last.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       return formatDuration(countdownMs);
     };
@@ -3893,7 +3895,8 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - lastPoint.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - lastPoint.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       const countdownText = formatDuration(countdownMs);
       const prevFont = ctx.font;

package/dist/index.d.cts

@@ -45,6 +45,14 @@ interface ChartOptions {
      * futures data with sparse back-month eras). 0/undefined = infer.
      */
     timeStepMs?: number;
+    /**
+     * Correction added to the machine's clock for time-sensitive rendering
+     * (bar-close countdowns): exchangeNow ≈ Date.now() + clockOffsetMs. Hosts
+     * should derive it from exchange-stamped ticks; without it a skewed local
+     * clock freezes the countdown at one full interval (bars arrive stamped
+     * "in the future") or makes it run visibly early/late.
+     */
+    clockOffsetMs?: number;
     pinOutOfRangeLines?: boolean;
     doubleClickEnabled?: boolean;
     doubleClickAction?: "reset" | "placeLimitOrder";

package/dist/index.d.ts

@@ -45,6 +45,14 @@ interface ChartOptions {
      * futures data with sparse back-month eras). 0/undefined = infer.
      */
     timeStepMs?: number;
+    /**
+     * Correction added to the machine's clock for time-sensitive rendering
+     * (bar-close countdowns): exchangeNow ≈ Date.now() + clockOffsetMs. Hosts
+     * should derive it from exchange-stamped ticks; without it a skewed local
+     * clock freezes the countdown at one full interval (bars arrive stamped
+     * "in the future") or makes it run visibly early/late.
+     */
+    clockOffsetMs?: number;
     pinOutOfRangeLines?: boolean;
     doubleClickEnabled?: boolean;
     doubleClickAction?: "reset" | "placeLimitOrder";

package/dist/index.js

@@ -196,6 +196,7 @@ var DEFAULT_OPTIONS = {
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
   timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -3613,7 +3614,8 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - last.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - last.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       return formatDuration(countdownMs);
     };
@@ -3867,7 +3869,8 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const elapsedMs = Date.now() - lastPoint.time.getTime();
+      const nowMs = Date.now() + (Number(mergedOptions.clockOffsetMs) || 0);
+      const elapsedMs = nowMs - lastPoint.time.getTime();
       const countdownMs = elapsedMs >= 0 ? stepMs - elapsedMs % stepMs : Math.min(stepMs, stepMs - elapsedMs);
       const countdownText = formatDuration(countdownMs);
       const prevFont = ctx.font;

package/package.json

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