@nakednous/host 0.0.13 → 0.0.14

package/README.md

@@ -75,7 +75,7 @@ dependency first and an options object last, and registers with the context so
 | `host.pointer` | the pointer source — presses queued per frame, per-pointer entries with a move counter, claims that capture on the canvas, Esc cancel, `flush()` |
 | `host.players` | the registry ticked each frame — `{ tick(dt) → boolean }`, removed on `false` |
 | `host.width` · `host.height` · `host.dpr` | the canvas observer's logical size and pixel ratio |
-| `host.dt` · `host.clock()` | last frame period and seconds since creation |
+| `host.dt` · `host.clock()` | last frame period and seconds since creation — or since the `origin` the host was given, an epoch-ms instant a page passes so the figures it embeds share one start |
 | `host.handle(opts)` | `Handle` — a draggable core constraint (`SPHERE` · `PLANE` · `AXIS` · `DIAL` · `VIEW`, or a contract object); `update()`, `value(out, opts)`, snap, hover, cancel, `from` |
 | `host.router(handles, opts)` | `PointerRouter` — one shared pick over overlapping handles, nearest proxy wins; shared hover |
 | `host.cameraHelm(cam, opts)` · `host.poseHelm(opts)` | a core `PoseHelm` on the players: body-fly a camera state, or integrate into a pose in `WORLD` · `EYE` · `SELF` · a mat4 and `bind()` a target |

package/dist/index.js

@@ -402,7 +402,7 @@ function createPlayers() {
   return players;
 }
 
-const _now$2 = () => (typeof performance !== 'undefined' && performance.now) ? performance.now() : Date.now();
+const _now$1 = () => (typeof performance !== 'undefined' && performance.now) ? performance.now() : Date.now();
 
 /**
  * Create a frame loop. `onFrame(dt)` runs once per animation frame with the
@@ -418,7 +418,7 @@ function createLoop(opts) {
   const o = opts || {};
   const raf = o.raf || ((cb) => requestAnimationFrame(cb));
   const caf = o.caf || ((id) => cancelAnimationFrame(id));
-  const now = o.now || _now$2;
+  const now = o.now || _now$1;
   const clamp = (o.clampMs ?? 50) / 1000;
   let handle = null, last = 0;
   const loop = {
@@ -2717,7 +2717,7 @@ function createLabels(host, opts) {
 
 
 const _clamp = { min: 0, max: Infinity };
-const _now$1 = () => (typeof performance !== 'undefined' && performance.now) ? performance.now() : Date.now();
+const _now = () => (typeof performance !== 'undefined' && performance.now) ? performance.now() : Date.now();
 const EPS = 1e-4;        // a rate below this in every lane ends the drain
 const DT_MAX = 0.1;      // seconds, the measured frame's clamp
 
@@ -2801,7 +2801,7 @@ function createOrbit(host, cam, opts) {
      * @returns {boolean} Whether the camera moved.
      */
     update(dt) {
-      const now = _now$1();
+      const now = _now();
       if (typeof dt !== 'number') dt = lastNow ? Math.min((now - lastNow) / 1000, DT_MAX) : 0;
       lastNow = now;
       if (!orbit.enabled) { tracked.clear(); wheelAcc = 0; cancel(); wasPressed = false; return false; }
@@ -3112,8 +3112,9 @@ function decodeRGBE(bytes, opts) {
  * nothing grabbed, draw.
  */
 
-
-const _now = () => (typeof performance !== 'undefined' && performance.now) ? performance.now() : Date.now();
+// The clock's own reading: epoch milliseconds, so a host can be told where its
+// zero is. Monotonic where performance.now is, since timeOrigin never moves.
+const _epoch = () => (typeof performance !== 'undefined' && performance.timeOrigin) ? performance.timeOrigin + performance.now() : Date.now();
 
 /**
  * Create the host context of a canvas.
@@ -3121,7 +3122,8 @@ const _now = () => (typeof performance !== 'undefined' && performance.now) ? per
  * @param {HTMLCanvasElement} canvas
  * @param {{ ndcZMin?:number, onFrame?:function(number, object):void,
  *           afterFrame?:function(number, object):void, raf?:function,
- *           caf?:function, onSize?:function(number, number, number):void }} [opts]
+ *           caf?:function, onSize?:function(number, number, number):void,
+ *           origin?:number }} [opts]
  *        ndcZMin: the GPU API's NDC-z convention, WEBGL (default) or WEBGPU —
  *        written once, never detected. onFrame: the host's own loop; absent,
  *        external-tick mode. afterFrame: called after the pointer source
@@ -3130,12 +3132,14 @@ const _now = () => (typeof performance !== 'undefined' && performance.now) ? per
  *        command encoder there. The host's loop only: an external tick has
  *        no frame end but the one its caller writes. dispose() clears it.
  *        onSize(width, height, dpr): the bridge's chance to resize its
- *        drawing buffer.
+ *        drawing buffer. origin: the epoch-ms instant `clock()` counts from,
+ *        default the host's creation — pass a page's `performance.timeOrigin`
+ *        and the figures a page embeds share one start.
  * @returns {object} The host.
  */
 function createHost(canvas, opts) {
   const o = opts || {};
-  const t0 = _now();
+  const origin = (typeof o.origin === 'number' && Number.isFinite(o.origin)) ? o.origin : _epoch();
   const constructs = new Set();
   let loop = null, observer = null, labels = null;
   let afterFrame = typeof o.afterFrame === 'function' ? o.afterFrame : null;
@@ -3145,8 +3149,8 @@ function createHost(canvas, opts) {
     dt: 0,
     view: null, pointer: null, players: null,
 
-    /** Seconds since the host was created. */
-    clock() { return (_now() - t0) / 1000; },
+    /** Seconds since the host was created — or since the `origin` it was given. */
+    clock() { return (_epoch() - origin) / 1000; },
 
     /**
      * External-loop mode: tick the players with dt (seconds). The caller