stimulus-pdf-viewer-rails 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2b8580f37e1f69672150d18e71bda47daff6b3eb2b082becc5f0090bea57d43
-  data.tar.gz: 6f3ecaf5db5c8248a6037c0f416149df1af21980e83236a9ffe9a9d395aa5e99
+  metadata.gz: 43f0f370e8cb71ab25bae045345269c4567e3afaecb6a15f43dfe8dd26b4766c
+  data.tar.gz: ce65b690119f2d649ef611f227e4da9bfddf4f27da9273221a9653211eb84445
 SHA512:
-  metadata.gz: 27b13a4566eefe38263b236ba1fd96a0bec05651a27f5e333147b2f6635e9dac5e100b58ff4a67db6f36360895fc1b2ca8facdd58e091aa8b1c2053accf76f28
-  data.tar.gz: 65a0c1284f86ffc83680d9ac95c6e20f64cec6dad84f3f5edb9ea6ec6e4cd1f6003f865d4d959400e05eab4f8e56b2db39494b2cec520506c1a8078770d3d605
+  metadata.gz: cd3c15bcfccb692d88527594f57cbcbe280b7c0ec79b84f15a8c36016e907b29431554098602042c51ed80a2cdd1601ced8782cf33ae9fd4fba216c29a764ffa
+  data.tar.gz: c275cb1442a607111a11564d1ecf5326c69be6653ef497c49c45f602c0d4f44e38373b9d6d5308cc821ba92c1933bdc4f929185de0f524533a60b84d52bb7d6f

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.3.0] - 2026-04-01
+
+### Added
+- Updated stimulus-pdf-viewer to 0.3.0
+
 ## [0.2.0] - 2026-01-11
 
 ### Added

data/app/assets/javascripts/stimulus-pdf-viewer.esm.js

@@ -3665,6 +3665,17 @@ class AnnotationSidebar {
         this.listContainer.appendChild(item);
       }
     }
+
+    // Re-fire selected event after rebuild so consumers can re-attach detail panels
+    if (this.selectedAnnotationId) {
+      const annotation = this.annotationManager.getAnnotation(this.selectedAnnotationId);
+      if (annotation) {
+        this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-selected", {
+          bubbles: true,
+          detail: { annotationId: this.selectedAnnotationId, annotation }
+        }));
+      }
+    }
   }
 
   _matchesFilter(annotation) {
@@ -3887,18 +3898,36 @@ class AnnotationSidebar {
   }
 
   _selectItem(annotationId) {
+    const previousId = this.selectedAnnotationId;
+
+    // Skip if already selected
+    if (previousId === annotationId) return
+
     // Deselect previous
     const prev = this.listContainer.querySelector(".annotation-list-item.selected");
     if (prev) {
       prev.classList.remove("selected");
     }
 
+    if (previousId) {
+      this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-deselected", {
+        bubbles: true,
+        detail: { annotationId: previousId }
+      }));
+    }
+
     // Select new
     this.selectedAnnotationId = annotationId;
     const item = this.listContainer.querySelector(`[data-annotation-id="${annotationId}"]`);
     if (item) {
       item.classList.add("selected");
     }
+
+    const annotation = this.annotationManager.getAnnotation(annotationId);
+    this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-selected", {
+      bubbles: true,
+      detail: { annotationId, annotation }
+    }));
   }
 
   /**
@@ -3926,7 +3955,12 @@ class AnnotationSidebar {
     if (this.isOpen) {
       // Clear selection if deleted annotation was selected
       if (this.selectedAnnotationId === annotation.id) {
+        const previousId = this.selectedAnnotationId;
         this.selectedAnnotationId = null;
+        this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-deselected", {
+          bubbles: true,
+          detail: { annotationId: previousId }
+        }));
       }
       this._refreshList();
     }
@@ -3954,6 +3988,10 @@ class AnnotationSidebar {
     this.element.classList.add("open");
     this.container.classList.add("annotation-sidebar-open");
     this._refreshList();
+
+    this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-sidebar-opened", {
+      bubbles: true
+    }));
   }
 
   /**
@@ -3963,6 +4001,10 @@ class AnnotationSidebar {
     this.isOpen = false;
     this.element.classList.remove("open");
     this.container.classList.remove("annotation-sidebar-open");
+
+    this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-sidebar-closed", {
+      bubbles: true
+    }));
   }
 
   /**
@@ -6873,6 +6915,10 @@ class PdfViewer {
       if (e.target.closest(".annotation") || e.target.closest(".annotation-edit-toolbar")) {
         return
       }
+      // Skip if an annotation was just created (click follows pointerup from text selection)
+      if (this._suppressClickDeselect) {
+        return
+      }
       this._deselectAnnotation();
     });
 
@@ -6922,6 +6968,12 @@ class PdfViewer {
       // Render annotations on all rendered pages
       this._renderAnnotations();
 
+      const annotations = this.annotationManager.getAllAnnotations();
+      this.container.dispatchEvent(new CustomEvent("pdf-viewer:annotations-loaded", {
+        bubbles: true,
+        detail: { annotations, count: annotations.length }
+      }));
+
       // Navigate to initial page if specified
       if (this.initialPage > 1) {
         this.viewer.goToPage(this.initialPage);
@@ -7049,11 +7101,15 @@ class PdfViewer {
 
     // Auto-select the newly created annotation
     const pageContainer = this.viewer.getPageContainer(annotation.page);
-    const element = pageContainer?.querySelector(`[data-annotation-id="${annotation.id}"]`);
+    const element = pageContainer?.querySelector(`.annotation[data-annotation-id="${annotation.id}"]`);
     if (element) {
       this._selectAnnotation(annotation, element);
     }
 
+    // Suppress the click-to-deselect that follows pointerup after text selection
+    this._suppressClickDeselect = true;
+    setTimeout(() => { this._suppressClickDeselect = false; }, 100);
+
     // Notify annotation sidebar
     this.annotationSidebar?.onAnnotationCreated(annotation);
 
@@ -7081,7 +7137,7 @@ class PdfViewer {
     // Re-select the annotation after re-render
     if (wasSelected) {
       const pageContainer = this.viewer.getPageContainer(annotation.page);
-      const element = pageContainer?.querySelector(`[data-annotation-id="${annotation.id}"]`);
+      const element = pageContainer?.querySelector(`.annotation[data-annotation-id="${annotation.id}"]`);
       if (element) {
         // Get the fresh annotation data from the manager
         const updatedAnnotation = this.annotationManager.getAnnotation(annotation.id);
@@ -7102,6 +7158,11 @@ class PdfViewer {
     // Announce to screen readers
     const typeLabel = this._getAnnotationTypeLabel(annotation.annotation_type);
     getAnnouncer().announce(`${typeLabel} updated`);
+
+    this.container.dispatchEvent(new CustomEvent("pdf-viewer:annotation-updated", {
+      bubbles: true,
+      detail: { annotation }
+    }));
   }
 
   _onAnnotationDeleted(annotation) {
@@ -7756,6 +7817,8 @@ class PdfViewer {
   }
 
   _deselectAnnotation() {
+    const previousAnnotation = this.selectedAnnotation;
+
     if (this.selectedAnnotationElement) {
       this.selectedAnnotationElement.classList.remove("selected");
     }
@@ -7764,6 +7827,13 @@ class PdfViewer {
 
     // Hide the edit toolbar
     this.annotationEditToolbar.hide();
+
+    if (previousAnnotation) {
+      this.container.dispatchEvent(new CustomEvent("pdf-viewer:annotation-deselected", {
+        bubbles: true,
+        detail: { annotationId: previousAnnotation.id }
+      }));
+    }
   }
 
   async _onAnnotationColorChange(annotation, color) {

data/app/assets/javascripts/stimulus-pdf-viewer.js

@@ -3685,6 +3685,17 @@
           this.listContainer.appendChild(item);
         }
       }
+
+      // Re-fire selected event after rebuild so consumers can re-attach detail panels
+      if (this.selectedAnnotationId) {
+        const annotation = this.annotationManager.getAnnotation(this.selectedAnnotationId);
+        if (annotation) {
+          this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-selected", {
+            bubbles: true,
+            detail: { annotationId: this.selectedAnnotationId, annotation }
+          }));
+        }
+      }
     }
 
     _matchesFilter(annotation) {
@@ -3907,18 +3918,36 @@
     }
 
     _selectItem(annotationId) {
+      const previousId = this.selectedAnnotationId;
+
+      // Skip if already selected
+      if (previousId === annotationId) return
+
       // Deselect previous
       const prev = this.listContainer.querySelector(".annotation-list-item.selected");
       if (prev) {
         prev.classList.remove("selected");
       }
 
+      if (previousId) {
+        this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-deselected", {
+          bubbles: true,
+          detail: { annotationId: previousId }
+        }));
+      }
+
       // Select new
       this.selectedAnnotationId = annotationId;
       const item = this.listContainer.querySelector(`[data-annotation-id="${annotationId}"]`);
       if (item) {
         item.classList.add("selected");
       }
+
+      const annotation = this.annotationManager.getAnnotation(annotationId);
+      this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-selected", {
+        bubbles: true,
+        detail: { annotationId, annotation }
+      }));
     }
 
     /**
@@ -3946,7 +3975,12 @@
       if (this.isOpen) {
         // Clear selection if deleted annotation was selected
         if (this.selectedAnnotationId === annotation.id) {
+          const previousId = this.selectedAnnotationId;
           this.selectedAnnotationId = null;
+          this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-deselected", {
+            bubbles: true,
+            detail: { annotationId: previousId }
+          }));
         }
         this._refreshList();
       }
@@ -3974,6 +4008,10 @@
       this.element.classList.add("open");
       this.container.classList.add("annotation-sidebar-open");
       this._refreshList();
+
+      this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-sidebar-opened", {
+        bubbles: true
+      }));
     }
 
     /**
@@ -3983,6 +4021,10 @@
       this.isOpen = false;
       this.element.classList.remove("open");
       this.container.classList.remove("annotation-sidebar-open");
+
+      this.element.dispatchEvent(new CustomEvent("pdf-sidebar:annotation-sidebar-closed", {
+        bubbles: true
+      }));
     }
 
     /**
@@ -6893,6 +6935,10 @@
         if (e.target.closest(".annotation") || e.target.closest(".annotation-edit-toolbar")) {
           return
         }
+        // Skip if an annotation was just created (click follows pointerup from text selection)
+        if (this._suppressClickDeselect) {
+          return
+        }
         this._deselectAnnotation();
       });
 
@@ -6942,6 +6988,12 @@
         // Render annotations on all rendered pages
         this._renderAnnotations();
 
+        const annotations = this.annotationManager.getAllAnnotations();
+        this.container.dispatchEvent(new CustomEvent("pdf-viewer:annotations-loaded", {
+          bubbles: true,
+          detail: { annotations, count: annotations.length }
+        }));
+
         // Navigate to initial page if specified
         if (this.initialPage > 1) {
           this.viewer.goToPage(this.initialPage);
@@ -7069,11 +7121,15 @@
 
       // Auto-select the newly created annotation
       const pageContainer = this.viewer.getPageContainer(annotation.page);
-      const element = pageContainer?.querySelector(`[data-annotation-id="${annotation.id}"]`);
+      const element = pageContainer?.querySelector(`.annotation[data-annotation-id="${annotation.id}"]`);
       if (element) {
         this._selectAnnotation(annotation, element);
       }
 
+      // Suppress the click-to-deselect that follows pointerup after text selection
+      this._suppressClickDeselect = true;
+      setTimeout(() => { this._suppressClickDeselect = false; }, 100);
+
       // Notify annotation sidebar
       this.annotationSidebar?.onAnnotationCreated(annotation);
 
@@ -7101,7 +7157,7 @@
       // Re-select the annotation after re-render
       if (wasSelected) {
         const pageContainer = this.viewer.getPageContainer(annotation.page);
-        const element = pageContainer?.querySelector(`[data-annotation-id="${annotation.id}"]`);
+        const element = pageContainer?.querySelector(`.annotation[data-annotation-id="${annotation.id}"]`);
         if (element) {
           // Get the fresh annotation data from the manager
           const updatedAnnotation = this.annotationManager.getAnnotation(annotation.id);
@@ -7122,6 +7178,11 @@
       // Announce to screen readers
       const typeLabel = this._getAnnotationTypeLabel(annotation.annotation_type);
       getAnnouncer().announce(`${typeLabel} updated`);
+
+      this.container.dispatchEvent(new CustomEvent("pdf-viewer:annotation-updated", {
+        bubbles: true,
+        detail: { annotation }
+      }));
     }
 
     _onAnnotationDeleted(annotation) {
@@ -7776,6 +7837,8 @@
     }
 
     _deselectAnnotation() {
+      const previousAnnotation = this.selectedAnnotation;
+
       if (this.selectedAnnotationElement) {
         this.selectedAnnotationElement.classList.remove("selected");
       }
@@ -7784,6 +7847,13 @@
 
       // Hide the edit toolbar
       this.annotationEditToolbar.hide();
+
+      if (previousAnnotation) {
+        this.container.dispatchEvent(new CustomEvent("pdf-viewer:annotation-deselected", {
+          bubbles: true,
+          detail: { annotationId: previousAnnotation.id }
+        }));
+      }
     }
 
     async _onAnnotationColorChange(annotation, color) {

data/lib/stimulus_pdf_viewer/rails/version.rb

@@ -1,7 +1,7 @@
 module StimulusPdfViewer
   module Rails
-    VERSION = "0.2.1"
+    VERSION = "0.3.0"
     # This should match the npm package version
-    STIMULUS_PDF_VIEWER_VERSION = "0.2.1"
+    STIMULUS_PDF_VIEWER_VERSION = "0.3.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stimulus-pdf-viewer-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Jeremy Baker
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-12 00:00:00.000000000 Z
+date: 2026-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties