@embedpdf/plugin-annotation 2.3.0 → 2.4.0

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../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;
@@ -29,11 +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[];
 }
 /**
  * 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, ...props }: AnnotationContainerProps<T>): JSX.Element;
+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/components/annotation-layer.d.ts

@@ -1,5 +1,5 @@
 import { HTMLAttributes, CSSProperties } from '../../react/adapter.ts';
-import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn } 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 */
@@ -20,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, groupSelectionMenu, 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/components/annotations.d.ts

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, BoxedAnnotationRenderer } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -13,6 +13,8 @@ interface AnnotationsProps {
     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/components/types.d.ts

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../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';
@@ -56,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/context/index.d.ts

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

package/dist/shared/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/index.d.ts

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

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { JSX, CSSProperties } from '../../preact/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;
@@ -29,11 +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[];
 }
 /**
  * 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, ...props }: AnnotationContainerProps<T>): JSX.Element;
+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-preact/components/annotation-layer.d.ts

@@ -1,5 +1,5 @@
 import { HTMLAttributes, CSSProperties } from '../../preact/adapter.ts';
-import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn } 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 */
@@ -20,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, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("preact").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("preact").JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, BoxedAnnotationRenderer } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -13,6 +13,8 @@ interface AnnotationsProps {
     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("preact").JSX.Element;
 export {};

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';
@@ -56,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;
@@ -29,11 +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[];
 }
 /**
  * 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, ...props }: AnnotationContainerProps<T>): JSX.Element;
+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, GroupSelectionMenuRenderFn } 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 */
@@ -20,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, groupSelectionMenu, 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.d.ts

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, BoxedAnnotationRenderer } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -13,6 +13,8 @@ interface AnnotationsProps {
     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/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';
@@ -56,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, 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 */
@@ -25,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,4 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
+import { BoxedAnnotationRenderer } from '../context';
 import { AnnotationSelectionMenuProps, AnnotationSelectionMenuRenderFn, GroupSelectionMenuProps, GroupSelectionMenuRenderFn, CustomAnnotationRenderer, ResizeHandleUI, VertexHandleUI } from '../types';
 import { Snippet } from 'svelte';
 interface AnnotationsProps {
@@ -20,6 +21,8 @@ interface AnnotationsProps {
     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/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/index.d.ts

@@ -5,6 +5,7 @@ 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/context/index.d.ts

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

package/dist/svelte/context/renderer-registry.svelte.d.ts

@@ -0,0 +1,20 @@
+import { BoxedAnnotationRenderer, AnnotationRendererEntry, AnnotationRendererProps } from './types';
+import { PdfAnnotationObject } from '@embedpdf/models';
+/**
+ * Annotation Renderer Registry
+ *
+ * Allows external plugins to register custom annotation renderers
+ * that integrate with the annotation layer.
+ */
+export interface AnnotationRendererRegistry {
+    register(entries: BoxedAnnotationRenderer[]): () => void;
+    getAll(): BoxedAnnotationRenderer[];
+}
+export declare function createRendererRegistry(): AnnotationRendererRegistry;
+export declare function provideRendererRegistry(): AnnotationRendererRegistry;
+export declare function getRendererRegistry(): AnnotationRendererRegistry | null;
+/**
+ * Factory to create a boxed renderer from a typed entry.
+ */
+export declare function createRenderer<T extends PdfAnnotationObject>(entry: AnnotationRendererEntry<T>): BoxedAnnotationRenderer;
+export type { AnnotationRendererProps, AnnotationRendererEntry, BoxedAnnotationRenderer };

package/dist/svelte/context/types.d.ts

@@ -0,0 +1,33 @@
+import { Component } from 'svelte';
+import { PdfAnnotationObject } from '@embedpdf/models';
+import { TrackedAnnotation } from '../../lib';
+/**
+ * Props passed to custom annotation renderer components
+ */
+export interface AnnotationRendererProps<T extends PdfAnnotationObject = PdfAnnotationObject> {
+    annotation: TrackedAnnotation<T>;
+    isSelected: boolean;
+    scale: number;
+    pageIndex: number;
+    onClick: (e: PointerEvent | TouchEvent) => void;
+}
+/**
+ * Entry for defining a custom annotation renderer.
+ * Type safety enforced at definition time via generic.
+ */
+export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject> {
+    /** Unique identifier for this renderer */
+    id: string;
+    /** Returns true if this renderer handles the annotation */
+    matches: (annotation: PdfAnnotationObject) => annotation is T;
+    /** Svelte component to render the annotation */
+    component: Component<AnnotationRendererProps<T>>;
+}
+/**
+ * Boxed renderer stored in registry (generic erased for storage)
+ */
+export interface BoxedAnnotationRenderer {
+    id: string;
+    matches: (annotation: PdfAnnotationObject) => boolean;
+    component: Component<AnnotationRendererProps>;
+}