@embedpdf/plugin-annotation 3.0.0-next.6 → 3.0.0-next.7

package/dist/{capability-BMBwSdaY.cjs → capability-2FkTVblD.cjs}

@@ -10,7 +10,7 @@ let _embedpdf_core_geometry = require("@embedpdf/core-geometry");
 * here (the package internals + the `/internal` entry use this view). The package
 * root re-exports the SAME token narrowed to {@link AnnotationCapability}.
 */
-const AnnotationToken = (0, _embedpdf_core.createCapabilityToken)("annotation");
+const AnnotationToken = (0, _embedpdf_core.createCapabilityToken)("annotation", { hint: `add annotationPlugin() from '@embedpdf/plugin-annotation' to your plugins list` });
 //#endregion
 //#region src/repository/seam.ts
 function refKey(ref) {
@@ -1126,6 +1126,17 @@ const TOOL_DEFAULT_KEYS = {
 const DRAW_TAGS = ["annotation-draw", "annotation-edit"];
 const MARKUP_TAGS = ["text-select", "annotation-edit"];
 /**
+* Whether arming this ANNOTATION tool is touch consent (`Tool.touchDirect`):
+* drag-CREATE tools — shape/ink draw and text-markup select — take
+* single-finger touch wholesale (finger draws/marks, two fingers navigate:
+* the drawing-app convention). Click-to-PLACE tools (stamp, note) do not: a
+* tap places without any claim, and drags keep scrolling. Derived from the
+* gesture tags, so custom registered tools inherit the right behavior. Only
+* annotation-owned tools run through this — the built-in `pointer` tool also
+* enables `text-select`, but it is registered by the hub, not here.
+*/
+const isTouchDirect = (enables) => enables.has("annotation-draw") || enables.has("text-select");
+/**
 * The built-in tools — a data mirror of v2's registrations (shapes + lines + ink
 * + free text in the draw channel, text markup + caret behind text selection, and
 * the click-to-place stamp). Order is display-neutral; the toolbar owns layout.
@@ -1560,16 +1571,23 @@ function createAnnotationCapability(ctx, config = {}) {
 	};
 	/** The CSS-px chrome settings converted to CONTENT units by the page's view
 	*  scale (px per content unit) — screen-constant grab zones + stalk at every
-	*  zoom. No scale → the values are read as content units (headless callers). */
-	const chromeGeomAt = (scale) => {
+	*  zoom. No scale → the values are read as content units (headless callers).
+	*  `boost` widens the GRAB tolerances only (never the drawn chrome or the
+	*  knob's position) — the touch path passes {@link TOUCH_GRAB_BOOST} so
+	*  handles present finger-sized targets. */
+	const chromeGeomAt = (scale, boost = 1) => {
 		const cs = chromeSettings();
 		const s = scale || 1;
 		return {
-			handleTol: cs.handles.hitSize / 2 / s,
-			knobTol: cs.knob.hitSize / 2 / s,
+			handleTol: cs.handles.hitSize / 2 / s * boost,
+			knobTol: cs.knob.hitSize / 2 / s * boost,
 			knobOffset: cs.knob.offset / s
 		};
 	};
+	/** Finger-sized grab zones: 2× the mouse tolerances lands a ~24px handle hit
+	*  box in Apple's ~44pt-target territory without moving any visuals. */
+	const TOUCH_GRAB_BOOST = 2;
+	const grabBoost = (touch) => touch ? TOUCH_GRAB_BOOST : 1;
 	const itemsCache = /* @__PURE__ */ new Map();
 	const chromeCache = /* @__PURE__ */ new Map();
 	const memoItems = (pon, view) => {
@@ -2340,7 +2358,8 @@ function createAnnotationCapability(ctx, config = {}) {
 			const un = ctx.tryGet(_embedpdf_plugin_interaction.InteractionToken)?.registerTool({
 				id: resolved.id,
 				cursor: resolved.cursor,
-				enables: resolved.enables
+				enables: resolved.enables,
+				touchDirect: isTouchDirect(resolved.enables)
 			});
 			if (resolved.defaults) apply({
 				t: "setDefaults",
@@ -2396,7 +2415,14 @@ function createAnnotationCapability(ctx, config = {}) {
 		selectionAnchor: (scale, rotation, zoom) => memoAnchor(scale, rotation, zoom),
 		creationDraftAnchor: () => memoDraftAnchor(),
 		selection: () => model().selected,
-		hitKind: (pon, point, scale, rotation, zoom) => (0, _embedpdf_core_annotation.hitTest)(model(), pon, point, chromeGeomAt(scale), model().hitMargin, pageBoxOf(pon), inertIdsAt(pon), viewEnv(zoom, rotation)).t,
+		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) => {
+			const m = model();
+			const t = (0, _embedpdf_core_annotation.hitTest)(m, pon, point, chromeGeomAt(scale, TOUCH_GRAB_BOOST), m.hitMargin, pageBoxOf(pon), inertIdsAt(pon), viewEnv(zoom, rotation));
+			if (t.t === "handle" || t.t === "rotate" || t.t === "group-handle") return true;
+			if (t.t === "annot") return m.selected.includes(t.id) && m.selected.every((id) => (0, _embedpdf_core_annotation.canMove)(m, id));
+			return false;
+		},
 		cursorAt: (pon, point, scale, rotation, zoom) => (0, _embedpdf_core_annotation.cursorAt)(model(), pon, point, chromeGeomAt(scale), model().hitMargin, pageBoxOf(pon), inertIdsAt(pon), viewEnv(zoom, rotation)),
 		hoverAt: (at) => {
 			const m = model();
@@ -2435,7 +2461,7 @@ function createAnnotationCapability(ctx, config = {}) {
 			const crop = cropOf(pon);
 			return crop ? (0, _embedpdf_core_annotation.pdfToContentRect)(rect, crop) : null;
 		},
-		editPointer: (phase, pon, point, shift, scale, rotation, zoom) => apply({
+		editPointer: (phase, pon, point, shift, scale, rotation, zoom, touch) => apply({
 			t: "editPointer",
 			phase,
 			in: {
@@ -2443,7 +2469,7 @@ function createAnnotationCapability(ctx, config = {}) {
 				point,
 				shift,
 				pageBox: pageBoxOf(pon),
-				chrome: chromeGeomAt(scale),
+				chrome: chromeGeomAt(scale, grabBoost(touch)),
 				inert: inertIdsAt(pon),
 				...zoom != null ? { zoom } : {},
 				...rotation != null ? { displayRotation: rotation } : {}
@@ -2659,10 +2685,14 @@ function createAnnotationCapability(ctx, config = {}) {
 			const m = model();
 			const h = (0, _embedpdf_core_annotation.hitTest)(m, pon, point, chromeGeomAt(scale), m.hitMargin, pageBoxOf(pon), void 0, viewEnv(zoom, rotation));
 			const id = h.t === "annot" || h.t === "handle" ? h.id : null;
-			if (id != null && m.byId[id]?.geom.t === "text") apply({
-				t: "beginTextEdit",
-				id
-			});
+			if (id != null && m.byId[id]?.geom.t === "text") {
+				apply({
+					t: "beginTextEdit",
+					id
+				});
+				return true;
+			}
+			return false;
 		},
 		setContents: (ref, text) => {
 			apply({
@@ -2736,6 +2766,12 @@ Object.defineProperty(exports, "fromDTO", {
 		return fromDTO;
 	}
 });
+Object.defineProperty(exports, "isTouchDirect", {
+	enumerable: true,
+	get: function() {
+		return isTouchDirect;
+	}
+});
 Object.defineProperty(exports, "refKey", {
 	enumerable: true,
 	get: function() {
@@ -2767,4 +2803,4 @@ Object.defineProperty(exports, "widgetAppearanceFromProps", {
 	}
 });
 
-//# sourceMappingURL=capability-BMBwSdaY.cjs.map
+//# sourceMappingURL=capability-2FkTVblD.cjs.map