@embedpdf/plugin-annotation 2.4.1 → 2.6.0

package/dist/svelte/types.d.ts

@@ -39,6 +39,59 @@ export interface VertexHandleUI {
     /** Custom renderer for each vertex (overrides default) */
     component?: Snippet<[HandleProps]>;
 }
+export type BorderStyle = 'solid' | 'dashed' | 'dotted';
+/** Border configuration for the rotation handle */
+export interface RotationHandleBorder {
+    /** Border color (default: '#007ACC') */
+    color?: string;
+    /** Border style (default: 'solid') */
+    style?: BorderStyle;
+    /** Border width in px (default: 1) */
+    width?: number;
+}
+/** Props for the rotation handle component */
+export interface RotationHandleComponentProps extends HandleProps {
+    /** Props for the connector line element */
+    connectorStyle?: string;
+    /** Whether to show the connector line */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Opacity of the handle (0 during active rotation) */
+    opacity?: number;
+    /** Resolved border configuration */
+    border?: RotationHandleBorder;
+}
+/** UI customization for rotation handle */
+export interface RotationHandleUI {
+    /** Handle size in CSS px (default: 32) */
+    size?: number;
+    /** Gap in CSS px between the bounding box edge and the rotation handle center (default: 20) */
+    margin?: number;
+    /** Default background color for the handle (default: 'white') */
+    color?: string;
+    /** Color for the connector line (default: '#007ACC') */
+    connectorColor?: string;
+    /** Whether to show the connector line (default: false) */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Border configuration for the handle */
+    border?: RotationHandleBorder;
+    /** Custom renderer for the rotation handle (overrides default) */
+    component?: Snippet<[RotationHandleComponentProps]>;
+}
+/** Customize the selection outline (color, style, width, offset) */
+export interface SelectionOutline {
+    /** Outline color (default: '#007ACC') */
+    color?: string;
+    /** Outline style (default: 'solid' for single, 'dashed' for group) */
+    style?: BorderStyle;
+    /** Outline width in px (default: 1 for single, 2 for group) */
+    width?: number;
+    /** Outline offset in px (default: 1 for single, 2 for group) */
+    offset?: number;
+}
 /**
  * Props for the custom annotation renderer
  */

package/dist/vue/components/annotation-container.vue.d.ts

@@ -1,8 +1,9 @@
+import { CSSProperties } from 'vue';
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { SelectionMenuPlacement } from '@embedpdf/utils/vue';
 import { TrackedAnnotation } from '../../lib';
 import { VertexConfig } from '../../shared-vue/types';
-import { AnnotationSelectionContext, AnnotationSelectionMenuRenderFn } from '../types';
+import { AnnotationSelectionContext, AnnotationSelectionMenuRenderFn, ResizeHandleUI, VertexHandleUI, RotationHandleUI, SelectionOutline } from '../types';
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: <T extends PdfAnnotationObject>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
@@ -19,43 +20,68 @@ declare const __VLS_export: <T extends PdfAnnotationObject>(__VLS_props: NonNull
         isMultiSelected?: boolean;
         isDraggable: boolean;
         isResizable: boolean;
+        isRotatable?: boolean;
         lockAspectRatio?: boolean;
         vertexConfig?: VertexConfig<T>;
         selectionMenu?: AnnotationSelectionMenuRenderFn;
+        /** @deprecated Use `selectionOutline.offset` instead */
         outlineOffset?: number;
         onDoubleClick?: (event: PointerEvent | MouseEvent) => void;
         onSelect: (event: TouchEvent | MouseEvent) => void;
         zIndex?: number;
+        /** @deprecated Use `selectionOutline.color` instead */
         selectionOutlineColor?: string;
-        style?: Record<string, string | number>;
+        /** Customize the selection outline (color, style, width, offset) */
+        selectionOutline?: SelectionOutline;
+        /** Customize resize handle appearance */
+        resizeUi?: ResizeHandleUI;
+        /** Customize vertex handle appearance */
+        vertexUi?: VertexHandleUI;
+        /** Customize rotation handle appearance */
+        rotationUi?: RotationHandleUI;
+        style?: CSSProperties;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
     attrs: any;
     slots: {
+        'rotation-handle'?: (props: {
+            [key: string]: any;
+            key?: string | number;
+            style: CSSProperties;
+            backgroundColor: string;
+            iconColor: string;
+            connectorStyle: CSSProperties;
+            showConnector: boolean;
+            opacity: number;
+            border: import('..').RotationHandleBorder;
+        } | {
+            [x: string]: never;
+        }) => any;
+    } & {
         default?: (props: {
             annotation: T;
         }) => any;
     } & {
         'resize-handle'?: (props: {
-            backgroundColor: "#007ACC";
+            backgroundColor: string;
             onPointerdown: (e: PointerEvent) => void;
             onPointermove: (e: PointerEvent) => void;
             onPointerup: (e: PointerEvent) => void;
             onPointercancel: (e: PointerEvent) => void;
-            key: string | number;
-            style: import('vue').CSSProperties;
+            key: string | number | undefined;
+            style: CSSProperties;
         }) => any;
     } & {
         'vertex-handle'?: (props: {
-            backgroundColor: "#007ACC";
+            backgroundColor: string;
             onPointerdown: (e: PointerEvent) => void;
             onPointermove: (e: PointerEvent) => void;
             onPointerup: (e: PointerEvent) => void;
             onPointercancel: (e: PointerEvent) => void;
-            key: string | number;
-            style: import('vue').CSSProperties;
+            key: string | number | undefined;
+            style: CSSProperties;
         }) => any;
     } & {
         'selection-menu'?: (props: {
@@ -73,7 +99,7 @@ declare const __VLS_export: <T extends PdfAnnotationObject>(__VLS_props: NonNull
             };
             placement: SelectionMenuPlacement;
             menuWrapperProps: {
-                style: import('vue').CSSProperties;
+                style: CSSProperties;
                 onPointerdown: (e: PointerEvent) => void;
                 onTouchstart: (e: TouchEvent) => void;
             };

package/dist/vue/components/annotation-layer.vue.d.ts

@@ -1,4 +1,4 @@
-import { AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, ResizeHandleUI, VertexHandleUI } from '../types';
+import { AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, ResizeHandleUI, VertexHandleUI, RotationHandleUI, SelectionOutline } from '../types';
 import { BoxedAnnotationRenderer } from '../context';
 type __VLS_Props = {
     /** The ID of the document that this layer displays annotations for */
@@ -7,11 +7,21 @@ type __VLS_Props = {
     scale?: number;
     rotation?: number;
     /** Customize resize handles */
+    resizeUi?: ResizeHandleUI;
+    /** @deprecated Use `resizeUi` (or `:resize-ui` in templates) instead */
     resizeUI?: ResizeHandleUI;
     /** Customize vertex handles */
+    vertexUi?: VertexHandleUI;
+    /** @deprecated Use `vertexUi` (or `:vertex-ui` in templates) instead */
     vertexUI?: VertexHandleUI;
-    /** Customize selection outline color */
+    /** Customize rotation handle */
+    rotationUi?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline` instead */
     selectionOutlineColor?: string;
+    /** Customize the selection outline for individual annotations */
+    selectionOutline?: SelectionOutline;
+    /** Customize the selection outline for the group selection box (falls back to selectionOutline) */
+    groupSelectionOutline?: SelectionOutline;
     /** Customize selection menu */
     selectionMenu?: AnnotationSelectionMenuRenderFn;
     /** Customize group selection menu */
@@ -63,16 +73,28 @@ declare var __VLS_8: {
     onPointermove: (e: PointerEvent) => void;
     onPointerup: (e: PointerEvent) => void;
     onPointercancel: (e: PointerEvent) => void;
-    key: string | number;
+    key: string | number | undefined;
     style: import('vue').CSSProperties;
 }, __VLS_17: {
-    backgroundColor: "#007ACC";
+    backgroundColor: string;
     onPointerdown: (e: PointerEvent) => void;
     onPointermove: (e: PointerEvent) => void;
     onPointerup: (e: PointerEvent) => void;
     onPointercancel: (e: PointerEvent) => void;
-    key: string | number;
+    key: string | number | undefined;
+    style: import('vue').CSSProperties;
+}, __VLS_20: {
+    [key: string]: any;
+    key?: string | number;
     style: import('vue').CSSProperties;
+    backgroundColor: string;
+    iconColor: string;
+    connectorStyle: import('vue').CSSProperties;
+    showConnector: boolean;
+    opacity: number;
+    border: import('..').RotationHandleBorder;
+} | {
+    [x: string]: never;
 };
 type __VLS_Slots = {} & {
     'selection-menu'?: (props: typeof __VLS_8) => any;
@@ -82,6 +104,8 @@ type __VLS_Slots = {} & {
     'resize-handle'?: (props: typeof __VLS_14) => any;
 } & {
     'vertex-handle'?: (props: typeof __VLS_17) => any;
+} & {
+    'rotation-handle'?: (props: typeof __VLS_20) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;