@embedpdf-editor/vue3-chapter-viewer 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { AnnotationCapability } from '@embedpdf/plugin-annotation';
+import { AnnotationTransferItem } from '@embedpdf/plugin-annotation';
 import { BasePlugin } from '@embedpdf/core';
 import { BasePluginConfig } from '@embedpdf/core';
 import { ChapterTreeNode } from '../vue/chapter-tree';
@@ -22,8 +23,23 @@ import { ToolbarSchema } from '@embedpdf/plugin-ui';
 import { UISchema } from '@embedpdf/plugin-ui';
 import { useCapability } from '@embedpdf/core/vue';
 import { usePdfiumEngine } from '@embedpdf/engines/vue';
+import { useRegistry } from '@embedpdf/core/vue';
 
-declare const __VLS_export: DefineComponent<ChapterPdfViewerProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ChapterPdfViewerProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: DefineComponent<ChapterPdfViewerProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ChapterPdfViewerProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+
+declare type __VLS_Slots = {} & {
+    prepend?: (props: typeof __VLS_9) => any;
+} & {
+    default?: (props: typeof __VLS_11) => any;
+};
+
+declare type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
 
 /** 对当前选区应用 PDF 划线/高亮，支持按类型自定义颜色、粗细与偏移 */
 export declare function applySelectionMarkup(documentId: string, kind: SelectionMarkupKind, annotation: AnnotationCapability, selection: SelectionCapability, styles?: MarkupStylesConfig): boolean;
@@ -61,6 +77,37 @@ export declare class CallbackPasswordProvider implements IPasswordProvider {
     resolvePassword(chapter: ChapterDescriptor, attempt: number): Promise<string | null>;
 }
 
+/** 归档文件格式版本 */
+export declare const CHAPTER_ANNOTATIONS_ARCHIVE_VERSION: 1;
+
+/** 全书按 chapterId 分组的归档 */
+export declare interface ChapterAnnotationsArchive {
+    version: typeof CHAPTER_ANNOTATIONS_ARCHIVE_VERSION;
+    exportedAt: string;
+    chapters: Record<string, Omit<ChapterAnnotationsSnapshot, 'chapterId'>>;
+}
+
+export declare function chapterAnnotationsArchiveToJson(archive: ChapterAnnotationsArchive): string;
+
+declare type ChapterAnnotationsContentFlags = {
+    /** 默认 true */
+    bookmarks?: boolean;
+    /** 默认 true */
+    notes?: boolean;
+    /** 默认 true；对应 @embedpdf/plugin-annotation 的 export/import */
+    markup?: boolean;
+};
+
+/** 单章用户标注快照 */
+export declare interface ChapterAnnotationsSnapshot {
+    chapterId: string;
+    bookmarks?: ParagraphBookmark[];
+    notes?: NoteAnchor[];
+    markup?: SerializableAnnotationTransferItem[];
+}
+
+export declare function chapterAnnotationsSnapshotToJson(snapshot: ChapterAnnotationsSnapshot): string;
+
 export declare interface ChapterDescriptor {
     /** 业务唯一 ID；同时复用作 documentManager 的 documentId */
     chapterId: string;
@@ -312,7 +359,7 @@ export declare interface ChapterViewerOptions {
 }
 
 declare interface ChapterViewerZoomConfig {
-    /** 是否启用 pinch/滑块缩放容器，默认 true */
+    /** 是否启用 Ctrl+滚轮 / 双指捏合等交互缩放，默认 true；为 false 时仍可用 pageWidth / initial 设置版面宽度 */
     enabled?: boolean;
     min?: number;
     max?: number;
@@ -398,6 +445,13 @@ export declare const DEFAULT_CHAPTER_VIEWER_CONFIG: ChapterViewerConfig;
 /** 默认全开的功能配置（内部规范化结果） */
 export declare const DEFAULT_CHAPTER_VIEWER_FEATURES: ChapterViewerFeaturesConfig;
 
+export declare function downloadChapterAnnotationsArchive(archive: ChapterAnnotationsArchive, filename?: string): void;
+
+export declare function downloadChapterAnnotationsSnapshot(snapshot: ChapterAnnotationsSnapshot, filename?: string): void;
+
+/** 触发浏览器下载 JSON 文件（仅浏览器环境） */
+export declare function downloadJsonFile(filename: string, json: string): void;
+
 /** 与 snippet 主工具栏 mode tabs 对齐的编辑模式 */
 declare type EditorModeId = 'view' | 'annotate' | 'shapes' | 'insert' | 'form' | 'redact';
 
@@ -406,6 +460,22 @@ declare const editorSecondaryToolbars: Record<string, ToolbarSchema>;
 
 export { EmbedPDF }
 
+/**
+ * 导出 manifest 中全部章节（按 chapterId 存 JSON 对象）。
+ */
+export declare function exportAllChapterAnnotations(registry: PluginRegistry, manifest: ChapterManifest, options?: ExportChapterAnnotationsOptions): Promise<ChapterAnnotationsArchive>;
+
+/**
+ * 导出单章用户标注（书签、笔记、划词划线）。
+ * `chapterId` 与章节 documentId 一致。
+ */
+export declare function exportChapterAnnotations(registry: PluginRegistry, chapterId: string, options?: ExportChapterAnnotationsOptions): Promise<ChapterAnnotationsSnapshot>;
+
+export declare type ExportChapterAnnotationsOptions = ChapterAnnotationsContentFlags & {
+    /** 导出前确保章节 PDF 已加载（划线需要），默认 true */
+    ensureChapterLoaded?: boolean;
+};
+
 declare interface HoverBookmarkUiConfig {
     /** 悬停行末「添加书签」自定义图标；无背景 */
     renderAddIcon?: () => unknown;
@@ -425,6 +495,29 @@ export declare interface IChapterPdfLoader {
     loadPdf(chapter: ChapterDescriptor): Promise<ChapterPdfPayload>;
 }
 
+/**
+ * 导入单章快照。
+ */
+export declare function importChapterAnnotations(registry: PluginRegistry, snapshot: ChapterAnnotationsSnapshot, options?: ImportChapterAnnotationsOptions): Promise<void>;
+
+/**
+ * 导入全书归档（仅处理 archive.chapters 中存在的 chapterId）。
+ */
+export declare function importChapterAnnotationsArchive(registry: PluginRegistry, archive: ChapterAnnotationsArchive, options?: ImportChapterAnnotationsOptions): Promise<void>;
+
+export declare type ImportChapterAnnotationsOptions = ChapterAnnotationsContentFlags & {
+    /**
+     * replace：先清空该章对应数据再写入；
+     * merge：划线/笔记/书签与现有合并（书签按 anchor 去重）。
+     */
+    mode?: 'replace' | 'merge';
+    /** 导入前确保章节已加载，默认 true */
+    ensureChapterLoaded?: boolean;
+    /** 导入完成后回调，便于写入 localStorage / 后端 */
+    persistNotes?: (allNotes: NoteAnchor[]) => void | Promise<void>;
+    persistBookmarks?: (allBookmarks: ParagraphBookmark[]) => void | Promise<void>;
+};
+
 /**
  * 章节加密的抽象接口：当某章节首次或重试加载因密码失败时，
  * `ChapterManagerPlugin` 会向 provider 询问密码。
@@ -628,6 +721,10 @@ declare interface ParagraphBookmarkPluginConfig extends BasePluginConfig {
     hover?: HoverBookmarkUiConfig_2;
 }
 
+export declare function parseChapterAnnotationsArchiveJson(json: string): ChapterAnnotationsArchive;
+
+export declare function parseChapterAnnotationsSnapshotJson(json: string): ChapterAnnotationsSnapshot;
+
 export declare interface PdfChapterEditorBookmarksConfig {
     callbacks: NonNullable<ParagraphBookmarkPluginConfig['callbacks']>;
 }
@@ -667,10 +764,21 @@ declare interface SelectionToolbarExtraAction {
     order?: number;
 }
 
+/** JSON 中可存储的划线（stamp 的 ArrayBuffer 转为 base64） */
+export declare interface SerializableAnnotationTransferItem {
+    annotation: AnnotationTransferItem['annotation'];
+    ctx?: {
+        dataBase64?: string;
+        mimeType?: string;
+    };
+}
+
 export { useCapability }
 
 export { usePdfiumEngine }
 
+export { useRegistry }
+
 /**
  * 一个虚拟页位的解析结果。`localPageIndex` 是 owner 章节 PDF 内的 0-based 索引。
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,QAAQ,EACR,aAAa,GACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,qCAAqC,EACrC,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,EAC/B,aAAa,EACb,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,QAAQ,EACR,aAAa,GACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,gCAAgC,EAChC,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,gBAAgB,EAChB,mCAAmC,EACnC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,GACrC,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,qCAAqC,EACrC,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,EAC/B,aAAa,EACb,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oCAAoC,CAAC"}