@embedpdf/plugin-annotation 2.2.0 → 2.4.0

package/dist/shared-preact/components/types.d.ts

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../preact/utils.ts';
-import { JSX } from '../../preact/adapter.ts';
+import { JSX, MouseEvent, TouchEvent } from '../../preact/adapter.ts';
 export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
 export interface AnnotationSelectionContext {
     type: 'annotation';
@@ -10,6 +10,13 @@ export interface AnnotationSelectionContext {
 }
 export type AnnotationSelectionMenuProps = SelectionMenuPropsBase<AnnotationSelectionContext>;
 export type AnnotationSelectionMenuRenderFn = SelectionMenuRenderFn<AnnotationSelectionContext>;
+export interface GroupSelectionContext {
+    type: 'group';
+    annotations: TrackedAnnotation[];
+    pageIndex: number;
+}
+export type GroupSelectionMenuProps = SelectionMenuPropsBase<GroupSelectionContext>;
+export type GroupSelectionMenuRenderFn = SelectionMenuRenderFn<GroupSelectionContext>;
 export type HandleProps = HandleElementProps & {
     backgroundColor?: string;
 };
@@ -49,3 +56,45 @@ export interface CustomAnnotationRendererProps<T extends PdfAnnotationObject> {
  * Custom renderer for an annotation
  */
 export type CustomAnnotationRenderer<T extends PdfAnnotationObject> = (props: CustomAnnotationRendererProps<T>) => JSX.Element | null;
+/**
+ * Props for an annotation renderer entry
+ */
+export interface AnnotationRendererProps<T extends PdfAnnotationObject> {
+    annotation: TrackedAnnotation<T>;
+    isSelected: boolean;
+    scale: number;
+    pageIndex: number;
+    onClick: (e: MouseEvent<Element> | TouchEvent<Element>) => void;
+}
+/**
+ * Entry for a custom annotation renderer that handles specific annotation types.
+ * This allows external plugins to provide their own rendering for annotation subtypes.
+ * Used at definition time for type safety.
+ */
+export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject> {
+    /** Unique identifier for this renderer (usually matches tool id) */
+    id: string;
+    /** Returns true if this renderer should handle the annotation */
+    matches: (annotation: PdfAnnotationObject) => annotation is T;
+    /** The component to render the annotation */
+    render: (props: AnnotationRendererProps<T>) => JSX.Element;
+}
+/**
+ * Props passed to tryRender (everything except annotation which is passed separately)
+ */
+export type BoxedRendererProps = Omit<AnnotationRendererProps<PdfAnnotationObject>, 'annotation'>;
+/**
+ * Boxed renderer that encapsulates type safety internally.
+ * The generic is erased - this is what the registry actually stores.
+ */
+export interface BoxedAnnotationRenderer {
+    /** Unique identifier for this renderer */
+    id: string;
+    /** Combined match + render: returns null if doesn't match, JSX.Element if it does */
+    tryRender: (annotation: TrackedAnnotation, props: BoxedRendererProps) => JSX.Element | null;
+}
+/**
+ * Creates a boxed renderer from a typed entry.
+ * Type safety is enforced at definition time, then erased for storage.
+ */
+export declare function createRenderer<T extends PdfAnnotationObject>(entry: AnnotationRendererEntry<T>): BoxedAnnotationRenderer;

package/dist/shared-preact/context/index.d.ts

@@ -0,0 +1 @@
+export * from './renderer-registry';

package/dist/shared-preact/context/renderer-registry.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from '../../preact/adapter.ts';
+import { BoxedAnnotationRenderer } from '../components/types';
+type RegisterFn = (entries: BoxedAnnotationRenderer[]) => () => void;
+export declare function AnnotationRendererProvider({ children }: {
+    children: ReactNode;
+}): import("preact").JSX.Element;
+/**
+ * Hook to register annotation renderers. Handles all registration lifecycle internally.
+ * Plugin authors just call this with their renderers array.
+ */
+export declare function useRegisterRenderers(renderers: BoxedAnnotationRenderer[]): void;
+/**
+ * Hook to get all registered renderers (for rendering components).
+ */
+export declare function useRegisteredRenderers(): BoxedAnnotationRenderer[];
+/**
+ * Low-level hook if someone needs direct access to register function.
+ * Most plugins should use useRegisterRenderers instead.
+ */
+export declare function useRendererRegistry(): RegisterFn | null;
+export {};

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

@@ -1,4 +1,6 @@
 export * from './hooks';
 export * from './components';
 export * from './components/types';
+export * from './context';
 export * from '../lib/index.ts';
+export declare const AnnotationPluginPackage: import('@embedpdf/core').WithAutoMount<import('@embedpdf/core').PluginPackage<import('../lib/index.ts').AnnotationPlugin, import('../lib/index.ts').AnnotationPluginConfig, import('../lib/index.ts').AnnotationState, import('../lib/actions').AnnotationAction>>;

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { JSX, CSSProperties } from '../../react/adapter.ts';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
 import { VertexConfig } from '../types';
 interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     scale: number;
@@ -13,6 +13,8 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     trackedAnnotation: TrackedAnnotation<T>;
     children: JSX.Element | ((annotation: T) => JSX.Element);
     isSelected: boolean;
+    /** Whether multiple annotations are selected (container becomes passive) */
+    isMultiSelected?: boolean;
     isDraggable: boolean;
     isResizable: boolean;
     lockAspectRatio?: boolean;
@@ -27,6 +29,15 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     vertexUI?: VertexHandleUI;
     selectionOutlineColor?: string;
     customAnnotationRenderer?: CustomAnnotationRenderer<T>;
+    /** Passed from parent but not used - destructured to prevent DOM spread */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+    /** Passed from parent but not used - destructured to prevent DOM spread */
+    annotationRenderers?: BoxedAnnotationRenderer[];
 }
-export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationContainerProps<T>): JSX.Element;
+/**
+ * AnnotationContainer wraps individual annotations with interaction handles.
+ * When isMultiSelected is true, the container becomes passive - drag/resize
+ * is handled by the GroupSelectionBox instead.
+ */
+export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isMultiSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { HTMLAttributes, CSSProperties } from '../../react/adapter.ts';
-import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn } from './types';
+import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
 import { PdfAnnotationObject } from '@embedpdf/models';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -9,6 +9,8 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     rotation?: number;
     /** Customize selection menu across all annotations on this layer */
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    /** Customize group selection menu across all annotations on this layer */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     style?: CSSProperties;
     /** Customize resize handles */
     resizeUI?: ResizeHandleUI;
@@ -18,6 +20,8 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     selectionOutlineColor?: string;
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
+    /** Custom renderers for specific annotation types (provided by external plugins) */
+    annotationRenderers?: BoxedAnnotationRenderer[];
 };
-export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -3,8 +3,8 @@ import { PdfInkListObject, Rect } from '@embedpdf/models';
 interface InkProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
-    /** Stroke colour (falls back to PDFium default black) */
-    color?: string;
+    /** Stroke color */
+    strokeColor?: string;
     /** 0 – 1 */
     opacity?: number;
     /** Line width in PDF units */
@@ -21,5 +21,5 @@ interface InkProps {
 /**
  * Renders a PDF Ink annotation (free-hand drawing) as SVG.
  */
-export declare function Ink({ isSelected, color, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
+export declare function Ink({ isSelected, strokeColor, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
 export {};

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

@@ -0,0 +1,28 @@
+import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+interface LinkProps {
+    /** Whether the annotation is selected */
+    isSelected: boolean;
+    /** Stroke colour – defaults to blue when omitted */
+    strokeColor?: string;
+    /** Stroke width in PDF units */
+    strokeWidth?: number;
+    /** Stroke type – defaults to underline when omitted */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array – for dashed style */
+    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> | TouchEvent<SVGElement>) => void;
+    /** Whether this link has an IRT (In Reply To) reference - disables direct interaction */
+    hasIRT?: boolean;
+}
+/**
+ * Renders a PDF Link annotation as SVG.
+ * Supports underline (default), solid, and dashed border styles.
+ */
+export declare function Link({ isSelected, strokeColor, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, hasIRT, }: LinkProps): JSX.Element;
+export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, BoxedAnnotationRenderer } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -8,10 +8,13 @@ interface AnnotationsProps {
     pageWidth: number;
     pageHeight: number;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
     selectionOutlineColor?: string;
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
+    /** Custom renderers for specific annotation types (provided by external plugins) */
+    annotationRenderers?: BoxedAnnotationRenderer[];
 }
 export declare function Annotations(annotationsProps: AnnotationsProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/shared-react/components/group-selection-box.d.ts

@@ -0,0 +1,32 @@
+import { TrackedAnnotation } from '../../lib/index.ts';
+import { ResizeHandleUI, GroupSelectionMenuRenderFn } from './types';
+interface GroupSelectionBoxProps {
+    documentId: string;
+    pageIndex: number;
+    scale: number;
+    rotation: number;
+    pageWidth: number;
+    pageHeight: number;
+    /** All selected annotations on this page */
+    selectedAnnotations: TrackedAnnotation[];
+    /** Whether the group is draggable (all annotations must be group-draggable) */
+    isDraggable: boolean;
+    /** Whether the group is resizable (all annotations must be group-resizable) */
+    isResizable: boolean;
+    /** Resize handle UI customization */
+    resizeUI?: ResizeHandleUI;
+    /** Selection outline color */
+    selectionOutlineColor?: string;
+    /** Outline offset */
+    outlineOffset?: number;
+    /** Z-index for the group box */
+    zIndex?: number;
+    /** Group selection menu render function */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+}
+/**
+ * GroupSelectionBox renders a bounding box around all selected annotations
+ * with drag and resize handles for group manipulation.
+ */
+export declare function GroupSelectionBox({ documentId, pageIndex, scale, rotation, pageWidth, pageHeight, selectedAnnotations, isDraggable, isResizable, resizeUI, selectionOutlineColor, outlineOffset, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
+export {};

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

@@ -1 +1,2 @@
 export * from './annotation-layer';
+export * from './group-selection-box';

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type HighlightProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type HighlightProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Highlight({ color, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("react/jsx-runtime").JSX.Element;
+export declare function Highlight({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type SquigglyProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type SquigglyProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Squiggly({ color, opacity, segmentRects, rect, scale, onClick, style, }: SquigglyProps): import("react/jsx-runtime").JSX.Element;
+export declare function Squiggly({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: SquigglyProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type StrikeoutProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type StrikeoutProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Strikeout({ color, opacity, segmentRects, rect, scale, onClick, style, }: StrikeoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function Strikeout({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: StrikeoutProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type UnderlineProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type UnderlineProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Underline({ color, opacity, segmentRects, rect, scale, onClick, style, }: UnderlineProps): import("react/jsx-runtime").JSX.Element;
+export declare function Underline({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: UnderlineProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../react/utils.ts';
-import { JSX } from '../../react/adapter.ts';
+import { JSX, MouseEvent, TouchEvent } from '../../react/adapter.ts';
 export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
 export interface AnnotationSelectionContext {
     type: 'annotation';
@@ -10,6 +10,13 @@ export interface AnnotationSelectionContext {
 }
 export type AnnotationSelectionMenuProps = SelectionMenuPropsBase<AnnotationSelectionContext>;
 export type AnnotationSelectionMenuRenderFn = SelectionMenuRenderFn<AnnotationSelectionContext>;
+export interface GroupSelectionContext {
+    type: 'group';
+    annotations: TrackedAnnotation[];
+    pageIndex: number;
+}
+export type GroupSelectionMenuProps = SelectionMenuPropsBase<GroupSelectionContext>;
+export type GroupSelectionMenuRenderFn = SelectionMenuRenderFn<GroupSelectionContext>;
 export type HandleProps = HandleElementProps & {
     backgroundColor?: string;
 };
@@ -49,3 +56,45 @@ export interface CustomAnnotationRendererProps<T extends PdfAnnotationObject> {
  * Custom renderer for an annotation
  */
 export type CustomAnnotationRenderer<T extends PdfAnnotationObject> = (props: CustomAnnotationRendererProps<T>) => JSX.Element | null;
+/**
+ * Props for an annotation renderer entry
+ */
+export interface AnnotationRendererProps<T extends PdfAnnotationObject> {
+    annotation: TrackedAnnotation<T>;
+    isSelected: boolean;
+    scale: number;
+    pageIndex: number;
+    onClick: (e: MouseEvent<Element> | TouchEvent<Element>) => void;
+}
+/**
+ * Entry for a custom annotation renderer that handles specific annotation types.
+ * This allows external plugins to provide their own rendering for annotation subtypes.
+ * Used at definition time for type safety.
+ */
+export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject> {
+    /** Unique identifier for this renderer (usually matches tool id) */
+    id: string;
+    /** Returns true if this renderer should handle the annotation */
+    matches: (annotation: PdfAnnotationObject) => annotation is T;
+    /** The component to render the annotation */
+    render: (props: AnnotationRendererProps<T>) => JSX.Element;
+}
+/**
+ * Props passed to tryRender (everything except annotation which is passed separately)
+ */
+export type BoxedRendererProps = Omit<AnnotationRendererProps<PdfAnnotationObject>, 'annotation'>;
+/**
+ * Boxed renderer that encapsulates type safety internally.
+ * The generic is erased - this is what the registry actually stores.
+ */
+export interface BoxedAnnotationRenderer {
+    /** Unique identifier for this renderer */
+    id: string;
+    /** Combined match + render: returns null if doesn't match, JSX.Element if it does */
+    tryRender: (annotation: TrackedAnnotation, props: BoxedRendererProps) => JSX.Element | null;
+}
+/**
+ * Creates a boxed renderer from a typed entry.
+ * Type safety is enforced at definition time, then erased for storage.
+ */
+export declare function createRenderer<T extends PdfAnnotationObject>(entry: AnnotationRendererEntry<T>): BoxedAnnotationRenderer;

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

@@ -0,0 +1 @@
+export * from './renderer-registry';

package/dist/shared-react/context/renderer-registry.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from '../../react/adapter.ts';
+import { BoxedAnnotationRenderer } from '../components/types';
+type RegisterFn = (entries: BoxedAnnotationRenderer[]) => () => void;
+export declare function AnnotationRendererProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to register annotation renderers. Handles all registration lifecycle internally.
+ * Plugin authors just call this with their renderers array.
+ */
+export declare function useRegisterRenderers(renderers: BoxedAnnotationRenderer[]): void;
+/**
+ * Hook to get all registered renderers (for rendering components).
+ */
+export declare function useRegisteredRenderers(): BoxedAnnotationRenderer[];
+/**
+ * Low-level hook if someone needs direct access to register function.
+ * Most plugins should use useRegisterRenderers instead.
+ */
+export declare function useRendererRegistry(): RegisterFn | null;
+export {};

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

@@ -1,4 +1,6 @@
 export * from './hooks';
 export * from './components';
 export * from './components/types';
+export * from './context';
 export * from '../lib/index.ts';
+export declare const AnnotationPluginPackage: import('@embedpdf/core').WithAutoMount<import('@embedpdf/core').PluginPackage<import('../lib/index.ts').AnnotationPlugin, import('../lib/index.ts').AnnotationPluginConfig, import('../lib/index.ts').AnnotationState, import('../lib/actions').AnnotationAction>>;

package/dist/svelte/components/AnnotationLayer.svelte.d.ts

@@ -1,6 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { HTMLAttributes } from 'svelte/elements';
-import { AnnotationSelectionMenuProps, AnnotationSelectionMenuRenderFn, CustomAnnotationRenderer, ResizeHandleUI, VertexHandleUI } from '../types';
+import { AnnotationSelectionMenuProps, AnnotationSelectionMenuRenderFn, GroupSelectionMenuProps, GroupSelectionMenuRenderFn, CustomAnnotationRenderer, ResizeHandleUI, VertexHandleUI } from '../types';
+import { BoxedAnnotationRenderer } from '../context';
 import { Snippet } from 'svelte';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -12,6 +13,10 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     selectionMenu?: AnnotationSelectionMenuRenderFn;
     /** Snippet for custom selection menu (slot-based approach) */
     selectionMenuSnippet?: Snippet<[AnnotationSelectionMenuProps]>;
+    /** Render function for group selection menu (schema-driven approach) */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+    /** Snippet for custom group selection menu (slot-based approach) */
+    groupSelectionMenuSnippet?: Snippet<[GroupSelectionMenuProps]>;
     style?: Record<string, string | number | undefined>;
     /** Customize resize handles */
     resizeUI?: ResizeHandleUI;
@@ -21,6 +26,8 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     selectionOutlineColor?: string;
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
+    /** Custom annotation renderers from props */
+    annotationRenderers?: BoxedAnnotationRenderer[];
 };
 declare const AnnotationLayer: import('svelte', { with: { "resolution-mode": "import" } }).Component<AnnotationLayerProps, {}, "">;
 type AnnotationLayer = ReturnType<typeof AnnotationLayer>;

package/dist/svelte/components/Annotations.svelte.d.ts

@@ -1,5 +1,6 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { AnnotationSelectionMenuProps, AnnotationSelectionMenuRenderFn, CustomAnnotationRenderer, ResizeHandleUI, VertexHandleUI } from '../types';
+import { BoxedAnnotationRenderer } from '../context';
+import { AnnotationSelectionMenuProps, AnnotationSelectionMenuRenderFn, GroupSelectionMenuProps, GroupSelectionMenuRenderFn, CustomAnnotationRenderer, ResizeHandleUI, VertexHandleUI } from '../types';
 import { Snippet } from 'svelte';
 interface AnnotationsProps {
     documentId: string;
@@ -12,10 +13,16 @@ interface AnnotationsProps {
     selectionMenu?: AnnotationSelectionMenuRenderFn;
     /** Snippet for custom selection menu (slot-based approach) */
     selectionMenuSnippet?: Snippet<[AnnotationSelectionMenuProps]>;
+    /** Render function for group selection menu (schema-driven approach) */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+    /** Snippet for custom group selection menu (slot-based approach) */
+    groupSelectionMenuSnippet?: Snippet<[GroupSelectionMenuProps]>;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
     selectionOutlineColor?: string;
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
+    /** Custom annotation renderers from registry/props */
+    annotationRenderers?: BoxedAnnotationRenderer[];
 }
 declare const Annotations: import('svelte', { with: { "resolution-mode": "import" } }).Component<AnnotationsProps, {}, "">;
 type Annotations = ReturnType<typeof Annotations>;

package/dist/svelte/components/GroupSelectionBox.svelte.d.ts

@@ -0,0 +1,32 @@
+import { TrackedAnnotation } from '../../lib/index.ts';
+import { GroupSelectionMenuProps, GroupSelectionMenuRenderFn, ResizeHandleUI } from '../types';
+import { Snippet } from 'svelte';
+interface GroupSelectionBoxProps {
+    documentId: string;
+    pageIndex: number;
+    scale: number;
+    rotation: number;
+    pageWidth: number;
+    pageHeight: number;
+    /** All selected annotations on this page */
+    selectedAnnotations: TrackedAnnotation[];
+    /** Whether the group is draggable (all annotations must be group-draggable) */
+    isDraggable: boolean;
+    /** Whether the group is resizable (all annotations must be group-resizable) */
+    isResizable: boolean;
+    /** Resize handle UI customization */
+    resizeUI?: ResizeHandleUI;
+    /** Selection outline color */
+    selectionOutlineColor?: string;
+    /** Outline offset */
+    outlineOffset?: number;
+    /** Z-index for the group box */
+    zIndex?: number;
+    /** Group selection menu render function */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+    /** Snippet for custom group selection menu (slot-based approach) */
+    groupSelectionMenuSnippet?: Snippet<[GroupSelectionMenuProps]>;
+}
+declare const GroupSelectionBox: import('svelte', { with: { "resolution-mode": "import" } }).Component<GroupSelectionBoxProps, {}, "">;
+type GroupSelectionBox = ReturnType<typeof GroupSelectionBox>;
+export default GroupSelectionBox;

package/dist/svelte/components/RendererRegistryProvider.svelte.d.ts

@@ -0,0 +1,7 @@
+import { Snippet } from 'svelte';
+type $$ComponentProps = {
+    children: Snippet;
+};
+declare const RendererRegistryProvider: import('svelte', { with: { "resolution-mode": "import" } }).Component<$$ComponentProps, {}, "">;
+type RendererRegistryProvider = ReturnType<typeof RendererRegistryProvider>;
+export default RendererRegistryProvider;

package/dist/svelte/components/annotations/Ink.svelte.d.ts

@@ -1,7 +1,8 @@
 import { PdfInkListObject, Rect } from '@embedpdf/models';
 interface InkProps {
     isSelected: boolean;
-    color?: string;
+    /** Stroke color */
+    strokeColor?: string;
     opacity?: number;
     strokeWidth: number;
     inkList: PdfInkListObject[];

package/dist/svelte/components/annotations/Link.svelte.d.ts

@@ -0,0 +1,24 @@
+import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+interface LinkProps {
+    /** Whether the annotation is selected */
+    isSelected: boolean;
+    /** Stroke colour – defaults to blue when omitted */
+    strokeColor?: string;
+    /** Stroke width in PDF units */
+    strokeWidth?: number;
+    /** Stroke type – defaults to underline when omitted */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array – for dashed style */
+    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 | TouchEvent) => void;
+    /** Whether this link has an IRT (In Reply To) reference - disables direct interaction */
+    hasIRT?: boolean;
+}
+declare const Link: import('svelte', { with: { "resolution-mode": "import" } }).Component<LinkProps, {}, "">;
+type Link = ReturnType<typeof Link>;
+export default Link;

package/dist/svelte/components/annotations/index.d.ts

@@ -2,6 +2,7 @@ export { default as Circle } from './Circle.svelte';
 export { default as FreeText } from './FreeText.svelte';
 export { default as Ink } from './Ink.svelte';
 export { default as Line } from './Line.svelte';
+export { default as Link } from './Link.svelte';
 export { default as Polygon } from './Polygon.svelte';
 export { default as Polyline } from './Polyline.svelte';
 export { default as Square } from './Square.svelte';

package/dist/svelte/components/index.d.ts

@@ -2,8 +2,10 @@ export { default as AnnotationContainer } from './AnnotationContainer.svelte';
 export { default as AnnotationLayer } from './AnnotationLayer.svelte';
 export { default as AnnotationPaintLayer } from './AnnotationPaintLayer.svelte';
 export { default as Annotations } from './Annotations.svelte';
+export { default as GroupSelectionBox } from './GroupSelectionBox.svelte';
 export { default as PreviewRenderer } from './PreviewRenderer.svelte';
 export { default as RenderAnnotation } from './RenderAnnotation.svelte';
+export { default as RendererRegistryProvider } from './RendererRegistryProvider.svelte';
 export { default as TextMarkup } from './TextMarkup.svelte';
 export * from './annotations';
 export * from './text-markup';

package/dist/svelte/components/text-markup/Highlight.svelte.d.ts

@@ -1,6 +1,7 @@
 import { Rect } from '@embedpdf/models';
 interface HighlightProps {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;

package/dist/svelte/components/text-markup/Squiggly.svelte.d.ts

@@ -1,6 +1,7 @@
 import { Rect } from '@embedpdf/models';
 interface SquigglyProps {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;

package/dist/svelte/components/text-markup/Strikeout.svelte.d.ts

@@ -1,6 +1,7 @@
 import { Rect } from '@embedpdf/models';
 interface StrikeoutProps {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;