@embedpdf/plugin-annotation 1.0.12 → 1.0.14

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

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

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

@@ -0,0 +1,17 @@
+import { MouseEvent } from '../../../react/adapter.ts';
+import { Rect, Position, PdfAnnotationBorderStyle } from '@embedpdf/models';
+interface PolygonProps {
+    rect: Rect;
+    vertices: Position[];
+    color?: string;
+    strokeColor?: string;
+    opacity?: number;
+    strokeWidth: number;
+    strokeStyle?: PdfAnnotationBorderStyle;
+    strokeDashArray?: number[];
+    scale: number;
+    isSelected: boolean;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
+}
+export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, }: PolygonProps): JSX.Element;
+export {};

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

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

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

@@ -0,0 +1,17 @@
+import { MouseEvent } from '../../../react/adapter.ts';
+import { Rect, Position, LineEndings } from '@embedpdf/models';
+interface PolylineProps {
+    rect: Rect;
+    vertices: Position[];
+    color?: string;
+    strokeColor?: string;
+    opacity?: number;
+    strokeWidth: number;
+    scale: number;
+    isSelected: boolean;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
+    /** Optional start & end endings */
+    lineEndings?: LineEndings;
+}
+export declare function Polyline({ rect, vertices, color, strokeColor, opacity, strokeWidth, scale, isSelected, onClick, lineEndings, }: PolylineProps): JSX.Element;
+export {};

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

@@ -1,7 +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/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/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/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/{resize-ink.d.ts → patch-ink.d.ts}

@@ -1,5 +1,5 @@
-import { PdfAnnotationObject, PdfInkAnnoObject, Rect } from '@embedpdf/models';
-import { ResizeDirection } from './types';
+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.
@@ -13,5 +13,4 @@ import { ResizeDirection } from './types';
  * @param uniform If true, constrains to uniform scaling (uses min scale factor).
  * @returns Partial patch { rect, inkList, strokeWidth } to apply.
  */
-export declare function resizeInkAnnotation(original: PdfAnnotationObject, // Assumes type=INK
-newRect: Rect, direction: ResizeDirection, uniform?: boolean): Partial<PdfInkAnnoObject>;
+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

@@ -1 +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.12",
+  "version": "1.0.14",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -18,24 +18,24 @@
     }
   },
   "dependencies": {
-    "@embedpdf/models": "1.0.12"
+    "@embedpdf/models": "1.0.14"
   },
   "devDependencies": {
     "@types/react": "^18.2.0",
     "typescript": "^5.0.0",
+    "@embedpdf/plugin-selection": "1.0.14",
     "@embedpdf/build": "1.0.0",
-    "@embedpdf/plugin-interaction-manager": "1.0.12",
-    "@embedpdf/plugin-selection": "1.0.12",
-    "@embedpdf/plugin-history": "1.0.12"
+    "@embedpdf/plugin-interaction-manager": "1.0.14",
+    "@embedpdf/plugin-history": "1.0.14"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
     "preact": "^10.26.4",
-    "@embedpdf/core": "1.0.12",
-    "@embedpdf/plugin-interaction-manager": "1.0.12",
-    "@embedpdf/plugin-selection": "1.0.12",
-    "@embedpdf/plugin-history": "1.0.12"
+    "@embedpdf/core": "1.0.14",
+    "@embedpdf/plugin-interaction-manager": "1.0.14",
+    "@embedpdf/plugin-selection": "1.0.14",
+    "@embedpdf/plugin-history": "1.0.14"
   },
   "files": [
     "dist",