@embedpdf/plugin-annotation 1.0.11 → 1.0.13

package/dist/shared-react/components/annotations/square-paint.d.ts

@@ -0,0 +1,10 @@
+interface SquarePaintProps {
+    pageIndex: number;
+    scale: number;
+    pageWidth: number;
+    pageHeight: number;
+    /** Optional preview cursor */
+    cursor?: string;
+}
+export declare const SquarePaint: ({ pageIndex, scale, pageWidth, pageHeight, cursor, }: SquarePaintProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/shared-react/components/annotations/square.d.ts

@@ -0,0 +1,29 @@
+import { MouseEvent } from '../../../react/adapter.ts';
+import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+interface SquareProps {
+    /** Fill colour – defaults to PDFium’s black if omitted */
+    color?: string;
+    /** Stroke colour – defaults to same as fill when omitted */
+    strokeColor?: string;
+    /** 0 – 1 */
+    opacity?: number;
+    /** Stroke width in PDF units */
+    strokeWidth: number;
+    /** Stroke type – defaults to solid when omitted */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array – defaults to undefined when omitted */
+    strokeDashArray?: number[];
+    /** Bounding box of the annotation (PDF units) */
+    rect: Rect;
+    /** Current page zoom factor */
+    scale: number;
+    /** Click handler (used for selection) */
+    onClick?: (e: MouseEvent<SVGElement>) => void;
+    /** Cursor shown over the annotation */
+    cursor?: string;
+}
+/**
+ * Renders a PDF Square annotation (rectangle) as SVG.
+ */
+export declare function Square({ color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, cursor, }: SquareProps): JSX.Element;
+export {};

package/dist/shared-react/components/annotations.d.ts

@@ -0,0 +1,11 @@
+import { SelectionMenu } from '../types';
+interface AnnotationsProps {
+    pageIndex: number;
+    scale: number;
+    rotation: number;
+    pageWidth: number;
+    pageHeight: number;
+    selectionMenu?: SelectionMenu;
+}
+export declare function Annotations(annotationsProps: AnnotationsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/counter-rotate-container.d.ts

@@ -0,0 +1,32 @@
+import { Rect, Rotation } from '@embedpdf/models';
+import { ReactNode, CSSProperties, PointerEvent } from '../../react/adapter.ts';
+interface CounterRotateProps {
+    rect: Rect;
+    rotation: Rotation;
+}
+interface CounterTransformResult {
+    matrix: string;
+    width: number;
+    height: number;
+}
+/**
+ * Given an already-placed rect (left/top/width/height in px) and the page rotation,
+ * return the counter-rotation matrix + adjusted width/height.
+ *
+ * transform-origin is expected to be "0 0".
+ * left/top DO NOT change, apply them as-is.
+ */
+export declare function getCounterRotation(rect: Rect, rotation: Rotation): CounterTransformResult;
+export interface MenuWrapperProps {
+    style: CSSProperties;
+    onPointerDown: (e: PointerEvent<HTMLDivElement>) => void;
+}
+interface CounterRotateComponentProps extends CounterRotateProps {
+    children: (props: {
+        matrix: string;
+        rect: Rect;
+        menuWrapperProps: MenuWrapperProps;
+    }) => ReactNode;
+}
+export declare function CounterRotate({ children, ...props }: CounterRotateComponentProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/index.d.ts

@@ -0,0 +1 @@
+export * from './annotation-layer';

package/dist/shared-react/components/render-annotation.d.ts

@@ -0,0 +1,11 @@
+import { HTMLAttributes, CSSProperties } from '../../react/adapter.ts';
+import { PdfAnnotationObject } from '@embedpdf/models';
+type RenderAnnotationProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {
+    pageIndex: number;
+    annotation: PdfAnnotationObject;
+    scaleFactor?: number;
+    dpr?: number;
+    style?: CSSProperties;
+};
+export declare function RenderAnnotation({ pageIndex, annotation, scaleFactor, dpr, style, ...props }: RenderAnnotationProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/resize-handles.d.ts

@@ -0,0 +1,9 @@
+import { ResizeDirection } from '../types';
+import { PointerEvent } from '../../react/adapter.ts';
+interface Props {
+    rotation: number;
+    outlineOffset?: number;
+    startResize: (d: ResizeDirection) => (e: PointerEvent<HTMLDivElement>) => void;
+}
+export declare function ResizeHandles({ rotation, outlineOffset, startResize }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/text-markup/highlight.d.ts

@@ -0,0 +1,13 @@
+import { HTMLAttributes, CSSProperties, MouseEvent } from '../../../react/adapter.ts';
+import { Rect } from '@embedpdf/models';
+type HighlightProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
+    color?: string;
+    opacity?: number;
+    rects: Rect[];
+    rect?: Rect;
+    scale: number;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
+    style?: CSSProperties;
+};
+export declare function Highlight({ color, opacity, rects, rect, scale, onClick, style, ...props }: HighlightProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/text-markup/squiggly.d.ts

@@ -0,0 +1,13 @@
+import { HTMLAttributes, CSSProperties, MouseEvent } from '../../../react/adapter.ts';
+import { Rect } from '@embedpdf/models';
+type SquigglyProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
+    color?: string;
+    opacity?: number;
+    rects: Rect[];
+    rect?: Rect;
+    scale: number;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
+    style?: CSSProperties;
+};
+export declare function Squiggly({ color, opacity, rects, rect, scale, onClick, style, ...props }: SquigglyProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/text-markup/strikeout.d.ts

@@ -0,0 +1,13 @@
+import { HTMLAttributes, CSSProperties, MouseEvent } from '../../../react/adapter.ts';
+import { Rect } from '@embedpdf/models';
+type StrikeoutProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
+    color?: string;
+    opacity?: number;
+    rects: Rect[];
+    rect?: Rect;
+    scale: number;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
+    style?: CSSProperties;
+};
+export declare function Strikeout({ color, opacity, rects, rect, scale, onClick, style, ...props }: StrikeoutProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/text-markup/underline.d.ts

@@ -0,0 +1,13 @@
+import { HTMLAttributes, CSSProperties, MouseEvent } from '../../../react/adapter.ts';
+import { Rect } from '@embedpdf/models';
+type UnderlineProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
+    color?: string;
+    opacity?: number;
+    rects: Rect[];
+    rect?: Rect;
+    scale: number;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
+    style?: CSSProperties;
+};
+export declare function Underline({ color, opacity, rects, rect, scale, onClick, style, ...props }: UnderlineProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared-react/components/text-markup.d.ts

@@ -0,0 +1,6 @@
+interface TextMarkupProps {
+    pageIndex: number;
+    scale: number;
+}
+export declare function TextMarkup({ pageIndex, scale }: TextMarkupProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/shared-react/components/vertex-editor.d.ts

@@ -0,0 +1,19 @@
+import { JSX } from '../../react/adapter.ts';
+import { Position, Rect } from '@embedpdf/models';
+export interface VertexEditorProps {
+    /** Bounding box (PDF units) of the annotation            */
+    rect: Rect;
+    /** Page rotation (0-3)                                    */
+    rotation: number;
+    /** Current zoom factor                                   */
+    scale: number;
+    /** Array of vertices in PDF units                        */
+    vertices: Position[];
+    /** Called *every* drag frame with new vertices           */
+    onEdit: (v: Position[]) => void;
+    /** Called once at end of drag to commit changes          */
+    onCommit: (v: Position[]) => void;
+    /** Size of handle in CSS px                              */
+    handleSize?: number;
+}
+export declare function VertexEditor({ rect, rotation, scale, vertices, onEdit, onCommit, handleSize, }: VertexEditorProps): JSX.Element;

package/dist/shared-react/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './use-annotation';

package/dist/shared-react/hooks/use-annotation.d.ts

@@ -0,0 +1,11 @@
+import { AnnotationPlugin } from '../../lib/index.ts';
+export declare const useAnnotationPlugin: () => {
+    plugin: AnnotationPlugin | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};
+export declare const useAnnotationCapability: () => {
+    provides: Readonly<import('../../lib/index.ts').AnnotationCapability> | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};

package/dist/shared-react/hooks/use-drag-resize.d.ts

@@ -0,0 +1,31 @@
+import { PointerEvent } from '../../react/adapter.ts';
+import { PdfAnnotationObject, Position, Rect } from '@embedpdf/models';
+import { TrackedAnnotation } from '../../lib/index.ts';
+import { ResizeDirection } from '../types';
+import { ComputePatch } from '../patchers';
+interface UseDragResizeOpts<T extends PdfAnnotationObject> {
+    scale: number;
+    pageWidth: number;
+    pageHeight: number;
+    rotation: number;
+    tracked: TrackedAnnotation<T>;
+    isSelected: boolean;
+    isDraggable: boolean;
+    isResizable: boolean;
+    computePatch?: ComputePatch<T>;
+    computeVertices?: (a: T) => Position[];
+    currentRect: Rect;
+    setCurrentRect: (r: Rect) => void;
+    setCurrentVertices: (v: Position[]) => void;
+    setPreviewObject: (p: Partial<T> | null) => void;
+    commit: (patch: Partial<T>) => void;
+}
+export declare function useDragResize<T extends PdfAnnotationObject>({ scale, pageWidth, pageHeight, rotation, tracked, isSelected, isDraggable, isResizable, computePatch, computeVertices, currentRect, setCurrentRect, setCurrentVertices, setPreviewObject, commit, }: UseDragResizeOpts<T>): {
+    rootHandlers: {
+        onPointerDown: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerMove: (e: PointerEvent<HTMLDivElement>) => void;
+        onPointerUp: () => void;
+    };
+    startResize: (direction: ResizeDirection) => (e: PointerEvent<HTMLDivElement>) => void;
+};
+export {};

package/dist/shared-react/index.d.ts

@@ -0,0 +1,2 @@
+export * from './hooks';
+export * from './components';

package/dist/shared-react/patch-ink.d.ts

@@ -0,0 +1,16 @@
+import { PdfInkAnnoObject } from '@embedpdf/models';
+import { ComputePatch } from './patchers';
+/**
+ * Computes a patch for resizing an ink annotation.
+ * - Scales all points in inkList to fit the new rect.
+ * - Scales strokeWidth proportionally (using average scale factor).
+ * - Handles non-uniform scaling (stretch).
+ * - Optionally preserves aspect ratio (set uniform=true).
+ *
+ * @param original The original ink annotation object.
+ * @param newRect The new bounding rect after resize.
+ * @param direction The resize handle direction (affects origin adjustments if needed).
+ * @param uniform If true, constrains to uniform scaling (uses min scale factor).
+ * @returns Partial patch { rect, inkList, strokeWidth } to apply.
+ */
+export declare const patchInk: ComputePatch<PdfInkAnnoObject>;

package/dist/shared-react/patchers.d.ts

@@ -0,0 +1,9 @@
+import { PdfAnnotationObject, Rect, Position } from '@embedpdf/models';
+import { ResizeDirection } from './types';
+export interface PatchContext {
+    rect: Rect;
+    vertices?: Position[];
+    direction?: ResizeDirection;
+    uniform?: boolean;
+}
+export type ComputePatch<T extends PdfAnnotationObject> = (original: T, ctx: PatchContext) => Partial<T>;

package/dist/shared-react/types.d.ts

@@ -0,0 +1,12 @@
+import { Rect } from '@embedpdf/models';
+import { TrackedAnnotation } from '../lib/index.ts';
+import { JSX } from '../react/adapter.ts';
+import { MenuWrapperProps } from './components/counter-rotate-container';
+export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
+export interface SelectionMenuProps {
+    annotation: TrackedAnnotation;
+    selected: boolean;
+    rect: Rect;
+    menuWrapperProps: MenuWrapperProps;
+}
+export type SelectionMenu = (props: SelectionMenuProps) => JSX.Element;

package/dist/shared-react/vertex-patchers.d.ts

@@ -0,0 +1,10 @@
+import { PdfAnnotationSubtype, PdfAnnotationObject, PdfLineAnnoObject, PdfPolylineAnnoObject, PdfPolygonAnnoObject, Rect, Position } from '@embedpdf/models';
+export interface PatchContext {
+    rect: Rect;
+    vertices?: Position[];
+}
+export type PatchFn<T extends PdfAnnotationObject> = (original: T, ctx: PatchContext) => Partial<T>;
+export declare const patchLine: PatchFn<PdfLineAnnoObject>;
+export declare const patchPolyline: PatchFn<PdfPolylineAnnoObject>;
+export declare const patchPolygon: PatchFn<PdfPolygonAnnoObject>;
+export declare function getPatchFn(type: PdfAnnotationSubtype): PatchFn<PdfLineAnnoObject> | PatchFn<PdfPolylineAnnoObject> | PatchFn<PdfPolygonAnnoObject> | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/plugin-annotation",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -18,23 +18,24 @@
     }
   },
   "dependencies": {
-    "@embedpdf/models": "1.0.11"
+    "@embedpdf/models": "1.0.13"
   },
   "devDependencies": {
     "@types/react": "^18.2.0",
-    "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "@embedpdf/plugin-interaction-manager": "1.0.11",
-    "@embedpdf/plugin-selection": "1.0.11",
-    "@embedpdf/plugin-history": "1.0.11"
+    "@embedpdf/plugin-selection": "1.0.13",
+    "@embedpdf/plugin-interaction-manager": "1.0.13",
+    "@embedpdf/build": "1.0.0",
+    "@embedpdf/plugin-history": "1.0.13"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
     "preact": "^10.26.4",
-    "@embedpdf/core": "1.0.11",
-    "@embedpdf/plugin-selection": "1.0.11",
-    "@embedpdf/plugin-interaction-manager": "1.0.11"
+    "@embedpdf/core": "1.0.13",
+    "@embedpdf/plugin-history": "1.0.13",
+    "@embedpdf/plugin-interaction-manager": "1.0.13",
+    "@embedpdf/plugin-selection": "1.0.13"
   },
   "files": [
     "dist",
@@ -53,11 +54,12 @@
     "access": "public"
   },
   "scripts": {
-    "build": "PROJECT_CWD=$(pwd) pnpm -w p:build",
-    "build:watch": "PROJECT_CWD=$(pwd) pnpm -w p:build:watch",
-    "clean": "PROJECT_CWD=$(pwd) pnpm -w p:clean",
-    "lint": "PROJECT_CWD=$(pwd) pnpm -w p:lint",
-    "lint:fix": "PROJECT_CWD=$(pwd) pnpm -w p:lint:fix",
-    "typecheck": "PROJECT_CWD=$(pwd) pnpm -w p:typecheck"
+    "build:base": "vite build --mode base",
+    "build:react": "vite build --mode react",
+    "build:preact": "vite build --mode preact",
+    "build": "pnpm run clean && concurrently -c auto -n base,react,preact \"vite build --mode base\" \"vite build --mode react\" \"vite build --mode preact\"",
+    "clean": "rimraf dist",
+    "lint": "eslint src --color",
+    "lint:fix": "eslint src --color --fix"
   }
 }

package/dist/index.d.cts

@@ -1,266 +0,0 @@
-import { BasePluginConfig, EventHook, Action, BasePlugin, PluginRegistry, PluginManifest, PluginPackage } from '@embedpdf/core';
-import { PdfAnnotationSubtype, WebAlphaColor, Task, PdfAnnotationObject, PdfErrorReason, Rotation, AppearanceMode, ImageConversionTypes, PdfEngine } from '@embedpdf/models';
-
-type CommitState = 'new' | 'dirty' | 'deleted' | 'synced' | 'ignored';
-interface TrackedAnnotation {
-    /** A stable, client-side unique identifier for history and state management. */
-    localId: number;
-    /**
-     * If the engine has already created the annotation in the PDF
-     * this is the definitive id coming from the engine.
-     * It is **never** cleared once set.
-     */
-    pdfId?: number;
-    /** local commit bookkeeping */
-    commitState: CommitState;
-    /** the actual annotation object */
-    object: PdfAnnotationObject;
-}
-interface RenderAnnotationOptions {
-    pageIndex: number;
-    annotation: PdfAnnotationObject;
-    scaleFactor?: number;
-    rotation?: Rotation;
-    dpr?: number;
-    mode?: AppearanceMode;
-    imageType?: ImageConversionTypes;
-}
-interface BaseAnnotationDefaults extends WebAlphaColor {
-    interaction: {
-        mode: string;
-        exclusive: boolean;
-        cursor?: string;
-    };
-    textSelection?: boolean;
-}
-interface HighlightDefaults extends BaseAnnotationDefaults {
-    name: 'Highlight';
-}
-interface UnderlineDefaults extends BaseAnnotationDefaults {
-    name: 'Underline';
-}
-interface StrikeoutDefaults extends BaseAnnotationDefaults {
-    name: 'Strikeout';
-}
-interface SquigglyDefaults extends BaseAnnotationDefaults {
-    name: 'Squiggly';
-}
-interface InkDefaults extends BaseAnnotationDefaults {
-    name: 'Ink';
-    strokeWidth: number;
-}
-type AnnotationDefaults = HighlightDefaults | UnderlineDefaults | StrikeoutDefaults | SquigglyDefaults | InkDefaults;
-type ToolDefaultsBySubtype = {
-    [PdfAnnotationSubtype.HIGHLIGHT]: HighlightDefaults;
-    [PdfAnnotationSubtype.UNDERLINE]: UnderlineDefaults;
-    [PdfAnnotationSubtype.STRIKEOUT]: StrikeoutDefaults;
-    [PdfAnnotationSubtype.SQUIGGLY]: SquigglyDefaults;
-    [PdfAnnotationSubtype.INK]: InkDefaults;
-};
-type StylableSubtype = keyof ToolDefaultsBySubtype;
-type ToolDefaults<S extends PdfAnnotationSubtype> = ToolDefaultsBySubtype[Extract<S, keyof ToolDefaultsBySubtype>];
-type ActiveTool = {
-    mode: null;
-    defaults: null;
-} | {
-    [K in StylableSubtype]: {
-        mode: K;
-        defaults: ToolDefaultsBySubtype[K];
-    };
-}[StylableSubtype];
-interface AnnotationState {
-    pages: Record<number, string[]>;
-    byUid: Record<string, TrackedAnnotation>;
-    selectedUid: string | null;
-    annotationMode: StylableSubtype | null;
-    toolDefaults: ToolDefaultsBySubtype;
-    colorPresets: string[];
-    hasPendingChanges: boolean;
-}
-interface AnnotationPluginConfig extends BasePluginConfig {
-    toolDefaults?: Partial<ToolDefaultsBySubtype>;
-    colorPresets?: string[];
-    /**
-     * When `false` mutations are kept in memory and must be
-     * flushed with `commitPendingChanges()`.
-     */
-    autoCommit?: boolean;
-}
-interface AnnotationCapability {
-    getPageAnnotations: (options: GetPageAnnotationsOptions) => Task<PdfAnnotationObject[], PdfErrorReason>;
-    getSelectedAnnotation: () => TrackedAnnotation | null;
-    selectAnnotation: (pageIndex: number, annotationId: number) => void;
-    deselectAnnotation: () => void;
-    getAnnotationMode: () => StylableSubtype | null;
-    setAnnotationMode: (mode: StylableSubtype | null) => void;
-    /** strongly typed – only sub-types we have defaults for */
-    getToolDefaults: <S extends StylableSubtype>(subtype: S) => ToolDefaultsBySubtype[S];
-    /** Partially patch a single tool’s defaults */
-    setToolDefaults: <S extends StylableSubtype>(subtype: S, patch: Partial<ToolDefaultsBySubtype[S]>) => void;
-    /** current palette – UI just reads this */
-    getColorPresets: () => string[];
-    /** append a swatch (deduped by RGBA) */
-    addColorPreset: (color: string) => void;
-    createAnnotation: (pageIndex: number, annotation: PdfAnnotationObject) => void;
-    updateAnnotation: (pageIndex: number, annotationId: number, patch: Partial<PdfAnnotationObject>) => void;
-    deleteAnnotation: (pageIndex: number, annotationId: number) => void;
-    renderAnnotation: (options: RenderAnnotationOptions) => Task<Blob, PdfErrorReason>;
-    /** undo / redo */
-    onStateChange: EventHook<AnnotationState>;
-    onModeChange: EventHook<StylableSubtype | null>;
-    onActiveToolChange: EventHook<ActiveTool>;
-    commit: () => void;
-}
-interface SelectedAnnotation {
-    pageIndex: number;
-    localId: number;
-    annotation: PdfAnnotationObject;
-}
-interface GetPageAnnotationsOptions {
-    pageIndex: number;
-}
-interface UpdateAnnotationColorOptions extends WebAlphaColor {
-    pageIndex: number;
-    annotationId: number;
-}
-
-declare const SET_ANNOTATIONS = "ANNOTATION/SET_ANNOTATIONS";
-declare const REINDEX_PAGE_ANNOTATIONS = "ANNOTATION/REINDEX_PAGE";
-declare const SELECT_ANNOTATION = "ANNOTATION/SELECT_ANNOTATION";
-declare const DESELECT_ANNOTATION = "ANNOTATION/DESELECT_ANNOTATION";
-declare const SET_ANNOTATION_MODE = "ANNOTATION/SET_ANNOTATION_MODE";
-declare const UPDATE_TOOL_DEFAULTS = "ANNOTATION/UPDATE_TOOL_DEFAULTS";
-declare const ADD_COLOR_PRESET = "ANNOTATION/ADD_COLOR_PRESET";
-declare const CREATE_ANNOTATION = "ANNOTATION/CREATE_ANNOTATION";
-declare const PATCH_ANNOTATION = "ANNOTATION/PATCH_ANNOTATION";
-declare const DELETE_ANNOTATION = "ANNOTATION/DELETE_ANNOTATION";
-declare const COMMIT_PENDING_CHANGES = "ANNOTATION/COMMIT";
-declare const STORE_PDF_ID = "ANNOTATION/STORE_PDF_ID";
-declare const PURGE_ANNOTATION = "ANNOTATION/PURGE_ANNOTATION";
-interface SetAnnotationsAction extends Action {
-    type: typeof SET_ANNOTATIONS;
-    payload: Record<number, PdfAnnotationObject[]>;
-}
-interface ReindexPageAnnotationsAction extends Action {
-    type: typeof REINDEX_PAGE_ANNOTATIONS;
-    payload: {
-        pageIndex: number;
-    };
-}
-interface SelectAnnotationAction extends Action {
-    type: typeof SELECT_ANNOTATION;
-    payload: {
-        pageIndex: number;
-        localId: number;
-    };
-}
-interface DeselectAnnotationAction extends Action {
-    type: typeof DESELECT_ANNOTATION;
-}
-interface SetAnnotationModeAction extends Action {
-    type: typeof SET_ANNOTATION_MODE;
-    payload: StylableSubtype | null;
-}
-interface UpdateToolDefaultsAction extends Action {
-    type: typeof UPDATE_TOOL_DEFAULTS;
-    payload: {
-        subtype: StylableSubtype;
-        patch: Partial<ToolDefaultsBySubtype[StylableSubtype]>;
-    };
-}
-interface AddColorPresetAction extends Action {
-    type: typeof ADD_COLOR_PRESET;
-    payload: string;
-}
-interface CreateAnnotationAction extends Action {
-    type: typeof CREATE_ANNOTATION;
-    payload: {
-        pageIndex: number;
-        localId: number;
-        annotation: PdfAnnotationObject;
-    };
-}
-interface PatchAnnotationAction extends Action {
-    type: typeof PATCH_ANNOTATION;
-    payload: {
-        pageIndex: number;
-        localId: number;
-        patch: Partial<PdfAnnotationObject>;
-    };
-}
-interface DeleteAnnotationAction extends Action {
-    type: typeof DELETE_ANNOTATION;
-    payload: {
-        pageIndex: number;
-        localId: number;
-    };
-}
-interface CommitAction extends Action {
-    type: typeof COMMIT_PENDING_CHANGES;
-}
-interface StorePdfIdAction extends Action {
-    type: typeof STORE_PDF_ID;
-    payload: {
-        uid: string;
-        pdfId: number;
-    };
-}
-interface PurgeAnnotationAction extends Action {
-    type: typeof PURGE_ANNOTATION;
-    payload: {
-        uid: string;
-    };
-}
-type AnnotationAction = SetAnnotationsAction | ReindexPageAnnotationsAction | SelectAnnotationAction | DeselectAnnotationAction | SetAnnotationModeAction | UpdateToolDefaultsAction | AddColorPresetAction | CreateAnnotationAction | PatchAnnotationAction | DeleteAnnotationAction | CommitAction | StorePdfIdAction | PurgeAnnotationAction;
-
-declare class AnnotationPlugin extends BasePlugin<AnnotationPluginConfig, AnnotationCapability, AnnotationState, AnnotationAction> {
-    static readonly id: "annotation";
-    private readonly ANNOTATION_HISTORY_TOPIC;
-    private readonly config;
-    private engine;
-    private readonly state$;
-    private readonly interactionManager;
-    private readonly selection;
-    private readonly history;
-    /** Map <subtype> → <modeId>.  Filled once in `initialize()`. */
-    private readonly modeBySubtype;
-    /** The inverse map for quick lookup in onModeChange().          */
-    private readonly subtypeByMode;
-    private readonly modeChange$;
-    private readonly activeTool$;
-    constructor(id: string, registry: PluginRegistry, engine: PdfEngine, config: AnnotationPluginConfig);
-    initialize(): Promise<void>;
-    private registerTool;
-    protected buildCapability(): AnnotationCapability;
-    private createActiveTool;
-    private emitActiveTool;
-    onStoreUpdated(prev: AnnotationState, next: AnnotationState): void;
-    private getAllAnnotations;
-    private getPageAnnotations;
-    private renderAnnotation;
-    private selectAnnotation;
-    private createAnnotation;
-    private updateAnnotation;
-    private deleteAnnotation;
-    private commit;
-}
-
-declare const ANNOTATION_PLUGIN_ID = "annotation";
-declare const manifest: PluginManifest<AnnotationPluginConfig>;
-
-/** All annotations _objects_ on a single page (order preserved). */
-declare const getAnnotationsByPageIndex: (s: AnnotationState, page: number) => TrackedAnnotation[];
-/** Shortcut: every page → list of annotation objects. */
-declare const getAnnotations: (s: AnnotationState) => Record<number, TrackedAnnotation[]>;
-/** The full `TrackedAnnotation` for the current selection. */
-declare const getSelectedAnnotation: (s: AnnotationState) => TrackedAnnotation | null;
-declare const getSelectedAnnotationWithPageIndex: (s: AnnotationState) => SelectedAnnotation | null;
-declare const getSelectedAnnotationByPageIndex: (s: AnnotationState, pageIndex: number) => TrackedAnnotation | null;
-declare const isInAnnotationMode: (s: AnnotationState) => boolean;
-declare const getSelectedAnnotationMode: (s: AnnotationState) => keyof ToolDefaultsBySubtype | null;
-/** Check if a given anno on a page is the current selection. */
-declare const isAnnotationSelected: (s: AnnotationState, page: number, id: number) => boolean;
-
-declare const AnnotationPluginPackage: PluginPackage<AnnotationPlugin, AnnotationPluginConfig, AnnotationState, AnnotationAction>;
-
-export { ANNOTATION_PLUGIN_ID, type ActiveTool, type AnnotationCapability, type AnnotationDefaults, AnnotationPlugin, type AnnotationPluginConfig, AnnotationPluginPackage, type AnnotationState, type BaseAnnotationDefaults, type CommitState, type GetPageAnnotationsOptions, type HighlightDefaults, type InkDefaults, type RenderAnnotationOptions, type SelectedAnnotation, type SquigglyDefaults, type StrikeoutDefaults, type StylableSubtype, type ToolDefaults, type ToolDefaultsBySubtype, type TrackedAnnotation, type UnderlineDefaults, type UpdateAnnotationColorOptions, getAnnotations, getAnnotationsByPageIndex, getSelectedAnnotation, getSelectedAnnotationByPageIndex, getSelectedAnnotationMode, getSelectedAnnotationWithPageIndex, isAnnotationSelected, isInAnnotationMode, manifest };