@d-i-t-a/reader 3.0.0-alpha.6 → 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) {
@@ -14676,7 +14739,7 @@ var require_lodash = __commonJS({
             } else if (isPlainObject(srcValue) || isArguments(srcValue)) {
               newValue = objValue;
               if (isArguments(objValue)) {
-                newValue = toPlainObject(objValue);
+                newValue = toPlainObject2(objValue);
               } else if (!isObject(objValue) || isFunction(objValue)) {
                 newValue = initCloneObject(srcValue);
               }
@@ -17317,7 +17380,7 @@ var require_lodash = __commonJS({
           var isBinary = reIsBinary.test(value);
           return isBinary || reIsOctal.test(value) ? freeParseInt(value.slice(2), isBinary ? 2 : 8) : reIsBadHex.test(value) ? NAN : +value;
         }
-        function toPlainObject(value) {
+        function toPlainObject2(value) {
           return copyObject(value, keysIn(value));
         }
         function toSafeInteger(value) {
@@ -18197,7 +18260,7 @@ var require_lodash = __commonJS({
         lodash4.toPairs = toPairs;
         lodash4.toPairsIn = toPairsIn;
         lodash4.toPath = toPath;
-        lodash4.toPlainObject = toPlainObject;
+        lodash4.toPlainObject = toPlainObject2;
         lodash4.transform = transform;
         lodash4.unary = unary;
         lodash4.union = union;
@@ -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) {
@@ -68637,7 +68708,7 @@ var Link = class extends U {
 // src/model/v3/Publication.ts
 function toLink(link) {
   if (link instanceof Link) return link;
-  return Object.assign(new Link({ href: link.href }), {
+  return new Link({
     href: link.href,
     templated: link.templated,
     type: link.type,
@@ -68663,6 +68734,27 @@ var Publication = class _Publication {
     this.manifest = manifest;
     this.manifestUrl = manifestUrl;
   }
+  /**
+   * Create a Publication from a raw JSON object.
+   * Handles both RWPM (camelCase) and legacy (PascalCase) key formats.
+   * Returns null if the JSON cannot be parsed.
+   */
+  static fromJSON(json, url) {
+    const normalized = {
+      metadata: json.metadata ?? json.Metadata ?? { title: "" },
+      links: json.links ?? json.Links ?? [],
+      readingOrder: json.readingOrder ?? json.spine ?? json.Spine ?? [],
+      resources: json.resources ?? json.Resources,
+      toc: json.toc ?? json.TOC
+    };
+    if (!normalized.metadata.title) {
+      normalized.metadata.title = normalized.metadata.Title ?? "";
+    }
+    const manifest = Ue.deserialize(normalized);
+    if (!manifest) return null;
+    manifest.setSelfLink(url.href);
+    return new _Publication(manifest, url);
+  }
   static async fromUrl(url, requestConfig) {
     const response = await fetch(url.href, requestConfig);
     const manifestJSON = await response.json();
@@ -68717,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() {
@@ -71591,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());
@@ -72557,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) {
@@ -73548,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
@@ -74340,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);
@@ -74351,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) {
@@ -74453,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
+            );
           }
         }
       }
@@ -75020,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
@@ -75238,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) {
@@ -75288,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) {
@@ -75379,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 {
@@ -75400,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(
@@ -75610,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();
   }
@@ -75620,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) {
@@ -75718,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));
@@ -75727,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));
@@ -76227,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(
@@ -76312,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;
@@ -76392,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;
@@ -76592,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));
@@ -76886,6 +77023,7 @@ var BookmarkModule = class _BookmarkModule {
 
 // src/modules/mediaoverlays/MediaOverlayModule.ts
 init_polyfills();
+init_Events();
 
 // src/model/v3/MediaOverlayNode.ts
 init_polyfills();
@@ -76921,16 +77059,6 @@ var MediaOverlayNode = class _MediaOverlayNode {
   }
 };
 
-// src/utils/JsonUtil.ts
-init_polyfills();
-function TaJsonDeserialize(json, type) {
-  if (type && typeof type.deserialize === "function") {
-    const result = type.deserialize(json);
-    if (result) return result;
-  }
-  return Object.assign(new type(), json);
-}
-
 // src/modules/mediaoverlays/MediaOverlaySettings.ts
 init_polyfills();
 init_HTMLUtilities();
@@ -77341,6 +77469,7 @@ var MediaOverlayModule = class {
       config2.settings,
       config2
     );
+    mediaOverlay.api = config2.api;
     mediaOverlay.start();
     return mediaOverlay;
   }
@@ -77393,10 +77522,7 @@ var MediaOverlayModule = class {
         import_loglevel11.default.log("## moJson" + moJson);
         return;
       }
-      link.mediaOverlayNode = TaJsonDeserialize(
-        moJson,
-        MediaOverlayNode
-      );
+      link.mediaOverlayNode = MediaOverlayNode.deserialize(moJson);
       link.mediaOverlayNode.initialized = true;
       const href = link.hrefDecoded || link.href;
       const hrefUrlObj = new URL("https://dita.digital/" + href);
@@ -77414,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();
         }
@@ -77475,10 +77619,7 @@ var MediaOverlayModule = class {
             if (response.ok) {
               const moJson = await response.json();
               if (moJson) {
-                link.mediaOverlayNode = TaJsonDeserialize(
-                  moJson,
-                  MediaOverlayNode
-                );
+                link.mediaOverlayNode = MediaOverlayNode.deserialize(moJson);
                 link.mediaOverlayNode.initialized = true;
               }
             }
@@ -77533,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() {
@@ -77550,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() {
@@ -77558,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) {
@@ -77668,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();
           }
@@ -81801,6 +81971,7 @@ var TTSSettings = class {
 
 // src/navigator/IFrameNavigator.ts
 init_polyfills();
+init_Events();
 init_EventHandler();
 init_HTMLUtilities();
 init_HTMLTemplates();
@@ -82279,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());
@@ -82449,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;
@@ -82470,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);
@@ -82639,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()
+          });
         }
       };
     }
@@ -82753,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"
@@ -82813,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;
@@ -82826,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;
@@ -83264,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 {
@@ -83356,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(
@@ -83373,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
+                    );
                   }
                 });
               },
@@ -84110,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";
@@ -84155,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 {
@@ -84182,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) {
@@ -84472,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;
@@ -84639,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) {
@@ -85416,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) {
@@ -85593,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) {
@@ -86053,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() {
@@ -86289,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;
@@ -86488,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 = "";
@@ -86572,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") {
@@ -86732,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 {
@@ -86796,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) {
@@ -86883,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() {
@@ -86962,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);
           }
@@ -87512,41 +87742,18 @@ init_HTMLUtilities();
 
 // src/model/Link.ts
 init_polyfills();
-function convertAndCamel(o) {
+function toPlainObject(o) {
   if (o == null) return o;
-  if (o.items && Array.isArray(o.items)) {
-    return convertAndCamel(o.items);
-  }
-  let newO, origKey, newKey, value;
-  if (o instanceof Array) {
-    return o.map(function(value2) {
-      if (typeof value2 === "object") {
-        value2 = convertAndCamel(value2);
-      }
-      return value2;
-    });
-  } else {
-    newO = {};
-    for (origKey in o) {
-      if (o.hasOwnProperty(origKey)) {
-        newKey = (origKey.charAt(0).toLowerCase() + origKey.slice(1) || origKey).toString();
-        value = o[origKey];
-        if (value && value.items && Array.isArray(value.items)) {
-          value = convertAndCamel(value.items);
-        } else if (value instanceof Array || value !== null && value !== void 0 && value.constructor === Object) {
-          value = convertAndCamel(value);
-        }
-        if (newKey === "href1") {
-          newO["href"] = value;
-        } else if (newKey === "typeLink") {
-          newO["type"] = value;
-        } else {
-          newO[newKey] = value;
-        }
-      }
-    }
+  if (o instanceof Set) return Array.from(o);
+  if (o.items && Array.isArray(o.items)) return o.items.map(toPlainObject);
+  if (Array.isArray(o)) return o.map(toPlainObject);
+  if (typeof o !== "object") return o;
+  const result = {};
+  for (const key in o) {
+    if (!o.hasOwnProperty(key)) continue;
+    result[key] = toPlainObject(o[key]);
   }
-  return newO;
+  return result;
 }
 
 // src/modules/highlight/LayerSettings.ts
@@ -88022,27 +88229,10 @@ var D2Reader = class _D2Reader {
       if (pubInput instanceof Publication) {
         publication = pubInput;
       } else {
-        const json = {
-          metadata: pubInput.metadata ?? pubInput.Metadata ?? { title: "" },
-          links: pubInput.links ?? pubInput.Links ?? [],
-          readingOrder: pubInput.readingOrder ?? pubInput.spine ?? pubInput.Spine ?? [],
-          resources: pubInput.resources ?? pubInput.Resources,
-          toc: pubInput.toc ?? pubInput.TOC
-        };
-        if (!json.metadata.title && !json.metadata.Title) {
-          json.metadata.title = "";
-        }
-        if (json.metadata.Title && !json.metadata.title) {
-          json.metadata.title = json.metadata.Title;
-        }
-        const manifest = Ue.deserialize(json);
-        if (!manifest) {
-          throw new Error("Failed to parse publication manifest from config");
-        }
-        manifest.setSelfLink(webPubManifestUrl.href);
-        publication = new Publication(manifest, new URL(webPubManifestUrl));
+        publication = Publication.fromJSON(pubInput, webPubManifestUrl);
       }
-    } else {
+    }
+    if (!publication) {
       publication = await Publication.fromUrl(
         webPubManifestUrl,
         initialConfig.requestConfig
@@ -88266,19 +88456,19 @@ var D2Reader = class _D2Reader {
   }
   /** Table of Contents */
   get tableOfContents() {
-    return convertAndCamel(this.navigator.tableOfContents()) ?? [];
+    return toPlainObject(this.navigator.tableOfContents()) ?? [];
   }
   /** Landmarks */
   get landmarks() {
-    return convertAndCamel(this.navigator.landmarks()) ?? [];
+    return toPlainObject(this.navigator.landmarks()) ?? [];
   }
   /** Page List */
   get pageList() {
-    return convertAndCamel(this.navigator.pageList()) ?? [];
+    return toPlainObject(this.navigator.pageList()) ?? [];
   }
   /** Reading Order or Spine */
   get readingOrder() {
-    return convertAndCamel(this.navigator.readingOrder()) ?? [];
+    return toPlainObject(this.navigator.readingOrder()) ?? [];
   }
   /** Current Bookmarks */
   get bookmarks() {
@@ -88408,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
 };