hyperprop-charting-library 0.1.121 → 0.1.123

package/dist/hyperprop-charting-library.cjs

@@ -221,6 +221,8 @@ var DEFAULT_OPTIONS = {
   autoScaleSmoothing: 0,
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
+  timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -1720,11 +1722,16 @@ function createChart(element, options = {}) {
     return Array.from(dedupedByTime.values()).sort((a, b) => a.time.getTime() - b.time.getTime());
   };
   const getTimeStepMs = () => {
+    const configured = Number(mergedOptions.timeStepMs);
+    if (Number.isFinite(configured) && configured > 0) {
+      return configured;
+    }
     if (data.length < 2) {
       return 24 * 60 * 60 * 1e3;
     }
     const deltas = [];
-    for (let index = 1; index < Math.min(data.length, 40); index += 1) {
+    const first = Math.max(1, data.length - 40);
+    for (let index = first; index < data.length; index += 1) {
       const previous = data[index - 1];
       const current = data[index];
       if (!previous || !current) {
@@ -3633,8 +3640,9 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = last.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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);
     };
     const ticker = mergedOptions.tickerLine ?? DEFAULT_OPTIONS.tickerLine;
@@ -3887,8 +3895,9 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = lastPoint.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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;
       ctx.font = `${xAxisFontSize}px ${mergedOptions.fontFamily}`;

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

@@ -37,6 +37,22 @@ interface ChartOptions {
         touch?: boolean;
         mouse?: boolean;
     };
+    /**
+     * Authoritative bar interval in milliseconds. When set, the bar-close
+     * countdown, time extrapolation beyond the last bar, and axis density use
+     * this exact step instead of inferring it from bar spacing (inference can
+     * mis-read series whose deep history has gaps, e.g. session-aligned 4h
+     * 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

@@ -195,6 +195,8 @@ var DEFAULT_OPTIONS = {
   autoScaleSmoothing: 0,
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
+  timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -1694,11 +1696,16 @@ function createChart(element, options = {}) {
     return Array.from(dedupedByTime.values()).sort((a, b) => a.time.getTime() - b.time.getTime());
   };
   const getTimeStepMs = () => {
+    const configured = Number(mergedOptions.timeStepMs);
+    if (Number.isFinite(configured) && configured > 0) {
+      return configured;
+    }
     if (data.length < 2) {
       return 24 * 60 * 60 * 1e3;
     }
     const deltas = [];
-    for (let index = 1; index < Math.min(data.length, 40); index += 1) {
+    const first = Math.max(1, data.length - 40);
+    for (let index = first; index < data.length; index += 1) {
       const previous = data[index - 1];
       const current = data[index];
       if (!previous || !current) {
@@ -3607,8 +3614,9 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = last.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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);
     };
     const ticker = mergedOptions.tickerLine ?? DEFAULT_OPTIONS.tickerLine;
@@ -3861,8 +3869,9 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = lastPoint.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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;
       ctx.font = `${xAxisFontSize}px ${mergedOptions.fontFamily}`;

package/dist/index.cjs

@@ -221,6 +221,8 @@ var DEFAULT_OPTIONS = {
   autoScaleSmoothing: 0,
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
+  timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -1720,11 +1722,16 @@ function createChart(element, options = {}) {
     return Array.from(dedupedByTime.values()).sort((a, b) => a.time.getTime() - b.time.getTime());
   };
   const getTimeStepMs = () => {
+    const configured = Number(mergedOptions.timeStepMs);
+    if (Number.isFinite(configured) && configured > 0) {
+      return configured;
+    }
     if (data.length < 2) {
       return 24 * 60 * 60 * 1e3;
     }
     const deltas = [];
-    for (let index = 1; index < Math.min(data.length, 40); index += 1) {
+    const first = Math.max(1, data.length - 40);
+    for (let index = first; index < data.length; index += 1) {
       const previous = data[index - 1];
       const current = data[index];
       if (!previous || !current) {
@@ -3633,8 +3640,9 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = last.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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);
     };
     const ticker = mergedOptions.tickerLine ?? DEFAULT_OPTIONS.tickerLine;
@@ -3887,8 +3895,9 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = lastPoint.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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;
       ctx.font = `${xAxisFontSize}px ${mergedOptions.fontFamily}`;

package/dist/index.d.cts

@@ -37,6 +37,22 @@ interface ChartOptions {
         touch?: boolean;
         mouse?: boolean;
     };
+    /**
+     * Authoritative bar interval in milliseconds. When set, the bar-close
+     * countdown, time extrapolation beyond the last bar, and axis density use
+     * this exact step instead of inferring it from bar spacing (inference can
+     * mis-read series whose deep history has gaps, e.g. session-aligned 4h
+     * 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

@@ -37,6 +37,22 @@ interface ChartOptions {
         touch?: boolean;
         mouse?: boolean;
     };
+    /**
+     * Authoritative bar interval in milliseconds. When set, the bar-close
+     * countdown, time extrapolation beyond the last bar, and axis density use
+     * this exact step instead of inferring it from bar spacing (inference can
+     * mis-read series whose deep history has gaps, e.g. session-aligned 4h
+     * 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

@@ -195,6 +195,8 @@ var DEFAULT_OPTIONS = {
   autoScaleSmoothing: 0,
   autoScaleIgnoreLatestCandle: true,
   kineticScroll: { touch: true, mouse: false },
+  timeStepMs: 0,
+  clockOffsetMs: 0,
   pinOutOfRangeLines: false,
   doubleClickEnabled: true,
   doubleClickAction: "reset",
@@ -1694,11 +1696,16 @@ function createChart(element, options = {}) {
     return Array.from(dedupedByTime.values()).sort((a, b) => a.time.getTime() - b.time.getTime());
   };
   const getTimeStepMs = () => {
+    const configured = Number(mergedOptions.timeStepMs);
+    if (Number.isFinite(configured) && configured > 0) {
+      return configured;
+    }
     if (data.length < 2) {
       return 24 * 60 * 60 * 1e3;
     }
     const deltas = [];
-    for (let index = 1; index < Math.min(data.length, 40); index += 1) {
+    const first = Math.max(1, data.length - 40);
+    for (let index = first; index < data.length; index += 1) {
       const previous = data[index - 1];
       const current = data[index];
       if (!previous || !current) {
@@ -3607,8 +3614,9 @@ function createChart(element, options = {}) {
         return null;
       }
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = last.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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);
     };
     const ticker = mergedOptions.tickerLine ?? DEFAULT_OPTIONS.tickerLine;
@@ -3861,8 +3869,9 @@ function createChart(element, options = {}) {
     }
     if (labels.visible && labels.showCountdownToBarClose && lastPoint) {
       const stepMs = getTimeStepMs();
-      const rawRemainingMs = lastPoint.time.getTime() + stepMs - Date.now();
-      const countdownMs = rawRemainingMs >= 0 && rawRemainingMs <= stepMs * 2 ? rawRemainingMs : stepMs - Date.now() % stepMs;
+      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;
       ctx.font = `${xAxisFontSize}px ${mergedOptions.fontFamily}`;

package/package.json

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