@embedpdf/plugin-annotation 2.9.1 → 2.10.0

package/dist/shared/components/annotation-navigation-handler.d.ts

@@ -0,0 +1 @@
+export declare function AnnotationNavigationHandler(): null;

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

@@ -0,0 +1,3 @@
+import { PdfLinkAnnoObject } from '@embedpdf/models';
+import { AnnotationRendererProps } from '../types';
+export declare function LinkLockedMode({ annotation, documentId, }: AnnotationRendererProps<PdfLinkAnnoObject>): import("react/jsx-runtime").JSX.Element;

package/dist/shared/components/annotations/stamp.d.ts

@@ -7,7 +7,7 @@ interface StampProps {
     documentId: string;
     pageIndex: number;
     scale: number;
-    onClick: (e: MouseEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
 }
 export declare function Stamp({ isSelected, annotation, documentId, pageIndex, scale, onClick, }: StampProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/shared/components/preview-renderer.d.ts

@@ -1,7 +1,8 @@
-import { AnyPreviewState } from '../../index.ts';
+import { PreviewState } from '../../index.ts';
 interface Props {
-    preview: AnyPreviewState;
+    toolId: string;
+    preview: PreviewState;
     scale: number;
 }
-export declare function PreviewRenderer({ preview, scale }: Props): import("react/jsx-runtime").JSX.Element | null;
+export declare function PreviewRenderer({ toolId, preview, scale }: Props): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode, Rect } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../react/utils.ts';
 import { JSX, CSSProperties, MouseEvent } from '../../react/adapter.ts';
@@ -122,7 +122,7 @@ export interface AnnotationRendererProps<T extends PdfAnnotationObject = PdfAnno
     scale: number;
     pageIndex: number;
     documentId: string;
-    onClick: (e: AnnotationInteractionEvent) => void;
+    onClick?: (e: AnnotationInteractionEvent) => void;
     /** When true, AP canvas provides the visual; component should only render hit area */
     appearanceActive: boolean;
 }
@@ -141,13 +141,19 @@ export interface SelectOverrideHelpers {
  * 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> {
+export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject, P = never> {
     /** 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;
+    /** Render a preview during drag-to-create. P is the preview data type. */
+    renderPreview?: (props: {
+        data: P;
+        bounds: Rect;
+        scale: number;
+    }) => JSX.Element;
     /** Vertex configuration for annotations with draggable vertices (line, polyline, polygon) */
     vertexConfig?: VertexConfig<T>;
     /** z-index for the annotation container (default: 1, text markup uses 0) */
@@ -175,6 +181,10 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation<T>, helpers: SelectOverrideHelpers) => void;
     /** Return true to hide the selection menu for this annotation */
     hideSelectionMenu?: (annotation: T) => boolean;
+    /** When true, the annotation is completely hidden when locked (e.g., form widgets defer to the form-filling layer). */
+    hiddenWhenLocked?: boolean;
+    /** Optional locked-mode renderer. When the annotation is locked, this replaces `render` inside the container. */
+    renderLocked?: (props: AnnotationRendererProps<T>) => JSX.Element;
 }
 /**
  * Boxed renderer that encapsulates type safety internally.
@@ -184,6 +194,11 @@ export interface BoxedAnnotationRenderer {
     id: string;
     matches: (annotation: PdfAnnotationObject) => boolean;
     render: (props: AnnotationRendererProps) => JSX.Element;
+    renderPreview?: (props: {
+        data: unknown;
+        bounds: Rect;
+        scale: number;
+    }) => JSX.Element;
     vertexConfig?: VertexConfig<PdfAnnotationObject>;
     zIndex?: number;
     defaultBlendMode?: PdfBlendMode;
@@ -202,9 +217,11 @@ export interface BoxedAnnotationRenderer {
     onDoubleClick?: (annotationId: string, setEditingId: (id: string) => void) => void;
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation, helpers: SelectOverrideHelpers) => void;
     hideSelectionMenu?: (annotation: PdfAnnotationObject) => boolean;
+    hiddenWhenLocked?: boolean;
+    renderLocked?: (props: AnnotationRendererProps) => JSX.Element;
 }
 /**
  * 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;
+export declare function createRenderer<T extends PdfAnnotationObject, P = never>(entry: AnnotationRendererEntry<T, P>): BoxedAnnotationRenderer;

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

@@ -1 +1,2 @@
 export * from './use-annotation';
+export * from './use-ios-zoom-prevention';

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

@@ -5,7 +5,7 @@ export declare const useAnnotationPlugin: () => {
     ready: Promise<void>;
 };
 export declare const useAnnotationCapability: () => {
-    provides: Readonly<import('../../index.ts').AnnotationCapability> | null;
+    provides: Readonly<import('../../index.ts').AnnotationCapability<import('../../index.ts').AnnotationToolMap>> | null;
     isLoading: boolean;
     ready: Promise<void>;
 };
@@ -15,5 +15,5 @@ export declare const useAnnotationCapability: () => {
  */
 export declare const useAnnotation: (documentId: string) => {
     state: AnnotationDocumentState;
-    provides: import('../../index.ts').AnnotationScope | null;
+    provides: import('../../index.ts').AnnotationScope<import('../../index.ts').AnnotationToolMap> | null;
 };

package/dist/shared/hooks/use-ios-zoom-prevention.d.ts

@@ -0,0 +1,16 @@
+import { CSSProperties } from '../../react/adapter.ts';
+/**
+ * Prevents iOS Safari from auto-zooming when a focused input's computed
+ * font-size is below 16px. Returns an adjusted font size and optional
+ * wrapper style that uses `transform: scale()` to visually match the
+ * intended size while keeping the real font at >= 16px.
+ *
+ * @param computedFontPx - The intended on-screen font size (fontSize * scale)
+ * @param active - Whether compensation should apply (e.g. isEditing, or always true for form inputs)
+ */
+export declare function useIOSZoomPrevention(computedFontPx: number, active: boolean): {
+    needsComp: boolean;
+    adjustedFontPx: number;
+    scaleComp: number;
+    wrapperStyle: CSSProperties | undefined;
+};

package/dist/shared-preact/components/annotation-navigation-handler.d.ts

@@ -0,0 +1 @@
+export declare function AnnotationNavigationHandler(): null;

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

@@ -0,0 +1,3 @@
+import { PdfLinkAnnoObject } from '@embedpdf/models';
+import { AnnotationRendererProps } from '../types';
+export declare function LinkLockedMode({ annotation, documentId, }: AnnotationRendererProps<PdfLinkAnnoObject>): import("preact").JSX.Element;

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

@@ -7,7 +7,7 @@ interface StampProps {
     documentId: string;
     pageIndex: number;
     scale: number;
-    onClick: (e: MouseEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
 }
 export declare function Stamp({ isSelected, annotation, documentId, pageIndex, scale, onClick, }: StampProps): import("preact").JSX.Element;
 export {};

package/dist/shared-preact/components/preview-renderer.d.ts

@@ -1,7 +1,8 @@
-import { AnyPreviewState } from '../../lib/index.ts';
+import { PreviewState } from '../../lib/index.ts';
 interface Props {
-    preview: AnyPreviewState;
+    toolId: string;
+    preview: PreviewState;
     scale: number;
 }
-export declare function PreviewRenderer({ preview, scale }: Props): import("preact").JSX.Element | null;
+export declare function PreviewRenderer({ toolId, preview, scale }: Props): import("preact").JSX.Element | null;
 export {};

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

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode, Rect } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../preact/utils.ts';
 import { JSX, CSSProperties, MouseEvent } from '../../preact/adapter.ts';
@@ -122,7 +122,7 @@ export interface AnnotationRendererProps<T extends PdfAnnotationObject = PdfAnno
     scale: number;
     pageIndex: number;
     documentId: string;
-    onClick: (e: AnnotationInteractionEvent) => void;
+    onClick?: (e: AnnotationInteractionEvent) => void;
     /** When true, AP canvas provides the visual; component should only render hit area */
     appearanceActive: boolean;
 }
@@ -141,13 +141,19 @@ export interface SelectOverrideHelpers {
  * 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> {
+export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject, P = never> {
     /** 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;
+    /** Render a preview during drag-to-create. P is the preview data type. */
+    renderPreview?: (props: {
+        data: P;
+        bounds: Rect;
+        scale: number;
+    }) => JSX.Element;
     /** Vertex configuration for annotations with draggable vertices (line, polyline, polygon) */
     vertexConfig?: VertexConfig<T>;
     /** z-index for the annotation container (default: 1, text markup uses 0) */
@@ -175,6 +181,10 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation<T>, helpers: SelectOverrideHelpers) => void;
     /** Return true to hide the selection menu for this annotation */
     hideSelectionMenu?: (annotation: T) => boolean;
+    /** When true, the annotation is completely hidden when locked (e.g., form widgets defer to the form-filling layer). */
+    hiddenWhenLocked?: boolean;
+    /** Optional locked-mode renderer. When the annotation is locked, this replaces `render` inside the container. */
+    renderLocked?: (props: AnnotationRendererProps<T>) => JSX.Element;
 }
 /**
  * Boxed renderer that encapsulates type safety internally.
@@ -184,6 +194,11 @@ export interface BoxedAnnotationRenderer {
     id: string;
     matches: (annotation: PdfAnnotationObject) => boolean;
     render: (props: AnnotationRendererProps) => JSX.Element;
+    renderPreview?: (props: {
+        data: unknown;
+        bounds: Rect;
+        scale: number;
+    }) => JSX.Element;
     vertexConfig?: VertexConfig<PdfAnnotationObject>;
     zIndex?: number;
     defaultBlendMode?: PdfBlendMode;
@@ -202,9 +217,11 @@ export interface BoxedAnnotationRenderer {
     onDoubleClick?: (annotationId: string, setEditingId: (id: string) => void) => void;
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation, helpers: SelectOverrideHelpers) => void;
     hideSelectionMenu?: (annotation: PdfAnnotationObject) => boolean;
+    hiddenWhenLocked?: boolean;
+    renderLocked?: (props: AnnotationRendererProps) => JSX.Element;
 }
 /**
  * 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;
+export declare function createRenderer<T extends PdfAnnotationObject, P = never>(entry: AnnotationRendererEntry<T, P>): BoxedAnnotationRenderer;

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

@@ -1 +1,2 @@
 export * from './use-annotation';
+export * from './use-ios-zoom-prevention';

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

@@ -5,7 +5,7 @@ export declare const useAnnotationPlugin: () => {
     ready: Promise<void>;
 };
 export declare const useAnnotationCapability: () => {
-    provides: Readonly<import('../../lib/index.ts').AnnotationCapability> | null;
+    provides: Readonly<import('../../lib/index.ts').AnnotationCapability<import('../../lib/index.ts').AnnotationToolMap>> | null;
     isLoading: boolean;
     ready: Promise<void>;
 };
@@ -15,5 +15,5 @@ export declare const useAnnotationCapability: () => {
  */
 export declare const useAnnotation: (documentId: string) => {
     state: AnnotationDocumentState;
-    provides: import('../../lib/index.ts').AnnotationScope | null;
+    provides: import('../../lib/index.ts').AnnotationScope<import('../../lib/index.ts').AnnotationToolMap> | null;
 };

package/dist/shared-preact/hooks/use-ios-zoom-prevention.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Prevents iOS Safari from auto-zooming when a focused input's computed
+ * font-size is below 16px. Returns an adjusted font size and optional
+ * wrapper style that uses `transform: scale()` to visually match the
+ * intended size while keeping the real font at >= 16px.
+ *
+ * @param computedFontPx - The intended on-screen font size (fontSize * scale)
+ * @param active - Whether compensation should apply (e.g. isEditing, or always true for form inputs)
+ */
+export declare function useIOSZoomPrevention(computedFontPx: number, active: boolean): {
+    needsComp: boolean;
+    adjustedFontPx: number;
+    scaleComp: number;
+    wrapperStyle: import("preact").JSX.CSSProperties | undefined;
+};

package/dist/shared-react/components/annotation-navigation-handler.d.ts

@@ -0,0 +1 @@
+export declare function AnnotationNavigationHandler(): null;

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

@@ -0,0 +1,3 @@
+import { PdfLinkAnnoObject } from '@embedpdf/models';
+import { AnnotationRendererProps } from '../types';
+export declare function LinkLockedMode({ annotation, documentId, }: AnnotationRendererProps<PdfLinkAnnoObject>): import("react/jsx-runtime").JSX.Element;

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

@@ -7,7 +7,7 @@ interface StampProps {
     documentId: string;
     pageIndex: number;
     scale: number;
-    onClick: (e: MouseEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
 }
 export declare function Stamp({ isSelected, annotation, documentId, pageIndex, scale, onClick, }: StampProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/shared-react/components/preview-renderer.d.ts

@@ -1,7 +1,8 @@
-import { AnyPreviewState } from '../../lib/index.ts';
+import { PreviewState } from '../../lib/index.ts';
 interface Props {
-    preview: AnyPreviewState;
+    toolId: string;
+    preview: PreviewState;
     scale: number;
 }
-export declare function PreviewRenderer({ preview, scale }: Props): import("react/jsx-runtime").JSX.Element | null;
+export declare function PreviewRenderer({ toolId, preview, scale }: Props): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode, Rect } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../react/utils.ts';
 import { JSX, CSSProperties, MouseEvent } from '../../react/adapter.ts';
@@ -122,7 +122,7 @@ export interface AnnotationRendererProps<T extends PdfAnnotationObject = PdfAnno
     scale: number;
     pageIndex: number;
     documentId: string;
-    onClick: (e: AnnotationInteractionEvent) => void;
+    onClick?: (e: AnnotationInteractionEvent) => void;
     /** When true, AP canvas provides the visual; component should only render hit area */
     appearanceActive: boolean;
 }
@@ -141,13 +141,19 @@ export interface SelectOverrideHelpers {
  * 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> {
+export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject, P = never> {
     /** 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;
+    /** Render a preview during drag-to-create. P is the preview data type. */
+    renderPreview?: (props: {
+        data: P;
+        bounds: Rect;
+        scale: number;
+    }) => JSX.Element;
     /** Vertex configuration for annotations with draggable vertices (line, polyline, polygon) */
     vertexConfig?: VertexConfig<T>;
     /** z-index for the annotation container (default: 1, text markup uses 0) */
@@ -175,6 +181,10 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation<T>, helpers: SelectOverrideHelpers) => void;
     /** Return true to hide the selection menu for this annotation */
     hideSelectionMenu?: (annotation: T) => boolean;
+    /** When true, the annotation is completely hidden when locked (e.g., form widgets defer to the form-filling layer). */
+    hiddenWhenLocked?: boolean;
+    /** Optional locked-mode renderer. When the annotation is locked, this replaces `render` inside the container. */
+    renderLocked?: (props: AnnotationRendererProps<T>) => JSX.Element;
 }
 /**
  * Boxed renderer that encapsulates type safety internally.
@@ -184,6 +194,11 @@ export interface BoxedAnnotationRenderer {
     id: string;
     matches: (annotation: PdfAnnotationObject) => boolean;
     render: (props: AnnotationRendererProps) => JSX.Element;
+    renderPreview?: (props: {
+        data: unknown;
+        bounds: Rect;
+        scale: number;
+    }) => JSX.Element;
     vertexConfig?: VertexConfig<PdfAnnotationObject>;
     zIndex?: number;
     defaultBlendMode?: PdfBlendMode;
@@ -202,9 +217,11 @@ export interface BoxedAnnotationRenderer {
     onDoubleClick?: (annotationId: string, setEditingId: (id: string) => void) => void;
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation, helpers: SelectOverrideHelpers) => void;
     hideSelectionMenu?: (annotation: PdfAnnotationObject) => boolean;
+    hiddenWhenLocked?: boolean;
+    renderLocked?: (props: AnnotationRendererProps) => JSX.Element;
 }
 /**
  * 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;
+export declare function createRenderer<T extends PdfAnnotationObject, P = never>(entry: AnnotationRendererEntry<T, P>): BoxedAnnotationRenderer;

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

@@ -1 +1,2 @@
 export * from './use-annotation';
+export * from './use-ios-zoom-prevention';

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

@@ -5,7 +5,7 @@ export declare const useAnnotationPlugin: () => {
     ready: Promise<void>;
 };
 export declare const useAnnotationCapability: () => {
-    provides: Readonly<import('../../lib/index.ts').AnnotationCapability> | null;
+    provides: Readonly<import('../../lib/index.ts').AnnotationCapability<import('../../lib/index.ts').AnnotationToolMap>> | null;
     isLoading: boolean;
     ready: Promise<void>;
 };
@@ -15,5 +15,5 @@ export declare const useAnnotationCapability: () => {
  */
 export declare const useAnnotation: (documentId: string) => {
     state: AnnotationDocumentState;
-    provides: import('../../lib/index.ts').AnnotationScope | null;
+    provides: import('../../lib/index.ts').AnnotationScope<import('../../lib/index.ts').AnnotationToolMap> | null;
 };

package/dist/shared-react/hooks/use-ios-zoom-prevention.d.ts

@@ -0,0 +1,16 @@
+import { CSSProperties } from '../../react/adapter.ts';
+/**
+ * Prevents iOS Safari from auto-zooming when a focused input's computed
+ * font-size is below 16px. Returns an adjusted font size and optional
+ * wrapper style that uses `transform: scale()` to visually match the
+ * intended size while keeping the real font at >= 16px.
+ *
+ * @param computedFontPx - The intended on-screen font size (fontSize * scale)
+ * @param active - Whether compensation should apply (e.g. isEditing, or always true for form inputs)
+ */
+export declare function useIOSZoomPrevention(computedFontPx: number, active: boolean): {
+    needsComp: boolean;
+    adjustedFontPx: number;
+    scaleComp: number;
+    wrapperStyle: CSSProperties | undefined;
+};

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

@@ -0,0 +1,3 @@
+declare const AnnotationNavigationHandler: import('svelte', { with: { "resolution-mode": "import" } }).Component<Record<string, never>, {}, "">;
+type AnnotationNavigationHandler = ReturnType<typeof AnnotationNavigationHandler>;
+export default AnnotationNavigationHandler;

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

@@ -1,6 +1,7 @@
-import { AnyPreviewState } from '../../lib/index.ts';
+import { PreviewState } from '../../lib/index.ts';
 interface PreviewRendererProps {
-    preview: AnyPreviewState;
+    toolId: string;
+    preview: PreviewState;
     scale: number;
 }
 declare const PreviewRenderer: import('svelte', { with: { "resolution-mode": "import" } }).Component<PreviewRendererProps, {}, "">;

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

@@ -0,0 +1,5 @@
+import { PdfLinkAnnoObject } from '@embedpdf/models';
+import { AnnotationRendererProps } from '../../context/types';
+declare const LinkLockedMode: import('svelte', { with: { "resolution-mode": "import" } }).Component<AnnotationRendererProps<PdfLinkAnnoObject>, {}, "">;
+type LinkLockedMode = ReturnType<typeof LinkLockedMode>;
+export default LinkLockedMode;

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

@@ -0,0 +1,10 @@
+import { Rect } from '@embedpdf/models';
+import { LinkPreviewData } from '../../../lib/index.ts';
+interface LinkPreviewProps {
+    data: LinkPreviewData;
+    bounds: Rect;
+    scale: number;
+}
+declare const LinkPreview: import('svelte', { with: { "resolution-mode": "import" } }).Component<LinkPreviewProps, {}, "">;
+type LinkPreview = ReturnType<typeof LinkPreview>;
+export default LinkPreview;

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

@@ -6,7 +6,7 @@ interface StampProps {
     annotation: TrackedAnnotation<PdfStampAnnoObject>;
     pageIndex: number;
     scale: number;
-    onClick: (e: MouseEvent) => void;
+    onClick?: (e: MouseEvent) => void;
 }
 declare const Stamp: import('svelte', { with: { "resolution-mode": "import" } }).Component<StampProps, {}, "">;
 type Stamp = ReturnType<typeof Stamp>;

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

@@ -16,5 +16,5 @@ 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 declare function createRenderer<T extends PdfAnnotationObject, P = never>(entry: AnnotationRendererEntry<T, P>): BoxedAnnotationRenderer;
 export type { AnnotationRendererProps, AnnotationRendererEntry, BoxedAnnotationRenderer, AnnotationInteractionEvent, SelectOverrideHelpers, };

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

@@ -1,5 +1,5 @@
 import { Component } from 'svelte';
-import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode, Rect } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { VertexConfig } from '../../shared-svelte/types';
 /**
@@ -17,7 +17,7 @@ export interface AnnotationRendererProps<T extends PdfAnnotationObject = PdfAnno
     scale: number;
     pageIndex: number;
     documentId: string;
-    onClick: (e: AnnotationInteractionEvent) => void;
+    onClick?: (e: AnnotationInteractionEvent) => void;
     /** When true, AP canvas provides the visual; component should only render hit area */
     appearanceActive: boolean;
 }
@@ -35,7 +35,7 @@ export interface SelectOverrideHelpers {
  * Entry for defining a custom annotation renderer.
  * Type safety enforced at definition time via generic.
  */
-export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject> {
+export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnnotationObject, P = never> {
     /** Unique identifier for this renderer */
     id: string;
     /** Returns true if this renderer handles the annotation */
@@ -69,6 +69,16 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation<T>, helpers: SelectOverrideHelpers) => void;
     /** Return true to hide the selection menu for this annotation */
     hideSelectionMenu?: (annotation: T) => boolean;
+    /** Render a preview during drag-to-create. P is the preview data type. */
+    renderPreview?: Component<{
+        data: P;
+        bounds: Rect;
+        scale: number;
+    }>;
+    /** When true, the annotation is completely hidden when locked (e.g., form widgets defer to the form-filling layer). */
+    hiddenWhenLocked?: boolean;
+    /** Optional locked-mode renderer. When the annotation is locked, this replaces `component` inside the container. */
+    renderLocked?: Component<AnnotationRendererProps<T>>;
 }
 /**
  * Boxed renderer stored in registry (generic erased for storage)
@@ -95,4 +105,11 @@ export interface BoxedAnnotationRenderer {
     onDoubleClick?: (annotationId: string, setEditingId: (id: string) => void) => void;
     selectOverride?: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation, helpers: SelectOverrideHelpers) => void;
     hideSelectionMenu?: (annotation: PdfAnnotationObject) => boolean;
+    renderPreview?: Component<{
+        data: unknown;
+        bounds: Rect;
+        scale: number;
+    }>;
+    hiddenWhenLocked?: boolean;
+    renderLocked?: Component<AnnotationRendererProps>;
 }

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

@@ -1 +1,2 @@
 export * from './use-annotation.svelte';
+export * from './use-ios-zoom-prevention.svelte';

package/dist/svelte/hooks/use-annotation.svelte.d.ts

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

package/dist/svelte/hooks/use-ios-zoom-prevention.svelte.d.ts

@@ -0,0 +1,6 @@
+export declare function useIOSZoomPrevention(getComputedFontPx: () => number, getActive: () => boolean): {
+    readonly needsComp: boolean;
+    readonly adjustedFontPx: number;
+    readonly scaleComp: number;
+    readonly wrapperStyle: string;
+};