@embedpdf/plugin-stage 3.0.0-next.5 → 3.0.0-next.6

package/dist/index.d.cts

@@ -186,6 +186,16 @@ interface VisiblePage extends PageBox {
 }
 interface StageState extends StageSettings {
   camera: Camera;
+  /**
+   * False while the ZOOM is in motion, true once it has rested (~150ms of
+   * frames without a zoom write). Device-snapping of page origins is gated
+   * on this: a continuous zoom and a snapped origin cannot coexist without
+   * the anchor point jittering ±0.5 device px per step (the rounding lands
+   * differently every frame), so pages place fractionally while zooming and
+   * snap once at rest — when crispness actually matters. Pans always snap
+   * (a pure translation snap has no anchor error). Transient like `camera`.
+   */
+  cameraResting: boolean;
   vp: Size;
   /**
    * Device pixels per view pixel (web: `window.devicePixelRatio`). Reported by
@@ -204,6 +214,9 @@ interface StageState extends StageSettings {
 type StageAction = {
   type: 'CAMERA';
   camera: Camera;
+} | {
+  type: 'CAMERA_REST';
+  resting: boolean;
 } | {
   type: 'VP';
   vp: Size;

package/dist/index.d.ts

@@ -186,6 +186,16 @@ interface VisiblePage extends PageBox {
 }
 interface StageState extends StageSettings {
   camera: Camera;
+  /**
+   * False while the ZOOM is in motion, true once it has rested (~150ms of
+   * frames without a zoom write). Device-snapping of page origins is gated
+   * on this: a continuous zoom and a snapped origin cannot coexist without
+   * the anchor point jittering ±0.5 device px per step (the rounding lands
+   * differently every frame), so pages place fractionally while zooming and
+   * snap once at rest — when crispness actually matters. Pans always snap
+   * (a pure translation snap has no anchor error). Transient like `camera`.
+   */
+  cameraResting: boolean;
   vp: Size;
   /**
    * Device pixels per view pixel (web: `window.devicePixelRatio`). Reported by
@@ -204,6 +214,9 @@ interface StageState extends StageSettings {
 type StageAction = {
   type: 'CAMERA';
   camera: Camera;
+} | {
+  type: 'CAMERA_REST';
+  resting: boolean;
 } | {
   type: 'VP';
   vp: Size;

package/dist/index.js

@@ -373,10 +373,37 @@ function createStageCapability(ctx, config = {}) {
 		fitAlign: ctx.getState().fitAlign,
 		direction: ctx.getState().direction
 	});
+	let hasPlaced = false;
+	const REST_MS = 150;
+	let restRaf = 0;
+	const armRest = () => {
+		if (!canAnimate || !hasPlaced) return;
+		if (ctx.getState().cameraResting) ctx.dispatch({
+			type: "CAMERA_REST",
+			resting: false
+		});
+		if (restRaf) scheduler.caf(restRaf);
+		let t0 = 0;
+		const tick = (ts) => {
+			restRaf = 0;
+			if (!t0) t0 = ts;
+			if (ts - t0 >= REST_MS) {
+				ctx.dispatch({
+					type: "CAMERA_REST",
+					resting: true
+				});
+				return;
+			}
+			restRaf = scheduler.raf(tick);
+		};
+		restRaf = scheduler.raf(tick);
+	};
 	const setCam = (next, bounds = stayBounds()) => {
+		const clamped = S.clampCamera(next, bounds, vp(), constraint());
+		if (clamped.zoom !== cam().zoom) armRest();
 		ctx.dispatch({
 			type: "CAMERA",
-			camera: S.clampCamera(next, bounds, vp(), constraint())
+			camera: clamped
 		});
 	};
 	/**
@@ -561,8 +588,11 @@ function createStageCapability(ctx, config = {}) {
 		} : unrotatedPoints(box);
 		const c = cam();
 		const ratio = dpr();
-		const screenX = snapToDevice((box.x - c.x) * c.zoom, ratio);
-		const screenY = snapToDevice((box.y - c.y) * c.zoom, ratio);
+		const rawX = (box.x - c.x) * c.zoom;
+		const rawY = (box.y - c.y) * c.zoom;
+		const resting = ctx.getState().cameraResting;
+		const screenX = resting ? snapToDevice(rawX, ratio) : rawX;
+		const screenY = resting ? snapToDevice(rawY, ratio) : rawY;
 		const transform = pageTransform({
 			pageSize,
 			rotation: box.rotation,
@@ -618,7 +648,7 @@ function createStageCapability(ctx, config = {}) {
 		const v = vp();
 		const sc = buildScene();
 		const items = paged() ? sc.items.slice(0, 1) : sc.query(S.cameraWorldRect(c, v));
-		const sig = `${sceneCache.key}|${ctx.getState().flow}|${c.x},${c.y},${c.zoom}|${v.width}x${v.height}|${dpr()}`;
+		const sig = `${sceneCache.key}|${ctx.getState().flow}|${c.x},${c.y},${c.zoom}|${v.width}x${v.height}|${dpr()}|r${ctx.getState().cameraResting ? 1 : 0}`;
 		if (sig === visSig) return vis;
 		visSig = sig;
 		vis = items.flatMap((it) => it.pages).map(withTransform);
@@ -631,7 +661,6 @@ function createStageCapability(ctx, config = {}) {
 	};
 	const snapshotSettings = () => pickSettings(ctx.getState());
 	const initialViewProviders = [];
-	let hasPlaced = false;
 	const api = {
 		camera: cam,
 		viewport: vp,
@@ -1031,6 +1060,7 @@ const initialStageState = (config) => {
 			y: 0,
 			zoom: 1
 		},
+		cameraResting: true,
 		vp: {
 			width: 0,
 			height: 0
@@ -1062,6 +1092,10 @@ const stageReducer = (state, a) => {
 			...state,
 			camera: a.camera
 		};
+		case "CAMERA_REST": return state.cameraResting === a.resting ? state : {
+			...state,
+			cameraResting: a.resting
+		};
 		case "VP": return {
 			...state,
 			vp: a.vp