Use only DOMHighResTimeStamp to calculate duration

Previously, we were combining Date.now() and DOMHighResTimeStamp values to calculate duration. These two value types use different clocks, so we should avoid combining the two value types where possible, since using two different clocks leaves us vulnerable to asymetrical issues. The native intersection observer uses DOMHighResTimeStamp, so we should use that type wherever possible in calculations.

This change also removes the native-* files, which are superseded by USE_NATIVE_IO and never part of the public API.

Thanks to @xg-wang for pointing out some potential issues affecting one clock and not the other, which could in turn cause asymmetrical bugs:
w3c/hr-time#115
mdn/content#4713

package.json

@@ -7,7 +7,7 @@
   "scripts": {
     "test": "tsc && yarn run build && yarn test:playwright && testem ci && node test/headless/run",
     "serve": "yarn run build && node test/headless/server/app",
-    "test:headless": "mocha --require @babel/register test/headless/specs/**/*.js --exit",
+    "test:headless": "mocha --require @babel/register test/headless/specs/**/*.js test/headless/specs/*.js --exit --timeout 5000",
     "test:playwright": "playwright test --config=test/playwright/playwright.config.ts",
     "watch": "broccoli-timepiece exports",
     "build": "./scripts/build.sh",

src/interfaces.ts

@@ -28,36 +28,69 @@ export interface SpanielObserverInit {
   USE_NATIVE_IO?: boolean;
 }
 
+export interface TimeCompat {
+  highResTime: number;
+  unixTime: number;
+}
+
 export interface SpanielRecord {
   target: SpanielTrackedElement;
   payload: any;
   thresholdStates: SpanielThresholdState[];
-  lastSeenEntry: IntersectionObserverEntry | null;
+  lastSeenEntry: InternalIntersectionObserverEntry | null;
 }
 
 export interface SpanielThresholdState {
   lastSatisfied: Boolean;
-  lastEntry: IntersectionObserverEntry | null;
+  lastEntry: InternalIntersectionObserverEntry | null;
   threshold: SpanielThreshold;
-  lastVisible: number;
+  lastVisible: TimeCompat;
   visible: boolean;
   timeoutId?: number;
 }
 
 export interface SpanielIntersectionObserverEntryInit {
-  time: DOMHighResTimeStamp;
+  highResTime: DOMHighResTimeStamp;
+  unixTime: number;
   rootBounds: DOMRectPojo;
   boundingClientRect: DOMRectPojo;
   intersectionRect: DOMRectPojo;
   target: SpanielTrackedElement;
 }
 
-export interface SpanielObserverEntry extends IntersectionObserverEntryInit {
+export interface SpanielRect extends DOMRectPojo {
+  readonly height: number;
+  readonly width: number;
+  readonly x: number;
+  readonly y: number;
+}
+
+export interface SpanielObserverEntry {
+  isIntersecting: boolean;
   duration: number;
+  visibleTime: number;
   intersectionRatio: number;
   entering: boolean;
   label?: string;
   payload?: any;
+  unixTime: number;
+  highResTime: number;
+  time: number;
+  target: Element;
+  boundingClientRect: SpanielRect;
+  intersectionRect: SpanielRect;
+  rootBounds: SpanielRect | null;
+}
+
+export interface InternalIntersectionObserverEntry {
+  time: number;
+  highResTime: DOMHighResTimeStamp;
+  target: Element;
+  boundingClientRect: SpanielRect;
+  intersectionRect: SpanielRect;
+  rootBounds: SpanielRect | null;
+  intersectionRatio: number;
+  isIntersecting: boolean;
 }
 
 export interface IntersectionObserverClass {

src/intersection-observer.ts

@@ -16,14 +16,15 @@ import { Frame, ElementScheduler, generateToken } from './metal/index';
 import {
   SpanielTrackedElement,
   DOMString,
-  DOMRectPojo,
   IntersectionObserverInit,
   DOMMargin,
-  SpanielIntersectionObserverEntryInit
+  SpanielIntersectionObserverEntryInit,
+  InternalIntersectionObserverEntry,
+  DOMRectPojo
 } from './interfaces';
 
 interface EntryEvent {
-  entry: IntersectionObserverEntry;
+  entry: InternalIntersectionObserverEntry;
   numSatisfiedThresholds: number;
 }
 
@@ -37,7 +38,7 @@ function marginToRect(margin: DOMMargin): DOMRectPojo {
     bottom,
     right,
     width: right - left,
-    height: bottom - top
+    height: bottom - top,
   };
 }
 
@@ -142,16 +143,17 @@ export class SpanielIntersectionObserver implements IntersectionObserver {
   }
 }
 
-function addRatio(entryInit: SpanielIntersectionObserverEntryInit): IntersectionObserverEntry {
-  const { time, rootBounds, boundingClientRect, intersectionRect, target } = entryInit;
+function addRatio(entryInit: SpanielIntersectionObserverEntryInit): InternalIntersectionObserverEntry {
+  const { unixTime, highResTime, rootBounds, boundingClientRect, intersectionRect, target } = entryInit;
   const boundingArea = boundingClientRect.height * boundingClientRect.width;
   const intersectionRatio = boundingArea > 0 ? (intersectionRect.width * intersectionRect.height) / boundingArea : 0;
 
   return {
-    time,
-    rootBounds: pojoToToDOMRectReadOnly(rootBounds),
-    boundingClientRect: pojoToToDOMRectReadOnly(boundingClientRect),
-    intersectionRect: pojoToToDOMRectReadOnly(intersectionRect),
+    time: unixTime,
+    highResTime,
+    rootBounds,
+    boundingClientRect,
+    intersectionRect,
     target,
     intersectionRatio,
     isIntersecting: calculateIsIntersecting({ intersectionRect })
@@ -183,28 +185,31 @@ export function generateEntry(
   clientRect: ClientRect,
   el: HTMLElement,
   rootMargin: DOMMargin
-): IntersectionObserverEntry {
+): InternalIntersectionObserverEntry {
   if (el.style.display === 'none') {
     return {
+      time: frame.dateNow,
+      highResTime: frame.highResTime,
       boundingClientRect: emptyRect(),
       intersectionRatio: 0,
       intersectionRect: emptyRect(),
       isIntersecting: false,
       rootBounds: emptyRect(),
-      target: el,
-      time: frame.timestamp
+      target: el
     };
   }
   let { bottom, right } = clientRect;
+  const left = frame.left + rootMargin.left;
+  const top = frame.top + rootMargin.top;
   let rootBounds: DOMRectPojo = {
-    left: frame.left + rootMargin.left,
-    top: frame.top + rootMargin.top,
-    x: frame.left + rootMargin.left,
-    y: frame.top + rootMargin.top,
+    left,
+    top,
     bottom: rootMargin.bottom,
     right: rootMargin.right,
     width: frame.width - (rootMargin.right + rootMargin.left),
-    height: frame.height - (rootMargin.bottom + rootMargin.top)
+    height: frame.height - (rootMargin.bottom + rootMargin.top),
+    y: top,
+    x: left
   };
 
   let intersectX = Math.max(rootBounds.left, clientRect.left);
@@ -213,20 +218,23 @@ export function generateEntry(
   let width = Math.min(rootBounds.left + rootBounds.width, clientRect.right) - intersectX;
   let height = Math.min(rootBounds.top + rootBounds.height, clientRect.bottom) - intersectY;
 
+  const interLeft = width >= 0 ? intersectX : 0;
+  const interTop = intersectY >= 0 ? intersectY : 0;
   let intersectionRect: DOMRectPojo = {
-    left: width >= 0 ? intersectX : 0,
-    top: intersectY >= 0 ? intersectY : 0,
-    x: width >= 0 ? intersectX : 0,
-    y: intersectY >= 0 ? intersectY : 0,
+    left: interLeft,
+    top: interTop,
+    x: interLeft,
+    y: interTop,
     width,
     height,
     right,
     bottom
   };
 
   return addRatio({
-    time: frame.timestamp,
-    rootBounds: pojoToToDOMRectReadOnly(rootBounds),
+    unixTime: frame.dateNow,
+    highResTime: frame.highResTime,
+    rootBounds,
     target: <SpanielTrackedElement>el,
     boundingClientRect: pojoToToDOMRectReadOnly(marginToRect(clientRect)),
     intersectionRect: pojoToToDOMRectReadOnly(intersectionRect)

src/metal/interfaces.ts

@@ -51,7 +51,8 @@ export interface ElementSchedulerInterface extends BaseSchedulerInterface {
 }
 
 export interface FrameInterface {
-  timestamp: number;
+  dateNow: number;
+  highResTime: DOMHighResTimeStamp;
   scrollTop: number;
   scrollLeft: number;
   width: number;

src/metal/scheduler.ts

@@ -33,7 +33,8 @@ let tokenCounter = 0;
 
 export class Frame implements FrameInterface {
   constructor(
-    public timestamp: number,
+    public dateNow: number,
+    public highResTime: number,
     public scrollTop: number,
     public scrollLeft: number,
     public width: number,
@@ -47,6 +48,7 @@ export class Frame implements FrameInterface {
     const rootMeta = this.revalidateRootMeta(root);
     return new Frame(
       Date.now(),
+      performance.now(),
       rootMeta.scrollTop,
       rootMeta.scrollLeft,
       rootMeta.width,