@embedpdf/plugin-stage 3.0.0-next.7 → 3.0.0-next.9

package/dist/index.d.cts

@@ -234,6 +234,13 @@ interface VisiblePage extends PageBox {
 }
 interface StageState extends StageSettings {
   camera: Camera;
+  /**
+   * One-way render-commit latch. False while the initial viewport-driven
+   * placement is unresolved; true only after its camera/settings writes have
+   * completed. Page/scroll screen-space selectors refuse to answer while
+   * false, so an adapter can never paint the placeholder camera at the origin.
+   */
+  placed: boolean;
   /**
    * Names of the responsive rules currently matching the box, in source order.
    * State (not derived) so `matches()` is reactive through the ordinary
@@ -271,6 +278,8 @@ type StageAction = {
 } | {
   type: 'CAMERA_REST';
   resting: boolean;
+} | {
+  type: 'PLACED';
 } | {
   type: 'VP';
   vp: Size;

package/dist/index.d.ts

@@ -234,6 +234,13 @@ interface VisiblePage extends PageBox {
 }
 interface StageState extends StageSettings {
   camera: Camera;
+  /**
+   * One-way render-commit latch. False while the initial viewport-driven
+   * placement is unresolved; true only after its camera/settings writes have
+   * completed. Page/scroll screen-space selectors refuse to answer while
+   * false, so an adapter can never paint the placeholder camera at the origin.
+   */
+  placed: boolean;
   /**
    * Names of the responsive rules currently matching the box, in source order.
    * State (not derived) so `matches()` is reactive through the ordinary
@@ -271,6 +278,8 @@ type StageAction = {
 } | {
   type: 'CAMERA_REST';
   resting: boolean;
+} | {
+  type: 'PLACED';
 } | {
   type: 'VP';
   vp: Size;

package/dist/index.js

@@ -529,7 +529,7 @@ function createStageCapability(ctx, config = {}) {
 		fitAlign: ctx.getState().fitAlign,
 		direction: ctx.getState().direction
 	});
-	let hasPlaced = false;
+	let placementStarted = false;
 	let gestureDepth = 0;
 	let gestureZoomed = false;
 	let gestureElastic = false;
@@ -537,7 +537,7 @@ function createStageCapability(ctx, config = {}) {
 	const REST_MS = 150;
 	let restRaf = 0;
 	const armRest = () => {
-		if (!canAnimate || !hasPlaced) return;
+		if (!canAnimate || !placementStarted) return;
 		if (ctx.getState().cameraResting) ctx.dispatch({
 			type: "CAMERA_REST",
 			resting: false
@@ -953,8 +953,19 @@ function createStageCapability(ctx, config = {}) {
 			visibleRect
 		};
 	};
+	const EMPTY_SCROLL_METRICS = {
+		scrollLeft: 0,
+		scrollTop: 0,
+		scrollWidth: 0,
+		scrollHeight: 0,
+		clientWidth: 0,
+		clientHeight: 0,
+		scrollableX: false,
+		scrollableY: false
+	};
 	let scrollMemo = null;
 	const scrollMetricsNow = () => {
+		if (!ctx.getState().placed) return EMPTY_SCROLL_METRICS;
 		const sc = buildScene();
 		const m = S.scrollMetrics(cam(), sc.itemCount ? stayBounds() : {
 			x: 0,
@@ -967,9 +978,11 @@ function createStageCapability(ctx, config = {}) {
 		scrollMemo = m;
 		return m;
 	};
+	const EMPTY_VISIBLE_PAGES = [];
 	let visSig = "";
 	let vis = [];
 	const visiblePages = () => {
+		if (!ctx.getState().placed) return EMPTY_VISIBLE_PAGES;
 		const c = cam();
 		const v = vp();
 		const sc = buildScene();
@@ -1070,6 +1083,7 @@ function createStageCapability(ctx, config = {}) {
 			label: p.label ?? null
 		})),
 		pageRect: (pon) => {
+			if (!ctx.getState().placed) return null;
 			const meta = ctx.document();
 			const index = meta ? meta.pages.findIndex((p) => p.pageObjectNumber === pon) : -1;
 			if (index < 0) return null;
@@ -1170,7 +1184,7 @@ function createStageCapability(ctx, config = {}) {
 			anchor: currentAnchor()
 		}),
 		setViewport: (v) => {
-			if (!hasPlaced) {
+			if (!placementStarted) {
 				ctx.dispatch({
 					type: "VP",
 					vp: v
@@ -1304,7 +1318,7 @@ function createStageCapability(ctx, config = {}) {
 		fitAll: () => api.update({ zoom: { mode: S.ZoomMode.FitAll } }),
 		automatic: () => api.update({ zoom: { mode: S.ZoomMode.Automatic } }),
 		refit: () => {
-			if (!hasPlaced) return;
+			if (!placementStarted) return;
 			cancelAnim();
 			reapply(currentAnchor());
 		},
@@ -1431,16 +1445,18 @@ function createStageCapability(ctx, config = {}) {
 			});
 		},
 		placeInitial: () => {
-			hasPlaced = true;
+			placementStarted = true;
 			const sorted = [...initialViewProviders].sort((a, b) => b.priority - a.priority);
 			for (const p of sorted) {
 				const view = p.fn();
 				if (view) {
 					api.applyViewState(view);
+					ctx.dispatch({ type: "PLACED" });
 					return;
 				}
 			}
 			api.resetView();
+			ctx.dispatch({ type: "PLACED" });
 		},
 		resetView: () => goToTarget(0, { behavior: "instant" })
 	};
@@ -1476,6 +1492,7 @@ const initialStageState = (config) => {
 			y: 0,
 			zoom: 1
 		},
+		placed: false,
 		cameraResting: true,
 		vp: {
 			width: 0,
@@ -1513,6 +1530,10 @@ const stageReducer = (state, a) => {
 			...state,
 			cameraResting: a.resting
 		};
+		case "PLACED": return state.placed ? state : {
+			...state,
+			placed: true
+		};
 		case "VP": return {
 			...state,
 			vp: a.vp