@embedpdf/engine-services 3.0.0-next.13 → 3.0.0-next.14

package/dist/index.cjs

@@ -3644,6 +3644,181 @@ function readInk(fn, mem, annotPtr, base) {
 	};
 }
 //#endregion
+//#region src/features/measure/internal/measureCodec.ts
+const MEASURE_AXES = {
+	x: 0,
+	y: 1,
+	distance: 2,
+	area: 3,
+	angle: 4,
+	slope: 5
+};
+const FRACTIONS = [
+	"decimal",
+	"fraction",
+	"round",
+	"truncate"
+];
+const TEXT = [
+	"thousands",
+	"decimal",
+	"prefixSpacing",
+	"suffixSpacing"
+];
+/** A native rejection after validated input is an internal invariant, never caller validation. */
+function requireMeasureWrite(ok) {
+	if (!ok) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, "Measurement native write failed after preflight");
+}
+function readMeasureNumber(mem, call, type = "f32") {
+	return withScratch(mem, 4, (p) => call(p) ? Number(mem.peek(p, type)) : void 0);
+}
+function withMeasurePoint(mem, point, call) {
+	if (!point) return call(_embedpdf_engine_runtime.NULL_PTR);
+	return withScratch(mem, 8, (p) => {
+		mem.poke(p, "f32", point.x);
+		mem.poke(p, "f32", point.y, 4);
+		return call(p);
+	});
+}
+function readMeasure(fn, mem, handle) {
+	if (!handle) return void 0;
+	const subtype = fn.EPDFMeasure_GetSubtype(handle);
+	if (subtype !== 1) return { subtype: subtype === 2 ? "GEO" : "unknown" };
+	const formats = (axis) => Array.from({ length: fn.EPDFMeasure_CountFormats(handle, axis) }, (_, i) => {
+		const f = fn.EPDFMeasure_GetFormat(handle, axis, i);
+		const out = { unit: readUtf16String(mem, (b, n) => fn.EPDFNumberFormat_GetUnit(f, b, n)) ?? "" };
+		const conversion = readMeasureNumber(mem, (p) => fn.EPDFNumberFormat_GetConversion(f, p));
+		if (conversion !== void 0) out.conversion = conversion;
+		const fraction = readMeasureNumber(mem, (p) => fn.EPDFNumberFormat_GetFraction(f, p), "i32");
+		if (fraction !== void 0 && FRACTIONS[fraction]) out.fraction = FRACTIONS[fraction];
+		const precision = readMeasureNumber(mem, (p) => fn.EPDFNumberFormat_GetPrecision(f, p), "i32");
+		if (precision !== void 0) out.precision = precision;
+		const fixed = readMeasureNumber(mem, (p) => fn.EPDFNumberFormat_GetFixedDenominator(f, p), "i32");
+		if (fixed !== void 0) out.fixed = !!fixed;
+		const position = readMeasureNumber(mem, (p) => fn.EPDFNumberFormat_GetLabelPosition(f, p), "i32");
+		if (position !== void 0) out.labelPosition = position === 1 ? "prefix" : "suffix";
+		for (const [code, key] of TEXT.entries()) {
+			const text = readUtf16String(mem, (b, n) => fn.EPDFNumberFormat_GetText(f, code, b, n));
+			if (text !== null) out[key] = text;
+		}
+		return out;
+	});
+	const ratio = readUtf16String(mem, (b, n) => fn.EPDFMeasure_GetRatio(handle, b, n));
+	const origin = withScratch(mem, 8, (p) => fn.EPDFMeasure_GetOrigin(handle, p) ? {
+		x: Number(mem.peek(p, "f32")),
+		y: Number(mem.peek(p, "f32", 4))
+	} : void 0);
+	const cyx = readMeasureNumber(mem, (p) => fn.EPDFMeasure_GetCYX(handle, p));
+	const result = {
+		subtype: "RL",
+		x: formats(0),
+		distance: formats(2),
+		area: formats(3),
+		...ratio !== null ? { ratio } : {},
+		...origin ? { origin } : {},
+		...cyx !== void 0 ? { cyx } : {}
+	};
+	for (const key of [
+		"y",
+		"angle",
+		"slope"
+	]) {
+		const list = formats(MEASURE_AXES[key]);
+		if (list.length) result[key] = list;
+	}
+	return result;
+}
+/** The caller supplies a freshly created/reset handle and has completed preflight. */
+function writeMeasure(fn, mem, handle, value) {
+	requireMeasureWrite(handle);
+	if (value.ratio !== void 0) requireMeasureWrite(writeUtf16String(mem, value.ratio, (p) => fn.EPDFMeasure_SetRatio(handle, p)));
+	if (value.origin) requireMeasureWrite(withMeasurePoint(mem, value.origin, (p) => fn.EPDFMeasure_SetOrigin(handle, p)));
+	if (value.cyx !== void 0) withScratch(mem, 4, (p) => {
+		mem.poke(p, "f32", value.cyx);
+		requireMeasureWrite(fn.EPDFMeasure_SetCYX(handle, p));
+	});
+	for (const [key, axis] of Object.entries(MEASURE_AXES)) for (const nf of value[key] ?? []) {
+		const text = mem.writeU16String(nf.unit);
+		let f;
+		try {
+			f = fn.EPDFMeasure_AddFormat(handle, axis, text, nf.conversion);
+		} finally {
+			mem.free(text);
+		}
+		requireMeasureWrite(f);
+		if (nf.fraction !== void 0) requireMeasureWrite(fn.EPDFNumberFormat_SetFraction(f, FRACTIONS.indexOf(nf.fraction)));
+		if (nf.precision !== void 0) requireMeasureWrite(fn.EPDFNumberFormat_SetPrecision(f, nf.precision));
+		if (nf.fixed !== void 0) requireMeasureWrite(fn.EPDFNumberFormat_SetFixedDenominator(f, nf.fixed));
+		if (nf.labelPosition !== void 0) requireMeasureWrite(fn.EPDFNumberFormat_SetLabelPosition(f, nf.labelPosition === "prefix" ? 1 : 0));
+		for (const [code, key] of TEXT.entries()) if (nf[key] !== void 0) requireMeasureWrite(writeUtf16String(mem, nf[key], (p) => fn.EPDFNumberFormat_SetText(f, code, p)));
+	}
+}
+//#endregion
+//#region src/features/annotations/internal/read/readMeasurementFields.ts
+function readAnnotationMeasure(fn, mem, annot) {
+	const measure = readMeasure(fn, mem, fn.EPDFAnnot_GetMeasure(annot));
+	return measure ? { measure } : {};
+}
+function readLineCaption(fn, mem, annot) {
+	if (![
+		"Cap",
+		"CP",
+		"CO"
+	].some((key) => fn.FPDFAnnot_HasKey(annot, key))) return void 0;
+	return withScratchN(mem, [
+		4,
+		4,
+		8
+	], ([enabled, position, offset]) => {
+		if (!fn.EPDFAnnot_GetLineCaption(annot, enabled, position, offset)) return void 0;
+		return {
+			enabled: !!mem.peek(enabled, "i32"),
+			position: mem.peek(position, "i32") === 1 ? "top" : "inline",
+			...fn.FPDFAnnot_HasKey(annot, "CO") ? { offset: {
+				along: Number(mem.peek(offset, "f32")),
+				perpendicular: Number(mem.peek(offset, "f32", 4))
+			} } : {}
+		};
+	});
+}
+function readShapeCaption(fn, mem, annot) {
+	return withScratchN(mem, [
+		4,
+		4,
+		8
+	], ([enabled, hasCenter, center]) => {
+		if (!fn.EPDFAnnot_GetShapeCaption(annot, enabled, hasCenter, center)) return void 0;
+		const value = !!mem.peek(enabled, "i32"), manual = !!mem.peek(hasCenter, "i32");
+		if (!fn.EPDFAnnot_GetEmbedMetadataBoolean(annot, "MeasurementCaption", enabled) && !manual) return void 0;
+		return {
+			enabled: value,
+			...manual ? { center: {
+				x: Number(mem.peek(center, "f32")),
+				y: Number(mem.peek(center, "f32", 4))
+			} } : {}
+		};
+	});
+}
+function readLineLeader(fn, mem, annot) {
+	if (![
+		"LL",
+		"LLE",
+		"LLO"
+	].some((key) => fn.FPDFAnnot_HasKey(annot, key))) return void 0;
+	return withScratchN(mem, [
+		4,
+		4,
+		4
+	], ([length, extension, offset]) => {
+		if (!fn.EPDFAnnot_GetLineLeader(annot, length, extension, offset)) return void 0;
+		return {
+			length: Number(mem.peek(length, "f32")),
+			extension: Number(mem.peek(extension, "f32")),
+			offset: Number(mem.peek(offset, "f32"))
+		};
+	});
+}
+//#endregion
 //#region src/features/annotations/internal/read/readLineAnnotation.ts
 /** Fallback `/L` when the annotation has no line geometry. */
 const ZERO_LINE = {
@@ -3658,8 +3833,15 @@ const ZERO_LINE = {
 };
 function readLine(fn, mem, annotPtr, base) {
 	const rotation = readAnnotationRotation(fn, mem, annotPtr);
+	const intent = readIntent(fn, mem, annotPtr);
+	const caption = readLineCaption(fn, mem, annotPtr);
+	const leader = readLineLeader(fn, mem, annotPtr);
 	return {
 		...base,
+		...readAnnotationMeasure(fn, mem, annotPtr),
+		...intent === "LineDimension" || intent === "LineArrow" ? { intent } : {},
+		...caption ? { caption } : {},
+		...leader ? { leader } : {},
 		subtype: "line",
 		...readFilledStyleExtras(fn, mem, annotPtr),
 		linePoints: readLine$1(fn, mem, annotPtr) ?? ZERO_LINE,
@@ -3998,16 +4180,26 @@ function readVertexExtras(fn, mem, annotPtr) {
 	};
 }
 function readPolygon(fn, mem, annotPtr, base) {
+	const caption = readShapeCaption(fn, mem, annotPtr);
+	const intent = readIntent(fn, mem, annotPtr);
 	return {
 		...base,
+		...readAnnotationMeasure(fn, mem, annotPtr),
+		...caption ? { caption } : {},
+		...intent === "PolygonDimension" || intent === "PolygonCloud" ? { intent } : {},
 		subtype: "polygon",
 		...readVertexExtras(fn, mem, annotPtr),
 		cloudyIntensity: readBorderEffect(fn, mem, annotPtr)
 	};
 }
 function readPolyline(fn, mem, annotPtr, base) {
+	const caption = readShapeCaption(fn, mem, annotPtr);
+	const intent = readIntent(fn, mem, annotPtr);
 	return {
 		...base,
+		...readAnnotationMeasure(fn, mem, annotPtr),
+		...caption ? { caption } : {},
+		...intent === "PolyLineDimension" ? { intent } : {},
 		subtype: "polyline",
 		...readVertexExtras(fn, mem, annotPtr),
 		lineEndings: readLineEndings(fn, mem, annotPtr)
@@ -5108,6 +5300,151 @@ var RawAnnotationReader = class {
 	}
 };
 //#endregion
+//#region src/features/annotations/internal/mutations/prepareMeasurementMutation.ts
+const kinds = /* @__PURE__ */ new Set([
+	"line",
+	"polygon",
+	"polyline"
+]);
+const inputs = [
+	"linePoints",
+	"vertices",
+	"measure",
+	"intent",
+	"contents"
+];
+function validate(value) {
+	if (!kinds.has(value.subtype)) return;
+	const v = value;
+	try {
+		if (v.measure !== void 0 && v.measure !== null) (0, _embedpdf_engine_core_runtime.assertWritableMeasure)(v.measure);
+		if (v.caption != null && (typeof v.caption !== "object" || Array.isArray(v.caption))) throw new RangeError("Invalid caption");
+		if (v.subtype === "line" && v.leader != null && (typeof v.leader !== "object" || Array.isArray(v.leader))) throw new RangeError("Invalid line leader");
+		const intents = v.subtype === "line" ? ["LineDimension", "LineArrow"] : v.subtype === "polygon" ? ["PolygonDimension", "PolygonCloud"] : ["PolyLineDimension"];
+		if (v.intent != null && !intents.includes(v.intent)) throw new RangeError("Invalid measurement intent");
+		if (v.caption) {
+			if (v.caption.enabled !== void 0 && typeof v.caption.enabled !== "boolean") throw new RangeError("Invalid caption visibility");
+			if (v.subtype === "line") {
+				if (v.caption.position != null && !["inline", "top"].includes(v.caption.position)) throw new RangeError("Invalid caption position");
+				if (v.caption.offset) {
+					(0, _embedpdf_engine_core_runtime.assertPdfFloat)(v.caption.offset.along);
+					(0, _embedpdf_engine_core_runtime.assertPdfFloat)(v.caption.offset.perpendicular);
+				}
+			} else if (v.caption.center) {
+				(0, _embedpdf_engine_core_runtime.assertPdfFloat)(v.caption.center.x);
+				(0, _embedpdf_engine_core_runtime.assertPdfFloat)(v.caption.center.y);
+			}
+		}
+		if (v.subtype === "line" && v.leader) {
+			for (const n of [
+				v.leader.length,
+				v.leader.extension ?? 0,
+				v.leader.offset ?? 0
+			]) (0, _embedpdf_engine_core_runtime.assertPdfFloat)(n);
+			if ((v.leader.extension ?? 0) < 0 || (v.leader.offset ?? 0) < 0) throw new RangeError("Leader extension and offset must be nonnegative");
+		}
+		const points = v.subtype === "line" ? v.linePoints ? [v.linePoints.start, v.linePoints.end] : [] : v.vertices ?? [];
+		for (const p of points) {
+			(0, _embedpdf_engine_core_runtime.assertPdfFloat)(p.x);
+			(0, _embedpdf_engine_core_runtime.assertPdfFloat)(p.y);
+		}
+	} catch (error) {
+		throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, error.message);
+	}
+}
+/** Infer a rigid transform only when ALL corresponding vertices agree. Vertex edits leave a manual center fixed. */
+function moveCenter(before, after, center) {
+	if (before.length !== after.length || before.length < 2) return void 0;
+	const a = before[0], b = after[0];
+	const index = before.findIndex((p) => Math.hypot(p.x - a.x, p.y - a.y) > 1e-6);
+	if (index < 0) return void 0;
+	const u = {
+		x: before[index].x - a.x,
+		y: before[index].y - a.y
+	};
+	const v = {
+		x: after[index].x - b.x,
+		y: after[index].y - b.y
+	};
+	const length = u.x * u.x + u.y * u.y;
+	const cos = (u.x * v.x + u.y * v.y) / length, sin = (u.x * v.y - u.y * v.x) / length;
+	if (Math.abs(cos * cos + sin * sin - 1) > 1e-5) return void 0;
+	const transform = (p) => ({
+		x: b.x + cos * (p.x - a.x) - sin * (p.y - a.y),
+		y: b.y + sin * (p.x - a.x) + cos * (p.y - a.y)
+	});
+	if (!before.every((p, i) => {
+		const t = transform(p);
+		return Math.hypot(t.x - after[i].x, t.y - after[i].y) <= .001;
+	})) return void 0;
+	return transform(center);
+}
+function prepareMeasurementDraft(draft) {
+	validate(draft);
+	if ((draft.subtype === "line" || draft.subtype === "polygon" || draft.subtype === "polyline") && draft.caption && draft.caption.enabled === void 0) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "A new caption requires enabled");
+	return (0, _embedpdf_engine_core_runtime.deriveMeasurementLabel)(draft);
+}
+function prepareMeasurementPatch(fn, annot, current, patch) {
+	if (patch.subtype !== current.subtype) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "Annotation subtype cannot change");
+	validate(patch);
+	if (patch.subtype !== "line" && patch.subtype !== "polygon" && patch.subtype !== "polyline" || current.subtype !== "line" && current.subtype !== "polygon" && current.subtype !== "polyline") return patch;
+	if (patch.measure && current.measure && current.measure.subtype !== "RL") throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "Remove the foreign measure explicitly before replacing it");
+	if (patch.subtype !== "line" && patch.caption && fn.FPDFAnnot_HasKey(annot, "EMBD_Metadata") && fn.FPDFAnnot_GetValueType(annot, "EMBD_Metadata") !== 6) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "Malformed annotation metadata cannot store a caption");
+	if (patch.subtype !== "line" && current.subtype !== "line" && patch.vertices && patch.caption !== null && patch.caption?.center === void 0 && current.caption?.center) {
+		const center = moveCenter(current.vertices, patch.vertices, current.caption.center);
+		if (center) patch = {
+			...patch,
+			caption: {
+				...current.caption,
+				...patch.caption,
+				center
+			}
+		};
+	}
+	if (patch.caption) {
+		if (patch.subtype === "line" && current.subtype === "line") {
+			const c = {
+				enabled: false,
+				...current.caption,
+				...patch.caption
+			};
+			patch = {
+				...patch,
+				caption: {
+					enabled: c.enabled,
+					position: c.position ?? "inline",
+					...c.offset ? { offset: c.offset } : {}
+				}
+			};
+		} else if (patch.subtype !== "line" && current.subtype !== "line") {
+			const c = {
+				enabled: false,
+				...current.caption,
+				...patch.caption
+			};
+			patch = {
+				...patch,
+				caption: {
+					enabled: c.enabled,
+					...c.center ? { center: c.center } : {}
+				}
+			};
+		}
+	}
+	if (inputs.some((key) => patch[key] !== void 0)) {
+		const readout = (0, _embedpdf_engine_core_runtime.measurementReadout)({
+			...current,
+			...patch
+		});
+		if ((0, _embedpdf_engine_core_runtime.isReadout)(readout)) patch = {
+			...patch,
+			contents: readout.label
+		};
+	}
+	validate(patch);
+	return patch;
+}
+//#endregion
 //#region src/features/annotations/internal/write/annotationWritePrimitives.ts
 /**
 * Write-side twin of `annotationReadPrimitives.ts`. Every annotation
@@ -6202,6 +6539,36 @@ function isInkSubtype(subtype) {
 	return subtype === "ink";
 }
 //#endregion
+//#region src/features/annotations/internal/write/writeMeasurementFields.ts
+/** Receives normalized complete captions from the mutator, never partial state. */
+function writeMeasurementFields(fn, mem, annot, value) {
+	if (value.intent !== void 0) if (value.intent === null) fn.EPDFAnnot_RemoveKey(annot, "IT");
+	else requireMeasureWrite(fn.EPDFAnnot_SetIntent(annot, value.intent));
+	if (value.measure !== void 0) if (value.measure === null) requireMeasureWrite(fn.EPDFAnnot_RemoveMeasure(annot));
+	else writeMeasure(fn, mem, fn.EPDFAnnot_AddMeasure(annot), value.measure);
+	if (value.subtype === "line") {
+		if (value.leader !== void 0) requireMeasureWrite(fn.EPDFAnnot_SetLineLeader(annot, value.leader?.length ?? 0, value.leader?.extension ?? 0, value.leader?.offset ?? 0));
+		if (value.caption !== void 0) if (value.caption === null) for (const key of [
+			"Cap",
+			"CP",
+			"CO"
+		]) fn.EPDFAnnot_RemoveKey(annot, key);
+		else {
+			const c = value.caption;
+			requireMeasureWrite(withMeasurePoint(mem, c.offset ? {
+				x: c.offset.along,
+				y: c.offset.perpendicular
+			} : void 0, (p) => fn.EPDFAnnot_SetLineCaption(annot, c.enabled ?? false, c.position === "top" ? 1 : 0, p)));
+		}
+	} else if (value.caption !== void 0) if (value.caption === null) {
+		fn.EPDFAnnot_ClearEmbedMetadataKey(annot, "MeasurementCaption");
+		fn.EPDFAnnot_ClearEmbedMetadataKey(annot, "MeasurementCaptionCenter");
+	} else {
+		const c = value.caption;
+		requireMeasureWrite(withMeasurePoint(mem, c.center ?? void 0, (p) => fn.EPDFAnnot_SetShapeCaption(annot, c.enabled ?? false, p)));
+	}
+}
+//#endregion
 //#region src/features/annotations/internal/write/writeLineAnnotation.ts
 /** Default line endings when a line draft omits them. */
 const DEFAULT_LINE_ENDINGS$1 = {
@@ -6218,6 +6585,7 @@ const DEFAULT_LINE_ENDINGS$1 = {
 */
 function applyLineDraft(fn, mem, annotPtr, draft) {
 	applyAnnotationBaseDraft(fn, mem, annotPtr, draft);
+	writeMeasurementFields(fn, mem, annotPtr, draft);
 	setAnnotRect(fn, mem, annotPtr, draft.rect);
 	applyFilledStyleDraft(fn, mem, annotPtr, draft);
 	setLine(fn, mem, annotPtr, draft.linePoints);
@@ -6226,6 +6594,7 @@ function applyLineDraft(fn, mem, annotPtr, draft) {
 }
 function applyLinePatch(fn, mem, annotPtr, patch) {
 	applyAnnotationBasePatch(fn, mem, annotPtr, patch);
+	writeMeasurementFields(fn, mem, annotPtr, patch);
 	if (patch.rect !== void 0) setAnnotRect(fn, mem, annotPtr, patch.rect);
 	applyFilledStylePatch(fn, mem, annotPtr, patch);
 	if (patch.linePoints !== void 0) setLine(fn, mem, annotPtr, patch.linePoints);
@@ -6884,6 +7253,7 @@ const DEFAULT_LINE_ENDINGS = {
 */
 function applyPolygonDraft(fn, mem, annotPtr, draft) {
 	applyAnnotationBaseDraft(fn, mem, annotPtr, draft);
+	writeMeasurementFields(fn, mem, annotPtr, draft);
 	setAnnotRect(fn, mem, annotPtr, draft.rect);
 	applyFilledStyleDraft(fn, mem, annotPtr, draft);
 	setVertices(fn, mem, annotPtr, draft.vertices);
@@ -6892,6 +7262,7 @@ function applyPolygonDraft(fn, mem, annotPtr, draft) {
 }
 function applyPolygonPatch(fn, mem, annotPtr, patch) {
 	applyAnnotationBasePatch(fn, mem, annotPtr, patch);
+	writeMeasurementFields(fn, mem, annotPtr, patch);
 	if (patch.rect !== void 0) setAnnotRect(fn, mem, annotPtr, patch.rect);
 	applyFilledStylePatch(fn, mem, annotPtr, patch);
 	if (patch.vertices !== void 0) setVertices(fn, mem, annotPtr, patch.vertices);
@@ -6909,6 +7280,7 @@ function applyPolygonPatch(fn, mem, annotPtr, patch) {
 */
 function applyPolylineDraft(fn, mem, annotPtr, draft) {
 	applyAnnotationBaseDraft(fn, mem, annotPtr, draft);
+	writeMeasurementFields(fn, mem, annotPtr, draft);
 	setAnnotRect(fn, mem, annotPtr, draft.rect);
 	applyFilledStyleDraft(fn, mem, annotPtr, draft);
 	setVertices(fn, mem, annotPtr, draft.vertices);
@@ -6917,6 +7289,7 @@ function applyPolylineDraft(fn, mem, annotPtr, draft) {
 }
 function applyPolylinePatch(fn, mem, annotPtr, patch) {
 	applyAnnotationBasePatch(fn, mem, annotPtr, patch);
+	writeMeasurementFields(fn, mem, annotPtr, patch);
 	if (patch.rect !== void 0) setAnnotRect(fn, mem, annotPtr, patch.rect);
 	applyFilledStylePatch(fn, mem, annotPtr, patch);
 	if (patch.vertices !== void 0) setVertices(fn, mem, annotPtr, patch.vertices);
@@ -7219,6 +7592,7 @@ var AnnotationMutator = class {
 			const writeCtx = this.writeContext(pagePtr, resources);
 			preflightDraft(draft, writeCtx);
 			assertRichTextAgreement(draft);
+			draft = prepareMeasurementDraft(draft);
 			const pageStateBefore = this.session.pageState(pageObjectNumber);
 			throwIfAborted(signal);
 			const annotPtr = fn.EPDFPage_CreateAnnot(pagePtr, subtypeCode);
@@ -7279,13 +7653,18 @@ var AnnotationMutator = class {
 			assertRichTextAgreement(patch);
 			this.ensureKnownWeakStateFromPage(ref.pageObjectNumber, pagePtr);
 			const pageStateBefore = this.session.pageState(ref.pageObjectNumber);
-			throwIfAborted(signal);
-			const stableId = this.captureOrStampStableId(annotPtr);
 			const previousBlendMode = blendModeFromCode(fn.EPDFAnnot_GetBlendMode(annotPtr));
 			const preIndex = fn.FPDFPage_GetAnnotIndex(pagePtr, annotPtr);
 			if (preIndex < 0) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, `FPDFPage_GetAnnotIndex returned ${preIndex} before update`);
 			const currentDto = readAnnotationFromPtr(fn, mem, annotPtr, ref.pageObjectNumber, preIndex, pageStateBefore.revision, readContextFor(this.session, this.fonts));
+			patch = prepareMeasurementPatch(fn, annotPtr, currentDto, patch);
+			throwIfAborted(signal);
+			const stableId = this.captureOrStampStableId(annotPtr);
 			applyPatch(fn, mem, annotPtr, patch, writeCtx);
+			if (patch.contents !== void 0 && patch.contents !== currentDto.contents && (0, _embedpdf_engine_core_runtime.isDimension)({
+				...currentDto,
+				...patch
+			})) fn.EPDFAnnot_RemoveKey(annotPtr, "RC");
 			let linkedParentId = null;
 			if (patch.inReplyTo !== void 0 || patch.replyType !== void 0) linkedParentId = writeAnnotationRelationship(this.runtime, this.session, pagePtr, annotPtr, ref.pageObjectNumber, {
 				inReplyTo: patch.inReplyTo,
@@ -8786,6 +9165,14 @@ function layerSaveError(status) {
 	return new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.DocOpenFailed, "failed to save layer artifact");
 }
 //#endregion
+//#region src/features/save/internal/readSavedBuffer.ts
+/** Keep the runtime's owned copy when it already occupies an entire ArrayBuffer. */
+function readSavedBuffer(mem, ptr, size) {
+	const bytes = mem.readBytes(ptr, size);
+	if (bytes.buffer instanceof ArrayBuffer && bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength) return bytes.buffer;
+	return new Uint8Array(bytes).buffer;
+}
+//#endregion
 //#region src/runtime/memory/u64.ts
 /**
 * 64-bit out-params as two little-endian 32-bit halves: the wasm memory
@@ -9411,7 +9798,7 @@ var DocumentSaver = class {
 	saveLayerArtifactImpl(reporting) {
 		this.requireLayer();
 		const { mem, fn } = this.runtime;
-		const sizePtr = mem.alloc(4);
+		const sizePtr = mem.alloc(8);
 		const statusPtr = mem.alloc(4);
 		const changedPtr = mem.alloc(4);
 		let artifactPtr = null;
@@ -9470,7 +9857,7 @@ var DocumentSaver = class {
 	saveLayerDeltaImpl(reporting) {
 		this.requireLayer();
 		const { mem, fn } = this.runtime;
-		const sizePtr = mem.alloc(4);
+		const sizePtr = mem.alloc(8);
 		const statusPtr = mem.alloc(4);
 		const changedPtr = mem.alloc(4);
 		let deltaPtr = null;
@@ -9521,18 +9908,15 @@ var DocumentSaver = class {
 	}
 	saveStandaloneToBuffer(mode) {
 		const { mem, fn } = this.runtime;
-		const sizePtr = mem.alloc(4);
+		const sizePtr = mem.alloc(8);
 		let pdfPtr = null;
 		try {
 			mem.poke(sizePtr, "i32", 0);
 			pdfPtr = fn.EPDF_SaveDocumentToOwnedBuffer(this.session.requireDocPtr(), pdfSaveModeFlags(mode), sizePtr);
 			const size = Number(mem.peek(sizePtr, "i32"));
 			if (!pdfPtr || size <= 0) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.DocOpenFailed, "failed to save document");
-			const bytes = mem.readBytes(pdfPtr, size);
-			const buffer = new ArrayBuffer(bytes.byteLength);
-			new Uint8Array(buffer).set(bytes);
 			return {
-				bytes: buffer,
+				bytes: readSavedBuffer(mem, pdfPtr, size),
 				size
 			};
 		} finally {
@@ -9549,7 +9933,7 @@ var DocumentSaver = class {
 	*/
 	saveStandaloneToBufferEx(mode) {
 		const { mem, fn } = this.runtime;
-		const sizePtr = mem.alloc(4);
+		const sizePtr = mem.alloc(8);
 		const statusPtr = mem.alloc(4);
 		let pdfPtr = null;
 		try {
@@ -9564,11 +9948,8 @@ var DocumentSaver = class {
 			};
 			const size = Number(mem.peek(sizePtr, "i32"));
 			if (!pdfPtr || size <= 0 || status !== EPDF_SAVE_WRITTEN) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.DocOpenFailed, "failed to save document");
-			const bytes = mem.readBytes(pdfPtr, size);
-			const buffer = new ArrayBuffer(bytes.byteLength);
-			new Uint8Array(buffer).set(bytes);
 			return {
-				bytes: buffer,
+				bytes: readSavedBuffer(mem, pdfPtr, size),
 				size,
 				unchangedSinceLoad: false
 			};
@@ -11980,6 +12361,7 @@ function searchQueryKey(query, mode) {
 		query.matchCase ? 1 : 0,
 		query.matchDiacritics ? 1 : 0,
 		query.wholeWord ? 1 : 0,
+		query.ignoreWhitespace ? 1 : 0,
 		mode
 	]);
 }
@@ -12080,7 +12462,7 @@ var SearchReader = class {
 			const text = corpus.snapshot.text;
 			let ranges;
 			if (query.regex) ranges = (0, _embedpdf_engine_core_runtime.matchRegex)(text, query);
-			else if (query.matchCase || query.matchDiacritics) ranges = (0, _embedpdf_engine_core_runtime.matchLiteral)((0, _embedpdf_engine_core_runtime.foldText)(text, (0, _embedpdf_engine_core_runtime.foldOptionsFor)(query)), query);
+			else if (query.matchCase || query.matchDiacritics || query.ignoreWhitespace) ranges = (0, _embedpdf_engine_core_runtime.matchLiteral)((0, _embedpdf_engine_core_runtime.foldText)(text, (0, _embedpdf_engine_core_runtime.foldOptionsFor)(query)), query);
 			else ranges = (0, _embedpdf_engine_core_runtime.matchLiteral)(corpus.folded, query);
 			if (ranges.length > 0) {
 				const layout = (0, _embedpdf_engine_core_runtime.buildPageTextLayout)(new PageGeometryReader(this.runtime, this.session).read(pon, signal));
@@ -12178,6 +12560,100 @@ function requireAction(action, owner, index) {
 	throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.MalformedPdf, `failed to read ${owner}`, { details: { index } });
 }
 //#endregion
+//#region src/features/measure/internal/readViewports.ts
+const CALIBRATION_NAME = "EmbedPDF";
+function readViewports(fn, mem, page) {
+	const viewports = [];
+	for (let i = 0; i < fn.EPDFPage_CountViewports(page); i++) {
+		const viewport = fn.EPDFPage_GetViewport(page, i);
+		if (!viewport) continue;
+		const bbox = withScratch(mem, 16, (p) => fn.EPDFViewport_GetBBox(viewport, p) ? (0, _embedpdf_engine_core_runtime.normalizePdfRect)(readRectF(mem, p)) : void 0);
+		if (!bbox) continue;
+		const name = readUtf16String(mem, (p, n) => fn.EPDFViewport_GetName(viewport, p, n));
+		const measure = readMeasure(fn, mem, fn.EPDFViewport_GetMeasure(viewport));
+		viewports.push({
+			bbox,
+			owned: name === "EmbedPDF" && (!measure || measure.subtype === "RL"),
+			...name !== null ? { name } : {},
+			...measure ? { measure } : {}
+		});
+	}
+	return viewports;
+}
+//#endregion
+//#region src/features/measure/MeasureReader.ts
+var MeasureReader = class {
+	constructor(runtime, session) {
+		this.runtime = runtime;
+		this.session = session;
+	}
+	viewports(pon, signal) {
+		throwIfAborted(signal);
+		const pool = this.session.pagePool(), page = pool.acquire(pon);
+		try {
+			return readViewports(this.runtime.fn, this.runtime.mem, page);
+		} finally {
+			pool.release(pon);
+		}
+	}
+};
+//#endregion
+//#region src/features/measure/MeasureMutator.ts
+var MeasureMutator = class {
+	constructor(runtime, session) {
+		this.runtime = runtime;
+		this.session = session;
+	}
+	setScale(pon, measure, signal) {
+		throwIfAborted(signal);
+		if (measure !== null) try {
+			(0, _embedpdf_engine_core_runtime.assertWritableMeasure)(measure);
+		} catch (e) {
+			throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, e.message);
+		}
+		const { fn, mem } = this.runtime, pool = this.session.pagePool(), page = pool.acquire(pon);
+		try {
+			const owned = [];
+			for (let i = 0; i < fn.EPDFPage_CountViewports(page); i++) {
+				const vp = fn.EPDFPage_GetViewport(page, i);
+				if (!vp || readUtf16String(mem, (p, n) => fn.EPDFViewport_GetName(vp, p, n)) !== "EmbedPDF") continue;
+				const m = fn.EPDFViewport_GetMeasure(vp);
+				if (!m || fn.EPDFMeasure_GetSubtype(m) === 1) owned.push(i);
+			}
+			const bbox = withScratch(mem, 16, (p) => {
+				const index = this.session.recordByObjectNumber(pon).pageIndex;
+				const doc = this.session.requireDocPtr();
+				if (!fn.EPDF_GetPageBoxByIndex(doc, index, 1, p) && !fn.EPDF_GetPageBoxByIndex(doc, index, 0, p)) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "Page has no valid calibration box");
+				return (0, _embedpdf_engine_core_runtime.normalizePdfRect)(readRectF(mem, p));
+			});
+			if (![
+				bbox.left,
+				bbox.right,
+				bbox.bottom,
+				bbox.top
+			].every(Number.isFinite)) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "Invalid calibration box");
+			throwIfAborted(signal);
+			if (measure === null) {
+				for (const i of owned.reverse()) requireMeasureWrite(fn.EPDFPage_RemoveViewport(page, i));
+				return;
+			}
+			withScratch(mem, 16, (p) => {
+				mem.poke(p, "f32", bbox.left);
+				mem.poke(p, "f32", bbox.top, 4);
+				mem.poke(p, "f32", bbox.right, 8);
+				mem.poke(p, "f32", bbox.bottom, 12);
+				const vp = owned.length ? fn.EPDFPage_GetViewport(page, owned[owned.length - 1]) : fn.EPDFPage_AddViewport(page, p);
+				requireMeasureWrite(vp);
+				requireMeasureWrite(fn.EPDFViewport_SetBBox(vp, p));
+				requireMeasureWrite(writeUtf16String(mem, CALIBRATION_NAME, (name) => fn.EPDFViewport_SetName(vp, name)));
+				writeMeasure(fn, mem, fn.EPDFViewport_AddMeasure(vp), measure);
+			});
+		} finally {
+			pool.release(pon);
+		}
+	}
+};
+//#endregion
 //#region src/features/pieceinfo/PieceInfoAccessor.ts
 const OBJ_BOOLEAN = 1;
 const OBJ_NUMBER = 2;
@@ -12578,6 +13054,12 @@ var WorkerHost = class {
 				case "annotations.readFile":
 					resultPack = this.handleAnnotationsReadFile(msg, ctrl.signal);
 					break;
+				case "measure.viewports":
+					resultPack = this.handleMeasureViewports(msg, ctrl.signal);
+					break;
+				case "measure.setScale":
+					resultPack = this.handleMeasureSetScale(msg, ctrl.signal);
+					break;
 				case "pieceInfo.read":
 					resultPack = this.handlePieceInfoRead(msg, ctrl.signal);
 					break;
@@ -13108,6 +13590,27 @@ var WorkerHost = class {
 			content
 		}, content.bytes !== void 0 ? [content.bytes] : []);
 	}
+	handleMeasureViewports(req, signal) {
+		const session = this.requireSession(req);
+		return (0, _embedpdf_engine_core_runtime.wirePack)({
+			tag: "measure.viewports",
+			viewports: new MeasureReader(this.runtime, session).viewports(req.pageObjectNumber, signal)
+		});
+	}
+	handleMeasureSetScale(req, signal) {
+		const session = this.requireSession(req);
+		new MeasureMutator(this.runtime, session).setScale(req.pageObjectNumber, req.measure, signal);
+		return this.finishMutation(session, {
+			tag: "measure.setScale",
+			result: {
+				pageObjectNumber: req.pageObjectNumber,
+				meta: {
+					affectedPages: [],
+					cacheDelta: null
+				}
+			}
+		}, req.artifactPath);
+	}
 	handlePieceInfoRead(req, signal) {
 		const session = this.requireSession(req);
 		return (0, _embedpdf_engine_core_runtime.wirePack)({
@@ -13656,6 +14159,7 @@ const MUTATING_KINDS = /* @__PURE__ */ new Set([
 	"redaction.apply",
 	"attachments.create",
 	"attachments.delete",
+	"measure.setScale",
 	"pieceInfo.update",
 	"pieceInfo.clear"
 ]);