@hyebook/vue3-adapter 2.2.7 → 2.3.0

package/dist/core/src/index.d.ts

@@ -4,5 +4,6 @@ export * from "./editor/commands";
 export * from "./editor/engine";
 export * from "./workbench/editor-workbench";
 export * from "./player/engine";
+export * from "./player/ebook-player";
 export * from "./utils/validate";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/core/src/index.js

@@ -4,4 +4,5 @@ export * from "./editor/commands";
 export * from "./editor/engine";
 export * from "./workbench/editor-workbench";
 export * from "./player/engine";
+export * from "./player/ebook-player";
 export * from "./utils/validate";

package/dist/core/src/player/ebook-player.d.ts

@@ -0,0 +1,65 @@
+import type { EbookDoc } from "../types/ebook";
+import type { EBookPlayerHandle, EBookPlayerOptions, ReaderAnnotationChangeSource, ReaderAnnotationCreateEvent, ReaderAnnotationDeleteEvent, ReaderAnnotations, ReaderAnnotationsChangeEvent, ReaderAnnotationUpdateEvent, ReaderHighlight, ReaderNote } from "../types/player";
+export declare class EBookPlayer implements EBookPlayerHandle {
+    private container;
+    private options;
+    private engine;
+    private root;
+    private content;
+    private selectionToolbar;
+    private highlightBtn;
+    private noteBtn;
+    private selectionOptions;
+    private selectionDraft;
+    private loaded;
+    private destroyed;
+    private readonly handleSelectionChangeBound;
+    private readonly handleDocumentPointerDownBound;
+    private readonly preserveSelectionOnToolbarMouseDownBound;
+    private readonly handleHighlightClickBound;
+    private readonly handleNoteClickBound;
+    constructor(container: HTMLElement, options: EBookPlayerOptions);
+    load(): Promise<EbookDoc>;
+    destroy(): void;
+    getDocument(): EbookDoc;
+    getAnnotations(): ReaderAnnotations;
+    getHighlights(): ReaderHighlight[];
+    getNotes(): ReaderNote[];
+    setAnnotations(annotations: ReaderAnnotations, source?: ReaderAnnotationChangeSource): Promise<ReaderAnnotations>;
+    reloadAnnotations(): Promise<ReaderAnnotations>;
+    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>;
+    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: (event: ReaderAnnotationCreateEvent) => void): () => void;
+    onAnnotationUpdate(listener: (event: ReaderAnnotationUpdateEvent) => void): () => void;
+    onAnnotationDelete(listener: (event: ReaderAnnotationDeleteEvent) => void): () => void;
+    onAnnotationsChange(listener: (event: ReaderAnnotationsChangeEvent) => void): () => void;
+    private renderDocument;
+    private renderPage;
+    private renderTextBlock;
+    private renderNonTextBlock;
+    private getTextBlockContent;
+    private createAnnotationBuckets;
+    private toBlockKey;
+    private applyHighlightMarks;
+    private applyNoteMarks;
+    private wrapRangeWithMark;
+    private createRangeFromOffsets;
+    private normalizeOffsetRange;
+    private handleSelectionChange;
+    private resolveTextContainer;
+    private getSelectionOffsets;
+    private hideSelectionToolbar;
+    private clearSelection;
+    private handleDocumentPointerDown;
+    private preserveSelectionOnToolbarMouseDown;
+    private handleHighlightClick;
+    private handleNoteClick;
+    private resolveWidth;
+    private resolveSelectionToolbarOptions;
+    private ensureLoaded;
+}
+//# sourceMappingURL=ebook-player.d.ts.map

package/dist/core/src/player/ebook-player.d.ts.map

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

package/dist/core/src/player/ebook-player.js

@@ -0,0 +1,550 @@
+import { PlayerEngine } from "./engine";
+const EBOOK_PLAYER_STYLE_ID = "hy-ebook-lite-player-style";
+const EBOOK_PLAYER_STYLE_VERSION = "0.1.0";
+const EBOOK_PLAYER_CSS = `
+.hyepl-root{position:relative;max-width:100%;margin:0 auto;color:#0f172a;font-size:14px;line-height:1.7}
+.hyepl-content{position:relative}
+.hyepl-page{margin:0 0 16px}
+.hyepl-page:last-child{margin-bottom:0}
+.hyepl-block{margin:0 0 10px;white-space:pre-wrap;word-break:break-word}
+.hyepl-block:last-child{margin-bottom:0}
+.hyepl-block-muted{color:#64748b}
+.hyepl-highlight{background:var(--hyepl-highlight-color,#fff59d);color:inherit;padding:0 .08em;border-radius:.2em}
+.hyepl-note{background:rgba(14,116,144,.14);border-bottom:2px solid #0e7490;color:inherit;padding:0 .04em;border-radius:.2em}
+.hyepl-selection-toolbar{position:fixed;z-index:10060;display:none;align-items:center;gap:8px;padding:6px 8px;border-radius:10px;border:1px solid #0f172a;background:rgba(15,23,42,.96);box-shadow:0 10px 24px rgba(15,23,42,.22);transform:translate(-50%,-100%)}
+.hyepl-selection-toolbar.show{display:inline-flex}
+.hyepl-toolbar-btn{height:30px;padding:0 10px;border:1px solid #334155;border-radius:8px;background:#1e293b;color:#f8fafc;cursor:pointer;font-size:12px}
+`;
+export class EBookPlayer {
+    constructor(container, options) {
+        this.selectionDraft = null;
+        this.loaded = false;
+        this.destroyed = false;
+        this.handleSelectionChangeBound = () => {
+            this.handleSelectionChange();
+        };
+        this.handleDocumentPointerDownBound = (event) => {
+            this.handleDocumentPointerDown(event);
+        };
+        this.preserveSelectionOnToolbarMouseDownBound = (event) => {
+            this.preserveSelectionOnToolbarMouseDown(event);
+        };
+        this.handleHighlightClickBound = () => {
+            void this.handleHighlightClick();
+        };
+        this.handleNoteClickBound = () => {
+            void this.handleNoteClick();
+        };
+        this.container = container;
+        this.options = options;
+        this.engine = new PlayerEngine(options.provider, options.engineOptions);
+        this.selectionOptions = this.resolveSelectionToolbarOptions(options.selectionToolbar);
+        ensureEBookPlayerStyles();
+        this.root = document.createElement("section");
+        this.root.className = "hyepl-root";
+        this.root.style.width = `${this.resolveWidth(options.width)}px`;
+        this.content = document.createElement("div");
+        this.content.className = "hyepl-content";
+        this.selectionToolbar = document.createElement("div");
+        this.selectionToolbar.className = "hyepl-selection-toolbar";
+        this.highlightBtn = document.createElement("button");
+        this.highlightBtn.type = "button";
+        this.highlightBtn.className = "hyepl-toolbar-btn";
+        this.highlightBtn.textContent = this.selectionOptions.highlightButtonText;
+        this.highlightBtn.setAttribute("aria-label", this.selectionOptions.highlightButtonText);
+        this.noteBtn = document.createElement("button");
+        this.noteBtn.type = "button";
+        this.noteBtn.className = "hyepl-toolbar-btn";
+        this.noteBtn.textContent = this.selectionOptions.noteButtonText;
+        this.noteBtn.setAttribute("aria-label", this.selectionOptions.noteButtonText);
+        this.selectionToolbar.append(this.highlightBtn, this.noteBtn);
+        this.root.append(this.content, this.selectionToolbar);
+        this.container.innerHTML = "";
+        this.container.append(this.root);
+        this.highlightBtn.addEventListener("mousedown", this.preserveSelectionOnToolbarMouseDownBound);
+        this.noteBtn.addEventListener("mousedown", this.preserveSelectionOnToolbarMouseDownBound);
+        this.highlightBtn.addEventListener("click", this.handleHighlightClickBound);
+        this.noteBtn.addEventListener("click", this.handleNoteClickBound);
+        document.addEventListener("selectionchange", this.handleSelectionChangeBound);
+        document.addEventListener("pointerdown", this.handleDocumentPointerDownBound);
+    }
+    async load() {
+        const doc = await this.engine.load();
+        this.loaded = true;
+        if (this.options.initialAnnotations) {
+            await this.engine.setAnnotations(this.options.initialAnnotations, "api");
+        }
+        this.renderDocument();
+        return doc;
+    }
+    destroy() {
+        if (this.destroyed) {
+            return;
+        }
+        this.destroyed = true;
+        this.hideSelectionToolbar();
+        document.removeEventListener("selectionchange", this.handleSelectionChangeBound);
+        document.removeEventListener("pointerdown", this.handleDocumentPointerDownBound);
+        this.highlightBtn.removeEventListener("mousedown", this.preserveSelectionOnToolbarMouseDownBound);
+        this.noteBtn.removeEventListener("mousedown", this.preserveSelectionOnToolbarMouseDownBound);
+        this.highlightBtn.removeEventListener("click", this.handleHighlightClickBound);
+        this.noteBtn.removeEventListener("click", this.handleNoteClickBound);
+        if (this.root.parentNode === this.container) {
+            this.container.removeChild(this.root);
+        }
+    }
+    getDocument() {
+        return this.engine.getDocument();
+    }
+    getAnnotations() {
+        return this.engine.getAnnotations();
+    }
+    getHighlights() {
+        return this.engine.getHighlights();
+    }
+    getNotes() {
+        return this.engine.getNotes();
+    }
+    async setAnnotations(annotations, source = "api") {
+        this.ensureLoaded();
+        const all = await this.engine.setAnnotations(annotations, source);
+        this.renderDocument();
+        return all;
+    }
+    async reloadAnnotations() {
+        this.ensureLoaded();
+        const all = await this.engine.reloadAnnotations();
+        this.renderDocument();
+        return all;
+    }
+    async createHighlight(highlight, source = "api") {
+        this.ensureLoaded();
+        const created = await this.engine.createHighlight(highlight, source);
+        this.renderDocument();
+        return created;
+    }
+    async updateHighlight(highlightId, patch, source = "api") {
+        this.ensureLoaded();
+        const updated = await this.engine.updateHighlight(highlightId, patch, source);
+        this.renderDocument();
+        return updated;
+    }
+    async deleteHighlight(highlightId, source = "api") {
+        this.ensureLoaded();
+        const deleted = await this.engine.deleteHighlight(highlightId, source);
+        this.renderDocument();
+        return deleted;
+    }
+    async createNote(note, source = "api") {
+        this.ensureLoaded();
+        const created = await this.engine.createNote(note, source);
+        this.renderDocument();
+        return created;
+    }
+    async updateNote(noteId, patch, source = "api") {
+        this.ensureLoaded();
+        const updated = await this.engine.updateNote(noteId, patch, source);
+        this.renderDocument();
+        return updated;
+    }
+    async deleteNote(noteId, source = "api") {
+        this.ensureLoaded();
+        const deleted = await this.engine.deleteNote(noteId, source);
+        this.renderDocument();
+        return deleted;
+    }
+    onAnnotationCreate(listener) {
+        return this.engine.onAnnotationCreate(listener);
+    }
+    onAnnotationUpdate(listener) {
+        return this.engine.onAnnotationUpdate(listener);
+    }
+    onAnnotationDelete(listener) {
+        return this.engine.onAnnotationDelete(listener);
+    }
+    onAnnotationsChange(listener) {
+        return this.engine.onAnnotationsChange(listener);
+    }
+    renderDocument() {
+        if (!this.loaded || this.destroyed) {
+            return;
+        }
+        const doc = this.engine.getDocument();
+        const buckets = this.createAnnotationBuckets(this.engine.getAnnotations());
+        const fragment = document.createDocumentFragment();
+        doc.pages.forEach((page) => {
+            fragment.append(this.renderPage(page, buckets));
+        });
+        this.content.innerHTML = "";
+        this.content.append(fragment);
+        this.hideSelectionToolbar();
+    }
+    renderPage(page, buckets) {
+        const pageSection = document.createElement("section");
+        pageSection.className = "hyepl-page";
+        pageSection.dataset.pageId = page.id;
+        page.blocks.forEach((block) => {
+            if (block.type === "text") {
+                pageSection.append(this.renderTextBlock(page.id, block, buckets));
+                return;
+            }
+            pageSection.append(this.renderNonTextBlock(block));
+        });
+        return pageSection;
+    }
+    renderTextBlock(pageId, block, buckets) {
+        const blockTextNode = document.createElement("div");
+        blockTextNode.className = "hyepl-block hyepl-block-text";
+        blockTextNode.dataset.pageId = pageId;
+        blockTextNode.dataset.blockId = block.id;
+        blockTextNode.textContent = this.getTextBlockContent(block);
+        const blockKey = this.toBlockKey(pageId, block.id);
+        const highlights = buckets.highlightsByBlock.get(blockKey) || [];
+        const notes = buckets.notesByBlock.get(blockKey) || [];
+        this.applyHighlightMarks(blockTextNode, highlights);
+        this.applyNoteMarks(blockTextNode, notes);
+        return blockTextNode;
+    }
+    renderNonTextBlock(block) {
+        const node = document.createElement("div");
+        node.className = "hyepl-block hyepl-block-muted";
+        if (block.type === "image") {
+            node.textContent = "[图片内容]";
+            return node;
+        }
+        if (block.type === "video") {
+            node.textContent = "[视频内容]";
+            return node;
+        }
+        if (block.type === "table") {
+            node.textContent = "[表格内容]";
+            return node;
+        }
+        node.textContent = "[内容块]";
+        return node;
+    }
+    getTextBlockContent(block) {
+        return block.content.paragraphs
+            .map((paragraph) => {
+            return paragraph.runs.map((run) => run.text || "").join("");
+        })
+            .join("\n");
+    }
+    createAnnotationBuckets(annotations) {
+        const highlightsByBlock = new Map();
+        const notesByBlock = new Map();
+        annotations.highlights.forEach((item) => {
+            const key = this.toBlockKey(item.pageId, item.blockId);
+            const current = highlightsByBlock.get(key) || [];
+            current.push(item);
+            highlightsByBlock.set(key, current);
+        });
+        annotations.notes.forEach((item) => {
+            const key = this.toBlockKey(item.pageId, item.blockId);
+            const current = notesByBlock.get(key) || [];
+            current.push(item);
+            notesByBlock.set(key, current);
+        });
+        return { highlightsByBlock, notesByBlock };
+    }
+    toBlockKey(pageId, blockId) {
+        return `${pageId}::${blockId}`;
+    }
+    applyHighlightMarks(container, highlights) {
+        [...highlights]
+            .filter((item) => Number.isFinite(item.range.start) && Number.isFinite(item.range.end))
+            .sort((a, b) => b.range.start - a.range.start)
+            .forEach((item) => {
+            const range = this.createRangeFromOffsets(container, item.range.start, item.range.end);
+            if (!range || range.collapsed) {
+                return;
+            }
+            const mark = document.createElement("mark");
+            mark.className = "hyepl-highlight";
+            if (item.color) {
+                mark.style.setProperty("--hyepl-highlight-color", item.color);
+            }
+            this.wrapRangeWithMark(range, mark);
+        });
+    }
+    applyNoteMarks(container, notes) {
+        [...notes]
+            .filter((item) => !!item.range)
+            .sort((a, b) => {
+            const startA = a.range?.start || 0;
+            const startB = b.range?.start || 0;
+            return startB - startA;
+        })
+            .forEach((item) => {
+            if (!item.range) {
+                return;
+            }
+            const range = this.createRangeFromOffsets(container, item.range.start, item.range.end);
+            if (!range || range.collapsed) {
+                return;
+            }
+            const mark = document.createElement("mark");
+            mark.className = "hyepl-note";
+            mark.dataset.noteId = item.id;
+            this.wrapRangeWithMark(range, mark);
+        });
+    }
+    wrapRangeWithMark(range, mark) {
+        try {
+            range.surroundContents(mark);
+        }
+        catch {
+            const fragment = range.extractContents();
+            mark.append(fragment);
+            range.insertNode(mark);
+        }
+    }
+    createRangeFromOffsets(containerNode, start, end) {
+        const normalized = this.normalizeOffsetRange(start, end);
+        if (!normalized) {
+            return null;
+        }
+        const range = document.createRange();
+        const walker = document.createTreeWalker(containerNode, NodeFilter.SHOW_TEXT);
+        let cursor = 0;
+        let startNode = null;
+        let endNode = null;
+        let startOffset = 0;
+        let endOffset = 0;
+        let lastTextNode = null;
+        while (walker.nextNode()) {
+            const node = walker.currentNode;
+            const length = node.textContent?.length || 0;
+            lastTextNode = node;
+            const nextCursor = cursor + length;
+            if (!startNode &&
+                normalized.start >= cursor &&
+                normalized.start < nextCursor) {
+                startNode = node;
+                startOffset = normalized.start - cursor;
+            }
+            if (!endNode && normalized.end > cursor && normalized.end <= nextCursor) {
+                endNode = node;
+                endOffset = normalized.end - cursor;
+                break;
+            }
+            cursor = nextCursor;
+        }
+        if (!startNode && lastTextNode && normalized.start === cursor) {
+            startNode = lastTextNode;
+            startOffset = lastTextNode.textContent?.length || 0;
+        }
+        if (!endNode && lastTextNode && normalized.end === cursor) {
+            endNode = lastTextNode;
+            endOffset = lastTextNode.textContent?.length || 0;
+        }
+        if (!startNode || !endNode) {
+            return null;
+        }
+        range.setStart(startNode, startOffset);
+        range.setEnd(endNode, endOffset);
+        return range;
+    }
+    normalizeOffsetRange(start, end) {
+        const safeStart = Math.max(0, Math.floor(start || 0));
+        const safeEnd = Math.max(0, Math.floor(end || 0));
+        if (safeStart === safeEnd) {
+            return null;
+        }
+        return safeStart < safeEnd
+            ? { start: safeStart, end: safeEnd }
+            : { start: safeEnd, end: safeStart };
+    }
+    handleSelectionChange() {
+        if (!this.selectionOptions.enabled || !this.loaded || this.destroyed) {
+            this.hideSelectionToolbar();
+            return;
+        }
+        const selection = window.getSelection();
+        if (!selection || selection.rangeCount === 0 || selection.isCollapsed) {
+            this.hideSelectionToolbar();
+            return;
+        }
+        const range = selection.getRangeAt(0);
+        const startContainer = this.resolveTextContainer(range.startContainer);
+        const endContainer = this.resolveTextContainer(range.endContainer);
+        if (!startContainer || !endContainer || startContainer !== endContainer) {
+            this.hideSelectionToolbar();
+            return;
+        }
+        const offsets = this.getSelectionOffsets(startContainer, selection);
+        if (!offsets) {
+            this.hideSelectionToolbar();
+            return;
+        }
+        const pageId = startContainer.dataset.pageId;
+        const blockId = startContainer.dataset.blockId;
+        if (!pageId || !blockId) {
+            this.hideSelectionToolbar();
+            return;
+        }
+        const rect = range.getBoundingClientRect();
+        if (!rect.width && !rect.height) {
+            this.hideSelectionToolbar();
+            return;
+        }
+        this.selectionDraft = {
+            pageId,
+            blockId,
+            range: offsets,
+            text: selection.toString().trim(),
+        };
+        this.selectionToolbar.style.left = `${Math.round(rect.left + rect.width / 2)}px`;
+        this.selectionToolbar.style.top = `${Math.round(rect.top - 8)}px`;
+        this.selectionToolbar.classList.add("show");
+    }
+    resolveTextContainer(node) {
+        if (!node) {
+            return null;
+        }
+        const baseElement = node.nodeType === Node.ELEMENT_NODE
+            ? node
+            : node.parentElement;
+        if (!baseElement) {
+            return null;
+        }
+        const textContainer = baseElement.closest(".hyepl-block-text");
+        if (!textContainer || !this.content.contains(textContainer)) {
+            return null;
+        }
+        return textContainer;
+    }
+    getSelectionOffsets(container, selection) {
+        if (selection.rangeCount === 0) {
+            return null;
+        }
+        const range = selection.getRangeAt(0);
+        const startRange = document.createRange();
+        startRange.selectNodeContents(container);
+        startRange.setEnd(range.startContainer, range.startOffset);
+        const endRange = document.createRange();
+        endRange.selectNodeContents(container);
+        endRange.setEnd(range.endContainer, range.endOffset);
+        const start = startRange.toString().length;
+        const end = endRange.toString().length;
+        return this.normalizeOffsetRange(start, end);
+    }
+    hideSelectionToolbar() {
+        this.selectionToolbar.classList.remove("show");
+        this.selectionDraft = null;
+    }
+    clearSelection() {
+        window.getSelection()?.removeAllRanges();
+    }
+    handleDocumentPointerDown(event) {
+        const target = event.target;
+        if (!target) {
+            this.hideSelectionToolbar();
+            return;
+        }
+        if (this.selectionToolbar.contains(target)) {
+            return;
+        }
+        if (!this.root.contains(target)) {
+            this.hideSelectionToolbar();
+        }
+    }
+    preserveSelectionOnToolbarMouseDown(event) {
+        event.preventDefault();
+        event.stopPropagation();
+    }
+    async handleHighlightClick() {
+        if (!this.selectionDraft) {
+            return;
+        }
+        const payload = {
+            pageId: this.selectionDraft.pageId,
+            blockId: this.selectionDraft.blockId,
+            range: this.selectionDraft.range,
+            ...(this.selectionDraft.text
+                ? { selectedText: this.selectionDraft.text }
+                : {}),
+            ...(this.selectionOptions.highlightColor
+                ? { color: this.selectionOptions.highlightColor }
+                : {}),
+        };
+        await this.createHighlight(payload, "user");
+        this.clearSelection();
+        this.hideSelectionToolbar();
+    }
+    async handleNoteClick() {
+        if (!this.selectionDraft) {
+            return;
+        }
+        const defaultText = this.selectionDraft.text || "";
+        const noteText = window.prompt("请输入笔记内容", defaultText);
+        const content = noteText?.trim();
+        if (!content) {
+            return;
+        }
+        const payload = {
+            pageId: this.selectionDraft.pageId,
+            blockId: this.selectionDraft.blockId,
+            range: this.selectionDraft.range,
+            content,
+            ...(this.selectionDraft.text
+                ? { selectedText: this.selectionDraft.text }
+                : {}),
+            ...(this.selectionOptions.noteColor
+                ? { color: this.selectionOptions.noteColor }
+                : {}),
+        };
+        await this.createNote(payload, "user");
+        this.clearSelection();
+        this.hideSelectionToolbar();
+    }
+    resolveWidth(width) {
+        if (!Number.isFinite(width)) {
+            return 840;
+        }
+        return Math.max(320, Math.round(width));
+    }
+    resolveSelectionToolbarOptions(options) {
+        const highlightButtonText = typeof options?.highlightButtonText === "string" &&
+            options.highlightButtonText.trim()
+            ? options.highlightButtonText.trim()
+            : "高亮";
+        const noteButtonText = typeof options?.noteButtonText === "string" &&
+            options.noteButtonText.trim()
+            ? options.noteButtonText.trim()
+            : "笔记";
+        return {
+            enabled: options?.enabled !== false,
+            highlightButtonText,
+            noteButtonText,
+            highlightColor: typeof options?.highlightColor === "string" &&
+                options.highlightColor.trim()
+                ? options.highlightColor.trim()
+                : "#fff59d",
+            noteColor: typeof options?.noteColor === "string" && options.noteColor.trim()
+                ? options.noteColor.trim()
+                : "#0e7490",
+        };
+    }
+    ensureLoaded() {
+        if (!this.loaded) {
+            throw new Error("Document is not loaded. Call load() first.");
+        }
+    }
+}
+function ensureEBookPlayerStyles() {
+    const existing = document.getElementById(EBOOK_PLAYER_STYLE_ID);
+    if (existing instanceof HTMLStyleElement) {
+        if (existing.dataset.hyeplVersion !== EBOOK_PLAYER_STYLE_VERSION ||
+            existing.textContent !== EBOOK_PLAYER_CSS) {
+            existing.textContent = EBOOK_PLAYER_CSS;
+            existing.dataset.hyeplVersion = EBOOK_PLAYER_STYLE_VERSION;
+        }
+        return;
+    }
+    const style = document.createElement("style");
+    style.id = EBOOK_PLAYER_STYLE_ID;
+    style.dataset.hyeplVersion = EBOOK_PLAYER_STYLE_VERSION;
+    style.textContent = EBOOK_PLAYER_CSS;
+    document.head.append(style);
+}

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

@@ -30,6 +30,7 @@ export declare class PlayerEngine {
     getFeatures(): Required<PlayerFeatures>;
     isBuiltInNotesModuleEnabled(): boolean;
     reloadAnnotations(): Promise<ReaderAnnotations>;
+    setAnnotations(annotations: ReaderAnnotations, source?: ReaderAnnotationChangeSource): Promise<ReaderAnnotations>;
     goToHighlight(highlightId: string): number | null;
     goToNote(noteId: string): number | null;
     goToPage(index: number): number;

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":"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"}
+{"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

@@ -69,6 +69,29 @@ export class PlayerEngine {
         await this.loadAnnotationsState();
         return this.getAnnotations();
     }
+    async setAnnotations(annotations, source = "api") {
+        if (!this.doc) {
+            throw new Error("Document is not loaded. Call load() first.");
+        }
+        const normalized = this.normalizeAnnotations(annotations, this.doc.id);
+        this.state.highlights = normalized.highlights;
+        this.state.notes = normalized.notes;
+        await this.persistAnnotations();
+        const all = this.getAnnotations();
+        this.emitAnnotationsChange({
+            action: "update",
+            kind: "highlight",
+            source,
+            all,
+        });
+        this.emitAnnotationsChange({
+            action: "update",
+            kind: "note",
+            source,
+            all,
+        });
+        return all;
+    }
     goToHighlight(highlightId) {
         const target = this.state.highlights.find((item) => item.id === highlightId);
         if (!target) {
@@ -267,7 +290,7 @@ export class PlayerEngine {
         if (this.provider.loadAnnotations) {
             const annotations = await this.provider.loadAnnotations(this.doc.id);
             if (annotations) {
-                const normalized = this.normalizeAnnotations(annotations);
+                const normalized = this.normalizeAnnotations(annotations, this.doc.id);
                 this.state.highlights = normalized.highlights;
                 this.state.notes = normalized.notes;
                 restoredFromAnnotationsProvider = true;
@@ -296,14 +319,41 @@ export class PlayerEngine {
             ? { start: safeStart, end: safeEnd }
             : { start: safeEnd, end: safeStart };
     }
-    normalizeAnnotations(annotations) {
+    normalizeAnnotations(annotations, bookId) {
+        const now = new Date().toISOString();
         const highlights = Array.isArray(annotations?.highlights)
-            ? clone(annotations.highlights)
-            : [];
-        const notes = Array.isArray(annotations?.notes)
-            ? clone(annotations.notes)
+            ? annotations.highlights
             : [];
-        return { highlights, notes };
+        const notes = Array.isArray(annotations?.notes) ? annotations.notes : [];
+        return {
+            highlights: highlights.map((item, index) => {
+                const fallbackId = `highlight-${Date.now()}-${index}`;
+                return {
+                    ...clone(item),
+                    id: item.id || fallbackId,
+                    bookId: item.bookId || bookId || "",
+                    pageId: item.pageId || "",
+                    blockId: item.blockId || "preview-flow-text",
+                    range: this.normalizeRange(item.range),
+                    createdAt: item.createdAt || now,
+                    updatedAt: item.updatedAt || item.createdAt || now,
+                };
+            }),
+            notes: notes.map((item, index) => {
+                const fallbackId = `note-${Date.now()}-${index}`;
+                return {
+                    ...clone(item),
+                    id: item.id || fallbackId,
+                    bookId: item.bookId || bookId || "",
+                    pageId: item.pageId || "",
+                    blockId: item.blockId || "preview-flow-text",
+                    ...(item.range ? { range: this.normalizeRange(item.range) } : {}),
+                    content: item.content || "",
+                    createdAt: item.createdAt || now,
+                    updatedAt: item.updatedAt || item.createdAt || now,
+                };
+            }),
+        };
     }
     mapPreviewAnnotationsToReader(annotations, bookId) {
         const now = new Date().toISOString();

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

@@ -72,6 +72,13 @@ export interface PlayerFeatures {
 export interface PlayerEngineOptions {
     features?: PlayerFeatures;
 }
+export interface EBookPlayerSelectionToolbarOptions {
+    enabled?: boolean;
+    highlightButtonText?: string;
+    noteButtonText?: string;
+    highlightColor?: string;
+    noteColor?: string;
+}
 export interface PlayerDataProvider {
     getData: () => Promise<EbookDoc>;
     loadProgress?: (bookId: string) => Promise<ReaderProgress | null>;
@@ -82,4 +89,31 @@ export interface PlayerDataProvider {
     saveNotes?: (bookId: string, notes: ReaderNote[]) => Promise<void>;
     onError?: (error: Error) => void;
 }
+export interface EBookPlayerOptions {
+    provider: PlayerDataProvider;
+    engineOptions?: PlayerEngineOptions;
+    width?: number;
+    initialAnnotations?: ReaderAnnotations;
+    selectionToolbar?: EBookPlayerSelectionToolbarOptions;
+}
+export interface EBookPlayerHandle {
+    load: () => Promise<EbookDoc>;
+    destroy: () => void;
+    getDocument: () => EbookDoc;
+    getAnnotations: () => ReaderAnnotations;
+    getHighlights: () => ReaderHighlight[];
+    getNotes: () => ReaderNote[];
+    setAnnotations: (annotations: ReaderAnnotations, source?: ReaderAnnotationChangeSource) => Promise<ReaderAnnotations>;
+    reloadAnnotations: () => Promise<ReaderAnnotations>;
+    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>;
+    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: (event: ReaderAnnotationCreateEvent) => void) => () => void;
+    onAnnotationUpdate: (listener: (event: ReaderAnnotationUpdateEvent) => void) => () => void;
+    onAnnotationDelete: (listener: (event: ReaderAnnotationDeleteEvent) => void) => () => void;
+    onAnnotationsChange: (listener: (event: ReaderAnnotationsChangeEvent) => void) => () => void;
+}
 //# sourceMappingURL=player.d.ts.map

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":"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"}
+{"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

@@ -12,11 +12,39 @@ export interface EditorWorkbenchOptions {
     previewAnnotations?: EditorWorkbenchPreviewAnnotationOptions;
     title?: string;
     pageWidth?: number;
+    fullscreen?: EditorWorkbenchFullscreenOptions;
+    extension?: EditorWorkbenchExtensionOptions;
+    debug?: boolean | EditorWorkbenchDebugOptions;
     upload?: EditorWorkbenchUploadOptions;
     importDocx?: EditorWorkbenchDocxImportOptions;
     onDocumentChange?: (doc: EbookDoc) => void | Promise<void>;
     onFullscreenSave?: (doc: EbookDoc) => void | Promise<void>;
 }
+export interface EditorWorkbenchFullscreenOptions {
+    exitButtonText?: string;
+}
+export interface EditorWorkbenchExtensionActionContext {
+    getDocument: () => EbookDoc;
+    isFullscreen: () => boolean;
+    getMode: () => "editor" | "preview";
+    setMode: (mode: "editor" | "preview") => void;
+    closeFullscreenAndSave: () => Promise<void>;
+}
+export interface EditorWorkbenchExtensionActionButton {
+    id: string;
+    text: string;
+    color?: string;
+    textColor?: string;
+    borderColor?: string;
+    onClick?: (context: EditorWorkbenchExtensionActionContext, event: MouseEvent) => void | Promise<void>;
+}
+export interface EditorWorkbenchExtensionOptions {
+    actions?: EditorWorkbenchExtensionActionButton[];
+}
+export interface EditorWorkbenchDebugOptions {
+    enabled?: boolean;
+    prefix?: string;
+}
 export interface EditorWorkbenchPreviewAnnotationActions {
     canDelete?: boolean;
 }

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

@@ -1,15 +1,18 @@
 import { addPageCommand } from "../editor/commands";
 import { EditorEngine } from "../editor/engine";
 const WORKBENCH_STYLE_ID = "hy-ebook-workbench-style";
-const WORKBENCH_STYLE_VERSION = "0.2.3";
+const WORKBENCH_STYLE_VERSION = "0.3.0";
 const WORKBENCH_CSS = `
 .hyewb-root{font-family:"Noto Sans SC","PingFang SC","Microsoft YaHei",sans-serif;color:#0f172a;background:#f8fbff;border:1px solid #d8e0ea;border-radius:12px;padding:12px;display:grid;gap:10px;position:relative;--hyewb-top-shield-height:0px}
 .hyewb-root::before{content:"";position:absolute;left:0;right:0;top:0;height:var(--hyewb-top-shield-height);background:#f8fbff;z-index:119500;pointer-events:none}
 .hyewb-header{display:flex;justify-content:space-between;align-items:center;gap:8px;flex-wrap:wrap}
 .hyewb-title{font-size:14px;font-weight:600}
+.hyewb-header-actions{margin-left:auto;display:inline-flex;align-items:center;gap:8px;flex-wrap:wrap}
 .hyewb-row{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
 .hyewb-top-control{position:relative;z-index:120000;background:#f8fbff;isolation:isolate}
 .hyewb-btn{border:1px solid #94a3b8;background:#fff;color:#0f172a;border-radius:8px;cursor:pointer;display:inline-flex;align-items:center;justify-content:center;padding:0;width:34px;height:34px;flex:0 0 auto}
+.hyewb-btn.hyewb-btn-text{width:auto;min-width:96px;padding:0 12px}
+.hyewb-header-action-btn{height:34px}
 .hyewb-btn.active{border-color:#0b7285;background:#0b7285;color:#fff}
 .hyewb-btn:disabled{cursor:not-allowed;opacity:.55}
 .hyewb-btn svg,.hyewb-upload-close svg{width:16px;height:16px;stroke-width:2}
@@ -25,10 +28,10 @@ const WORKBENCH_CSS = `
 .hyewb-field-icon{position:absolute;left:10px;top:50%;transform:translateY(-50%);display:inline-flex;align-items:center;justify-content:center;color:#64748b;pointer-events:none;z-index:1}
 .hyewb-field-icon svg{width:14px;height:14px;stroke-width:2}
 .hyewb-field-with-icon .hyewb-select,.hyewb-field-with-icon .hyewb-number{padding-left:30px}
-.hyewb-shell{border:1px dashed #b8c3d1;border-radius:10px;background:#eef4ff;padding:10px;overflow-x:auto;overflow-y:auto;overscroll-behavior:auto;-webkit-overflow-scrolling:touch}
+.hyewb-shell{border:1px dashed #b8c3d1;border-radius:10px;background:#eef4ff;padding:10px;overflow-x:auto;overflow-y:auto;overscroll-behavior:contain;-webkit-overflow-scrolling:touch}
 .hyewb-preview-layout{display:grid;grid-template-columns:minmax(0,1fr);gap:12px;align-items:start}
 .hyewb-preview-layout.with-annotation-panel{grid-template-columns:minmax(0,1fr) 300px}
-.hyewb-canvas{position:relative;background:#fff;border:1px solid #d9e3ee;border-radius:8px;min-height:420px;padding:20px 24px;box-shadow:0 6px 16px rgba(15,23,42,.08);margin:0 auto;max-width:100%;box-sizing:border-box}
+.hyewb-canvas{position:relative;background:#fff;border:1px solid #d9e3ee;border-radius:8px;min-height:420px;padding:20px 24px;box-shadow:0 6px 16px rgba(15,23,42,.08);margin:16px auto;max-width:100%;box-sizing:border-box;}
 .hyewb-editor{min-height:360px;outline:none;line-height:1.7;font-size:16px;color:#1e293b}
 .hyewb-float{position:fixed;z-index:9999;display:none;align-items:center;gap:6px;padding:6px 8px;border-radius:10px;border:1px solid #0f172a;background:rgba(15,23,42,.96);box-shadow:0 10px 24px rgba(15,23,42,.22)}
 .hyewb-float.show{display:inline-flex}
@@ -175,10 +178,14 @@ 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-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}
+.hyewb-overlay{position:fixed;inset:0;z-index:2147483000;background:rgba(15,23,42,.35);padding:0;box-sizing:border-box;overflow:hidden;overscroll-behavior:contain}
+.hyewb-overlay-layer{min-height:100vh;min-height:100dvh;height:100vh;height:100dvh;display:flex;align-items:stretch;justify-content:stretch;overflow:hidden}
+.hyewb-root.hyewb-overlay-active{width:100%;max-width:none;min-height:100vh;min-height:100dvh;height:100vh;height:100dvh;margin:0;border-radius:0;box-shadow:none;grid-template-rows:auto auto minmax(0,1fr);overflow:hidden}
+.hyewb-root.hyewb-overlay-active .hyewb-preview-layout{height:100%;min-height:0;align-items:stretch;grid-template-rows:minmax(0,1fr)}
+.hyewb-root.hyewb-overlay-active .hyewb-shell{height:100%;max-height:none;min-height:0;padding:0;background:transparent}
+.hyewb-root.hyewb-overlay-active .hyewb-canvas{height:auto;min-height:100%;border-radius:0;box-shadow:none}
+.hyewb-root.hyewb-overlay-active .hyewb-preview-annotation-panel{height:100%;max-height:none}
+.hyewb-root.hyewb-overlay-active .hyewb-editor,.hyewb-root.hyewb-overlay-active .hyewb-preview{min-height:100%}
 `;
 export const DEFAULT_EDITOR_WORKBENCH_FEATURES = {
     textToolbar: true,
@@ -449,14 +456,50 @@ export function mountEditorWorkbench(container, options = {}) {
     const paperWidth = resolvePaperWidth(options.pageWidth, state.doc.settings.page.width);
     const root = document.createElement("section");
     root.className = "hyewb-root";
+    const extensionActionConfigs = Array.isArray(options.extension?.actions)
+        ? options.extension.actions.filter((action) => {
+            return (!!action &&
+                typeof action.id === "string" &&
+                action.id.trim().length > 0 &&
+                typeof action.text === "string" &&
+                action.text.trim().length > 0);
+        })
+        : [];
     const header = document.createElement("header");
     header.className = "hyewb-header hyewb-top-control";
     const title = document.createElement("div");
     title.className = "hyewb-title";
     title.textContent = options.title ?? "hy-ebook Editor Workbench";
+    const headerActions = document.createElement("div");
+    headerActions.className = "hyewb-header-actions";
     const fullscreenBtn = createButton("fullscreen");
-    fullscreenBtn.style.marginLeft = "auto";
-    header.append(title, fullscreenBtn);
+    const extensionActionButtons = extensionActionConfigs.map((action) => {
+        const button = document.createElement("button");
+        button.type = "button";
+        button.className = "hyewb-btn hyewb-btn-text hyewb-header-action-btn";
+        const text = action.text.trim();
+        button.textContent = text;
+        button.title = text;
+        button.setAttribute("aria-label", text);
+        button.style.display = "none";
+        const color = typeof action.color === "string" ? action.color.trim() : "";
+        if (color) {
+            button.style.backgroundColor = color;
+            button.style.borderColor = color;
+        }
+        const textColor = typeof action.textColor === "string" ? action.textColor.trim() : "";
+        if (textColor) {
+            button.style.color = textColor;
+        }
+        const borderColor = typeof action.borderColor === "string" ? action.borderColor.trim() : "";
+        if (borderColor) {
+            button.style.borderColor = borderColor;
+        }
+        headerActions.append(button);
+        return { action, button };
+    });
+    headerActions.append(fullscreenBtn);
+    header.append(title, headerActions);
     const toolbar = document.createElement("div");
     toolbar.className = "hyewb-row hyewb-top-control";
     const boldBtn = createButton("bold");
@@ -854,6 +897,41 @@ export function mountEditorWorkbench(container, options = {}) {
     const status = document.createElement("p");
     status.className = "hyewb-status";
     status.textContent = "已加载默认编辑器能力";
+    const debugEnabled = options.debug === true ||
+        (typeof options.debug === "object" &&
+            options.debug !== null &&
+            options.debug.enabled !== false);
+    const debugPrefix = typeof options.debug === "object" &&
+        options.debug !== null &&
+        options.debug.prefix
+        ? options.debug.prefix
+        : "[hyebook:workbench]";
+    const debugLog = (message) => {
+        if (!debugEnabled) {
+            return;
+        }
+        console.log(`${debugPrefix} ${message}`);
+    };
+    let lastDebugStatusMessage = "";
+    const flushDebugStatus = () => {
+        const nextMessage = String(status.textContent || "").trim();
+        if (!nextMessage || nextMessage === lastDebugStatusMessage) {
+            return;
+        }
+        lastDebugStatusMessage = nextMessage;
+        debugLog(nextMessage);
+    };
+    const statusObserver = debugEnabled && typeof MutationObserver !== "undefined"
+        ? new MutationObserver(() => {
+            flushDebugStatus();
+        })
+        : null;
+    statusObserver?.observe(status, {
+        childList: true,
+        characterData: true,
+        subtree: true,
+    });
+    flushDebugStatus();
     const uploadBackdrop = document.createElement("div");
     uploadBackdrop.className = "hyewb-upload-backdrop";
     const uploadDialog = document.createElement("div");
@@ -892,7 +970,7 @@ export function mountEditorWorkbench(container, options = {}) {
     const colorGrid = document.createElement("div");
     colorGrid.className = "hyewb-color-grid";
     colorPalette.append(colorGrid);
-    root.append(header, toolbar, pageRow, previewLayout, status, colorPalette, tablePicker, tableTools, tableRowDeleteBtn, tableMoveHandle, tableScaleHandle, tableColEdgeLayer, tableRowEdgeLayer, tableRowGapInsertBtn, tableColGapInsertBtn, tableDropIndicator, tableContextMenu, uploadBackdrop, previewNoteBackdrop, docxInput, previewSelectionToolbar);
+    root.append(header, toolbar, pageRow, previewLayout, colorPalette, tablePicker, tableTools, tableRowDeleteBtn, tableMoveHandle, tableScaleHandle, tableColEdgeLayer, tableRowEdgeLayer, tableRowGapInsertBtn, tableColGapInsertBtn, tableDropIndicator, tableContextMenu, uploadBackdrop, previewNoteBackdrop, docxInput, previewSelectionToolbar);
     container.innerHTML = "";
     root.append(floatingToolbar);
     container.append(root);
@@ -940,27 +1018,52 @@ export function mountEditorWorkbench(container, options = {}) {
     let fullscreenOverlay = null;
     let fullscreenAnchor = null;
     let bodyOverflowBeforeOverlay = null;
+    let htmlOverflowBeforeOverlay = null;
     let isOverlayFullscreen = false;
+    const fullscreenExitButtonText = typeof options.fullscreen?.exitButtonText === "string"
+        ? options.fullscreen.exitButtonText.trim()
+        : "";
     const setButtonIcon = (button, iconName) => {
-        button.innerHTML = "";
+        button.classList.remove("hyewb-btn-text");
+        button.textContent = "";
         button.append(createIconPlaceholder(iconName));
     };
+    const setButtonText = (button, text) => {
+        button.classList.add("hyewb-btn-text");
+        button.textContent = text;
+    };
     const isWorkbenchFullscreen = () => {
         return isOverlayFullscreen;
     };
     const updateFullscreenButtonState = () => {
         const isFullscreen = isWorkbenchFullscreen();
         setButtonActive(fullscreenBtn, isFullscreen);
-        setButtonIcon(fullscreenBtn, isFullscreen ? "fullscreen-exit" : "fullscreen-enter");
+        const shouldUseExitText = isFullscreen && fullscreenExitButtonText.length > 0;
+        if (shouldUseExitText) {
+            setButtonText(fullscreenBtn, fullscreenExitButtonText);
+        }
+        else {
+            setButtonIcon(fullscreenBtn, isFullscreen ? "fullscreen-exit" : "fullscreen-enter");
+        }
         const label = isFullscreen ? "保存并退出" : "全屏";
-        fullscreenBtn.title = label;
-        fullscreenBtn.setAttribute("aria-label", label);
+        const ariaLabel = shouldUseExitText ? fullscreenExitButtonText : label;
+        fullscreenBtn.title = ariaLabel;
+        fullscreenBtn.setAttribute("aria-label", ariaLabel);
         fullscreenBtn.style.display = isFullscreen ? "inline-flex" : "none";
+        extensionActionButtons.forEach(({ button }) => {
+            button.style.display = isFullscreen ? "inline-flex" : "none";
+        });
     };
     const updateShellViewportHeight = () => {
+        if (isWorkbenchFullscreen()) {
+            shell.style.height = "100%";
+            shell.style.maxHeight = "";
+            return;
+        }
+        shell.style.height = "";
         const viewportHeight = window.innerHeight || document.documentElement.clientHeight;
         const top = root.getBoundingClientRect().top;
-        const bottomPadding = isWorkbenchFullscreen() ? 16 : 24;
+        const bottomPadding = 24;
         const nextHeight = Math.max(320, Math.floor(viewportHeight - top - bottomPadding));
         shell.style.maxHeight = `${nextHeight}px`;
     };
@@ -1012,10 +1115,13 @@ export function mountEditorWorkbench(container, options = {}) {
         fullscreenOverlay.append(fullscreenOverlayLayer);
         fullscreenOverlayLayer.append(root);
         document.body.append(fullscreenOverlay);
+        htmlOverflowBeforeOverlay = document.documentElement.style.overflow;
+        document.documentElement.style.overflow = "hidden";
         bodyOverflowBeforeOverlay = document.body.style.overflow;
         document.body.style.overflow = "hidden";
         root.classList.add("hyewb-overlay-active");
         isOverlayFullscreen = true;
+        render();
         status.textContent = "已进入页面全屏编辑";
         syncWorkbenchLayoutAfterFullscreenChange();
     };
@@ -1037,10 +1143,15 @@ export function mountEditorWorkbench(container, options = {}) {
         fullscreenOverlay = null;
         root.classList.remove("hyewb-overlay-active");
         isOverlayFullscreen = false;
+        render();
         if (bodyOverflowBeforeOverlay !== null) {
             document.body.style.overflow = bodyOverflowBeforeOverlay;
             bodyOverflowBeforeOverlay = null;
         }
+        if (htmlOverflowBeforeOverlay !== null) {
+            document.documentElement.style.overflow = htmlOverflowBeforeOverlay;
+            htmlOverflowBeforeOverlay = null;
+        }
         syncWorkbenchLayoutAfterFullscreenChange();
     };
     const closeWorkbenchFullscreenAndSave = async () => {
@@ -1064,6 +1175,16 @@ export function mountEditorWorkbench(container, options = {}) {
             status.textContent = `保存失败：${errorMessage}`;
         }
     };
+    const getExtensionActionContext = () => {
+        syncEditorToDoc({ emitChange: false });
+        return {
+            getDocument: () => clone(state.doc),
+            isFullscreen: isWorkbenchFullscreen,
+            getMode: () => state.mode,
+            setMode,
+            closeFullscreenAndSave: closeWorkbenchFullscreenAndSave,
+        };
+    };
     const formatUploadProgress = (percent) => {
         const safe = Number.isFinite(percent) ? percent : 0;
         const clamped = Math.max(0, Math.min(100, safe));
@@ -3552,7 +3673,14 @@ export function mountEditorWorkbench(container, options = {}) {
             return Math.max(max, nextBottom);
         }, 0);
         const nextCanvasMinHeight = Math.max(420, Math.round(mediaBottom + 60));
-        canvas.style.minHeight = `${nextCanvasMinHeight}px`;
+        if (isWorkbenchFullscreen()) {
+            const shellHeight = Math.max(0, Math.round(shell.clientHeight));
+            const fullscreenCanvasMinHeight = Math.max(nextCanvasMinHeight, shellHeight);
+            canvas.style.minHeight = `${fullscreenCanvasMinHeight}px`;
+        }
+        else {
+            canvas.style.minHeight = `${nextCanvasMinHeight}px`;
+        }
         mediaStage.classList.toggle("preview", state.mode === "preview");
         mediaStage.innerHTML = "";
         mediaBlocks.forEach((item, index) => {
@@ -4619,6 +4747,28 @@ export function mountEditorWorkbench(container, options = {}) {
     fullscreenBtn.addEventListener("click", () => {
         void closeWorkbenchFullscreenAndSave();
     });
+    extensionActionButtons.forEach(({ action, button }) => {
+        button.addEventListener("click", (event) => {
+            if (!action.onClick) {
+                return;
+            }
+            try {
+                const result = action.onClick(getExtensionActionContext(), event);
+                void Promise.resolve(result).catch((error) => {
+                    const errorMessage = error instanceof Error && error.message
+                        ? error.message
+                        : "请稍后重试";
+                    status.textContent = `扩展按钮执行失败：${errorMessage}`;
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error && error.message
+                    ? error.message
+                    : "请稍后重试";
+                status.textContent = `扩展按钮执行失败：${errorMessage}`;
+            }
+        });
+    });
     tableAddBtn.addEventListener("mousedown", preserveSelectionForInputControl);
     videoAddBtn.addEventListener("mousedown", preserveSelectionForInputControl);
     videoAddBtn.addEventListener("click", () => {
@@ -4704,6 +4854,7 @@ export function mountEditorWorkbench(container, options = {}) {
     emitDocumentChange();
     return {
         destroy: () => {
+            statusObserver?.disconnect();
             closeWorkbenchFullscreen();
             hideTablePicker();
             hideTableTools();

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

@@ -1,4 +1,4 @@
-import { EditorEngine, PlayerEngine, type EditorWorkbenchHandle, type EditorWorkbenchOptions, type EbookDoc, type PlayerDataProvider, type PlayerEngineOptions } from "@hyebook/core";
+import { EBookPlayer, EditorEngine, PlayerEngine, type EBookPlayerOptions, type EditorWorkbenchHandle, type EditorWorkbenchOptions, type EbookDoc, type PlayerDataProvider, type PlayerEngineOptions } from "@hyebook/core";
 export interface Vue3EditorAdapterOptions {
     initialDoc: EbookDoc;
     onDocumentChange?: (doc: EbookDoc) => void;
@@ -7,11 +7,14 @@ export interface Vue3PlayerAdapterOptions {
     provider: PlayerDataProvider;
     engineOptions?: PlayerEngineOptions;
 }
+export interface Vue3EBookPlayerAdapterOptions extends EBookPlayerOptions {
+}
 export interface Vue3EditorWorkbenchOptions extends EditorWorkbenchOptions {
 }
 export interface Vue3EditorWorkbenchHandle extends EditorWorkbenchHandle {
 }
 export declare function createVue3EditorAdapter(options: Vue3EditorAdapterOptions): EditorEngine;
 export declare function createVue3PlayerAdapter(options: Vue3PlayerAdapterOptions): PlayerEngine;
+export declare function createEBookPlayerAdapter(container: HTMLElement, options: Vue3EBookPlayerAdapterOptions): EBookPlayer;
 export declare function mountVue3EditorWorkbench(container: HTMLElement, options?: Vue3EditorWorkbenchOptions): Vue3EditorWorkbenchHandle;
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,KAAK,kBAAkB,EAEvB,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,6BAA8B,SAAQ,kBAAkB;CAAG;AAE5E,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,EAAE,6BAA6B,GACrC,WAAW,CAEb;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAE3B"}

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

@@ -1,4 +1,4 @@
-import { EditorEngine, PlayerEngine, mountEditorWorkbench, } from "@hyebook/core";
+import { EBookPlayer, EditorEngine, PlayerEngine, mountEditorWorkbench, } from "@hyebook/core";
 export function createVue3EditorAdapter(options) {
     const engine = new EditorEngine(options.initialDoc);
     options.onDocumentChange?.(engine.getDocument());
@@ -7,6 +7,9 @@ export function createVue3EditorAdapter(options) {
 export function createVue3PlayerAdapter(options) {
     return new PlayerEngine(options.provider, options.engineOptions);
 }
+export function createEBookPlayerAdapter(container, options) {
+    return new EBookPlayer(container, options);
+}
 export function mountVue3EditorWorkbench(container, options = {}) {
     return mountEditorWorkbench(container, options);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyebook/vue3-adapter",
-  "version": "2.2.7",
+  "version": "2.3.0",
   "description": "Vue3 adapter for hy-ebook core",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "dist"
   ],
   "dependencies": {
-    "@hyebook/core": "^2.2.7"
+    "@hyebook/core": "^2.3.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",