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

package/dist/index.cjs

@@ -1,13 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./rolldown-runtime-DDXJien1.cjs");
 const require_runtime = require("./runtime.cjs");
-const require_interaction = require("./interaction.cjs");
+const require_anchored = require("./anchored.cjs");
 const require_stage = require("./stage.cjs");
 const require_scrollbar = require("./scrollbar.cjs");
 const require_page_view = require("./page-view.cjs");
 const require_render = require("./render.cjs");
+const require_interaction = require("./interaction.cjs");
 const require_selection = require("./selection.cjs");
-const require_annotation = require("./annotation-Ct6dFtzJ.cjs");
+const require_annotation = require("./annotation.cjs");
 const require_annotation_menu = require("./annotation-menu.cjs");
 const require_link = require("./link.cjs");
 const require_views = require("./views.cjs");
@@ -21,6 +22,8 @@ const require_i18n = require("./i18n.cjs");
 const require_commands = require("./commands.cjs");
 const require_shell = require("./shell.cjs");
 const require_toolbar = require("./toolbar.cjs");
+let _embedpdf_web = require("@embedpdf/web");
+exports.Anchored = require_anchored.Anchored;
 exports.AnnotationDraftMenu = require_annotation_menu.AnnotationDraftMenu;
 exports.AnnotationLayer = require_annotation.AnnotationLayer;
 exports.AnnotationMenu = require_annotation_menu.AnnotationMenu;
@@ -29,23 +32,32 @@ exports.DocumentScope = require_runtime.DocumentScope;
 exports.EmbedPDF = require_runtime.EmbedPDF;
 exports.FormLayer = require_form.FormLayer;
 exports.LinkLayer = require_link.LinkLayer;
-exports.PageAnnotationDraftMenu = require_annotation.PageAnnotationDraftMenu;
-exports.PageAnnotationMenu = require_annotation.PageAnnotationMenu;
 exports.PagePointerSource = require_interaction.PagePointerSource;
 exports.PageProvider = require_runtime.PageProvider;
 exports.PageView = require_page_view.PageView;
+exports.ProjectorProvider = require_anchored.ProjectorProvider;
 exports.RenderLayer = require_render.RenderLayer;
 exports.Scrollbar = require_scrollbar.Scrollbar;
 exports.SearchLayer = require_search.SearchLayer;
+exports.SelectionClipboard = require_selection.SelectionClipboard;
+exports.SelectionHandles = require_selection.SelectionHandles;
 exports.SelectionLayer = require_selection.SelectionLayer;
+exports.SelectionMenu = require_selection.SelectionMenu;
 exports.Stage = require_stage.Stage;
-exports.TileLayer = require_render.TileLayer;
 exports.Toolbar = require_toolbar.Toolbar;
 exports.Viewer = require_runtime.Viewer;
+Object.defineProperty(exports, "copySelection", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.copySelection;
+	}
+});
 exports.createClickCounter = require_interaction.createClickCounter;
+exports.enrichCommentThreads = require_annotation.enrichCommentThreads;
 exports.filePickerProvider = require_annotation.filePickerProvider;
 exports.isMacPlatform = require_commands.isMacPlatform;
 exports.makePageContext = require_runtime.makePageContext;
+exports.openLinkTarget = require_link.openLinkTarget;
 exports.sameAnchor = require_annotation.sameAnchor;
 exports.sameCreationDraftAnchor = require_annotation.sameCreationDraftAnchor;
 exports.shallowArray = require_runtime.shallowArray;
@@ -59,6 +71,10 @@ exports.useCapability = require_runtime.useCapability;
 exports.useCommand = require_commands.useCommand;
 exports.useCommandShortcuts = require_commands.useCommandShortcuts;
 exports.useCommands = require_commands.useCommands;
+exports.useCommentThread = require_annotation.useCommentThread;
+exports.useCommentThreads = require_annotation.useCommentThreads;
+exports.useComments = require_annotation.useComments;
+exports.useCommentsHydration = require_annotation.useCommentsHydration;
 exports.useDocumentId = require_runtime.useDocumentId;
 exports.useDocumentStatus = require_runtime.useDocumentStatus;
 exports.useDocuments = require_runtime.useDocuments;
@@ -81,6 +97,7 @@ exports.usePageEditor = require_page_edit.usePageEditor;
 exports.usePageList = require_stage.usePageList;
 exports.usePages = require_stage.usePages;
 exports.usePendingRedactions = require_redaction.usePendingRedactions;
+exports.useProjectorBinding = require_anchored.useProjectorBinding;
 exports.useRedaction = require_redaction.useRedaction;
 exports.useScrollMetrics = require_scrollbar.useScrollMetrics;
 exports.useSearch = require_search.useSearch;
@@ -103,6 +120,18 @@ exports.useTool = require_interaction.useTool;
 exports.useToolCursor = require_interaction.useToolCursor;
 exports.useViews = require_views.useViews;
 exports.useZoom = require_stage.useZoom;
+Object.defineProperty(exports, "vibrationFeedback", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.vibrationFeedback;
+	}
+});
+Object.defineProperty(exports, "wkFeedback", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.wkFeedback;
+	}
+});
 var _embedpdf_core = require("@embedpdf/core");
 Object.keys(_embedpdf_core).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {

package/dist/index.d.cts

@@ -1,16 +1,17 @@
-import { S as useSelector, _ as useKernel, a as EmbedPDF, b as useOptionalSelector, c as Viewer, d as shallowArray, f as useActiveDocumentId, g as useDocuments, h as useDocumentStatus, i as DocumentScopeProps, l as ViewerProps, m as useDocumentId, n as DocumentGateProps, o as PageContextValue, p as useCapability, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useKernelValue, x as usePage, y as useOptionalCapability } from "./runtime-CMxIuF2O.cjs";
-import { A as useAnnotation, C as SelectionProps, D as filePickerProvider, E as TextStyle, F as useSelectionFlags, I as useSelectionProps, L as AnnotationMenuPlacement, M as useAnnotationSelected, N as useAnnotationSelection, O as sameAnchor, P as useFilePickerProvider, S as SelectionFlags, T as TextAlign, _ as PageAnnotationMenu, a as AnnotationLayerProps, b as RenderItem, c as AnnotationProps, d as AnnotationRendererProps, f as Border, g as PageAnnotationDraftMenu, h as LineEndings, i as AnnotationLayer, j as useAnnotationDefaults, k as sameCreationDraftAnchor, l as AnnotationPropsPatch, m as LineEnding, n as AnnotationDraftMenuRenderArgs, o as AnnotationMenuProps, p as Geom, r as AnnotationFlags, s as AnnotationMenuRenderArgs, t as AnnotationDraftMenuProps, u as AnnotationRenderer, v as PropKey, w as Style, x as SelectionAnchor, y as PropSpec } from "./annotation-B6jwfTCh.cjs";
-import { AnnotationDraftMenu, AnnotationMenu } from "./annotation-menu.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 { isMacPlatform, useCommand, useCommandShortcuts, useCommands } from "./commands.cjs";
 import { FormLayer, FormScriptingUiHandlers, useForm, useFormField, useFormScriptingProvider } 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";
 import { PageView, PageViewProps } from "./page-view.cjs";
-import { RenderLayer, RenderLayerProps, TileLayer, TileLayerProps } from "./render.cjs";
-import { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor } from "./interaction.cjs";
-import { SelectionLayer, SelectionLayerProps, useSelection } from "./selection.cjs";
-import { LinkLayer, LinkLayerProps, useLink } from "./link.cjs";
+import { RenderLayer, RenderLayerProps } from "./render.cjs";
+import { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback } from "./interaction.cjs";
+import { SelectionClipboard, SelectionClipboardProps, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, copySelection, useSelection } from "./selection.cjs";
+import { LinkLayer, LinkLayerProps, openLinkTarget, useLink } from "./link.cjs";
 import { UseViews, useViews } from "./views.cjs";
 import { usePageEditor } from "./page-edit.cjs";
 import { useMetadata } from "./metadata.cjs";
@@ -34,4 +35,9 @@ export * from "@embedpdf/plugin-redaction";
 export * from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-shell";
 export * from "@embedpdf/core-ui";
-export { AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationDraftMenuRenderArgs, type AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, type AnnotationMenuPlacement, AnnotationMenuProps, AnnotationMenuRenderArgs, type AnnotationProps, type AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, type Border, CollapsedGroupView, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, type FormScriptingUiHandlers, type Geom, GroupDisclosureView, type LineEnding, type LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageAnnotationDraftMenu, PageAnnotationMenu, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, type PropKey, type PropSpec, type RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, type SelectionFlags, SelectionLayer, SelectionLayerProps, type SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, type Style, SurfaceHandle, type TextAlign, type TextStyle, TileLayer, TileLayerProps, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, Viewer, ViewerProps, createClickCounter, filePickerProvider, isMacPlatform, makePageContext, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom };
+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 };
+}
+//#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 };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,16 +1,17 @@
-import { S as useSelector, _ as useKernel, a as EmbedPDF, b as useOptionalSelector, c as Viewer, d as shallowArray, f as useActiveDocumentId, g as useDocuments, h as useDocumentStatus, i as DocumentScopeProps, l as ViewerProps, m as useDocumentId, n as DocumentGateProps, o as PageContextValue, p as useCapability, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useKernelValue, x as usePage, y as useOptionalCapability } from "./runtime-DV98q7I0.js";
-import { A as useAnnotation, C as SelectionProps, D as filePickerProvider, E as TextStyle, F as useSelectionFlags, I as useSelectionProps, L as AnnotationMenuPlacement, M as useAnnotationSelected, N as useAnnotationSelection, O as sameAnchor, P as useFilePickerProvider, S as SelectionFlags, T as TextAlign, _ as PageAnnotationMenu, a as AnnotationLayerProps, b as RenderItem, c as AnnotationProps, d as AnnotationRendererProps, f as Border, g as PageAnnotationDraftMenu, h as LineEndings, i as AnnotationLayer, j as useAnnotationDefaults, k as sameCreationDraftAnchor, l as AnnotationPropsPatch, m as LineEnding, n as AnnotationDraftMenuRenderArgs, o as AnnotationMenuProps, p as Geom, r as AnnotationFlags, s as AnnotationMenuRenderArgs, t as AnnotationDraftMenuProps, u as AnnotationRenderer, v as PropKey, w as Style, x as SelectionAnchor, y as PropSpec } from "./annotation-nUMefyjw.js";
-import { AnnotationDraftMenu, AnnotationMenu } from "./annotation-menu.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 { isMacPlatform, useCommand, useCommandShortcuts, useCommands } from "./commands.js";
 import { FormLayer, FormScriptingUiHandlers, useForm, useFormField, useFormScriptingProvider } 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";
 import { PageView, PageViewProps } from "./page-view.js";
-import { RenderLayer, RenderLayerProps, TileLayer, TileLayerProps } from "./render.js";
-import { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor } from "./interaction.js";
-import { SelectionLayer, SelectionLayerProps, useSelection } from "./selection.js";
-import { LinkLayer, LinkLayerProps, useLink } from "./link.js";
+import { RenderLayer, RenderLayerProps } from "./render.js";
+import { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback } from "./interaction.js";
+import { SelectionClipboard, SelectionClipboardProps, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, copySelection, useSelection } from "./selection.js";
+import { LinkLayer, LinkLayerProps, openLinkTarget, useLink } from "./link.js";
 import { UseViews, useViews } from "./views.js";
 import { usePageEditor } from "./page-edit.js";
 import { useMetadata } from "./metadata.js";
@@ -34,4 +35,9 @@ export * from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-commands";
 export * from "@embedpdf/plugin-shell";
 export * from "@embedpdf/core-ui";
-export { AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationDraftMenuRenderArgs, type AnnotationFlags, AnnotationLayer, AnnotationLayerProps, AnnotationMenu, type AnnotationMenuPlacement, AnnotationMenuProps, AnnotationMenuRenderArgs, type AnnotationProps, type AnnotationPropsPatch, AnnotationRenderer, AnnotationRendererProps, type Border, CollapsedGroupView, CustomSlotCtx, DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, FormLayer, type FormScriptingUiHandlers, type Geom, GroupDisclosureView, type LineEnding, type LineEndings, LinkLayer, LinkLayerProps, MenusHandle, OverflowMenuView, PageAnnotationDraftMenu, PageAnnotationMenu, PageContextValue, PagePointerSource, PageProvider, PageView, PageViewProps, type PropKey, type PropSpec, type RenderItem, RenderLayer, RenderLayerProps, Scrollbar, ScrollbarAxis, ScrollbarProps, SearchLayer, SelectionAnchor, type SelectionFlags, SelectionLayer, SelectionLayerProps, type SelectionProps, Stage, StageProps, StageTokenProp, StripView, StripViewGroup, type Style, SurfaceHandle, type TextAlign, type TextStyle, TileLayer, TileLayerProps, ToolCursorImage, ToolCursorSpec, Toolbar, ToolbarProps, UseViews, Viewer, ViewerProps, createClickCounter, filePickerProvider, isMacPlatform, makePageContext, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom };
+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 };
+}
+//#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 };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,13 +1,15 @@
+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 { PagePointerSource, createClickCounter, useTool, useToolCursor } from "./interaction.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";
 import { PageView } from "./page-view.js";
-import { RenderLayer, TileLayer } from "./render.js";
-import { SelectionLayer, useSelection } from "./selection.js";
-import { a as sameAnchor, c as useAnnotationDefaults, d as useFilePickerProvider, f as useSelectionFlags, i as filePickerProvider, l as useAnnotationSelected, n as PageAnnotationDraftMenu, o as sameCreationDraftAnchor, p as useSelectionProps, r as PageAnnotationMenu, s as useAnnotation, t as AnnotationLayer, u as useAnnotationSelection } from "./annotation-DjGWJljY.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 { AnnotationDraftMenu, AnnotationMenu } from "./annotation-menu.js";
-import { LinkLayer, useLink } from "./link.js";
+import { LinkLayer, openLinkTarget, useLink } from "./link.js";
 import { useViews } from "./views.js";
 import { usePageEditor } from "./page-edit.js";
 import { useMetadata } from "./metadata.js";
@@ -34,4 +36,4 @@ export * from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-commands";
 export * from "@embedpdf/plugin-shell";
 export * from "@embedpdf/core-ui";
-export { AnnotationDraftMenu, AnnotationLayer, AnnotationMenu, DocumentGate, DocumentScope, EmbedPDF, FormLayer, LinkLayer, PageAnnotationDraftMenu, PageAnnotationMenu, PagePointerSource, PageProvider, PageView, RenderLayer, Scrollbar, SearchLayer, SelectionLayer, Stage, TileLayer, Toolbar, Viewer, createClickCounter, filePickerProvider, isMacPlatform, makePageContext, sameAnchor, sameCreationDraftAnchor, shallowArray, useActiveDocumentId, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useArmStampAsset, useCapability, useCommand, useCommandShortcuts, useCommands, useDocumentId, useDocumentStatus, useDocuments, useFilePickerProvider, useForm, useFormField, useFormScriptingProvider, useI18n, useKernel, useKernelValue, useLayout, useLink, useLocale, useMenus, useMetadata, useOptionalCapability, useOptionalSelector, usePage, usePageEditor, usePageList, usePages, usePendingRedactions, useRedaction, useScrollMetrics, useSearch, useSearchState, useSelection, useSelectionFlags, useSelectionProps, useSelector, useShell, useStage, useStageSettings, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries, useStripView, useSurface, useT, useTool, useToolCursor, useViews, useZoom };
+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 };

package/dist/interaction.cjs

@@ -4,8 +4,8 @@ const require_runtime = require("./runtime.cjs");
 let react_jsx_runtime = require("react/jsx-runtime");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react, 1);
-let _embedpdf_plugin_interaction = require("@embedpdf/plugin-interaction");
 let _embedpdf_web = require("@embedpdf/web");
+let _embedpdf_plugin_interaction = require("@embedpdf/plugin-interaction");
 //#region src/interaction.tsx
 const mods = (e) => ({
 	shift: e.shiftKey,
@@ -50,14 +50,15 @@ function PagePointerSource() {
 				},
 				page: {
 					pon: page.pon,
-					point: page.toPagePoint(e.clientX, e.clientY),
+					point: page.toContentPoint(e.clientX, e.clientY),
 					scale: page.transform.viewScale,
 					rotation: page.transform.rotation,
 					zoom: page.transform.zoom
 				},
-				project: (pon) => pon === page.pon ? page.toPagePoint(e.clientX, e.clientY) : null,
+				project: (pon) => pon === page.pon ? page.toContentPoint(e.clientX, e.clientY) : null,
 				modifiers: mods(e),
-				clickCount
+				clickCount,
+				pointerType: e.pointerType || "mouse"
 			};
 		};
 		let dragging = false;
@@ -140,6 +141,18 @@ exports.PagePointerSource = PagePointerSource;
 exports.createClickCounter = createClickCounter;
 exports.useTool = useTool;
 exports.useToolCursor = useToolCursor;
+Object.defineProperty(exports, "vibrationFeedback", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.vibrationFeedback;
+	}
+});
+Object.defineProperty(exports, "wkFeedback", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.wkFeedback;
+	}
+});
 Object.keys(_embedpdf_plugin_interaction).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,

package/dist/interaction.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.cjs","names":["usePage","useCapability","InteractionToken","useSelector"],"sources":["../src/interaction.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-interaction.\n *\n * <PagePointerSource> is the ONE pointer listener per page: it converts events to\n * page space via PageContext.toPagePoint and forwards normalized samples to the\n * hub. It binds only to the page context, so it works identically inside a\n * virtualized <Stage> page and a standalone <PageView>. Features never attach\n * their own pointer listeners — they register handlers with the hub.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport type { Modifiers, PointerSample } from '@embedpdf/plugin-interaction';\nimport { svgCursor } from '@embedpdf/web';\nimport type { SvgCursorOptions } from '@embedpdf/web';\nimport { useCapability, usePage, useSelector } from './runtime';\n\nconst mods = (e: PointerEvent): Modifiers => ({\n  shift: e.shiftKey,\n  alt: e.altKey,\n  ctrl: e.ctrlKey,\n  meta: e.metaKey,\n});\n\n/**\n * Robust multi-click counter. `pointerdown.detail` is 0/1 in several browsers, so\n * we count clicks ourselves from timing + proximity — the standard double/triple\n * detection. Input normalization belongs in the adapter; the hub/handlers stay pure.\n */\nexport function createClickCounter(maxGapMs = 400, maxDistPx = 6) {\n  let last = 0;\n  let lx = 0;\n  let ly = 0;\n  let count = 0;\n  return (now: number, x: number, y: number): number => {\n    count = now - last <= maxGapMs && Math.hypot(x - lx, y - ly) <= maxDistPx ? count + 1 : 1;\n    last = now;\n    lx = x;\n    ly = y;\n    return count;\n  };\n}\n\nexport function PagePointerSource() {\n  const page = usePage();\n  const interaction = useCapability(InteractionToken);\n  const cursor = useSelector(InteractionToken, (c) => c.cursor());\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const clicks = createClickCounter();\n    const sample = (\n      phase: PointerSample['phase'],\n      e: PointerEvent,\n      clickCount = 1,\n    ): PointerSample => {\n      const r = el.getBoundingClientRect();\n      return {\n        phase,\n        viewport: { x: e.clientX - r.left, y: e.clientY - r.top },\n        // `scale`/`rotation`/`zoom` carry the same per-page environmental\n        // context the Stage source resolves via `pageAt` — read off the page\n        // transform so a standalone <PageView> drives handlers identically.\n        page: {\n          pon: page.pon,\n          point: page.toPagePoint(e.clientX, e.clientY),\n          scale: page.transform.viewScale,\n          rotation: page.transform.rotation,\n          zoom: page.transform.zoom,\n        },\n        // A per-page source can only project onto its OWN page — toPagePoint is\n        // already unclamped (the drag listener lives on window), so a gesture\n        // anchored here keeps tracking past the page bounds.\n        project: (pon) => (pon === page.pon ? page.toPagePoint(e.clientX, e.clientY) : null),\n        modifiers: mods(e),\n        clickCount,\n      };\n    };\n    let dragging = false;\n\n    const down = (e: PointerEvent) => {\n      if (e.button !== 0) return;\n      dragging = true;\n      interaction.dispatch(sample('down', e, clicks(Date.now(), e.clientX, e.clientY)));\n    };\n    // hover (no gesture): drive cursor feedback only — fires from the element\n    const hover = (e: PointerEvent) => {\n      if (dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    // active drag: track on window so it survives leaving the page bounds\n    const drag = (e: PointerEvent) => {\n      if (!dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    const up = (e: PointerEvent) => {\n      if (!dragging) return;\n      dragging = false;\n      interaction.dispatch(sample('up', e));\n    };\n\n    el.addEventListener('pointerdown', down);\n    el.addEventListener('pointermove', hover);\n    window.addEventListener('pointermove', drag);\n    window.addEventListener('pointerup', up);\n    return () => {\n      el.removeEventListener('pointerdown', down);\n      el.removeEventListener('pointermove', hover);\n      window.removeEventListener('pointermove', drag);\n      window.removeEventListener('pointerup', up);\n    };\n  }, [interaction, page]);\n\n  // Sits on top as the page's event surface; visual layers below use pointerEvents:none.\n  return <div ref={ref} style={{ position: 'absolute', inset: 0, cursor, touchAction: 'none' }} />;\n}\n\n/** Read + switch the active tool (for a toolbar). */\nexport function useTool() {\n  const interaction = useCapability(InteractionToken);\n  const activeToolId = useSelector(InteractionToken, (c) => c.activeToolId());\n  return {\n    activeToolId,\n    activate: interaction.activateTool,\n    tools: interaction.tools(),\n  };\n}\n\n/** One cursor slot: an SVG image ({@link SvgCursorOptions}) or a plain CSS\n *  cursor string ('crosshair', 'url(…) 4 4, copy'). */\nexport type ToolCursorImage = SvgCursorOptions | string;\n\n/** What {@link useToolCursor} installs: the tool to reskin + its keyword map.\n *  Apps build `svg` from the SAME icon their toolbar renders, so the cursor\n *  and the button can never drift apart. */\nexport interface ToolCursorSpec {\n  toolId: string;\n  /** keyword → cursor: restyle the keywords this tool can show — its declared\n   *  base ('crosshair', 'copy') and hover claims ('text' over text) — in the\n   *  tool's identity. Keywords the map omits render as-is: a markup tool's\n   *  'default' base stays the bare arrow, a foreign 'move' claim drops the\n   *  icon. An SVG value defaults its keyword `fallback` to the keyword it\n   *  replaces. */\n  cursors: Record<string, ToolCursorImage>;\n}\n\nconst toCursor = (img: ToolCursorImage, fallback?: string): string =>\n  typeof img === 'string'\n    ? img\n    : svgCursor(img.fallback === undefined && fallback ? { ...img, fallback } : img);\n\n/**\n * Give a tool IMAGE cursors — the armed-tool indicator. The cursor is the only\n * zero-latency pointer-locked pixel the platform has, and the hub already\n * arbitrates it: unmapped hover claims beat it over annotations/text, page\n * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill\n * controls) carries its own CSS cursor — so nothing chases the pointer in\n * DOM. `null` installs nothing. A re-render with new content rebuilds the\n * cursor (live recolor from tool defaults); unmount restores the tool's\n * declared cursors.\n */\nexport function useToolCursor(spec: ToolCursorSpec | null): void {\n  const interaction = useCapability(InteractionToken);\n  // Key the effect by VALUE: specs are built inline in render, and a\n  // fresh-but-identical object must not thrash the skin.\n  const key = spec && JSON.stringify(spec);\n  const ref = useRef(spec);\n  ref.current = spec;\n  useEffect(() => {\n    const s = ref.current;\n    if (!s) return;\n    interaction.setToolCursor(\n      s.toolId,\n      Object.fromEntries(Object.entries(s.cursors).map(([k, v]) => [k, toCursor(v, k)])),\n    );\n    return () => interaction.setToolCursor(s.toolId, null);\n  }, [interaction, key]);\n}\n"],"mappings":";;;;;;;;;AAoBA,MAAM,QAAQ,OAAgC;CAC5C,OAAO,EAAE;CACT,KAAK,EAAE;CACP,MAAM,EAAE;CACR,MAAM,EAAE;AACV;;;;;;AAOA,SAAgB,mBAAmB,WAAW,KAAK,YAAY,GAAG;CAChE,IAAI,OAAO;CACX,IAAI,KAAK;CACT,IAAI,KAAK;CACT,IAAI,QAAQ;CACZ,QAAQ,KAAa,GAAW,MAAsB;EACpD,QAAQ,MAAM,QAAQ,YAAY,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,KAAK,YAAY,QAAQ,IAAI;EACxF,OAAO;EACP,KAAK;EACL,KAAK;EACL,OAAO;CACT;AACF;AAEA,SAAgB,oBAAoB;CAClC,MAAM,OAAOA,gBAAAA,QAAQ;CACrB,MAAM,cAAcC,gBAAAA,cAAcC,6BAAAA,gBAAgB;CAClD,MAAM,SAASC,gBAAAA,YAAYD,6BAAAA,mBAAmB,MAAM,EAAE,OAAO,CAAC;CAC9D,MAAM,OAAA,GAAA,MAAA,OAAA,CAA6B,IAAI;CAEvC,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,MAAM,KAAK,IAAI;EACf,IAAI,CAAC,IAAI;EACT,MAAM,SAAS,mBAAmB;EAClC,MAAM,UACJ,OACA,GACA,aAAa,MACK;GAClB,MAAM,IAAI,GAAG,sBAAsB;GACnC,OAAO;IACL;IACA,UAAU;KAAE,GAAG,EAAE,UAAU,EAAE;KAAM,GAAG,EAAE,UAAU,EAAE;IAAI;IAIxD,MAAM;KACJ,KAAK,KAAK;KACV,OAAO,KAAK,YAAY,EAAE,SAAS,EAAE,OAAO;KAC5C,OAAO,KAAK,UAAU;KACtB,UAAU,KAAK,UAAU;KACzB,MAAM,KAAK,UAAU;IACvB;IAIA,UAAU,QAAS,QAAQ,KAAK,MAAM,KAAK,YAAY,EAAE,SAAS,EAAE,OAAO,IAAI;IAC/E,WAAW,KAAK,CAAC;IACjB;GACF;EACF;EACA,IAAI,WAAW;EAEf,MAAM,QAAQ,MAAoB;GAChC,IAAI,EAAE,WAAW,GAAG;GACpB,WAAW;GACX,YAAY,SAAS,OAAO,QAAQ,GAAG,OAAO,KAAK,IAAI,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;EAClF;EAEA,MAAM,SAAS,MAAoB;GACjC,IAAI,UAAU;GACd,YAAY,SAAS,OAAO,QAAQ,CAAC,CAAC;EACxC;EAEA,MAAM,QAAQ,MAAoB;GAChC,IAAI,CAAC,UAAU;GACf,YAAY,SAAS,OAAO,QAAQ,CAAC,CAAC;EACxC;EACA,MAAM,MAAM,MAAoB;GAC9B,IAAI,CAAC,UAAU;GACf,WAAW;GACX,YAAY,SAAS,OAAO,MAAM,CAAC,CAAC;EACtC;EAEA,GAAG,iBAAiB,eAAe,IAAI;EACvC,GAAG,iBAAiB,eAAe,KAAK;EACxC,OAAO,iBAAiB,eAAe,IAAI;EAC3C,OAAO,iBAAiB,aAAa,EAAE;EACvC,aAAa;GACX,GAAG,oBAAoB,eAAe,IAAI;GAC1C,GAAG,oBAAoB,eAAe,KAAK;GAC3C,OAAO,oBAAoB,eAAe,IAAI;GAC9C,OAAO,oBAAoB,aAAa,EAAE;EAC5C;CACF,GAAG,CAAC,aAAa,IAAI,CAAC;CAGtB,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EAAU;EAAK,OAAO;GAAE,UAAU;GAAY,OAAO;GAAG;GAAQ,aAAa;EAAO;CAAI,CAAA;AACjG;;AAGA,SAAgB,UAAU;CACxB,MAAM,cAAcD,gBAAAA,cAAcC,6BAAAA,gBAAgB;CAElD,OAAO;EACL,cAFmBC,gBAAAA,YAAYD,6BAAAA,mBAAmB,MAAM,EAAE,aAAa,CAE5D;EACX,UAAU,YAAY;EACtB,OAAO,YAAY,MAAM;CAC3B;AACF;AAoBA,MAAM,YAAY,KAAsB,aACtC,OAAO,QAAQ,WACX,OAAA,GAAA,cAAA,UAAA,CACU,IAAI,aAAa,KAAA,KAAa,WAAW;CAAE,GAAG;CAAK;AAAS,IAAI,GAAG;;;;;;;;;;;AAYnF,SAAgB,cAAc,MAAmC;CAC/D,MAAM,cAAcD,gBAAAA,cAAcC,6BAAAA,gBAAgB;CAGlD,MAAM,MAAM,QAAQ,KAAK,UAAU,IAAI;CACvC,MAAM,OAAA,GAAA,MAAA,OAAA,CAAa,IAAI;CACvB,IAAI,UAAU;CACd,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,MAAM,IAAI,IAAI;EACd,IAAI,CAAC,GAAG;EACR,YAAY,cACV,EAAE,QACF,OAAO,YAAY,OAAO,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CACnF;EACA,aAAa,YAAY,cAAc,EAAE,QAAQ,IAAI;CACvD,GAAG,CAAC,aAAa,GAAG,CAAC;AACvB"}
+{"version":3,"file":"interaction.cjs","names":["usePage","useCapability","InteractionToken","useSelector"],"sources":["../src/interaction.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-interaction.\n *\n * <PagePointerSource> is the ONE pointer listener per page: it converts events to\n * page space via PageContext.toContentPoint and forwards normalized samples to the\n * hub. It binds only to the page context, so it works identically inside a\n * virtualized <Stage> page and a standalone <PageView>. Features never attach\n * their own pointer listeners — they register handlers with the hub.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\n// The browser feedback providers live in @embedpdf/web (the plugin is\n// DOM-free); re-exported here so app code has one import for the feature.\nexport { vibrationFeedback, wkFeedback } from '@embedpdf/web';\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport type { Modifiers, PointerSample } from '@embedpdf/plugin-interaction';\nimport { svgCursor } from '@embedpdf/web';\nimport type { SvgCursorOptions } from '@embedpdf/web';\nimport { useCapability, usePage, useSelector } from './runtime';\n\nconst mods = (e: PointerEvent): Modifiers => ({\n  shift: e.shiftKey,\n  alt: e.altKey,\n  ctrl: e.ctrlKey,\n  meta: e.metaKey,\n});\n\n/**\n * Robust multi-click counter. `pointerdown.detail` is 0/1 in several browsers, so\n * we count clicks ourselves from timing + proximity — the standard double/triple\n * detection. Input normalization belongs in the adapter; the hub/handlers stay pure.\n */\nexport function createClickCounter(maxGapMs = 400, maxDistPx = 6) {\n  let last = 0;\n  let lx = 0;\n  let ly = 0;\n  let count = 0;\n  return (now: number, x: number, y: number): number => {\n    count = now - last <= maxGapMs && Math.hypot(x - lx, y - ly) <= maxDistPx ? count + 1 : 1;\n    last = now;\n    lx = x;\n    ly = y;\n    return count;\n  };\n}\n\nexport function PagePointerSource() {\n  const page = usePage();\n  const interaction = useCapability(InteractionToken);\n  const cursor = useSelector(InteractionToken, (c) => c.cursor());\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const clicks = createClickCounter();\n    const sample = (\n      phase: PointerSample['phase'],\n      e: PointerEvent,\n      clickCount = 1,\n    ): PointerSample => {\n      const r = el.getBoundingClientRect();\n      return {\n        phase,\n        viewport: { x: e.clientX - r.left, y: e.clientY - r.top },\n        // `scale`/`rotation`/`zoom` carry the same per-page environmental\n        // context the Stage source resolves via `pageAt` — read off the page\n        // transform so a standalone <PageView> drives handlers identically.\n        page: {\n          pon: page.pon,\n          point: page.toContentPoint(e.clientX, e.clientY),\n          scale: page.transform.viewScale,\n          rotation: page.transform.rotation,\n          zoom: page.transform.zoom,\n        },\n        // A per-page source can only project onto its OWN page — toContentPoint is\n        // already unclamped (the drag listener lives on window), so a gesture\n        // anchored here keeps tracking past the page bounds.\n        project: (pon) => (pon === page.pon ? page.toContentPoint(e.clientX, e.clientY) : null),\n        modifiers: mods(e),\n        clickCount,\n        pointerType: (e.pointerType || 'mouse') as PointerSample['pointerType'],\n      };\n    };\n    let dragging = false;\n\n    const down = (e: PointerEvent) => {\n      if (e.button !== 0) return;\n      dragging = true;\n      interaction.dispatch(sample('down', e, clicks(Date.now(), e.clientX, e.clientY)));\n    };\n    // hover (no gesture): drive cursor feedback only — fires from the element\n    const hover = (e: PointerEvent) => {\n      if (dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    // active drag: track on window so it survives leaving the page bounds\n    const drag = (e: PointerEvent) => {\n      if (!dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    const up = (e: PointerEvent) => {\n      if (!dragging) return;\n      dragging = false;\n      interaction.dispatch(sample('up', e));\n    };\n\n    el.addEventListener('pointerdown', down);\n    el.addEventListener('pointermove', hover);\n    window.addEventListener('pointermove', drag);\n    window.addEventListener('pointerup', up);\n    return () => {\n      el.removeEventListener('pointerdown', down);\n      el.removeEventListener('pointermove', hover);\n      window.removeEventListener('pointermove', drag);\n      window.removeEventListener('pointerup', up);\n    };\n  }, [interaction, page]);\n\n  // Sits on top as the page's event surface; visual layers below use pointerEvents:none.\n  return <div ref={ref} style={{ position: 'absolute', inset: 0, cursor, touchAction: 'none' }} />;\n}\n\n/** Read + switch the active tool (for a toolbar). */\nexport function useTool() {\n  const interaction = useCapability(InteractionToken);\n  const activeToolId = useSelector(InteractionToken, (c) => c.activeToolId());\n  return {\n    activeToolId,\n    activate: interaction.activateTool,\n    tools: interaction.tools(),\n  };\n}\n\n/** One cursor slot: an SVG image ({@link SvgCursorOptions}) or a plain CSS\n *  cursor string ('crosshair', 'url(…) 4 4, copy'). */\nexport type ToolCursorImage = SvgCursorOptions | string;\n\n/** What {@link useToolCursor} installs: the tool to reskin + its keyword map.\n *  Apps build `svg` from the SAME icon their toolbar renders, so the cursor\n *  and the button can never drift apart. */\nexport interface ToolCursorSpec {\n  toolId: string;\n  /** keyword → cursor: restyle the keywords this tool can show — its declared\n   *  base ('crosshair', 'copy') and hover claims ('text' over text) — in the\n   *  tool's identity. Keywords the map omits render as-is: a markup tool's\n   *  'default' base stays the bare arrow, a foreign 'move' claim drops the\n   *  icon. An SVG value defaults its keyword `fallback` to the keyword it\n   *  replaces. */\n  cursors: Record<string, ToolCursorImage>;\n}\n\nconst toCursor = (img: ToolCursorImage, fallback?: string): string =>\n  typeof img === 'string'\n    ? img\n    : svgCursor(img.fallback === undefined && fallback ? { ...img, fallback } : img);\n\n/**\n * Give a tool IMAGE cursors — the armed-tool indicator. The cursor is the only\n * zero-latency pointer-locked pixel the platform has, and the hub already\n * arbitrates it: unmapped hover claims beat it over annotations/text, page\n * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill\n * controls) carries its own CSS cursor — so nothing chases the pointer in\n * DOM. `null` installs nothing. A re-render with new content rebuilds the\n * cursor (live recolor from tool defaults); unmount restores the tool's\n * declared cursors.\n */\nexport function useToolCursor(spec: ToolCursorSpec | null): void {\n  const interaction = useCapability(InteractionToken);\n  // Key the effect by VALUE: specs are built inline in render, and a\n  // fresh-but-identical object must not thrash the skin.\n  const key = spec && JSON.stringify(spec);\n  const ref = useRef(spec);\n  ref.current = spec;\n  useEffect(() => {\n    const s = ref.current;\n    if (!s) return;\n    interaction.setToolCursor(\n      s.toolId,\n      Object.fromEntries(Object.entries(s.cursors).map(([k, v]) => [k, toCursor(v, k)])),\n    );\n    return () => interaction.setToolCursor(s.toolId, null);\n  }, [interaction, key]);\n}\n"],"mappings":"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"}

package/dist/interaction.d.cts

@@ -1,4 +1,4 @@
-import { SvgCursorOptions } from "@embedpdf/web";
+import { SvgCursorOptions, vibrationFeedback, wkFeedback } from "@embedpdf/web";
 export * from "@embedpdf/plugin-interaction";
 //#region src/interaction.d.ts
 /**
@@ -42,5 +42,5 @@ interface ToolCursorSpec {
  */
 declare function useToolCursor(spec: ToolCursorSpec | null): void;
 //#endregion
-export { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor };
+export { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback };
 //# sourceMappingURL=interaction.d.cts.map

package/dist/interaction.d.ts

@@ -1,4 +1,4 @@
-import { SvgCursorOptions } from "@embedpdf/web";
+import { SvgCursorOptions, vibrationFeedback, wkFeedback } from "@embedpdf/web";
 export * from "@embedpdf/plugin-interaction";
 //#region src/interaction.d.ts
 /**
@@ -42,5 +42,5 @@ interface ToolCursorSpec {
  */
 declare function useToolCursor(spec: ToolCursorSpec | null): void;
 //#endregion
-export { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor };
+export { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback };
 //# sourceMappingURL=interaction.d.ts.map

package/dist/interaction.js

@@ -1,8 +1,9 @@
+import "./rolldown-runtime-BBjsoOtd.js";
 import { useCapability, usePage, useSelector } from "./runtime.js";
 import { jsx } from "react/jsx-runtime";
 import { useEffect, useRef } from "react";
+import { svgCursor, vibrationFeedback, wkFeedback } from "@embedpdf/web";
 import { InteractionToken } from "@embedpdf/plugin-interaction";
-import { svgCursor } from "@embedpdf/web";
 export * from "@embedpdf/plugin-interaction";
 //#region src/interaction.tsx
 const mods = (e) => ({
@@ -48,14 +49,15 @@ function PagePointerSource() {
 				},
 				page: {
 					pon: page.pon,
-					point: page.toPagePoint(e.clientX, e.clientY),
+					point: page.toContentPoint(e.clientX, e.clientY),
 					scale: page.transform.viewScale,
 					rotation: page.transform.rotation,
 					zoom: page.transform.zoom
 				},
-				project: (pon) => pon === page.pon ? page.toPagePoint(e.clientX, e.clientY) : null,
+				project: (pon) => pon === page.pon ? page.toContentPoint(e.clientX, e.clientY) : null,
 				modifiers: mods(e),
-				clickCount
+				clickCount,
+				pointerType: e.pointerType || "mouse"
 			};
 		};
 		let dragging = false;
@@ -134,6 +136,6 @@ function useToolCursor(spec) {
 	}, [interaction, key]);
 }
 //#endregion
-export { PagePointerSource, createClickCounter, useTool, useToolCursor };
+export { PagePointerSource, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback };
 
 //# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.js","names":[],"sources":["../src/interaction.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-interaction.\n *\n * <PagePointerSource> is the ONE pointer listener per page: it converts events to\n * page space via PageContext.toPagePoint and forwards normalized samples to the\n * hub. It binds only to the page context, so it works identically inside a\n * virtualized <Stage> page and a standalone <PageView>. Features never attach\n * their own pointer listeners — they register handlers with the hub.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport type { Modifiers, PointerSample } from '@embedpdf/plugin-interaction';\nimport { svgCursor } from '@embedpdf/web';\nimport type { SvgCursorOptions } from '@embedpdf/web';\nimport { useCapability, usePage, useSelector } from './runtime';\n\nconst mods = (e: PointerEvent): Modifiers => ({\n  shift: e.shiftKey,\n  alt: e.altKey,\n  ctrl: e.ctrlKey,\n  meta: e.metaKey,\n});\n\n/**\n * Robust multi-click counter. `pointerdown.detail` is 0/1 in several browsers, so\n * we count clicks ourselves from timing + proximity — the standard double/triple\n * detection. Input normalization belongs in the adapter; the hub/handlers stay pure.\n */\nexport function createClickCounter(maxGapMs = 400, maxDistPx = 6) {\n  let last = 0;\n  let lx = 0;\n  let ly = 0;\n  let count = 0;\n  return (now: number, x: number, y: number): number => {\n    count = now - last <= maxGapMs && Math.hypot(x - lx, y - ly) <= maxDistPx ? count + 1 : 1;\n    last = now;\n    lx = x;\n    ly = y;\n    return count;\n  };\n}\n\nexport function PagePointerSource() {\n  const page = usePage();\n  const interaction = useCapability(InteractionToken);\n  const cursor = useSelector(InteractionToken, (c) => c.cursor());\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const clicks = createClickCounter();\n    const sample = (\n      phase: PointerSample['phase'],\n      e: PointerEvent,\n      clickCount = 1,\n    ): PointerSample => {\n      const r = el.getBoundingClientRect();\n      return {\n        phase,\n        viewport: { x: e.clientX - r.left, y: e.clientY - r.top },\n        // `scale`/`rotation`/`zoom` carry the same per-page environmental\n        // context the Stage source resolves via `pageAt` — read off the page\n        // transform so a standalone <PageView> drives handlers identically.\n        page: {\n          pon: page.pon,\n          point: page.toPagePoint(e.clientX, e.clientY),\n          scale: page.transform.viewScale,\n          rotation: page.transform.rotation,\n          zoom: page.transform.zoom,\n        },\n        // A per-page source can only project onto its OWN page — toPagePoint is\n        // already unclamped (the drag listener lives on window), so a gesture\n        // anchored here keeps tracking past the page bounds.\n        project: (pon) => (pon === page.pon ? page.toPagePoint(e.clientX, e.clientY) : null),\n        modifiers: mods(e),\n        clickCount,\n      };\n    };\n    let dragging = false;\n\n    const down = (e: PointerEvent) => {\n      if (e.button !== 0) return;\n      dragging = true;\n      interaction.dispatch(sample('down', e, clicks(Date.now(), e.clientX, e.clientY)));\n    };\n    // hover (no gesture): drive cursor feedback only — fires from the element\n    const hover = (e: PointerEvent) => {\n      if (dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    // active drag: track on window so it survives leaving the page bounds\n    const drag = (e: PointerEvent) => {\n      if (!dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    const up = (e: PointerEvent) => {\n      if (!dragging) return;\n      dragging = false;\n      interaction.dispatch(sample('up', e));\n    };\n\n    el.addEventListener('pointerdown', down);\n    el.addEventListener('pointermove', hover);\n    window.addEventListener('pointermove', drag);\n    window.addEventListener('pointerup', up);\n    return () => {\n      el.removeEventListener('pointerdown', down);\n      el.removeEventListener('pointermove', hover);\n      window.removeEventListener('pointermove', drag);\n      window.removeEventListener('pointerup', up);\n    };\n  }, [interaction, page]);\n\n  // Sits on top as the page's event surface; visual layers below use pointerEvents:none.\n  return <div ref={ref} style={{ position: 'absolute', inset: 0, cursor, touchAction: 'none' }} />;\n}\n\n/** Read + switch the active tool (for a toolbar). */\nexport function useTool() {\n  const interaction = useCapability(InteractionToken);\n  const activeToolId = useSelector(InteractionToken, (c) => c.activeToolId());\n  return {\n    activeToolId,\n    activate: interaction.activateTool,\n    tools: interaction.tools(),\n  };\n}\n\n/** One cursor slot: an SVG image ({@link SvgCursorOptions}) or a plain CSS\n *  cursor string ('crosshair', 'url(…) 4 4, copy'). */\nexport type ToolCursorImage = SvgCursorOptions | string;\n\n/** What {@link useToolCursor} installs: the tool to reskin + its keyword map.\n *  Apps build `svg` from the SAME icon their toolbar renders, so the cursor\n *  and the button can never drift apart. */\nexport interface ToolCursorSpec {\n  toolId: string;\n  /** keyword → cursor: restyle the keywords this tool can show — its declared\n   *  base ('crosshair', 'copy') and hover claims ('text' over text) — in the\n   *  tool's identity. Keywords the map omits render as-is: a markup tool's\n   *  'default' base stays the bare arrow, a foreign 'move' claim drops the\n   *  icon. An SVG value defaults its keyword `fallback` to the keyword it\n   *  replaces. */\n  cursors: Record<string, ToolCursorImage>;\n}\n\nconst toCursor = (img: ToolCursorImage, fallback?: string): string =>\n  typeof img === 'string'\n    ? img\n    : svgCursor(img.fallback === undefined && fallback ? { ...img, fallback } : img);\n\n/**\n * Give a tool IMAGE cursors — the armed-tool indicator. The cursor is the only\n * zero-latency pointer-locked pixel the platform has, and the hub already\n * arbitrates it: unmapped hover claims beat it over annotations/text, page\n * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill\n * controls) carries its own CSS cursor — so nothing chases the pointer in\n * DOM. `null` installs nothing. A re-render with new content rebuilds the\n * cursor (live recolor from tool defaults); unmount restores the tool's\n * declared cursors.\n */\nexport function useToolCursor(spec: ToolCursorSpec | null): void {\n  const interaction = useCapability(InteractionToken);\n  // Key the effect by VALUE: specs are built inline in render, and a\n  // fresh-but-identical object must not thrash the skin.\n  const key = spec && JSON.stringify(spec);\n  const ref = useRef(spec);\n  ref.current = spec;\n  useEffect(() => {\n    const s = ref.current;\n    if (!s) return;\n    interaction.setToolCursor(\n      s.toolId,\n      Object.fromEntries(Object.entries(s.cursors).map(([k, v]) => [k, toCursor(v, k)])),\n    );\n    return () => interaction.setToolCursor(s.toolId, null);\n  }, [interaction, key]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"interaction.js","names":[],"sources":["../src/interaction.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-interaction.\n *\n * <PagePointerSource> is the ONE pointer listener per page: it converts events to\n * page space via PageContext.toContentPoint and forwards normalized samples to the\n * hub. It binds only to the page context, so it works identically inside a\n * virtualized <Stage> page and a standalone <PageView>. Features never attach\n * their own pointer listeners — they register handlers with the hub.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\n// The browser feedback providers live in @embedpdf/web (the plugin is\n// DOM-free); re-exported here so app code has one import for the feature.\nexport { vibrationFeedback, wkFeedback } from '@embedpdf/web';\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport type { Modifiers, PointerSample } from '@embedpdf/plugin-interaction';\nimport { svgCursor } from '@embedpdf/web';\nimport type { SvgCursorOptions } from '@embedpdf/web';\nimport { useCapability, usePage, useSelector } from './runtime';\n\nconst mods = (e: PointerEvent): Modifiers => ({\n  shift: e.shiftKey,\n  alt: e.altKey,\n  ctrl: e.ctrlKey,\n  meta: e.metaKey,\n});\n\n/**\n * Robust multi-click counter. `pointerdown.detail` is 0/1 in several browsers, so\n * we count clicks ourselves from timing + proximity — the standard double/triple\n * detection. Input normalization belongs in the adapter; the hub/handlers stay pure.\n */\nexport function createClickCounter(maxGapMs = 400, maxDistPx = 6) {\n  let last = 0;\n  let lx = 0;\n  let ly = 0;\n  let count = 0;\n  return (now: number, x: number, y: number): number => {\n    count = now - last <= maxGapMs && Math.hypot(x - lx, y - ly) <= maxDistPx ? count + 1 : 1;\n    last = now;\n    lx = x;\n    ly = y;\n    return count;\n  };\n}\n\nexport function PagePointerSource() {\n  const page = usePage();\n  const interaction = useCapability(InteractionToken);\n  const cursor = useSelector(InteractionToken, (c) => c.cursor());\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const clicks = createClickCounter();\n    const sample = (\n      phase: PointerSample['phase'],\n      e: PointerEvent,\n      clickCount = 1,\n    ): PointerSample => {\n      const r = el.getBoundingClientRect();\n      return {\n        phase,\n        viewport: { x: e.clientX - r.left, y: e.clientY - r.top },\n        // `scale`/`rotation`/`zoom` carry the same per-page environmental\n        // context the Stage source resolves via `pageAt` — read off the page\n        // transform so a standalone <PageView> drives handlers identically.\n        page: {\n          pon: page.pon,\n          point: page.toContentPoint(e.clientX, e.clientY),\n          scale: page.transform.viewScale,\n          rotation: page.transform.rotation,\n          zoom: page.transform.zoom,\n        },\n        // A per-page source can only project onto its OWN page — toContentPoint is\n        // already unclamped (the drag listener lives on window), so a gesture\n        // anchored here keeps tracking past the page bounds.\n        project: (pon) => (pon === page.pon ? page.toContentPoint(e.clientX, e.clientY) : null),\n        modifiers: mods(e),\n        clickCount,\n        pointerType: (e.pointerType || 'mouse') as PointerSample['pointerType'],\n      };\n    };\n    let dragging = false;\n\n    const down = (e: PointerEvent) => {\n      if (e.button !== 0) return;\n      dragging = true;\n      interaction.dispatch(sample('down', e, clicks(Date.now(), e.clientX, e.clientY)));\n    };\n    // hover (no gesture): drive cursor feedback only — fires from the element\n    const hover = (e: PointerEvent) => {\n      if (dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    // active drag: track on window so it survives leaving the page bounds\n    const drag = (e: PointerEvent) => {\n      if (!dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    const up = (e: PointerEvent) => {\n      if (!dragging) return;\n      dragging = false;\n      interaction.dispatch(sample('up', e));\n    };\n\n    el.addEventListener('pointerdown', down);\n    el.addEventListener('pointermove', hover);\n    window.addEventListener('pointermove', drag);\n    window.addEventListener('pointerup', up);\n    return () => {\n      el.removeEventListener('pointerdown', down);\n      el.removeEventListener('pointermove', hover);\n      window.removeEventListener('pointermove', drag);\n      window.removeEventListener('pointerup', up);\n    };\n  }, [interaction, page]);\n\n  // Sits on top as the page's event surface; visual layers below use pointerEvents:none.\n  return <div ref={ref} style={{ position: 'absolute', inset: 0, cursor, touchAction: 'none' }} />;\n}\n\n/** Read + switch the active tool (for a toolbar). */\nexport function useTool() {\n  const interaction = useCapability(InteractionToken);\n  const activeToolId = useSelector(InteractionToken, (c) => c.activeToolId());\n  return {\n    activeToolId,\n    activate: interaction.activateTool,\n    tools: interaction.tools(),\n  };\n}\n\n/** One cursor slot: an SVG image ({@link SvgCursorOptions}) or a plain CSS\n *  cursor string ('crosshair', 'url(…) 4 4, copy'). */\nexport type ToolCursorImage = SvgCursorOptions | string;\n\n/** What {@link useToolCursor} installs: the tool to reskin + its keyword map.\n *  Apps build `svg` from the SAME icon their toolbar renders, so the cursor\n *  and the button can never drift apart. */\nexport interface ToolCursorSpec {\n  toolId: string;\n  /** keyword → cursor: restyle the keywords this tool can show — its declared\n   *  base ('crosshair', 'copy') and hover claims ('text' over text) — in the\n   *  tool's identity. Keywords the map omits render as-is: a markup tool's\n   *  'default' base stays the bare arrow, a foreign 'move' claim drops the\n   *  icon. An SVG value defaults its keyword `fallback` to the keyword it\n   *  replaces. */\n  cursors: Record<string, ToolCursorImage>;\n}\n\nconst toCursor = (img: ToolCursorImage, fallback?: string): string =>\n  typeof img === 'string'\n    ? img\n    : svgCursor(img.fallback === undefined && fallback ? { ...img, fallback } : img);\n\n/**\n * Give a tool IMAGE cursors — the armed-tool indicator. The cursor is the only\n * zero-latency pointer-locked pixel the platform has, and the hub already\n * arbitrates it: unmapped hover claims beat it over annotations/text, page\n * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill\n * controls) carries its own CSS cursor — so nothing chases the pointer in\n * DOM. `null` installs nothing. A re-render with new content rebuilds the\n * cursor (live recolor from tool defaults); unmount restores the tool's\n * declared cursors.\n */\nexport function useToolCursor(spec: ToolCursorSpec | null): void {\n  const interaction = useCapability(InteractionToken);\n  // Key the effect by VALUE: specs are built inline in render, and a\n  // fresh-but-identical object must not thrash the skin.\n  const key = spec && JSON.stringify(spec);\n  const ref = useRef(spec);\n  ref.current = spec;\n  useEffect(() => {\n    const s = ref.current;\n    if (!s) return;\n    interaction.setToolCursor(\n      s.toolId,\n      Object.fromEntries(Object.entries(s.cursors).map(([k, v]) => [k, toCursor(v, k)])),\n    );\n    return () => interaction.setToolCursor(s.toolId, null);\n  }, [interaction, key]);\n}\n"],"mappings":"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"}

package/dist/link.cjs

@@ -5,16 +5,33 @@ 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_link = require("@embedpdf/plugin-link");
 //#region src/link.tsx
+/**
+* Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE
+* place in the codebase that turns a link target into a browser tab. The
+* plugin owns resolution (goto → stage reveal, policy, analytics) and stays
+* DOM-free; opening is this framework layer's job. Every click path — the nav
+* 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);
+	if (activation.outcome === "uri") {
+		const href = (0, _embedpdf_web.sanitizeExternalUri)(activation.uri);
+		if (href && typeof window !== "undefined") window.open(href, "_blank", "noopener,noreferrer");
+	}
+	return activation;
+}
 /** Content rect → view px (the page wrapper's own space) — the same idiom as
 *  the annotation and form layers: never re-derive `x * scale`. */
 function boxOf(item, page) {
-	const tl = page.transform.pageToContent({
+	const tl = page.transform.toPixels({
 		x: item.rect.x,
 		y: item.rect.y
 	});
-	const br = page.transform.pageToContent({
+	const br = page.transform.toPixels({
 		x: item.rect.x + item.rect.width,
 		y: item.rect.y + item.rect.height
 	});
@@ -40,20 +57,24 @@ function LinkLayer({ renderLink } = {}) {
 	const link = require_runtime.useCapability(_embedpdf_plugin_link.LinkToken);
 	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);
 	(0, react.useEffect)(() => {
 		link.ensurePage(page.pon);
 	}, [link, page.pon]);
 	if (!engaged || !items.length) return null;
+	const visible = editEnabled ? items.filter((i) => !i.attached) : items;
+	if (!visible.length) return null;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		style: {
 			position: "absolute",
 			inset: 0,
 			pointerEvents: "none"
 		},
-		children: items.map((item) => {
+		children: visible.map((item) => {
 			const box = boxOf(item, page);
+			const href = item.target.kind === "uri" ? (0, _embedpdf_web.sanitizeExternalUri)(item.target.uri) : null;
 			const native = /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-				href: (item.target.kind === "uri" ? (0, _embedpdf_web.sanitizeExternalUri)(item.target.uri) : null) ?? void 0,
+				href: href ?? void 0,
 				target: "_blank",
 				rel: "noopener noreferrer",
 				role: "link",
@@ -62,13 +83,14 @@ function LinkLayer({ renderLink } = {}) {
 				"aria-label": labelOf(item),
 				onClick: (e) => {
 					if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+					if (href) return;
 					e.preventDefault();
-					link.activate(item.target);
+					openLinkTarget(link, item.target);
 				},
 				onKeyDown: (e) => {
 					if (e.key === "Enter" || e.key === " ") {
 						e.preventDefault();
-						link.activate(item.target);
+						openLinkTarget(link, item.target);
 					}
 				},
 				onPointerDown: (e) => e.stopPropagation(),
@@ -95,6 +117,7 @@ function useLink() {
 }
 //#endregion
 exports.LinkLayer = LinkLayer;
+exports.openLinkTarget = openLinkTarget;
 exports.useLink = useLink;
 Object.keys(_embedpdf_plugin_link).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {

package/dist/link.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"link.cjs","names":["usePage","useCapability","LinkToken","useSelector","shallowArray","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 { LinkToken, type LinkNavItem } from '@embedpdf/plugin-link';\nimport { sanitizeExternalUri } from '@embedpdf/web';\n\nimport { shallowArray, useCapability, usePage, useSelector } from './runtime';\nimport type { PageContextValue } from './runtime';\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.pageToContent({ x: item.rect.x, y: item.rect.y });\n  const br = page.transform.pageToContent({\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\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\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {items.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              // Plain left-click activates through the plugin (stage reveal /\n              // policy / analytics). Modified clicks and middle-clicks on a\n              // real href keep their native browser behaviour.\n              if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n              e.preventDefault();\n              link.activate(item.target);\n            }}\n            onKeyDown={(e) => {\n              if (e.key === 'Enter' || e.key === ' ') {\n                e.preventDefault();\n                link.activate(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":";;;;;;;;;;;AAuBA,SAAS,MAAM,MAAmB,MAAwB;CACxD,MAAM,KAAK,KAAK,UAAU,cAAc;EAAE,GAAG,KAAK,KAAK;EAAG,GAAG,KAAK,KAAK;CAAE,CAAC;CAC1E,MAAM,KAAK,KAAK,UAAU,cAAc;EACtC,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,OAAOA,gBAAAA,QAAQ;CACrB,MAAM,OAAOC,gBAAAA,cAAcC,sBAAAA,SAAS;CACpC,MAAM,QAAQC,gBAAAA,YAAYD,sBAAAA,YAAY,MAAM,EAAE,QAAQ,KAAK,GAAG,GAAGE,gBAAAA,YAAY;CAC7E,MAAM,UAAUD,gBAAAA,YAAYD,sBAAAA,YAAY,MAAM,EAAE,QAAQ,CAAC;CAEzD,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,KAAK,WAAW,KAAK,GAAG;CAC1B,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC;CAInB,IAAI,CAAC,WAAW,CAAC,MAAM,QAAQ,OAAO;CAEtC,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EAAK,OAAO;GAAE,UAAU;GAAY,OAAO;GAAG,eAAe;EAAO;EACjE,UAAA,MAAM,KAAK,SAAS;GACnB,MAAM,MAAM,MAAM,MAAM,IAAI;GAI5B,MAAM,SACJ,iBAAA,GAAA,kBAAA,IAAA,CAAC,KAAD;IACE,OAHS,KAAK,OAAO,SAAS,SAAA,GAAA,cAAA,oBAAA,CAA4B,KAAK,OAAO,GAAG,IAAI,SAG/D,KAAA;IACd,QAAO;IACP,KAAI;IACJ,MAAK;IACL,UAAU;IACV,OAAO,QAAQ,IAAI;IACnB,cAAY,QAAQ,IAAI;IACxB,UAAU,MAAM;KAId,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ;KACtD,EAAE,eAAe;KACjB,KAAK,SAAS,KAAK,MAAM;IAC3B;IACA,YAAY,MAAM;KAChB,IAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;MACtC,EAAE,eAAe;MACjB,KAAK,SAAS,KAAK,MAAM;KAC3B;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,iBAAA,GAAA,kBAAA,IAAA,CAACG,MAAM,UAAP,EAAA,UAA+B,IAAoB,GAA9B,KAAK,EAAyB;EAC5D,CAAC;CACE,CAAA;AAET;AAEA,SAAgB,UAAU;CACxB,OAAOJ,gBAAAA,cAAcC,sBAAAA,SAAS;AAChC"}
+{"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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"}