@embedpdf/plugin-annotation 3.0.0-next.13 → 3.0.0-next.14

package/dist/{capability-DVx1NmTe.cjs → capability-Bt320iJP.cjs}

@@ -1,5 +1,5 @@
 const require_seam = require("./seam-6pJeKOOJ.cjs");
-const require_tools = require("./tools-0NI3b9z8.cjs");
+const require_tools = require("./tools-B3i1gjRs.cjs");
 const require_types = require("./types-Dlhdw2k_.cjs");
 let _embedpdf_core = require("@embedpdf/core");
 let _embedpdf_plugin_actions_contract = require("@embedpdf/plugin-actions/contract");
@@ -107,6 +107,15 @@ const polyCloudy = (a) => a.geom.t === "poly" && a.geom.closed ? { cloudyIntensi
 /** The visual-bounds `/Rect` (stroke + border included) of a stroke geom. */
 const visualRect = (a, crop) => {
 	const g = a.geom;
+	if (a.measure) {
+		const bounds = (0, _embedpdf_core_annotation.measurementLayout)(g, a.measure, a.style)?.visualBounds;
+		if (bounds) return { rect: {
+			left: crop.left + bounds.x,
+			right: crop.left + bounds.x + bounds.width,
+			top: crop.top - bounds.y,
+			bottom: crop.top - bounds.y - bounds.height
+		} };
+	}
 	if (g.t === "line" || g.t === "ink") return { rect: (0, _embedpdf_core_annotation.geomPdfBounds)(g, a.style.strokeWidth, crop) };
 	if (g.t === "poly") return { rect: (0, _embedpdf_core_annotation.geomPdfBounds)(g, a.style.strokeWidth, crop, a.style.border) };
 	return {};
@@ -138,18 +147,29 @@ const strokeProps = {
 const line = {
 	ingest: (dto, crop) => {
 		const d = dto;
-		return { geom: {
-			t: "line",
-			a: (0, _embedpdf_core_annotation.pdfToContentPoint)(d.linePoints.start, crop),
-			b: (0, _embedpdf_core_annotation.pdfToContentPoint)(d.linePoints.end, crop),
-			ends: d.lineEndings,
-			...require_seam.rotFromDTO(d.rotation)
-		} };
+		return {
+			...d.intent === "LineDimension" ? { measure: {
+				intent: d.intent,
+				measure: d.measure ?? null,
+				caption: d.caption ?? { enabled: false },
+				leader: d.leader ?? void 0,
+				crop,
+				text: d.contents ?? ""
+			} } : {},
+			geom: {
+				t: "line",
+				a: (0, _embedpdf_core_annotation.pdfToContentPoint)(d.linePoints.start, crop),
+				b: (0, _embedpdf_core_annotation.pdfToContentPoint)(d.linePoints.end, crop),
+				ends: d.lineEndings,
+				...require_seam.rotFromDTO(d.rotation)
+			}
+		};
 	},
 	geometry: (a, crop) => {
 		const g = a.geom;
 		if (g.t !== "line") return null;
 		return {
+			...a.measure?.intent === "LineDimension" ? { contents: (0, _embedpdf_core_annotation.distanceLabel)(g, a.measure) } : {},
 			linePoints: {
 				start: (0, _embedpdf_core_annotation.contentToPdfPoint)(g.a, crop),
 				end: (0, _embedpdf_core_annotation.contentToPdfPoint)(g.b, crop)
@@ -158,29 +178,55 @@ const line = {
 			...advisoryRotation(g)
 		};
 	},
-	prop: strokeProps
+	prop: strokeProps,
+	draftExtras: (a) => a.measure?.intent === "LineDimension" ? {
+		intent: a.measure.intent,
+		measure: a.measure.measure?.subtype === "RL" ? a.measure.measure : null,
+		caption: a.measure.caption,
+		leader: a.measure.leader,
+		subject: "Distance"
+	} : {}
 };
 const polyProjection = (closed) => ({
 	ingest: (dto, crop) => {
 		const d = dto;
-		return { geom: {
-			t: "poly",
-			points: d.vertices.map((p) => (0, _embedpdf_core_annotation.pdfToContentPoint)(p, crop)),
-			closed,
-			..."lineEndings" in d ? { ends: d.lineEndings } : {},
-			...require_seam.rotFromDTO(d.rotation)
-		} };
+		return {
+			...d.intent === "PolygonDimension" || d.intent === "PolyLineDimension" ? { measure: {
+				intent: d.intent,
+				measure: d.measure ?? null,
+				caption: d.caption ?? { enabled: false },
+				crop,
+				text: d.contents ?? ""
+			} } : {},
+			geom: {
+				t: "poly",
+				points: d.vertices.map((p) => (0, _embedpdf_core_annotation.pdfToContentPoint)(p, crop)),
+				closed,
+				..."lineEndings" in d ? { ends: d.lineEndings } : {},
+				...require_seam.rotFromDTO(d.rotation)
+			}
+		};
 	},
 	geometry: (a, crop) => {
 		const g = a.geom;
 		if (g.t !== "poly") return null;
 		return {
+			...a.measure && a.measure.intent !== "LineDimension" ? {
+				contents: (0, _embedpdf_core_annotation.shapeMeasurementLabel)(g, a.measure),
+				caption: a.measure.caption
+			} : {},
 			vertices: g.points.map((p) => (0, _embedpdf_core_annotation.contentToPdfPoint)(p, crop)),
 			...visualRect(a, crop),
 			...advisoryRotation(g)
 		};
 	},
-	prop: strokeProps
+	prop: strokeProps,
+	draftExtras: (a) => a.measure && a.measure.intent !== "LineDimension" ? {
+		intent: a.measure.intent,
+		measure: a.measure.measure?.subtype === "RL" ? a.measure.measure : null,
+		caption: a.measure.caption,
+		subject: closed ? "Area" : "Perimeter"
+	} : {}
 });
 const polygon = polyProjection(true);
 const polyline = polyProjection(false);
@@ -1025,6 +1071,14 @@ function toPatch(a, crop) {
 */
 function toScopedPatch(a, scope, crop) {
 	const kind = projectionOf(a.subtype);
+	if (scope.kind === "caption") return a.measure ? {
+		subtype: wireSubtypeOf(a),
+		caption: a.measure.caption
+	} : null;
+	if (scope.kind === "leader") return a.measure?.intent === "LineDimension" ? {
+		subtype: "line",
+		leader: a.measure.leader
+	} : null;
 	if (scope.kind === "geometry") {
 		const geo = kind.geometry(a, crop);
 		return geo ? {
@@ -1215,6 +1269,12 @@ function createAnnotationCapability(ctx, config = {}) {
 	*  adapter), or null — every click-then-pick tool resolves through this ONE
 	*  slot. See {@link FilePickerProvider}. */
 	let filePickerProvider = null;
+	const pageViewports = /* @__PURE__ */ new Map();
+	const captured = /* @__PURE__ */ new Set();
+	ctx.cleanup(() => {
+		captured.clear();
+		pageViewports.clear();
+	});
 	const model = () => ctx.getState().model;
 	const actionsForHover = ctx.tryGet(_embedpdf_plugin_actions_contract.ActionsToken);
 	const hoverFeed = actionsForHover ? createAnnotationHoverFeed(actionsForHover, (id) => model().byId[id] ?? null) : null;
@@ -1811,8 +1871,8 @@ function createAnnotationCapability(ctx, config = {}) {
 	* changed the appearance (create / restyle / resize), `'baked'` when the AP is
 	* still authoritative (a move, which preserves it, or a remote edit).
 	* `bumpAp` marks the upsert as confirming an engine /AP re-bake with new
-	* content, so the annotation's `apVersion` — and with it the page's
-	* appearance epoch — advances and the shell fetches the fresh raster.
+	* content, advancing the annotation's `apVersion`. Only baked annotations
+	* contribute to the page's appearance epoch and trigger a raster fetch.
 	*/
 	const syncDTO = (dto, source, bumpAp = false) => {
 		const crop = cropOf(dto.pageObjectNumber);
@@ -1830,7 +1890,7 @@ function createAnnotationCapability(ctx, config = {}) {
 		const pon = ponForRef(ref);
 		if (pon == null) throw new Error("[annotation] cannot resolve page for ref");
 		const res = await doc.page(pon).annotations.update(ref, patch);
-		syncDTO(res.updated, "vector");
+		syncDTO(res.updated, "vector", res.appearance?.changed);
 	};
 	const commitText = (ref) => {
 		const key = require_seam.refKey(ref);
@@ -2131,7 +2191,9 @@ function createAnnotationCapability(ctx, config = {}) {
 			})).ref;
 		},
 		edit: async (ref, text) => {
-			const subtype = model().byId[require_seam.refKey(ref)]?.data?.subtype;
+			const data = model().byId[require_seam.refKey(ref)]?.data;
+			if (data && (0, _embedpdf_engine_core_runtime.isDimension)(data)) throw new Error("[annotation] measurement contents are derived");
+			const subtype = data?.subtype;
 			if (!subtype) throw new Error("[annotation] cannot edit an uncommitted annotation");
 			await updateOne(ref, {
 				subtype,
@@ -2201,7 +2263,7 @@ function createAnnotationCapability(ctx, config = {}) {
 				canSetStatus: allowsCreate(),
 				canEditText: (() => {
 					const a = model().byId[require_seam.refKey(ref)];
-					return !!a && (0, _embedpdf_core_annotation.annotContentsEditable)(a);
+					return !!a && !(a.data && (0, _embedpdf_engine_core_runtime.isDimension)(a.data)) && (0, _embedpdf_core_annotation.annotContentsEditable)(a);
 				})(),
 				canDelete: deletableOne(ref),
 				canDeleteThread: t !== null && threadMemberRefs(t).every(deletableOne)
@@ -2312,7 +2374,21 @@ function createAnnotationCapability(ctx, config = {}) {
 	function perform(fx, m) {
 		const doc = ctx.doc;
 		if (!doc) return;
-		if (fx.fx === "createGroup") {
+		if (fx.fx === "captured") {
+			const crop = cropOf(fx.pon);
+			if (crop && fx.geom.t === "line") {
+				const pdf = (p) => ({
+					x: p.x + crop.left,
+					y: crop.top - p.y
+				});
+				for (const cb of captured) cb({
+					tool: fx.tool,
+					pon: fx.pon,
+					from: pdf(fx.geom.a),
+					to: pdf(fx.geom.b)
+				});
+			}
+		} else if (fx.fx === "createGroup") {
 			const ids = [fx.primary, ...fx.members];
 			const annots = ids.map((id) => m.byId[id]);
 			const primary = annots[0];
@@ -2507,6 +2583,61 @@ function createAnnotationCapability(ctx, config = {}) {
 		});
 	};
 	return {
+		setPageViewports: (pon, viewports, fallback) => {
+			pageViewports.set(pon, {
+				viewports,
+				fallback
+			});
+		},
+		onDraftCaptured: (cb) => {
+			captured.add(cb);
+			return () => {
+				captured.delete(cb);
+			};
+		},
+		remeasurePage: async (pon, scale) => {
+			await rehydrate();
+			const report = {
+				pon,
+				scale,
+				updated: [],
+				skipped: [],
+				failed: []
+			};
+			const hydration = ctx.getState().hydration;
+			if (hydration.status !== "complete") {
+				report.error = (0, _embedpdf_engine_core_runtime.serializeError)(hydration.status === "error" ? hydration.error : /* @__PURE__ */ new Error("Annotation hydration is incomplete"));
+				return report;
+			}
+			const candidates = Object.values(model().byId).filter((a) => a.pon === pon && a.data && (0, _embedpdf_engine_core_runtime.isDimension)(a.data));
+			for (const a of candidates) {
+				const dto = a.data, ref = dto.ref;
+				const reason = a.authority?.update === false ? "no-authority" : !(0, _embedpdf_core_annotation.annotTransformable)(a) || !(0, _embedpdf_core_annotation.annotContentsEditable)(a) ? "locked" : "measure" in dto && dto.measure && dto.measure.subtype !== "RL" ? "foreign-measure" : !(0, _embedpdf_engine_core_runtime.isReadout)((0, _embedpdf_engine_core_runtime.measurementReadout)({
+					...dto,
+					measure: scale
+				})) ? "unavailable" : null;
+				if (reason) {
+					report.skipped.push({
+						ref,
+						reason
+					});
+					continue;
+				}
+				try {
+					await updateOne(ref, {
+						subtype: dto.subtype,
+						measure: scale
+					});
+					report.updated.push(ref);
+				} catch (error) {
+					report.failed.push({
+						ref,
+						error: (0, _embedpdf_engine_core_runtime.serializeError)(error)
+					});
+				}
+			}
+			return report;
+		},
 		create: async (pon, draft) => {
 			const doc = ctx.doc;
 			if (!doc) throw new Error("[annotation] no document bound");
@@ -2644,6 +2775,10 @@ function createAnnotationCapability(ctx, config = {}) {
 		chrome: (pon, scale, rotation, zoom) => memoChrome(pon, scale, rotation, zoom),
 		selectionAnchor: (scale, rotation, zoom) => memoAnchor(scale, rotation, zoom),
 		creationDraftAnchor: () => memoDraftAnchor(),
+		distanceCreationPage: () => {
+			const draft = model().draft;
+			return draft?.g === "create-distance" && draft.step === "offset" ? draft.pon : null;
+		},
 		selection: () => model().selected,
 		hitKind: (pon, point, scale, rotation, zoom, touch) => (0, _embedpdf_core_annotation.hitTest)(model(), pon, point, chromeGeomAt(scale, grabBoost(touch)), model().hitMargin, pageBoxOf(pon), inertIdsAt(pon), viewEnv(zoom, rotation)).t,
 		claimsTouchAt: (pon, point, scale, rotation, zoom) => {
@@ -2723,14 +2858,63 @@ function createAnnotationCapability(ctx, config = {}) {
 			}
 		}),
 		createPointer: (tool, phase, pon, point, finish = false, displayRotation) => {
-			if (!allowsCreate()) return;
 			const t = registry.get(tool);
+			if (t?.meta?.capture === true ? !ctx.doc?.security.allows("doc.annotate.modify") : !allowsCreate()) return;
+			const crop = cropOf(pon);
+			const cache = pageViewports.get(pon);
+			const draft = model().draft;
+			const continuingMeasurement = (draft?.g === "create-distance" || draft?.g === "create-poly") && draft.pon === pon && draft.preset === (t?.preset ?? tool);
+			const dimension = t && (0, _embedpdf_engine_core_runtime.isDimension)(t);
+			if (dimension && phase === "down" && !continuingMeasurement && (!crop || !cache?.viewports)) return;
+			const viewport = crop && cache?.viewports ? (0, _embedpdf_engine_core_runtime.viewportForPoint)(cache.viewports, {
+				x: point.x + crop.left,
+				y: crop.top - point.y
+			}) : void 0;
+			const measure = dimension && crop && cache ? {
+				intent: t.intent,
+				measure: viewport ? viewport.measure ?? null : cache.fallback,
+				caption: t.measurement?.caption ?? { enabled: true },
+				...t.intent === "LineDimension" ? { leader: t.measurement?.leader } : {},
+				crop,
+				text: ""
+			} : void 0;
+			if (measure && phase === "down" && !continuingMeasurement && !(0, _embedpdf_engine_core_runtime.isReadout)((0, _embedpdf_engine_core_runtime.measurementReadout)({
+				subtype: t.subtype,
+				intent: measure.intent,
+				measure: measure.measure,
+				linePoints: {
+					start: {
+						x: 0,
+						y: 0
+					},
+					end: {
+						x: 1,
+						y: 0
+					}
+				},
+				vertices: [
+					{
+						x: 0,
+						y: 0
+					},
+					{
+						x: 1,
+						y: 0
+					},
+					{
+						x: 1,
+						y: 1
+					}
+				]
+			}))) return;
 			apply({
 				t: "createPointer",
+				measure,
+				capture: t?.meta?.capture === true ? tool : void 0,
 				phase,
 				subtype: t?.subtype ?? tool,
 				preset: t?.preset ?? tool,
-				intent: t?.intent,
+				intent: t?.intent === "ink-highlight" ? t.intent : void 0,
 				clickCreate: t?.clickCreate,
 				flags: t?.flags,
 				deferInkCommit: (t?.ink?.groupStrokesMs ?? 0) > 0,
@@ -2746,6 +2930,7 @@ function createAnnotationCapability(ctx, config = {}) {
 				}
 			});
 		},
+		hasCreationDraft: () => model().draft?.g.startsWith("create-") ?? false,
 		finishCreationDraft: () => apply({ t: "finishCreationDraft" }),
 		finishInkDraft: () => apply({ t: "finishInkDraft" }),
 		cancelCreationDraft: () => apply({ t: "cancel" }),
@@ -3061,4 +3246,4 @@ Object.defineProperty(exports, "toPatch", {
 	}
 });
 
-//# sourceMappingURL=capability-DVx1NmTe.cjs.map
+//# sourceMappingURL=capability-Bt320iJP.cjs.map