@embedpdf/plugin-link 3.0.0-next.14 → 3.0.0-next.16

package/dist/index.cjs

@@ -1,197 +1,246 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_contract = require("./contract-DGKEPl11.cjs");
+const require_contract = require("./contract-DXB_v4as.cjs");
+const require_contract_host = require("./contract/host.cjs");
 let _embedpdf_core = require("@embedpdf/core");
 let _embedpdf_plugin_actions_contract = require("@embedpdf/plugin-actions/contract");
 let _embedpdf_plugin_annotation_contract = require("@embedpdf/plugin-annotation/contract");
-let _embedpdf_plugin_annotation_contract_host = require("@embedpdf/plugin-annotation/contract/host");
 let _embedpdf_plugin_interaction_contract = require("@embedpdf/plugin-interaction/contract");
 let _embedpdf_plugin_stage_contract = require("@embedpdf/plugin-stage/contract");
-let _embedpdf_plugin_stage_destination = require("@embedpdf/plugin-stage/destination");
-let _embedpdf_core_annotation = require("@embedpdf/core-annotation");
+let _embedpdf_plugin_annotation_contract_host = require("@embedpdf/plugin-annotation/contract/host");
+let _embedpdf_plugin_interaction_contract_host = require("@embedpdf/plugin-interaction/contract/host");
+let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
+//#region src/connect.ts
+/**
+* Links are annotations: while a navigation tool is active the link layer
+* owns their input (its anchors take the clicks), so the annotation plane
+* stands down for them. A link still shows as the file draws it.
+*/
+function connectLink(ctx) {
+	const annotation = ctx.tryGet(_embedpdf_plugin_annotation_contract_host.AnnotationToken);
+	if (!annotation) return;
+	const interaction = ctx.get(_embedpdf_plugin_interaction_contract_host.InteractionToken);
+	ctx.cleanup(annotation.registerBehavior({
+		id: "link-nav",
+		matches: (target) => target.subtype === "link",
+		engaged: () => interaction.activeToolEnables("link-nav")
+	}));
+}
+//#endregion
 //#region src/source.ts
-function loadLinksPage(io, pon) {
-	const doc = io.doc;
-	const crop = io.document()?.pages.find((p) => p.pageObjectNumber === pon)?.boxes.crop;
-	if (!doc || !crop) return;
-	doc.page(pon).annotations.list().then((snap) => {
-		const items = [];
-		for (const dto of snap.annotations) {
-			if (dto.subtype !== "link" || dto.target == null) continue;
-			if (dto.flags.hidden || dto.flags.noView) continue;
-			items.push({
-				id: dto.ref.kind === "objectNumber" ? `obj:${dto.ref.annotObjectNumber}` : `idx:${pon}:${dto.index}`,
-				rect: (0, _embedpdf_core_annotation.pdfToContentRect)(dto.rect, crop),
-				target: dto.target,
-				...dto.actions?.activate ? { activate: dto.actions.activate } : {},
-				...dto.actions?.cursorEnter?.root || dto.actions?.cursorExit?.root ? { hoverEvents: {
-					enter: Boolean(dto.actions?.cursorEnter?.root),
-					exit: Boolean(dto.actions?.cursorExit?.root)
-				} } : {},
-				ref: dto.ref,
-				attached: dto.replyType === "group" && dto.inReplyTo != null
-			});
-		}
-		io.dispatch({
-			type: "SET_PAGE",
-			pon,
-			items
+/**
+* The stand-alone source, used when no annotation plugin is installed: the
+* clickable areas among one page's annotations, in page space.
+*/
+/** The visible link annotations of a page that have a target. */
+function linksOf(annotations) {
+	const links = [];
+	for (const dto of annotations) {
+		if (dto.subtype !== "link" || dto.target == null) continue;
+		if (dto.hidden || dto.noView) continue;
+		links.push({
+			id: (0, _embedpdf_engine_core_runtime.annotationKey)(dto.ref),
+			bounds: dto.rect,
+			target: dto.target,
+			...dto.actions?.activate ? { activate: dto.actions.activate } : {},
+			...dto.actions?.cursorEnter?.root || dto.actions?.cursorExit?.root ? { hoverEvents: {
+				enter: Boolean(dto.actions?.cursorEnter?.root),
+				exit: Boolean(dto.actions?.cursorExit?.root)
+			} } : {},
+			ref: dto.ref,
+			attached: dto.reply?.type === "group"
 		});
-	}, () => {});
+	}
+	return links;
 }
 //#endregion
-//#region src/capability.ts
-const EMPTY = [];
+//#region src/controller.ts
+const EMPTY = Object.freeze([]);
+const isLink = (value) => "target" in value && "bounds" in value;
+const contains = (bounds, point) => point.x >= bounds.x && point.x <= bounds.x + bounds.width && point.y >= bounds.y && point.y <= bounds.y + bounds.height;
+/** The pages whose annotation lists an event changed, each once. */
+function pagesChangedBy(event) {
+	switch (event.type) {
+		case "annotations.created": return [event.annotation.page];
+		case "annotations.updated": return [event.annotation.page];
+		case "annotations.deleted":
+		case "annotations.reordered": return [event.page];
+		case "redaction.applied":
+		case "pages.flattened": return event.results.filter((result) => result.status === "applied").map((result) => result.page);
+		case "annotations.flattened": return event.results.some((result) => result.status === "applied") ? [event.page] : null;
+		default: return null;
+	}
+}
 /**
-* The navigation plane's surface. Data source is decided PER CALL (lazily,
-* so plugin registration order can't matter): the annotation plugin's
-* folded model when present — its `linkItemsOn` lens is memoized by model
-* identity and already excludes hidden links — else this plugin's own
-* engine-backed page cache (see source.ts).
+* The link controller. Two sources for the clickable areas: the annotation
+* plugin's folded model when it is installed (always current), else a page
+* mirror of this plugin's own per-page reads, re-read when a confirmed
+* change (an annotation write, a redaction, a flatten) touches a loaded page. Activation is pure resolution
+* (`resolve`) plus the one side effect this plugin owns, a stage reveal;
+* everything else is reported to the host, which keeps the user gesture.
 */
-function createLinkCapability(ctx, config = {}) {
-	const anno = () => ctx.tryGet(_embedpdf_plugin_annotation_contract_host.AnnotationToken);
-	const activate = (target, context) => {
-		const activation = (() => {
-			const actions = ctx.tryGet(_embedpdf_plugin_actions_contract.ActionsToken);
-			if (actions && context?.activate) return {
-				outcome: "dispatched",
-				dispatch: actions.execute(context.activate, {
-					origin: "user",
-					source: {
-						kind: "link",
-						annotation: context.ref,
-						pon: context.pon
-					},
-					event: { scope: "activate" }
-				})
-			};
-			switch (target.kind) {
-				case "goto": {
-					const stage = ctx.tryGet(_embedpdf_plugin_stage_contract.StageToken);
-					const layout = ctx.document()?.pages.find((p) => p.pageObjectNumber === target.destination.pageObjectNumber);
-					if (!stage || !layout) return {
-						outcome: "destination",
-						destination: target.destination
-					};
-					const { pageIndex, options } = (0, _embedpdf_plugin_stage_destination.destinationToReveal)(target.destination, layout);
-					stage.reveal(pageIndex, {
-						...options,
-						behavior: "smooth"
-					});
-					return { outcome: "revealed" };
-				}
-				case "uri": return {
-					outcome: "uri",
-					uri: target.uri
+function createLinkController(ctx) {
+	const annotationHost = () => ctx.tryGet(_embedpdf_plugin_annotation_contract_host.AnnotationToken);
+	const activated = ctx.events.source();
+	const loaded = ctx.events.source();
+	const pages = ctx.pageMirror({
+		name: "links",
+		load: async (doc, page) => {
+			if (!ctx.getPage(page)) throw new _embedpdf_core.PluginError("not-found", "link", `page ${page.objectNumber} is not in this document`);
+			return linksOf((await doc.page(page).annotations.list()).annotations);
+		},
+		affected: pagesChangedBy,
+		changed: ({ page, cause }) => {
+			if (cause === "load") loaded.emit({ page });
+		}
+	});
+	const listLinks = (pageArgument) => {
+		const page = ctx.getPage(pageArgument)?.ref;
+		if (!page) return EMPTY;
+		const host = annotationHost();
+		if (host) return host.listLinkItems(page);
+		return pages.get(page) ?? EMPTY;
+	};
+	const ensureLoaded = async (pageArgument, options) => {
+		const { ref } = ctx.pageOf(pageArgument);
+		if (annotationHost()) return;
+		await ctx.cancellable(options?.signal, pages.ensureLoaded(ref));
+	};
+	const uriOpeners = [];
+	const resolve = (target) => require_contract.resolveLinkTarget(target, (page) => ctx.getPage(page) !== null);
+	const perform = (target, context) => {
+		const actions = ctx.tryGet(_embedpdf_plugin_actions_contract.ActionsToken);
+		if (actions && context?.activate) return {
+			outcome: "dispatched",
+			dispatch: actions.execute(context.activate, {
+				origin: "user",
+				source: {
+					kind: "link",
+					annotation: context.ref,
+					page: context.page
+				},
+				event: { scope: "activate" }
+			})
+		};
+		const resolution = resolve(target);
+		switch (resolution.kind) {
+			case "destination": {
+				const stage = context?.stage ?? ctx.tryGet(_embedpdf_plugin_stage_contract.StageToken);
+				if (!stage) return {
+					outcome: "destination",
+					destination: resolution.destination
 				};
-				case "named": return {
-					outcome: "named",
-					name: target.name
+				stage.goToDestination(resolution.destination);
+				return { outcome: "revealed" };
+			}
+			case "uri": {
+				const open = uriOpeners[0];
+				if (!open || open(resolution.uri)) return {
+					outcome: "uri",
+					uri: resolution.uri
 				};
-				default: return {
+				return {
 					outcome: "reported",
 					target
 				};
 			}
-		})();
-		config.onActivate?.({
+			case "named": return {
+				outcome: "named",
+				name: resolution.name
+			};
+			default: return {
+				outcome: "reported",
+				target
+			};
+		}
+	};
+	const activate = (input, context) => {
+		const target = isLink(input) ? input.target : input;
+		const linkContext = isLink(input) ? {
+			activate: input.activate,
+			ref: input.ref,
+			...context
+		} : context;
+		const activation = perform(target, linkContext);
+		activated.emit({
 			target,
 			activation
 		});
 		return activation;
 	};
-	return {
-		linksOn: (pon) => {
-			const host = anno();
-			if (host) return host.linkItemsOn(pon);
-			return ctx.getState().pages[pon] ?? EMPTY;
-		},
-		ensurePage: (pon) => {
-			const host = anno();
-			if (host) {
-				host.ensurePage(pon);
-				return;
-			}
-			if (!(pon in ctx.getState().pages)) loadLinksPage(ctx, pon);
-		},
-		engaged: () => ctx.tryGet(_embedpdf_plugin_interaction_contract.InteractionToken)?.activeTool()?.enables.has("link-nav") ?? false,
-		activate
-	};
-}
-//#endregion
-//#region src/effects.ts
-/**
-* Keeps the ENGINE-BACKED page cache honest in viewer-only deployments:
-* any annotation mutation on a cached page (own or remote — the cache has
-* no other refresh path, unlike the annotation plugin's optimistic model)
-* refetches that page's links. With the annotation plugin present the
-* folded model is the source and this effect never fires a fetch.
-*/
-function registerLinkEffects(ctx) {
-	const doc = ctx.doc;
-	if (!doc) return;
-	const refetch = (pon) => {
-		if (ctx.tryGet(_embedpdf_plugin_annotation_contract_host.AnnotationToken)) return;
-		if (pon in ctx.getState().pages) loadLinksPage(ctx, pon);
+	const getLinkAt = (page, point) => {
+		let best = null;
+		for (const link of listLinks(page)) {
+			if (!contains(link.bounds, point)) continue;
+			if (!best || link.bounds.width * link.bounds.height < best.bounds.width * best.bounds.height) best = link;
+		}
+		return best;
 	};
-	const unsubscribe = doc.events.subscribe((event) => {
-		switch (event.type) {
-			case "annotation.created":
-				refetch(event.created.pageObjectNumber);
-				break;
-			case "annotation.updated":
-				refetch(event.updated.pageObjectNumber);
-				break;
-			case "annotation.moved":
-				if (event.moved.length) refetch(event.moved[0].pageObjectNumber);
-				break;
-			case "annotation.deleted":
-				refetch(event.pageObjectNumber);
-				break;
-			default: break;
+	const getLabel = (input) => {
+		const target = isLink(input) ? input.target : input;
+		switch (target.kind) {
+			case "uri": return target.uri;
+			case "goto": return "Go to destination";
+			case "named": return target.name;
+			default: return "Link";
 		}
-	});
-	ctx.cleanup(unsubscribe);
-}
-//#endregion
-//#region src/reducer.ts
-const initialLinkState = () => ({ pages: {} });
-/** Pure. Engine-backed page cache only — the annotation-backed mode reads the
-*  annotation plugin's model and never touches this state. */
-function linkReducer(state, a) {
-	switch (a.type) {
-		case "SET_PAGE": return {
-			...state,
-			pages: {
-				...state.pages,
-				[a.pon]: a.items
-			}
-		};
-		case "DROP_PAGE": {
-			if (!(a.pon in state.pages)) return state;
-			const pages = { ...state.pages };
-			delete pages[a.pon];
-			return {
-				...state,
-				pages
-			};
+	};
+	return {
+		api: {
+			listLinks,
+			getLink: (page, linkId) => listLinks(page).find((link) => link.id === linkId) ?? null,
+			getLinkAt,
+			listAllLinks: async (options) => {
+				const layouts = ctx.document()?.pages ?? [];
+				await ctx.cancellable(options?.signal, Promise.all(layouts.map((layout) => ensureLoaded(layout.ref, options))));
+				return layouts.flatMap((layout) => listLinks(layout.ref));
+			},
+			ensureLoaded,
+			isLoaded: (page) => {
+				const ref = ctx.getPage(page)?.ref;
+				return !!ref && (annotationHost() !== null || pages.getStatus(ref) === "ready");
+			},
+			getStatus: (page) => {
+				const ref = ctx.getPage(page)?.ref;
+				if (!ref) return "idle";
+				return annotationHost() ? "ready" : pages.getStatus(ref);
+			},
+			resolve,
+			activate,
+			activateAt: (pageArgument, point, context) => {
+				const page = ctx.pageOf(pageArgument).ref;
+				const link = getLinkAt(page, point);
+				return link ? activate(link, {
+					page,
+					...context
+				}) : null;
+			},
+			getLabel,
+			onActivated: activated.on,
+			onLoaded: loaded.on,
+			registerUriOpener: (opener) => {
+				uriOpeners.unshift(opener);
+				return () => {
+					const index = uriOpeners.indexOf(opener);
+					if (index >= 0) uriOpeners.splice(index, 1);
+				};
+			},
+			isNavigationEngaged: () => ctx.tryGet(_embedpdf_plugin_interaction_contract_host.InteractionToken)?.activeToolEnables("link-nav") ?? false
+		},
+		connect() {
+			connectLink(ctx);
 		}
-	}
+	};
 }
 //#endregion
 //#region src/link.plugin.ts
 /**
-* The link plugin: the NAVIGATION plane. Document-scoped; requires only the
-* interaction hub. Navigation works with no annotation plugin at all —
-* links are read from the engine's link DTOs. When the annotation plugin IS
-* present, its folded model becomes the data source (no double fetch) and a
-* Behavior keeps links navigation-owned while a `link-nav` tool is active
-* (pointer/pan/form-fill by default) — the single-active-tool hub IS the
-* mode switch: grab the link tool and every link becomes an editable rect.
+* Clickable link regions and their activation. Document-scoped; needs the
+* interaction hub (the navigation tool tag), optionally the stage (reveal),
+* the annotation plugin (the folded link model) and actions (`/A` trees).
 */
-const linkPlugin = (config) => (0, _embedpdf_core.definePlugin)({
+const linkPlugin = () => (0, _embedpdf_core.definePlugin)({
 	id: "link",
-	token: require_contract.LinkToken,
+	token: require_contract_host.LinkToken,
 	scope: "document",
 	requires: [_embedpdf_plugin_interaction_contract.InteractionToken],
 	optional: [
@@ -199,22 +248,11 @@ const linkPlugin = (config) => (0, _embedpdf_core.definePlugin)({
 		_embedpdf_plugin_annotation_contract.AnnotationToken,
 		_embedpdf_plugin_actions_contract.ActionsToken
 	],
-	initialState: initialLinkState,
-	reduce: linkReducer,
-	capability: (ctx) => createLinkCapability(ctx, config),
-	effects: registerLinkEffects,
-	init: (ctx) => {
-		const interaction = ctx.get(_embedpdf_plugin_interaction_contract.InteractionToken);
-		const annotation = ctx.tryGet(_embedpdf_plugin_annotation_contract_host.AnnotationToken);
-		if (annotation) annotation.registerBehavior({
-			id: "link-nav",
-			matches: (a) => a.subtype === "link",
-			engaged: () => interaction.activeTool()?.enables.has("link-nav") ?? false
-		});
-	}
+	create: createLinkController
 });
 //#endregion
 exports.LinkToken = require_contract.LinkToken;
 exports.linkPlugin = linkPlugin;
+exports.resolveLinkTarget = require_contract.resolveLinkTarget;
 
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["AnnotationHostToken","ActionsToken","StageToken","InteractionToken","AnnotationHostToken","LinkToken","InteractionToken","StageToken","AnnotationToken","ActionsToken","AnnotationHostToken"],"sources":["../src/source.ts","../src/capability.ts","../src/effects.ts","../src/reducer.ts","../src/link.plugin.ts"],"sourcesContent":["import type { DocumentHandle, PageLayout } from '@embedpdf/core';\nimport { pdfToContentRect } from '@embedpdf/core-annotation';\nimport type { LinkAction, LinkNavItem } from './types';\n\n/**\n * The ENGINE-BACKED link source, for viewer-only deployments (no annotation\n * plugin): read a page's annotation list and keep just the navigable links —\n * standalone AND attached children alike (both are raw link DTOs here).\n * Shared by the capability's lazy `ensurePage` and the effects module's\n * event-driven refetch; both PluginContext and EffectContext satisfy the\n * structural `io` slice.\n */\nexport interface LinkSourceIO {\n  doc: DocumentHandle | null;\n  document(): { pages: readonly PageLayout[] } | null;\n  dispatch(action: LinkAction): void;\n}\n\nexport function loadLinksPage(io: LinkSourceIO, pon: number): void {\n  const doc = io.doc;\n  const crop = io.document()?.pages.find((p) => p.pageObjectNumber === pon)?.boxes.crop;\n  if (!doc || !crop) return;\n  doc\n    .page(pon)\n    .annotations.list()\n    .then(\n      (snap) => {\n        const items: LinkNavItem[] = [];\n        for (const dto of snap.annotations) {\n          if (dto.subtype !== 'link' || dto.target == null) continue;\n          if (dto.flags.hidden || dto.flags.noView) continue;\n          items.push({\n            id:\n              dto.ref.kind === 'objectNumber'\n                ? `obj:${dto.ref.annotObjectNumber}`\n                : `idx:${pon}:${dto.index}`,\n            rect: pdfToContentRect(dto.rect, crop),\n            target: dto.target,\n            ...(dto.actions?.activate ? { activate: dto.actions.activate } : {}),\n            ...(dto.actions?.cursorEnter?.root || dto.actions?.cursorExit?.root\n              ? {\n                  hoverEvents: {\n                    enter: Boolean(dto.actions?.cursorEnter?.root),\n                    exit: Boolean(dto.actions?.cursorExit?.root),\n                  },\n                }\n              : {}),\n            ref: dto.ref,\n            // A `/RT /Group` child riding another annotation — labeled so the\n            // nav layer can defer to editing (moot in viewer-only deployments,\n            // but the item contract stays truthful either way).\n            attached: dto.replyType === 'group' && dto.inReplyTo != null,\n          });\n        }\n        io.dispatch({ type: 'SET_PAGE', pon, items });\n      },\n      () => {},\n    );\n}\n","import type { PluginContext } from '@embedpdf/core';\nimport type { PdfLinkTarget } from '@embedpdf/engine-core/runtime';\nimport { ActionsToken } from '@embedpdf/plugin-actions/contract';\n// The host lens (linkItemsOn) — same runtime token as the public one.\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/contract/host';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\nimport { destinationToReveal } from '@embedpdf/plugin-stage/destination';\nimport { loadLinksPage } from './source';\nimport type {\n  LinkAction,\n  LinkActivateContext,\n  LinkActivation,\n  LinkCapability,\n  LinkNavItem,\n  LinkPluginConfig,\n  LinkState,\n} from './types';\n\nconst EMPTY: LinkNavItem[] = [];\n\n/**\n * The navigation plane's surface. Data source is decided PER CALL (lazily,\n * so plugin registration order can't matter): the annotation plugin's\n * folded model when present — its `linkItemsOn` lens is memoized by model\n * identity and already excludes hidden links — else this plugin's own\n * engine-backed page cache (see source.ts).\n */\nexport function createLinkCapability(\n  ctx: PluginContext<LinkState, LinkAction>,\n  config: LinkPluginConfig = {},\n): LinkCapability {\n  const anno = () => ctx.tryGet(AnnotationHostToken);\n\n  const activate = (target: PdfLinkTarget, context?: LinkActivateContext): LinkActivation => {\n    const activation = ((): LinkActivation => {\n      // The action engine takes precedence when it is installed and the item\n      // carries its payload tree: named verbs execute, mixed /Next chains\n      // run, and the dispatcher enforces policy + the incomplete-tree law.\n      // Without it, the classic root-projection path below is the fallback.\n      const actions = ctx.tryGet(ActionsToken);\n      if (actions && context?.activate) {\n        const dispatch = actions.execute(context.activate, {\n          origin: 'user',\n          source: { kind: 'link', annotation: context.ref, pon: context.pon },\n          event: { scope: 'activate' },\n        });\n        return { outcome: 'dispatched', dispatch };\n      }\n      switch (target.kind) {\n        case 'goto': {\n          const stage = ctx.tryGet(StageToken);\n          const layout = ctx\n            .document()\n            ?.pages.find((p) => p.pageObjectNumber === target.destination.pageObjectNumber);\n          if (!stage || !layout) {\n            // No camera to drive — hand the embedder the explicit destination.\n            return { outcome: 'destination', destination: target.destination };\n          }\n          const { pageIndex, options } = destinationToReveal(target.destination, layout);\n          stage.reveal(pageIndex, { ...options, behavior: 'smooth' });\n          return { outcome: 'revealed' };\n        }\n        case 'uri':\n          // Opening is the FRAMEWORK layer's job (a real <a href> after\n          // sanitizing) — this plugin never touches the DOM.\n          return { outcome: 'uri', uri: target.uri };\n        case 'named':\n          return { outcome: 'named', name: target.name };\n        default:\n          // javascript / goto-remote / launch / unsupported: reported, never\n          // executed here. JavaScript activation belongs to the scripting\n          // orchestrator once it lands — the chain already rides the\n          // annotation's base `actions`.\n          return { outcome: 'reported', target };\n      }\n    })();\n    config.onActivate?.({ target, activation });\n    return activation;\n  };\n\n  return {\n    linksOn: (pon) => {\n      const host = anno();\n      if (host) return host.linkItemsOn(pon);\n      return ctx.getState().pages[pon] ?? EMPTY;\n    },\n    ensurePage: (pon) => {\n      const host = anno();\n      if (host) {\n        host.ensurePage(pon); // the folded model is the source; it lazy-loads\n        return;\n      }\n      if (!(pon in ctx.getState().pages)) loadLinksPage(ctx, pon);\n    },\n    engaged: () => ctx.tryGet(InteractionToken)?.activeTool()?.enables.has('link-nav') ?? false,\n    activate,\n  };\n}\n","import type { DocumentEvent, EffectContext } from '@embedpdf/core';\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/contract/host';\nimport { loadLinksPage } from './source';\nimport type { LinkAction, LinkState } from './types';\n\n/**\n * Keeps the ENGINE-BACKED page cache honest in viewer-only deployments:\n * any annotation mutation on a cached page (own or remote — the cache has\n * no other refresh path, unlike the annotation plugin's optimistic model)\n * refetches that page's links. With the annotation plugin present the\n * folded model is the source and this effect never fires a fetch.\n */\nexport function registerLinkEffects(ctx: EffectContext<LinkState, LinkAction>): void {\n  const doc = ctx.doc;\n  if (!doc) return;\n\n  const refetch = (pon: number): void => {\n    if (ctx.tryGet(AnnotationHostToken)) return; // annotation model owns the data\n    if (pon in ctx.getState().pages) loadLinksPage(ctx, pon);\n  };\n\n  const unsubscribe = doc.events.subscribe((event: DocumentEvent) => {\n    switch (event.type) {\n      case 'annotation.created':\n        refetch(event.created.pageObjectNumber);\n        break;\n      case 'annotation.updated':\n        refetch(event.updated.pageObjectNumber);\n        break;\n      case 'annotation.moved':\n        if (event.moved.length) refetch(event.moved[0].pageObjectNumber);\n        break;\n      case 'annotation.deleted':\n        refetch(event.pageObjectNumber);\n        break;\n      default:\n        break;\n    }\n  });\n  ctx.cleanup(unsubscribe);\n}\n","import type { LinkAction, LinkState } from './types';\n\nexport const initialLinkState = (): LinkState => ({ pages: {} });\n\n/** Pure. Engine-backed page cache only — the annotation-backed mode reads the\n *  annotation plugin's model and never touches this state. */\nexport function linkReducer(state: LinkState, a: LinkAction): LinkState {\n  switch (a.type) {\n    case 'SET_PAGE':\n      return { ...state, pages: { ...state.pages, [a.pon]: a.items } };\n    case 'DROP_PAGE': {\n      if (!(a.pon in state.pages)) return state;\n      const pages = { ...state.pages };\n      delete pages[a.pon];\n      return { ...state, pages };\n    }\n  }\n}\n","import { definePlugin } from '@embedpdf/core';\nimport { ActionsToken } from '@embedpdf/plugin-actions/contract';\nimport { AnnotationToken } from '@embedpdf/plugin-annotation/contract';\n// Behavior registration lives on the HOST capability (framework/plugin\n// surface) — same runtime token, wider type. The form plugin's precedent.\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/contract/host';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\n\nimport { createLinkCapability } from './capability';\nimport { registerLinkEffects } from './effects';\nimport { initialLinkState, linkReducer } from './reducer';\nimport { LinkToken } from './types';\nimport type { LinkAction, LinkCapability, LinkPluginConfig, LinkState } from './types';\n\n/**\n * The link plugin: the NAVIGATION plane. Document-scoped; requires only the\n * interaction hub. Navigation works with no annotation plugin at all —\n * links are read from the engine's link DTOs. When the annotation plugin IS\n * present, its folded model becomes the data source (no double fetch) and a\n * Behavior keeps links navigation-owned while a `link-nav` tool is active\n * (pointer/pan/form-fill by default) — the single-active-tool hub IS the\n * mode switch: grab the link tool and every link becomes an editable rect.\n */\nexport const linkPlugin = (config?: LinkPluginConfig) =>\n  definePlugin<LinkState, LinkAction, LinkCapability>({\n    id: 'link',\n    token: LinkToken,\n    scope: 'document',\n    requires: [InteractionToken],\n    optional: [StageToken, AnnotationToken, ActionsToken],\n    initialState: initialLinkState,\n    reduce: linkReducer,\n    capability: (ctx) => createLinkCapability(ctx, config),\n    effects: registerLinkEffects,\n    init: (ctx) => {\n      const interaction = ctx.get(InteractionToken);\n      const annotation = ctx.tryGet(AnnotationHostToken);\n      if (annotation) {\n        annotation.registerBehavior({\n          id: 'link-nav',\n          matches: (a) => a.subtype === 'link',\n          engaged: () => interaction.activeTool()?.enables.has('link-nav') ?? false,\n        });\n      }\n    },\n  });\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["AnnotationToken","InteractionToken","AnnotationHostToken","PluginError","resolveLinkTarget","ActionsToken","StageToken","InteractionToken","LinkToken","InteractionToken","StageToken","AnnotationToken","ActionsToken"],"sources":["../src/connect.ts","../src/source.ts","../src/controller.ts","../src/link.plugin.ts"],"sourcesContent":["/** The link plugin's wiring to its siblings, run from the controller's `connect`. */\nimport type { PluginContext } from '@embedpdf/core';\nimport { AnnotationToken } from '@embedpdf/plugin-annotation/contract/host';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract/host';\n\n/**\n * Links are annotations: while a navigation tool is active the link layer\n * owns their input (its anchors take the clicks), so the annotation plane\n * stands down for them. A link still shows as the file draws it.\n */\nexport function connectLink(ctx: PluginContext<void>): void {\n  const annotation = ctx.tryGet(AnnotationToken);\n  if (!annotation) return;\n  const interaction = ctx.get(InteractionToken);\n  ctx.cleanup(\n    annotation.registerBehavior({\n      id: 'link-nav',\n      matches: (target) => target.subtype === 'link',\n      engaged: () => interaction.activeToolEnables('link-nav'),\n    }),\n  );\n}\n","/**\n * The stand-alone source, used when no annotation plugin is installed: the\n * clickable areas among one page's annotations, in page space.\n */\nimport { annotationKey, type Annotation } from '@embedpdf/engine-core/runtime';\n\nimport type { Link } from './contract';\n\n/** The visible link annotations of a page that have a target. */\nexport function linksOf(annotations: readonly Annotation[]): readonly Link[] {\n  const links: Link[] = [];\n  for (const dto of annotations) {\n    if (dto.subtype !== 'link' || dto.target == null) continue;\n    if (dto.hidden || dto.noView) continue;\n    links.push({\n      id: annotationKey(dto.ref),\n      bounds: dto.rect,\n      target: dto.target,\n      ...(dto.actions?.activate ? { activate: dto.actions.activate } : {}),\n      ...(dto.actions?.cursorEnter?.root || dto.actions?.cursorExit?.root\n        ? {\n            hoverEvents: {\n              enter: Boolean(dto.actions?.cursorEnter?.root),\n              exit: Boolean(dto.actions?.cursorExit?.root),\n            },\n          }\n        : {}),\n      ref: dto.ref,\n      attached: dto.reply?.type === 'group',\n    });\n  }\n  return links;\n}\n","import {\n  PluginError,\n  type PluginContext,\n  type DocumentEvent,\n  type OperationOptions,\n  type PageRef,\n} from '@embedpdf/core';\nimport type { Point } from '@embedpdf/core-geometry';\nimport type { PdfLinkTarget } from '@embedpdf/engine-core/runtime';\nimport { ActionsToken } from '@embedpdf/plugin-actions/contract';\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/contract/host';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract/host';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\n\nimport { connectLink } from './connect';\nimport {\n  resolveLinkTarget,\n  type Link,\n  type LinkActivateContext,\n  type LinkActivatedEvent,\n  type LinkActivation,\n  type LinkLoadedEvent,\n  type LinkResolution,\n} from './contract';\nimport type { LinkHostCapability, UriOpener } from './host-contract';\nimport { linksOf } from './source';\n\nconst EMPTY: readonly Link[] = Object.freeze([]);\n\nconst isLink = (value: PdfLinkTarget | Link): value is Link =>\n  'target' in value && 'bounds' in value;\nconst contains = (\n  bounds: { x: number; y: number; width: number; height: number },\n  point: Point,\n): boolean =>\n  point.x >= bounds.x &&\n  point.x <= bounds.x + bounds.width &&\n  point.y >= bounds.y &&\n  point.y <= bounds.y + bounds.height;\n\n/** The pages whose annotation lists an event changed, each once. */\nfunction pagesChangedBy(event: DocumentEvent): readonly PageRef[] | null {\n  switch (event.type) {\n    case 'annotations.created':\n      return [event.annotation.page];\n    case 'annotations.updated':\n      return [event.annotation.page];\n    case 'annotations.deleted':\n    case 'annotations.reordered':\n      return [event.page];\n    // These can remove annotations, links included, from the pages they applied to.\n    case 'redaction.applied':\n    case 'pages.flattened':\n      return event.results\n        .filter((result) => result.status === 'applied')\n        .map((result) => result.page);\n    case 'annotations.flattened':\n      return event.results.some((result) => result.status === 'applied') ? [event.page] : null;\n    default:\n      return null;\n  }\n}\n\n/**\n * The link controller. Two sources for the clickable areas: the annotation\n * plugin's folded model when it is installed (always current), else a page\n * mirror of this plugin's own per-page reads, re-read when a confirmed\n * change (an annotation write, a redaction, a flatten) touches a loaded page. Activation is pure resolution\n * (`resolve`) plus the one side effect this plugin owns, a stage reveal;\n * everything else is reported to the host, which keeps the user gesture.\n */\nexport function createLinkController(ctx: PluginContext<void>) {\n  const annotationHost = () => ctx.tryGet(AnnotationHostToken);\n  const activated = ctx.events.source<LinkActivatedEvent>();\n  const loaded = ctx.events.source<LinkLoadedEvent>();\n\n  const pages = ctx.pageMirror<readonly Link[]>({\n    name: 'links',\n    load: async (doc, page) => {\n      if (!ctx.getPage(page)) {\n        throw new PluginError(\n          'not-found',\n          'link',\n          `page ${page.objectNumber} is not in this document`,\n        );\n      }\n      const snapshot = await doc.page(page).annotations.list();\n      return linksOf(snapshot.annotations);\n    },\n    affected: pagesChangedBy,\n    changed: ({ page, cause }) => {\n      if (cause === 'load') loaded.emit({ page });\n    },\n  });\n\n  // Reads take a page's ref or its index; a page that isn't there has no links.\n  const listLinks = (pageArgument: PageRef | number): readonly Link[] => {\n    const page = ctx.getPage(pageArgument)?.ref;\n    if (!page) return EMPTY;\n    const host = annotationHost();\n    if (host) return host.listLinkItems(page);\n    return pages.get(page) ?? EMPTY;\n  };\n\n  const ensureLoaded = async (\n    pageArgument: PageRef | number,\n    options?: OperationOptions,\n  ): Promise<void> => {\n    const { ref } = ctx.pageOf(pageArgument);\n    // With the annotation plugin installed, its model owns the data.\n    if (annotationHost()) return;\n    await ctx.cancellable(options?.signal, pages.ensureLoaded(ref));\n  };\n\n  // The framework's website openers, the latest first: the plugin never opens one itself.\n  const uriOpeners: UriOpener[] = [];\n\n  // A page the document doesn't have can't be shown.\n  const resolve = (target: PdfLinkTarget): LinkResolution =>\n    resolveLinkTarget(target, (page) => ctx.getPage(page) !== null);\n\n  const perform = (target: PdfLinkTarget, context?: LinkActivateContext): LinkActivation => {\n    const actions = ctx.tryGet(ActionsToken);\n    if (actions && context?.activate) {\n      const dispatch = actions.execute(context.activate, {\n        origin: 'user',\n        source: { kind: 'link', annotation: context.ref, page: context.page },\n        event: { scope: 'activate' },\n      });\n      return { outcome: 'dispatched', dispatch };\n    }\n    const resolution = resolve(target);\n    switch (resolution.kind) {\n      case 'destination': {\n        // The view the link was followed in, by its own scroll behavior.\n        const stage = context?.stage ?? ctx.tryGet(StageToken);\n        if (!stage) return { outcome: 'destination', destination: resolution.destination };\n        stage.goToDestination(resolution.destination);\n        return { outcome: 'revealed' };\n      }\n      case 'uri': {\n        const open = uriOpeners[0];\n        if (!open || open(resolution.uri)) return { outcome: 'uri', uri: resolution.uri };\n        return { outcome: 'reported', target };\n      }\n      case 'named':\n        return { outcome: 'named', name: resolution.name };\n      default:\n        return { outcome: 'reported', target };\n    }\n  };\n\n  const activate = (input: PdfLinkTarget | Link, context?: LinkActivateContext): LinkActivation => {\n    const target = isLink(input) ? input.target : input;\n    const linkContext: LinkActivateContext | undefined = isLink(input)\n      ? { activate: input.activate, ref: input.ref, ...context }\n      : context;\n    const activation = perform(target, linkContext);\n    activated.emit({ target, activation });\n    return activation;\n  };\n\n  const getLinkAt = (page: PageRef | number, point: Point): Link | null => {\n    let best: Link | null = null;\n    for (const link of listLinks(page)) {\n      if (!contains(link.bounds, point)) continue;\n      if (\n        !best ||\n        link.bounds.width * link.bounds.height < best.bounds.width * best.bounds.height\n      ) {\n        best = link;\n      }\n    }\n    return best;\n  };\n\n  const getLabel = (input: Link | PdfLinkTarget): string => {\n    const target = isLink(input) ? input.target : input;\n    switch (target.kind) {\n      case 'uri':\n        return target.uri;\n      case 'goto':\n        return 'Go to destination';\n      case 'named':\n        return target.name;\n      default:\n        return 'Link';\n    }\n  };\n\n  const api: LinkHostCapability = {\n    listLinks,\n    getLink: (page, linkId) => listLinks(page).find((link) => link.id === linkId) ?? null,\n    getLinkAt,\n    listAllLinks: async (options) => {\n      const layouts = ctx.document()?.pages ?? [];\n      await ctx.cancellable(\n        options?.signal,\n        Promise.all(layouts.map((layout) => ensureLoaded(layout.ref, options))),\n      );\n      return layouts.flatMap((layout) => listLinks(layout.ref));\n    },\n    ensureLoaded,\n    isLoaded: (page) => {\n      const ref = ctx.getPage(page)?.ref;\n      return !!ref && (annotationHost() !== null || pages.getStatus(ref) === 'ready');\n    },\n    getStatus: (page) => {\n      const ref = ctx.getPage(page)?.ref;\n      if (!ref) return 'idle';\n      return annotationHost() ? 'ready' : pages.getStatus(ref);\n    },\n    resolve,\n    activate,\n    activateAt: (pageArgument, point, context) => {\n      const page = ctx.pageOf(pageArgument).ref;\n      const link = getLinkAt(page, point);\n      return link ? activate(link, { page, ...context }) : null;\n    },\n    getLabel,\n    onActivated: activated.on,\n    onLoaded: loaded.on,\n    registerUriOpener: (opener) => {\n      uriOpeners.unshift(opener);\n      return () => {\n        const index = uriOpeners.indexOf(opener);\n        if (index >= 0) uriOpeners.splice(index, 1);\n      };\n    },\n    isNavigationEngaged: () => ctx.tryGet(InteractionToken)?.activeToolEnables('link-nav') ?? false,\n  };\n\n  return {\n    api,\n    connect() {\n      connectLink(ctx);\n    },\n  };\n}\n","import { definePlugin } from '@embedpdf/core';\nimport { ActionsToken } from '@embedpdf/plugin-actions/contract';\nimport { AnnotationToken } from '@embedpdf/plugin-annotation/contract';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\n\nimport { createLinkController } from './controller';\nimport { LinkToken } from './host-contract';\n\n/**\n * Clickable link regions and their activation. Document-scoped; needs the\n * interaction hub (the navigation tool tag), optionally the stage (reveal),\n * the annotation plugin (the folded link model) and actions (`/A` trees).\n */\nexport const linkPlugin = () =>\n  definePlugin({\n    id: 'link',\n    token: LinkToken,\n    scope: 'document',\n    requires: [InteractionToken],\n    optional: [StageToken, AnnotationToken, ActionsToken],\n    create: createLinkController,\n  });\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,15 +1,12 @@
-import { a as LinkCapability, c as LinkState, d as PdfLinkTarget, i as LinkActivation, l as LinkToken, n as LinkActivateContext, o as LinkNavItem, r as LinkActivateEvent, s as LinkPluginConfig, t as LinkAction, u as PdfDestination } from "./contract-DO3vDsAV.cjs";
+import { a as LinkCapability, c as PageDestination, d as LinkToken, i as LinkActivation, l as PdfLinkTarget, n as LinkActivateContext, o as LinkLoadedEvent, r as LinkActivatedEvent, s as LinkResolution, t as Link, u as resolveLinkTarget } from "./contract-B4x0DFCT.cjs";
+import { t as LinkHostCapability } from "./host-contract-c0QOjhO6.cjs";
 //#region src/link.plugin.d.ts
 /**
- * The link plugin: the NAVIGATION plane. Document-scoped; requires only the
- * interaction hub. Navigation works with no annotation plugin at all —
- * links are read from the engine's link DTOs. When the annotation plugin IS
- * present, its folded model becomes the data source (no double fetch) and a
- * Behavior keeps links navigation-owned while a `link-nav` tool is active
- * (pointer/pan/form-fill by default) — the single-active-tool hub IS the
- * mode switch: grab the link tool and every link becomes an editable rect.
+ * Clickable link regions and their activation. Document-scoped; needs the
+ * interaction hub (the navigation tool tag), optionally the stage (reveal),
+ * the annotation plugin (the folded link model) and actions (`/A` trees).
  */
-declare const linkPlugin: (config?: LinkPluginConfig) => import("@embedpdf/core").PluginDef<LinkState, LinkAction, LinkCapability>;
+declare const linkPlugin: () => import("@embedpdf/core").PluginDef<void, LinkHostCapability, import("@embedpdf/core").NoSettings>;
 //#endregion
-export { type LinkActivateContext, type LinkActivateEvent, type LinkActivation, type LinkCapability, type LinkNavItem, type LinkPluginConfig, type LinkState, LinkToken, type PdfDestination, type PdfLinkTarget, linkPlugin };
+export { Link, LinkActivateContext, LinkActivatedEvent, LinkActivation, LinkCapability, LinkLoadedEvent, LinkResolution, LinkToken, type PageDestination, type PdfLinkTarget, linkPlugin, resolveLinkTarget };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,15 +1,12 @@
-import { a as LinkCapability, c as LinkState, d as PdfLinkTarget, i as LinkActivation, l as LinkToken, n as LinkActivateContext, o as LinkNavItem, r as LinkActivateEvent, s as LinkPluginConfig, t as LinkAction, u as PdfDestination } from "./contract-B8bEMeH8.js";
+import { a as LinkCapability, c as PageDestination, d as LinkToken, i as LinkActivation, l as PdfLinkTarget, n as LinkActivateContext, o as LinkLoadedEvent, r as LinkActivatedEvent, s as LinkResolution, t as Link, u as resolveLinkTarget } from "./contract-DyTXDEwb.js";
+import { t as LinkHostCapability } from "./host-contract-DNwp7dlr.js";
 //#region src/link.plugin.d.ts
 /**
- * The link plugin: the NAVIGATION plane. Document-scoped; requires only the
- * interaction hub. Navigation works with no annotation plugin at all —
- * links are read from the engine's link DTOs. When the annotation plugin IS
- * present, its folded model becomes the data source (no double fetch) and a
- * Behavior keeps links navigation-owned while a `link-nav` tool is active
- * (pointer/pan/form-fill by default) — the single-active-tool hub IS the
- * mode switch: grab the link tool and every link becomes an editable rect.
+ * Clickable link regions and their activation. Document-scoped; needs the
+ * interaction hub (the navigation tool tag), optionally the stage (reveal),
+ * the annotation plugin (the folded link model) and actions (`/A` trees).
  */
-declare const linkPlugin: (config?: LinkPluginConfig) => import("@embedpdf/core").PluginDef<LinkState, LinkAction, LinkCapability>;
+declare const linkPlugin: () => import("@embedpdf/core").PluginDef<void, LinkHostCapability, import("@embedpdf/core").NoSettings>;
 //#endregion
-export { type LinkActivateContext, type LinkActivateEvent, type LinkActivation, type LinkCapability, type LinkNavItem, type LinkPluginConfig, type LinkState, LinkToken, type PdfDestination, type PdfLinkTarget, linkPlugin };
+export { Link, LinkActivateContext, LinkActivatedEvent, LinkActivation, LinkCapability, LinkLoadedEvent, LinkResolution, LinkToken, type PageDestination, type PdfLinkTarget, linkPlugin, resolveLinkTarget };
 //# sourceMappingURL=index.d.ts.map