@embedpdf/plugin-annotation 2.14.4 → 3.0.0-next.0

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

@@ -1,35 +0,0 @@
-import { MouseEvent } from '../../../preact/adapter.ts';
-import { Rect, LinePoints, LineEndings, PdfAnnotationBorderStyle } from '@embedpdf/models';
-interface LineProps {
-    /** interior colour */
-    color?: string;
-    /** 0 – 1 */
-    opacity?: number;
-    /** Stroke width in PDF units */
-    strokeWidth: number;
-    /** Stroke colour (falls back to PDFium default black) */
-    strokeColor?: string;
-    /** Stroke style */
-    strokeStyle?: PdfAnnotationBorderStyle;
-    /** Stroke dash array */
-    strokeDashArray?: number[];
-    /** Bounding box of the annotation */
-    rect: Rect;
-    /** Line start / end points (page units) */
-    linePoints: LinePoints;
-    /** Line endings (eg. OpenArrow / Butt) */
-    lineEndings?: LineEndings;
-    /** Current page zoom factor */
-    scale: number;
-    /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement>) => void;
-    /** Whether the annotation is selected */
-    isSelected: boolean;
-    /** When true, AP canvas provides the visual; only render hit area */
-    appearanceActive?: boolean;
-}
-/**
- * Renders a PDF Line annotation as SVG (with arrow/butt endings).
- */
-export declare function Line({ color, opacity, strokeWidth, strokeColor, strokeStyle, strokeDashArray, rect, linePoints, lineEndings, scale, onClick, isSelected, appearanceActive, }: LineProps): JSX.Element;
-export {};

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

@@ -1,3 +0,0 @@
-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/link.d.ts

@@ -1,28 +0,0 @@
-import { MouseEvent } from '../../../preact/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>) => 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-preact/components/annotations/polygon.d.ts

@@ -1,23 +0,0 @@
-import { MouseEvent } from '../../../preact/adapter.ts';
-import { Rect, Position, PdfAnnotationBorderStyle } from '@embedpdf/models';
-interface PolygonProps {
-    rect: Rect;
-    vertices: Position[];
-    color?: string;
-    strokeColor?: string;
-    opacity?: number;
-    strokeWidth: number;
-    strokeStyle?: PdfAnnotationBorderStyle;
-    strokeDashArray?: number[];
-    scale: number;
-    isSelected: boolean;
-    onClick?: (e: MouseEvent<SVGElement>) => void;
-    currentVertex?: Position;
-    handleSize?: number;
-    /** When true, AP canvas provides the visual; only render hit area */
-    appearanceActive?: boolean;
-    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
-    cloudyBorderIntensity?: number;
-}
-export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, currentVertex, handleSize, appearanceActive, cloudyBorderIntensity, }: PolygonProps): JSX.Element;
-export {};

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

@@ -1,23 +0,0 @@
-import { MouseEvent } from '../../../preact/adapter.ts';
-import { Rect, Position, LineEndings, PdfAnnotationBorderStyle } from '@embedpdf/models';
-interface PolylineProps {
-    rect: Rect;
-    vertices: Position[];
-    color?: string;
-    strokeColor?: string;
-    opacity?: number;
-    strokeWidth: number;
-    /** Stroke style */
-    strokeStyle?: PdfAnnotationBorderStyle;
-    /** Stroke dash array */
-    strokeDashArray?: number[];
-    scale: number;
-    isSelected: boolean;
-    onClick?: (e: MouseEvent<SVGElement>) => void;
-    /** Optional start & end endings */
-    lineEndings?: LineEndings;
-    /** When true, AP canvas provides the visual; only render hit area */
-    appearanceActive?: boolean;
-}
-export declare function Polyline({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, lineEndings, appearanceActive, }: PolylineProps): JSX.Element;
-export {};

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

@@ -1,35 +0,0 @@
-import { MouseEvent } from '../../../preact/adapter.ts';
-import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
-interface SquareProps {
-    /** Whether the annotation is selected */
-    isSelected: boolean;
-    /** Fill colour – defaults to PDFium's black if omitted */
-    color?: string;
-    /** Stroke colour – defaults to same as fill when omitted */
-    strokeColor?: string;
-    /** 0 – 1 */
-    opacity?: number;
-    /** Stroke width in PDF units */
-    strokeWidth: number;
-    /** Stroke type – defaults to solid when omitted */
-    strokeStyle?: PdfAnnotationBorderStyle;
-    /** Stroke dash array – defaults to undefined when omitted */
-    strokeDashArray?: number[];
-    /** Bounding box of the annotation (PDF units) */
-    rect: Rect;
-    /** Current page zoom factor */
-    scale: number;
-    /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement>) => void;
-    /** When true, AP canvas provides the visual; only render hit area */
-    appearanceActive?: boolean;
-    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
-    cloudyBorderIntensity?: number;
-    /** Rectangle differences – inset from Rect to drawn area */
-    rectangleDifferences?: PdfRectDifferences;
-}
-/**
- * Renders a PDF Square annotation (rectangle) as SVG.
- */
-export declare function Square({ isSelected, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, appearanceActive, cloudyBorderIntensity, rectangleDifferences, }: SquareProps): JSX.Element;
-export {};

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

@@ -1,13 +0,0 @@
-import { MouseEvent } from '../../../preact/adapter.ts';
-import { PdfStampAnnoObject } from '@embedpdf/models';
-import { TrackedAnnotation } from '../../../lib/index.ts';
-interface StampProps {
-    isSelected: boolean;
-    annotation: TrackedAnnotation<PdfStampAnnoObject>;
-    documentId: string;
-    pageIndex: number;
-    scale: number;
-    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/annotations/text.d.ts

@@ -1,14 +0,0 @@
-import { MouseEvent } from '../../../preact/adapter.ts';
-interface TextProps {
-    isSelected: boolean;
-    color?: string;
-    opacity?: number;
-    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
-    appearanceActive?: boolean;
-}
-/**
- * Renders a fallback sticky-note icon for PDF Text annotations when no
- * appearance stream image is available.
- */
-export declare function Text({ isSelected, color, opacity, onClick, appearanceActive, }: TextProps): JSX.Element;
-export {};

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

@@ -1,22 +0,0 @@
-import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, RotationHandleUI, SelectionOutline, BoxedAnnotationRenderer } from './types';
-interface AnnotationsProps {
-    documentId: string;
-    pageIndex: number;
-    scale: number;
-    rotation: number;
-    pageWidth: number;
-    pageHeight: number;
-    selectionMenu?: AnnotationSelectionMenuRenderFn;
-    groupSelectionMenu?: GroupSelectionMenuRenderFn;
-    resizeUI?: ResizeHandleUI;
-    vertexUI?: VertexHandleUI;
-    rotationUI?: RotationHandleUI;
-    selectionOutlineColor?: string;
-    selectionOutline?: SelectionOutline;
-    groupSelectionOutline?: SelectionOutline;
-    customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
-    annotationRenderers?: BoxedAnnotationRenderer[];
-}
-export declare function Annotations(annotationsProps: AnnotationsProps): import("preact").JSX.Element;
-export {};

package/dist/shared-preact/components/appearance-image.d.ts

@@ -1,12 +0,0 @@
-import { AnnotationAppearanceImage } from '@embedpdf/models';
-import { CSSProperties } from '../../preact/adapter.ts';
-interface AppearanceImageProps {
-    appearance: AnnotationAppearanceImage<Blob>;
-    style?: CSSProperties;
-}
-/**
- * Renders a pre-rendered annotation appearance stream image as an img URL.
- * Purely visual -- pointer events are always disabled; hit-area SVG handles interaction.
- */
-export declare function AppearanceImage({ appearance, style }: AppearanceImageProps): import("preact").JSX.Element | null;
-export {};

package/dist/shared-preact/components/built-in-renderers.d.ts

@@ -1,2 +0,0 @@
-import { BoxedAnnotationRenderer } from './types';
-export declare const builtInRenderers: BoxedAnnotationRenderer[];

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

@@ -1,40 +0,0 @@
-import { TrackedAnnotation } from '../../lib/index.ts';
-import { ResizeHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, SelectionOutline } 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;
-    /** Whether the group can be rotated */
-    isRotatable?: boolean;
-    /** Whether to lock aspect ratio during group resize */
-    lockAspectRatio?: boolean;
-    /** Resize handle UI customization */
-    resizeUI?: ResizeHandleUI;
-    /** Rotation handle UI customization */
-    rotationUI?: RotationHandleUI;
-    /** @deprecated Use `selectionOutline.color` instead */
-    selectionOutlineColor?: string;
-    /** @deprecated Use `selectionOutline.offset` instead */
-    outlineOffset?: number;
-    /** Customize the selection outline (color, style, width, offset) */
-    selectionOutline?: SelectionOutline;
-    /** 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, isRotatable, lockAspectRatio, resizeUI, rotationUI, selectionOutlineColor, outlineOffset, selectionOutline, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
-export {};

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

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

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

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

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

@@ -1,13 +0,0 @@
-import { HTMLAttributes, CSSProperties } from '../../preact/adapter.ts';
-import { PdfAnnotationObject } from '@embedpdf/models';
-type RenderAnnotationProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {
-    documentId: string;
-    pageIndex: number;
-    annotation: PdfAnnotationObject;
-    scaleFactor?: number;
-    dpr?: number;
-    style?: CSSProperties;
-    unrotated?: boolean;
-};
-export declare function RenderAnnotation({ documentId, pageIndex, annotation, scaleFactor, unrotated, style, ...props }: RenderAnnotationProps): import("preact").JSX.Element;
-export {};

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

@@ -1,16 +0,0 @@
-import { CSSProperties, MouseEvent } from '../../../preact/adapter.ts';
-import { Rect } from '@embedpdf/models';
-type HighlightProps = {
-    /** Stroke/markup color */
-    strokeColor?: string;
-    opacity?: number;
-    segmentRects: Rect[];
-    rect?: Rect;
-    scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
-    style?: CSSProperties;
-    /** When true, AP image provides the visual; only render hit area */
-    appearanceActive?: boolean;
-};
-export declare function Highlight({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, appearanceActive, }: HighlightProps): import("preact").JSX.Element;
-export {};

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

@@ -1,16 +0,0 @@
-import { CSSProperties, MouseEvent } from '../../../preact/adapter.ts';
-import { Rect } from '@embedpdf/models';
-type SquigglyProps = {
-    /** Stroke/markup color */
-    strokeColor?: string;
-    opacity?: number;
-    segmentRects: Rect[];
-    rect?: Rect;
-    scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
-    style?: CSSProperties;
-    /** When true, AP image provides the visual; only render hit area */
-    appearanceActive?: boolean;
-};
-export declare function Squiggly({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, appearanceActive, }: SquigglyProps): import("preact").JSX.Element;
-export {};

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

@@ -1,16 +0,0 @@
-import { CSSProperties, MouseEvent } from '../../../preact/adapter.ts';
-import { Rect } from '@embedpdf/models';
-type StrikeoutProps = {
-    /** Stroke/markup color */
-    strokeColor?: string;
-    opacity?: number;
-    segmentRects: Rect[];
-    rect?: Rect;
-    scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
-    style?: CSSProperties;
-    /** When true, AP image provides the visual; only render hit area */
-    appearanceActive?: boolean;
-};
-export declare function Strikeout({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, appearanceActive, }: StrikeoutProps): import("preact").JSX.Element;
-export {};

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

@@ -1,16 +0,0 @@
-import { CSSProperties, MouseEvent } from '../../../preact/adapter.ts';
-import { Rect } from '@embedpdf/models';
-type UnderlineProps = {
-    /** Stroke/markup color */
-    strokeColor?: string;
-    opacity?: number;
-    segmentRects: Rect[];
-    rect?: Rect;
-    scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
-    style?: CSSProperties;
-    /** When true, AP image provides the visual; only render hit area */
-    appearanceActive?: boolean;
-};
-export declare function Underline({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, appearanceActive, }: UnderlineProps): import("preact").JSX.Element;
-export {};

package/dist/shared-preact/components/text-markup.d.ts

@@ -1,7 +0,0 @@
-interface TextMarkupProps {
-    documentId: string;
-    pageIndex: number;
-    scale: number;
-}
-export declare function TextMarkup({ documentId, pageIndex, scale }: TextMarkupProps): import("preact").JSX.Element | null;
-export {};

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

@@ -1,253 +0,0 @@
-import { PdfAnnotationObject, PdfBlendMode, Rect } from '@embedpdf/models';
-import { TrackedAnnotation, PreviewState } from '../../lib/index.ts';
-import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../preact/utils.ts';
-import { JSX, CSSProperties, MouseEvent } from '../../preact/adapter.ts';
-import { VertexConfig } from '../types';
-export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
-export interface AnnotationSelectionContext {
-    type: 'annotation';
-    annotation: TrackedAnnotation;
-    pageIndex: number;
-    /**
-     * Derived: PDF `locked` flag is set OR the annotation is non-interactive.
-     * Consumers should disable move/resize/rotate/delete/property-change menu items
-     * when this is true.
-     */
-    structurallyLocked: boolean;
-    /**
-     * Derived: PDF `lockedContents` flag is set OR the annotation is non-interactive.
-     * Consumers should disable content-editing menu items (e.g. FreeText text edit)
-     * when this is true.
-     */
-    contentLocked: boolean;
-}
-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;
-};
-/** UI customization for resize handles */
-export interface ResizeHandleUI {
-    /** Handle size in CSS px (default: 12) */
-    size?: number;
-    /** Default background color for the handle (used by default renderer) */
-    color?: string;
-    /** Custom renderer for each handle (overrides default) */
-    component?: (p: HandleProps) => JSX.Element;
-}
-/** UI customization for vertex handles */
-export interface VertexHandleUI {
-    /** Handle size in CSS px (default: 12) */
-    size?: number;
-    /** Default background color for the handle (used by default renderer) */
-    color?: string;
-    /** Custom renderer for each vertex (overrides default) */
-    component?: (p: HandleProps) => JSX.Element;
-}
-/** Props for the rotation handle component */
-export interface RotationHandleComponentProps extends HandleProps {
-    /** Props for the connector line element */
-    connectorStyle?: CSSProperties;
-    /** Whether to show the connector line */
-    showConnector?: boolean;
-    /** Color for the icon inside the handle (default: '#007ACC') */
-    iconColor?: string;
-    /** Resolved border configuration */
-    border?: RotationHandleBorder;
-}
-export type BorderStyle = 'solid' | 'dashed' | 'dotted';
-export interface SelectionOutline {
-    /** Outline color (default: '#007ACC') */
-    color?: string;
-    /** Outline style (default: 'solid' for single, 'dashed' for group) */
-    style?: BorderStyle;
-    /** Outline width in px (default: 1 for single, 2 for group) */
-    width?: number;
-    /** Outline offset in px (default: 1 for single, 2 for group) */
-    offset?: number;
-}
-/** Border configuration for the rotation handle */
-export interface RotationHandleBorder {
-    /** Border color (default: '#007ACC') */
-    color?: string;
-    /** Border style (default: 'solid') */
-    style?: BorderStyle;
-    /** Border width in px (default: 1) */
-    width?: number;
-}
-/** UI customization for rotation handle */
-export interface RotationHandleUI {
-    /** Handle size in CSS px (default: 16) */
-    size?: number;
-    /** Gap in CSS px between the bounding box edge and the rotation handle center (default: 20) */
-    margin?: number;
-    /** Default background color for the handle (default: 'white') */
-    color?: string;
-    /** Color for the connector line (default: '#007ACC') */
-    connectorColor?: string;
-    /** Whether to show the connector line (default: true) */
-    showConnector?: boolean;
-    /** Color for the icon inside the handle (default: '#007ACC') */
-    iconColor?: string;
-    /** Border configuration for the handle */
-    border?: RotationHandleBorder;
-    /** Custom renderer for the rotation handle (overrides default) */
-    component?: (p: RotationHandleComponentProps) => JSX.Element;
-}
-/**
- * Props for the custom annotation renderer
- */
-export interface CustomAnnotationRendererProps<T extends PdfAnnotationObject> {
-    annotation: T;
-    children: JSX.Element;
-    isSelected: boolean;
-    scale: number;
-    rotation: number;
-    pageWidth: number;
-    pageHeight: number;
-    pageIndex: number;
-    onSelect: (event: any) => void;
-}
-/**
- * Custom renderer for an annotation
- */
-export type CustomAnnotationRenderer<T extends PdfAnnotationObject> = (props: CustomAnnotationRendererProps<T>) => JSX.Element | null;
-/**
- * Properly typed event for annotation interactions (click, select, etc.)
- */
-export type AnnotationInteractionEvent = MouseEvent<Element>;
-/**
- * Props for an annotation renderer entry
- */
-export interface AnnotationRendererProps<T extends PdfAnnotationObject = PdfAnnotationObject> {
-    annotation: TrackedAnnotation<T>;
-    currentObject: T;
-    isSelected: boolean;
-    isEditing: boolean;
-    scale: number;
-    pageIndex: number;
-    documentId: string;
-    onClick?: (e: AnnotationInteractionEvent) => void;
-    /** When true, AP canvas provides the visual; component should only render hit area */
-    appearanceActive: boolean;
-}
-/**
- * Helpers passed to selectOverride for custom selection behavior.
- */
-export interface SelectOverrideHelpers {
-    defaultSelect: (e: AnnotationInteractionEvent, annotation: TrackedAnnotation) => void;
-    selectAnnotation: (pageIndex: number, id: string) => void;
-    clearSelection: () => void;
-    allAnnotations: TrackedAnnotation[];
-    pageIndex: number;
-}
-/**
- * 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, P = never> {
-    /** Unique identifier for this renderer (usually matches tool id) */
-    id: string;
-    /** Returns true if this renderer should handle the annotation. Optional for preview-only renderers. */
-    matches?: (annotation: PdfAnnotationObject) => annotation is T;
-    /** The component to render the annotation. Optional for preview-only renderers. */
-    render?: (props: AnnotationRendererProps<T>) => JSX.Element;
-    /** Returns true if this renderer should handle the given preview state */
-    matchesPreview?: (preview: PreviewState) => boolean;
-    /** Render a preview during drag-to-create. P is the preview data type. */
-    renderPreview?: (props: {
-        data: P;
-        bounds: Rect;
-        scale: number;
-    }) => JSX.Element;
-    /** Extra styles merged onto the preview container div (e.g. mixBlendMode for ink). */
-    previewContainerStyle?: (props: {
-        data: P;
-        bounds: Rect;
-        scale: number;
-    }) => CSSProperties;
-    /** 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) */
-    zIndex?: number;
-    /** Default blend mode for this annotation type (used when annotation.blendMode is not set) */
-    defaultBlendMode?: PdfBlendMode;
-    /** Style applied to the annotation container — overrides the default blend-mode style. */
-    containerStyle?: (annotation: T) => CSSProperties;
-    /** Type-specific interaction fallbacks used when the tool doesn't define a property */
-    interactionDefaults?: {
-        isDraggable?: boolean;
-        isResizable?: boolean;
-        isRotatable?: boolean;
-        lockAspectRatio?: boolean;
-    };
-    /** Whether this annotation type uses AP rendering before editing (default: true) */
-    useAppearanceStream?: boolean;
-    /** Override resolved isDraggable (e.g., FreeText disables drag while editing) */
-    isDraggable?: (toolDraggable: boolean, context: {
-        isEditing: boolean;
-    }) => boolean;
-    /** Handle double-click on the annotation container */
-    onDoubleClick?: (annotationId: string, setEditingId: (id: string) => void) => void;
-    /** Override default selection behavior (e.g., Link IRT parent resolution) */
-    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.
- * The generic is erased -- this is what the registry actually stores.
- */
-export interface BoxedAnnotationRenderer {
-    id: string;
-    matches: (annotation: PdfAnnotationObject) => boolean;
-    render: (props: AnnotationRendererProps) => JSX.Element;
-    matchesPreview?: (preview: PreviewState) => boolean;
-    renderPreview?: (props: {
-        data: unknown;
-        bounds: Rect;
-        scale: number;
-    }) => JSX.Element;
-    previewContainerStyle?: (props: {
-        data: unknown;
-        bounds: Rect;
-        scale: number;
-    }) => CSSProperties;
-    vertexConfig?: VertexConfig<PdfAnnotationObject>;
-    zIndex?: number;
-    defaultBlendMode?: PdfBlendMode;
-    /** Style applied to the annotation container — overrides the default blend-mode style. */
-    containerStyle?: (annotation: PdfAnnotationObject) => CSSProperties;
-    interactionDefaults?: {
-        isDraggable?: boolean;
-        isResizable?: boolean;
-        isRotatable?: boolean;
-        lockAspectRatio?: boolean;
-    };
-    useAppearanceStream?: boolean;
-    isDraggable?: (toolDraggable: boolean, context: {
-        isEditing: boolean;
-    }) => boolean;
-    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, P = never>(entry: AnnotationRendererEntry<T, P>): BoxedAnnotationRenderer;

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

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

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

@@ -1,21 +0,0 @@
-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/hooks/index.d.ts

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