@embedpdf/plugin-annotation 3.0.0-next.10 → 3.0.0-next.11

package/dist/{types-DITX_3CG.d.ts → types-otwv-Cdl.d.ts}

@@ -1,5 +1,6 @@
 import { DocumentEvent, PageObjectNumber } from "@embedpdf/core";
-import { AnnotationAppearanceImage, AnnotationDTO, AnnotationDraft, AnnotationPatch, AnnotationRef, AttachmentContent, AttachmentFileSource, BinarySource, CommentThread, InkIntent, PdfLinkTarget, PdfRect } from "@embedpdf/engine-core/runtime";
+import { AnnotCommitEntry, AnnotCommitResult } from "@embedpdf/plugin-actions/contract/host";
+import { AnnotationAppearanceImage, AnnotationDTO, AnnotationDraft, AnnotationPatch, AnnotationRef, AttachmentContent, AttachmentFileSource, BinarySource, CommentThread, InkIntent, PdfActionTree, PdfLinkTarget, PdfRect } from "@embedpdf/engine-core/runtime";
 import { AnnotationFlags, AnnotationProps, AnnotationPropsPatch, ChromeNode, ClickCreate, CreationDraftAnchor, Geom, Id, InkStraightenOptions, Model, PropKey, PropSpec, Rect, RenderItem, SnapSettings, Subtype, TextEndAnchor, TextQuad, Vec, ViewEnv } from "@embedpdf/core-annotation";
 import { PageRotation } from "@embedpdf/core-geometry";
 //#region src/tools.d.ts
@@ -429,6 +430,19 @@ interface LinkNavItem {
    * stays selectable/movable; standalone document links navigate regardless.
    */
   attached: boolean;
+  /** The full payload-carrying `/A` tree, when one exists — the action
+   *  engine's dispatch input. `target` remains its root projection. */
+  activate?: PdfActionTree;
+  /** The annotation ref, carried for ActionSource context. */
+  ref?: AnnotationRef;
+  /** Which `/AA` hover trees this link carries — the nav layer's pump flags
+   *  (tree-less hover must cost zero dispatches). Links are behavior-inert
+   *  to the annotation plane's hover feed while navigable, so THEIR
+   *  cursorEnter/cursorExit can only fire from the LinkLayer anchors. */
+  hoverEvents?: {
+    enter: boolean;
+    exit: boolean;
+  };
 }
 interface Behavior {
   id: string;
@@ -490,8 +504,9 @@ interface TextItem {
  * package root (`@embedpdf/plugin-annotation`).
  *
  * Framework-only plumbing (render projection, pointer gestures, behavior
- * registration) lives on {@link AnnotationHostCapability}, reachable only through
- * the `@embedpdf/plugin-annotation/internal` entry. Both are the SAME runtime
+ * registration) lives on {@link AnnotationHostCapability}, reachable through
+ * `@embedpdf/plugin-annotation/contract/host` (and the framework's `/internal`
+ * entry). Both are the SAME runtime
  * object — two typed lenses on one token — so app code simply can't see the host
  * methods.
  */
@@ -818,8 +833,9 @@ type FilePickerProvider = (req: FilePromptRequest) => Promise<AttachmentFileSour
 /**
  * The HOST (framework) surface: everything the render layer, the interaction hub,
  * and sibling plugins need, on top of the public {@link AnnotationCapability}.
- * Internal — import the token from `@embedpdf/plugin-annotation/internal`, never
- * from application code.
+ * Host-only — sibling plugins import the token from
+ * `@embedpdf/plugin-annotation/contract/host`; framework implementation code may
+ * use `/internal`. Never use either from application code.
  */
 interface AnnotationHostCapability extends AnnotationCapability {
   /** `view` (the page's scale + total display rotation, from its transform)
@@ -1046,13 +1062,25 @@ interface AnnotationHostCapability extends AnnotationCapability {
    *  gesture and the created annotation's PDF kind. Falls back to the id. */
   toolSubtype(id: string): Subtype;
   registerBehavior(b: Behavior): () => void;
+  /**
+   * The actions plane's session-visibility write (Hide actions, script
+   * `annot.hidden`): resolve annotation OBJECT NUMBERS to loaded model ids
+   * (the `obj:` refKey seam) and merge session-hidden overrides. Returns how
+   * many resolved — unresolved numbers (unloaded pages, nm/index refs) are
+   * the caller's diagnostics. Session state only; never an engine write.
+   */
+  /** The script/Hide DOCUMENT-commit door (full ISO): engine updates +
+   *  model reconciliation, per entry, stop-on-failure. Never enqueues,
+   *  never touches the script host — the D2 sink contract. */
+  commitScriptEffects(entries: AnnotCommitEntry[]): Promise<AnnotCommitResult>;
 }
 /**
  * The annotation capability token. Typed to the full {@link AnnotationHostCapability}
- * here (the package internals + the `/internal` entry use this view). The package
- * root re-exports the SAME token narrowed to {@link AnnotationCapability}.
+ * here (the package internals, `/contract/host`, and `/internal` use this view).
+ * The package root re-exports the SAME token narrowed to
+ * {@link AnnotationCapability}.
  */
 declare const AnnotationToken: import("@embedpdf/core").CapabilityToken<AnnotationHostCapability>;
 //#endregion
 export { StampSourceSpec as A, AnnotationToolInput as C, PromptSourceSpec as D, InkAuthoringOptions as E, ToolDefaultsFor as M, buildToolRegistry as N, ResolvedTool as O, AnnotationToolDef as S, GhostPolicy as T, SelectionProps as _, AnnotationHydration as a, ThreadDeleteResult as b, Behavior as c, CommentPermissions as d, CommentsApi as f, SelectionFlags as g, LinkNavItem as h, AnnotationHostCapability as i, ToolAuthoringKind as j, SelectionAuthoring as k, ChromeSettings as l, FilePromptRequest as m, AnnotationCapability as n, AnnotationState as o, FilePickerProvider as p, AnnotationConfig as r, AnnotationToken as s, AnnotationAction as t, ChromeSettingsPatch as u, StampToolInput as v, DEFAULT_TOOLS as w, ToolGhost as x, TextItem as y };
-//# sourceMappingURL=types-DITX_3CG.d.ts.map
+//# sourceMappingURL=types-otwv-Cdl.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/plugin-annotation",
-  "version": "3.0.0-next.10",
+  "version": "3.0.0-next.11",
   "private": false,
   "description": "Annotation feature plugin: the pure annotation-core wired to the engine repository (optimistic create/patch/delete) + the interaction hub (ambient edit + draw tools). Behaviors (forms) plug in here.",
   "type": "module",
@@ -12,6 +12,18 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./authoring": {
+      "import": "./dist/authoring.js",
+      "require": "./dist/authoring.cjs"
+    },
+    "./contract": {
+      "import": "./dist/contract.js",
+      "require": "./dist/contract.cjs"
+    },
+    "./contract/host": {
+      "import": "./dist/contract/host.js",
+      "require": "./dist/contract/host.cjs"
+    },
     "./internal": {
       "import": "./dist/internal.js",
       "require": "./dist/internal.cjs"
@@ -22,12 +34,14 @@
     "dist"
   ],
   "dependencies": {
-    "@embedpdf/core-annotation": "3.0.0-next.10",
-    "@embedpdf/core": "3.0.0-next.10",
-    "@embedpdf/core-geometry": "3.0.0-next.10",
-    "@embedpdf/plugin-interaction": "3.0.0-next.10",
-    "@embedpdf/engine-core": "3.0.0-next.10",
-    "@embedpdf/plugin-selection": "3.0.0-next.10"
+    "@embedpdf/core-annotation": "3.0.0-next.11",
+    "@embedpdf/core-geometry": "3.0.0-next.11",
+    "@embedpdf/core": "3.0.0-next.11",
+    "@embedpdf/plugin-selection": "3.0.0-next.11",
+    "@embedpdf/plugin-interaction": "3.0.0-next.11",
+    "@embedpdf/engine-core": "3.0.0-next.11",
+    "@embedpdf/core-acrojs": "3.0.0-next.11",
+    "@embedpdf/plugin-actions": "3.0.0-next.11"
   },
   "devDependencies": {
     "typescript": "^5.0.0",