@embedpdf/plugin-annotation 3.0.0-next.4 → 3.0.0-next.5

package/dist/{types-CfewRmXH.d.cts → types-BCB5YKIk.d.ts}

@@ -1,7 +1,7 @@
 import { PageObjectNumber } from "@embedpdf/core";
-import { PageRotation } from "@embedpdf/core-geometry";
 import { AnnotationAppearanceImage, AnnotationDTO, AnnotationDraft, AnnotationPatch, AnnotationRef, AttachmentContent, AttachmentFileSource, BinarySource, InkIntent, 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
 /**
  * How a stamp-family tool resolves the image bytes it places — pure DATA, so a
@@ -604,6 +604,21 @@ interface AnnotationCapability {
    * (`extends`, per-tool `defaults`, …). Returns an unregister fn.
    */
   registerTool(def: AnnotationToolInput): () => void;
+  /**
+   * Turn the CURRENT text selection into markup annotations — one per
+   * selected page, from the selection's oriented per-line quads — then clear
+   * the selection. The one-call form of what the markup tools do on
+   * commit, made for selection-menu buttons ("Highlight") and automation.
+   * `preset` is a tool id whose defaults style the markup (e.g.
+   * `'highlight'`); defaults to the subtype's own. Returns false (and does
+   * nothing) when no selection plugin is installed or nothing is selected.
+   */
+  markupFromSelection(subtype: Subtype, preset?: string): boolean;
+  /** Commit the in-progress multi-click creation draft (no-op when there is
+   *  none, or it can't finish yet — see `creationDraftAnchor().canFinish`). */
+  finishCreationDraft(): void;
+  /** Discard the in-progress multi-click creation draft. */
+  cancelCreationDraft(): void;
   deleteSelection(): void;
   deselect(): void;
   cancel(): void;
@@ -793,10 +808,8 @@ interface AnnotationHostCapability extends AnnotationCapability {
    *  `displayRotation` (the DOWN sample's page rotation: /Rotate + view rotation)
    *  feeds the tool's `upright` policy — omit it and upright is a no-op. */
   createPointer(tool: string, phase: 'down' | 'move' | 'up', pon: PageObjectNumber, point: Vec, finish?: boolean, displayRotation?: PageRotation): void;
-  finishCreationDraft(): void;
   /** Commit the strokes currently buffered by an ink tool's grouping window. */
   finishInkDraft(): void;
-  cancelCreationDraft(): void;
   /** Create one text-markup annotation on a page from the selected text's
    *  per-line oriented quads (content space) — the `text-selection` create
    *  gesture. Axis-aligned callers build quads with `textQuadFromRect`. */
@@ -877,4 +890,4 @@ interface AnnotationHostCapability extends AnnotationCapability {
 declare const AnnotationToken: import("@embedpdf/core").CapabilityToken<AnnotationHostCapability>;
 //#endregion
 export { PromptSourceSpec as C, ToolAuthoringKind as D, StampSourceSpec as E, ToolDefaultsFor as O, InkAuthoringOptions as S, SelectionAuthoring as T, ToolGhost as _, AnnotationState as a, DEFAULT_TOOLS as b, ChromeSettings as c, FilePromptRequest as d, LinkNavItem as f, TextItem as g, StampToolInput as h, AnnotationHostCapability as i, buildToolRegistry as k, ChromeSettingsPatch as l, SelectionProps as m, AnnotationCapability as n, AnnotationToken as o, SelectionFlags as p, AnnotationConfig as r, Behavior as s, AnnotationAction as t, FilePickerProvider as u, AnnotationToolDef as v, ResolvedTool as w, GhostPolicy as x, AnnotationToolInput as y };
-//# sourceMappingURL=types-CfewRmXH.d.cts.map
+//# sourceMappingURL=types-BCB5YKIk.d.ts.map

package/dist/{types-DZ29RSW9.d.ts → types-N25K86pT.d.cts}

@@ -1,7 +1,7 @@
 import { PageObjectNumber } from "@embedpdf/core";
+import { PageRotation } from "@embedpdf/core-geometry";
 import { AnnotationAppearanceImage, AnnotationDTO, AnnotationDraft, AnnotationPatch, AnnotationRef, AttachmentContent, AttachmentFileSource, BinarySource, InkIntent, 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
 /**
  * How a stamp-family tool resolves the image bytes it places — pure DATA, so a
@@ -604,6 +604,21 @@ interface AnnotationCapability {
    * (`extends`, per-tool `defaults`, …). Returns an unregister fn.
    */
   registerTool(def: AnnotationToolInput): () => void;
+  /**
+   * Turn the CURRENT text selection into markup annotations — one per
+   * selected page, from the selection's oriented per-line quads — then clear
+   * the selection. The one-call form of what the markup tools do on
+   * commit, made for selection-menu buttons ("Highlight") and automation.
+   * `preset` is a tool id whose defaults style the markup (e.g.
+   * `'highlight'`); defaults to the subtype's own. Returns false (and does
+   * nothing) when no selection plugin is installed or nothing is selected.
+   */
+  markupFromSelection(subtype: Subtype, preset?: string): boolean;
+  /** Commit the in-progress multi-click creation draft (no-op when there is
+   *  none, or it can't finish yet — see `creationDraftAnchor().canFinish`). */
+  finishCreationDraft(): void;
+  /** Discard the in-progress multi-click creation draft. */
+  cancelCreationDraft(): void;
   deleteSelection(): void;
   deselect(): void;
   cancel(): void;
@@ -793,10 +808,8 @@ interface AnnotationHostCapability extends AnnotationCapability {
    *  `displayRotation` (the DOWN sample's page rotation: /Rotate + view rotation)
    *  feeds the tool's `upright` policy — omit it and upright is a no-op. */
   createPointer(tool: string, phase: 'down' | 'move' | 'up', pon: PageObjectNumber, point: Vec, finish?: boolean, displayRotation?: PageRotation): void;
-  finishCreationDraft(): void;
   /** Commit the strokes currently buffered by an ink tool's grouping window. */
   finishInkDraft(): void;
-  cancelCreationDraft(): void;
   /** Create one text-markup annotation on a page from the selected text's
    *  per-line oriented quads (content space) — the `text-selection` create
    *  gesture. Axis-aligned callers build quads with `textQuadFromRect`. */
@@ -877,4 +890,4 @@ interface AnnotationHostCapability extends AnnotationCapability {
 declare const AnnotationToken: import("@embedpdf/core").CapabilityToken<AnnotationHostCapability>;
 //#endregion
 export { PromptSourceSpec as C, ToolAuthoringKind as D, StampSourceSpec as E, ToolDefaultsFor as O, InkAuthoringOptions as S, SelectionAuthoring as T, ToolGhost as _, AnnotationState as a, DEFAULT_TOOLS as b, ChromeSettings as c, FilePromptRequest as d, LinkNavItem as f, TextItem as g, StampToolInput as h, AnnotationHostCapability as i, buildToolRegistry as k, ChromeSettingsPatch as l, SelectionProps as m, AnnotationCapability as n, AnnotationToken as o, SelectionFlags as p, AnnotationConfig as r, Behavior as s, AnnotationAction as t, FilePickerProvider as u, AnnotationToolDef as v, ResolvedTool as w, GhostPolicy as x, AnnotationToolInput as y };
-//# sourceMappingURL=types-DZ29RSW9.d.ts.map
+//# sourceMappingURL=types-N25K86pT.d.cts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/plugin-annotation",
-  "version": "3.0.0-next.4",
+  "version": "3.0.0-next.5",
   "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",
@@ -22,12 +22,12 @@
     "dist"
   ],
   "dependencies": {
-    "@embedpdf/core": "3.0.0-next.4",
-    "@embedpdf/core-geometry": "3.0.0-next.4",
-    "@embedpdf/core-annotation": "3.0.0-next.4",
-    "@embedpdf/plugin-interaction": "3.0.0-next.4",
-    "@embedpdf/plugin-selection": "3.0.0-next.4",
-    "@embedpdf/engine-core": "3.0.0-next.4"
+    "@embedpdf/core": "3.0.0-next.5",
+    "@embedpdf/core-annotation": "3.0.0-next.5",
+    "@embedpdf/plugin-interaction": "3.0.0-next.5",
+    "@embedpdf/plugin-selection": "3.0.0-next.5",
+    "@embedpdf/engine-core": "3.0.0-next.5",
+    "@embedpdf/core-geometry": "3.0.0-next.5"
   },
   "devDependencies": {
     "typescript": "^5.0.0",