@agilehub/vue-pdf-flipbook 1.3.4 → 2.0.0

package/dist/VuePdfFlipbook.vue.d.ts

@@ -1,6 +1,9 @@
+import type { PdfAnnotationToolbarSlotProps, PdfAnnotationEditorSlotProps, PdfAnnotationClickPayload } from './annotationTypes';
 import type { PdfFlipbookProps, PdfPageNavigationSlotProps, PdfThumbnailSlotProps, PdfThumbnailsSlotProps } from './types';
 /** thumbnail 替换单项内容；thumbnails 接管整个列表、位置及交互，优先级更高。 */
 type __VLS_Slots = {
+    'annotation-toolbar'?: (props: PdfAnnotationToolbarSlotProps) => unknown;
+    'annotation-editor'?: (props: PdfAnnotationEditorSlotProps) => unknown;
     'previous-button'?: (props: PdfPageNavigationSlotProps) => unknown;
     'next-button'?: (props: PdfPageNavigationSlotProps) => unknown;
     thumbnail?: (props: PdfThumbnailSlotProps) => unknown;
@@ -9,6 +12,10 @@ type __VLS_Slots = {
 declare const __VLS_base: import("vue").DefineComponent<PdfFlipbookProps, import("./types").PdfFlipbookExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     error: (error: unknown) => any;
     progress: (progress: number) => any;
+    "annotation-change": (change: import("./annotationTypes").PdfAnnotationChange) => any;
+    "annotation-select": (annotation: import("./annotationTypes").PdfAnnotation | null) => any;
+    "annotation-click": (payload: PdfAnnotationClickPayload) => any;
+    "annotation-error": (error: unknown) => any;
     loaded: (payload: {
         pages: number;
     }) => any;
@@ -18,6 +25,10 @@ declare const __VLS_base: import("vue").DefineComponent<PdfFlipbookProps, import
 }, string, import("vue").PublicProps, Readonly<PdfFlipbookProps> & Readonly<{
     onError?: ((error: unknown) => any) | undefined;
     onProgress?: ((progress: number) => any) | undefined;
+    "onAnnotation-change"?: ((change: import("./annotationTypes").PdfAnnotationChange) => any) | undefined;
+    "onAnnotation-select"?: ((annotation: import("./annotationTypes").PdfAnnotation | null) => any) | undefined;
+    "onAnnotation-click"?: ((payload: PdfAnnotationClickPayload) => any) | undefined;
+    "onAnnotation-error"?: ((error: unknown) => any) | undefined;
     onLoaded?: ((payload: {
         pages: number;
     }) => any) | undefined;
@@ -25,10 +36,11 @@ declare const __VLS_base: import("vue").DefineComponent<PdfFlipbookProps, import
     "onMode-change"?: ((mode: import("./types").ReaderMode) => any) | undefined;
     "onState-change"?: ((state: import("./types").PdfFlipbookState) => any) | undefined;
 }>, {
-    initialPage: number;
     height: string | number;
+    initialPage: number;
     background: string;
     workerSrc: string;
+    showAnnotationToolbar: boolean;
     loadingText: string;
     showPreviousButton: boolean;
     showNextButton: boolean;

package/dist/annotationGeometry.d.ts

@@ -0,0 +1,35 @@
+import type { PdfAnnotationGeometry, PdfAnnotationPoint } from './annotationTypes';
+/** PDF.js scale=1 viewport 的最小几何接口；只传尺寸和变换矩阵，不把大型 PDF 页面实例存进标注。 */
+export interface AnnotationViewport {
+    width: number;
+    height: number;
+    transform: number[];
+}
+/**
+ * 把持久化的 PDF 点投影为本页 SVG 点；矩阵已包含旋转、裁剪原点和 userUnit。
+ * @param point 标注中保存的 PDF 用户空间坐标。
+ * @param viewport 当前页由 PDF.js 提供的 scale=1 视口。
+ */
+export declare function projectPoint(point: PdfAnnotationPoint, viewport: AnnotationViewport): PdfAnnotationPoint;
+/**
+ * 将鼠标所在的 SVG 点反投影成可保存的 PDF 坐标；无效矩阵必须拒绝。
+ * @param point 本页 SVG/viewBox 坐标。
+ * @param viewport 与绘制正文时相同的当前页视口。
+ */
+export declare function unprojectPoint(point: PdfAnnotationPoint, viewport: AnnotationViewport): PdfAnnotationPoint;
+/** 将端点投影为页面朝向的包围盒；矩形绘制、拖拽限位和定位都复用这一结果。 */
+export declare function geometryBounds(geometry: PdfAnnotationGeometry, viewport: AnnotationViewport): {
+    start: PdfAnnotationPoint;
+    end: PdfAnnotationPoint;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * 沿直线法线生成波浪线 SVG 路径；首尾仍是原始端点，因此编辑手柄与存储坐标不变。
+ * 限制周期数和采样点数，避免长线或大尺寸 PDF 生成过大的 DOM 路径。
+ */
+export declare function waveLinePath(start: PdfAnnotationPoint, end: PdfAnnotationPoint): string;
+/** 校验外部快照中的标注是否落在当前 PDF 可见区域；错误数据由页面层报告，不静默挪动。 */
+export declare function isGeometryOnPage(geometry: PdfAnnotationGeometry, viewport: AnnotationViewport): boolean;

package/dist/annotationTypes.d.ts

@@ -0,0 +1,163 @@
+/**
+ * 标注业务的数据流：调用方传入完整快照或按页加载器 → 控制器管理内存中的标注 → 每页 SVG 层绘制和交互
+ * → 控制器发送变更 → 调用方自行保存。阅读组件本身不持久化数据。
+ */
+/** read 保留翻页手势并在点击标注时发送 annotation-click；select 用于选中、移动和编辑。 */
+export type PdfAnnotationTool = 'read' | 'select' | 'rect' | 'line' | 'anchor';
+/** PDF 用户空间中的点；不受外部 CSS 缩放、滚动和 DPR 影响。 */
+export interface PdfAnnotationPoint {
+    x: number;
+    y: number;
+}
+/** 锚点记录一个 PDF 坐标；矩形记录两个对角点，直线记录两个端点。 */
+export type PdfAnnotationGeometry = {
+    type: 'anchor';
+    point: PdfAnnotationPoint;
+} | {
+    type: 'rect' | 'line';
+    start: PdfAnnotationPoint;
+    end: PdfAnnotationPoint;
+};
+/** 直线可选线型；矩形边框只允许实线、虚线或无边框。 */
+export type PdfLineStyle = 'solid' | 'dashed' | 'wavy';
+export type PdfRectBorderStyle = 'solid' | 'dashed' | 'none';
+/** 绘制所需的最小标注数据；笔记标题、摘要和正文由调用方独立保存。 */
+export interface PdfAnnotation {
+    /** 单条标注的稳定 ID，更新、删除和跨页定位都使用它。 */
+    id: string;
+    /** PDF 页码从 1 开始，不随单双栏布局变化。 */
+    page: number;
+    geometry: PdfAnnotationGeometry;
+    color: string;
+    /** 旧数据省略时按实线渲染；取值必须与 geometry.type 匹配，锚点不可设置。 */
+    strokeStyle?: PdfLineStyle | PdfRectBorderStyle;
+}
+/** 阅读模式点击已有标注时只返回 ID；详情查询和弹框展示由调用方负责。 */
+export interface PdfAnnotationClickPayload {
+    id: string;
+}
+/** 可 JSON 序列化的快照；只需业务文档 ID 和标注列表。 */
+export interface PdfAnnotationSnapshot {
+    /** 业务文档 ID，由调用方确保每份 PDF 使用正确的数据。 */
+    documentId: string;
+    /** 完整标注列表；调用方负责从数据库或本地存储读取并传入。 */
+    annotations: PdfAnnotation[];
+}
+/** 保存操作类型；撤销新增为 delete，撤销删除为 add，撤销修改仍为 update。 */
+export type PdfAnnotationAction = 'add' | 'update' | 'delete';
+/** 单条保存通知；不包含全量快照和修改前副本，标注数据只取 annotation；不含笔记正文。 */
+export interface PdfAnnotationChange {
+    documentId: string;
+    /** 本次操作的确认标识，重试时保持不变；不要作为笔记字段持久化。 */
+    operationId: string;
+    action: PdfAnnotationAction;
+    /** 新增/修改为提交后的完整单条标注；删除为被删除的标注，可用其 id、page 定位。 */
+    annotation: PdfAnnotation;
+}
+/** 工具栏和 SVG 页面共同读取的状态；items 是内存中的当前值，并非已保存状态。 */
+export interface PdfAnnotationState {
+    readonly tool: PdfAnnotationTool;
+    readonly color: string;
+    /** 下一条直线、矩形的默认样式；不修改已有标注。 */
+    readonly lineStyle: PdfLineStyle;
+    readonly rectBorderStyle: PdfRectBorderStyle;
+    readonly readOnly: boolean;
+    /** 完整快照模式在 hydrate 后为 true；按页模式创建后即为 true，未加载页仍需用 isPageLoaded 判断。 */
+    readonly ready: boolean;
+    readonly selectedId: string | null;
+    /** 当前尚未点击“保存”的新标注 ID；它只用于页面预览，不进入导出快照。 */
+    readonly draftId: string | null;
+    /** 本次草稿使用的绘制工具；弹框保存或取消后用于恢复连续标注。 */
+    readonly draftTool: 'rect' | 'line' | 'anchor' | null;
+    /** 快照模式为全部标注；按页模式仅包含当前缓存页，不能当作整份文档。 */
+    readonly items: readonly PdfAnnotation[];
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    /** 尚未由调用方确认保存成功的操作数。 */
+    readonly pendingCount: number;
+}
+/** 每个控制器对应一个文档会话；按页模式可调用宿主提供的 pageLoader，持久化仍由宿主负责。 */
+export interface PdfAnnotationController {
+    readonly documentId: string;
+    /** true 时只持有已加载页，保存应使用 annotation-change 的增量数据。 */
+    readonly paged: boolean;
+    readonly state: PdfAnnotationState;
+    /**
+     * 初始化或回显完整数据；有未确认操作时拒绝覆盖。无历史标注也应传入空快照。
+     * @param snapshot 调用方从持久化存储读出的当前文档快照。
+     */
+    hydrate(snapshot: PdfAnnotationSnapshot): void;
+    /** 返回完整独立副本；按页模式不能导出整份文档，会抛错。 */
+    exportSnapshot(): PdfAnnotationSnapshot;
+    /** 当前页的标注。按页模式下，未加载页面返回空数组，须结合 isPageLoaded 判断。 */
+    getPageItems(page: number): readonly PdfAnnotation[];
+    /** 标注是否已加载；快照模式在 hydrate 后所有有效页均视为已加载。 */
+    isPageLoaded(page: number): boolean;
+    /** 按页模式请求当前阅读窗口。控制器自动取消离开的请求、限制并发并回收旧页缓存。 */
+    setActivePages(pages: readonly number[]): void;
+    /** 切换阅读、选择或绘制工具；切回阅读会取消选中。 */
+    setTool(tool: PdfAnnotationTool): void;
+    /** 设置后续新标注的颜色，不修改已存在标注。 */
+    setColor(color: string): void;
+    /** 设置后续新直线的线型；修改已有标注应使用 update。 */
+    setLineStyle(style: PdfLineStyle): void;
+    /** 设置后续新矩形的边框；修改已有标注应使用 update。 */
+    setRectBorderStyle(style: PdfRectBorderStyle): void;
+    /** 切换只读；只读时仍可选择、查看，但不能提交编辑。 */
+    setReadOnly(value: boolean): void;
+    /** 选择已有 ID 或传入 null 清除选择。 */
+    select(id: string | null): void;
+    /**
+     * 新增标注并生成 ID；SVG 页层在一次绘制完成后调用。
+     * @param value 页码、PDF 坐标、颜色及可选样式，不需要传 ID。
+     * @returns 供后续编辑和定位使用的标注 ID。
+     */
+    add(value: Omit<PdfAnnotation, 'id'>): string;
+    /** 页面绘制完成后创建临时标注；不会触发变更事件或进入待保存队列。 */
+    addDraft(value: Omit<PdfAnnotation, 'id'>): string;
+    /** 用户点击笔记弹框“保存”后提交草稿，并产生一次仅含绘制数据的新增变更。 */
+    commitDraft(id: string): void;
+    /** 用户取消新标注时静默移除草稿；重复调用不会报错。 */
+    discardDraft(id: string): void;
+    /**
+     * 原子替换颜色、形状或样式；不能修改 ID 和页码。
+     * @param id 目标标注 ID。
+     * @param patch 需要修改的字段，未提供的字段保留原值。
+     */
+    update(id: string, patch: Partial<Pick<PdfAnnotation, 'color' | 'geometry' | 'strokeStyle'>>): void;
+    /** 删除标注；实际持久化仍由调用方处理。 */
+    remove(id: string): void;
+    /** 撤销最近一次编辑；撤销本身也会发送一条待保存变更。 */
+    undo(): void;
+    /** 重做最近一次撤销；重做本身也会发送一条待保存变更。 */
+    redo(): void;
+    /**
+     * 只确认实际保存成功的操作；请求发出后新增的编辑仍留在待保存队列。
+     * @param operationIds 本次已经由调用方持久化成功的操作 ID。
+     */
+    acknowledge(operationIds: readonly string[]): void;
+    /** 按产生顺序返回待保存操作的副本；逐条保存并确认，失败时停止，供下次重试。 */
+    getPendingChanges(): PdfAnnotationChange[];
+    /**
+     * 订阅新增、修改、删除与撤销重做；初始化及保存确认不产生增量事件。
+     * @param listener 每次操作完成后收到独立副本的回调。
+     * @returns 取消订阅函数，阅读组件卸载或切换控制器时会调用。
+     */
+    subscribe(listener: (change: PdfAnnotationChange) => void): () => void;
+    /** 订阅分页标注请求异常；返回值用于组件卸载时解除订阅。 */
+    subscribePageError(listener: (error: unknown, pages: readonly number[]) => void): () => void;
+}
+export interface PdfAnnotationToolbarSlotProps {
+    state: PdfAnnotationState;
+    actions: PdfAnnotationController;
+    /** 页面准备、翻页和归位期间为 false。 */
+    canEdit: boolean;
+}
+export interface PdfAnnotationEditorSlotProps {
+    annotation: PdfAnnotation;
+    readOnly: boolean;
+    /** 外部保存笔记成功后调用，无需传正文/摘要；false 表示提交失败，应保留草稿。 */
+    save: () => boolean;
+    remove: () => void;
+    close: () => void;
+}

package/dist/components/PdfAnnotationControls.vue.d.ts

@@ -0,0 +1,26 @@
+import type { PdfAnnotationController, PdfAnnotationEditorSlotProps, PdfAnnotationToolbarSlotProps } from '../annotationTypes';
+type __VLS_Props = {
+    controller: PdfAnnotationController;
+    showToolbar: boolean;
+    stable: boolean;
+    visiblePages: readonly number[];
+};
+type __VLS_Slots = {
+    toolbar?: (props: PdfAnnotationToolbarSlotProps) => unknown;
+    editor?: (props: PdfAnnotationEditorSlotProps) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    error: (error: unknown) => any;
+    focus: (id: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((error: unknown) => any) | undefined;
+    onFocus?: ((id: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/PdfAnnotationLayer.vue.d.ts

@@ -0,0 +1,29 @@
+import type { PdfAnnotationClickPayload, PdfAnnotationController } from '../annotationTypes';
+import type { AnnotationViewport } from '../annotationGeometry';
+/**
+ * 每个 PDF 页面各有一层 SVG，与页面 Canvas 使用同一个可见区域。
+ * 控制器保存 PDF 原始坐标；这里绘制时投影到当前页，鼠标操作时再反投影回 PDF 坐标。
+ * 因此外部缩放、双栏排版和浏览器 DPR 不会改变标注的存储位置。
+ */
+type __VLS_Props = {
+    controller: PdfAnnotationController;
+    page: number;
+    viewport: AnnotationViewport;
+    /** 页面已准备、当前可见且无翻页/归位时允许交互。 */
+    interactive: boolean;
+    /** 动画中保留进入动画前的静态标记，避免克隆与原页内容不一致。 */
+    frozen: boolean;
+    /** 程序导航即刻取消当前手势，无需等目标页准备完成。 */
+    revision: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (id: string) => any;
+    error: (error: unknown) => any;
+    view: (payload: PdfAnnotationClickPayload) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((id: string) => any) | undefined;
+    onError?: ((error: unknown) => any) | undefined;
+    onView?: ((payload: PdfAnnotationClickPayload) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/PdfCanvasPage.vue.d.ts

@@ -1,4 +1,5 @@
 import type { PDFDocumentProxy } from 'pdfjs-dist';
+import type { AnnotationViewport } from '../annotationGeometry';
 /**
  * 单页 Canvas 的输入属性。正文和缩略图均复用此组件；实际渲染与资源释放交给 usePdfPageCanvas。
  */
@@ -12,7 +13,13 @@ type __VLS_Props = {
     /** Canvas 无障碍名称的前缀，最终会拼接一基页码；默认“PDF 页面”。 */
     ariaLabel?: string;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+/** 页内容插槽与 Canvas 共用 object-fit 内容坐标，正文标注使用；缩略图不创建标注。 */
+type __VLS_Slots = {
+    default?: (props: {
+        viewport: AnnotationViewport;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     rendered: (payload: {
         page: number;
         width: number;
@@ -30,5 +37,11 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     renderScale: number;
     ariaLabel: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/PdfThumbnails.vue.d.ts

@@ -12,11 +12,11 @@ type __VLS_Slots = {
     thumbnail?: (props: PdfThumbnailSlotProps) => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    error: (error: unknown) => any;
     select: (page: number) => any;
+    error: (error: unknown) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onError?: ((error: unknown) => any) | undefined;
     onSelect?: ((page: number) => any) | undefined;
+    onError?: ((error: unknown) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/composables/types.d.ts

@@ -1,10 +1,17 @@
 import type { PdfFlipAnimation, PdfFlipbookProps, PdfFlipbookState, ReaderMode } from '../types';
+import type { PdfAnnotation, PdfAnnotationChange, PdfAnnotationClickPayload } from '../annotationTypes';
 export interface PageSize {
     width: number;
     height: number;
 }
 export type ResolvedFlipbookProps = Readonly<PdfFlipbookProps & Required<Pick<PdfFlipbookProps, 'initialPage' | 'height' | 'background' | 'workerSrc'>>>;
 export type FlipbookEvents = {
+    /** 每次只发送一条带 action 的保存通知，完整加载与按页加载使用相同结构。 */
+    'annotation-change': [change: PdfAnnotationChange];
+    'annotation-select': [annotation: PdfAnnotation | null];
+    /** 阅读模式点击已有标注；由调用方决定如何展示笔记。 */
+    'annotation-click': [payload: PdfAnnotationClickPayload];
+    'annotation-error': [error: unknown];
     loaded: [payload: {
         pages: number;
     }];

package/dist/composables/usePageFlip.d.ts

@@ -15,6 +15,7 @@ interface EngineEvents {
     canStartUserTurn: (forward: boolean, prepare?: boolean) => boolean;
     getLayoutMode: () => ReaderMode;
     isAnimationEnabled: () => boolean;
+    isInputEnabled?: () => boolean;
     onInstantUserTurn: (forward: boolean) => void;
 }
 /**
@@ -28,6 +29,7 @@ export declare function usePageFlip(flipbookElement: Ref<HTMLElement | undefined
     initialize: (pageSize: PageSize, pageCount: number, currentPage: number) => void;
     destroy: () => void;
     syncAnimationMode: () => void;
+    syncInputMode: () => void;
     /** 导航层翻页前调用；无参数，返回引擎实例是否存在。 */
     isReady: () => boolean;
     update: () => void;

package/dist/composables/usePdfFlipbook.d.ts

@@ -1,3 +1,4 @@
+import type { PdfAnnotationController } from '../annotationTypes';
 import type { PdfFlipbookExpose, ReaderMode } from '../types';
 import type { FlipbookEmit, ResolvedFlipbookProps } from './types';
 /**
@@ -8,6 +9,11 @@ import type { FlipbookEmit, ResolvedFlipbookProps } from './types';
  * @returns 模板所需 ref、事件处理方法和公开实例 API。
  */
 export declare function usePdfFlipbook(props: ResolvedFlipbookProps, emit: FlipbookEmit): {
+    annotationController: import("vue").ShallowRef<PdfAnnotationController | undefined, PdfAnnotationController | undefined>;
+    annotationSession: import("vue").Ref<number, number>;
+    annotationStable: import("vue").ComputedRef<boolean>;
+    annotationInteractionRevision: import("vue").Ref<number, number>;
+    onAnnotationTransition: (event: TransitionEvent) => void;
     viewport: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined>;
     bookStage: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined>;
     flipbookElement: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined>;

package/dist/composables/usePdfPageCanvas.d.ts

@@ -1,3 +1,4 @@
+import type { AnnotationViewport } from '../annotationGeometry';
 import type { PDFDocumentProxy } from 'pdfjs-dist';
 interface CanvasOptions {
     pdf: PDFDocumentProxy;
@@ -24,5 +25,6 @@ interface CanvasEvents {
 export declare function usePdfPageCanvas(props: Readonly<CanvasOptions>, events: CanvasEvents): {
     canvas: import("vue").Ref<HTMLCanvasElement | undefined, HTMLCanvasElement | undefined>;
     rendering: import("vue").Ref<boolean, boolean>;
+    pageViewport: import("vue").ShallowRef<AnnotationViewport | undefined, AnnotationViewport | undefined>;
 };
 export {};

package/dist/index.d.ts

@@ -2,6 +2,8 @@ import type { Plugin } from 'vue';
 import VuePdfFlipbook from './VuePdfFlipbook.vue';
 export type { PdfFlipAnimation, PdfFlipbookExpose, PdfFlipbookProps, PdfFlipbookState, PdfPageNavigationSlotProps, PdfThumbnailSlotProps, PdfThumbnailsSlotProps, PdfThumbnailItem, ReaderMode } from './types';
 export { VuePdfFlipbook };
+export { usePdfAnnotations } from './usePdfAnnotations';
+export type { PdfAnnotation, PdfAnnotationGeometry, PdfAnnotationPoint, PdfAnnotationClickPayload, PdfLineStyle, PdfRectBorderStyle, PdfAnnotationSnapshot, PdfAnnotationAction, PdfAnnotationChange, PdfAnnotationController, PdfAnnotationState, PdfAnnotationTool, PdfAnnotationToolbarSlotProps, PdfAnnotationEditorSlotProps } from './annotationTypes';
 export { default as PdfCanvasPage } from './components/PdfCanvasPage.vue';
 declare const plugin: Plugin;
 export default plugin;

package/dist/loadPdfRuntime.d.ts

@@ -1,4 +1,6 @@
 /** PDF.js 现代构建直接调用的浏览器 API；缺失时使用包含 polyfill 的兼容构建。 */
 export declare function needsLegacyPdfRuntime(): boolean;
+/** 兼容构建会补齐主线程 API；固定首次检测结果，避免重载时切换到未补齐的现代 Worker。 */
+export declare function shouldUseLegacyPdfRuntime(): boolean;
 /** 文档解析器和 Worker 从同一个构建导入，避免浏览器能力差异导致版本混用。 */
 export declare function loadPdfRuntime(): Promise<typeof import("./pdfLegacyRuntime")>;