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

package/dist/{capability-CYYDz4dW.js → capability-BNMRdnKf.js}

@@ -2,7 +2,7 @@ import { CONTINUOUS_RENDER_POLICY, createCapabilityToken, snapAppearanceScale }
 import { InteractionToken } from "@embedpdf/plugin-interaction";
 import { resolveBinarySource, sniffBinaryMetadata } from "@embedpdf/engine-core/runtime";
 import { SelectionToken } from "@embedpdf/plugin-selection";
-import { FLAG_KEYS, calloutLinePoints, chrome, clickCreateGeom, cloudyBorderExtent, contentToPdfPoint, contentToPdfRect, contentToPdfRect as contentToPdfRect$1, creationDraftAnchor, cursorAt, defaultsFor, expandGroups, fitStampBox, geomPdfBounds, geomRotation, geomVisualBounds, groupKeyOf, hitTest, initialTextStyle, normalizeDeg, pageItems, pdfToContentPoint, pdfToContentPoint as pdfToContentPoint$1, pdfToContentRect, pdfToContentRect as pdfToContentRect$1, propsFor, readProp, resolveClickPlacement, rotatedAabb, selectionAnchor, selectionQuad, sharedProps, styleFromProps, textBoxes, unionRect, update, uprightRotation, viewable } from "@embedpdf/core-annotation";
+import { FLAG_KEYS, calloutLinePoints, canMove, chrome, clickCreateGeom, cloudyBorderExtent, contentToPdfPoint, contentToPdfRect, contentToPdfRect as contentToPdfRect$1, creationDraftAnchor, cursorAt, defaultsFor, expandGroups, fitStampBox, geomPdfBounds, geomRotation, geomVisualBounds, groupKeyOf, hitTest, initialTextStyle, normalizeDeg, pageItems, pdfToContentPoint, pdfToContentPoint as pdfToContentPoint$1, pdfToContentRect, pdfToContentRect as pdfToContentRect$1, propsFor, readProp, resolveClickPlacement, rotatedAabb, selectionAnchor, selectionQuad, sharedProps, styleFromProps, textBoxes, unionRect, update, uprightRotation, viewable } from "@embedpdf/core-annotation";
 import { normalizeQuad, textQuadBounds } from "@embedpdf/core-geometry";
 //#region src/types.ts
 /**
@@ -10,7 +10,7 @@ import { normalizeQuad, textQuadBounds } from "@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 = createCapabilityToken("annotation");
+const AnnotationToken = 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(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) => hitTest(model(), pon, point, chromeGeomAt(scale), model().hitMargin, pageBoxOf(pon), inertIdsAt(pon), viewEnv(zoom, rotation)).t,
+		hitKind: (pon, point, scale, rotation, zoom, touch) => 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 = 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) => canMove(m, id));
+			return false;
+		},
 		cursorAt: (pon, point, scale, rotation, zoom) => 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 ? 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 = 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({
@@ -2706,6 +2736,6 @@ function createAnnotationCapability(ctx, config = {}) {
 	};
 }
 //#endregion
-export { toCreateDraft as a, styleFromDTO as c, fromDTO as i, widgetAppearanceFromProps as l, DEFAULT_TOOLS as n, toPatch as o, buildToolRegistry as r, refKey as s, createAnnotationCapability as t, AnnotationToken as u };
+export { fromDTO as a, refKey as c, AnnotationToken as d, isTouchDirect as i, styleFromDTO as l, DEFAULT_TOOLS as n, toCreateDraft as o, buildToolRegistry as r, toPatch as s, createAnnotationCapability as t, widgetAppearanceFromProps as u };
 
-//# sourceMappingURL=capability-CYYDz4dW.js.map
+//# sourceMappingURL=capability-BNMRdnKf.js.map