@getuserfeedback/protocol 3.0.10 → 3.0.11

package/dist/host/widget-layout-transition-plan.d.ts

@@ -14,6 +14,7 @@ export type WidgetLayoutInstantTransitionPlan = {
     settledAtMs: number;
 };
 export type WidgetLayoutTransitionPlan = WidgetLayoutUnchangedTransitionPlan | WidgetLayoutInstantTransitionPlan;
+export declare function getWidgetLayoutPlanNowMs(): number;
 export declare function areWidgetLayoutSizeUpdatesEqual(left: WidgetLayoutComparableSizeUpdate | undefined, right: WidgetLayoutComparableSizeUpdate): boolean;
 export declare function planWidgetLayoutTransition(input: {
     previous?: WidgetLayoutSizeUpdate;

package/dist/host/widget-layout-transition-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-layout-transition-plan.d.ts","sourceRoot":"","sources":["../../src/host/widget-layout-transition-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,gCAAgC,GACzC,sBAAsB,GACtB,2BAA2B,CAAC;AAE/B,MAAM,MAAM,mCAAmC,GAAG;IACjD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GACnC,mCAAmC,GACnC,iCAAiC,CAAC;AAErC,wBAAgB,+BAA+B,CAC9C,IAAI,EAAE,gCAAgC,GAAG,SAAS,EAClD,KAAK,EAAE,gCAAgC,GACrC,OAAO,CAiCT;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACd,GAAG,0BAA0B,CAyB7B"}
+{"version":3,"file":"widget-layout-transition-plan.d.ts","sourceRoot":"","sources":["../../src/host/widget-layout-transition-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,gCAAgC,GACzC,sBAAsB,GACtB,2BAA2B,CAAC;AAE/B,MAAM,MAAM,mCAAmC,GAAG;IACjD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GACnC,mCAAmC,GACnC,iCAAiC,CAAC;AAErC,wBAAgB,wBAAwB,IAAI,MAAM,CAQjD;AAED,wBAAgB,+BAA+B,CAC9C,IAAI,EAAE,gCAAgC,GAAG,SAAS,EAClD,KAAK,EAAE,gCAAgC,GACrC,OAAO,CAiCT;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACd,GAAG,0BAA0B,CAyB7B"}

package/dist/host/widget-layout-transition-plan.js

@@ -1,3 +1,11 @@
+export function getWidgetLayoutPlanNowMs() {
+    const performanceNow = typeof globalThis.performance?.now === "function"
+        ? globalThis.performance.now()
+        : undefined;
+    return typeof performanceNow === "number" && Number.isFinite(performanceNow)
+        ? performanceNow
+        : Date.now();
+}
 export function areWidgetLayoutSizeUpdatesEqual(left, right) {
     if (left?.size.width !== right.size.width ||
         left.size.height !== right.size.height ||

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@getuserfeedback/protocol",
-	"version": "3.0.10",
+	"version": "3.0.11",
 	"description": "getuserfeedback widget protocol — host surface and (later) wire protocol",
 	"keywords": [
 		"getuserfeedback",

package/src/host/widget-layout-transition-plan.test.ts

@@ -5,10 +5,70 @@ import {
 } from "./widget-layout-size-update.js";
 import {
 	areWidgetLayoutSizeUpdatesEqual,
+	getWidgetLayoutPlanNowMs,
 	planWidgetLayoutTransition,
 } from "./widget-layout-transition-plan.js";
 
 describe("widget layout transition plan", () => {
+	test("uses the browser monotonic clock for layout plan timestamps", () => {
+		const originalPerformanceDescriptor = Object.getOwnPropertyDescriptor(
+			globalThis,
+			"performance",
+		);
+
+		try {
+			Object.defineProperty(globalThis, "performance", {
+				configurable: true,
+				value: {
+					now: () => 123.45,
+				},
+			});
+
+			expect(getWidgetLayoutPlanNowMs()).toBe(123.45);
+		} finally {
+			if (originalPerformanceDescriptor) {
+				Object.defineProperty(
+					globalThis,
+					"performance",
+					originalPerformanceDescriptor,
+				);
+			} else {
+				Reflect.deleteProperty(globalThis, "performance");
+			}
+		}
+	});
+
+	test("falls back to Date.now when the monotonic clock is unavailable", () => {
+		const originalNow = Date.now;
+		const originalPerformanceDescriptor = Object.getOwnPropertyDescriptor(
+			globalThis,
+			"performance",
+		);
+
+		try {
+			Date.now = () => 1_700;
+			Object.defineProperty(globalThis, "performance", {
+				configurable: true,
+				value: {
+					now: () => Number.NaN,
+				},
+			});
+
+			expect(getWidgetLayoutPlanNowMs()).toBe(1_700);
+		} finally {
+			Date.now = originalNow;
+			if (originalPerformanceDescriptor) {
+				Object.defineProperty(
+					globalThis,
+					"performance",
+					originalPerformanceDescriptor,
+				);
+			} else {
+				Reflect.deleteProperty(globalThis, "performance");
+			}
+		}
+	});
+
 	test("plans the first instant layout update at the requested time", () => {
 		const next = toInstantWidgetLayoutSizeUpdate({ width: 320, height: 240 });
 

package/src/host/widget-layout-transition-plan.ts

@@ -27,6 +27,16 @@ export type WidgetLayoutTransitionPlan =
 	| WidgetLayoutUnchangedTransitionPlan
 	| WidgetLayoutInstantTransitionPlan;
 
+export function getWidgetLayoutPlanNowMs(): number {
+	const performanceNow =
+		typeof globalThis.performance?.now === "function"
+			? globalThis.performance.now()
+			: undefined;
+	return typeof performanceNow === "number" && Number.isFinite(performanceNow)
+		? performanceNow
+		: Date.now();
+}
+
 export function areWidgetLayoutSizeUpdatesEqual(
 	left: WidgetLayoutComparableSizeUpdate | undefined,
 	right: WidgetLayoutComparableSizeUpdate,