@embedpdf/react 3.0.0-next.10 → 3.0.0-next.12

package/dist/index.d.cts

@@ -1,9 +1,10 @@
+import { ActionsUiHandlers, useActionsUiAdapter } from "./actions.cjs";
 import { AnchorTarget, Anchored, AnchoredPlacement, AnchoredProps, ProjectorBinding, ProjectorProvider, ViewProjector, useProjectorBinding } from "./anchored.cjs";
 import { AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationMenu, AnnotationMenuProps } from "./annotation-menu.cjs";
-import { C as useSelector, S as usePage, _ as useDocuments, a as EmbedPDF, b as useOptionalCapability, c as Viewer, d as runtime_d_exports, f as shallowArray, g as useDocumentStatus, h as useDocumentId, i as DocumentScopeProps, l as ViewerProps, m as useCapability, n as DocumentGateProps, o as PageContextValue, p as useActiveDocumentId, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useKernel, x as useOptionalSelector, y as useKernelValue } from "./runtime-Cvi0wQ4d.cjs";
-import { AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationProps, AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, Border, CommentThreadView, CreationDraftAnchor, Geom, LineEnding, LineEndings, PropKey, PropSpec, RenderItem, SelectionAnchor, SelectionFlags, SelectionProps, Style, TextAlign, TextStyle, enrichCommentThreads, filePickerProvider, sameAnchor, sameCreationDraftAnchor, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useFilePickerProvider, useSelectionFlags, useSelectionProps } from "./annotation.cjs";
+import { C as usePage, S as useOptionalSelector, _ as useDocumentStatus, a as EmbedPDF, b as useKernelValue, c as Viewer, d as runtime_d_exports, f as shallowArray, g as useDocumentId, h as useCapabilityEvent, i as DocumentScopeProps, l as ViewerProps, m as useCapability, n as DocumentGateProps, o as PageContextValue, p as useActiveDocumentId, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useDocuments, w as useSelector, x as useOptionalCapability, y as useKernel } from "./runtime-umHA_xHt.cjs";
+import { A as useCommentsHydration, C as filePickerProvider, D as useCommentThread, E as useAnnotationSelection, F as SelectionAnchor, I as sameAnchor, L as sameCreationDraftAnchor, M as useSelectionFlags, N as useSelectionProps, O as useCommentThreads, P as useAnnotationSelected, S as enrichCommentThreads, T as useAnnotationDefaults, _ as SelectionFlags, a as AnnotationPropsPatch, b as TextAlign, c as Border, d as Geom, f as LineEnding, g as RenderItem, h as PropSpec, i as AnnotationProps, j as useFilePickerProvider, k as useComments, l as CommentThreadView, m as PropKey, n as AnnotationLayer, o as AnnotationRenderer, p as LineEndings, r as AnnotationLayerProps, s as AnnotationRendererProps, t as AnnotationFlags, u as CreationDraftAnchor, v as SelectionProps, w as useAnnotation, x as TextStyle, y as Style } from "./annotation-BCED_p9H.cjs";
 import { isMacPlatform, useCommand, useCommandShortcuts, useCommands } from "./commands.cjs";
-import { FormLayer, FormScriptingUiHandlers, useForm, useFormField, useFormScriptingProvider } from "./form.cjs";
+import { FormLayer, useForm, useFormField } from "./form.cjs";
 import { useI18n, useLocale, useT } from "./i18n.cjs";
 import { Stage, StageProps, StageTokenProp, useLayout, usePageList, usePages, useStage, useStageSettings, useZoom } from "./stage.cjs";
 import { Scrollbar, ScrollbarAxis, ScrollbarProps, useScrollMetrics } from "./scrollbar.cjs";
@@ -17,14 +18,14 @@ import { usePageEditor } from "./page-edit.cjs";
 import { useMetadata } from "./metadata.cjs";
 import { usePendingRedactions, useRedaction } from "./redaction.cjs";
 import { SearchLayer, useSearch, useSearchState } from "./search.cjs";
-import { useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries } from "./stamp.cjs";
+import { ByteStore, indexedDbByteStore, useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries } from "./stamp.cjs";
 import { MenusHandle, SurfaceHandle, useMenus, useShell, useSurface } from "./shell.cjs";
 import { CollapsedGroupView, CustomSlotCtx, GroupDisclosureView, OverflowMenuView, StripView, StripViewGroup, Toolbar, ToolbarProps, useStripView } from "./toolbar.cjs";
 export * from "@embedpdf/plugin-annotation";
 export * from "@embedpdf/core";
-export * from "@embedpdf/plugin-render";
 export * from "@embedpdf/plugin-commands";
 export * from "@embedpdf/plugin-stage";
+export * from "@embedpdf/plugin-render";
 export * from "@embedpdf/plugin-interaction";
 export * from "@embedpdf/plugin-selection";
 export * from "@embedpdf/plugin-link";
@@ -36,8 +37,8 @@ export * from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-shell";
 export * from "@embedpdf/core-ui";
 declare namespace index_d_exports {
-  export { AnchorTarget, Anchored, AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, AnnotationProps, AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, Border, CollapsedGroupView, CommentThreadView, CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, FormScriptingUiHandlers, Geom, GroupDisclosureView, LineEnding, LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, PropKey, PropSpec, RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, SelectionClipboard, SelectionClipboardProps, SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, Style, SurfaceHandle, TextAlign, TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
+  export { ActionsUiHandlers, AnchorTarget, Anchored, AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, AnnotationProps, AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, Border, ByteStore, CollapsedGroupView, CommentThreadView, CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, Geom, GroupDisclosureView, LineEnding, LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, PropKey, PropSpec, RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, SelectionClipboard, SelectionClipboardProps, SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, Style, SurfaceHandle, TextAlign, TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, indexedDbByteStore, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActionsUiAdapter, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCapabilityEvent, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
 }
 //#endregion
-export { type AnchorTarget, Anchored, type AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, type AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, type AnnotationProps, type AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, type Border, CollapsedGroupView, CommentThreadView, type CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, type FormScriptingUiHandlers, type Geom, GroupDisclosureView, type LineEnding, type LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, type PropKey, type PropSpec, type RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, SelectionClipboard, SelectionClipboardProps, type SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, type SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, type Style, SurfaceHandle, type TextAlign, type TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, type ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
+export { type ActionsUiHandlers, type AnchorTarget, Anchored, type AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, type AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, type AnnotationProps, type AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, type Border, type ByteStore, CollapsedGroupView, CommentThreadView, type CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, type Geom, GroupDisclosureView, type LineEnding, type LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, type PropKey, type PropSpec, type RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, type SelectionAnchor, SelectionClipboard, SelectionClipboardProps, type SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, type SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, type Style, SurfaceHandle, type TextAlign, type TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, type ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, indexedDbByteStore, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActionsUiAdapter, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCapabilityEvent, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,9 +1,10 @@
+import { ActionsUiHandlers, useActionsUiAdapter } from "./actions.js";
 import { AnchorTarget, Anchored, AnchoredPlacement, AnchoredProps, ProjectorBinding, ProjectorProvider, ViewProjector, useProjectorBinding } from "./anchored.js";
 import { AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationMenu, AnnotationMenuProps } from "./annotation-menu.js";
-import { C as useSelector, S as usePage, _ as useDocuments, a as EmbedPDF, b as useOptionalCapability, c as Viewer, d as runtime_d_exports, f as shallowArray, g as useDocumentStatus, h as useDocumentId, i as DocumentScopeProps, l as ViewerProps, m as useCapability, n as DocumentGateProps, o as PageContextValue, p as useActiveDocumentId, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useKernel, x as useOptionalSelector, y as useKernelValue } from "./runtime-DXxr8T4L.js";
-import { AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationProps, AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, Border, CommentThreadView, CreationDraftAnchor, Geom, LineEnding, LineEndings, PropKey, PropSpec, RenderItem, SelectionAnchor, SelectionFlags, SelectionProps, Style, TextAlign, TextStyle, enrichCommentThreads, filePickerProvider, sameAnchor, sameCreationDraftAnchor, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useFilePickerProvider, useSelectionFlags, useSelectionProps } from "./annotation.js";
+import { C as usePage, S as useOptionalSelector, _ as useDocumentStatus, a as EmbedPDF, b as useKernelValue, c as Viewer, d as runtime_d_exports, f as shallowArray, g as useDocumentId, h as useCapabilityEvent, i as DocumentScopeProps, l as ViewerProps, m as useCapability, n as DocumentGateProps, o as PageContextValue, p as useActiveDocumentId, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useDocuments, w as useSelector, x as useOptionalCapability, y as useKernel } from "./runtime-DE76hlnl.js";
+import { A as useCommentsHydration, C as filePickerProvider, D as useCommentThread, E as useAnnotationSelection, F as SelectionAnchor, I as sameAnchor, L as sameCreationDraftAnchor, M as useSelectionFlags, N as useSelectionProps, O as useCommentThreads, P as useAnnotationSelected, S as enrichCommentThreads, T as useAnnotationDefaults, _ as SelectionFlags, a as AnnotationPropsPatch, b as TextAlign, c as Border, d as Geom, f as LineEnding, g as RenderItem, h as PropSpec, i as AnnotationProps, j as useFilePickerProvider, k as useComments, l as CommentThreadView, m as PropKey, n as AnnotationLayer, o as AnnotationRenderer, p as LineEndings, r as AnnotationLayerProps, s as AnnotationRendererProps, t as AnnotationFlags, u as CreationDraftAnchor, v as SelectionProps, w as useAnnotation, x as TextStyle, y as Style } from "./annotation-k38KDlIZ.js";
 import { isMacPlatform, useCommand, useCommandShortcuts, useCommands } from "./commands.js";
-import { FormLayer, FormScriptingUiHandlers, useForm, useFormField, useFormScriptingProvider } from "./form.js";
+import { FormLayer, useForm, useFormField } from "./form.js";
 import { useI18n, useLocale, useT } from "./i18n.js";
 import { Stage, StageProps, StageTokenProp, useLayout, usePageList, usePages, useStage, useStageSettings, useZoom } from "./stage.js";
 import { Scrollbar, ScrollbarAxis, ScrollbarProps, useScrollMetrics } from "./scrollbar.js";
@@ -17,13 +18,13 @@ import { usePageEditor } from "./page-edit.js";
 import { useMetadata } from "./metadata.js";
 import { usePendingRedactions, useRedaction } from "./redaction.js";
 import { SearchLayer, useSearch, useSearchState } from "./search.js";
-import { useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries } from "./stamp.js";
+import { ByteStore, indexedDbByteStore, useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries } from "./stamp.js";
 import { MenusHandle, SurfaceHandle, useMenus, useShell, useSurface } from "./shell.js";
 import { CollapsedGroupView, CustomSlotCtx, GroupDisclosureView, OverflowMenuView, StripView, StripViewGroup, Toolbar, ToolbarProps, useStripView } from "./toolbar.js";
 export * from "@embedpdf/core";
 export * from "@embedpdf/plugin-stage";
-export * from "@embedpdf/plugin-interaction";
 export * from "@embedpdf/plugin-render";
+export * from "@embedpdf/plugin-interaction";
 export * from "@embedpdf/plugin-selection";
 export * from "@embedpdf/plugin-annotation";
 export * from "@embedpdf/plugin-link";
@@ -36,8 +37,8 @@ export * from "@embedpdf/plugin-commands";
 export * from "@embedpdf/plugin-shell";
 export * from "@embedpdf/core-ui";
 declare namespace index_d_exports {
-  export { AnchorTarget, Anchored, AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, AnnotationProps, AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, Border, CollapsedGroupView, CommentThreadView, CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, FormScriptingUiHandlers, Geom, GroupDisclosureView, LineEnding, LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, PropKey, PropSpec, RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, SelectionClipboard, SelectionClipboardProps, SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, Style, SurfaceHandle, TextAlign, TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
+  export { ActionsUiHandlers, AnchorTarget, Anchored, AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, AnnotationProps, AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, Border, ByteStore, CollapsedGroupView, CommentThreadView, CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, Geom, GroupDisclosureView, LineEnding, LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, PropKey, PropSpec, RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, SelectionClipboard, SelectionClipboardProps, SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, Style, SurfaceHandle, TextAlign, TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, indexedDbByteStore, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActionsUiAdapter, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCapabilityEvent, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
 }
 //#endregion
-export { type AnchorTarget, Anchored, type AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, type AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, type AnnotationProps, type AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, type Border, CollapsedGroupView, CommentThreadView, type CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, type FormScriptingUiHandlers, type Geom, GroupDisclosureView, type LineEnding, type LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, type PropKey, type PropSpec, type RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, SelectionClipboard, SelectionClipboardProps, type SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, type SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, type Style, SurfaceHandle, type TextAlign, type TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, type ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
+export { type ActionsUiHandlers, type AnchorTarget, Anchored, type AnchoredPlacement, AnchoredProps, AnnotationDraftMenu, AnnotationDraftMenuProps, type AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, AnnotationMenuProps, type AnnotationProps, type AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, type Border, type ByteStore, CollapsedGroupView, CommentThreadView, type CreationDraftAnchor, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, type Geom, GroupDisclosureView, type LineEnding, type LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, ProjectorBinding, ProjectorProvider, type PropKey, type PropSpec, type RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, type SelectionAnchor, SelectionClipboard, SelectionClipboardProps, type SelectionFlags, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, type SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, type Style, SurfaceHandle, type TextAlign, type TextStyle, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, type ViewProjector, Viewer, ViewerProps, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, indexedDbByteStore, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActionsUiAdapter, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCapabilityEvent, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 import "./rolldown-runtime-BBjsoOtd.js";
-import { DocumentGate, DocumentScope, EmbedPDF, PageProvider, Viewer, makePageContext, shallowArray, useActiveDocumentId, useCapability, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector } from "./runtime.js";
+import { DocumentGate, DocumentScope, EmbedPDF, PageProvider, Viewer, makePageContext, shallowArray, useActiveDocumentId, useCapability, useCapabilityEvent, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector } from "./runtime.js";
 import { Anchored, ProjectorProvider, useProjectorBinding } from "./anchored.js";
 import { Stage, useLayout, usePageList, usePages, useStage, useStageSettings, useZoom } from "./stage.js";
 import { Scrollbar, useScrollMetrics } from "./scrollbar.js";
@@ -7,24 +7,27 @@ import { PageView } from "./page-view.js";
 import { RenderLayer } from "./render.js";
 import { PagePointerSource, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback } from "./interaction.js";
 import { SelectionClipboard, SelectionHandles, SelectionLayer, SelectionMenu, copySelection, useSelection } from "./selection.js";
-import { AnnotationLayer, enrichCommentThreads, filePickerProvider, sameAnchor, sameCreationDraftAnchor, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useFilePickerProvider, useSelectionFlags, useSelectionProps } from "./annotation.js";
+import { n as sameCreationDraftAnchor, t as sameAnchor } from "./annotation-anchors-CetwM1g7.js";
+import { t as useAnnotationSelected } from "./annotation-hooks-Df8EmzDO.js";
+import { AnnotationLayer, enrichCommentThreads, filePickerProvider, useAnnotation, useAnnotationDefaults, useAnnotationSelection, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useFilePickerProvider, useSelectionFlags, useSelectionProps } from "./annotation.js";
 import { AnnotationDraftMenu, AnnotationMenu } from "./annotation-menu.js";
 import { LinkLayer, openLinkTarget, useLink } from "./link.js";
+import { useActionsUiAdapter } from "./actions.js";
 import { useViews } from "./views.js";
 import { usePageEditor } from "./page-edit.js";
 import { useMetadata } from "./metadata.js";
 import { usePendingRedactions, useRedaction } from "./redaction.js";
-import { FormLayer, useForm, useFormField, useFormScriptingProvider } from "./form.js";
+import { i as useFormField, r as useForm, t as FormLayer } from "./form-BwrLFpKN.js";
 import { SearchLayer, useSearch, useSearchState } from "./search.js";
-import { useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries } from "./stamp.js";
+import { indexedDbByteStore, useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries } from "./stamp.js";
 import { useI18n, useLocale, useT } from "./i18n.js";
 import { isMacPlatform, useCommand, useCommandShortcuts, useCommands } from "./commands.js";
 import { useMenus, useShell, useSurface } from "./shell.js";
 import { Toolbar, useStripView } from "./toolbar.js";
 export * from "@embedpdf/core";
 export * from "@embedpdf/plugin-stage";
-export * from "@embedpdf/plugin-interaction";
 export * from "@embedpdf/plugin-render";
+export * from "@embedpdf/plugin-interaction";
 export * from "@embedpdf/plugin-selection";
 export * from "@embedpdf/plugin-annotation";
 export * from "@embedpdf/plugin-link";
@@ -36,4 +39,4 @@ export * from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-commands";
 export * from "@embedpdf/plugin-shell";
 export * from "@embedpdf/core-ui";
-export { Anchored, AnnotationDraftMenu, AnnotationLayer, AnnotationMenu, DocumentGate, DocumentScope, EmbedPDF, FormLayer, LinkLayer, PagePointerSource, PageProvider, PageView, ProjectorProvider, RenderLayer, Scrollbar, SearchLayer, SelectionClipboard, SelectionHandles, SelectionLayer, SelectionMenu, Stage, Toolbar, Viewer, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };
+export { Anchored, AnnotationDraftMenu, AnnotationLayer, AnnotationMenu, DocumentGate, DocumentScope, EmbedPDF, FormLayer, LinkLayer, PagePointerSource, PageProvider, PageView, ProjectorProvider, RenderLayer, Scrollbar, SearchLayer, SelectionClipboard, SelectionHandles, SelectionLayer, SelectionMenu, Stage, Toolbar, Viewer, copySelection, createClickCounter, enrichCommentThreads, filePickerProvider, indexedDbByteStore, isMacPlatform, makePageContext, openLinkTarget, sameAnchor, sameCreationDraftAnchor, shallowArray, useActionsUiAdapter, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCapabilityEvent, useCommand, useCommandShortcuts, useCommands, useCommentThread, useCommentThreads, useComments, useCommentsHydration, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useProjectorBinding, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom, vibrationFeedback, wkFeedback };

package/dist/link.cjs

@@ -5,8 +5,9 @@ let react_jsx_runtime = require("react/jsx-runtime");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react, 1);
 let _embedpdf_web = require("@embedpdf/web");
-let _embedpdf_plugin_interaction = require("@embedpdf/plugin-interaction");
+let _embedpdf_plugin_interaction_contract = require("@embedpdf/plugin-interaction/contract");
 let _embedpdf_plugin_link = require("@embedpdf/plugin-link");
+let _embedpdf_plugin_actions_contract = require("@embedpdf/plugin-actions/contract");
 //#region src/link.tsx
 /**
 * Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE
@@ -16,8 +17,8 @@ let _embedpdf_plugin_link = require("@embedpdf/plugin-link");
 * anchors below, the selection menu's "Open link", the style editor's "Go to
 * link" — goes through here, so none of them can drop the uri outcome again.
 */
-function openLinkTarget(link, target) {
-	const activation = link.activate(target);
+function openLinkTarget(link, target, context) {
+	const activation = link.activate(target, context);
 	if (activation.outcome === "uri") {
 		const href = (0, _embedpdf_web.sanitizeExternalUri)(activation.uri);
 		if (href && typeof window !== "undefined") window.open(href, "_blank", "noopener,noreferrer");
@@ -55,9 +56,11 @@ function labelOf(item) {
 function LinkLayer({ renderLink } = {}) {
 	const page = require_runtime.usePage();
 	const link = require_runtime.useCapability(_embedpdf_plugin_link.LinkToken);
+	const actions = require_runtime.useOptionalCapability(_embedpdf_plugin_actions_contract.ActionsToken);
+	const linkPump = (0, react.useMemo)(() => actions ? (0, _embedpdf_plugin_actions_contract.createHoverPump)(actions.dispatch) : null, [actions]);
 	const items = require_runtime.useSelector(_embedpdf_plugin_link.LinkToken, (c) => c.linksOn(page.pon), require_runtime.shallowArray);
 	const engaged = require_runtime.useSelector(_embedpdf_plugin_link.LinkToken, (c) => c.engaged());
-	const editEnabled = require_runtime.useOptionalSelector(_embedpdf_plugin_interaction.InteractionToken, (c) => c.activeTool()?.enables.has("annotation-edit") ?? false, false);
+	const editEnabled = require_runtime.useOptionalSelector(_embedpdf_plugin_interaction_contract.InteractionToken, (c) => c.activeTool()?.enables.has("annotation-edit") ?? false, false);
 	(0, react.useEffect)(() => {
 		link.ensurePage(page.pon);
 	}, [link, page.pon]);
@@ -72,7 +75,28 @@ function LinkLayer({ renderLink } = {}) {
 		},
 		children: visible.map((item) => {
 			const box = boxOf(item, page);
-			const href = item.target.kind === "uri" ? (0, _embedpdf_web.sanitizeExternalUri)(item.target.uri) : null;
+			const chained = (item.activate?.root?.next.length ?? 0) > 0;
+			const href = item.target.kind === "uri" && !chained ? (0, _embedpdf_web.sanitizeExternalUri)(item.target.uri) : null;
+			const context = {
+				activate: item.activate,
+				ref: item.ref,
+				pon: page.pon
+			};
+			const linkSource = item.ref ? {
+				kind: "link",
+				annotation: item.ref,
+				pon: page.pon
+			} : null;
+			const notify = (event) => {
+				if (!actions || !item.ref || !linkSource) return;
+				actions.dispatch({
+					scope: "annotation",
+					event,
+					ref: item.ref,
+					pon: page.pon,
+					source: linkSource
+				});
+			};
 			const native = /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
 				href: href ?? void 0,
 				target: "_blank",
@@ -85,15 +109,31 @@ function LinkLayer({ renderLink } = {}) {
 					if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
 					if (href) return;
 					e.preventDefault();
-					openLinkTarget(link, item.target);
+					openLinkTarget(link, item.target, context);
 				},
 				onKeyDown: (e) => {
 					if (e.key === "Enter" || e.key === " ") {
 						e.preventDefault();
-						openLinkTarget(link, item.target);
+						openLinkTarget(link, item.target, context);
 					}
 				},
-				onPointerDown: (e) => e.stopPropagation(),
+				onPointerEnter: () => {
+					if (!linkPump || !item.ref || !item.hoverEvents) return;
+					linkPump.hover({
+						ref: item.ref,
+						pon: page.pon,
+						...linkSource ? { source: linkSource } : {},
+						events: item.hoverEvents
+					});
+				},
+				onPointerLeave: () => linkPump?.hover(null),
+				onPointerUp: () => notify("mouseUp"),
+				onFocus: () => notify("focus"),
+				onBlur: () => notify("blur"),
+				onPointerDown: (e) => {
+					e.stopPropagation();
+					notify("mouseDown");
+				},
 				style: {
 					position: "absolute",
 					left: box.left,

package/dist/link.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"link.cjs","names":["usePage","useCapability","LinkToken","useSelector","shallowArray","useOptionalSelector","InteractionToken","React"],"sources":["../src/link.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-link — the navigation plane's paint.\n *\n * One absolutely-positioned <a> per clickable link area, real anchors on\n * purpose: URIs get an `href` (middle-click, copy-link, status-bar preview\n * and keyboard focus for free), internal destinations activate through the\n * plugin (stage reveal). The layer stands down entirely while the active\n * tool doesn't enable `link-nav` — the annotation plane owns links then\n * (select / move / resize / retarget through the selection editor).\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-link';\nimport * as React from 'react';\nimport { useEffect } from 'react';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport {\n  LinkToken,\n  type LinkActivation,\n  type LinkCapability,\n  type LinkNavItem,\n  type PdfLinkTarget,\n} from '@embedpdf/plugin-link';\nimport { sanitizeExternalUri } from '@embedpdf/web';\n\nimport {\n  shallowArray,\n  useCapability,\n  useOptionalSelector,\n  usePage,\n  useSelector,\n} from './runtime';\nimport type { PageContextValue } from './runtime';\n\n/**\n * Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE\n * place in the codebase that turns a link target into a browser tab. The\n * plugin owns resolution (goto → stage reveal, policy, analytics) and stays\n * DOM-free; opening is this framework layer's job. Every click path — the nav\n * anchors below, the selection menu's \"Open link\", the style editor's \"Go to\n * link\" — goes through here, so none of them can drop the uri outcome again.\n */\nexport function openLinkTarget(link: LinkCapability, target: PdfLinkTarget): LinkActivation {\n  const activation = link.activate(target);\n  if (activation.outcome === 'uri') {\n    const href = sanitizeExternalUri(activation.uri);\n    if (href && typeof window !== 'undefined') window.open(href, '_blank', 'noopener,noreferrer');\n  }\n  return activation;\n}\n\n/** Content rect → view px (the page wrapper's own space) — the same idiom as\n *  the annotation and form layers: never re-derive `x * scale`. */\nfunction boxOf(item: LinkNavItem, page: PageContextValue) {\n  const tl = page.transform.toPixels({ x: item.rect.x, y: item.rect.y });\n  const br = page.transform.toPixels({\n    x: item.rect.x + item.rect.width,\n    y: item.rect.y + item.rect.height,\n  });\n  return { left: tl.x, top: tl.y, width: br.x - tl.x, height: br.y - tl.y };\n}\n\n/** A human label for the hover tooltip. Apps with i18n render their own via\n *  `renderLink`; this is the sensible default. */\nfunction labelOf(item: LinkNavItem): string {\n  switch (item.target.kind) {\n    case 'uri':\n      return item.target.uri;\n    case 'goto':\n      return 'Go to destination';\n    case 'named':\n      return item.target.name;\n    default:\n      return 'Link';\n  }\n}\n\nexport interface LinkLayerProps {\n  /** Wrap or replace a link's native anchor (badging, custom tooltips). */\n  renderLink?: (args: {\n    item: LinkNavItem;\n    nativeComponent: React.ReactNode;\n  }) => React.ReactNode | undefined;\n}\n\nexport function LinkLayer({ renderLink }: LinkLayerProps = {}) {\n  const page = usePage();\n  const link = useCapability(LinkToken);\n  const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);\n  const engaged = useSelector(LinkToken, (c) => c.engaged());\n  // One owner per pixel: an ATTACHED link is a property of its parent — while\n  // the active tool can edit annotations, the parent owns those pixels and\n  // the anchor stands down (select/move/resize work; no tooltip, no swallowed\n  // pointer). Standalone document links navigate under any link-nav tool.\n  const editEnabled = useOptionalSelector(\n    InteractionToken,\n    (c) => c.activeTool()?.enables.has('annotation-edit') ?? false,\n    false,\n  );\n\n  useEffect(() => {\n    link.ensurePage(page.pon);\n  }, [link, page.pon]);\n\n  // An authoring tool is active → the annotation plane owns links (they're\n  // plain editable rects there); no nav anchors, no swallowed pointer events.\n  if (!engaged || !items.length) return null;\n  const visible = editEnabled ? items.filter((i) => !i.attached) : items;\n  if (!visible.length) return null;\n\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {visible.map((item) => {\n        const box = boxOf(item, page);\n        // Real href ONLY for sanitized external URIs; blocked schemes and\n        // internal targets activate through the plugin instead.\n        const href = item.target.kind === 'uri' ? sanitizeExternalUri(item.target.uri) : null;\n        const native = (\n          <a\n            href={href ?? undefined}\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            role=\"link\"\n            tabIndex={0}\n            title={labelOf(item)}\n            aria-label={labelOf(item)}\n            onClick={(e) => {\n              // Modified clicks and middle-clicks on a real href keep their\n              // native browser behaviour (new tab / copy link).\n              if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n              // A plain left-click on a real href: let the anchor be an\n              // anchor — native navigation, target=_blank, status bar. Only\n              // non-href targets (goto / named / blocked schemes) route\n              // through the plugin, whose uri outcome the opener PERFORMS\n              // (the old code preventDefault-ed AND dropped the outcome, so\n              // clicking a URL link did nothing at all).\n              if (href) return;\n              e.preventDefault();\n              openLinkTarget(link, item.target);\n            }}\n            onKeyDown={(e) => {\n              if (e.key === 'Enter' || e.key === ' ') {\n                e.preventDefault();\n                openLinkTarget(link, item.target);\n              }\n            }}\n            // Keep the hub out of it: a down inside the anchor must not reach\n            // the Stage's native listener (same isolation idiom as FreeText).\n            onPointerDown={(e) => e.stopPropagation()}\n            style={{\n              position: 'absolute',\n              left: box.left,\n              top: box.top,\n              width: box.width,\n              height: box.height,\n              cursor: 'pointer',\n              pointerEvents: 'auto',\n            }}\n          />\n        );\n        const out = renderLink?.({ item, nativeComponent: native }) ?? native;\n        return <React.Fragment key={item.id}>{out}</React.Fragment>;\n      })}\n    </div>\n  );\n}\n\nexport function useLink() {\n  return useCapability(LinkToken);\n}\n"],"mappings":"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"}
+{"version":3,"file":"link.cjs","names":["usePage","useCapability","LinkToken","useOptionalCapability","ActionsToken","useSelector","shallowArray","useOptionalSelector","InteractionToken","React"],"sources":["../src/link.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-link — the navigation plane's paint.\n *\n * One absolutely-positioned <a> per clickable link area, real anchors on\n * purpose: URIs get an `href` (middle-click, copy-link, status-bar preview\n * and keyboard focus for free), internal destinations activate through the\n * plugin (stage reveal). The layer stands down entirely while the active\n * tool doesn't enable `link-nav` — the annotation plane owns links then\n * (select / move / resize / retarget through the selection editor).\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-link';\nimport * as React from 'react';\nimport { useEffect, useMemo } from 'react';\nimport { ActionsToken, createHoverPump } from '@embedpdf/plugin-actions/contract';\nimport type {\n  ActionSource,\n  PdfAnnotationEventKind,\n} from '@embedpdf/plugin-actions/contract';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract';\nimport {\n  LinkToken,\n  type LinkActivateContext,\n  type LinkActivation,\n  type LinkCapability,\n  type LinkNavItem,\n  type PdfLinkTarget,\n} from '@embedpdf/plugin-link';\nimport { sanitizeExternalUri } from '@embedpdf/web';\n\nimport {\n  shallowArray,\n  useCapability,\n  useOptionalCapability,\n  useOptionalSelector,\n  usePage,\n  useSelector,\n} from './runtime';\nimport type { PageContextValue } from './runtime';\n\n/**\n * Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE\n * place in the codebase that turns a link target into a browser tab. The\n * plugin owns resolution (goto → stage reveal, policy, analytics) and stays\n * DOM-free; opening is this framework layer's job. Every click path — the nav\n * anchors below, the selection menu's \"Open link\", the style editor's \"Go to\n * link\" — goes through here, so none of them can drop the uri outcome again.\n */\nexport function openLinkTarget(\n  link: LinkCapability,\n  target: PdfLinkTarget,\n  context?: LinkActivateContext,\n): LinkActivation {\n  const activation = link.activate(target, context);\n  if (activation.outcome === 'uri') {\n    const href = sanitizeExternalUri(activation.uri);\n    if (href && typeof window !== 'undefined') window.open(href, '_blank', 'noopener,noreferrer');\n  }\n  // 'dispatched': the action engine took it — the actions UI adapter owns any\n  // URI open (the no-double-open rule); this opener must do NOTHING.\n  return activation;\n}\n\n/** Content rect → view px (the page wrapper's own space) — the same idiom as\n *  the annotation and form layers: never re-derive `x * scale`. */\nfunction boxOf(item: LinkNavItem, page: PageContextValue) {\n  const tl = page.transform.toPixels({ x: item.rect.x, y: item.rect.y });\n  const br = page.transform.toPixels({\n    x: item.rect.x + item.rect.width,\n    y: item.rect.y + item.rect.height,\n  });\n  return { left: tl.x, top: tl.y, width: br.x - tl.x, height: br.y - tl.y };\n}\n\n/** A human label for the hover tooltip. Apps with i18n render their own via\n *  `renderLink`; this is the sensible default. */\nfunction labelOf(item: LinkNavItem): string {\n  switch (item.target.kind) {\n    case 'uri':\n      return item.target.uri;\n    case 'goto':\n      return 'Go to destination';\n    case 'named':\n      return item.target.name;\n    default:\n      return 'Link';\n  }\n}\n\nexport interface LinkLayerProps {\n  /** Wrap or replace a link's native anchor (badging, custom tooltips). */\n  renderLink?: (args: {\n    item: LinkNavItem;\n    nativeComponent: React.ReactNode;\n  }) => React.ReactNode | undefined;\n}\n\nexport function LinkLayer({ renderLink }: LinkLayerProps = {}) {\n  const page = usePage();\n  const link = useCapability(LinkToken);\n  // The link plane's /AA event feed: links are behavior-inert to the\n  // annotation plane's hover feed while navigable (their pixels are THESE\n  // anchors), so E/X/D/U/Fo/Bl can only fire from here. One shared pump per\n  // layer — crossing layers still orders Exit before Enter because both\n  // sides submit synchronously in DOM event order.\n  const actions = useOptionalCapability(ActionsToken);\n  const linkPump = useMemo(() => (actions ? createHoverPump(actions.dispatch) : null), [actions]);\n  const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);\n  const engaged = useSelector(LinkToken, (c) => c.engaged());\n  // One owner per pixel: an ATTACHED link is a property of its parent — while\n  // the active tool can edit annotations, the parent owns those pixels and\n  // the anchor stands down (select/move/resize work; no tooltip, no swallowed\n  // pointer). Standalone document links navigate under any link-nav tool.\n  const editEnabled = useOptionalSelector(\n    InteractionToken,\n    (c) => c.activeTool()?.enables.has('annotation-edit') ?? false,\n    false,\n  );\n\n  useEffect(() => {\n    link.ensurePage(page.pon);\n  }, [link, page.pon]);\n\n  // An authoring tool is active → the annotation plane owns links (they're\n  // plain editable rects there); no nav anchors, no swallowed pointer events.\n  if (!engaged || !items.length) return null;\n  const visible = editEnabled ? items.filter((i) => !i.attached) : items;\n  if (!visible.length) return null;\n\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {visible.map((item) => {\n        const box = boxOf(item, page);\n        // Real href ONLY for a chain-free sanitized external URI; blocked\n        // schemes, internal targets, and chain-bearing trees (/Next after the\n        // URI) activate through the plugin instead — a native navigation\n        // would perform the first action and silently drop the rest.\n        const chained = (item.activate?.root?.next.length ?? 0) > 0;\n        const href =\n          item.target.kind === 'uri' && !chained ? sanitizeExternalUri(item.target.uri) : null;\n        const context: LinkActivateContext = { activate: item.activate, ref: item.ref, pon: page.pon };\n        const linkSource: ActionSource | null = item.ref\n          ? { kind: 'link', annotation: item.ref, pon: page.pon }\n          : null;\n        const notify = (event: Exclude<PdfAnnotationEventKind, 'cursorEnter' | 'cursorExit'>) => {\n          if (!actions || !item.ref || !linkSource) return;\n          void actions.dispatch({\n            scope: 'annotation',\n            event,\n            ref: item.ref,\n            pon: page.pon,\n            source: linkSource,\n          });\n        };\n        const native = (\n          <a\n            href={href ?? undefined}\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            role=\"link\"\n            tabIndex={0}\n            title={labelOf(item)}\n            aria-label={labelOf(item)}\n            onClick={(e) => {\n              // Modified clicks and middle-clicks on a real href keep their\n              // native browser behaviour (new tab / copy link).\n              if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n              // A plain left-click on a real href: let the anchor be an\n              // anchor — native navigation, target=_blank, status bar. Only\n              // non-href targets (goto / named / blocked schemes) route\n              // through the plugin, whose uri outcome the opener PERFORMS\n              // (the old code preventDefault-ed AND dropped the outcome, so\n              // clicking a URL link did nothing at all).\n              if (href) return;\n              e.preventDefault();\n              openLinkTarget(link, item.target, context);\n            }}\n            onKeyDown={(e) => {\n              if (e.key === 'Enter' || e.key === ' ') {\n                e.preventDefault();\n                openLinkTarget(link, item.target, context);\n              }\n            }}\n            onPointerEnter={() => {\n              if (!linkPump || !item.ref || !item.hoverEvents) return;\n              linkPump.hover({\n                ref: item.ref,\n                pon: page.pon,\n                ...(linkSource ? { source: linkSource } : {}),\n                events: item.hoverEvents,\n              });\n            }}\n            onPointerLeave={() => linkPump?.hover(null)}\n            onPointerUp={() => notify('mouseUp')}\n            onFocus={() => notify('focus')}\n            onBlur={() => notify('blur')}\n            // Keep the hub out of it: a down inside the anchor must not reach\n            // the Stage's native listener (same isolation idiom as FreeText).\n            onPointerDown={(e) => {\n              e.stopPropagation();\n              notify('mouseDown');\n            }}\n            style={{\n              position: 'absolute',\n              left: box.left,\n              top: box.top,\n              width: box.width,\n              height: box.height,\n              cursor: 'pointer',\n              pointerEvents: 'auto',\n            }}\n          />\n        );\n        const out = renderLink?.({ item, nativeComponent: native }) ?? native;\n        return <React.Fragment key={item.id}>{out}</React.Fragment>;\n      })}\n    </div>\n  );\n}\n\nexport function useLink() {\n  return useCapability(LinkToken);\n}\n"],"mappings":"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"}

package/dist/link.d.cts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import { LinkActivation, LinkCapability, LinkNavItem, PdfLinkTarget } from "@embedpdf/plugin-link";
+import { LinkActivateContext, LinkActivation, LinkCapability, LinkNavItem, PdfLinkTarget } from "@embedpdf/plugin-link";
 export * from "@embedpdf/plugin-link";
 //#region src/link.d.ts
 /**
@@ -10,7 +10,7 @@ export * from "@embedpdf/plugin-link";
  * anchors below, the selection menu's "Open link", the style editor's "Go to
  * link" — goes through here, so none of them can drop the uri outcome again.
  */
-declare function openLinkTarget(link: LinkCapability, target: PdfLinkTarget): LinkActivation;
+declare function openLinkTarget(link: LinkCapability, target: PdfLinkTarget, context?: LinkActivateContext): LinkActivation;
 interface LinkLayerProps {
   /** Wrap or replace a link's native anchor (badging, custom tooltips). */
   renderLink?: (args: {

package/dist/link.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import { LinkActivation, LinkCapability, LinkNavItem, PdfLinkTarget } from "@embedpdf/plugin-link";
+import { LinkActivateContext, LinkActivation, LinkCapability, LinkNavItem, PdfLinkTarget } from "@embedpdf/plugin-link";
 export * from "@embedpdf/plugin-link";
 //#region src/link.d.ts
 /**
@@ -10,7 +10,7 @@ export * from "@embedpdf/plugin-link";
  * anchors below, the selection menu's "Open link", the style editor's "Go to
  * link" — goes through here, so none of them can drop the uri outcome again.
  */
-declare function openLinkTarget(link: LinkCapability, target: PdfLinkTarget): LinkActivation;
+declare function openLinkTarget(link: LinkCapability, target: PdfLinkTarget, context?: LinkActivateContext): LinkActivation;
 interface LinkLayerProps {
   /** Wrap or replace a link's native anchor (badging, custom tooltips). */
   renderLink?: (args: {

package/dist/link.js

@@ -1,11 +1,12 @@
 import "./rolldown-runtime-BBjsoOtd.js";
-import { shallowArray, useCapability, useOptionalSelector, usePage, useSelector } from "./runtime.js";
+import { shallowArray, useCapability, useOptionalCapability, useOptionalSelector, usePage, useSelector } from "./runtime.js";
 import { jsx } from "react/jsx-runtime";
 import * as React from "react";
-import { useEffect } from "react";
+import { useEffect, useMemo } from "react";
 import { sanitizeExternalUri } from "@embedpdf/web";
-import { InteractionToken } from "@embedpdf/plugin-interaction";
+import { InteractionToken } from "@embedpdf/plugin-interaction/contract";
 import { LinkToken } from "@embedpdf/plugin-link";
+import { ActionsToken, createHoverPump } from "@embedpdf/plugin-actions/contract";
 export * from "@embedpdf/plugin-link";
 //#region src/link.tsx
 /**
@@ -16,8 +17,8 @@ export * from "@embedpdf/plugin-link";
 * anchors below, the selection menu's "Open link", the style editor's "Go to
 * link" — goes through here, so none of them can drop the uri outcome again.
 */
-function openLinkTarget(link, target) {
-	const activation = link.activate(target);
+function openLinkTarget(link, target, context) {
+	const activation = link.activate(target, context);
 	if (activation.outcome === "uri") {
 		const href = sanitizeExternalUri(activation.uri);
 		if (href && typeof window !== "undefined") window.open(href, "_blank", "noopener,noreferrer");
@@ -55,6 +56,8 @@ function labelOf(item) {
 function LinkLayer({ renderLink } = {}) {
 	const page = usePage();
 	const link = useCapability(LinkToken);
+	const actions = useOptionalCapability(ActionsToken);
+	const linkPump = useMemo(() => actions ? createHoverPump(actions.dispatch) : null, [actions]);
 	const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);
 	const engaged = useSelector(LinkToken, (c) => c.engaged());
 	const editEnabled = useOptionalSelector(InteractionToken, (c) => c.activeTool()?.enables.has("annotation-edit") ?? false, false);
@@ -72,7 +75,28 @@ function LinkLayer({ renderLink } = {}) {
 		},
 		children: visible.map((item) => {
 			const box = boxOf(item, page);
-			const href = item.target.kind === "uri" ? sanitizeExternalUri(item.target.uri) : null;
+			const chained = (item.activate?.root?.next.length ?? 0) > 0;
+			const href = item.target.kind === "uri" && !chained ? sanitizeExternalUri(item.target.uri) : null;
+			const context = {
+				activate: item.activate,
+				ref: item.ref,
+				pon: page.pon
+			};
+			const linkSource = item.ref ? {
+				kind: "link",
+				annotation: item.ref,
+				pon: page.pon
+			} : null;
+			const notify = (event) => {
+				if (!actions || !item.ref || !linkSource) return;
+				actions.dispatch({
+					scope: "annotation",
+					event,
+					ref: item.ref,
+					pon: page.pon,
+					source: linkSource
+				});
+			};
 			const native = /* @__PURE__ */ jsx("a", {
 				href: href ?? void 0,
 				target: "_blank",
@@ -85,15 +109,31 @@ function LinkLayer({ renderLink } = {}) {
 					if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
 					if (href) return;
 					e.preventDefault();
-					openLinkTarget(link, item.target);
+					openLinkTarget(link, item.target, context);
 				},
 				onKeyDown: (e) => {
 					if (e.key === "Enter" || e.key === " ") {
 						e.preventDefault();
-						openLinkTarget(link, item.target);
+						openLinkTarget(link, item.target, context);
 					}
 				},
-				onPointerDown: (e) => e.stopPropagation(),
+				onPointerEnter: () => {
+					if (!linkPump || !item.ref || !item.hoverEvents) return;
+					linkPump.hover({
+						ref: item.ref,
+						pon: page.pon,
+						...linkSource ? { source: linkSource } : {},
+						events: item.hoverEvents
+					});
+				},
+				onPointerLeave: () => linkPump?.hover(null),
+				onPointerUp: () => notify("mouseUp"),
+				onFocus: () => notify("focus"),
+				onBlur: () => notify("blur"),
+				onPointerDown: (e) => {
+					e.stopPropagation();
+					notify("mouseDown");
+				},
 				style: {
 					position: "absolute",
 					left: box.left,

package/dist/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","names":[],"sources":["../src/link.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-link — the navigation plane's paint.\n *\n * One absolutely-positioned <a> per clickable link area, real anchors on\n * purpose: URIs get an `href` (middle-click, copy-link, status-bar preview\n * and keyboard focus for free), internal destinations activate through the\n * plugin (stage reveal). The layer stands down entirely while the active\n * tool doesn't enable `link-nav` — the annotation plane owns links then\n * (select / move / resize / retarget through the selection editor).\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-link';\nimport * as React from 'react';\nimport { useEffect } from 'react';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport {\n  LinkToken,\n  type LinkActivation,\n  type LinkCapability,\n  type LinkNavItem,\n  type PdfLinkTarget,\n} from '@embedpdf/plugin-link';\nimport { sanitizeExternalUri } from '@embedpdf/web';\n\nimport {\n  shallowArray,\n  useCapability,\n  useOptionalSelector,\n  usePage,\n  useSelector,\n} from './runtime';\nimport type { PageContextValue } from './runtime';\n\n/**\n * Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE\n * place in the codebase that turns a link target into a browser tab. The\n * plugin owns resolution (goto → stage reveal, policy, analytics) and stays\n * DOM-free; opening is this framework layer's job. Every click path — the nav\n * anchors below, the selection menu's \"Open link\", the style editor's \"Go to\n * link\" — goes through here, so none of them can drop the uri outcome again.\n */\nexport function openLinkTarget(link: LinkCapability, target: PdfLinkTarget): LinkActivation {\n  const activation = link.activate(target);\n  if (activation.outcome === 'uri') {\n    const href = sanitizeExternalUri(activation.uri);\n    if (href && typeof window !== 'undefined') window.open(href, '_blank', 'noopener,noreferrer');\n  }\n  return activation;\n}\n\n/** Content rect → view px (the page wrapper's own space) — the same idiom as\n *  the annotation and form layers: never re-derive `x * scale`. */\nfunction boxOf(item: LinkNavItem, page: PageContextValue) {\n  const tl = page.transform.toPixels({ x: item.rect.x, y: item.rect.y });\n  const br = page.transform.toPixels({\n    x: item.rect.x + item.rect.width,\n    y: item.rect.y + item.rect.height,\n  });\n  return { left: tl.x, top: tl.y, width: br.x - tl.x, height: br.y - tl.y };\n}\n\n/** A human label for the hover tooltip. Apps with i18n render their own via\n *  `renderLink`; this is the sensible default. */\nfunction labelOf(item: LinkNavItem): string {\n  switch (item.target.kind) {\n    case 'uri':\n      return item.target.uri;\n    case 'goto':\n      return 'Go to destination';\n    case 'named':\n      return item.target.name;\n    default:\n      return 'Link';\n  }\n}\n\nexport interface LinkLayerProps {\n  /** Wrap or replace a link's native anchor (badging, custom tooltips). */\n  renderLink?: (args: {\n    item: LinkNavItem;\n    nativeComponent: React.ReactNode;\n  }) => React.ReactNode | undefined;\n}\n\nexport function LinkLayer({ renderLink }: LinkLayerProps = {}) {\n  const page = usePage();\n  const link = useCapability(LinkToken);\n  const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);\n  const engaged = useSelector(LinkToken, (c) => c.engaged());\n  // One owner per pixel: an ATTACHED link is a property of its parent — while\n  // the active tool can edit annotations, the parent owns those pixels and\n  // the anchor stands down (select/move/resize work; no tooltip, no swallowed\n  // pointer). Standalone document links navigate under any link-nav tool.\n  const editEnabled = useOptionalSelector(\n    InteractionToken,\n    (c) => c.activeTool()?.enables.has('annotation-edit') ?? false,\n    false,\n  );\n\n  useEffect(() => {\n    link.ensurePage(page.pon);\n  }, [link, page.pon]);\n\n  // An authoring tool is active → the annotation plane owns links (they're\n  // plain editable rects there); no nav anchors, no swallowed pointer events.\n  if (!engaged || !items.length) return null;\n  const visible = editEnabled ? items.filter((i) => !i.attached) : items;\n  if (!visible.length) return null;\n\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {visible.map((item) => {\n        const box = boxOf(item, page);\n        // Real href ONLY for sanitized external URIs; blocked schemes and\n        // internal targets activate through the plugin instead.\n        const href = item.target.kind === 'uri' ? sanitizeExternalUri(item.target.uri) : null;\n        const native = (\n          <a\n            href={href ?? undefined}\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            role=\"link\"\n            tabIndex={0}\n            title={labelOf(item)}\n            aria-label={labelOf(item)}\n            onClick={(e) => {\n              // Modified clicks and middle-clicks on a real href keep their\n              // native browser behaviour (new tab / copy link).\n              if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n              // A plain left-click on a real href: let the anchor be an\n              // anchor — native navigation, target=_blank, status bar. Only\n              // non-href targets (goto / named / blocked schemes) route\n              // through the plugin, whose uri outcome the opener PERFORMS\n              // (the old code preventDefault-ed AND dropped the outcome, so\n              // clicking a URL link did nothing at all).\n              if (href) return;\n              e.preventDefault();\n              openLinkTarget(link, item.target);\n            }}\n            onKeyDown={(e) => {\n              if (e.key === 'Enter' || e.key === ' ') {\n                e.preventDefault();\n                openLinkTarget(link, item.target);\n              }\n            }}\n            // Keep the hub out of it: a down inside the anchor must not reach\n            // the Stage's native listener (same isolation idiom as FreeText).\n            onPointerDown={(e) => e.stopPropagation()}\n            style={{\n              position: 'absolute',\n              left: box.left,\n              top: box.top,\n              width: box.width,\n              height: box.height,\n              cursor: 'pointer',\n              pointerEvents: 'auto',\n            }}\n          />\n        );\n        const out = renderLink?.({ item, nativeComponent: native }) ?? native;\n        return <React.Fragment key={item.id}>{out}</React.Fragment>;\n      })}\n    </div>\n  );\n}\n\nexport function useLink() {\n  return useCapability(LinkToken);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA0CA,SAAgB,eAAe,MAAsB,QAAuC;CAC1F,MAAM,aAAa,KAAK,SAAS,MAAM;CACvC,IAAI,WAAW,YAAY,OAAO;EAChC,MAAM,OAAO,oBAAoB,WAAW,GAAG;EAC/C,IAAI,QAAQ,OAAO,WAAW,aAAa,OAAO,KAAK,MAAM,UAAU,qBAAqB;CAC9F;CACA,OAAO;AACT;;;AAIA,SAAS,MAAM,MAAmB,MAAwB;CACxD,MAAM,KAAK,KAAK,UAAU,SAAS;EAAE,GAAG,KAAK,KAAK;EAAG,GAAG,KAAK,KAAK;CAAE,CAAC;CACrE,MAAM,KAAK,KAAK,UAAU,SAAS;EACjC,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK;EAC3B,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK;CAC7B,CAAC;CACD,OAAO;EAAE,MAAM,GAAG;EAAG,KAAK,GAAG;EAAG,OAAO,GAAG,IAAI,GAAG;EAAG,QAAQ,GAAG,IAAI,GAAG;CAAE;AAC1E;;;AAIA,SAAS,QAAQ,MAA2B;CAC1C,QAAQ,KAAK,OAAO,MAApB;EACE,KAAK,OACH,OAAO,KAAK,OAAO;EACrB,KAAK,QACH,OAAO;EACT,KAAK,SACH,OAAO,KAAK,OAAO;EACrB,SACE,OAAO;CACX;AACF;AAUA,SAAgB,UAAU,EAAE,eAA+B,CAAC,GAAG;CAC7D,MAAM,OAAO,QAAQ;CACrB,MAAM,OAAO,cAAc,SAAS;CACpC,MAAM,QAAQ,YAAY,YAAY,MAAM,EAAE,QAAQ,KAAK,GAAG,GAAG,YAAY;CAC7E,MAAM,UAAU,YAAY,YAAY,MAAM,EAAE,QAAQ,CAAC;CAKzD,MAAM,cAAc,oBAClB,mBACC,MAAM,EAAE,WAAW,CAAC,EAAE,QAAQ,IAAI,iBAAiB,KAAK,OACzD,KACF;CAEA,gBAAgB;EACd,KAAK,WAAW,KAAK,GAAG;CAC1B,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC;CAInB,IAAI,CAAC,WAAW,CAAC,MAAM,QAAQ,OAAO;CACtC,MAAM,UAAU,cAAc,MAAM,QAAQ,MAAM,CAAC,EAAE,QAAQ,IAAI;CACjE,IAAI,CAAC,QAAQ,QAAQ,OAAO;CAE5B,OACE,oBAAC,OAAD;EAAK,OAAO;GAAE,UAAU;GAAY,OAAO;GAAG,eAAe;EAAO;EACjE,UAAA,QAAQ,KAAK,SAAS;GACrB,MAAM,MAAM,MAAM,MAAM,IAAI;GAG5B,MAAM,OAAO,KAAK,OAAO,SAAS,QAAQ,oBAAoB,KAAK,OAAO,GAAG,IAAI;GACjF,MAAM,SACJ,oBAAC,KAAD;IACE,MAAM,QAAQ,KAAA;IACd,QAAO;IACP,KAAI;IACJ,MAAK;IACL,UAAU;IACV,OAAO,QAAQ,IAAI;IACnB,cAAY,QAAQ,IAAI;IACxB,UAAU,MAAM;KAGd,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ;KAOtD,IAAI,MAAM;KACV,EAAE,eAAe;KACjB,eAAe,MAAM,KAAK,MAAM;IAClC;IACA,YAAY,MAAM;KAChB,IAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;MACtC,EAAE,eAAe;MACjB,eAAe,MAAM,KAAK,MAAM;KAClC;IACF;IAGA,gBAAgB,MAAM,EAAE,gBAAgB;IACxC,OAAO;KACL,UAAU;KACV,MAAM,IAAI;KACV,KAAK,IAAI;KACT,OAAO,IAAI;KACX,QAAQ,IAAI;KACZ,QAAQ;KACR,eAAe;IACjB;GACD,CAAA;GAEH,MAAM,MAAM,aAAa;IAAE;IAAM,iBAAiB;GAAO,CAAC,KAAK;GAC/D,OAAO,oBAAC,MAAM,UAAP,EAAA,UAA+B,IAAoB,GAA9B,KAAK,EAAyB;EAC5D,CAAC;CACE,CAAA;AAET;AAEA,SAAgB,UAAU;CACxB,OAAO,cAAc,SAAS;AAChC"}
+{"version":3,"file":"link.js","names":[],"sources":["../src/link.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-link — the navigation plane's paint.\n *\n * One absolutely-positioned <a> per clickable link area, real anchors on\n * purpose: URIs get an `href` (middle-click, copy-link, status-bar preview\n * and keyboard focus for free), internal destinations activate through the\n * plugin (stage reveal). The layer stands down entirely while the active\n * tool doesn't enable `link-nav` — the annotation plane owns links then\n * (select / move / resize / retarget through the selection editor).\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-link';\nimport * as React from 'react';\nimport { useEffect, useMemo } from 'react';\nimport { ActionsToken, createHoverPump } from '@embedpdf/plugin-actions/contract';\nimport type {\n  ActionSource,\n  PdfAnnotationEventKind,\n} from '@embedpdf/plugin-actions/contract';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract';\nimport {\n  LinkToken,\n  type LinkActivateContext,\n  type LinkActivation,\n  type LinkCapability,\n  type LinkNavItem,\n  type PdfLinkTarget,\n} from '@embedpdf/plugin-link';\nimport { sanitizeExternalUri } from '@embedpdf/web';\n\nimport {\n  shallowArray,\n  useCapability,\n  useOptionalCapability,\n  useOptionalSelector,\n  usePage,\n  useSelector,\n} from './runtime';\nimport type { PageContextValue } from './runtime';\n\n/**\n * Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE\n * place in the codebase that turns a link target into a browser tab. The\n * plugin owns resolution (goto → stage reveal, policy, analytics) and stays\n * DOM-free; opening is this framework layer's job. Every click path — the nav\n * anchors below, the selection menu's \"Open link\", the style editor's \"Go to\n * link\" — goes through here, so none of them can drop the uri outcome again.\n */\nexport function openLinkTarget(\n  link: LinkCapability,\n  target: PdfLinkTarget,\n  context?: LinkActivateContext,\n): LinkActivation {\n  const activation = link.activate(target, context);\n  if (activation.outcome === 'uri') {\n    const href = sanitizeExternalUri(activation.uri);\n    if (href && typeof window !== 'undefined') window.open(href, '_blank', 'noopener,noreferrer');\n  }\n  // 'dispatched': the action engine took it — the actions UI adapter owns any\n  // URI open (the no-double-open rule); this opener must do NOTHING.\n  return activation;\n}\n\n/** Content rect → view px (the page wrapper's own space) — the same idiom as\n *  the annotation and form layers: never re-derive `x * scale`. */\nfunction boxOf(item: LinkNavItem, page: PageContextValue) {\n  const tl = page.transform.toPixels({ x: item.rect.x, y: item.rect.y });\n  const br = page.transform.toPixels({\n    x: item.rect.x + item.rect.width,\n    y: item.rect.y + item.rect.height,\n  });\n  return { left: tl.x, top: tl.y, width: br.x - tl.x, height: br.y - tl.y };\n}\n\n/** A human label for the hover tooltip. Apps with i18n render their own via\n *  `renderLink`; this is the sensible default. */\nfunction labelOf(item: LinkNavItem): string {\n  switch (item.target.kind) {\n    case 'uri':\n      return item.target.uri;\n    case 'goto':\n      return 'Go to destination';\n    case 'named':\n      return item.target.name;\n    default:\n      return 'Link';\n  }\n}\n\nexport interface LinkLayerProps {\n  /** Wrap or replace a link's native anchor (badging, custom tooltips). */\n  renderLink?: (args: {\n    item: LinkNavItem;\n    nativeComponent: React.ReactNode;\n  }) => React.ReactNode | undefined;\n}\n\nexport function LinkLayer({ renderLink }: LinkLayerProps = {}) {\n  const page = usePage();\n  const link = useCapability(LinkToken);\n  // The link plane's /AA event feed: links are behavior-inert to the\n  // annotation plane's hover feed while navigable (their pixels are THESE\n  // anchors), so E/X/D/U/Fo/Bl can only fire from here. One shared pump per\n  // layer — crossing layers still orders Exit before Enter because both\n  // sides submit synchronously in DOM event order.\n  const actions = useOptionalCapability(ActionsToken);\n  const linkPump = useMemo(() => (actions ? createHoverPump(actions.dispatch) : null), [actions]);\n  const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);\n  const engaged = useSelector(LinkToken, (c) => c.engaged());\n  // One owner per pixel: an ATTACHED link is a property of its parent — while\n  // the active tool can edit annotations, the parent owns those pixels and\n  // the anchor stands down (select/move/resize work; no tooltip, no swallowed\n  // pointer). Standalone document links navigate under any link-nav tool.\n  const editEnabled = useOptionalSelector(\n    InteractionToken,\n    (c) => c.activeTool()?.enables.has('annotation-edit') ?? false,\n    false,\n  );\n\n  useEffect(() => {\n    link.ensurePage(page.pon);\n  }, [link, page.pon]);\n\n  // An authoring tool is active → the annotation plane owns links (they're\n  // plain editable rects there); no nav anchors, no swallowed pointer events.\n  if (!engaged || !items.length) return null;\n  const visible = editEnabled ? items.filter((i) => !i.attached) : items;\n  if (!visible.length) return null;\n\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {visible.map((item) => {\n        const box = boxOf(item, page);\n        // Real href ONLY for a chain-free sanitized external URI; blocked\n        // schemes, internal targets, and chain-bearing trees (/Next after the\n        // URI) activate through the plugin instead — a native navigation\n        // would perform the first action and silently drop the rest.\n        const chained = (item.activate?.root?.next.length ?? 0) > 0;\n        const href =\n          item.target.kind === 'uri' && !chained ? sanitizeExternalUri(item.target.uri) : null;\n        const context: LinkActivateContext = { activate: item.activate, ref: item.ref, pon: page.pon };\n        const linkSource: ActionSource | null = item.ref\n          ? { kind: 'link', annotation: item.ref, pon: page.pon }\n          : null;\n        const notify = (event: Exclude<PdfAnnotationEventKind, 'cursorEnter' | 'cursorExit'>) => {\n          if (!actions || !item.ref || !linkSource) return;\n          void actions.dispatch({\n            scope: 'annotation',\n            event,\n            ref: item.ref,\n            pon: page.pon,\n            source: linkSource,\n          });\n        };\n        const native = (\n          <a\n            href={href ?? undefined}\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            role=\"link\"\n            tabIndex={0}\n            title={labelOf(item)}\n            aria-label={labelOf(item)}\n            onClick={(e) => {\n              // Modified clicks and middle-clicks on a real href keep their\n              // native browser behaviour (new tab / copy link).\n              if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n              // A plain left-click on a real href: let the anchor be an\n              // anchor — native navigation, target=_blank, status bar. Only\n              // non-href targets (goto / named / blocked schemes) route\n              // through the plugin, whose uri outcome the opener PERFORMS\n              // (the old code preventDefault-ed AND dropped the outcome, so\n              // clicking a URL link did nothing at all).\n              if (href) return;\n              e.preventDefault();\n              openLinkTarget(link, item.target, context);\n            }}\n            onKeyDown={(e) => {\n              if (e.key === 'Enter' || e.key === ' ') {\n                e.preventDefault();\n                openLinkTarget(link, item.target, context);\n              }\n            }}\n            onPointerEnter={() => {\n              if (!linkPump || !item.ref || !item.hoverEvents) return;\n              linkPump.hover({\n                ref: item.ref,\n                pon: page.pon,\n                ...(linkSource ? { source: linkSource } : {}),\n                events: item.hoverEvents,\n              });\n            }}\n            onPointerLeave={() => linkPump?.hover(null)}\n            onPointerUp={() => notify('mouseUp')}\n            onFocus={() => notify('focus')}\n            onBlur={() => notify('blur')}\n            // Keep the hub out of it: a down inside the anchor must not reach\n            // the Stage's native listener (same isolation idiom as FreeText).\n            onPointerDown={(e) => {\n              e.stopPropagation();\n              notify('mouseDown');\n            }}\n            style={{\n              position: 'absolute',\n              left: box.left,\n              top: box.top,\n              width: box.width,\n              height: box.height,\n              cursor: 'pointer',\n              pointerEvents: 'auto',\n            }}\n          />\n        );\n        const out = renderLink?.({ item, nativeComponent: native }) ?? native;\n        return <React.Fragment key={item.id}>{out}</React.Fragment>;\n      })}\n    </div>\n  );\n}\n\nexport function useLink() {\n  return useCapability(LinkToken);\n}\n"],"mappings":"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"}

package/dist/{runtime-Cvi0wQ4d.d.cts → runtime-DE76hlnl.d.ts}

@@ -1,9 +1,9 @@
+import { AnyPlugin, CapabilityToken, Engine, EngineFactory, EventHook, InitialDocument, Kernel } from "@embedpdf/core";
 import * as React from "react";
-import { AnyPlugin, CapabilityToken, Engine, EngineFactory, InitialDocument, Kernel } from "@embedpdf/core";
 import { PageFrame, PageTransform, Point, Rect } from "@embedpdf/core-geometry";
-import { PageViewDemand } from "@embedpdf/plugin-render";
+import { PageViewDemand } from "@embedpdf/plugin-render/contract";
 declare namespace runtime_d_exports {
-  export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, PageContextValue, PageProvider, Viewer, ViewerProps, makePageContext, shallowArray, useActiveDocumentId, useCapability, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector };
+  export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, PageContextValue, PageProvider, Viewer, ViewerProps, makePageContext, shallowArray, useActiveDocumentId, useCapability, useCapabilityEvent, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector };
 }
 import * as import__embedpdf_core from "@embedpdf/core";
 declare function useKernel(): Kernel;
@@ -69,6 +69,14 @@ declare function useSelector<C, R>(token: CapabilityToken<C>, select: (cap: C) =
  * resolves to `fallback` for one frame, then re-renders against the new state.
  */
 declare function useOptionalSelector<C, R>(token: CapabilityToken<C>, select: (cap: C) => R, fallback: R, isEqual?: (a: R, b: R) => boolean): R;
+/**
+ * Subscribe to a capability's {@link EventHook} for the mounted lifetime —
+ * `useCapabilityEvent(ActionsToken, (c) => c.onAction, handler)`. Events
+ * carry occurrences, never state (a late subscriber that needs the current
+ * value uses `useSelector`). The handler rides a ref, so a fresh closure per
+ * render never resubscribes. Null-safe: no plugin/document → no subscription.
+ */
+declare function useCapabilityEvent<C, T>(token: CapabilityToken<C>, select: (cap: C) => EventHook<T>, handler: (event: T) => void): void;
 /** The document registry (open/close/active/list), reactive. */
 declare function useDocuments(): {
   docs: import("@embedpdf/core").DocInfo[];
@@ -204,5 +212,5 @@ declare const PageProvider: React.Provider<PageContextValue | null>;
 declare function usePage(): PageContextValue;
 declare function makePageContext(documentId: string, view: string, pon: number, pageIndex: number, frame: PageFrame, transform: PageTransform, getRect: () => DOMRect, getViewDemand?: () => PageViewDemand): PageContextValue;
 //#endregion
-export { useSelector as C, usePage as S, useDocuments as _, EmbedPDF as a, useOptionalCapability as b, Viewer as c, runtime_d_exports as d, shallowArray as f, useDocumentStatus as g, useDocumentId as h, DocumentScopeProps as i, ViewerProps as l, useCapability as m, DocumentGateProps as n, PageContextValue as o, useActiveDocumentId as p, DocumentScope as r, PageProvider as s, DocumentGate as t, makePageContext as u, useKernel as v, useOptionalSelector as x, useKernelValue as y };
-//# sourceMappingURL=runtime-Cvi0wQ4d.d.cts.map
+export { usePage as C, useOptionalSelector as S, useDocumentStatus as _, EmbedPDF as a, useKernelValue as b, Viewer as c, runtime_d_exports as d, shallowArray as f, useDocumentId as g, useCapabilityEvent as h, DocumentScopeProps as i, ViewerProps as l, useCapability as m, DocumentGateProps as n, PageContextValue as o, useActiveDocumentId as p, DocumentScope as r, PageProvider as s, DocumentGate as t, makePageContext as u, useDocuments as v, useSelector as w, useOptionalCapability as x, useKernel as y };
+//# sourceMappingURL=runtime-DE76hlnl.d.ts.map

package/dist/{runtime-DXxr8T4L.d.ts → runtime-umHA_xHt.d.cts}

@@ -1,9 +1,9 @@
-import { AnyPlugin, CapabilityToken, Engine, EngineFactory, InitialDocument, Kernel } from "@embedpdf/core";
 import * as React from "react";
+import { AnyPlugin, CapabilityToken, Engine, EngineFactory, EventHook, InitialDocument, Kernel } from "@embedpdf/core";
 import { PageFrame, PageTransform, Point, Rect } from "@embedpdf/core-geometry";
-import { PageViewDemand } from "@embedpdf/plugin-render";
+import { PageViewDemand } from "@embedpdf/plugin-render/contract";
 declare namespace runtime_d_exports {
-  export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, PageContextValue, PageProvider, Viewer, ViewerProps, makePageContext, shallowArray, useActiveDocumentId, useCapability, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector };
+  export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, PageContextValue, PageProvider, Viewer, ViewerProps, makePageContext, shallowArray, useActiveDocumentId, useCapability, useCapabilityEvent, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector };
 }
 import * as import__embedpdf_core from "@embedpdf/core";
 declare function useKernel(): Kernel;
@@ -69,6 +69,14 @@ declare function useSelector<C, R>(token: CapabilityToken<C>, select: (cap: C) =
  * resolves to `fallback` for one frame, then re-renders against the new state.
  */
 declare function useOptionalSelector<C, R>(token: CapabilityToken<C>, select: (cap: C) => R, fallback: R, isEqual?: (a: R, b: R) => boolean): R;
+/**
+ * Subscribe to a capability's {@link EventHook} for the mounted lifetime —
+ * `useCapabilityEvent(ActionsToken, (c) => c.onAction, handler)`. Events
+ * carry occurrences, never state (a late subscriber that needs the current
+ * value uses `useSelector`). The handler rides a ref, so a fresh closure per
+ * render never resubscribes. Null-safe: no plugin/document → no subscription.
+ */
+declare function useCapabilityEvent<C, T>(token: CapabilityToken<C>, select: (cap: C) => EventHook<T>, handler: (event: T) => void): void;
 /** The document registry (open/close/active/list), reactive. */
 declare function useDocuments(): {
   docs: import("@embedpdf/core").DocInfo[];
@@ -204,5 +212,5 @@ declare const PageProvider: React.Provider<PageContextValue | null>;
 declare function usePage(): PageContextValue;
 declare function makePageContext(documentId: string, view: string, pon: number, pageIndex: number, frame: PageFrame, transform: PageTransform, getRect: () => DOMRect, getViewDemand?: () => PageViewDemand): PageContextValue;
 //#endregion
-export { useSelector as C, usePage as S, useDocuments as _, EmbedPDF as a, useOptionalCapability as b, Viewer as c, runtime_d_exports as d, shallowArray as f, useDocumentStatus as g, useDocumentId as h, DocumentScopeProps as i, ViewerProps as l, useCapability as m, DocumentGateProps as n, PageContextValue as o, useActiveDocumentId as p, DocumentScope as r, PageProvider as s, DocumentGate as t, makePageContext as u, useKernel as v, useOptionalSelector as x, useKernelValue as y };
-//# sourceMappingURL=runtime-DXxr8T4L.d.ts.map
+export { usePage as C, useOptionalSelector as S, useDocumentStatus as _, EmbedPDF as a, useKernelValue as b, Viewer as c, runtime_d_exports as d, shallowArray as f, useDocumentId as g, useCapabilityEvent as h, DocumentScopeProps as i, ViewerProps as l, useCapability as m, DocumentGateProps as n, PageContextValue as o, useActiveDocumentId as p, DocumentScope as r, PageProvider as s, DocumentGate as t, makePageContext as u, useDocuments as v, useSelector as w, useOptionalCapability as x, useKernel as y };
+//# sourceMappingURL=runtime-umHA_xHt.d.cts.map