@embedpdf/engine-core 3.0.0-next.7 → 3.0.0-next.9

package/dist/conformance.js

@@ -1,7 +1,7 @@
-import { f as pdfQuadBounds, i as EngineError, n as foldText, u as isRotatedGeometryRun } from "./fold-DemV94jf.js";
-import { a as sliceTextByChars, d as EngineErrorCode } from "./charmap-CUukAMhR.js";
-import { t as AbortError } from "./AbortError-BsHuCO1S.js";
-import { A as FormSetValueResultSchema, At as AnnotationDTOSchema, B as PageDeleteResultSchema, G as PageListSnapshotSchema, H as PageFlattenResultSchema, O as FormImportResultSchema, Q as PageRotateResultSchema, U as PageGeometrySnapshotSchema, a as AnnotationCreateResultSchema, c as AnnotationListPageSnapshotSchema, d as AnnotationUpdateResultSchema, k as FormRepairResultSchema, l as AnnotationListSnapshotAllPagesSchema, o as AnnotationDeleteResultSchema, q as PageMoveResultSchema, rt as RedactionApplyResultSchema, tt as PageTextSnapshotSchema, u as AnnotationMoveResultSchema, ur as DocumentActionsSnapshotSchema, ut as SearchSliceSchema, wt as FormSnapshotSchema } from "./schemas-ES6-TkIl.js";
+import { f as pdfQuadBounds, i as EngineError, n as foldText, u as isRotatedGeometryRun } from "./fold-BfyxxwS6.js";
+import { f as EngineErrorCode, o as sliceTextByChars } from "./PageInsertBlankInput-WKY0tr6S.js";
+import { t as AbortError } from "./AbortError-8-9JAX1Y.js";
+import { A as FormSetValueResultSchema, B as PageDeleteResultSchema, O as FormImportResultSchema, Ot as FormSnapshotSchema, Pt as AnnotationDTOSchema, U as PageFlattenResultSchema, W as PageGeometrySnapshotSchema, Y as PageListSnapshotSchema, Z as PageMoveResultSchema, a as AnnotationCreateResultSchema, at as PageTextSnapshotSchema, c as AnnotationListPageSnapshotSchema, d as AnnotationUpdateResultSchema, k as FormRepairResultSchema, l as AnnotationListSnapshotAllPagesSchema, mr as DocumentActionsSnapshotSchema, mt as SearchSliceSchema, nt as PageRotateResultSchema, o as AnnotationDeleteResultSchema, st as RedactionApplyResultSchema, u as AnnotationMoveResultSchema } from "./schemas-BKRZZ-g1.js";
 //#region src/conformance/runMetadataConformance.ts
 /**
 * The conformance harness is transport-agnostic. It takes the test runner as
@@ -18,7 +18,7 @@ function runMetadataConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("reads metadata from sample fixture", async () => {
-			const doc = await openFixture$16(engine, opts);
+			const doc = await openFixture$17(engine, opts);
 			try {
 				const meta = await doc.metadata.read();
 				expect(meta).toMatchObject(opts.fixture.expected);
@@ -28,7 +28,7 @@ function runMetadataConformance(runner, opts) {
 			}
 		});
 		test("abort() before completion rejects with AbortError", async () => {
-			const doc = await openFixture$16(engine, opts);
+			const doc = await openFixture$17(engine, opts);
 			try {
 				const p = doc.metadata.read();
 				p.abort("test");
@@ -38,7 +38,7 @@ function runMetadataConformance(runner, opts) {
 			}
 		});
 		test("aborting one read does not affect a concurrent one", async () => {
-			const doc = await openFixture$16(engine, opts);
+			const doc = await openFixture$17(engine, opts);
 			try {
 				const a = doc.metadata.read();
 				const b = doc.metadata.read();
@@ -50,7 +50,7 @@ function runMetadataConformance(runner, opts) {
 			}
 		});
 		test("metadata after close throws DocNotOpen", async () => {
-			const doc = await openFixture$16(engine, opts);
+			const doc = await openFixture$17(engine, opts);
 			await doc.close();
 			let caught;
 			try {
@@ -62,7 +62,7 @@ function runMetadataConformance(runner, opts) {
 			expect(EngineError.is(caught, EngineErrorCode.DocNotOpen)).toBe(true);
 		});
 		test("update() sets standard + custom fields and a subsequent read observes them", async () => {
-			const doc = await openFixture$16(engine, opts);
+			const doc = await openFixture$17(engine, opts);
 			try {
 				const result = await doc.metadata.update({
 					title: "Conformance Title",
@@ -81,7 +81,7 @@ function runMetadataConformance(runner, opts) {
 			}
 		});
 		test("update() clears a field with null", async () => {
-			const doc = await openFixture$16(engine, opts);
+			const doc = await openFixture$17(engine, opts);
 			try {
 				await doc.metadata.update({ title: "To Be Cleared" });
 				const set = await doc.metadata.read();
@@ -94,7 +94,7 @@ function runMetadataConformance(runner, opts) {
 			}
 		});
 		test("update() after close throws DocNotOpen", async () => {
-			const doc = await openFixture$16(engine, opts);
+			const doc = await openFixture$17(engine, opts);
 			await doc.close();
 			let caught;
 			try {
@@ -107,7 +107,7 @@ function runMetadataConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$16(engine, opts) {
+async function openFixture$17(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -134,7 +134,7 @@ function runAnnotationReadConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("listRawAll returns one entry per page with valid PageState", async () => {
-			const doc = await openFixture$15(engine, opts);
+			const doc = await openFixture$16(engine, opts);
 			try {
 				const snap = await doc.annotations.listRawAll();
 				expect(AnnotationListSnapshotAllPagesSchema.safeParse(snap).success).toBe(true);
@@ -147,7 +147,7 @@ function runAnnotationReadConformance(runner, opts) {
 			}
 		});
 		test("listRaw on the test page returns the expected counts and DTO shape", async () => {
-			const doc = await openFixture$15(engine, opts);
+			const doc = await openFixture$16(engine, opts);
 			try {
 				const snap = await doc.annotations.listRaw(opts.fixture.pageObjectNumber);
 				expect(AnnotationListPageSnapshotSchema.safeParse(snap).success).toBe(true);
@@ -177,7 +177,7 @@ function runAnnotationReadConformance(runner, opts) {
 			}
 		});
 		test("shape/vertex/line annotations expose their family fields", async () => {
-			const doc = await openFixture$15(engine, opts);
+			const doc = await openFixture$16(engine, opts);
 			try {
 				const snap = await doc.annotations.listRaw(opts.fixture.pageObjectNumber);
 				for (const a of snap.annotations) {
@@ -236,7 +236,7 @@ function runAnnotationReadConformance(runner, opts) {
 			}
 		});
 		test("full page list dispatches per-subtype and matches raw counts", async () => {
-			const doc = await openFixture$15(engine, opts);
+			const doc = await openFixture$16(engine, opts);
 			try {
 				const full = await doc.page(opts.fixture.pageObjectNumber).annotations.list();
 				expect(AnnotationListPageSnapshotSchema.safeParse(full).success).toBe(true);
@@ -246,7 +246,7 @@ function runAnnotationReadConformance(runner, opts) {
 			}
 		});
 		test("every annotation DTO satisfies AnnotationDTOSchema (discriminated union)", async () => {
-			const doc = await openFixture$15(engine, opts);
+			const doc = await openFixture$16(engine, opts);
 			try {
 				const snap = await doc.annotations.listRaw(opts.fixture.pageObjectNumber);
 				for (const a of snap.annotations) {
@@ -286,7 +286,7 @@ function runAnnotationReadConformance(runner, opts) {
 		});
 		if (opts.fixture.expectsWeakAnnotation) {
 			test("weak annotations carry identityQuality: weak and ref.kind: index", async () => {
-				const doc = await openFixture$15(engine, opts);
+				const doc = await openFixture$16(engine, opts);
 				try {
 					const weak = (await doc.annotations.listRaw(opts.fixture.pageObjectNumber)).annotations.find((a) => a.identityQuality === "weak");
 					expect(weak !== void 0).toBe(true);
@@ -296,7 +296,7 @@ function runAnnotationReadConformance(runner, opts) {
 				}
 			});
 			test("a stale revision token throws InvalidReference", async () => {
-				const doc = await openFixture$15(engine, opts);
+				const doc = await openFixture$16(engine, opts);
 				try {
 					const snap = await doc.page(opts.fixture.pageObjectNumber).annotations.list();
 					const weak = snap.annotations.find((a) => a.identityQuality === "weak");
@@ -312,7 +312,7 @@ function runAnnotationReadConformance(runner, opts) {
 			});
 		}
 		test("abort() on listRaw rejects with AbortError", async () => {
-			const doc = await openFixture$15(engine, opts);
+			const doc = await openFixture$16(engine, opts);
 			try {
 				const p = doc.annotations.listRaw(opts.fixture.pageObjectNumber);
 				p.abort("test");
@@ -322,7 +322,7 @@ function runAnnotationReadConformance(runner, opts) {
 			}
 		});
 		test("listRaw on an unknown pageObjectNumber throws NotFound", async () => {
-			const doc = await openFixture$15(engine, opts);
+			const doc = await openFixture$16(engine, opts);
 			try {
 				let caught;
 				try {
@@ -338,7 +338,7 @@ function runAnnotationReadConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$15(engine, opts) {
+async function openFixture$16(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -596,7 +596,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("create appends without shifting indices and leaves weak refs valid", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const before = await page.annotations.list();
@@ -632,7 +632,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create + update honor annotation flags (set on create, merge on patch)", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const draft = {
@@ -667,7 +667,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create shape annotations (circle + square) round-trip shape fields", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const circleDraft = {
@@ -748,7 +748,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("cloudy border (/BE) + rect differences (/RD) are tri-state", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const plainDraft = {
@@ -827,7 +827,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update echoes the appearance verdict: moves preserve /AP, restyles re-bake", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const draft = {
@@ -902,7 +902,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("a partial /DA patch preserves the unpatched font members", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const draft = {
@@ -958,7 +958,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("box transform is tri-state: rect-only moves keep rotation, null flattens", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const draft = {
@@ -1019,7 +1019,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create vertex + line annotations (polygon/polyline/line) round-trip geometry", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const polygonDraft = {
@@ -1150,7 +1150,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create free-text + callout round-trip text/colour/intent fields", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const freeTextDraft = {
@@ -1246,7 +1246,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update a free-text patches alignment + colours and is non-structural", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -1307,7 +1307,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create redact (area + text) round-trips label + colour fields", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const areaDraft = {
@@ -1387,7 +1387,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update a redact patches the label and clears it, non-structurally", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -1464,7 +1464,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create + update a caret round-trips color/opacity/rect differences", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const caretDraft = {
@@ -1544,7 +1544,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update an ink annotation patches strokes + color and is non-structural", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -1595,7 +1595,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("ink highlight intent + blend round-trip and unrelated patches preserve blend", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -1638,7 +1638,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update a polyline patches vertices + line endings and is non-structural", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -1687,7 +1687,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update a shape annotation patches color and is non-structural", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -1736,7 +1736,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		if (opts.supportsAppearanceRasters) test("creating a shape bakes an /AP appearance the reader can rasterize", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -1766,7 +1766,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update on a durable annotation is non-structural and never touches /NM", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const before = await page.annotations.list();
@@ -1792,7 +1792,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		if (fix.expectsWeakAnnotation) test("update on a weak annotation stamps a UUID v4 /NM and upgrades the ref", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const before = await page.annotations.list();
@@ -1822,7 +1822,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("delete by objectNumber removes the annotation and reports a stable id", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const draft = {
@@ -1852,7 +1852,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		if (fix.expectsWeakAnnotation) test("delete by index of a weak annotation reports deleted: null and refetch reason", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const weak = (await page.annotations.list()).annotations.find((a) => a.identityQuality === "weak");
@@ -1875,7 +1875,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("abort on create rejects with AbortError", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const draft = {
@@ -1891,7 +1891,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("update with a stale index revision throws InvalidReference", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const weak = (await page.annotations.list()).annotations.find((a) => a.identityQuality === "weak");
@@ -1918,7 +1918,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("move single durable annotation reorders within the page (single-as-batch)", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const aDraft = {
@@ -1962,7 +1962,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("move multi-block preserves caller-supplied order at the destination", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const ids = await Promise.all([
@@ -2001,7 +2001,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		if (fix.expectsWeakAnnotation) test("move on a weak annotation upgrades it to durable /NM (one rev bump for batch)", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const before = await page.annotations.list();
@@ -2026,7 +2026,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("move with a stale index revision rejects (locked rev-token guard)", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const a = await page.annotations.create({
@@ -2064,7 +2064,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("move with out-of-range toIndex rejects with InvalidArg", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const a = await page.annotations.create({
@@ -2088,7 +2088,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("move with duplicate refs rejects with InvalidArg", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const a = await page.annotations.create({
@@ -2111,7 +2111,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("abort on move rejects with AbortError", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const a = await page.annotations.create({
@@ -2132,7 +2132,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("a page move does NOT bump per-page RevisionTokens (weak refs survive reorder)", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 1) return;
@@ -2147,7 +2147,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create a reply links /IRT and defaults /RT to \"reply\", reporting the parent", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const parent = await page.annotations.create({
@@ -2181,7 +2181,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create a grouped subordinate writes /RT /Group", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const primary = await page.annotations.create({
@@ -2212,7 +2212,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create link annotations round-trip uri, goto/xyz, goto/fitH, and dead targets", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const uri = await page.annotations.create({
@@ -2289,7 +2289,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("a link patch retargets in both directions (uri→goto, goto→uri) and moves the rect", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -2344,7 +2344,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("a link patch clears the target with null — a dead link on re-read", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const created = await page.annotations.create({
@@ -2383,7 +2383,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("a link grouped to a highlight round-trips /IRT + /RT /Group with its target", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const parent = await page.annotations.create({
@@ -2417,7 +2417,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("replace-text round-trips /IT and groups StrikeOut under its Caret", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const caret = await page.annotations.create({
@@ -2469,7 +2469,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("patch inReplyTo: null clears /IRT and /RT (back to top-level)", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const parent = await page.annotations.create({
@@ -2496,7 +2496,7 @@ function runAnnotationMutationConformance(runner, opts) {
 			}
 		});
 		test("create with a cross-page /IRT parent throws InvalidArg", async () => {
-			const doc = await openFixture$14(engine, opts);
+			const doc = await openFixture$15(engine, opts);
 			try {
 				const page = doc.page(fix.pageObjectNumber);
 				const parent = await page.annotations.create({
@@ -2532,7 +2532,7 @@ async function beginWeakEditIfRequired(doc, pageObjectNumber, fix) {
 	if (doc.capabilities.weakAnnotationEditSessions !== "required" || !fix.expectsWeakAnnotation) return null;
 	return doc.annotations.beginWeakEdit([pageObjectNumber]);
 }
-async function openFixture$14(engine, opts) {
+async function openFixture$15(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -3122,7 +3122,7 @@ function runAnnotationAppearanceConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("renders the expected set of appearances with valid output", async () => {
-			const doc = await openFixture$13(engine, opts);
+			const doc = await openFixture$14(engine, opts);
 			try {
 				const { pageState, appearances } = await collect(doc, opts, useRaw);
 				expect(pageState.pageObjectNumber).toBe(opts.fixture.pageObjectNumber);
@@ -3149,7 +3149,7 @@ function runAnnotationAppearanceConformance(runner, opts) {
 			}
 		});
 		if (opts.fixture.expectsWeakAppearance) test("weak (index-only) annotations are emitted, not dropped", async () => {
-			const doc = await openFixture$13(engine, opts);
+			const doc = await openFixture$14(engine, opts);
 			try {
 				const { appearances } = await collect(doc, opts, useRaw);
 				const weak = appearances.find((a) => a.ref.kind === "index");
@@ -3159,7 +3159,7 @@ function runAnnotationAppearanceConformance(runner, opts) {
 			}
 		});
 		if (useRaw) test("rendered appearances are not blank (non-zero alpha)", async () => {
-			const doc = await openFixture$13(engine, opts);
+			const doc = await openFixture$14(engine, opts);
 			try {
 				const { appearances } = await collect(doc, opts, useRaw);
 				const anyVisible = appearances.some((a) => a.raster !== null && hasOpaquePixel(a.raster));
@@ -3169,7 +3169,7 @@ function runAnnotationAppearanceConformance(runner, opts) {
 			}
 		});
 		test("abort() rejects with AbortError", async () => {
-			const doc = await openFixture$13(engine, opts);
+			const doc = await openFixture$14(engine, opts);
 			try {
 				const page = doc.page(opts.fixture.pageObjectNumber);
 				const p = useRaw ? page.annotations.renderAppearances({ scale: 1 }) : page.annotations.renderAppearanceImages({
@@ -3224,7 +3224,7 @@ function hasOpaquePixel(raster) {
 	}
 	return false;
 }
-async function openFixture$13(engine, opts) {
+async function openFixture$14(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -3293,7 +3293,7 @@ function runPageReorderConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("pages.list() returns every page in display order, durable PONs only", async () => {
-			const doc = await openFixture$12(engine, opts);
+			const doc = await openFixture$13(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				expect(PageListSnapshotSchema.safeParse(list).success).toBe(true);
@@ -3312,7 +3312,7 @@ function runPageReorderConformance(runner, opts) {
 			}
 		});
 		test("pages.move() reorders pages and returns the full post-move order", async () => {
-			const doc = await openFixture$12(engine, opts);
+			const doc = await openFixture$13(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				if (before.pages.length < 3) return;
@@ -3336,7 +3336,7 @@ function runPageReorderConformance(runner, opts) {
 			}
 		});
 		test("weak index-based annotation refs survive a page reorder", async () => {
-			const doc = await openFixture$12(engine, opts);
+			const doc = await openFixture$13(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 2) return;
@@ -3373,7 +3373,7 @@ function runPageReorderConformance(runner, opts) {
 			}
 		});
 		test("pages.move() rejects duplicate PONs with InvalidArg", async () => {
-			const doc = await openFixture$12(engine, opts);
+			const doc = await openFixture$13(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 1) return;
@@ -3390,7 +3390,7 @@ function runPageReorderConformance(runner, opts) {
 			}
 		});
 		test("pages.move() rejects out-of-range destIndex with InvalidArg", async () => {
-			const doc = await openFixture$12(engine, opts);
+			const doc = await openFixture$13(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 1) return;
@@ -3407,7 +3407,7 @@ function runPageReorderConformance(runner, opts) {
 			}
 		});
 		test("pages.move() rejects unknown PON with NotFound or InvalidArg", async () => {
-			const doc = await openFixture$12(engine, opts);
+			const doc = await openFixture$13(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				let bogus = 0;
@@ -3425,7 +3425,7 @@ function runPageReorderConformance(runner, opts) {
 			}
 		});
 		test("abort on pages.move() rejects with AbortError", async () => {
-			const doc = await openFixture$12(engine, opts);
+			const doc = await openFixture$13(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 1) return;
@@ -3439,7 +3439,7 @@ function runPageReorderConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$12(engine, opts) {
+async function openFixture$13(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -3513,7 +3513,7 @@ function runPageRotateConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("pages.rotate() sets the absolute rotation and returns the full layout", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				const target = before.pages[0];
@@ -3532,7 +3532,7 @@ function runPageRotateConformance(runner, opts) {
 			}
 		});
 		test("absolute rotation is idempotent: setting the same value twice is a no-op", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const pon = (await doc.pages.list()).pages[0].pageObjectNumber;
 				const first = await doc.pages.rotate([pon], 180);
@@ -3543,7 +3543,7 @@ function runPageRotateConformance(runner, opts) {
 			}
 		});
 		test("one rotation applies to EVERY listed page (the multi-select gesture)", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 2) return;
@@ -3555,7 +3555,7 @@ function runPageRotateConformance(runner, opts) {
 			}
 		});
 		test("weak index-based annotation refs survive a rotate (no revision bump)", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const hostPon = (await doc.pages.list()).pages[0].pageObjectNumber;
 				const hostPage = doc.page(hostPon);
@@ -3585,7 +3585,7 @@ function runPageRotateConformance(runner, opts) {
 			}
 		});
 		test("pages.rotate() rejects an invalid rotation value with InvalidArg", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const pon = (await doc.pages.list()).pages[0].pageObjectNumber;
 				let caught;
@@ -3600,7 +3600,7 @@ function runPageRotateConformance(runner, opts) {
 			}
 		});
 		test("pages.rotate() rejects duplicate PONs with InvalidArg", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const pon = (await doc.pages.list()).pages[0].pageObjectNumber;
 				let caught;
@@ -3615,7 +3615,7 @@ function runPageRotateConformance(runner, opts) {
 			}
 		});
 		test("pages.rotate() rejects unknown PON with NotFound or InvalidArg", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				let bogus = 0;
@@ -3633,7 +3633,7 @@ function runPageRotateConformance(runner, opts) {
 			}
 		});
 		test("abort on pages.rotate() rejects with AbortError", async () => {
-			const doc = await openFixture$11(engine, opts);
+			const doc = await openFixture$12(engine, opts);
 			try {
 				const pon = (await doc.pages.list()).pages[0].pageObjectNumber;
 				const p = doc.pages.rotate([pon], 90);
@@ -3645,7 +3645,7 @@ function runPageRotateConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$11(engine, opts) {
+async function openFixture$12(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -3708,7 +3708,7 @@ function runPageDeleteConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("pages.delete() removes the page and returns the surviving layout", async () => {
-			const doc = await openFixture$10(engine, opts);
+			const doc = await openFixture$11(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				if (before.pages.length < 2) return;
@@ -3729,7 +3729,7 @@ function runPageDeleteConformance(runner, opts) {
 			}
 		});
 		test("addressing a deleted page afterwards is a clean NotFound", async () => {
-			const doc = await openFixture$10(engine, opts);
+			const doc = await openFixture$11(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				if (before.pages.length < 2) return;
@@ -3747,7 +3747,7 @@ function runPageDeleteConformance(runner, opts) {
 			}
 		});
 		test("surviving pages keep their weak index-based annotation refs", async () => {
-			const doc = await openFixture$10(engine, opts);
+			const doc = await openFixture$11(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 2) return;
@@ -3780,7 +3780,7 @@ function runPageDeleteConformance(runner, opts) {
 			}
 		});
 		test("deleting EVERY page is rejected with InvalidArg", async () => {
-			const doc = await openFixture$10(engine, opts);
+			const doc = await openFixture$11(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				let caught;
@@ -3795,7 +3795,7 @@ function runPageDeleteConformance(runner, opts) {
 			}
 		});
 		test("pages.delete() rejects duplicate PONs with InvalidArg", async () => {
-			const doc = await openFixture$10(engine, opts);
+			const doc = await openFixture$11(engine, opts);
 			try {
 				const pon = (await doc.pages.list()).pages[0].pageObjectNumber;
 				let caught;
@@ -3810,7 +3810,7 @@ function runPageDeleteConformance(runner, opts) {
 			}
 		});
 		test("pages.delete() rejects unknown PON with NotFound or InvalidArg", async () => {
-			const doc = await openFixture$10(engine, opts);
+			const doc = await openFixture$11(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				let bogus = 0;
@@ -3828,7 +3828,7 @@ function runPageDeleteConformance(runner, opts) {
 			}
 		});
 		test("abort on pages.delete() rejects with AbortError", async () => {
-			const doc = await openFixture$10(engine, opts);
+			const doc = await openFixture$11(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				if (list.pages.length < 2) return;
@@ -3842,7 +3842,7 @@ function runPageDeleteConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$10(engine, opts) {
+async function openFixture$11(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -3870,7 +3870,7 @@ function runPageFlattenConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("flattens eligible appearances once without changing layout", async () => {
-			const doc = await openFixture$9(engine, opts);
+			const doc = await openFixture$10(engine, opts);
 			try {
 				if (!doc.pages.flatten) return;
 				const layoutBefore = await doc.pages.list();
@@ -3904,7 +3904,7 @@ function runPageFlattenConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$9(engine, opts) {
+async function openFixture$10(engine, opts) {
 	if (opts.openKind === "bytes") return engine.open({
 		kind: "bytes",
 		id: opts.fixture.id,
@@ -3959,7 +3959,7 @@ function runRedactionApplyConformance(runner, opts) {
 			if (engine) await engine.destroy();
 		});
 		test("annotations scope applies the marked redaction and counts collateral", async () => {
-			const doc = await openFixture$8(engine, opts);
+			const doc = await openFixture$9(engine, opts);
 			try {
 				if (!doc.redaction) return;
 				const layoutBefore = await doc.pages.list();
@@ -4013,7 +4013,7 @@ function runRedactionApplyConformance(runner, opts) {
 			}
 		});
 		test("pages scope applies everything once and validates its input", async () => {
-			const doc = await openFixture$8(engine, opts);
+			const doc = await openFixture$9(engine, opts);
 			try {
 				if (!doc.redaction) return;
 				const pageObjectNumber = (await doc.pages.list()).pages[0].pageObjectNumber;
@@ -4064,7 +4064,7 @@ function runRedactionApplyConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$8(engine, opts) {
+async function openFixture$9(engine, opts) {
 	if (opts.openKind === "bytes") return engine.open({
 		kind: "bytes",
 		id: opts.fixture.id,
@@ -4104,19 +4104,14 @@ function runPageExtractConformance(runner, opts) {
 	const { describe, test, beforeAll, afterAll, expect } = runner;
 	describe(`page extract conformance: ${opts.label}`, () => {
 		let engine;
-		let supported = false;
 		beforeAll(async () => {
 			engine = await opts.makeEngine();
-			const probe = await openFixture$7(engine, opts);
-			supported = probe.pages.extract !== void 0;
-			await probe.close();
 		});
 		afterAll(async () => {
 			if (engine) await engine.destroy();
 		});
 		test("pages.extract() returns standalone PDF bytes and leaves the source untouched", async () => {
-			if (!supported) return;
-			const doc = await openFixture$7(engine, opts);
+			const doc = await openFixture$8(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				const target = before.pages[before.pages.length - 1];
@@ -4131,8 +4126,8 @@ function runPageExtractConformance(runner, opts) {
 			}
 		});
 		test("extracted bytes re-open as a document with the requested pages, in caller order", async () => {
-			if (!supported || opts.openKind !== "bytes") return;
-			const doc = await openFixture$7(engine, opts);
+			if (opts.openKind !== "bytes") return;
+			const doc = await openFixture$8(engine, opts);
 			let extracted = null;
 			try {
 				const list = await doc.pages.list();
@@ -4155,8 +4150,7 @@ function runPageExtractConformance(runner, opts) {
 			}
 		});
 		test("pages.extract() rejects empty input with InvalidArg", async () => {
-			if (!supported) return;
-			const doc = await openFixture$7(engine, opts);
+			const doc = await openFixture$8(engine, opts);
 			try {
 				let caught;
 				try {
@@ -4170,8 +4164,7 @@ function runPageExtractConformance(runner, opts) {
 			}
 		});
 		test("pages.extract() rejects duplicate PONs with InvalidArg", async () => {
-			if (!supported) return;
-			const doc = await openFixture$7(engine, opts);
+			const doc = await openFixture$8(engine, opts);
 			try {
 				const pon = (await doc.pages.list()).pages[0].pageObjectNumber;
 				let caught;
@@ -4186,8 +4179,7 @@ function runPageExtractConformance(runner, opts) {
 			}
 		});
 		test("pages.extract() rejects unknown PON with NotFound or InvalidArg", async () => {
-			if (!supported) return;
-			const doc = await openFixture$7(engine, opts);
+			const doc = await openFixture$8(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				let bogus = 0;
@@ -4205,8 +4197,7 @@ function runPageExtractConformance(runner, opts) {
 			}
 		});
 		test("abort on pages.extract() rejects with AbortError", async () => {
-			if (!supported) return;
-			const doc = await openFixture$7(engine, opts);
+			const doc = await openFixture$8(engine, opts);
 			try {
 				const list = await doc.pages.list();
 				const p = doc.pages.extract([list.pages[0].pageObjectNumber]);
@@ -4218,7 +4209,7 @@ function runPageExtractConformance(runner, opts) {
 		});
 	});
 }
-async function openFixture$7(engine, opts) {
+async function openFixture$8(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
 		return engine.open({
@@ -4480,9 +4471,9 @@ function runAttachmentConformance(runner, opts) {
 //#endregion
 //#region src/conformance/runPageInsertConformance.ts
 /**
-* Page insert conformance. `pages.insert?` is optional only until the cloud
-* endpoint ships (it is slated REQUIRED-parity — a cloud viewer must be able
-* to add pages); the suite runs wherever the implementation exists.
+* Page insert conformance. `pages.insert` is a REQUIRED member — this suite
+* runs unconditionally on every engine, so an implementation that loses the
+* verb fails loudly instead of being skipped past.
 *
 * Invariants:
 *   1. Every page of the source bytes is COPIED in at `destIndex` (omitted →
@@ -4498,19 +4489,14 @@ function runPageInsertConformance(runner, opts) {
 	const { describe, test, beforeAll, afterAll, expect } = runner;
 	describe(`page insert conformance: ${opts.label}`, () => {
 		let engine;
-		let supported = false;
 		beforeAll(async () => {
 			engine = await opts.makeEngine();
-			const probe = await openFixture$6(engine, opts);
-			supported = probe.pages.insert !== void 0 && probe.pages.extract !== void 0;
-			await probe.close();
 		});
 		afterAll(async () => {
 			if (engine) await engine.destroy();
 		});
 		test("appends every source page with fresh PONs; existing pages keep identity", async () => {
-			if (!supported) return;
-			const doc = await openFixture$6(engine, opts);
+			const doc = await openFixture$7(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				const beforePons = before.pages.map((p) => p.pageObjectNumber);
@@ -4528,8 +4514,7 @@ function runPageInsertConformance(runner, opts) {
 			}
 		});
 		test("destIndex places the block mid-document, in source order", async () => {
-			if (!supported) return;
-			const doc = await openFixture$6(engine, opts);
+			const doc = await openFixture$7(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				if (before.pages.length < 2) return;
@@ -4546,8 +4531,8 @@ function runPageInsertConformance(runner, opts) {
 			}
 		});
 		test("the inserted pages persist through save → re-open", async () => {
-			if (!supported || opts.openKind !== "bytes") return;
-			const doc = await openFixture$6(engine, opts);
+			if (opts.openKind !== "bytes") return;
+			const doc = await openFixture$7(engine, opts);
 			let reopened = null;
 			try {
 				const before = await doc.pages.list();
@@ -4567,8 +4552,7 @@ function runPageInsertConformance(runner, opts) {
 			}
 		});
 		test("empty bytes reject with InvalidArg; garbage rejects with MalformedPdf", async () => {
-			if (!supported) return;
-			const doc = await openFixture$6(engine, opts);
+			const doc = await openFixture$7(engine, opts);
 			try {
 				let caught;
 				try {
@@ -4591,8 +4575,7 @@ function runPageInsertConformance(runner, opts) {
 			}
 		});
 		test("out-of-range destIndex rejects with InvalidArg", async () => {
-			if (!supported) return;
-			const doc = await openFixture$6(engine, opts);
+			const doc = await openFixture$7(engine, opts);
 			try {
 				const before = await doc.pages.list();
 				const single = await doc.pages.extract([before.pages[0].pageObjectNumber]);
@@ -4609,6 +4592,159 @@ function runPageInsertConformance(runner, opts) {
 		});
 	});
 }
+async function openFixture$7(engine, opts) {
+	if (opts.openKind === "bytes") {
+		const bytes = await opts.fixture.bytes();
+		return engine.open({
+			kind: "bytes",
+			id: opts.fixture.id,
+			bytes
+		});
+	}
+	return engine.open({
+		kind: "id",
+		id: opts.fixture.cloudId ?? opts.fixture.id
+	});
+}
+//#endregion
+//#region src/conformance/runPageInsertBlankConformance.ts
+/** An on-purpose non-default size so the assertions can't pass by accident. */
+const SIZE = {
+	width: 396,
+	height: 612
+};
+/**
+* Blank-page insert conformance. `pages.insertBlank` is a REQUIRED member —
+* the suite runs unconditionally on every engine (no fixture bytes are
+* needed at all, which is the point of the verb), so an implementation that
+* loses the verb fails loudly instead of being skipped past.
+*
+* Invariants:
+*   1. `count` blank pages of exactly `size` appear at `destIndex` (omitted
+*      → append), rotation 0; the result lists their fresh PONs in insertion
+*      order and they agree with the returned layout.
+*   2. Pre-existing pages keep their identity: same PONs before and after,
+*      in the expected positions (an insert never invalidates neighbours).
+*   3. The mutation persists through save → re-open (bytes engines only).
+*   4. Non-positive size / count outside [1, PAGE_INSERT_BLANK_MAX_COUNT] /
+*      out-of-range destIndex reject with InvalidArg, leaving the document
+*      untouched.
+*/
+function runPageInsertBlankConformance(runner, opts) {
+	const { describe, test, beforeAll, afterAll, expect } = runner;
+	describe(`page insert-blank conformance: ${opts.label}`, () => {
+		let engine;
+		beforeAll(async () => {
+			engine = await opts.makeEngine();
+		});
+		afterAll(async () => {
+			if (engine) await engine.destroy();
+		});
+		test("appends one blank page of the requested size with a fresh PON", async () => {
+			const doc = await openFixture$6(engine, opts);
+			try {
+				const before = await doc.pages.list();
+				const beforePons = before.pages.map((p) => p.pageObjectNumber);
+				const result = await doc.pages.insertBlank({ size: SIZE });
+				expect(result.insertedPageObjectNumbers.length).toBe(1);
+				expect(result.layout.pageCount).toBe(before.pageCount + 1);
+				expect(result.layout.pages.slice(0, before.pageCount).map((p) => p.pageObjectNumber)).toEqual(beforePons);
+				const newPon = result.insertedPageObjectNumbers[0];
+				expect(beforePons.includes(newPon)).toBe(false);
+				const appended = result.layout.pages[before.pageCount];
+				expect(appended.pageObjectNumber).toBe(newPon);
+				expect(appended.size).toEqual(SIZE);
+				expect(appended.rotation).toBe(0);
+			} finally {
+				await doc.close();
+			}
+		});
+		test("destIndex + count places the blank block mid-document", async () => {
+			const doc = await openFixture$6(engine, opts);
+			try {
+				const before = await doc.pages.list();
+				if (before.pages.length < 2) return;
+				const beforePons = before.pages.map((p) => p.pageObjectNumber);
+				const result = await doc.pages.insertBlank({
+					size: SIZE,
+					count: 2
+				}, 1);
+				expect(result.insertedPageObjectNumbers.length).toBe(2);
+				expect(result.insertedPageObjectNumbers[0] === result.insertedPageObjectNumbers[1]).toBe(false);
+				const pons = result.layout.pages.map((p) => p.pageObjectNumber);
+				expect(pons[0]).toBe(beforePons[0]);
+				expect(pons.slice(1, 3)).toEqual(result.insertedPageObjectNumbers);
+				expect(pons.slice(3)).toEqual(beforePons.slice(1));
+				expect(result.layout.pages[1].size).toEqual(SIZE);
+				expect(result.layout.pages[2].size).toEqual(SIZE);
+			} finally {
+				await doc.close();
+			}
+		});
+		test("the blank pages persist through save → re-open", async () => {
+			if (opts.openKind !== "bytes") return;
+			const doc = await openFixture$6(engine, opts);
+			let reopened = null;
+			try {
+				const before = await doc.pages.list();
+				await doc.pages.insertBlank({ size: SIZE });
+				const bytes = await doc.download();
+				reopened = await engine.open({
+					kind: "bytes",
+					id: `${opts.fixture.id}-insert-blank-reopen`,
+					bytes
+				});
+				const after = await reopened.pages.list();
+				expect(after.pageCount).toBe(before.pageCount + 1);
+				const tail = after.pages[after.pageCount - 1];
+				expect(Math.round(tail.size.width)).toBe(SIZE.width);
+				expect(Math.round(tail.size.height)).toBe(SIZE.height);
+			} finally {
+				if (reopened) await reopened.close();
+				await doc.close();
+			}
+		});
+		test("non-positive size, bad count, and out-of-range destIndex reject with InvalidArg", async () => {
+			const doc = await openFixture$6(engine, opts);
+			try {
+				const before = await doc.pages.list();
+				const rejects = [
+					() => doc.pages.insertBlank({ size: {
+						width: 0,
+						height: 612
+					} }),
+					() => doc.pages.insertBlank({ size: {
+						width: 396,
+						height: -10
+					} }),
+					() => doc.pages.insertBlank({
+						size: SIZE,
+						count: 0
+					}),
+					() => doc.pages.insertBlank({
+						size: SIZE,
+						count: 101
+					}),
+					() => doc.pages.insertBlank({ size: SIZE }, before.pageCount + 1)
+				];
+				for (const attempt of rejects) {
+					let caught;
+					try {
+						await attempt();
+					} catch (err) {
+						caught = err;
+					}
+					expect(EngineError.is(caught, EngineErrorCode.InvalidArg)).toBe(true);
+				}
+				const list = await doc.pages.list();
+				expect(list.pageCount).toBe(before.pageCount);
+				expect(list.pages.map((p) => p.pageObjectNumber)).toEqual(before.pages.map((p) => p.pageObjectNumber));
+			} finally {
+				await doc.close();
+			}
+		});
+	});
+}
 async function openFixture$6(engine, opts) {
 	if (opts.openKind === "bytes") {
 		const bytes = await opts.fixture.bytes();
@@ -4916,6 +5052,28 @@ function runDocumentEventsConformance(runner, opts) {
 				await doc.close();
 			}
 		});
+		test("pages.inserted rides verbatim", async () => {
+			const doc = await openFixture$4(engine, opts);
+			try {
+				const events = [];
+				doc.events.subscribe((event) => events.push(event));
+				const inserted = await doc.pages.insertBlank({ size: {
+					width: 396,
+					height: 612
+				} }, 0);
+				expect(events.map((event) => event.type)).toEqual(["pages.inserted"]);
+				const [evInserted] = events;
+				if (evInserted.type === "pages.inserted") {
+					expect(evInserted.insertedPageObjectNumbers).toEqual(inserted.insertedPageObjectNumbers);
+					expect(evInserted.layout).toEqual(inserted.layout);
+					expect(evInserted.cache).toEqual(inserted.cache);
+					expect(evInserted.destIndex).toBe(0);
+					expect(evInserted.origin.kind).toBe("local");
+				}
+			} finally {
+				await doc.close();
+			}
+		});
 		test("a FAILED mutation publishes nothing (events are ground truth)", async () => {
 			const doc = await openFixture$4(engine, opts);
 			try {
@@ -5720,6 +5878,6 @@ function diffAnnotation(i, a, b, errs) {
 	if (a.nm !== b.nm) errs.push(`annotations[${i}].nm mismatch: ${a.nm} vs ${b.nm}`);
 }
 //#endregion
-export { TEXT_DIVERGENCE_CASES, diffAnnotationListSnapshot, diffAnnotationListSnapshotAll, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationMutationConformance, runAnnotationReadConformance, runAttachmentConformance, runDocumentEventsConformance, runFormConformance, runMetadataConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertConformance, runPageReorderConformance, runPageRotateConformance, runPageTextConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runTextDivergenceConformance };
+export { TEXT_DIVERGENCE_CASES, diffAnnotationListSnapshot, diffAnnotationListSnapshotAll, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationMutationConformance, runAnnotationReadConformance, runAttachmentConformance, runDocumentEventsConformance, runFormConformance, runMetadataConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageReorderConformance, runPageRotateConformance, runPageTextConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runTextDivergenceConformance };
 
 //# sourceMappingURL=conformance.js.map