@hyebook/vue3-adapter 2.2.6 → 2.2.7

package/dist/core/src/player/engine.d.ts

@@ -1,25 +1,65 @@
 import type { EbookDoc } from "../types/ebook";
-import type { PlayerDataProvider, ReaderNote, ReaderProgress } from "../types/player";
+import type { ReaderAnnotationChangeSource, ReaderAnnotationCreateEvent, ReaderAnnotationDeleteEvent, ReaderAnnotations, ReaderAnnotationsChangeEvent, ReaderAnnotationUpdateEvent, ReaderHighlight, PlayerDataProvider, PlayerEngineOptions, PlayerFeatures, ReaderNote, ReaderProgress } from "../types/player";
 export interface PlayerState {
     currentPage: number;
     zoom: number;
+    highlights: ReaderHighlight[];
     notes: ReaderNote[];
     progress: ReaderProgress | null;
 }
+type AnnotationCreateListener = (event: ReaderAnnotationCreateEvent) => void;
+type AnnotationUpdateListener = (event: ReaderAnnotationUpdateEvent) => void;
+type AnnotationDeleteListener = (event: ReaderAnnotationDeleteEvent) => void;
+type AnnotationsChangeListener = (event: ReaderAnnotationsChangeEvent) => void;
 export declare class PlayerEngine {
     private provider;
+    private features;
     private doc;
     private state;
-    constructor(provider: PlayerDataProvider);
+    private annotationCreateListeners;
+    private annotationUpdateListeners;
+    private annotationDeleteListeners;
+    private annotationsChangeListeners;
+    constructor(provider: PlayerDataProvider, options?: PlayerEngineOptions);
     load(): Promise<EbookDoc>;
     getDocument(): EbookDoc;
     getState(): PlayerState;
+    getHighlights(): ReaderHighlight[];
+    getNotes(): ReaderNote[];
+    getAnnotations(): ReaderAnnotations;
+    getFeatures(): Required<PlayerFeatures>;
+    isBuiltInNotesModuleEnabled(): boolean;
+    reloadAnnotations(): Promise<ReaderAnnotations>;
+    goToHighlight(highlightId: string): number | null;
+    goToNote(noteId: string): number | null;
     goToPage(index: number): number;
     nextPage(): number;
     prevPage(): number;
     setZoom(zoom: number): number;
     saveProgress(): Promise<void>;
+    createHighlight(highlight: Omit<ReaderHighlight, "id" | "createdAt" | "updatedAt" | "bookId">, source?: ReaderAnnotationChangeSource): Promise<ReaderHighlight>;
+    updateHighlight(highlightId: string, patch: Partial<Omit<ReaderHighlight, "id" | "bookId" | "createdAt">>, source?: ReaderAnnotationChangeSource): Promise<ReaderHighlight | null>;
+    deleteHighlight(highlightId: string, source?: ReaderAnnotationChangeSource): Promise<boolean>;
     addNote(note: Omit<ReaderNote, "id" | "createdAt" | "updatedAt" | "bookId">): Promise<ReaderNote>;
+    createNote(note: Omit<ReaderNote, "id" | "createdAt" | "updatedAt" | "bookId">, source?: ReaderAnnotationChangeSource): Promise<ReaderNote>;
+    updateNote(noteId: string, patch: Partial<Omit<ReaderNote, "id" | "bookId" | "createdAt">>, source?: ReaderAnnotationChangeSource): Promise<ReaderNote | null>;
+    deleteNote(noteId: string, source?: ReaderAnnotationChangeSource): Promise<boolean>;
+    onAnnotationCreate(listener: AnnotationCreateListener): () => void;
+    onAnnotationUpdate(listener: AnnotationUpdateListener): () => void;
+    onAnnotationDelete(listener: AnnotationDeleteListener): () => void;
+    onAnnotationsChange(listener: AnnotationsChangeListener): () => void;
     private restoreUserState;
+    private loadAnnotationsState;
+    private findPageIndexByPageId;
+    private normalizeRange;
+    private normalizeAnnotations;
+    private mapPreviewAnnotationsToReader;
+    private persistAnnotations;
+    private emitAnnotationCreate;
+    private emitAnnotationUpdate;
+    private emitAnnotationDelete;
+    private emitAnnotationsChange;
+    private notifyListeners;
 }
+export {};
 //# sourceMappingURL=engine.d.ts.map

package/dist/core/src/player/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../core/src/player/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,cAAc,EACf,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,KAAK,CAKX;gBAEU,QAAQ,EAAE,kBAAkB;IAIlC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAa/B,WAAW,IAAI,QAAQ;IAOvB,QAAQ,IAAI,WAAW;IAIvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/B,QAAQ,IAAI,MAAM;IAIlB,QAAQ,IAAI,MAAM;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMvB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAc7B,OAAO,CACX,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC,GAClE,OAAO,CAAC,UAAU,CAAC;YAiBR,gBAAgB;CAmB/B"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../core/src/player/engine.ts"],"names":[],"mappings":"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"}

package/dist/core/src/player/engine.js

@@ -1,14 +1,26 @@
 import { assertEbookDoc } from "../utils/validate";
+const DEFAULT_PLAYER_FEATURES = {
+    useBuiltInNotesModule: true,
+};
 export class PlayerEngine {
-    constructor(provider) {
+    constructor(provider, options = {}) {
         this.doc = null;
         this.state = {
             currentPage: 0,
             zoom: 1,
+            highlights: [],
             notes: [],
             progress: null,
         };
+        this.annotationCreateListeners = new Set();
+        this.annotationUpdateListeners = new Set();
+        this.annotationDeleteListeners = new Set();
+        this.annotationsChangeListeners = new Set();
         this.provider = provider;
+        this.features = {
+            useBuiltInNotesModule: options.features?.useBuiltInNotesModule ??
+                DEFAULT_PLAYER_FEATURES.useBuiltInNotesModule,
+        };
     }
     async load() {
         try {
@@ -30,7 +42,48 @@ export class PlayerEngine {
         return JSON.parse(JSON.stringify(this.doc));
     }
     getState() {
-        return JSON.parse(JSON.stringify(this.state));
+        return clone(this.state);
+    }
+    getHighlights() {
+        return clone(this.state.highlights);
+    }
+    getNotes() {
+        return clone(this.state.notes);
+    }
+    getAnnotations() {
+        return {
+            highlights: this.getHighlights(),
+            notes: this.getNotes(),
+        };
+    }
+    getFeatures() {
+        return { ...this.features };
+    }
+    isBuiltInNotesModuleEnabled() {
+        return this.features.useBuiltInNotesModule;
+    }
+    async reloadAnnotations() {
+        if (!this.doc) {
+            throw new Error("Document is not loaded. Call load() first.");
+        }
+        await this.loadAnnotationsState();
+        return this.getAnnotations();
+    }
+    goToHighlight(highlightId) {
+        const target = this.state.highlights.find((item) => item.id === highlightId);
+        if (!target) {
+            return null;
+        }
+        const pageIndex = this.findPageIndexByPageId(target.pageId);
+        return pageIndex >= 0 ? this.goToPage(pageIndex) : null;
+    }
+    goToNote(noteId) {
+        const target = this.state.notes.find((item) => item.id === noteId);
+        if (!target) {
+            return null;
+        }
+        const pageIndex = this.findPageIndexByPageId(target.pageId);
+        return pageIndex >= 0 ? this.goToPage(pageIndex) : null;
     }
     goToPage(index) {
         const doc = this.getDocument();
@@ -62,7 +115,62 @@ export class PlayerEngine {
         this.state.progress = progress;
         await this.provider.saveProgress(progress);
     }
+    async createHighlight(highlight, source = "api") {
+        const doc = this.getDocument();
+        const now = new Date().toISOString();
+        const nextHighlight = {
+            ...highlight,
+            range: this.normalizeRange(highlight.range),
+            id: `highlight-${Date.now()}`,
+            bookId: doc.id,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.state.highlights.push(nextHighlight);
+        await this.persistAnnotations();
+        this.emitAnnotationCreate("highlight", nextHighlight, source);
+        return clone(nextHighlight);
+    }
+    async updateHighlight(highlightId, patch, source = "api") {
+        const index = this.state.highlights.findIndex((item) => item.id === highlightId);
+        if (index < 0) {
+            return null;
+        }
+        const current = this.state.highlights[index];
+        if (!current) {
+            return null;
+        }
+        const nextHighlight = {
+            ...current,
+            ...patch,
+            id: current.id,
+            bookId: current.bookId,
+            createdAt: current.createdAt,
+            updatedAt: new Date().toISOString(),
+            range: patch.range ? this.normalizeRange(patch.range) : current.range,
+        };
+        this.state.highlights[index] = nextHighlight;
+        await this.persistAnnotations();
+        this.emitAnnotationUpdate("highlight", current, nextHighlight, source);
+        return clone(nextHighlight);
+    }
+    async deleteHighlight(highlightId, source = "api") {
+        const index = this.state.highlights.findIndex((item) => item.id === highlightId);
+        if (index < 0) {
+            return false;
+        }
+        const [removedHighlight] = this.state.highlights.splice(index, 1);
+        if (!removedHighlight) {
+            return false;
+        }
+        await this.persistAnnotations();
+        this.emitAnnotationDelete("highlight", removedHighlight, source);
+        return true;
+    }
     async addNote(note) {
+        return this.createNote(note, "api");
+    }
+    async createNote(note, source = "api") {
         const doc = this.getDocument();
         const now = new Date().toISOString();
         const nextNote = {
@@ -73,10 +181,69 @@ export class PlayerEngine {
             updatedAt: now,
         };
         this.state.notes.push(nextNote);
-        if (this.provider.saveNotes) {
-            await this.provider.saveNotes(doc.id, this.state.notes);
+        await this.persistAnnotations();
+        this.emitAnnotationCreate("note", nextNote, source);
+        return clone(nextNote);
+    }
+    async updateNote(noteId, patch, source = "api") {
+        const index = this.state.notes.findIndex((item) => item.id === noteId);
+        if (index < 0) {
+            return null;
+        }
+        const current = this.state.notes[index];
+        if (!current) {
+            return null;
+        }
+        const nextNote = {
+            ...current,
+            ...patch,
+            id: current.id,
+            bookId: current.bookId,
+            createdAt: current.createdAt,
+            updatedAt: new Date().toISOString(),
+            ...(patch.range ? { range: this.normalizeRange(patch.range) } : {}),
+        };
+        this.state.notes[index] = nextNote;
+        await this.persistAnnotations();
+        this.emitAnnotationUpdate("note", current, nextNote, source);
+        return clone(nextNote);
+    }
+    async deleteNote(noteId, source = "api") {
+        const index = this.state.notes.findIndex((item) => item.id === noteId);
+        if (index < 0) {
+            return false;
         }
-        return nextNote;
+        const [removedNote] = this.state.notes.splice(index, 1);
+        if (!removedNote) {
+            return false;
+        }
+        await this.persistAnnotations();
+        this.emitAnnotationDelete("note", removedNote, source);
+        return true;
+    }
+    onAnnotationCreate(listener) {
+        this.annotationCreateListeners.add(listener);
+        return () => {
+            this.annotationCreateListeners.delete(listener);
+        };
+    }
+    onAnnotationUpdate(listener) {
+        this.annotationUpdateListeners.add(listener);
+        return () => {
+            this.annotationUpdateListeners.delete(listener);
+        };
+    }
+    onAnnotationDelete(listener) {
+        this.annotationDeleteListeners.add(listener);
+        return () => {
+            this.annotationDeleteListeners.delete(listener);
+        };
+    }
+    onAnnotationsChange(listener) {
+        this.annotationsChangeListeners.add(listener);
+        return () => {
+            this.annotationsChangeListeners.delete(listener);
+        };
     }
     async restoreUserState() {
         if (!this.doc) {
@@ -90,10 +257,170 @@ export class PlayerEngine {
                 this.state.zoom = progress.zoom;
             }
         }
-        if (this.provider.loadNotes) {
-            const notes = await this.provider.loadNotes(this.doc.id);
-            this.state.notes = notes;
+        await this.loadAnnotationsState();
+    }
+    async loadAnnotationsState() {
+        if (!this.doc) {
+            return;
         }
+        let restoredFromAnnotationsProvider = false;
+        if (this.provider.loadAnnotations) {
+            const annotations = await this.provider.loadAnnotations(this.doc.id);
+            if (annotations) {
+                const normalized = this.normalizeAnnotations(annotations);
+                this.state.highlights = normalized.highlights;
+                this.state.notes = normalized.notes;
+                restoredFromAnnotationsProvider = true;
+            }
+        }
+        if (!restoredFromAnnotationsProvider) {
+            const fromDocument = this.mapPreviewAnnotationsToReader(this.doc.meta.previewAnnotations, this.doc.id);
+            this.state.highlights = fromDocument.highlights;
+            this.state.notes = fromDocument.notes;
+            if (this.provider.loadNotes) {
+                const notes = await this.provider.loadNotes(this.doc.id);
+                this.state.notes = Array.isArray(notes) ? clone(notes) : [];
+            }
+        }
+    }
+    findPageIndexByPageId(pageId) {
+        if (!this.doc) {
+            return -1;
+        }
+        return this.doc.pages.findIndex((page) => page.id === pageId);
+    }
+    normalizeRange(range) {
+        const safeStart = Math.max(0, Math.floor(range.start || 0));
+        const safeEnd = Math.max(0, Math.floor(range.end || 0));
+        return safeStart <= safeEnd
+            ? { start: safeStart, end: safeEnd }
+            : { start: safeEnd, end: safeStart };
+    }
+    normalizeAnnotations(annotations) {
+        const highlights = Array.isArray(annotations?.highlights)
+            ? clone(annotations.highlights)
+            : [];
+        const notes = Array.isArray(annotations?.notes)
+            ? clone(annotations.notes)
+            : [];
+        return { highlights, notes };
+    }
+    mapPreviewAnnotationsToReader(annotations, bookId) {
+        const now = new Date().toISOString();
+        const safe = annotations || { highlights: [], notes: [] };
+        const highlights = safe.highlights.map((item, index) => {
+            const range = this.normalizeRange({ start: item.start, end: item.end });
+            return {
+                id: item.id || `highlight-preview-${index}`,
+                bookId,
+                pageId: item.pageId,
+                blockId: item.blockId || "preview-flow-text",
+                range,
+                ...(item.selectedText !== undefined
+                    ? { selectedText: item.selectedText }
+                    : {}),
+                ...(item.color !== undefined ? { color: item.color } : {}),
+                createdAt: item.createdAt || now,
+                updatedAt: item.updatedAt || item.createdAt || now,
+            };
+        });
+        const notes = safe.notes.map((item, index) => {
+            const range = this.normalizeRange({ start: item.start, end: item.end });
+            return {
+                id: item.id || `note-preview-${index}`,
+                bookId,
+                pageId: item.pageId,
+                blockId: "preview-flow-text",
+                range,
+                content: item.text,
+                ...(item.color !== undefined ? { color: item.color } : {}),
+                createdAt: item.createdAt || now,
+                updatedAt: item.updatedAt || item.createdAt || now,
+            };
+        });
+        return {
+            highlights,
+            notes,
+        };
+    }
+    async persistAnnotations() {
+        if (!this.doc) {
+            return;
+        }
+        const all = this.getAnnotations();
+        if (this.provider.saveAnnotations) {
+            await this.provider.saveAnnotations(this.doc.id, all);
+            return;
+        }
+        if (this.provider.saveNotes) {
+            await this.provider.saveNotes(this.doc.id, all.notes);
+        }
+    }
+    emitAnnotationCreate(kind, annotation, source) {
+        const all = this.getAnnotations();
+        const event = {
+            kind,
+            source,
+            annotation: clone(annotation),
+            all,
+        };
+        this.notifyListeners(this.annotationCreateListeners, event);
+        this.emitAnnotationsChange({
+            action: "create",
+            kind,
+            source,
+            all,
+            current: event.annotation,
+        });
+    }
+    emitAnnotationUpdate(kind, previous, current, source) {
+        const all = this.getAnnotations();
+        const event = {
+            kind,
+            source,
+            previous: clone(previous),
+            current: clone(current),
+            all,
+        };
+        this.notifyListeners(this.annotationUpdateListeners, event);
+        this.emitAnnotationsChange({
+            action: "update",
+            kind,
+            source,
+            all,
+            current: event.current,
+            previous: event.previous,
+        });
+    }
+    emitAnnotationDelete(kind, annotation, source) {
+        const all = this.getAnnotations();
+        const event = {
+            kind,
+            source,
+            annotation: clone(annotation),
+            all,
+        };
+        this.notifyListeners(this.annotationDeleteListeners, event);
+        this.emitAnnotationsChange({
+            action: "delete",
+            kind,
+            source,
+            all,
+            previous: event.annotation,
+        });
+    }
+    emitAnnotationsChange(event) {
+        this.notifyListeners(this.annotationsChangeListeners, event);
+    }
+    notifyListeners(listeners, event) {
+        listeners.forEach((listener) => {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                this.provider.onError?.(toError(error));
+            }
+        });
     }
 }
 function toError(error) {
@@ -102,3 +429,6 @@ function toError(error) {
     }
     return new Error(String(error));
 }
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}

package/dist/core/src/types/player.d.ts

@@ -1,4 +1,8 @@
 import type { EbookDoc } from "./ebook";
+export interface ReaderRange {
+    start: number;
+    end: number;
+}
 export interface ReaderProgress {
     bookId: string;
     lastPage: number;
@@ -10,19 +14,70 @@ export interface ReaderNote {
     bookId: string;
     pageId: string;
     blockId: string;
-    range?: {
-        start: number;
-        end: number;
-    };
+    range?: ReaderRange;
     content: string;
     color?: string;
     createdAt: string;
     updatedAt: string;
 }
+export interface ReaderHighlight {
+    id: string;
+    bookId: string;
+    pageId: string;
+    blockId: string;
+    range: ReaderRange;
+    selectedText?: string;
+    color?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ReaderAnnotations {
+    highlights: ReaderHighlight[];
+    notes: ReaderNote[];
+}
+export type ReaderAnnotationKind = "highlight" | "note";
+export type ReaderAnnotationAction = "create" | "update" | "delete";
+export type ReaderAnnotationChangeSource = "api" | "user";
+export type ReaderAnnotation = ReaderHighlight | ReaderNote;
+export interface ReaderAnnotationCreateEvent {
+    kind: ReaderAnnotationKind;
+    source: ReaderAnnotationChangeSource;
+    annotation: ReaderAnnotation;
+    all: ReaderAnnotations;
+}
+export interface ReaderAnnotationUpdateEvent {
+    kind: ReaderAnnotationKind;
+    source: ReaderAnnotationChangeSource;
+    previous: ReaderAnnotation;
+    current: ReaderAnnotation;
+    all: ReaderAnnotations;
+}
+export interface ReaderAnnotationDeleteEvent {
+    kind: ReaderAnnotationKind;
+    source: ReaderAnnotationChangeSource;
+    annotation: ReaderAnnotation;
+    all: ReaderAnnotations;
+}
+export interface ReaderAnnotationsChangeEvent {
+    action: ReaderAnnotationAction;
+    kind: ReaderAnnotationKind;
+    source: ReaderAnnotationChangeSource;
+    all: ReaderAnnotations;
+    current?: ReaderAnnotation;
+    previous?: ReaderAnnotation;
+}
+export interface PlayerFeatures {
+    useBuiltInNotesModule?: boolean;
+}
+export interface PlayerEngineOptions {
+    features?: PlayerFeatures;
+}
 export interface PlayerDataProvider {
     getData: () => Promise<EbookDoc>;
     loadProgress?: (bookId: string) => Promise<ReaderProgress | null>;
     saveProgress?: (progress: ReaderProgress) => Promise<void>;
+    loadAnnotations?: (bookId: string) => Promise<ReaderAnnotations | null>;
+    saveAnnotations?: (bookId: string, annotations: ReaderAnnotations) => Promise<void>;
     loadNotes?: (bookId: string) => Promise<ReaderNote[]>;
     saveNotes?: (bookId: string, notes: ReaderNote[]) => Promise<void>;
     onError?: (error: Error) => void;

package/dist/core/src/types/player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/player.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACtD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC"}
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/player.ts"],"names":[],"mappings":"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"}

package/dist/core/src/workbench/editor-workbench.d.ts

@@ -14,7 +14,8 @@ export interface EditorWorkbenchOptions {
     pageWidth?: number;
     upload?: EditorWorkbenchUploadOptions;
     importDocx?: EditorWorkbenchDocxImportOptions;
-    onDocumentChange?: (doc: EbookDoc) => void;
+    onDocumentChange?: (doc: EbookDoc) => void | Promise<void>;
+    onFullscreenSave?: (doc: EbookDoc) => void | Promise<void>;
 }
 export interface EditorWorkbenchPreviewAnnotationActions {
     canDelete?: boolean;
@@ -52,9 +53,12 @@ export interface EditorWorkbenchUploadOptions {
 export interface EditorWorkbenchHandle {
     destroy: () => void;
     getDocument: () => EbookDoc;
+    isFullscreen: () => boolean;
     getMode: () => Mode;
     getPageIndex: () => number;
     importDocx: (file: File) => Promise<void>;
+    openFullscreen: () => void;
+    closeFullscreenAndSave: () => Promise<void>;
     setMode: (mode: Mode) => void;
     loadPreviewAnnotations: () => PreviewAnnotations;
     savePreviewAnnotations: (annotations: PreviewAnnotations | null | undefined) => PreviewAnnotations;

package/dist/core/src/workbench/editor-workbench.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor-workbench.d.ts","sourceRoot":"","sources":["../../../../../core/src/workbench/editor-workbench.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"editor-workbench.d.ts","sourceRoot":"","sources":["../../../../../core/src/workbench/editor-workbench.ts"],"names":[],"mappings":"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"}

package/dist/core/src/workbench/editor-workbench.js

@@ -175,8 +175,10 @@ const WORKBENCH_CSS = `
 .hyewb-preview-selection-btn svg{width:16px;height:16px}
 .hyewb-preview-annotation-flash{animation:hyewb-preview-annotation-pulse .9s ease}
 @keyframes hyewb-preview-annotation-pulse{0%{box-shadow:0 0 0 0 rgba(14,116,144,.4)}100%{box-shadow:0 0 0 12px rgba(14,116,144,0)}}
-.hyewb-root:fullscreen .hyewb-editor,.hyewb-root:fullscreen .hyewb-preview{min-height:1000px}
-.hyewb-root:-webkit-full-screen .hyewb-editor,.hyewb-root:-webkit-full-screen .hyewb-preview{min-height:1000px}
+.hyewb-overlay{position:fixed;inset:0;z-index:2147483000;background:rgba(15,23,42,.35);padding:0;box-sizing:border-box;overflow:auto}
+.hyewb-overlay-layer{min-height:100%;display:flex;align-items:stretch;justify-content:stretch}
+.hyewb-root.hyewb-overlay-active{width:100%;max-width:none;min-height:100%;margin:0;border-radius:0;box-shadow:none}
+.hyewb-root.hyewb-overlay-active .hyewb-editor,.hyewb-root.hyewb-overlay-active .hyewb-preview{min-height:1000px}
 `;
 export const DEFAULT_EDITOR_WORKBENCH_FEATURES = {
     textToolbar: true,
@@ -453,7 +455,8 @@ export function mountEditorWorkbench(container, options = {}) {
     title.className = "hyewb-title";
     title.textContent = options.title ?? "hy-ebook Editor Workbench";
     const fullscreenBtn = createButton("fullscreen");
-    header.append(title);
+    fullscreenBtn.style.marginLeft = "auto";
+    header.append(title, fullscreenBtn);
     const toolbar = document.createElement("div");
     toolbar.className = "hyewb-row hyewb-top-control";
     const boldBtn = createButton("bold");
@@ -722,8 +725,7 @@ export function mountEditorWorkbench(container, options = {}) {
     const addPageBtn = createButton("addPage");
     const pageInfo = document.createElement("span");
     pageInfo.className = "hyewb-status";
-    fullscreenBtn.style.marginLeft = "auto";
-    pageRow.append(prevPageBtn, nextPageBtn, addPageBtn, pageInfo, fullscreenBtn);
+    pageRow.append(prevPageBtn, nextPageBtn, addPageBtn, pageInfo);
     const previewLayout = document.createElement("div");
     previewLayout.className = "hyewb-preview-layout";
     const shell = document.createElement("div");
@@ -935,27 +937,25 @@ export function mountEditorWorkbench(container, options = {}) {
         speedMbps: undefined,
         error: undefined,
     };
-    let shouldRestoreFullscreenAfterFilePicker = false;
+    let fullscreenOverlay = null;
+    let fullscreenAnchor = null;
+    let bodyOverflowBeforeOverlay = null;
+    let isOverlayFullscreen = false;
     const setButtonIcon = (button, iconName) => {
         button.innerHTML = "";
         button.append(createIconPlaceholder(iconName));
     };
-    const getFullscreenElement = () => {
-        const webkitDocument = document;
-        return (document.fullscreenElement ||
-            webkitDocument.webkitFullscreenElement ||
-            null);
-    };
     const isWorkbenchFullscreen = () => {
-        return getFullscreenElement() === root;
+        return isOverlayFullscreen;
     };
     const updateFullscreenButtonState = () => {
         const isFullscreen = isWorkbenchFullscreen();
         setButtonActive(fullscreenBtn, isFullscreen);
         setButtonIcon(fullscreenBtn, isFullscreen ? "fullscreen-exit" : "fullscreen-enter");
-        const label = isFullscreen ? "退出全屏" : "全屏";
+        const label = isFullscreen ? "保存并退出" : "全屏";
         fullscreenBtn.title = label;
         fullscreenBtn.setAttribute("aria-label", label);
+        fullscreenBtn.style.display = isFullscreen ? "inline-flex" : "none";
     };
     const updateShellViewportHeight = () => {
         const viewportHeight = window.innerHeight || document.documentElement.clientHeight;
@@ -986,67 +986,82 @@ export function mountEditorWorkbench(container, options = {}) {
         const rounded = Math.round(top);
         return Math.min(rounded, maxTop);
     };
-    const requestWorkbenchFullscreen = async () => {
-        const target = root;
-        if (typeof target.requestFullscreen === "function") {
-            await target.requestFullscreen();
+    const syncWorkbenchLayoutAfterFullscreenChange = () => {
+        updateFullscreenButtonState();
+        updateShellViewportHeight();
+        updateTopControlShieldHeight();
+        updateInlineResizeOverlay();
+        syncTableToolsPosition();
+        syncFocusedTableControls();
+        syncPreviewSelectionToolbar();
+    };
+    const openWorkbenchFullscreen = () => {
+        if (isWorkbenchFullscreen()) {
             return;
         }
-        if (typeof target.webkitRequestFullscreen === "function") {
-            target.webkitRequestFullscreen();
+        const parentNode = root.parentNode;
+        if (!parentNode) {
             return;
         }
-        throw new Error("当前环境不支持全屏");
+        fullscreenAnchor = document.createComment("hyewb-fullscreen-anchor");
+        parentNode.insertBefore(fullscreenAnchor, root);
+        fullscreenOverlay = document.createElement("div");
+        fullscreenOverlay.className = "hyewb-overlay";
+        const fullscreenOverlayLayer = document.createElement("div");
+        fullscreenOverlayLayer.className = "hyewb-overlay-layer";
+        fullscreenOverlay.append(fullscreenOverlayLayer);
+        fullscreenOverlayLayer.append(root);
+        document.body.append(fullscreenOverlay);
+        bodyOverflowBeforeOverlay = document.body.style.overflow;
+        document.body.style.overflow = "hidden";
+        root.classList.add("hyewb-overlay-active");
+        isOverlayFullscreen = true;
+        status.textContent = "已进入页面全屏编辑";
+        syncWorkbenchLayoutAfterFullscreenChange();
     };
-    const exitWorkbenchFullscreen = async () => {
-        const webkitDocument = document;
-        if (typeof document.exitFullscreen === "function") {
-            await document.exitFullscreen();
+    const closeWorkbenchFullscreen = () => {
+        if (!isWorkbenchFullscreen()) {
             return;
         }
-        if (typeof webkitDocument.webkitExitFullscreen === "function") {
-            webkitDocument.webkitExitFullscreen();
-            return;
+        if (fullscreenAnchor && fullscreenAnchor.parentNode) {
+            fullscreenAnchor.parentNode.insertBefore(root, fullscreenAnchor);
+            fullscreenAnchor.parentNode.removeChild(fullscreenAnchor);
         }
-        if (typeof webkitDocument.webkitCancelFullScreen === "function") {
-            webkitDocument.webkitCancelFullScreen();
+        else {
+            container.append(root);
         }
-    };
-    const toggleWorkbenchFullscreen = async () => {
-        try {
-            if (isWorkbenchFullscreen()) {
-                await exitWorkbenchFullscreen();
-            }
-            else {
-                await requestWorkbenchFullscreen();
-            }
+        fullscreenAnchor = null;
+        if (fullscreenOverlay && fullscreenOverlay.parentNode) {
+            fullscreenOverlay.parentNode.removeChild(fullscreenOverlay);
         }
-        catch {
-            status.textContent = "当前浏览器不支持全屏";
-        }
-        finally {
-            updateFullscreenButtonState();
-            updateShellViewportHeight();
+        fullscreenOverlay = null;
+        root.classList.remove("hyewb-overlay-active");
+        isOverlayFullscreen = false;
+        if (bodyOverflowBeforeOverlay !== null) {
+            document.body.style.overflow = bodyOverflowBeforeOverlay;
+            bodyOverflowBeforeOverlay = null;
         }
+        syncWorkbenchLayoutAfterFullscreenChange();
     };
-    const restoreWorkbenchFullscreenIfNeeded = async () => {
-        if (!shouldRestoreFullscreenAfterFilePicker) {
-            return;
-        }
-        shouldRestoreFullscreenAfterFilePicker = false;
-        if (isWorkbenchFullscreen()) {
+    const closeWorkbenchFullscreenAndSave = async () => {
+        if (!isWorkbenchFullscreen()) {
             return;
         }
         try {
-            await requestWorkbenchFullscreen();
-        }
-        catch {
-            // Ignore restore failure when browser blocks fullscreen without activation.
+            syncEditorToDoc({ emitChange: false });
+            const snapshot = clone(state.doc);
+            if (options.onFullscreenSave) {
+                await options.onFullscreenSave(snapshot);
+            }
+            else {
+                await Promise.resolve(options.onDocumentChange?.(snapshot));
+            }
+            closeWorkbenchFullscreen();
+            status.textContent = "已保存并退出页面全屏";
         }
-        finally {
-            updateFullscreenButtonState();
-            updateShellViewportHeight();
-            updateTopControlShieldHeight();
+        catch (error) {
+            const errorMessage = error instanceof Error && error.message ? error.message : "请稍后重试";
+            status.textContent = `保存失败：${errorMessage}`;
         }
     };
     const formatUploadProgress = (percent) => {
@@ -2963,7 +2978,7 @@ export function mountEditorWorkbench(container, options = {}) {
         });
         colorGrid.append(swatch);
     });
-    const syncEditorToDoc = () => {
+    const syncEditorToDoc = (options) => {
         if (state.mode !== "editor") {
             return;
         }
@@ -2975,7 +2990,9 @@ export function mountEditorWorkbench(container, options = {}) {
         page.blocks = replaceFlowBlocks(page.blocks, flowBlocks);
         state.doc.meta.updatedAt = new Date().toISOString();
         editor.setDocument(state.doc);
-        emitDocumentChange();
+        if (options?.emitChange !== false) {
+            emitDocumentChange();
+        }
     };
     const updateAlign = (align) => {
         if (selectedInlineImage &&
@@ -3499,12 +3516,12 @@ export function mountEditorWorkbench(container, options = {}) {
         previewArea.classList.toggle("show", state.mode === "preview");
         editorArea.style.display = state.mode === "editor" ? "block" : "none";
         const showEditorControls = state.mode === "editor";
-        header.style.display = showEditorControls ? "flex" : "none";
+        header.style.display =
+            showEditorControls || isWorkbenchFullscreen() ? "flex" : "none";
         toolbar.style.display =
             showEditorControls && state.features.textToolbar ? "flex" : "none";
-        pageRow.style.display = state.features.pageNav ? "flex" : "none";
-        addPageBtn.style.display =
-            showEditorControls && state.features.pageNav ? "inline-flex" : "none";
+        pageRow.style.display = "none";
+        addPageBtn.style.display = "none";
         videoAddBtn.style.display = state.features.video ? "inline-block" : "none";
         imageUploadBtn.style.display = "inline-block";
         status.style.display = showEditorControls ? "block" : "none";
@@ -4525,19 +4542,6 @@ export function mountEditorWorkbench(container, options = {}) {
     };
     window.addEventListener("resize", handleWindowResize);
     window.addEventListener("scroll", handleWindowScroll, true);
-    const handleFullscreenChange = () => {
-        window.requestAnimationFrame(() => {
-            updateFullscreenButtonState();
-            updateShellViewportHeight();
-            updateTopControlShieldHeight();
-            updateInlineResizeOverlay();
-            syncTableToolsPosition();
-            syncFocusedTableControls();
-            syncPreviewSelectionToolbar();
-        });
-    };
-    document.addEventListener("fullscreenchange", handleFullscreenChange);
-    document.addEventListener("webkitfullscreenchange", handleFullscreenChange);
     document.addEventListener("selectionchange", handleSelectionChange);
     const handleDocumentPointerDownForPalette = (event) => {
         const clickTarget = event.target;
@@ -4613,7 +4617,7 @@ export function mountEditorWorkbench(container, options = {}) {
     document.addEventListener("pointerdown", handleDocumentPointerDownForPalette);
     document.addEventListener("keydown", handleDocumentKeyDown);
     fullscreenBtn.addEventListener("click", () => {
-        void toggleWorkbenchFullscreen();
+        void closeWorkbenchFullscreenAndSave();
     });
     tableAddBtn.addEventListener("mousedown", preserveSelectionForInputControl);
     videoAddBtn.addEventListener("mousedown", preserveSelectionForInputControl);
@@ -4644,12 +4648,10 @@ export function mountEditorWorkbench(container, options = {}) {
             status.textContent = "请先切换到编辑模式后再导入 Word";
             return;
         }
-        shouldRestoreFullscreenAfterFilePicker = isWorkbenchFullscreen();
         docxInput.value = "";
         docxInput.click();
     });
     docxInput.addEventListener("change", () => {
-        void restoreWorkbenchFullscreenIfNeeded();
         const picked = docxInput.files?.[0] || null;
         docxInput.value = "";
         if (!picked) {
@@ -4657,11 +4659,7 @@ export function mountEditorWorkbench(container, options = {}) {
         }
         void importDocxFile(picked);
     });
-    uploadInput.addEventListener("click", () => {
-        shouldRestoreFullscreenAfterFilePicker = isWorkbenchFullscreen();
-    });
     uploadInput.addEventListener("change", () => {
-        void restoreWorkbenchFullscreenIfNeeded();
         const picked = uploadInput.files?.[0] || null;
         uploadState.progress = 0;
         uploadState.speedMbps = undefined;
@@ -4696,10 +4694,6 @@ export function mountEditorWorkbench(container, options = {}) {
     uploadDialog.addEventListener("click", (event) => {
         event.stopPropagation();
     });
-    const handleWindowFocusForFullscreenRestore = () => {
-        void restoreWorkbenchFullscreenIfNeeded();
-    };
-    window.addEventListener("focus", handleWindowFocusForFullscreenRestore);
     prevPageBtn.addEventListener("click", () => jumpPage(-1));
     nextPageBtn.addEventListener("click", () => jumpPage(1));
     addPageBtn.addEventListener("click", addPage);
@@ -4710,6 +4704,7 @@ export function mountEditorWorkbench(container, options = {}) {
     emitDocumentChange();
     return {
         destroy: () => {
+            closeWorkbenchFullscreen();
             hideTablePicker();
             hideTableTools();
             document.removeEventListener("selectionchange", handleSelectionChange);
@@ -4717,17 +4712,17 @@ export function mountEditorWorkbench(container, options = {}) {
             document.removeEventListener("pointerup", onMediaPointerUp);
             window.removeEventListener("resize", handleWindowResize);
             window.removeEventListener("scroll", handleWindowScroll, true);
-            window.removeEventListener("focus", handleWindowFocusForFullscreenRestore);
             document.removeEventListener("pointerdown", handleDocumentPointerDownForPalette);
             document.removeEventListener("keydown", handleDocumentKeyDown);
-            document.removeEventListener("fullscreenchange", handleFullscreenChange);
-            document.removeEventListener("webkitfullscreenchange", handleFullscreenChange);
             container.innerHTML = "";
         },
         getDocument: () => clone(state.doc),
+        isFullscreen: isWorkbenchFullscreen,
         getMode: () => state.mode,
         getPageIndex: () => state.pageIndex,
         importDocx: importDocxFile,
+        openFullscreen: openWorkbenchFullscreen,
+        closeFullscreenAndSave: closeWorkbenchFullscreenAndSave,
         setMode,
         loadPreviewAnnotations,
         savePreviewAnnotations,

package/dist/vue3-adapter/src/index.d.ts

@@ -1,10 +1,11 @@
-import { EditorEngine, PlayerEngine, type EditorWorkbenchHandle, type EditorWorkbenchOptions, type EbookDoc, type PlayerDataProvider } from "@hyebook/core";
+import { EditorEngine, PlayerEngine, type EditorWorkbenchHandle, type EditorWorkbenchOptions, type EbookDoc, type PlayerDataProvider, type PlayerEngineOptions } from "@hyebook/core";
 export interface Vue3EditorAdapterOptions {
     initialDoc: EbookDoc;
     onDocumentChange?: (doc: EbookDoc) => void;
 }
 export interface Vue3PlayerAdapterOptions {
     provider: PlayerDataProvider;
+    engineOptions?: PlayerEngineOptions;
 }
 export interface Vue3EditorWorkbenchOptions extends EditorWorkbenchOptions {
 }

package/dist/vue3-adapter/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EAEZ,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,QAAQ,CAAC;IACrB,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;CAAG;AAE7E,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;CAAG;AAE3E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,YAAY,CAId;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,YAAY,CAEd;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAE3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EAEZ,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,QAAQ,CAAC;IACrB,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;CAAG;AAE7E,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;CAAG;AAE3E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,YAAY,CAId;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,YAAY,CAEd;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAE3B"}

package/dist/vue3-adapter/src/index.js

@@ -5,7 +5,7 @@ export function createVue3EditorAdapter(options) {
     return engine;
 }
 export function createVue3PlayerAdapter(options) {
-    return new PlayerEngine(options.provider);
+    return new PlayerEngine(options.provider, options.engineOptions);
 }
 export function mountVue3EditorWorkbench(container, options = {}) {
     return mountEditorWorkbench(container, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyebook/vue3-adapter",
-  "version": "2.2.6",
+  "version": "2.2.7",
   "description": "Vue3 adapter for hy-ebook core",
   "repository": {
     "type": "git",
@@ -17,11 +17,11 @@
     "dist"
   ],
   "dependencies": {
-    "@hyebook/core": "^2.2.6"
+    "@hyebook/core": "^2.2.7"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "echo 'No lint configured for @hyebook/vue3-adapter'"
   }
-}
+}