feat(annotator): Add public query methods to BaseAnnotator (#736)

Add getActiveId, getAnnotationContainerEl, and isPopupOpen methods
to support annotation escape key handling from Preview SDK.

Author: jackiejou

src/common/BaseAnnotator.ts

@@ -136,6 +136,14 @@ export default class BaseAnnotator extends EventEmitter {
         this.removeListener(Event.VISIBLE_SET, this.handleSetVisible);
     }
 
+    public getActiveId(): string | null {
+        return store.getActiveAnnotationId(this.store.getState());
+    }
+
+    public getAnnotationContainerEl(): HTMLElement | null {
+        return this.containerEl ?? null;
+    }
+
     public init(scale = 1, rotation = 0): void {
         this.containerEl = this.getElement(this.container);
         this.annotatedEl = this.getAnnotatedElement();
@@ -162,6 +170,10 @@ export default class BaseAnnotator extends EventEmitter {
         return getProp(this.features, feature, false);
     }
 
+    public isPopupOpen(): boolean {
+        return !!this.containerEl?.querySelector('.ba-Popup');
+    }
+
     public removeAnnotation = (annotationId: string): void => {
         this.store.dispatch(store.removeAnnotationAction(annotationId));
     };

src/common/__tests__/BaseAnnotator-test.ts

@@ -304,10 +304,66 @@ describe('BaseAnnotator', () => {
         });
     });
 
+    describe('getActiveId()', () => {
+        test('should return the active annotation id from the store', () => {
+            (annotator.store.getState as jest.Mock).mockReturnValue({
+                annotations: { activeId: 'abc123' },
+            });
+
+            expect(annotator.getActiveId()).toBe('abc123');
+        });
+
+        test('should return null if no active annotation', () => {
+            (annotator.store.getState as jest.Mock).mockReturnValue({
+                annotations: { activeId: null },
+            });
+
+            expect(annotator.getActiveId()).toBeNull();
+        });
+    });
+
+    describe('getAnnotationContainerEl()', () => {
+        test('should return the container element when initialized', () => {
+            annotator.init(1);
+
+            expect(annotator.getAnnotationContainerEl()).toBe(annotator.containerEl);
+        });
+
+        test('should return null when containerEl is undefined', () => {
+            annotator.containerEl = undefined;
+
+            expect(annotator.getAnnotationContainerEl()).toBeNull();
+        });
+    });
+
     describe('isFeatureEnabled()', () => {
         test('should return whether feature is enabled or not', () => {
             expect(annotator.isFeatureEnabled('enabledFeature')).toBe(true);
             expect(annotator.isFeatureEnabled('notEnabledFeature')).toBe(false);
         });
     });
+
+    describe('isPopupOpen()', () => {
+        test('should return true when a popup element exists', () => {
+            annotator.init(1);
+            const popup = document.createElement('div');
+            popup.classList.add('ba-Popup');
+            annotator.containerEl?.appendChild(popup);
+
+            expect(annotator.isPopupOpen()).toBe(true);
+        });
+
+        test('should return false when no popup element exists', () => {
+            annotator.init(1);
+            annotator.containerEl?.querySelectorAll('.ba-Popup').forEach(el => el.remove());
+
+            expect(annotator.isPopupOpen()).toBe(false);
+        });
+
+        test('should return false when containerEl is undefined', () => {
+            annotator.containerEl = undefined;
+
+            expect(annotator.isPopupOpen()).toBe(false);
+        });
+    });
 });