@embedpdf/plugin-annotation 2.15.0 → 3.0.0-next.1

package/dist/lib/tools/tools-utils.d.ts

@@ -1,453 +0,0 @@
-import { ToolMapFromList } from './types';
-import { defaultTools } from './default-tools';
-export type ToolMap = ToolMapFromList<typeof defaultTools>;
-/**
- * A factory that creates a type-safe predicate function for a specific tool ID.
- * This is more reliable for TypeScript's type inference than a single generic function.
- */
-export declare function createToolPredicate<K extends keyof ToolMap>(id: K): (tool: {
-    id: string;
-} | undefined) => tool is ToolMap[K];
-export declare const isHighlightTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "highlight";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        textSelection: true;
-        isDraggable: false;
-        isResizable: false;
-        isRotatable: false;
-        isGroupDraggable: false;
-        isGroupResizable: false;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.HIGHLIGHT;
-        strokeColor: string;
-        color: string;
-        opacity: number;
-        blendMode: import("@embedpdf/models").PdfBlendMode.Multiply;
-    };
-};
-export declare const isSquigglyTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "squiggly";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        textSelection: true;
-        isDraggable: false;
-        isResizable: false;
-        isRotatable: false;
-        isGroupDraggable: false;
-        isGroupResizable: false;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.SQUIGGLY;
-        strokeColor: string;
-        color: string;
-        opacity: number;
-        blendMode?: undefined;
-    };
-};
-export declare const isUnderlineTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "underline";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        textSelection: true;
-        isDraggable: false;
-        isResizable: false;
-        isRotatable: false;
-        isGroupDraggable: false;
-        isGroupResizable: false;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.UNDERLINE;
-        strokeColor: string;
-        color: string;
-        opacity: number;
-        blendMode?: undefined;
-    };
-};
-export declare const isStrikeoutTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "strikeout";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        textSelection: true;
-        isDraggable: false;
-        isResizable: false;
-        isRotatable: false;
-        isGroupDraggable: false;
-        isGroupResizable: false;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.STRIKEOUT;
-        strokeColor: string;
-        color: string;
-        opacity: number;
-        blendMode?: undefined;
-    };
-};
-export declare const isInkTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "ink";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 5;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: false;
-        lockGroupAspectRatio?: undefined;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.INK;
-        strokeColor: string;
-        color: string;
-        opacity: number;
-        strokeWidth: number;
-        intent?: undefined;
-        blendMode?: undefined;
-    };
-    behavior: {
-        commitDelay: number;
-        smartLineRecognition?: undefined;
-        smartLineThreshold?: undefined;
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfInkAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfInkAnnoObject, string>;
-};
-export declare const isInkHighlighterTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "inkHighlighter";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 10;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: false;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.INK;
-        intent: string;
-        strokeColor: string;
-        color: string;
-        opacity: number;
-        strokeWidth: number;
-        blendMode: import("@embedpdf/models").PdfBlendMode.Multiply;
-    };
-    behavior: {
-        commitDelay: number;
-        smartLineRecognition: true;
-        smartLineThreshold: number;
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfInkAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfInkAnnoObject, string>;
-};
-export declare const isSquareTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "square";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: false;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.SQUARE;
-        color: string;
-        opacity: number;
-        strokeWidth: number;
-        strokeColor: string;
-        strokeStyle: import("@embedpdf/models").PdfAnnotationBorderStyle.SOLID;
-    };
-    clickBehavior: {
-        enabled: true;
-        defaultSize: {
-            width: number;
-            height: number;
-        };
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfSquareAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfSquareAnnoObject, string>;
-};
-export declare const isCircleTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "circle";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: false;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.CIRCLE;
-        color: string;
-        opacity: number;
-        strokeWidth: number;
-        strokeColor: string;
-        strokeStyle: import("@embedpdf/models").PdfAnnotationBorderStyle.SOLID;
-    };
-    clickBehavior: {
-        enabled: true;
-        defaultSize: {
-            width: number;
-            height: number;
-        };
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfCircleAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfCircleAnnoObject, string>;
-};
-export declare const isLineTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "line";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 5;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: false;
-        lockAspectRatio: false;
-        isGroupResizable: true;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.LINE;
-        color: string;
-        opacity: number;
-        strokeWidth: number;
-        strokeColor: string;
-        intent?: undefined;
-        lineEndings?: undefined;
-    };
-    clickBehavior: {
-        enabled: true;
-        defaultLength: number;
-        defaultAngle: number;
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfLineAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfLineAnnoObject, string>;
-};
-export declare const isPolylineTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "polyline";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: false;
-        lockAspectRatio: false;
-        isGroupResizable: true;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.POLYLINE;
-        color: string;
-        opacity: number;
-        strokeWidth: number;
-        strokeColor: string;
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfPolylineAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfPolylineAnnoObject, string>;
-};
-export declare const isPolygonTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "polygon";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: false;
-        lockAspectRatio: false;
-        isGroupResizable: true;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.POLYGON;
-        color: string;
-        opacity: number;
-        strokeWidth: number;
-        strokeColor: string;
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfPolygonAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfPolygonAnnoObject, string>;
-};
-export declare const isFreeTextTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "freeText";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: false;
-        lockGroupAspectRatio: (a: import('@embedpdf/models').PdfAnnotationObject) => boolean;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.FREETEXT;
-        contents: string;
-        fontSize: number;
-        fontColor: string;
-        fontFamily: import("@embedpdf/models").PdfStandardFont.Helvetica;
-        textAlign: import("@embedpdf/models").PdfTextAlignment.Left;
-        verticalAlign: import("@embedpdf/models").PdfVerticalAlignment.Top;
-        color: string;
-        backgroundColor: string;
-        opacity: number;
-    };
-    clickBehavior: {
-        enabled: true;
-        defaultSize: {
-            width: number;
-            height: number;
-        };
-        defaultContent: string;
-    };
-    behavior: {
-        insertUpright: true;
-        editAfterCreate: true;
-        selectAfterCreate: true;
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfFreeTextAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfFreeTextAnnoObject, string>;
-};
-export declare const isStampTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "stamp";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1;
-    interaction: {
-        exclusive: false;
-        cursor: string;
-        isDraggable: true;
-        isResizable: true;
-        lockAspectRatio: true;
-        lockGroupAspectRatio: true;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.STAMP;
-    };
-    behavior: {
-        insertUpright: true;
-        useAppearanceStream: false;
-    };
-    transform: import('..').PatchFunction<import('@embedpdf/models').PdfStampAnnoObject>;
-    pointerHandler: import('..').HandlerFactory<import('@embedpdf/models').PdfStampAnnoObject, string>;
-};
-export declare const isInsertTextTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "insertText";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 1 | 2;
-    interaction: {
-        exclusive: false;
-        textSelection: true;
-        showSelectionRects: true;
-        isDraggable: false;
-        isResizable: false;
-        isRotatable: false;
-        isGroupDraggable: false;
-        isGroupResizable: false;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.CARET;
-        strokeColor: string;
-        opacity: number;
-        intent: string;
-    };
-    selectionHandler: import('..').SelectionHandlerFactory<import('@embedpdf/models').PdfCaretAnnoObject>;
-};
-export declare const isReplaceTextTool: (tool: {
-    id: string;
-} | undefined) => tool is {
-    id: "replaceText";
-    name: string;
-    labelKey: string;
-    categories: string[];
-    matchScore: (a: import('@embedpdf/models').PdfAnnotationObject) => 0 | 2;
-    interaction: {
-        exclusive: false;
-        textSelection: true;
-        isDraggable: false;
-        isResizable: false;
-        isRotatable: false;
-        isGroupDraggable: false;
-        isGroupResizable: false;
-    };
-    defaults: {
-        type: import("@embedpdf/models").PdfAnnotationSubtype.STRIKEOUT;
-        strokeColor: string;
-        opacity: number;
-        intent: string;
-    };
-    selectionHandler: import('..').SelectionHandlerFactory<import('@embedpdf/models').PdfStrikeOutAnnoObject>;
-};

package/dist/lib/tools/types.d.ts

@@ -1,209 +0,0 @@
-import { PdfAnnotationObject, PdfAnnotationSubtype, Size } from '@embedpdf/models';
-import { HandlerFactory, SelectionHandlerFactory } from '../handlers/types';
-import { PatchFunction } from '../patching/patch-registry';
-/**
- * A dynamic boolean property that can be either a static boolean
- * or a function that receives the annotation and returns a boolean.
- */
-export type DynamicBooleanProp = boolean | ((annotation: PdfAnnotationObject) => boolean);
-/**
- * Resolves a dynamic boolean property to its actual value.
- * @param prop The dynamic property (boolean or function)
- * @param annotation The annotation to pass to the function if prop is a function
- * @param defaultValue The default value if prop is undefined
- */
-export declare function resolveInteractionProp(prop: DynamicBooleanProp | undefined, annotation: PdfAnnotationObject, defaultValue: boolean): boolean;
-/**
- * Specific configuration for Stamp tools.
- */
-export interface StampToolConfig {
-    /** The base64 or URL source for the stamp's image. */
-    imageSrc?: string;
-    imageSize?: Size;
-}
-/**
- * Click behavior for shape annotations (Circle, Square)
- */
-export interface ShapeClickBehavior {
-    /** If true, creates annotation on click with default size */
-    enabled: boolean;
-    /** Default size to use when clicking (PDF units) */
-    defaultSize: Size;
-}
-/**
- * Click behavior for line annotations
- */
-export interface LineClickBehavior {
-    /** If true, creates annotation on click with default length */
-    enabled: boolean;
-    /** Default length of the line */
-    defaultLength: number;
-    /** Default angle in radians (0 = horizontal right) */
-    defaultAngle?: number;
-}
-/**
- * Click behavior for free text annotations
- */
-export interface FreeTextClickBehavior {
-    /** If true, creates annotation on click with default size */
-    enabled: boolean;
-    /** Default size for the text box */
-    defaultSize: Size;
-    /** Optional default content */
-    defaultContent?: string;
-}
-/**
- * A central, extensible map that associates an annotation subtype
- * with its unique tool configuration interface.
- */
-export interface ToolConfigMap {
-    [PdfAnnotationSubtype.STAMP]: StampToolConfig;
-}
-/**
- * Map of annotation subtypes to their click behavior configuration
- */
-export interface ClickBehaviorMap {
-    [PdfAnnotationSubtype.CIRCLE]: ShapeClickBehavior;
-    [PdfAnnotationSubtype.SQUARE]: ShapeClickBehavior;
-    [PdfAnnotationSubtype.LINE]: LineClickBehavior;
-    [PdfAnnotationSubtype.FREETEXT]: FreeTextClickBehavior;
-    [PdfAnnotationSubtype.WIDGET]: ShapeClickBehavior;
-    [PdfAnnotationSubtype.LINK]: ShapeClickBehavior;
-}
-type GetToolConfig<T extends PdfAnnotationObject> = T['type'] extends keyof ToolConfigMap ? ToolConfigMap[T['type']] : {};
-type ClickBehaviorFor<T extends PdfAnnotationObject> = Extract<T['type'], keyof ClickBehaviorMap> extends never ? {} : {
-    clickBehavior?: ClickBehaviorMap[Extract<T['type'], keyof ClickBehaviorMap>];
-};
-/**
- * Map of annotation types that support the insertUpright behavior.
- * Only types with a "natural upright orientation" (readable text, image content)
- * should be listed here.
- */
-export interface InsertUprightBehaviorMap {
-    [PdfAnnotationSubtype.STAMP]: true;
-    [PdfAnnotationSubtype.FREETEXT]: true;
-}
-type InsertUprightBehaviorFor<T extends PdfAnnotationObject> = Extract<T['type'], keyof InsertUprightBehaviorMap> extends never ? {} : {
-    /** Counter-rotate new annotations to appear visually upright on rotated pages. */
-    insertUpright?: boolean;
-};
-/**
- * Ink-specific behavior settings. Only available on tools whose annotation
- * type is PdfAnnotationSubtype.INK (i.e. 'ink' and 'inkHighlighter').
- */
-export interface InkBehavior {
-    /** ms of pointer inactivity before the accumulated strokes are committed. Default: 800. */
-    commitDelay?: number;
-    /** When true, line-like strokes are snapped to a clean 2-point straight line on pointerUp. */
-    smartLineRecognition?: boolean;
-    /**
-     * Maximum allowed perpendicular-deviation ratio (maxDeviation / strokeLength) for a stroke
-     * to qualify as a straight line. Lower = stricter. Default: 0.15.
-     */
-    smartLineThreshold?: number;
-    /**
-     * How many degrees from horizontal or vertical a recognised straight line may deviate
-     * before axis-snapping is skipped. Default: 15.
-     */
-    snapAngleDeg?: number;
-}
-/**
- * Non-distributive conditional: wrapping both sides in [...] prevents TypeScript from
- * distributing over a union. [PdfAnnotationObject] extends [PdfInkAnnoObject] is false
- * (the full union is not a subtype of the specific ink type), so InkBehavior is only added
- * when T is specifically the INK annotation type.
- */
-type InkBehaviorFor<T extends PdfAnnotationObject> = [T] extends [
-    Extract<PdfAnnotationObject, {
-        type: PdfAnnotationSubtype.INK;
-    }>
-] ? InkBehavior : {};
-/**
- * The primary interface for defining an annotation tool.
- * Uses a type alias to properly combine the base interface with conditional properties.
- */
-export type AnnotationTool<T extends PdfAnnotationObject = PdfAnnotationObject, TId extends string = string> = {
-    /** A unique identifier, e.g., 'ink', 'arrow' */
-    id: TId;
-    /** A user-facing name for UI elements, e.g., 'Pen' */
-    name: string;
-    /** Translation key for the tool label, e.g., 'annotation.ink'. Used by the UI for i18n. */
-    labelKey?: string;
-    /** Category tags for authoring mode control, e.g., `['annotation', 'form']`. */
-    categories?: string[];
-    /**
-     * Determines how well this tool matches an existing annotation.
-     * Higher numbers indicate a more specific match.
-     */
-    matchScore: (annotation: PdfAnnotationObject) => number;
-    /**
-     * The defaults combine the base annotation properties (Partial<T>)
-     * with any custom tool configuration (C) found in the ToolConfigMap.
-     */
-    defaults: Partial<T> & GetToolConfig<T>;
-    /** Defines how this tool interacts with the viewer. */
-    interaction: {
-        mode?: string;
-        exclusive: boolean;
-        cursor?: string;
-        /** If true, this interaction mode is activated by selecting text. */
-        textSelection?: boolean;
-        /** Whether to show the native text selection rectangles. Only relevant when textSelection is true. Defaults to false. */
-        showSelectionRects?: boolean;
-        /** Whether this annotation can be dragged when selected individually. Can be dynamic based on annotation. */
-        isDraggable?: DynamicBooleanProp;
-        /** Whether this annotation can be resized when selected individually. Can be dynamic based on annotation. */
-        isResizable?: DynamicBooleanProp;
-        /** Whether this annotation can be rotated when selected individually. Can be dynamic based on annotation. */
-        isRotatable?: DynamicBooleanProp;
-        /** Whether to maintain aspect ratio during resize. Can be dynamic based on annotation. */
-        lockAspectRatio?: DynamicBooleanProp;
-        /** Whether to maintain aspect ratio during group resize. Defaults to lockAspectRatio. Can be dynamic based on annotation. */
-        lockGroupAspectRatio?: DynamicBooleanProp;
-        /** Whether this annotation can be dragged when part of a group. Defaults to isDraggable. Can be dynamic based on annotation. */
-        isGroupDraggable?: DynamicBooleanProp;
-        /** Whether this annotation can be resized when part of a group. Defaults to isResizable. Can be dynamic based on annotation. */
-        isGroupResizable?: DynamicBooleanProp;
-        /** Whether this annotation can be rotated when part of a group. Defaults to isRotatable. Can be dynamic based on annotation. */
-        isGroupRotatable?: DynamicBooleanProp;
-    };
-    /** Tool-specific behavior settings that override plugin defaults */
-    behavior?: {
-        /** When true, deactivate this tool after creating an annotation. Overrides plugin config. */
-        deactivateToolAfterCreate?: boolean;
-        /** When true, select the annotation immediately after creation. Overrides plugin config. */
-        selectAfterCreate?: boolean;
-        /** When true, automatically enter editing mode after creating the annotation. Implies selectAfterCreate. */
-        editAfterCreate?: boolean;
-        /** Override whether this annotation type uses AP rendering before editing (default: true) */
-        useAppearanceStream?: boolean;
-        /** Show a ghost image preview following the cursor. Defaults to false. */
-        showGhost?: boolean;
-    } & InsertUprightBehaviorFor<T> & InkBehaviorFor<T>;
-    /** Pointer-based creation handler (drag-to-create, click-to-place). */
-    pointerHandler?: HandlerFactory<T, TId>;
-    /** Text-selection-based creation handler. */
-    selectionHandler?: SelectionHandlerFactory<T>;
-    /** Transform function for move, resize, rotate, and property-update operations. */
-    transform?: PatchFunction<T>;
-} & ClickBehaviorFor<T>;
-export interface AnnotationToolRecord {
-    id: string;
-    defaults: Record<string, unknown>;
-}
-export type AnnotationToolMap = Record<string, AnnotationToolRecord>;
-export type ToolId<TMap extends AnnotationToolMap> = Extract<keyof TMap, string>;
-export type ToolById<TMap extends AnnotationToolMap, TId extends ToolId<TMap>> = TMap[TId];
-export type ToolMapFromList<TTools extends readonly {
-    id: string;
-}[]> = {
-    [T in TTools[number] as T['id']]: T;
-};
-export type UpsertToolMap<TMap extends AnnotationToolMap, TTool extends AnnotationTool> = Omit<TMap, TTool['id']> & {
-    [K in TTool['id']]: TTool;
-};
-/**
- * Helper to preserve literal IDs and concrete tool typing.
- */
-export declare const defineAnnotationTool: <const TTool extends AnnotationTool<any>>(tool: TTool) => TTool;
-export {};