@embedpdf/plugin-annotation 2.15.0 → 3.0.0-next.1

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

@@ -1,90 +0,0 @@
-/**
- * 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,2 +0,0 @@
-export * from './rotation';
-export * from './cloudy-border';

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

@@ -1,32 +0,0 @@
-import { Rect } from '@embedpdf/models';
-/**
- * Re-export rotation geometry utilities from @embedpdf/models.
- *
- * These functions used to live here but have been promoted to the shared models
- * package so that both @embedpdf/utils (DragResizeController) and
- * @embedpdf/plugin-annotation (patches) can import from the same source.
- *
- * Existing imports from this module continue to work unchanged.
- */
-export { rotatePointAround as rotatePointAroundCenter, rotateVertices, getRectCenter, calculateRotatedRectAABBAroundPoint, calculateRotatedRectAABB, inferRotationCenterFromRects, } from '@embedpdf/models';
-/**
- * Convert an AABB-space rect to unrotated space.
- *
- * During group resize the pipeline works in AABB space (axis-aligned bounding
- * box), but `baseResizeScaling` expects the incoming rect in unrotated space.
- *
- * The AABB of a rect rotated by θ around its center is:
- *   AABB_w = w·|cosθ| + h·|sinθ|
- *   AABB_h = w·|sinθ| + h·|cosθ|
- *
- * This function inverts that system to recover (w, h) from the new AABB size.
- * Near 45° the system is degenerate (the AABB is always square), so we fall
- * back to uniform scaling based on the area ratio.
- *
- * @param newAABBRect - the proportionally scaled AABB rect from the group resize
- * @param originalAABBRect - the original AABB rect captured at resize start
- * @param originalUnrotatedRect - the original unrotated rect captured at resize start
- * @param rotationDegrees - the annotation's rotation in degrees
- * @returns the equivalent rect in unrotated space
- */
-export declare function convertAABBRectToUnrotatedSpace(newAABBRect: Rect, originalAABBRect: Rect, originalUnrotatedRect: Rect, rotationDegrees: number): Rect;

package/dist/lib/handlers/callout-free-text.handler.d.ts

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

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

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

package/dist/lib/handlers/click-detector.d.ts

@@ -1,27 +0,0 @@
-import { PdfAnnotationObject } from '@embedpdf/models';
-import { AnnotationTool } from '../tools/types';
-interface ClickDetectorOptions<T extends PdfAnnotationObject> {
-    threshold?: number;
-    getTool: () => AnnotationTool<T> | undefined;
-    onClickDetected: (pos: {
-        x: number;
-        y: number;
-    }, tool: AnnotationTool<T>) => void;
-}
-export declare function useClickDetector<T extends PdfAnnotationObject>({ threshold, getTool, onClickDetected, }: ClickDetectorOptions<T>): {
-    onStart: (pos: {
-        x: number;
-        y: number;
-    }) => void;
-    onMove: (pos: {
-        x: number;
-        y: number;
-    }) => void;
-    onEnd: (pos: {
-        x: number;
-        y: number;
-    }) => void;
-    hasMoved: () => boolean;
-    reset: () => void;
-};
-export {};

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

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

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

@@ -1,14 +0,0 @@
-export * from './ink.handler';
-export * from './text.handler';
-export * from './free-text.handler';
-export * from './callout-free-text.handler';
-export * from './line.handler';
-export * from './polyline.handler';
-export * from './polygon.handler';
-export * from './square.handler';
-export * from './stamp.handler';
-export * from './circle.handler';
-export * from './link.handler';
-export * from './text-markup.handler';
-export * from './insert-text.handler';
-export * from './replace-text.handler';

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

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

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

@@ -1,8 +0,0 @@
-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/line.handler.d.ts

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

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

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

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

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

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

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

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

@@ -1,9 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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/square.handler.d.ts

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

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

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

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

@@ -1,7 +0,0 @@
-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

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

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

@@ -1,176 +0,0 @@
-import { PointerEventHandlersWithLifecycle } from '@embedpdf/plugin-interaction-manager';
-import { PdfAnnotationObject, PdfAnnotationSubtype, Rect, Rotation, Size, AnnotationCreateContext, PdfAnnotationBorderStyle, Position, LineEndings, PdfInkListObject, PdfStandardFont, PdfTextAlignment, PdfVerticalAlignment, PdfBlendMode, PdfAnnotationLineEnding } from '@embedpdf/models';
-import { FormattedSelection } from '@embedpdf/plugin-selection';
-import { AnnotationTool } from '../tools/types';
-export interface CirclePreviewData {
-    rect: Rect;
-    color: string;
-    opacity: number;
-    strokeWidth: number;
-    strokeColor: string;
-    strokeStyle: PdfAnnotationBorderStyle;
-    strokeDashArray: number[];
-}
-export interface SquarePreviewData extends CirclePreviewData {
-}
-export interface PolygonPreviewData {
-    rect: Rect;
-    vertices: Position[];
-    currentVertex: Position;
-    color?: string;
-    opacity?: number;
-    strokeWidth: number;
-    strokeColor?: string;
-    strokeStyle?: PdfAnnotationBorderStyle;
-    strokeDashArray?: number[];
-}
-export interface PolylinePreviewData {
-    rect: Rect;
-    vertices: Position[];
-    currentVertex: Position;
-    color: string;
-    strokeColor: string;
-    opacity: number;
-    strokeWidth: number;
-    lineEndings?: LineEndings;
-}
-export interface LinePreviewData {
-    rect: Rect;
-    linePoints: {
-        start: Position;
-        end: Position;
-    };
-    strokeWidth: number;
-    color: string;
-    strokeColor: string;
-    opacity: number;
-    lineEndings?: LineEndings;
-    strokeStyle: PdfAnnotationBorderStyle;
-    strokeDashArray: number[];
-}
-export interface InkPreviewData {
-    rect: Rect;
-    inkList: PdfInkListObject[];
-    strokeWidth: number;
-    strokeColor: string;
-    opacity: number;
-    blendMode?: PdfBlendMode;
-}
-export interface FreeTextPreviewData {
-    rect: Rect;
-    fontColor?: string;
-    opacity?: number;
-    fontSize?: number;
-    fontFamily?: PdfStandardFont;
-    backgroundColor?: string;
-    textAlign?: PdfTextAlignment;
-    verticalAlign?: PdfVerticalAlignment;
-    contents?: string;
-    calloutLine?: Position[];
-    textBox?: Rect;
-    strokeColor?: string;
-    strokeWidth?: number;
-    lineEnding?: PdfAnnotationLineEnding;
-    color?: string;
-}
-export interface LinkPreviewData {
-    rect: Rect;
-    strokeColor: string;
-    strokeWidth: number;
-    strokeStyle: PdfAnnotationBorderStyle;
-    strokeDashArray: number[];
-}
-export interface StampPreviewData {
-    rect: Rect;
-    ghostUrl: string;
-    pageRotation: Rotation;
-}
-/**
- * Map types to their preview data
- */
-export interface PreviewDataMap {
-    [PdfAnnotationSubtype.CIRCLE]: CirclePreviewData;
-    [PdfAnnotationSubtype.SQUARE]: SquarePreviewData;
-    [PdfAnnotationSubtype.POLYGON]: PolygonPreviewData;
-    [PdfAnnotationSubtype.POLYLINE]: PolylinePreviewData;
-    [PdfAnnotationSubtype.LINE]: LinePreviewData;
-    [PdfAnnotationSubtype.INK]: InkPreviewData;
-    [PdfAnnotationSubtype.FREETEXT]: FreeTextPreviewData;
-    [PdfAnnotationSubtype.LINK]: LinkPreviewData;
-    [PdfAnnotationSubtype.STAMP]: StampPreviewData;
-}
-/**
- * Typed preview state - constrain T to keys that exist in PreviewDataMap
- */
-export type TypedPreviewState<T extends keyof PreviewDataMap> = {
-    type: T;
-    bounds: Rect;
-    data: PreviewDataMap[T];
-};
-/**
- * Union of all preview states
- */
-export type AnyPreviewState = {
-    [K in keyof PreviewDataMap]: TypedPreviewState<K>;
-}[keyof PreviewDataMap];
-/**
- * Generic version for handlers - use conditional type for safety
- */
-export interface PreviewState<T extends PdfAnnotationSubtype = PdfAnnotationSubtype> {
-    type: T;
-    bounds: Rect;
-    data: T extends keyof PreviewDataMap ? PreviewDataMap[T] : any;
-}
-/**
- * Defines the DOM-based services that the UI layer must provide to the handlers.
- * This is the bridge that keeps the core logic framework-agnostic.
- */
-export interface HandlerServices {
-    requestFile(options: {
-        accept: string;
-        onFile: (file: File) => void;
-    }): void;
-}
-/**
- * Extensible map from tool ID to per-activation context data.
- * Plugins extend this via declaration merging to provide typed context
- * for their custom tools (e.g. stamp appearance data, ghost image URL).
- */
-export interface ToolContextMap {
-}
-/**
- * Resolves the tool context type for a given tool ID.
- * Returns the mapped type if known, otherwise a generic record.
- */
-export type ResolvedToolContext<TId extends string> = TId extends keyof ToolContextMap ? ToolContextMap[TId] : Record<string, unknown>;
-/**
- * The context object passed to a handler factory when creating a handler.
- * It contains all the necessary information and callbacks.
- */
-export interface HandlerFactory<A extends PdfAnnotationObject, TId extends string = string> {
-    annotationType: PdfAnnotationSubtype;
-    create(context: HandlerContext<A, TId>): PointerEventHandlersWithLifecycle;
-}
-export interface HandlerContext<A extends PdfAnnotationObject, TId extends string = string> {
-    getTool: () => AnnotationTool<A> | undefined;
-    getToolContext: () => ResolvedToolContext<TId> | undefined;
-    pageIndex: number;
-    pageSize: Size;
-    /** Effective page rotation (page intrinsic + document rotation), as a quarter-turn value (0-3). */
-    pageRotation: Rotation;
-    scale: number;
-    services: HandlerServices;
-    onPreview: (state: PreviewState<A['type']> | 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;
-}

package/dist/lib/helpers.d.ts

@@ -1,46 +0,0 @@
-import { PdfAnnotationSubtype, PdfAnnotationObject, PdfAnnotationOf, Rect } from '@embedpdf/models';
-import { LockMode, TrackedAnnotation } from './types';
-import { AnnotationTool } from './tools/types';
-/**
- * Check if two rectangles intersect
- */
-export declare function rectsIntersect(a: Rect, b: Rect): boolean;
-export type AnnoOf<S extends PdfAnnotationSubtype> = PdfAnnotationOf<S>;
-export type TextMarkupSubtype = PdfAnnotationSubtype.HIGHLIGHT | PdfAnnotationSubtype.UNDERLINE | PdfAnnotationSubtype.STRIKEOUT | PdfAnnotationSubtype.SQUIGGLY;
-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. */
-export declare function isCircle(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.CIRCLE>>;
-export declare function isPolygon(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.POLYGON>>;
-export declare function isSquare(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.SQUARE>>;
-export declare function isLine(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.LINE>>;
-export declare function isPolyline(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.POLYLINE>>;
-export declare function isHighlight(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.HIGHLIGHT>>;
-export declare function isUnderline(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.UNDERLINE>>;
-export declare function isStrikeout(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.STRIKEOUT>>;
-export declare function isSquiggly(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.SQUIGGLY>>;
-export declare function isTextMarkup(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<TextMarkupSubtype>>;
-export declare function isFreeText(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.FREETEXT>>;
-export declare function isStamp(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.STAMP>>;
-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 isWidget(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.WIDGET>>;
-export declare function isSidebarAnnotation(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<SidebarSubtype>>;
-export declare function isSelectableAnnotation(a: TrackedAnnotation): boolean;
-/** Extract the category tags from a tool (returns `[]` for uncategorized). */
-export declare function getAnnotationCategories(tool: AnnotationTool | null): string[];
-/** Check if the category-based LockMode locks annotations with these categories. */
-export declare function isCategoryLocked(categories: string[], mode: LockMode): boolean;
-/** Check if the annotation itself has the PDF 'locked' flag (bit 7). */
-export declare function hasLockedFlag(annotation: PdfAnnotationObject): boolean;
-/** Check if the annotation has the PDF 'noView' flag (bit 6). */
-export declare function hasNoViewFlag(annotation: PdfAnnotationObject): boolean;
-/** Check if the annotation has the PDF 'hidden' flag (bit 2): do not render, do not interact, do not print. */
-export declare function hasHiddenFlag(annotation: PdfAnnotationObject): boolean;
-/** Check if the annotation has the PDF 'readOnly' flag (bit 7): do not allow user interaction. Ignored for widgets per spec. */
-export declare function hasReadOnlyFlag(annotation: PdfAnnotationObject): boolean;
-/** Check if the annotation has the PDF 'lockedContents' flag (bit 10): content cannot be modified by the user. */
-export declare function hasLockedContentsFlag(annotation: PdfAnnotationObject): boolean;

package/dist/lib/index.d.ts

@@ -1,21 +0,0 @@
-import { PluginPackage } from '@embedpdf/core';
-import { AnnotationPluginConfig, AnnotationState } from './types';
-import { AnnotationPlugin } from './annotation-plugin';
-import { AnnotationAction } from './actions';
-export declare const AnnotationPluginPackage: PluginPackage<AnnotationPlugin, AnnotationPluginConfig, AnnotationState, AnnotationAction>;
-export * from './annotation-plugin';
-export * from './types';
-export * from './manifest';
-export * from './selectors';
-export * from './helpers';
-export * from './handlers/types';
-export * from './tools/types';
-export type { DefaultAnnotationTool, DefaultAnnotationToolMap } from './tools/default-tools';
-export * from './tools/tools-utils';
-export * from './geometry';
-export * as patching from './patching';
-export type { PatchFunction, TransformContext } from './patching/patch-registry';
-export * from './patching/insert-upright';
-export { initialState, initialDocumentState } from './reducer';
-export { useState } from './utils/use-state';
-export { useClickDetector } from './handlers/click-detector';

package/dist/lib/manifest.d.ts

@@ -1,4 +0,0 @@
-import { PluginManifest } from '@embedpdf/core';
-import { AnnotationPluginConfig } from './types';
-export declare const ANNOTATION_PLUGIN_ID = "annotation";
-export declare const manifest: PluginManifest<AnnotationPluginConfig>;

package/dist/lib/patching/base-patch.d.ts

@@ -1,87 +0,0 @@
-import { Rect } from '@embedpdf/models';
-import { TransformContext } from './patch-registry';
-/**
- * Minimal shape required by the shared patch helpers.
- * All annotation objects satisfy this through PdfAnnotationObject.
- */
-export interface RotatableAnnotation {
-    rect: Rect;
-    unrotatedRect?: Rect;
-    rotation?: number;
-}
-/**
- * Shared rotate logic.
- * Returns the full patch (rect, unrotatedRect, rotation) or `null` when the
- * context doesn't carry a rotationAngle (in which case the caller should
- * fall through to `ctx.changes`).
- */
-export declare function baseRotateChanges(orig: RotatableAnnotation, ctx: TransformContext<any>): Partial<{
-    rect: Rect;
-    unrotatedRect: Rect;
-    rotation: number;
-}> | null;
-/**
- * Shared property-update rotation logic.
- * Recomputes rect and unrotatedRect for a new rotation angle, preserving
- * the annotation's rotation center. Works for all annotation types since
- * it only touches rect/unrotatedRect/rotation.
- */
-export declare function basePropertyRotationChanges(orig: RotatableAnnotation, newRotation: number): {
-    rotation: number;
-    rect: Rect;
-    unrotatedRect: Rect;
-};
-/**
- * Shared move logic: computes dx/dy and translates rect + unrotatedRect.
- * Callers use the returned `dx`/`dy` to translate their own type-specific
- * data (vertices, linePoints, inkList, etc.).
- */
-export declare function baseMoveChanges(orig: RotatableAnnotation, newRect: Rect): {
-    dx: number;
-    dy: number;
-    rects: {
-        rect: Rect;
-        unrotatedRect?: Rect;
-    };
-};
-export interface ResizeScalingResult {
-    /** Horizontal scale factor */
-    scaleX: number;
-    /** Vertical scale factor */
-    scaleY: number;
-    /** The old rect used as the scaling reference (unrotatedRect ?? rect) */
-    oldRect: Rect;
-    /** The adjusted new rect after min-size and aspect-ratio enforcement */
-    resolvedRect: Rect;
-    /** The final rect + unrotatedRect patches to spread into the result */
-    rects: {
-        rect: Rect;
-        unrotatedRect?: Rect;
-    };
-}
-/**
- * Shared resize scaling logic:
- * 1. Determines scale factors from oldRect → newRect
- * 2. Enforces a minimum size of 10
- * 3. Optionally maintains aspect ratio
- * 4. Resolves rect vs unrotatedRect for rotated annotations
- *
- * Callers use `scaleX`, `scaleY`, `oldRect`, and `resolvedRect` to scale
- * their own type-specific data (vertices, linePoints, etc.), then spread
- * `rects` into their result.
- */
-export declare function baseResizeScaling(orig: RotatableAnnotation, newRect: Rect, metadata?: {
-    maintainAspectRatio?: boolean;
-}): ResizeScalingResult;
-/**
- * Compute the orbit translation (dx/dy) from a rotation result.
- * Point-based annotations (line, polyline, polygon, ink) use this to
- * translate their vertices/points alongside the rect orbit during
- * group rotation. For single-annotation rotation the delta is zero.
- */
-export declare function rotateOrbitDelta(orig: RotatableAnnotation, rotateResult: {
-    unrotatedRect?: Rect;
-}): {
-    dx: number;
-    dy: number;
-};

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

@@ -1,6 +0,0 @@
-export * from './patch-utils';
-export * from './line-ending-handlers';
-export * from './line-endings';
-export * from './patch-registry';
-export * from './insert-upright';
-export * from './patches';

package/dist/lib/patching/insert-upright.d.ts

@@ -1,20 +0,0 @@
-import { PdfAnnotationObject, Rotation, Size } from '@embedpdf/models';
-/**
- * Applies a counter-rotation to make an annotation appear visually upright
- * on a rotated page. Uses `basePropertyRotationChanges` to correctly compute
- * rect, unrotatedRect, and rotation for the annotation.
- *
- * @param annotation - The annotation to transform
- * @param pageRotation - Effective page rotation as quarter-turn value (0-3)
- * @param rectWasDrawn - `true` if the rect was produced by a marquee drag
- *   (PagePointerProvider transposes dimensions on 90/270 pages),
- *   `false` if the rect was placed from config/content (click-to-place, stamp)
- * @returns The annotation with rotation, unrotatedRect, and rect set
- */
-export declare function applyInsertUpright<T extends PdfAnnotationObject>(annotation: T, pageRotation: Rotation, rectWasDrawn: boolean): T;
-/**
- * Clamps an annotation's rect to stay within page bounds.
- * If the annotation has an unrotatedRect, it is shifted by the same delta
- * to keep the geometry consistent.
- */
-export declare function clampAnnotationToPage<T extends PdfAnnotationObject>(annotation: T, pageSize: Size): T;

package/dist/lib/patching/line-ending-handlers.d.ts

@@ -1,20 +0,0 @@
-import { PdfAnnotationLineEnding, Position } from '@embedpdf/models';
-/**
- * A handler that encapsulates all logic for a specific line ending type,
- * including SVG path generation, geometric vertex calculation, and rotation logic.
- * This is the single source of truth for each ending.
- */
-export interface LineEndingHandler {
-    /** Returns the SVG `d` attribute string for rendering. */
-    getSvgPath: (strokeWidth: number) => string;
-    /** Returns the vertices used for calculating the geometric bounding box. */
-    getLocalPoints: (strokeWidth: number) => Position[];
-    /** Returns the final rotation angle in radians based on the line segment's angle. */
-    getRotation: (segmentAngle: number) => number;
-    /** True if the shape should be filled, false if only stroked. */
-    filled: boolean;
-}
-/**
- * A map containing the authoritative handler for each line ending type.
- */
-export declare const LINE_ENDING_HANDLERS: Partial<Record<PdfAnnotationLineEnding, LineEndingHandler>>;