@embedpdf/plugin-annotation 2.7.0 → 2.9.0

package/dist/lib/annotation-plugin.d.ts

@@ -17,6 +17,7 @@ export declare class AnnotationPlugin extends BasePlugin<AnnotationPluginConfig,
     private importQueue;
     private commitInProgress;
     private handlerFactories;
+    private selectionHandlerFactories;
     private readonly activeTool$;
     private readonly events$;
     private readonly toolsChange$;
@@ -33,6 +34,7 @@ export declare class AnnotationPlugin extends BasePlugin<AnnotationPluginConfig,
     protected onDocumentLoaded(documentId: string): void;
     protected onDocumentClosed(documentId: string): void;
     private registerHandlerFactories;
+    private registerSelectionHandlerFactories;
     private registerBuiltInPatches;
     initialize(): Promise<void>;
     private registerInteractionForTool;

package/dist/lib/geometry/cloudy-border.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Cloudy border path generator for PDF annotations.
+ *
+ * Framework-agnostic utility that generates SVG path `d` strings for cloudy
+ * (scalloped) borders on Rectangle, Ellipse, and Polygon shapes.
+ *
+ * Derived from Apache PDFBox's CloudyBorder.java:
+ * https://github.com/apache/pdfbox/blob/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/interactive/annotation/handlers/CloudyBorder.java
+ *
+ * Original code licensed under the Apache License, Version 2.0:
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Substantially modified: ported from Java to TypeScript, adapted for SVG
+ * path output, and reworked curl distribution and merging logic.
+ *
+ * Copyright (c) 2026 CloudPDF / EmbedPDF
+ *
+ * @module
+ */
+interface BBox {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/** Rect differences (inset from annotation Rect to drawn shape). */
+export interface RectDifferences {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export interface CloudyPathResult {
+    /** SVG path `d` attribute string */
+    path: string;
+    /** Bounding box of the generated cloudy border (in annotation-local coords) */
+    bbox: BBox;
+}
+/**
+ * Returns the per-side outward extent of a cloudy border (how far the
+ * scallop peaks + stroke extend beyond the inner shape boundary).
+ *
+ * Use this to compute `rectangleDifferences` for Square/Circle or the
+ * padding for Polygon Rect computation.
+ */
+export declare function getCloudyBorderExtent(intensity: number, lineWidth: number, isEllipse: boolean): number;
+/**
+ * Generates a cloudy border SVG path for a rectangle (Square annotation).
+ *
+ * @param rect - The annotation rect `{ x, y, width, height }` (top-left origin)
+ * @param rd - Rectangle differences (inset), or undefined
+ * @param intensity - Cloudy border intensity (typically 1 or 2)
+ * @param lineWidth - Stroke width of the annotation border
+ */
+export declare function generateCloudyRectanglePath(rect: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, rd: RectDifferences | undefined, intensity: number, lineWidth: number): CloudyPathResult;
+/**
+ * Generates a cloudy border SVG path for an ellipse (Circle annotation).
+ *
+ * @param rect - The annotation rect `{ x, y, width, height }` (top-left origin)
+ * @param rd - Rectangle differences (inset), or undefined
+ * @param intensity - Cloudy border intensity (typically 1 or 2)
+ * @param lineWidth - Stroke width of the annotation border
+ */
+export declare function generateCloudyEllipsePath(rect: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, rd: RectDifferences | undefined, intensity: number, lineWidth: number): CloudyPathResult;
+/**
+ * Generates a cloudy border SVG path for a polygon.
+ *
+ * @param vertices - The polygon vertices in annotation-local coordinates
+ * @param rectOrigin - The annotation rect origin `{ x, y }` for coordinate translation
+ * @param intensity - Cloudy border intensity (typically 1 or 2)
+ * @param lineWidth - Stroke width of the annotation border
+ */
+export declare function generateCloudyPolygonPath(vertices: ReadonlyArray<{
+    x: number;
+    y: number;
+}>, rectOrigin: {
+    x: number;
+    y: number;
+}, intensity: number, lineWidth: number): CloudyPathResult;
+export {};

package/dist/lib/geometry/index.d.ts

@@ -1 +1,2 @@
 export * from './rotation';
+export * from './cloudy-border';

package/dist/lib/handlers/index.d.ts

@@ -1,4 +1,5 @@
 export * from './ink.handler';
+export * from './text.handler';
 export * from './free-text.handler';
 export * from './line.handler';
 export * from './polyline.handler';
@@ -6,3 +7,6 @@ export * from './polygon.handler';
 export * from './square.handler';
 export * from './stamp.handler';
 export * from './circle.handler';
+export * from './text-markup.handler';
+export * from './insert-text.handler';
+export * from './replace-text.handler';

package/dist/lib/handlers/insert-text.handler.d.ts

@@ -0,0 +1,8 @@
+import { PdfCaretAnnoObject } from '@embedpdf/models';
+import { SelectionHandlerFactory } from './types';
+/**
+ * Selection handler for the "Insert Text" tool.
+ * Creates a single Caret annotation at the end of the text selection
+ * with intent "Insert".
+ */
+export declare const insertTextSelectionHandler: SelectionHandlerFactory<PdfCaretAnnoObject>;

package/dist/lib/handlers/replace-text.handler.d.ts

@@ -0,0 +1,9 @@
+import { PdfStrikeOutAnnoObject } from '@embedpdf/models';
+import { SelectionHandlerFactory } from './types';
+/**
+ * Selection handler for the "Replace Text" tool.
+ * Creates a Caret annotation (group leader, intent "Replace") at the end
+ * of the selection, plus a StrikeOut annotation (intent "StrikeOutTextEdit")
+ * over the full selection, linked to the Caret via IRT/RT=Group.
+ */
+export declare const replaceTextSelectionHandler: SelectionHandlerFactory<PdfStrikeOutAnnoObject>;

package/dist/lib/handlers/selection-utils.d.ts

@@ -0,0 +1,7 @@
+import { Rect } from '@embedpdf/models';
+/**
+ * Compute a caret annotation rect at the end of a text selection.
+ * The caret is half the line height, bottom-aligned with the line,
+ * and horizontally centered on the line's end edge.
+ */
+export declare function computeCaretRect(lastSegRect: Rect): Rect;

package/dist/lib/handlers/text-markup.handler.d.ts

@@ -0,0 +1,7 @@
+import { SelectionHandlerFactory } from './types';
+/**
+ * Default selection handler for text-markup tools (highlight, underline,
+ * strikeout, squiggly). Used as a fallback when no tool-specific
+ * SelectionHandlerFactory is registered.
+ */
+export declare const textMarkupSelectionHandler: SelectionHandlerFactory;

package/dist/lib/handlers/text.handler.d.ts

@@ -0,0 +1,3 @@
+import { PdfTextAnnoObject } from '@embedpdf/models';
+import { HandlerFactory } from './types';
+export declare const textHandlerFactory: HandlerFactory<PdfTextAnnoObject>;

package/dist/lib/handlers/types.d.ts

@@ -1,5 +1,6 @@
 import { PointerEventHandlersWithLifecycle } from '@embedpdf/plugin-interaction-manager';
-import { PdfAnnotationObject, PdfAnnotationSubtype, Rect, Rotation, Size, AnnotationCreateContext, PdfAnnotationBorderStyle, Position, LineEndings, PdfInkListObject, PdfStandardFont, PdfTextAlignment, PdfVerticalAlignment } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfAnnotationSubtype, Rect, Rotation, Size, AnnotationCreateContext, PdfAnnotationBorderStyle, Position, LineEndings, PdfInkListObject, PdfStandardFont, PdfTextAlignment, PdfVerticalAlignment, PdfBlendMode } from '@embedpdf/models';
+import { FormattedSelection } from '@embedpdf/plugin-selection';
 import { AnnotationTool } from '../tools/types';
 export interface CirclePreviewData {
     rect: Rect;
@@ -53,6 +54,7 @@ export interface InkPreviewData {
     strokeWidth: number;
     strokeColor: string;
     opacity: number;
+    blendMode?: PdfBlendMode;
 }
 export interface FreeTextPreviewData {
     rect: Rect;
@@ -138,4 +140,15 @@ export interface HandlerContext<A extends PdfAnnotationObject> {
     onPreview: (state: AnyPreviewState | null) => void;
     onCommit: (annotation: A, context?: AnnotationCreateContext<A>) => void;
 }
+export interface SelectionHandlerContext<A extends PdfAnnotationObject = PdfAnnotationObject> {
+    toolId: string;
+    documentId: string;
+    getTool: () => AnnotationTool<A> | null;
+    createAnnotation: (pageIndex: number, annotation: PdfAnnotationObject) => void;
+    selectAnnotation: (pageIndex: number, id: string) => void;
+}
+export interface SelectionHandlerFactory<A extends PdfAnnotationObject = PdfAnnotationObject> {
+    toolId: string;
+    handle(context: SelectionHandlerContext<A>, selections: FormattedSelection[], getText: () => Promise<string | undefined>): void;
+}
 export {};

package/dist/lib/helpers.d.ts

@@ -8,7 +8,7 @@ export type AnnoOf<S extends PdfAnnotationSubtype> = Extract<PdfAnnotationObject
     type: S;
 }>;
 export type TextMarkupSubtype = PdfAnnotationSubtype.HIGHLIGHT | PdfAnnotationSubtype.UNDERLINE | PdfAnnotationSubtype.STRIKEOUT | PdfAnnotationSubtype.SQUIGGLY;
-export type SidebarSubtype = TextMarkupSubtype | PdfAnnotationSubtype.INK | PdfAnnotationSubtype.SQUARE | PdfAnnotationSubtype.CIRCLE | PdfAnnotationSubtype.POLYGON | PdfAnnotationSubtype.LINE | PdfAnnotationSubtype.POLYLINE | PdfAnnotationSubtype.FREETEXT | PdfAnnotationSubtype.STAMP | PdfAnnotationSubtype.REDACT;
+export type SidebarSubtype = TextMarkupSubtype | PdfAnnotationSubtype.TEXT | PdfAnnotationSubtype.INK | PdfAnnotationSubtype.SQUARE | PdfAnnotationSubtype.CIRCLE | PdfAnnotationSubtype.POLYGON | PdfAnnotationSubtype.LINE | PdfAnnotationSubtype.POLYLINE | PdfAnnotationSubtype.FREETEXT | PdfAnnotationSubtype.STAMP | PdfAnnotationSubtype.REDACT | PdfAnnotationSubtype.CARET;
 /** True when `a.object.type === INK` – and narrows the generic. */
 export declare function isInk(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.INK>>;
 /** Example for Circle – create similar ones for Square, Line, etc. */
@@ -27,4 +27,5 @@ export declare function isStamp(a: TrackedAnnotation): a is TrackedAnnotation<An
 export declare function isText(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.TEXT>>;
 export declare function isLink(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.LINK>>;
 export declare function isRedact(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.REDACT>>;
+export declare function isCaret(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.CARET>>;
 export declare function isSidebarAnnotation(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<SidebarSubtype>>;

package/dist/lib/selectors.d.ts

@@ -40,9 +40,14 @@ export declare function getToolDefaultsById<K extends keyof ToolMap>(state: Anno
  * Collect every sidebar-eligible annotation and attach its TEXT replies,
  * grouped by page for efficient rendering.
  *
+ * Annotations linked via IRT / RT=Group are collapsed: the group leader
+ * becomes the sidebar entry and its non-LINK group members are attached
+ * as `groupMembers`. This keeps the sidebar compact for tools like
+ * Replace Text (Caret + StrikeOut pair).
+ *
  * Result shape:
  * {
- *   0: [{ page: 0, annotation: <TrackedAnnotation>, replies: [ … ] }, ...],
+ *   0: [{ page: 0, annotation: <TrackedAnnotation>, replies: [ … ], groupMembers: [ … ] }, ...],
  *   1: [{ page: 1, annotation: <TrackedAnnotation>, replies: [ … ] }, ...],
  *   …
  * }

package/dist/lib/tools/default-tools.d.ts

@@ -1,15 +1,42 @@
 import { PdfAnnotationBorderStyle, PdfAnnotationLineEnding, PdfAnnotationSubtype, PdfBlendMode, PdfStandardFont, PdfTextAlignment, PdfVerticalAlignment } from '@embedpdf/models';
 export declare const defaultTools: ({
+    id: string;
+    name: string;
+    matchScore: (annotation: import('@embedpdf/models').PdfAnnotationObject) => number;
+    defaults: Partial<import('@embedpdf/models').PdfInkAnnoObject>;
+    interaction: {
+        mode?: string;
+        exclusive: boolean;
+        cursor?: string;
+        textSelection?: boolean;
+        showSelectionRects?: boolean;
+        isDraggable?: import('./types').DynamicBooleanProp;
+        isResizable?: import('./types').DynamicBooleanProp;
+        isRotatable?: import('./types').DynamicBooleanProp;
+        lockAspectRatio?: import('./types').DynamicBooleanProp;
+        lockGroupAspectRatio?: import('./types').DynamicBooleanProp;
+        isGroupDraggable?: import('./types').DynamicBooleanProp;
+        isGroupResizable?: import('./types').DynamicBooleanProp;
+        isGroupRotatable?: import('./types').DynamicBooleanProp;
+    };
+    behavior?: ({
+        deactivateToolAfterCreate?: boolean;
+        selectAfterCreate?: boolean;
+        useAppearanceStream?: boolean;
+    } & import('./types').InkBehavior) | undefined;
+} | {
     id: "highlight";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         textSelection: true;
         isDraggable: false;
         isResizable: false;
+        isRotatable: false;
         isGroupDraggable: false;
         isGroupResizable: false;
+        showSelectionRects?: undefined;
         cursor?: undefined;
         lockAspectRatio?: undefined;
         lockGroupAspectRatio?: undefined;
@@ -20,8 +47,8 @@ export declare const defaultTools: ({
         color: string;
         opacity: number;
         blendMode: PdfBlendMode.Multiply;
-        strokeWidth?: undefined;
         intent?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -37,14 +64,16 @@ export declare const defaultTools: ({
 } | {
     id: "underline";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         textSelection: true;
         isDraggable: false;
         isResizable: false;
+        isRotatable: false;
         isGroupDraggable: false;
         isGroupResizable: false;
+        showSelectionRects?: undefined;
         cursor?: undefined;
         lockAspectRatio?: undefined;
         lockGroupAspectRatio?: undefined;
@@ -55,8 +84,8 @@ export declare const defaultTools: ({
         color: string;
         opacity: number;
         blendMode?: undefined;
-        strokeWidth?: undefined;
         intent?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -72,14 +101,16 @@ export declare const defaultTools: ({
 } | {
     id: "strikeout";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         textSelection: true;
         isDraggable: false;
         isResizable: false;
+        isRotatable: false;
         isGroupDraggable: false;
         isGroupResizable: false;
+        showSelectionRects?: undefined;
         cursor?: undefined;
         lockAspectRatio?: undefined;
         lockGroupAspectRatio?: undefined;
@@ -90,8 +121,8 @@ export declare const defaultTools: ({
         color: string;
         opacity: number;
         blendMode?: undefined;
-        strokeWidth?: undefined;
         intent?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -107,14 +138,16 @@ export declare const defaultTools: ({
 } | {
     id: "squiggly";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         textSelection: true;
         isDraggable: false;
         isResizable: false;
+        isRotatable: false;
         isGroupDraggable: false;
         isGroupResizable: false;
+        showSelectionRects?: undefined;
         cursor?: undefined;
         lockAspectRatio?: undefined;
         lockGroupAspectRatio?: undefined;
@@ -125,8 +158,8 @@ export declare const defaultTools: ({
         color: string;
         opacity: number;
         blendMode?: undefined;
-        strokeWidth?: undefined;
         intent?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -140,28 +173,30 @@ export declare const defaultTools: ({
     clickBehavior?: undefined;
     behavior?: undefined;
 } | {
-    id: "ink";
+    id: "insertText";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 5;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1 | 2;
     interaction: {
         exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: false;
-        textSelection?: undefined;
-        isGroupDraggable?: undefined;
-        isGroupResizable?: undefined;
+        textSelection: true;
+        showSelectionRects: true;
+        isDraggable: false;
+        isResizable: false;
+        isRotatable: false;
+        isGroupDraggable: false;
+        isGroupResizable: false;
+        cursor?: undefined;
+        lockAspectRatio?: undefined;
         lockGroupAspectRatio?: undefined;
     };
     defaults: {
-        type: PdfAnnotationSubtype.INK;
+        type: PdfAnnotationSubtype.CARET;
         strokeColor: string;
-        color: string;
         opacity: number;
-        strokeWidth: number;
+        intent: string;
+        color?: undefined;
         blendMode?: undefined;
-        intent?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -175,28 +210,30 @@ export declare const defaultTools: ({
     clickBehavior?: undefined;
     behavior?: undefined;
 } | {
-    id: "inkHighlighter";
+    id: "replaceText";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 10;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 2;
     interaction: {
         exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: false;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-        textSelection?: undefined;
-        isGroupDraggable?: undefined;
-        isGroupResizable?: undefined;
+        textSelection: true;
+        isDraggable: false;
+        isResizable: false;
+        isRotatable: false;
+        isGroupDraggable: false;
+        isGroupResizable: false;
+        showSelectionRects?: undefined;
+        cursor?: undefined;
+        lockAspectRatio?: undefined;
+        lockGroupAspectRatio?: undefined;
     };
     defaults: {
-        type: PdfAnnotationSubtype.INK;
-        intent: string;
+        type: PdfAnnotationSubtype.STRIKEOUT;
         strokeColor: string;
-        color: string;
         opacity: number;
-        strokeWidth: number;
-        blendMode: PdfBlendMode.Multiply;
+        intent: string;
+        color?: undefined;
+        blendMode?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -212,7 +249,7 @@ export declare const defaultTools: ({
 } | {
     id: "circle";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         cursor: string;
@@ -221,8 +258,10 @@ export declare const defaultTools: ({
         lockAspectRatio: false;
         lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
         isGroupResizable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.CIRCLE;
@@ -256,7 +295,7 @@ export declare const defaultTools: ({
 } | {
     id: "square";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         cursor: string;
@@ -265,8 +304,10 @@ export declare const defaultTools: ({
         lockAspectRatio: false;
         lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
         isGroupResizable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.SQUARE;
@@ -300,7 +341,7 @@ export declare const defaultTools: ({
 } | {
     id: "line";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 5;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 5 | 0;
     interaction: {
         exclusive: false;
         cursor: string;
@@ -310,7 +351,9 @@ export declare const defaultTools: ({
         isGroupResizable: true;
         lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.LINE;
@@ -351,7 +394,9 @@ export declare const defaultTools: ({
         isGroupResizable: true;
         lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.LINE;
@@ -385,7 +430,7 @@ export declare const defaultTools: ({
 } | {
     id: "polyline";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         cursor: string;
@@ -395,7 +440,9 @@ export declare const defaultTools: ({
         isGroupResizable: true;
         lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.POLYLINE;
@@ -420,7 +467,7 @@ export declare const defaultTools: ({
 } | {
     id: "polygon";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         cursor: string;
@@ -430,7 +477,9 @@ export declare const defaultTools: ({
         isGroupResizable: true;
         lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.POLYGON;
@@ -452,10 +501,51 @@ export declare const defaultTools: ({
     };
     clickBehavior?: undefined;
     behavior?: undefined;
+} | {
+    id: "textComment";
+    name: string;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
+    interaction: {
+        exclusive: false;
+        cursor: string;
+        isDraggable: true;
+        isResizable: false;
+        isRotatable: false;
+        textSelection?: undefined;
+        isGroupDraggable?: undefined;
+        isGroupResizable?: undefined;
+        showSelectionRects?: undefined;
+        lockAspectRatio?: undefined;
+        lockGroupAspectRatio?: undefined;
+    };
+    defaults: {
+        type: PdfAnnotationSubtype.TEXT;
+        strokeColor: string;
+        opacity: number;
+        color?: undefined;
+        blendMode?: undefined;
+        intent?: undefined;
+        strokeWidth?: undefined;
+        strokeStyle?: undefined;
+        lineEndings?: undefined;
+        contents?: undefined;
+        fontSize?: undefined;
+        fontColor?: undefined;
+        fontFamily?: undefined;
+        textAlign?: undefined;
+        verticalAlign?: undefined;
+        backgroundColor?: undefined;
+    };
+    behavior: {
+        selectAfterCreate: true;
+        insertUpright?: undefined;
+        useAppearanceStream?: undefined;
+    };
+    clickBehavior?: undefined;
 } | {
     id: "freeText";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         cursor: string;
@@ -464,8 +554,10 @@ export declare const defaultTools: ({
         lockAspectRatio: false;
         lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
         isGroupResizable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.FREETEXT;
@@ -480,8 +572,8 @@ export declare const defaultTools: ({
         opacity: number;
         strokeColor?: undefined;
         blendMode?: undefined;
-        strokeWidth?: undefined;
         intent?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
     };
@@ -497,12 +589,13 @@ export declare const defaultTools: ({
     };
     behavior: {
         insertUpright: true;
+        selectAfterCreate?: undefined;
         useAppearanceStream?: undefined;
     };
 } | {
     id: "stamp";
     name: string;
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 1 | 0;
+    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
     interaction: {
         exclusive: false;
         cursor: string;
@@ -511,8 +604,10 @@ export declare const defaultTools: ({
         lockAspectRatio: true;
         lockGroupAspectRatio: true;
         textSelection?: undefined;
+        isRotatable?: undefined;
         isGroupDraggable?: undefined;
         isGroupResizable?: undefined;
+        showSelectionRects?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.STAMP;
@@ -520,8 +615,8 @@ export declare const defaultTools: ({
         color?: undefined;
         opacity?: undefined;
         blendMode?: undefined;
-        strokeWidth?: undefined;
         intent?: undefined;
+        strokeWidth?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -535,6 +630,7 @@ export declare const defaultTools: ({
     behavior: {
         insertUpright: true;
         useAppearanceStream: false;
+        selectAfterCreate?: undefined;
     };
     clickBehavior?: undefined;
 })[];