@d-i-t-a/reader 3.0.0-alpha.7 → 3.0.0-alpha.8

package/dist/esm/index.js

@@ -12860,6 +12860,69 @@ var require_debounce = __commonJS({
   }
 });
 
+// src/utils/Events.ts
+var ReaderEvent;
+var init_Events = __esm({
+  "src/utils/Events.ts"() {
+    init_polyfills();
+    ReaderEvent = {
+      // Resource lifecycle
+      ResourceReady: "resource.ready",
+      ResourceStart: "resource.start",
+      ResourceEnd: "resource.end",
+      ResourceFits: "resource.fits",
+      ResourceError: "resource.error",
+      // Navigation info
+      Direction: "direction",
+      ChapterInfo: "chapterinfo",
+      PositionInfo: "positioninfo",
+      LocationChanged: "location.changed",
+      // User interaction
+      Click: "click",
+      KeyDown: "keydown",
+      // Error
+      Error: "error",
+      // TTS / Read Aloud
+      ReadAloudStarted: "readaloud.started",
+      ReadAloudStopped: "readaloud.stopped",
+      ReadAloudPaused: "readaloud.paused",
+      ReadAloudResumed: "readaloud.resumed",
+      ReadAloudFinished: "readaloud.finished",
+      // Media Overlays / Read Along
+      ReadAlongStarted: "readalong.started",
+      ReadAlongStopped: "readalong.stopped",
+      ReadAlongPaused: "readalong.paused",
+      ReadAlongResumed: "readalong.resumed",
+      ReadAlongFinished: "readalong.finished",
+      // Bookmarks
+      BookmarkCreated: "bookmark.created",
+      BookmarkDeleted: "bookmark.deleted",
+      // Annotations
+      AnnotationCreated: "annotation.created",
+      AnnotationDeleted: "annotation.deleted",
+      AnnotationUpdated: "annotation.updated",
+      AnnotationSelected: "annotation.selected",
+      AnnotationCommentAdded: "annotation.comment.added",
+      // Text selection / Toolbox
+      ToolboxOpened: "toolbox.opened",
+      ToolboxClosed: "toolbox.closed",
+      TextSelected: "text.selected",
+      // Definitions
+      DefinitionSuccess: "definition.success",
+      DefinitionClick: "definition.click",
+      DefinitionVisible: "definition.visible",
+      // Citation
+      CitationCreated: "citation.created",
+      CitationFailed: "citation.failed",
+      // Content Protection
+      InspectDetected: "inspect.detected",
+      // Consumption tracking
+      ActionTracked: "consumption.action",
+      IdleSince: "consumption.idle"
+    };
+  }
+});
+
 // node_modules/cssesc/cssesc.js
 var require_cssesc = __commonJS({
   "node_modules/cssesc/cssesc.js"(exports, module) {
@@ -65355,6 +65418,7 @@ var init_PDFNavigator = __esm({
     init_polyfills();
     import_debounce8 = __toESM(require_debounce());
     init_eventemitter3();
+    init_Events();
     init_pdf();
     init_pdf_viewer();
     init_EventHandler();
@@ -65476,10 +65540,14 @@ var init_PDFNavigator = __esm({
             this.saveLastReadingPosition();
             if (this.atStart()) {
               this.api?.resourceAtStart?.();
-              this.emit("resource.start");
+              this.emit(ReaderEvent.ResourceStart, {
+                href: this.publication.readingOrder[0]?.href
+              });
             } else if (this.atEnd()) {
               this.api?.resourceAtEnd?.();
-              this.emit("resource.end");
+              this.emit(ReaderEvent.ResourceEnd, {
+                href: this.publication.readingOrder[0]?.href
+              });
             }
           }
         );
@@ -65489,7 +65557,9 @@ var init_PDFNavigator = __esm({
             this._numPages = pagesCount;
             this.hideLoading();
             this.api?.resourceReady?.();
-            this.emit("resource.ready");
+            this.emit(ReaderEvent.ResourceReady, {
+              href: this.publication.readingOrder[0]?.href
+            });
             if (!this._positionRestored) {
               this._positionRestored = true;
               await this.restoreLastReadingPosition();
@@ -65590,7 +65660,7 @@ var init_PDFNavigator = __esm({
           const error = err instanceof Error ? err : new Error(String(err));
           console.error("PDFNavigator: failed to load document", url, error);
           this.api?.onError?.(error);
-          this.emit("resource.error", error);
+          this.emit(ReaderEvent.ResourceError, error);
         }
       }
       // ── Navigator interface ────────────────────────────────────────────────────
@@ -66027,6 +66097,7 @@ var init_PDFNavigator = __esm({
         } else {
           this.annotator.saveLastReadingPosition(position);
         }
+        this.emit(ReaderEvent.LocationChanged, position);
       }
       async restoreLastReadingPosition() {
         if (this.initialLastReadingPosition) {
@@ -68738,7 +68809,7 @@ var Publication = class _Publication {
   // ── Layout detection ─────────────────────────────────────────
   get isFixedLayout() {
     if (this.metadata?.layout === "fixed") return true;
-    const renditionLayout = this.metadata?.otherMetadata?.["rendition:layout"];
+    const renditionLayout = this.metadata?.otherMetadata?.["rendition:layout"] ?? this.metadata?.otherMetadata?.rendition?.layout;
     return renditionLayout === "pre-paginated" || renditionLayout === "fixed";
   }
   get isReflowable() {
@@ -71612,6 +71683,9 @@ var import_debounce2 = __toESM(require_debounce());
 // src/modules/highlight/common/highlight.ts
 init_polyfills();
 
+// src/modules/highlight/TextHighlighter.ts
+init_Events();
+
 // src/modules/highlight/common/rect-utils.ts
 init_polyfills();
 var import_loglevel3 = __toESM(require_loglevel());
@@ -72578,18 +72652,25 @@ var TextHighlighter = class _TextHighlighter {
       if (!this.isSelectionMenuOpen) {
         this.isSelectionMenuOpen = true;
         if (this.api?.selectionMenuOpen) this.api?.selectionMenuOpen();
-        this.navigator.emit("toolbox.opened", "opened");
+        const doc = this.navigator.iframes[0].contentDocument;
+        const sel = doc ? this.dom(doc.body)?.getSelection() : null;
+        const text = sel && !sel.isCollapsed ? sel.toString() : void 0;
+        this.navigator.emit(ReaderEvent.ToolboxOpened, "opened", { text });
+        if (text && sel) {
+          if (this.api?.selection) this.api.selection(text, sel);
+          this.navigator.emit(ReaderEvent.TextSelected, { text, selection: sel });
+        }
       }
     }, 100);
     this.selectionMenuClosed = (0, import_debounce2.default)(() => {
       if (this.isSelectionMenuOpen) {
         this.isSelectionMenuOpen = false;
         if (this.api?.selectionMenuClose) this.api?.selectionMenuClose();
-        this.navigator.emit("toolbox.closed", "closed");
+        this.navigator.emit(ReaderEvent.ToolboxClosed, "closed");
       }
     }, 100);
-    this.selection = (0, import_debounce2.default)((text, selection) => {
-      if (this.api?.selection) this.api?.selection(text, selection);
+    /** @deprecated Selection callback now fires from selectionMenuOpened */
+    this.selection = (0, import_debounce2.default)((_text, _selection) => {
     }, 100);
     this.getScrollingElement = (doc) => {
       if (doc?.scrollingElement) {
@@ -73569,6 +73650,10 @@ var TextHighlighter = class _TextHighlighter {
                             if (menuItem?.note) {
                               if (anno.highlight) {
                                 self3.navigator.annotationModule?.api?.addCommentToAnnotation(anno).then((result) => {
+                                  self3.navigator.emit(
+                                    ReaderEvent.AnnotationCommentAdded,
+                                    result
+                                  );
                                   self3.navigator.annotationModule?.updateAnnotation(result).then(async () => {
                                     import_loglevel5.default.log(
                                       "update highlight " + result.id
@@ -74361,6 +74446,7 @@ var TextHighlighter = class _TextHighlighter {
         if (payload.highlight.type === 0 /* Annotation */) {
           this.navigator.annotationModule?.api?.selectedAnnotation(anno).then(async () => {
           });
+          this.navigator.emit(ReaderEvent.AnnotationSelected, anno);
         }
         if (anno?.id) {
           import_loglevel5.default.log("selected highlight " + anno.id);
@@ -74372,6 +74458,10 @@ var TextHighlighter = class _TextHighlighter {
             if (getComputedStyle(toolbox).display === "none") {
               let noteH = function() {
                 self2.navigator.annotationModule?.api?.addCommentToAnnotation(anno).then((result) => {
+                  self2.navigator.emit(
+                    ReaderEvent.AnnotationCommentAdded,
+                    result
+                  );
                   self2.navigator.annotationModule?.updateAnnotation(result).then(async () => {
                     import_loglevel5.default.log("update highlight " + result.id);
                     if (toolbox) {
@@ -74474,7 +74564,11 @@ var TextHighlighter = class _TextHighlighter {
               lodash.omit(result, "callbacks"),
               lodash.omit(foundHighlight, "definition")
             );
-            this.navigator.emit("definition.click", result, foundHighlight);
+            this.navigator.emit(
+              ReaderEvent.DefinitionClick,
+              result,
+              foundHighlight
+            );
           }
         }
       }
@@ -75041,6 +75135,7 @@ var TextHighlighter = class _TextHighlighter {
           );
           self2.navigator.annotationModule?.api?.selectedAnnotation(anno).then(async () => {
           });
+          self2.navigator.emit(ReaderEvent.AnnotationSelected, anno);
         } else if (self2.navigator.rights.enableBookmarks) {
           anno = await self2.navigator.bookmarkModule?.getAnnotationByID(
             highlight.id
@@ -75259,6 +75354,7 @@ var import_loglevel8 = __toESM(require_loglevel());
 
 // src/modules/consumption/ConsumptionModule.ts
 init_polyfills();
+init_Events();
 var import_loglevel7 = __toESM(require_loglevel());
 var ConsumptionModule = class {
   constructor(publication, properties, api) {
@@ -75309,6 +75405,7 @@ var ConsumptionModule = class {
   }
   trackAction(locator, action) {
     this.api?.actionTracked(locator, action);
+    this.navigator.emit(ReaderEvent.ActionTracked, { locator, action });
   }
   startReadingSession(locator) {
     if (this.firstReadingLocator && this.lastReadingLocator) {
@@ -75400,6 +75497,7 @@ var ConsumptionModule = class {
     this.currSeconds++;
     if (this.currSeconds === this.properties.idleTimeout) {
       this.api?.idleSince(this.currSeconds);
+      this.navigator.emit(ReaderEvent.IdleSince, this.currSeconds);
       if (this.startResearchTimer !== void 0) {
         this.updateResearchSession();
       } else {
@@ -75421,6 +75519,7 @@ var ConsumptionModule = class {
 };
 
 // src/modules/AnnotationModule.ts
+init_Events();
 var AnnotationModule = class _AnnotationModule {
   constructor(annotator, rights, publication, initialAnnotations, properties, highlighter, api, headerMenu) {
     this.hide = findElement(
@@ -75631,9 +75730,11 @@ var AnnotationModule = class _AnnotationModule {
   }
   async deleteAnnotation(highlight) {
     await this.deleteLocalHighlight(highlight.id);
+    this.navigator.emit(ReaderEvent.AnnotationDeleted, highlight);
   }
   async addAnnotation(highlight) {
     await this.annotator?.saveAnnotation(highlight);
+    this.navigator.emit(ReaderEvent.AnnotationCreated, highlight);
     await this.showHighlights();
     await this.drawHighlights();
   }
@@ -75641,27 +75742,33 @@ var AnnotationModule = class _AnnotationModule {
     if (this.api?.deleteAnnotation) {
       this.api?.deleteAnnotation(highlight).then(async () => {
         this.deleteLocalHighlight(highlight.id);
+        this.navigator.emit(ReaderEvent.AnnotationDeleted, highlight);
       });
     } else {
       this.deleteLocalHighlight(highlight.id);
+      this.navigator.emit(ReaderEvent.AnnotationDeleted, highlight);
     }
   }
   async deleteSelectedHighlight(highlight) {
     if (this.api?.deleteAnnotation) {
       this.api.deleteAnnotation(highlight).then(async () => {
         this.deleteLocalHighlight(highlight.id);
+        this.navigator.emit(ReaderEvent.AnnotationDeleted, highlight);
       });
     } else {
       this.deleteLocalHighlight(highlight.id);
+      this.navigator.emit(ReaderEvent.AnnotationDeleted, highlight);
     }
   }
   async updateAnnotation(highlight) {
     if (this.api?.updateAnnotation) {
       this.api.updateAnnotation(highlight).then(async () => {
         this.updateLocalHighlight(highlight);
+        this.navigator.emit(ReaderEvent.AnnotationUpdated, highlight);
       });
     } else {
       this.updateLocalHighlight(highlight);
+      this.navigator.emit(ReaderEvent.AnnotationUpdated, highlight);
     }
   }
   async saveAnnotation(highlight) {
@@ -75739,6 +75846,7 @@ var AnnotationModule = class _AnnotationModule {
             try {
               let result = await this.api.addAnnotation(annotation);
               const saved = await this.annotator.saveAnnotation(result);
+              this.navigator.emit(ReaderEvent.AnnotationCreated, saved);
               await this.showHighlights();
               await this.drawHighlights();
               return new Promise((resolve) => resolve(saved));
@@ -75748,6 +75856,7 @@ var AnnotationModule = class _AnnotationModule {
             }
           } else {
             const saved = await this.annotator.saveAnnotation(annotation);
+            this.navigator.emit(ReaderEvent.AnnotationCreated, saved);
             await this.showHighlights();
             await this.drawHighlights();
             return new Promise((resolve) => resolve(saved));
@@ -76248,6 +76357,7 @@ init_HTMLUtilities();
 init_EventHandler();
 init_IconLib();
 var import_loglevel9 = __toESM(require_loglevel());
+init_Events();
 var BookmarkModule = class _BookmarkModule {
   static async create(config2) {
     const module = new this(
@@ -76333,12 +76443,14 @@ var BookmarkModule = class _BookmarkModule {
         await this.api?.deleteBookmark(bookmark);
         let deleted = await this.annotator.deleteBookmark(bookmark);
         import_loglevel9.default.log("Bookmark deleted " + JSON.stringify(deleted));
+        this.navigator.emit(ReaderEvent.BookmarkDeleted, bookmark);
         await this.showBookmarks();
         await this.drawBookmarks();
         return deleted;
       } else {
         let deleted = await this.annotator.deleteBookmark(bookmark);
         import_loglevel9.default.log("Bookmark deleted " + JSON.stringify(deleted));
+        this.navigator.emit(ReaderEvent.BookmarkDeleted, bookmark);
         await this.showBookmarks();
         await this.drawBookmarks();
         return deleted;
@@ -76413,12 +76525,14 @@ var BookmarkModule = class _BookmarkModule {
             import_loglevel9.default.log(bookmark);
             let saved = this.annotator.saveBookmark(bookmark);
             import_loglevel9.default.log("Bookmark added " + JSON.stringify(saved));
+            this.navigator.emit(ReaderEvent.BookmarkCreated, bookmark);
             this.showBookmarks();
             await this.drawBookmarks();
             return saved;
           } else {
             let saved = this.annotator.saveBookmark(bookmark);
             import_loglevel9.default.log("Bookmark added " + JSON.stringify(saved));
+            this.navigator.emit(ReaderEvent.BookmarkCreated, bookmark);
             this.showBookmarks();
             await this.drawBookmarks();
             return saved;
@@ -76613,11 +76727,13 @@ var BookmarkModule = class _BookmarkModule {
           if (this.api?.addBookmark) {
             let result = await this.api.addBookmark(annotation);
             const saved = await this.annotator.saveAnnotation(result);
+            this.navigator.emit(ReaderEvent.BookmarkCreated, annotation);
             await this.showBookmarks();
             await this.drawBookmarks();
             return new Promise((resolve) => resolve(saved));
           } else {
             const saved = await this.annotator.saveAnnotation(annotation);
+            this.navigator.emit(ReaderEvent.BookmarkCreated, annotation);
             await this.showBookmarks();
             await this.drawBookmarks();
             return new Promise((resolve) => resolve(saved));
@@ -76907,6 +77023,7 @@ var BookmarkModule = class _BookmarkModule {
 
 // src/modules/mediaoverlays/MediaOverlayModule.ts
 init_polyfills();
+init_Events();
 
 // src/model/v3/MediaOverlayNode.ts
 init_polyfills();
@@ -77352,6 +77469,7 @@ var MediaOverlayModule = class {
       config2.settings,
       config2
     );
+    mediaOverlay.api = config2.api;
     mediaOverlay.start();
     return mediaOverlay;
   }
@@ -77422,10 +77540,28 @@ var MediaOverlayModule = class {
         await this.playLink();
       } else {
         if (this.settings.autoTurn && this.settings.playing) {
-          if (this.audioElement) {
-            await this.audioElement.pause();
+          const currentLink = this.currentLinks[this.currentLinkIndex];
+          const nextLink = currentLink ? this.publication.getNextSpineItem(
+            this.publication.getAbsoluteHref(currentLink.href)
+          ) : void 0;
+          if (nextLink) {
+            if (this.audioElement) {
+              await this.audioElement.pause();
+            }
+            this.navigator.nextResource();
+          } else {
+            await this.stopReadAloud();
+            if (this.api?.finished) this.api.finished();
+            this.navigator.emit(ReaderEvent.ReadAlongFinished, "finished", {
+              href: this.currentLinks[this.currentLinkIndex]?.href
+            });
           }
-          this.navigator.nextResource();
+        } else if (this.settings.playing) {
+          await this.stopReadAloud();
+          if (this.api?.stopped) this.api.stopped();
+          this.navigator.emit(ReaderEvent.ReadAlongStopped, "stopped", {
+            href: this.currentLinks[this.currentLinkIndex]?.href
+          });
         } else {
           await this.stopReadAloud();
         }
@@ -77538,6 +77674,10 @@ var MediaOverlayModule = class {
       if (this.play) this.play.style.display = "none";
       if (this.pause) this.pause.style.removeProperty("display");
       this.bindClickHandler();
+      if (this.api?.started) this.api.started();
+      this.navigator.emit(ReaderEvent.ReadAlongStarted, "started", {
+        href: this.currentLinks[this.currentLinkIndex]?.href
+      });
     }
   }
   async stopReadAloud() {
@@ -77555,6 +77695,10 @@ var MediaOverlayModule = class {
       this.audioElement.pause();
       if (this.play) this.play.style.removeProperty("display");
       if (this.pause) this.pause.style.display = "none";
+      if (this.api?.paused) this.api.paused();
+      this.navigator.emit(ReaderEvent.ReadAlongPaused, "paused", {
+        href: this.currentLinks[this.currentLinkIndex]?.href
+      });
     }
   }
   async resumeReadAloud() {
@@ -77563,6 +77707,10 @@ var MediaOverlayModule = class {
       await this.audioElement.play();
       if (this.play) this.play.style.display = "none";
       if (this.pause) this.pause.style.removeProperty("display");
+      if (this.api?.resumed) this.api.resumed();
+      this.navigator.emit(ReaderEvent.ReadAlongResumed, "resumed", {
+        href: this.currentLinks[this.currentLinkIndex]?.href
+      });
     }
   }
   findDepthFirstTextAudioPair(textHref, mo, textFragmentIDChain) {
@@ -77673,8 +77821,25 @@ var MediaOverlayModule = class {
         } else {
           this.audioElement.pause();
           if (this.settings.autoTurn && this.settings.playing) {
-            this.audioElement.pause();
-            this.navigator.nextResource();
+            const currentLink = this.currentLinks[this.currentLinkIndex];
+            const nextLink = currentLink ? this.publication.getNextSpineItem(
+              this.publication.getAbsoluteHref(currentLink.href)
+            ) : void 0;
+            if (nextLink) {
+              this.navigator.nextResource();
+            } else {
+              this.stopReadAloud();
+              if (this.api?.finished) this.api.finished();
+              this.navigator.emit(ReaderEvent.ReadAlongFinished, "finished", {
+                href: this.currentLinks[this.currentLinkIndex]?.href
+              });
+            }
+          } else if (this.settings.playing) {
+            this.stopReadAloud();
+            if (this.api?.stopped) this.api.stopped();
+            this.navigator.emit(ReaderEvent.ReadAlongStopped, "stopped", {
+              href: this.currentLinks[this.currentLinkIndex]?.href
+            });
           } else {
             this.stopReadAloud();
           }
@@ -81806,6 +81971,7 @@ var TTSSettings = class {
 
 // src/navigator/IFrameNavigator.ts
 init_polyfills();
+init_Events();
 init_EventHandler();
 init_HTMLUtilities();
 init_HTMLTemplates();
@@ -82284,6 +82450,7 @@ var PageBreakModule = class {
 
 // src/modules/TTS/TTSModule2.ts
 init_polyfills();
+init_Events();
 init_HTMLUtilities();
 init_EventHandler();
 var import_sanitize_html2 = __toESM(require_sanitize_html());
@@ -82454,9 +82621,11 @@ var TTSModule2 = class {
     });
   }
   cancel(api = true) {
-    if (api) {
+    if (api && this.speaking) {
       if (this.api?.stopped) this.api?.stopped();
-      this.navigator.emit("readaloud.stopped", "stopped");
+      this.navigator.emit(ReaderEvent.ReadAloudStopped, "stopped", {
+        locator: this.navigator.currentLocator()
+      });
     }
     this.userScrolled = false;
     this.speaking = false;
@@ -82475,7 +82644,9 @@ var TTSModule2 = class {
       }
     }
     if (this.api?.started) this.api?.started();
-    this.navigator.emit("readaloud.started", "started");
+    this.navigator.emit(ReaderEvent.ReadAloudStarted, "started", {
+      locator: this.navigator.currentLocator()
+    });
     const self2 = this;
     this.userScrolled = false;
     this.cancel(false);
@@ -82644,14 +82815,18 @@ var TTSModule2 = class {
               import_loglevel18.default.log("utterance ended");
               self2.highlighter.doneSpeaking();
               self2.api?.finished();
-              self2.navigator.emit("readaloud.finished", "finished");
+              self2.navigator.emit(ReaderEvent.ReadAloudFinished, "finished", {
+                locator: this.navigator.currentLocator()
+              });
             }
           }
         } else {
           import_loglevel18.default.log("utterance ended");
           self2.highlighter.doneSpeaking();
           self2.api?.finished();
-          self2.navigator.emit("readaloud.finished", "finished");
+          self2.navigator.emit(ReaderEvent.ReadAloudFinished, "finished", {
+            locator: this.navigator.currentLocator()
+          });
         }
       };
     }
@@ -82758,7 +82933,9 @@ var TTSModule2 = class {
     this.scrollPartial = true;
     this.cancel(false);
     if (this.api?.started) this.api?.started();
-    this.navigator.emit("readaloud.started", "started");
+    this.navigator.emit(ReaderEvent.ReadAloudStarted, "started", {
+      locator: this.navigator.currentLocator()
+    });
     let self2 = this;
     let iframe = document.querySelector(
       "main#iframe-wrapper iframe"
@@ -82818,7 +82995,9 @@ var TTSModule2 = class {
   speakPause() {
     if (window.speechSynthesis.speaking) {
       if (this.api?.paused) this.api?.paused();
-      this.navigator.emit("readaloud.paused", "paused");
+      this.navigator.emit(ReaderEvent.ReadAloudPaused, "paused", {
+        locator: this.navigator.currentLocator()
+      });
       this.userScrolled = false;
       window.speechSynthesis.pause();
       this.speaking = false;
@@ -82831,7 +83010,9 @@ var TTSModule2 = class {
   speakResume() {
     if (window.speechSynthesis.speaking) {
       if (this.api?.resumed) this.api?.resumed();
-      this.navigator.emit("readaloud.resumed", "resumed");
+      this.navigator.emit(ReaderEvent.ReadAloudResumed, "resumed", {
+        locator: this.navigator.currentLocator()
+      });
       this.userScrolled = false;
       window.speechSynthesis.resume();
       this.speaking = true;
@@ -83269,6 +83450,7 @@ function getTtsQueueItemRefText(obj) {
 // src/modules/search/DefinitionsModule.ts
 init_polyfills();
 var lodash3 = __toESM(require_lodash());
+init_Events();
 var import_debounce6 = __toESM(require_debounce());
 var import_loglevel19 = __toESM(require_loglevel());
 var DefinitionsModule = class {
@@ -83361,7 +83543,9 @@ var DefinitionsModule = class {
     await this.searchAndPaint(item, async (result) => {
       if (this.api?.success) {
         this.api?.success(lodash3.omit(item, "callbacks"), result);
-        this.navigator.emit("definition.success", result);
+        if (result && result.length > 0) {
+          this.navigator.emit(ReaderEvent.DefinitionSuccess, result);
+        }
         if (this.api?.visible) {
           result.forEach((highlight) => {
             let highlightParent = this.navigator.iframes[0].contentDocument?.querySelector(
@@ -83378,7 +83562,11 @@ var DefinitionsModule = class {
                       lodash3.omit(item, "callbacks"),
                       lodash3.omit(highlight, "definition")
                     );
-                    this.navigator.emit("definition.visible", item, highlight);
+                    this.navigator.emit(
+                      ReaderEvent.DefinitionVisible,
+                      item,
+                      highlight
+                    );
                   }
                 });
               },
@@ -84115,6 +84303,7 @@ var HistoryModule = class {
 // src/modules/citation/CitationModule.ts
 init_polyfills();
 var import_loglevel22 = __toESM(require_loglevel());
+init_Events();
 var CitationStyle = /* @__PURE__ */ ((CitationStyle2) => {
   CitationStyle2[CitationStyle2["Chicago"] = 0] = "Chicago";
   CitationStyle2[CitationStyle2["MLA"] = 1] = "MLA";
@@ -84160,7 +84349,13 @@ var CitationModule = class {
       tmp.innerHTML = textToClipboard;
       const plainText = tmp.textContent ?? tmp.innerText ?? textToClipboard;
       navigator.clipboard.writeText(plainText).then(
-        () => this.api?.citationCreated("The text was copied to the clipboard!"),
+        () => {
+          this.api?.citationCreated("The text was copied to the clipboard!");
+          this.navigator.emit(
+            ReaderEvent.CitationCreated,
+            "The text was copied to the clipboard!"
+          );
+        },
         () => this.legacyCopyToClipboard(textToClipboard)
       );
     } else {
@@ -84187,8 +84382,16 @@ var CitationModule = class {
     document.body.removeChild(forExecElement);
     if (success) {
       this.api?.citationCreated("The text was copied to the clipboard!");
+      this.navigator.emit(
+        ReaderEvent.CitationCreated,
+        "The text was copied to the clipboard!"
+      );
     } else {
       this.api?.citationFailed("Your browser doesn't allow clipboard access!");
+      this.navigator.emit(
+        ReaderEvent.CitationFailed,
+        "Your browser doesn't allow clipboard access!"
+      );
     }
   }
   selectContent(element) {
@@ -84477,13 +84680,19 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
     this.checkResourcePosition = (0, import_debounce7.default)(() => {
       if (this.view?.atStart() && this.view?.atEnd()) {
         if (this.api?.resourceFitsScreen) this.api?.resourceFitsScreen();
-        this.emit("resource.fits");
+        this.emit(ReaderEvent.ResourceFits, {
+          href: this.currentChapterLink.href
+        });
       } else if (this.view?.atEnd()) {
         if (this.api?.resourceAtEnd) this.api?.resourceAtEnd();
-        this.emit("resource.end");
+        this.emit(ReaderEvent.ResourceEnd, {
+          href: this.currentChapterLink.href
+        });
       } else if (this.view?.atStart()) {
         if (this.api?.resourceAtStart) this.api?.resourceAtStart();
-        this.emit("resource.start");
+        this.emit(ReaderEvent.ResourceStart, {
+          href: this.currentChapterLink.href
+        });
       }
     }, 200);
     this.highlighter = highlighter;
@@ -84644,7 +84853,7 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
       if (dir === "ltr") this.spreads.style.flexDirection = "row";
       this.keyboardEventHandler.rtl = dir === "rtl";
       if (this.api?.direction) this.api?.direction(dir);
-      this.emit("direction", dir);
+      this.emit(ReaderEvent.Direction, dir);
     }
   }
   async start(mainElement, headerMenu, footerMenu) {
@@ -85421,12 +85630,12 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
           this.chapterTitle.innerHTML = "(" + this.currentChapterLink.title + ")";
         if (this.api?.chapterInfo)
           this.api.chapterInfo(this.currentChapterLink.title);
-        this.emit("chapterinfo", this.currentChapterLink.title);
+        this.emit(ReaderEvent.ChapterInfo, this.currentChapterLink.title);
       } else {
         if (this.chapterTitle)
           this.chapterTitle.innerHTML = "(Current Chapter)";
         if (this.api?.chapterInfo) this.api.chapterInfo(void 0);
-        this.emit("chapterinfo", void 0);
+        this.emit(ReaderEvent.ChapterInfo, void 0);
       }
       await this.injectInjectablesIntoIframeHead(iframe);
       if (this.view?.layout !== "fixed" && this.highlighter !== void 0) {
@@ -85598,6 +85807,7 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
     if (this.api?.onError) {
       const trueError = e7 instanceof Error ? e7 : typeof e7 === "string" ? new Error(e7) : new Error("An unknown error occurred in the IFrameNavigator.");
       this.api.onError(trueError);
+      this.emit(ReaderEvent.Error, trueError);
     } else {
       if (this.errorMessage) this.errorMessage.style.display = "block";
       if (this.isLoading) {
@@ -86058,7 +86268,11 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
   }
   stopReadAlong() {
     if (this.rights.enableMediaOverlays && this.mediaOverlayModule !== void 0 && this.hasMediaOverlays) {
+      const wasPlaying = this.mediaOverlayModule.settings.playing;
       this.mediaOverlayModule?.stopReadAloud();
+      if (wasPlaying) {
+        this.emit(ReaderEvent.ReadAlongStopped, "stopped");
+      }
     }
   }
   pauseReadAloud() {
@@ -86294,7 +86508,7 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
   }
   handleClickThrough(event) {
     if (this.api?.clickThrough) this.api?.clickThrough(event);
-    this.emit("click", event);
+    this.emit(ReaderEvent.Click, event);
   }
   handleInternalLink(event) {
     const element = event.target;
@@ -86493,7 +86707,7 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
           if (this.api?.positionInfo) {
             this.api.positionInfo(locator);
           }
-          this.emit("positioninfo", locator);
+          this.emit(ReaderEvent.PositionInfo, locator);
         }
       } else {
         if (this.chapterPosition) this.chapterPosition.innerHTML = "";
@@ -86577,7 +86791,7 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
   }
   handleKeydownFallthrough(event) {
     if (this.api?.keydownFallthrough) this.api?.keydownFallthrough(event);
-    this.emit("keydown", event);
+    this.emit(ReaderEvent.KeyDown, event);
   }
   hideView() {
     if (this.view?.layout !== "fixed") {
@@ -86737,12 +86951,12 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
             this.chapterTitle.innerHTML = "(" + this.currentChapterLink.title + ")";
           if (this.api?.chapterInfo)
             this.api.chapterInfo(this.currentChapterLink.title);
-          this.emit("chapterinfo", this.currentChapterLink.title);
+          this.emit(ReaderEvent.ChapterInfo, this.currentChapterLink.title);
         } else {
           if (this.chapterTitle)
             this.chapterTitle.innerHTML = "(Current Chapter)";
           if (this.api?.chapterInfo) this.api.chapterInfo(void 0);
-          this.emit("chapterinfo", void 0);
+          this.emit(ReaderEvent.ChapterInfo, void 0);
         }
         await this.updatePositionInfo();
       } else {
@@ -86801,7 +87015,9 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
           if (this.previousChapterTopAnchorElement)
             this.previousChapterTopAnchorElement.style.display = "none";
           if (this.api?.resourceFitsScreen) this.api?.resourceFitsScreen();
-          this.emit("resource.fits");
+          this.emit(ReaderEvent.ResourceFits, {
+            href: this.currentChapterLink.href
+          });
         } else {
           this.settings.isPaginated().then((paginated) => {
             if (!paginated) {
@@ -86888,17 +87104,25 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
         this.view?.padOddColumns?.();
         if (this.view?.atStart() && this.view?.atEnd()) {
           if (this.api?.resourceFitsScreen) this.api?.resourceFitsScreen();
-          this.emit("resource.fits");
+          this.emit(ReaderEvent.ResourceFits, {
+            href: this.currentChapterLink.href
+          });
         } else if (this.view?.atEnd()) {
           if (this.api?.resourceAtEnd) this.api?.resourceAtEnd();
-          this.emit("resource.end");
+          this.emit(ReaderEvent.ResourceEnd, {
+            href: this.currentChapterLink.href
+          });
         } else if (this.view?.atStart()) {
           if (this.api?.resourceAtStart) this.api?.resourceAtStart();
-          this.emit("resource.start");
+          this.emit(ReaderEvent.ResourceStart, {
+            href: this.currentChapterLink.href
+          });
         }
       }
       if (this.api?.resourceReady) this.api?.resourceReady();
-      this.emit("resource.ready");
+      this.emit(ReaderEvent.ResourceReady, {
+        href: this.currentChapterLink.href
+      });
     }, 150);
   }
   saveCurrentReadingPosition() {
@@ -86967,6 +87191,7 @@ var IFrameNavigator = class _IFrameNavigator extends eventemitter3_default {
             import_loglevel23.default.log("save last reading position", position);
             this.annotator.saveLastReadingPosition(position);
           }
+          this.emit(ReaderEvent.LocationChanged, position);
           if (this.consumptionModule) {
             this.consumptionModule.continueReadingSession(position);
           }
@@ -88373,11 +88598,13 @@ function updateConfig(rights, publication) {
 }
 
 // src/index.ts
+init_Events();
 var index_default = D2Reader;
 var load = D2Reader.load;
 export {
   AnnotationMarker,
   Link,
+  ReaderEvent,
   index_default as default,
   load
 };