ng2-pdfjs-viewer 25.0.11 → 25.0.13

package/pdfjs/web/postmessage-wrapper.js

@@ -1,1967 +1,1967 @@
-(function() {
-  'use strict';
-  
-  // This will be wrapped in diagnostic logs check after diagnosticLogs is set
-  
-  // #region URL Security Validation
-  let originalFileUrl = null;
-  let urlValidationEnabled = true;
-  
-  function initializeUrlValidation() {
-    // Get the initial file URL from query parameters
-    const urlParams = new URLSearchParams(window.location.search);
-    const currentFileUrl = urlParams.get('file');
-    
-    // Check if we already have a stored original URL
-    const storedOriginalUrl = sessionStorage.getItem('ng2-pdfjs-viewer-original-file-url');
-    
-    if (storedOriginalUrl) {
-      // Use the stored original URL (from previous page load)
-      originalFileUrl = storedOriginalUrl;
-    } else if (currentFileUrl) {
-      // Store the current URL as the original (first time loading)
-      originalFileUrl = currentFileUrl;
-      sessionStorage.setItem('ng2-pdfjs-viewer-original-file-url', originalFileUrl);
-    }
-  }
-  
-  function validateCurrentUrl() {
-    if (!urlValidationEnabled || !originalFileUrl) {
-      return true; // Skip validation if disabled or no original URL
-    }
-    
-    const currentFileParam = new URLSearchParams(window.location.search).get('file');
-    
-    // Compare the file parameter specifically
-    if (currentFileParam !== originalFileUrl) {
-      console.error('🚨 SECURITY ALERT: File URL has been modified!');
-      console.error('Original:', originalFileUrl);
-      console.error('Current:', currentFileParam);
-      
-      // Prevent loading and show error
-      showSecurityError('Unauthorized file access detected. The file URL has been tampered with.');
-      return false;
-    }
-    
-    return true;
-  }
-  
-  function showSecurityError(message) {
-    // Simple console warning (less intrusive)
-    console.warn('🚨 Security Warning:', message);
-    
-    // Send notification to parent window for Angular template handling
-    if (window.parent && window.parent !== window) {
-      window.parent.postMessage({
-        type: 'ng2-pdfjs-viewer-security-warning',
-        message: message,
-        originalUrl: originalFileUrl,
-        currentUrl: new URLSearchParams(window.location.search).get('file')
-      }, '*');
-    }
-  }
-  
-  // Initialize URL validation on page load
-  initializeUrlValidation();
-  
-  // Add validation check before PDF.js loads
-  window.addEventListener('DOMContentLoaded', () => {
-    if (!validateCurrentUrl()) {
-      // Prevent PDF.js from loading if URL validation fails
-      return;
-    }
-  });
-  
-  // Validate on page load
-  window.addEventListener('load', () => {
-    validateCurrentUrl();
-  });
-  
-  // Also validate on hash change (in case user tries to modify URL)
-  window.addEventListener('hashchange', () => {
-    validateCurrentUrl();
-  });
-  
-  // Validate on popstate (back/forward navigation)
-  window.addEventListener('popstate', () => {
-    validateCurrentUrl();
-  });
-  
-  // Run validation immediately (in case page is already loaded)
-  validateCurrentUrl();
-  // #endregion
-  
-  // Override the webviewerloaded event to dispatch to parent window
-  // This allows us to capture the event outside the iframe and set locale before PDF.js initializes
-  const originalDispatchEvent = document.dispatchEvent;
-  document.dispatchEvent = function(event) {
-    if (event.type === 'webviewerloaded') {
-      // Dispatch to parent window so it can be captured outside the iframe
-      if (window.parent && window.parent !== window) {
-        window.parent.document.dispatchEvent(event);
-      }
-    }
-    return originalDispatchEvent.call(this, event);
-  };
-  
-  // #region Constants and Configuration
-  // Command tracking for zoom to prevent infinite loops
-  const ZoomCommandTracker = {
-    activeZoomCommand: false,
-    
-    markZoomCommandStart() {
-      this.activeZoomCommand = true;
-    },
-    
-    markZoomCommandEnd() {
-      this.activeZoomCommand = false;
-    },
-    
-    isZoomCommandActive() {
-      return this.activeZoomCommand;
-    }
-  };
-  
-  // Readiness state management
-  const ViewerReadiness = {
-    NOT_LOADED: 0,
-    VIEWER_LOADED: 1,      // PDFViewerApplication exists
-    VIEWER_INITIALIZED: 2, // PDFViewerApplication.initialized = true
-    EVENTBUS_READY: 3,     // Event bus is available and ready
-    COMPONENTS_READY: 4,   // All required components available
-    DOCUMENT_LOADED: 5     // PDF document fully loaded
-  };
-  
-  // Pure event-driven architecture - no action categorization needed
-  // All actions are dispatched at required readiness levels by Universal Dispatcher
-  // #endregion
-
-  // #region State Management
-  let currentReadiness = ViewerReadiness.NOT_LOADED;
-  let readinessCallbacks = [];
-  let diagnosticLogs = false; // Default to false for production
-  // #endregion
-
-  // #region Utility Functions
-  function log(message, level = 'info') {
-    if (!diagnosticLogs) return; // Only log when diagnostic logs are enabled
-    
-    const timestamp = new Date().toISOString();
-    const prefix = '[PostMessage]';
-    
-      switch (level) {
-        case 'error':
-        console.error(`${prefix} ${timestamp} ERROR: ${message}`);
-          break;
-        case 'warn':
-        console.warn(`${prefix} ${timestamp} WARN: ${message}`);
-          break;
-        default:
-        console.log(`${prefix} ${timestamp} INFO: ${message}`);
-    }
-  }
-
-  // Set diagnostic logs mode
-  function setDiagnosticLogs(enabled) {
-    diagnosticLogs = enabled;
-  }
-
-  // Button visibility control helper (consolidated from separate module)
-  function toggleButtonVisibility(primaryId, secondaryId, visible) {
-    const primary = document.getElementById(primaryId);
-    const secondary = secondaryId ? document.getElementById(secondaryId) : null;
-    if (primary) primary.classList.toggle('hidden', !visible);
-    if (secondary) secondary.classList.toggle('hidden', !visible);
-  }
-
-  // Generic element visibility control for toolbar/sidebar groups
-  function toggleElementVisibilityById(elementId, visible) {
-    const el = document.getElementById(elementId);
-    if (!el) {
-      log(`Element not found for visibility toggle: ${elementId}`, 'warn');
-      return;
-    }
-    el.classList.toggle('hidden', !visible);
-  }
-
-  // Toolbar section visibility control that preserves layout
-  function toggleToolbarSectionVisibility(elementId, visible) {
-    const el = document.getElementById(elementId);
-    if (!el) {
-      log(`Toolbar section not found for visibility toggle: ${elementId}`, 'warn');
-      return;
-    }
-    
-    // Use CSS class instead of inline styles (CSP-safe)
-    el.classList.toggle('ng2-hidden-section', !visible);
-  }
-  
-  // Readiness state management
-  function setReadiness(readiness) {
-    if (readiness > currentReadiness) {
-      log(`Readiness state changed: ${currentReadiness} → ${readiness}`);
-      currentReadiness = readiness;
-      
-      // Execute callbacks for this readiness level
-      readinessCallbacks.forEach(callback => {
-        if (callback.readiness <= readiness && !callback.executed) {
-          callback.executed = true;
-          callback.callback();
-        }
-      });
-    }
-  }
-  
-  function onReadiness(readiness, callback) {
-    if (currentReadiness >= readiness) {
-      callback();
-    } else {
-      readinessCallbacks.push({ readiness, callback, executed: false });
-    }
-  }
-  
-  // Note: Density styles now loaded from external ng2-customization.css (CSP-safe)
-  
-  // Enhanced zoom transformation function
-  function transformZoomFromViewer(scale, app) {
-    if (typeof scale === 'string') {
-      return scale;
-    }
-    
-    if (app?.pdfViewer) {
-      const viewer = app.pdfViewer;
-      
-      // Check for special zoom modes
-      const specialModes = ['page-fit', 'page-width', 'page-actual', 'auto'];
-      if (specialModes.includes(viewer.currentScaleValue)) {
-        return viewer.currentScaleValue;
-      }
-      
-      // Check predefined zoom levels
-      const predefinedZooms = {
-        0.5: '0.5', 0.75: '0.75', 1: '1', 1.25: '1.25', 
-        1.5: '1.5', 2: '2', 3: '3', 4: '4'
-      };
-      
-      for (const [zoomLevel, zoomValue] of Object.entries(predefinedZooms)) {
-        if (Math.abs(scale - parseFloat(zoomLevel)) < 0.01) {
-          return zoomValue;
-        }
-      }
-    }
-    
-    return typeof scale === 'number' ? `${Math.round(scale * 100)}%` : 'auto';
-  }
-
-  // Send state change notifications to Angular component
-  function sendStateChangeNotification(property, value, source = 'user') {
-    try {
-      const message = {
-        type: 'state-change',
-        property: property,
-        value: value,
-        source: source,
-        timestamp: Date.now()
-      };
-      
-      window.parent.postMessage(message, '*');
-    } catch (error) {
-      log(`Failed to send state change notification: ${error.message}`, 'error');
-    }
-  }
-
-  // Send event notifications to Angular component
-  function sendEventNotification(eventName, eventData) {
-    try {
-      const message = {
-        type: 'event-notification',
-        eventName: eventName,
-        eventData: eventData,
-        timestamp: Date.now()
-      };
-      
-      window.parent.postMessage(message, '*');
-    } catch (error) {
-      log(`Failed to send event notification: ${error.message}`, 'error');
-    }
-  }
-
-  function sendResponse(id, response) {
-    if (id && window.parent) {
-      window.parent.postMessage({
-        type: 'control-response',
-        id: id,
-        ...response,
-        timestamp: Date.now()
-      }, '*');
-    }
-  }
-
-  function getState() {
-    const app = PDFViewerApplication;
-    if (!app) {
-      return { ready: false };
-    }
-    
-    return {
-      ready: app.initialized,
-      page: app.page,
-      pagesCount: app.pagesCount,
-      currentScale: app.pdfViewer ? app.pdfViewer.currentScale : null,
-      currentScaleValue: app.pdfViewer ? app.pdfViewer.currentScaleValue : null,
-      pagesRotation: app.pdfViewer ? app.pdfViewer.pagesRotation : null,
-      scrollMode: app.pdfViewer ? app.pdfViewer.scrollMode : null,
-      spreadMode: app.pdfViewer ? app.pdfViewer.spreadMode : null
-    };
-  }
-
-  // Common control update utilities
-  const ControlUtils = {
-    // Common button visibility update pattern
-    updateButtonVisibility: function(buttonId, secondaryId, visible) {
-      const button = document.getElementById(buttonId);
-      const secondaryButton = secondaryId ? document.getElementById(secondaryId) : null;
-      
-      if (button) {
-        button.classList.toggle('hidden', !visible);
-      }
-      if (secondaryButton) {
-        secondaryButton.classList.toggle('hidden', !visible);
-      }
-      
-    },
-
-    // Common mode update pattern with event bus
-    updateModeViaEventBus: function(eventName, modeValue, modeMap, propertyName) {
-      const app = PDFViewerApplication;
-      if (!app?.eventBus) {
-        log('EventBus not available for mode update', 'error');
-        return;
-      }
-
-      try {
-        const upperMode = typeof modeValue === 'string' ? modeValue.toUpperCase() : modeValue;
-        const mode = modeMap[upperMode];
-        
-        if (mode !== undefined) {
-          app.eventBus.dispatch(eventName, { mode });
-          
-          // NOTE: State change notifications are sent by the bidirectional event listeners
-          // when the actual mode change occurs in PDF.js, not immediately when we dispatch
-          // This prevents infinite loops and ensures we only notify on actual changes
-        } else {
-          log(`Unknown ${propertyName} mode: ${modeValue}`, 'warn');
-        }
-      } catch (error) {
-        log(`Error updating ${propertyName} mode: ${error.message}`, 'error');
-      }
-    },
-
-    // Common direct property update pattern
-    updatePropertyDirectly: function(propertyPath, value, propertyName) {
-      const app = PDFViewerApplication;
-      if (!app?.pdfViewer) {
-        log(`PDFViewer not available for ${propertyName} update`, 'warn');
-        return;
-      }
-
-      try {
-        // Navigate to nested property
-        const pathParts = propertyPath.split('.');
-        let target = app;
-        
-        for (let i = 0; i < pathParts.length - 1; i++) {
-          target = target[pathParts[i]];
-          if (!target) {
-            log(`Property path ${propertyPath} not found for ${propertyName}`, 'warn');
-            return;
-          }
-        }
-        
-        target[pathParts[pathParts.length - 1]] = value;
-      } catch (error) {
-        log(`Direct ${propertyName} update failed: ${error.message}`, 'warn');
-      }
-    },
-
-    // Common validation pattern
-    validateAndExecute: function(condition, action, errorMessage) {
-      if (condition) {
-        action();
-      } else {
-        log(errorMessage, 'warn');
-      }
-    }
-  };
-  // #endregion
-
-  // #region Initialization and Setup
-  
-  // Enhanced readiness checking with proper async initialization handling
-  function checkViewerReadiness() {
-    const app = PDFViewerApplication;
-    
-    if (!app) {
-      setReadiness(ViewerReadiness.NOT_LOADED);
-      return;
-    }
-    
-    setReadiness(ViewerReadiness.VIEWER_LOADED);
-    
-    // Handle async initialization properly
-    if (app.initializedPromise) {
-      app.initializedPromise.then(() => {
-        setReadiness(ViewerReadiness.VIEWER_INITIALIZED);
-        
-        // Check if event bus is ready
-        if (app.eventBus && typeof app.eventBus.dispatch === 'function') {
-          setReadiness(ViewerReadiness.EVENTBUS_READY);
-          
-          // Check if key components are available
-          if (app.pdfViewer && app.pdfCursorTools) {
-            setReadiness(ViewerReadiness.COMPONENTS_READY);
-            
-            // CSS zoom setting is now handled via PostMessage configuration
-            // No need to check global window variables
-          }
-        }
-      }).catch(error => {
-        log(`PDFViewerApplication initialization failed: ${error.message}`, 'error');
-      });
-    } else if (app.initialized) {
-      // Fallback for synchronous check (though this should be async)
-      setReadiness(ViewerReadiness.VIEWER_INITIALIZED);
-      
-      // Check if event bus is ready
-      if (app.eventBus && typeof app.eventBus.dispatch === 'function') {
-        setReadiness(ViewerReadiness.EVENTBUS_READY);
-        
-        // Check if key components are available
-        if (app.pdfViewer && app.pdfCursorTools) {
-          setReadiness(ViewerReadiness.COMPONENTS_READY);
-          
-          // CSS zoom setting is now handled via PostMessage configuration
-          // No need to check global window variables
-        }
-      }
-    }
-  }
-  
-  // Wait for PDF.js viewer to be ready with event-driven approach
-  function waitForViewer() {
-    // Use MutationObserver to detect when PDFViewerApplication becomes available
-    const observer = new MutationObserver((mutations, obs) => {
-      if (typeof PDFViewerApplication !== 'undefined') {
-        obs.disconnect(); // Stop observing
-        checkViewerReadiness();
-        
-        // Set up event-driven readiness monitoring
-        setupEventDrivenReadinessMonitoring();
-      }
-    });
-    
-    // Start observing DOM changes
-    observer.observe(document, {
-      childList: true,
-      subtree: true
-    });
-    
-    // Also check immediately in case it's already available
-    if (typeof PDFViewerApplication !== 'undefined') {
-      log('PDFViewerApplication already available, starting readiness check');
-      observer.disconnect();
-      checkViewerReadiness();
-      setupEventDrivenReadinessMonitoring();
-    }
-  }
-  
-  // Set up event-driven readiness monitoring
-  function setupEventDrivenReadinessMonitoring() {
-    // Use a custom event system for readiness changes
-    const readinessEventTarget = new EventTarget();
-    
-    // Override setReadiness to emit events
-    const originalSetReadiness = setReadiness;
-    setReadiness = function(readiness) {
-      originalSetReadiness(readiness);
-      
-      // Emit custom event for readiness change
-      readinessEventTarget.dispatchEvent(new CustomEvent('readiness-change', {
-        detail: { readiness, previousReadiness: currentReadiness }
-      }));
-    };
-    
-    // Listen for readiness changes
-    readinessEventTarget.addEventListener('readiness-change', (event) => {
-      const { readiness } = event.detail;
-      
-      if (readiness >= ViewerReadiness.EVENTBUS_READY) {
-
-        initializePostMessageAPI();
-      }
-    });
-    
-    // Check initial readiness
-    if (currentReadiness >= ViewerReadiness.EVENTBUS_READY) {
-
-      initializePostMessageAPI();
-    }
-  }
-
-  function initializePostMessageAPI() {
-    // Add message listener
-    window.addEventListener('message', handleControlMessage);
-    
-    // Expose API for external access
-    window.Ng2PdfJsViewerAPI = {
-      updateControl: updateControl,
-      getState: getState,
-      isReady: () => currentReadiness >= ViewerReadiness.EVENTBUS_READY,
-      getReadiness: () => currentReadiness
-    };
-    
-    // Notify parent that PostMessage API is ready
-    window.parent.postMessage({
-      type: 'postmessage-ready',
-      timestamp: Date.now(),
-      readiness: currentReadiness
-    }, '*');
-    
-    // Set up event listeners for readiness changes
-    setupReadinessEventListeners();
-  }
-  
-  function setupReadinessEventListeners() {
-    const app = PDFViewerApplication;
-    if (!app || !app.eventBus) return;
-    
-    // Set up error event listeners immediately (before document loads)
-    setupErrorEventListeners();
-    
-    // Listen for document loaded event
-    app.eventBus.on('documentloaded', () => {
-      setReadiness(ViewerReadiness.DOCUMENT_LOADED);
-      
-      // Set up bidirectional event listeners once document is loaded
-      setupBidirectionalEventListeners();
-    });
-    
-    // Listen for pages loaded event
-    app.eventBus.on('pagesloaded', () => {
-      // Ensure we're at least at components ready level
-      if (currentReadiness < ViewerReadiness.COMPONENTS_READY) {
-        setReadiness(ViewerReadiness.COMPONENTS_READY);
-      }
-    });
-  }
-  // #endregion
-
-  // #region Message Handling
-  function handleControlMessage(event) {
-    const { type, action, payload, id } = event.data;
-    
-    if (type === 'control-update') {
-      try {
-        
-        // Universal Dispatcher has already verified readiness - just execute
-        updateControl(action, payload);
-        sendResponse(id, { success: true, action, payload });
-      } catch (error) {
-        const errorMsg = `Error processing ${action}: ${error.message}`;
-        log(errorMsg, 'error');
-        sendResponse(id, { success: false, error: errorMsg });
-      }
-    }
-  }
-  // #endregion
-
-  // #region Control Update Functions
-  function updateControl(action, payload) {
-    const app = PDFViewerApplication;
-    
-    // Validate that PDFViewerApplication is available
-    if (!app) {
-      log('PDFViewerApplication not available', 'error');
-      return;
-    }
-    
-    try {
-      // Note: Density styles loaded from external ng2-customization.css (CSP-safe)
-      switch (action) {
-        // Button visibility controls (using consolidated helper function)
-        case 'show-download':
-          toggleButtonVisibility('downloadButton', 'secondaryDownload', payload);
-          break;
-        case 'show-print':
-          toggleButtonVisibility('printButton', 'secondaryPrint', payload);
-          break;
-        case 'show-fullscreen':
-          toggleButtonVisibility('presentationMode', null, payload);
-          break;
-        case 'show-find':
-          toggleButtonVisibility('viewFindButton', null, payload);
-          break;
-        case 'show-bookmark':
-          toggleButtonVisibility('viewBookmark', null, payload);
-          break;
-        case 'show-openfile':
-          toggleButtonVisibility('openFile', 'secondaryOpenFile', payload);
-          break;
-        case 'show-annotations':
-          toggleElementVisibilityById('editorModeButtons', payload);
-          break;
-        
-        case 'set-toolbar-density': {
-          // Apply compact/comfortable density by toggling a class on #toolbarContainer
-          const container = document.getElementById('toolbarContainer');
-          if (container) {
-            container.classList.remove('density-default','density-compact','density-comfortable');
-            const density = typeof payload === 'string' ? payload : 'default';
-            container.classList.add(`density-${density}`);
-          }
-          break;
-        }
-        case 'set-sidebar-width': {
-          // Use CSS variable only (CSP-safe) - width applied via ng2-customization.css
-          const outer = document.getElementById('outerContainer');
-          if (outer && typeof payload === 'string' && payload.trim() !== '') {
-            outer.style.setProperty('--sidebar-width', payload);
-          }
-          break;
-        }
-        case 'set-toolbar-position': {
-          const outer = document.getElementById('outerContainer');
-          if (outer) {
-            outer.classList.remove('toolbar-bottom');
-            if (payload === 'bottom') outer.classList.add('toolbar-bottom');
-          }
-          break;
-        }
-        case 'set-sidebar-position': {
-          const outer = document.getElementById('outerContainer');
-          if (outer) {
-            outer.classList.remove('sidebar-right');
-            if (payload === 'right') outer.classList.add('sidebar-right');
-          }
-          break;
-        }
-        case 'set-responsive-breakpoint': {
-          const value = typeof payload === 'number' ? `${payload}px` : `${payload}`;
-          const outer = document.getElementById('outerContainer');
-          if (outer && value) {
-            outer.style.setProperty('--ng2-responsive-breakpoint', value);
-          }
-          break;
-        }
-        
-        case 'show-toolbar-left':
-          toggleToolbarSectionVisibility('toolbarViewerLeft', payload);
-          break;
-        case 'show-toolbar-middle':
-          toggleToolbarSectionVisibility('toolbarViewerMiddle', payload);
-          break;
-        case 'show-toolbar-right':
-          toggleToolbarSectionVisibility('toolbarViewerRight', payload);
-          break;
-        case 'show-secondary-toolbar-toggle':
-          toggleElementVisibilityById('secondaryToolbarToggle', payload);
-          break;
-        case 'show-sidebar':
-          toggleElementVisibilityById('sidebarContainer', payload);
-          break;
-        case 'show-sidebar-left':
-          toggleElementVisibilityById('toolbarSidebarLeft', payload);
-          break;
-        case 'show-sidebar-right':
-          toggleElementVisibilityById('toolbarSidebarRight', payload);
-          break;
-        
-        // Mode controls
-        case 'set-zoom':
-          updateZoom(payload);
-          break;
-        case 'set-cursor':
-          updateCursor(payload);
-          break;
-        case 'set-scroll':
-          ControlUtils.updateModeViaEventBus('switchscrollmode', payload, 
-            { 'VERTICAL': 0, 'V': 0, 'HORIZONTAL': 1, 'H': 1, 'WRAPPED': 2, 'W': 2, 'PAGE': 3, 'P': 3 }, 
-            'scroll mode');
-          ControlUtils.updatePropertyDirectly('pdfViewer.scrollMode', 
-            ({ 'VERTICAL': 0, 'V': 0, 'HORIZONTAL': 1, 'H': 1, 'WRAPPED': 2, 'W': 2, 'PAGE': 3, 'P': 3 })[payload?.toUpperCase()] || 0, 
-            'scroll mode');
-          break;
-        case 'set-spread':
-          ControlUtils.updateModeViaEventBus('switchspreadmode', payload, 
-            { 'NONE': 0, 'N': 0, 'ODD': 1, 'O': 1, 'EVEN': 2, 'E': 2 }, 
-            'spread mode');
-          ControlUtils.updatePropertyDirectly('pdfViewer.spreadMode', 
-            ({ 'NONE': 0, 'N': 0, 'ODD': 1, 'O': 1, 'EVEN': 2, 'E': 2 })[payload?.toUpperCase()] || 0, 
-            'spread mode');
-          break;
-        
-        // Navigation controls
-        case 'set-page':
-          // Universal Dispatcher guarantees PDFViewerApplication.initialized at readiness level 5
-          const pageNumber = parseInt(payload, 10);
-          if (pageNumber > 0 && pageNumber <= PDFViewerApplication.pagesCount) {
-            PDFViewerApplication.page = pageNumber;
-          } else {
-            log(`Invalid page number: ${payload}`, 'warn');
-          }
-          break;
-        case 'set-rotation':
-          // Universal Dispatcher guarantees PDFViewerApplication.initialized at readiness level 5
-          const rotation = parseInt(payload, 10);
-          if ([0, 90, 180, 270].includes(rotation)) {
-            // Set rotation on pdfViewer to trigger proper refresh
-            PDFViewerApplication.pdfViewer.pagesRotation = rotation;
-            // Note: No need to send state change notification here - 
-            // PDF.js will fire 'rotationchanging' event which we handle separately
-          } else {
-            log(`Invalid rotation: ${payload}`, 'warn');
-          }
-          break;
-        case 'go-to-last-page':
-          if (payload === true) {
-            // Universal Dispatcher guarantees PDFViewerApplication.initialized at readiness level 5
-            const lastPage = PDFViewerApplication.pagesCount;
-            PDFViewerApplication.page = lastPage;
-          }
-          break;
-        case 'go-to-named-dest':
-          // Validate that payload is not empty or null before processing
-          if (!payload || typeof payload !== 'string' || payload.trim() === '') {
-            log(`Skipping invalid named destination: "${payload}"`);
-            break;
-          }
-          
-          // Universal Dispatcher guarantees PDFViewerApplication.pdfLinkService at readiness level 5
-          PDFViewerApplication.pdfLinkService.goToDestination(payload);
-          break;
-        case 'update-page-mode':
-          // Universal Dispatcher guarantees PDFViewerApplication.eventBus at readiness level 4
-          const mode = payload ? payload.toLowerCase() : 'none';
-          PDFViewerApplication.eventBus.dispatch('pagemode', { mode });
-          break;
-        
-        // Configuration actions
-        case 'set-download-filename':
-          setDownloadFilename(payload);
-          break;
-
-        // Auto actions - Universal Dispatcher guarantees eventBus availability at readiness level 5
-        case 'trigger-download':
-          if (payload === true) {
-            PDFViewerApplication.eventBus.dispatch('download');
-          }
-          break;
-        case 'trigger-print':
-          if (payload === true) {
-            PDFViewerApplication.eventBus.dispatch('print');
-          }
-          break;
-        case 'trigger-rotate-cw':
-          if (payload === true) {
-            PDFViewerApplication.eventBus.dispatch('rotatecw');
-          }
-          break;
-        case 'trigger-rotate-ccw':
-          if (payload === true) {
-            PDFViewerApplication.eventBus.dispatch('rotateccw');
-          }
-          break;
-        
-        // Error handling
-        case 'set-error-message':
-          setErrorMessage(payload);
-          break;
-        case 'set-error-override':
-          setErrorOverride(payload);
-          break;
-        case 'set-error-append':
-          setErrorAppend(payload);
-          break;
-        
-        // CSS zoom
-        case 'set-css-zoom':
-          setCssZoom(payload);
-          break;
-        
-        // Event enablement
-        case 'enable-before-print':
-          enableBeforePrint(payload);
-          break;
-        case 'enable-after-print':
-          enableAfterPrint(payload);
-          break;
-        case 'enable-pages-loaded':
-          enablePagesLoaded(payload);
-          break;
-        case 'enable-page-change':
-          enablePageChange(payload);
-          break;
-        
-        // New high-value event enablement
-        case 'enable-document-error':
-          enableDocumentError(payload);
-          break;
-        case 'enable-document-init':
-          enableDocumentInit(payload);
-          break;
-        case 'enable-pages-init':
-          enablePagesInit(payload);
-          break;
-        case 'enable-presentation-mode-changed':
-          enablePresentationModeChanged(payload);
-          break;
-        case 'enable-open-file':
-          enableOpenFile(payload);
-          break;
-        case 'enable-find':
-          enableFind(payload);
-          break;
-        case 'enable-update-find-matches-count':
-          enableUpdateFindMatchesCount(payload);
-          break;
-        case 'enable-metadata-loaded':
-          enableMetadataLoaded(payload);
-          break;
-        case 'enable-outline-loaded':
-          enableOutlineLoaded(payload);
-          break;
-        case 'enable-page-rendered':
-          enablePageRendered(payload);
-          break;
-        
-        // New high-value events
-        case 'enable-annotation-layer-rendered':
-          enableAnnotationLayerRendered(payload);
-          break;
-        case 'enable-bookmark-click':
-          enableBookmarkClick(payload);
-          break;
-        case 'enable-idle':
-          enableIdle(payload);
-          break;
-        
-        // Theme & Visual Customization Actions
-        case 'set-theme':
-          setTheme(payload);
-          break;
-        case 'set-primary-color':
-          setPrimaryColor(payload);
-          break;
-        case 'set-background-color':
-          setBackgroundColor(payload);
-          break;
-        case 'set-page-border-color':
-          setPageBorderColor(payload);
-          break;
-        case 'set-page-spacing':
-          setPageSpacing(payload.margin, payload.spreadMargin, payload.border);
-          break;
-        case 'set-toolbar-color':
-          setToolbarColor(payload);
-          break;
-        case 'set-text-color':
-          setTextColor(payload);
-          break;
-        case 'set-border-radius':
-          setBorderRadius(payload);
-          break;
-        case 'set-custom-css':
-          // Handle both old format (string) and new format (object with nonce)
-          if (typeof payload === 'string') {
-            setCustomCSS(payload, null);
-          } else if (payload && typeof payload === 'object') {
-            setCustomCSS(payload.css, payload.nonce);
-          }
-          break;
-        
-        case 'set-diagnostic-logs':
-          setDiagnosticLogs(payload);
-          break;
-        case 'set-url-validation':
-          urlValidationEnabled = payload === true;
-          log(`URL validation ${urlValidationEnabled ? 'enabled' : 'disabled'}`);
-          break;
-        
-        default:
-          log(`Unknown action: ${action}`, 'warn');
-      }
-    } catch (error) {
-      log(`Error in updateControl for action ${action}: ${error.message}`, 'error');
-      throw error;
-    }
-  }
-  // #endregion
-
-  // #region Button Visibility Functions
-  function updateDownloadButton(visible) {
-    const button = document.getElementById('downloadButton');
-    const secondaryButton = document.getElementById('secondaryDownload');
-    if (button) {
-      button.classList.toggle('hidden', !visible);
-    }
-    if (secondaryButton) {
-      secondaryButton.classList.toggle('hidden', !visible);
-      }
-  }
-
-  function updatePrintButton(visible) {
-    const button = document.getElementById('printButton');
-    const secondaryButton = document.getElementById('secondaryPrint');
-    if (button) {
-      button.classList.toggle('hidden', !visible);
-    }
-    if (secondaryButton) {
-      secondaryButton.classList.toggle('hidden', !visible);
-      }
-  }
-
-  function updateFullScreenButton(visible) {
-    const button = document.getElementById('presentationMode');
-    if (button) {
-      button.classList.toggle('hidden', !visible);
-      }
-  }
-
-  function updateFindButton(visible) {
-    const button = document.getElementById('viewFindButton');
-    if (button) {
-      button.classList.toggle('hidden', !visible);
-      }
-  }
-
-  function updateBookmarkButton(visible) {
-    const button = document.getElementById('viewBookmark');
-    if (button) {
-      button.classList.toggle('hidden', !visible);
-      }
-  }
-
-  function updateOpenFileButton(visible) {
-    const button = document.getElementById('openFile');
-    const secondaryButton = document.getElementById('secondaryOpenFile');
-    if (button) {
-      button.classList.toggle('hidden', !visible);
-    }
-    if (secondaryButton) {
-      secondaryButton.classList.toggle('hidden', !visible);
-      }
-  }
-  function updateAnnotationsButton(visible) {
-    // Handle annotations button visibility
-    // This might need to be implemented based on the specific annotation system
-    log(`Annotations button visibility set to: ${visible}`);
-  }
-  // #endregion
-
-  // #region Mode Control Functions
-  function updateZoom(zoom) {
-    const app = PDFViewerApplication;
-    if (!app || !app.pdfViewer || !app.eventBus) {
-      log('PDFViewerApplication, pdfViewer, or eventBus not ready for zoom update', 'warn');
-      return;
-    }
-
-    // Mark zoom command as active to prevent infinite loop
-    ZoomCommandTracker.markZoomCommandStart();
-    
-    try {
-      // Acceptable values: "auto", "page-fit", "page-width", "page-actual", "page-height", or a number/string number like "1.25"
-      const validStringZooms = ['auto', 'page-actual', 'page-fit', 'page-width', 'page-height'];
-      
-      // Check if it's a valid string zoom
-      if (validStringZooms.includes(zoom)) {
-        // Dispatch the scalechanged event exactly like the UI does
-        app.eventBus.dispatch("scalechanged", {
-          source: app.toolbar,  // Use toolbar as source, just like the UI does
-          value: zoom
-        });
-        return;
-      }
-      
-      // Check if it's a valid numeric zoom (including decimal strings like "1.25")
-      const numericZoom = Number(zoom);
-      if (!isNaN(numericZoom) && numericZoom > 0) {
-        // Dispatch the scalechanged event exactly like the UI does
-        app.eventBus.dispatch("scalechanged", {
-          source: app.toolbar,  // Use toolbar as source, just like the UI does
-          value: zoom
-        });
-        return;
-      }
-      
-      // If we get here, it's invalid
-      log(`Invalid zoom value: ${zoom}`, 'warn');
-    } finally {
-      // Always clear the command flag, even if there's an error
-      ZoomCommandTracker.markZoomCommandEnd();
-    }
-  }
-
-  function updateCursor(cursor) {
-    // Universal Dispatcher guarantees PDFViewerApplication availability at readiness level 4
-    const app = PDFViewerApplication;
-    
-    try {
-      const cursorTool = cursor ? cursor.toUpperCase() : 'SELECT';
-      
-      let toolId = 0; // Default to SELECT
-      switch (cursorTool) {
-        case 'HAND':
-        case 'H':
-          toolId = 1; // HAND
-            break;
-        case 'SELECT':
-        case 'S':
-          toolId = 0; // SELECT
-            break;
-        case 'ZOOM':
-        case 'Z':
-          toolId = 2; // ZOOM  
-            break;
-          default:
-          log(`Unknown cursor tool: ${cursorTool}, defaulting to SELECT`, 'warn');
-          toolId = 0;
-      }
-      
-      // Update cursor using event bus dispatch (PDF.js v4.x)
-      if (app.eventBus && typeof app.eventBus.dispatch === 'function') {
-          app.eventBus.dispatch('switchcursortool', {
-            tool: toolId
-          });
-      } else {
-        log('EventBus not available for cursor update', 'warn');
-      }
-    } catch (error) {
-      log(`Error updating cursor: ${error.message}`, 'error');
-    }
-  }
-
-  function updateScroll(scroll) {
-    // Universal Dispatcher guarantees PDFViewerApplication availability at readiness level 4
-    
-    try {
-      const scrollMode = scroll ? scroll.toUpperCase() : 'VERTICAL';
-      log(`Attempting to update scroll mode to: ${scrollMode}`);
-      
-      if (PDFViewerApplication.eventBus) {
-        // Use PDF.js v4.x event bus dispatch for scroll mode switching
-        switch (scrollMode) {
-          case 'VERTICAL':
-          case 'V':
-            log('Dispatching switchscrollmode with VERTICAL mode');
-            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
-              mode: 0 // ScrollMode.VERTICAL
-            });
-            break;
-          case 'HORIZONTAL':
-          case 'H':
-            log('Dispatching switchscrollmode with HORIZONTAL mode');
-            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
-              mode: 1 // ScrollMode.HORIZONTAL
-            });
-            break;
-          case 'WRAPPED':
-          case 'W':
-            log('Dispatching switchscrollmode with WRAPPED mode');
-            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
-              mode: 2 // ScrollMode.WRAPPED
-            });
-            break;
-          case 'PAGE':
-          case 'P':
-            log('Dispatching switchscrollmode with PAGE mode');
-            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
-              mode: 3 // ScrollMode.PAGE
-            });
-            break;
-          default:
-            log(`Unknown scroll mode: ${scrollMode}, defaulting to VERTICAL`, 'warn');
-            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
-              mode: 0
-            });
-        }
-      } else {
-        // Fallback to direct property setting if event bus not available
-      if (PDFViewerApplication.pdfViewer) {
-          switch (scrollMode) {
-            case 'VERTICAL':
-            case 'V':
-              PDFViewerApplication.pdfViewer.scrollMode = 0;
-              break;
-            case 'HORIZONTAL':
-            case 'H':
-              PDFViewerApplication.pdfViewer.scrollMode = 1;
-              break;
-            case 'WRAPPED':
-            case 'W':
-              PDFViewerApplication.pdfViewer.scrollMode = 2;
-              break;
-            case 'PAGE':
-            case 'P':
-              PDFViewerApplication.pdfViewer.scrollMode = 3;
-              break;
-          }
-        }
-      }
-      
-      log(`Scroll mode update completed for: ${scrollMode}`);
-    } catch (error) {
-      log(`Error updating scroll mode: ${error.message}`, 'error');
-    }
-  }
-
-  function updateSpread(spread) {
-    // Universal Dispatcher guarantees PDFViewerApplication availability at readiness level 4
-    
-    try {
-      const spreadMode = spread ? spread.toUpperCase() : 'NONE';
-      log(`Attempting to update spread mode to: ${spreadMode}`);
-      
-      if (PDFViewerApplication.eventBus) {
-        // Use PDF.js v4.x event bus dispatch for spread mode switching
-        switch (spreadMode) {
-          case 'NONE':
-          case 'N':
-            log('Dispatching switchspreadmode with NONE mode');
-            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
-              mode: 0 // SpreadMode.NONE
-            });
-            break;
-          case 'ODD':
-          case 'O':
-            log('Dispatching switchspreadmode with ODD mode');
-            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
-              mode: 1 // SpreadMode.ODD
-            });
-            break;
-          case 'EVEN':
-          case 'E':
-            log('Dispatching switchspreadmode with EVEN mode');
-            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
-              mode: 2 // SpreadMode.EVEN
-            });
-            break;
-          default:
-            log(`Unknown spread mode: ${spreadMode}, defaulting to NONE`, 'warn');
-            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
-              mode: 0
-            });
-        }
-      } else {
-        // Fallback to direct property setting if event bus not available
-      if (PDFViewerApplication.pdfViewer) {
-          switch (spreadMode) {
-            case 'NONE':
-            case 'N':
-              PDFViewerApplication.pdfViewer.spreadMode = 0;
-              break;
-            case 'ODD':
-            case 'O':
-              PDFViewerApplication.pdfViewer.spreadMode = 1;
-              break;
-            case 'EVEN':
-            case 'E':
-              PDFViewerApplication.pdfViewer.spreadMode = 2;
-              break;
-          }
-        }
-      }
-      
-      log(`Spread mode update completed for: ${spreadMode}`);
-    } catch (error) {
-      log(`Error updating spread mode: ${error.message}`, 'error');
-    }
-  }
-  // #endregion
-
-  // Note: Legacy navigation and auto-action functions removed.
-  // All functionality now handled through the main updateControl switch statement
-  // which trusts the Universal Dispatcher's readiness guarantees.
-
-  // #region Error Handling Functions
-  // Error state is managed internally and communicated via PostMessage
-  // No need for global window variables - events drive the behavior
-  function setErrorMessage(message) {
-    // Error messages are sent directly via PostMessage when errors occur
-    // No need to store in global variables
-  }
-
-  function setErrorOverride(override) {
-    // Error override is handled by the Angular component
-    // No need to store in global variables
-  }
-
-  function setErrorAppend(append) {
-    // Error append is handled by the Angular component
-    // No need to store in global variables
-  }
-  // #endregion
-
-  // #region CSS Zoom Functions
-
-  function setCssZoom(useCssZoom) {
-    try {
-      if (PDFViewerApplication && PDFViewerApplication.pdfViewer) {
-        // Set CSS zoom mode
-        PDFViewerApplication.pdfViewer.useOnlyCssZoom = useCssZoom === true;
-      } else {
-        // CSS zoom will be set when viewer becomes ready via readiness-based dispatch
-        // No need to store in global variables
-      }
-    } catch (error) {
-      log(`Error setting CSS zoom: ${error.message}`, 'error');
-    }
-  }
-
-  function setDownloadFilename(filename) {
-    try {
-      if (filename && PDFViewerApplication) {
-        // Ensure filename ends with .pdf if not already present
-        const processedFilename = filename.endsWith('.pdf') ? filename : `${filename}.pdf`;
-        
-        // Set the content disposition filename that PDF.js uses for downloads
-        PDFViewerApplication._contentDispositionFilename = processedFilename;
-      } else {
-        log('Cannot set download filename - invalid filename or PDFViewerApplication not available', 'warn');
-      }
-    } catch (error) {
-      log(`Error setting download filename: ${error.message}`, 'error');
-    }
-  }
-  // #endregion
-
-  // #region Event Configuration Functions
-  // Event enablement state stored locally (not in global window variables)
-  // This follows v5-upgrade.md principles while maintaining functionality
-  
-  // Local state for event enablement
-  const eventEnablement = {
-    beforePrint: false,
-    afterPrint: false,
-    pagesLoaded: false,
-    pageChange: false,
-    documentError: false,
-    documentInit: false,
-    pagesInit: false,
-    presentationModeChanged: false,
-    openFile: false,
-    find: false,
-    updateFindMatchesCount: false,
-    metadataLoaded: false,
-    outlineLoaded: false,
-    pageRendered: false,
-    annotationLayerRendered: false,
-    bookmarkClick: false,
-    idle: false
-  };
-  
-  function enableBeforePrint(enable) { eventEnablement.beforePrint = enable === true; }
-  function enableAfterPrint(enable) { eventEnablement.afterPrint = enable === true; }
-  function enablePagesLoaded(enable) { eventEnablement.pagesLoaded = enable === true; }
-  function enablePageChange(enable) { eventEnablement.pageChange = enable === true; }
-  function enableDocumentError(enable) { eventEnablement.documentError = enable === true; }
-  function enableDocumentInit(enable) { eventEnablement.documentInit = enable === true; }
-  function enablePagesInit(enable) { eventEnablement.pagesInit = enable === true; }
-  function enablePresentationModeChanged(enable) { eventEnablement.presentationModeChanged = enable === true; }
-  function enableOpenFile(enable) { eventEnablement.openFile = enable === true; }
-  function enableFind(enable) { eventEnablement.find = enable === true; }
-  function enableUpdateFindMatchesCount(enable) { eventEnablement.updateFindMatchesCount = enable === true; }
-  function enableMetadataLoaded(enable) { eventEnablement.metadataLoaded = enable === true; }
-  function enableOutlineLoaded(enable) { eventEnablement.outlineLoaded = enable === true; }
-  function enablePageRendered(enable) { eventEnablement.pageRendered = enable === true; }
-  function enableAnnotationLayerRendered(enable) { eventEnablement.annotationLayerRendered = enable === true; }
-  function enableBookmarkClick(enable) { eventEnablement.bookmarkClick = enable === true; }
-  function enableIdle(enable) { eventEnablement.idle = enable === true; }
-  // #endregion
-
-  // #region Theme & Visual Customization Functions
-  
-  // Theme management variables
-  let currentTheme = 'light';
-  
-  function setTheme(theme) {
-    currentTheme = theme || 'light';
-    
-    // Apply theme-specific CSS classes (CSP-safe)
-    const body = document.body;
-    if (body) {
-      // Remove ALL theme classes including active states
-      body.classList.remove('ng2-theme-light', 'ng2-theme-dark', 'ng2-theme-auto', 
-                           'ng2-theme-dark-active', 'ng2-theme-light-active');
-      
-      // Add new theme class
-      body.classList.add(`ng2-theme-${currentTheme}`);
-      
-      // Apply auto theme detection
-      if (currentTheme === 'auto') {
-        const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-        const activeClass = prefersDark ? 'ng2-theme-dark-active' : 'ng2-theme-light-active';
-        body.classList.add(activeClass);
-        
-        // Listen for theme changes
-        if (!window.ng2ThemeMediaListener) {
-          const mediaListener = window.matchMedia('(prefers-color-scheme: dark)');
-          mediaListener.addListener((e) => {
-            if (currentTheme === 'auto') {
-              body.classList.remove('ng2-theme-dark-active', 'ng2-theme-light-active');
-              const newActiveClass = e.matches ? 'ng2-theme-dark-active' : 'ng2-theme-light-active';
-              body.classList.add(newActiveClass);
-            }
-          });
-          window.ng2ThemeMediaListener = mediaListener;
-        }
-      }
-      
-      // Force style recalculation
-      body.offsetHeight; // Trigger reflow
-    }
-    
-    // Note: Theme styles now loaded from external ng2-customization.css (CSP-safe)
-  }
-  
-  function setPrimaryColor(color) {
-    setCSSVariable('--ng2-primary-color', color);
-  }
-  
-  function setBackgroundColor(color) {
-    setCSSVariable('--ng2-background-color', color);
-  }
-  
-  function setPageSpacing(margin, spreadMargin, border) {
-    if (margin !== undefined) {
-      setCSSVariable('--page-margin', margin);
-    }
-    if (spreadMargin !== undefined) {
-      setCSSVariable('--spreadHorizontalWrapped-margin-LR', spreadMargin);
-    }
-    if (border !== undefined) {
-      setCSSVariable('--page-border', border);
-    }
-  }
-  
-  function setPageBorderColor(color) {
-    setCSSVariable('--ng2-page-border-color', color);
-  }
-  
-  function setToolbarColor(color) {
-    setCSSVariable('--ng2-toolbar-color', color);
-  }
-  
-  function setTextColor(color) {
-    setCSSVariable('--ng2-text-color', color);
-  }
-  
-  function setBorderRadius(radius) {
-    setCSSVariable('--ng2-border-radius', radius);
-  }
-  
-  function setCustomCSS(css, nonce) {
-    // Remove existing custom CSS
-    const existingStyle = document.getElementById('ng2-custom-css');
-    if (existingStyle) {
-      existingStyle.remove();
-    }
-    
-    // Apply new custom CSS with optional nonce for CSP support
-    if (css) {
-      const style = document.createElement('style');
-      style.id = 'ng2-custom-css';
-      style.textContent = css;
-      
-      // Add nonce if provided (CSP support)
-      if (nonce) {
-        style.setAttribute('nonce', nonce);
-      }
-      
-      document.head.appendChild(style);
-    }
-  }
-  
-  // Helper function to set CSS custom properties
-  function setCSSVariable(property, value) {
-    if (value) {
-      document.documentElement.style.setProperty(property, value);
-      // Also set on body for better compatibility
-      document.body.style.setProperty(property, value);
-    } else {
-      document.documentElement.style.removeProperty(property);
-      document.body.style.removeProperty(property);
-    }
-  }
-  
-  // Note: Theme styles now loaded from external ng2-customization.css (CSP-safe)
-  
-  // #endregion
-
-  // #region Error Event Listeners (Early Setup)
-  let errorListenersSetup = false; // Flag to prevent multiple setups
-  
-  function setupErrorEventListeners() {
-    // Prevent multiple setups
-    if (errorListenersSetup) {
-      return;
-    }
-    
-    const app = PDFViewerApplication;
-    if (!app || !app.eventBus) {
-      log('Cannot setup error listeners: EventBus not available', 'warn');
-      return;
-    }
-
-    // Listen for document errors (including file origin errors)
-    app.eventBus.on('documenterror', (event) => {
-      log(`🔴 DOCUMENT ERROR EVENT FIRED: ${event.message}`, 'error');
-      // Always hide loading spinner on document error
-      sendStateChangeNotification('loading', false, 'system');
-      
-      // Send error state notification for custom error display
-      const errorMessage = event.message || 'An error occurred while loading the PDF.';
-      sendStateChangeNotification('error', errorMessage, 'system');
-      
-      // Send document error events only if enabled
-      if (eventEnablement.documentError) {
-        log(`Document error event received: ${event.message}`);
-        const errorData = {
-          message: event.message || 'Unknown document error',
-          source: event.source ? 'PDFViewerApplication' : 'unknown',
-          name: event.name || 'DocumentError'
-        };
-        sendEventNotification('documentError', errorData);
-      }
-    });
-
-    // Listen for other potential error events
-    app.eventBus.on('loaderror', (event) => {
-      log(`🔴 LOAD ERROR EVENT FIRED: ${event.message}`, 'error');
-      // Hide loading spinner on load error
-      sendStateChangeNotification('loading', false, 'system');
-    });
-
-    app.eventBus.on('error', (event) => {
-      log(`🔴 GENERIC ERROR EVENT FIRED: ${event.message}`, 'error');
-      // Hide loading spinner on any error
-      sendStateChangeNotification('loading', false, 'system');
-    });
-
-    errorListenersSetup = true;
-    log('Error event listeners set up successfully', 'info');
-  }
-
-  // #region Bidirectional Event Listeners
-  let bidirectionalListenersSetup = false; // Flag to prevent multiple setups
-  
-  function setupBidirectionalEventListeners() {
-    // Prevent multiple setups
-    if (bidirectionalListenersSetup) {
-      return;
-    }
-
-    // Add global error handler for iframe-level errors
-    window.addEventListener('error', (event) => {
-      log(`🔴 GLOBAL ERROR: ${event.message}`, 'error');
-      // Hide loading spinner on any global error
-      sendStateChangeNotification('loading', false, 'system');
-    });
-
-    window.addEventListener('unhandledrejection', (event) => {
-      log(`🔴 UNHANDLED PROMISE REJECTION: ${event.reason}`, 'error');
-      // Hide loading spinner on unhandled promise rejection
-      sendStateChangeNotification('loading', false, 'system');
-    });
-    
-    bidirectionalListenersSetup = true;
-    const app = PDFViewerApplication;
-    if (!app || !app.eventBus) {
-      log('Cannot setup bidirectional listeners: EventBus not available', 'warn');
-      return;
-    }
-
-    
-    // Test sending a state change notification immediately
-    sendStateChangeNotification('test', 'initial-setup', 'system');
-
-    // Cursor tool changes are handled via switchcursortool event listener only
-
-    // Note: Scroll and spread mode changes are handled via event listeners
-    // No method interception needed for PDF.js v5.3.93
-    if (app.pdfViewer) {
-      
-      // Monitor scroll mode changes - setScrollMode doesn't exist in v5.3.93
-      // The scroll mode changes are handled via event listeners instead
-
-      // Spread mode changes are handled via switchspreadmode event listener only
-
-      // Monitor zoom changes via currentScale property
-      let lastKnownScale = app.pdfViewer.currentScale;
-      const originalSetCurrentScale = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(app.pdfViewer), 'currentScale');
-      if (originalSetCurrentScale && originalSetCurrentScale.set) {
-        Object.defineProperty(app.pdfViewer, 'currentScale', {
-          get: originalSetCurrentScale.get,
-          set: function(scale) {
-            const result = originalSetCurrentScale.set.call(this, scale);
-            
-            if (scale !== lastKnownScale) {
-              lastKnownScale = scale;
-              
-              // Use enhanced zoom transformation
-              const zoomValue = transformZoomFromViewer(scale, app);
-              
-              log(`Zoom changed via currentScale to: ${zoomValue} (scale: ${scale}, currentScaleValue: ${app.pdfViewer.currentScaleValue})`);
-              sendStateChangeNotification('zoom', zoomValue, 'user');
-            }
-            
-            return result;
-          },
-          configurable: true,
-          enumerable: true
-        });
-        } else {
-        log('pdfViewer.currentScale setter not found', 'warn');
-      }
-    } else {
-      log('pdfViewer not available', 'warn');
-    }
-
-    // Listen for sidebar/page mode changes
-    if (app.pdfSidebar) {
-      
-      // Monitor sidebar view changes
-      const originalSetView = app.pdfSidebar.setView;
-      if (originalSetView) {
-        app.pdfSidebar.setView = function(view) {
-          const result = originalSetView.apply(this, arguments);
-          
-          // Map PDF.js sidebar view numbers to our page mode names
-          const pageModeMap = {
-            0: 'none',        // SidebarView.NONE
-            1: 'thumbs',      // SidebarView.THUMBS
-            2: 'bookmarks',   // SidebarView.OUTLINE
-            3: 'attachments', // SidebarView.ATTACHMENTS
-            4: 'layers'       // SidebarView.LAYERS
-          };
-          
-          const pageModeName = pageModeMap[view] || 'none';
-          log(`Page mode changed to: ${pageModeName} (view: ${view})`);
-          sendStateChangeNotification('pageMode', pageModeName, 'user');
-          
-          return result;
-        };
-        } else {
-    }
-    } else {
-      log('pdfSidebar not available', 'warn');
-    }
-
-    // Listen for additional PDF.js events that might indicate property changes
-    if (app.eventBus) {
-      
-      // Listen for scale changing events with intelligent user vs programmatic detection
-      app.eventBus.on('scalechanging', (event) => {
-
-        
-        // Skip notification if this is from our own zoom command
-        if (ZoomCommandTracker.isZoomCommandActive()) {
-          log('Skipping zoom notification - programmatic change from our command');
-          return;
-        }
-        
-        // Use event context to determine if this is a user-initiated change
-        let isUserInitiated = false;
-        let zoomValue;
-        
-        if (event.presetValue && typeof event.presetValue === 'string') {
-          // User clicked zoom buttons (Page Fit, Page Width, Auto, etc.)
-
-          isUserInitiated = true;
-          zoomValue = event.presetValue;
-        } else if (typeof event.scale === 'number' && !event.presetValue) {
-          // Could be mouse wheel (user) or other programmatic change
-          // For now, assume it's user-initiated (mouse wheel, etc.)
-          // Future enhancement: could add more sophisticated detection
-          log('Assuming user-initiated scale change (mouse wheel, etc.)');
-          isUserInitiated = true;
-          zoomValue = transformZoomFromViewer(event.scale, app);
-        }
-        
-        if (isUserInitiated) {
-
-          sendStateChangeNotification('zoom', zoomValue, 'user');
-      } else {
-          log('Skipping zoom notification - not identified as user-initiated');
-        }
-      });
-
-      // Listen for other relevant events
-      app.eventBus.on('switchscrollmode', (event) => {
-        
-        const scrollMap = {
-          0: 'vertical',   // ScrollMode.VERTICAL
-          1: 'horizontal', // ScrollMode.HORIZONTAL
-          2: 'wrapped',    // ScrollMode.WRAPPED
-          3: 'page'        // ScrollMode.PAGE
-        };
-        
-        const scrollName = scrollMap[event.mode] || 'vertical';
-        log(`Scroll mode changed via event to: ${scrollName}`);
-        sendStateChangeNotification('scroll', scrollName, 'user');
-      });
-
-      app.eventBus.on('switchspreadmode', (event) => {
-        
-        const spreadMap = {
-          0: 'none', // SpreadMode.NONE
-          1: 'odd',  // SpreadMode.ODD
-          2: 'even'  // SpreadMode.EVEN
-        };
-        
-        const spreadName = spreadMap[event.mode] || 'none';
-        log(`Spread mode changed via event to: ${spreadName}`);
-        sendStateChangeNotification('spread', spreadName, 'user');
-      });
-
-      app.eventBus.on('switchcursortool', (event) => {
-        
-        const cursorMap = {
-          0: 'select', // CursorTool.SELECT
-          1: 'hand',   // CursorTool.HAND
-          2: 'zoom'    // CursorTool.ZOOM
-        };
-        
-        const cursorName = cursorMap[event.tool] || 'select';
-        log(`Cursor changed via event to: ${cursorName}`);
-        sendStateChangeNotification('cursor', cursorName, 'user');
-      });
-
-      app.eventBus.on('sidebarviewchanged', (event) => {
-        
-        const pageModeMap = {
-          0: 'none',        // SidebarView.NONE
-          1: 'thumbs',      // SidebarView.THUMBS
-          2: 'bookmarks',   // SidebarView.OUTLINE
-          3: 'attachments', // SidebarView.ATTACHMENTS
-          4: 'layers'       // SidebarView.LAYERS
-        };
-        
-        const pageModeName = pageModeMap[event.view] || 'none';
-        log(`Page mode changed via event to: ${pageModeName}`);
-        sendStateChangeNotification('pageMode', pageModeName, 'user');
-      });
-
-      // Listen for rotation changes (when user rotates via UI or programmatically)
-      app.eventBus.on('rotationchanging', (event) => {
-        log(`Rotation changed via event to: ${event.pagesRotation}`);
-        sendStateChangeNotification('rotation', event.pagesRotation, 'user');
-      });
-
-      // Note: Error event listeners are set up earlier in setupErrorEventListeners()
-
-      app.eventBus.on('documentinit', (event) => {
-        // Send document init events only if enabled
-        if (eventEnablement.documentInit) {
-          sendEventNotification('documentInit', null);
-        }
-      });
-
-      app.eventBus.on('pagesinit', (event) => {
-        // Send pages init events only if enabled
-        if (eventEnablement.pagesInit) {
-          const pageCount = app.pagesCount || 0;
-          const pagesData = {
-            pagesCount: pageCount
-          };
-          sendEventNotification('pagesInit', pagesData);
-        }
-      });
-
-      app.eventBus.on('presentationmodechanged', (event) => {
-        // Send presentation mode events only if enabled
-        if (eventEnablement.presentationModeChanged) {
-          // Map PDF.js PresentationModeState to boolean
-          // FULLSCREEN = 3, CHANGING = 2, NORMAL = 1, UNKNOWN = 0
-          const isActive = event.state === 3; // PresentationModeState.FULLSCREEN
-          const isChanging = event.state === 2; // PresentationModeState.CHANGING
-          const presentationData = {
-            active: isActive,
-            switchInProgress: isChanging
-          };
-          sendEventNotification('presentationModeChanged', presentationData);
-        }
-      });
-
-      app.eventBus.on('fileinputchange', (event) => {
-        // Send open file events only if enabled
-        if (eventEnablement.openFile) {
-          sendEventNotification('openFile', null);
-        }
-      });
-
-      app.eventBus.on('find', (event) => {
-        // Send find events only if enabled
-        if (eventEnablement.find) {
-          const findData = {
-            query: event.query || '',
-            phraseSearch: false, // Not available in PDF.js v5.3.93
-            caseSensitive: event.caseSensitive || false,
-            entireWord: event.entireWord || false,
-            highlightAll: event.highlightAll || false,
-            findPrevious: event.findPrevious || false
-          };
-          sendEventNotification('find', findData);
-        }
-      });
-
-      app.eventBus.on('updatefindmatchescount', (event) => {
-        // Send find matches count events only if enabled
-        if (eventEnablement.updateFindMatchesCount) {
-          const countData = {
-            current: event.matchesCount?.current || 0,
-            total: event.matchesCount?.total || 0
-          };
-          sendEventNotification('updateFindMatchesCount', countData);
-        }
-      });
-
-      app.eventBus.on('metadataloaded', (event) => {
-        // Send metadata loaded events only if enabled
-        if (eventEnablement.metadataLoaded) {
-          const info = app.documentInfo;
-          const metadataData = {
-            title: info?.Title,
-            author: info?.Author,
-            subject: info?.Subject,
-            keywords: info?.Keywords,
-            creator: info?.Creator,
-            producer: info?.Producer,
-            creationDate: info?.CreationDate,
-            modificationDate: info?.ModDate,
-            pdfFormatVersion: info?.PDFFormatVersion,
-            isLinearized: info?.IsLinearized,
-            isAcroFormPresent: info?.IsAcroFormPresent,
-            isXFAPresent: info?.IsXFAPresent,
-            isCollectionPresent: info?.IsCollectionPresent
-          };
-          sendEventNotification('metadataLoaded', metadataData);
-        }
-      });
-
-      app.eventBus.on('outlineloaded', (event) => {
-        // Send outline loaded events only if enabled
-        if (eventEnablement.outlineLoaded) {
-          const outlineData = {
-            items: [], // Outline items are not available in the event, but consumers can check hasOutline
-            hasOutline: (event.outlineCount || 0) > 0
-          };
-          sendEventNotification('outlineLoaded', outlineData);
-        }
-      });
-
-      app.eventBus.on('pagerendered', (event) => {
-        // Send page rendered events only if enabled
-        if (eventEnablement.pageRendered) {
-          const renderData = {
-            pageNumber: event.pageNumber || 1,
-            // Don't include source as it contains canvas element that can't be cloned
-        timestamp: Date.now()
-          };
-          sendEventNotification('pageRendered', renderData);
-        }
-      });
-
-      // Loading state integration for overlay control
-      // Event-driven only; idempotent notifications, no flags or polling
-      app.eventBus.on('documentinit', () => sendStateChangeNotification('loading', true, 'system'));
-      app.eventBus.on('pagesinit', () => sendStateChangeNotification('loading', true, 'system'));
-      app.eventBus.on('pagerendered', () => sendStateChangeNotification('loading', false, 'system'));
-      app.eventBus.on('pagesloaded', () => sendStateChangeNotification('loading', false, 'system'));
-
-      // New high-value events
-      
-      // Annotation Layer Rendered - Native PDF.js event
-      app.eventBus.on('annotationlayerrendered', (event) => {
-        // Send annotation layer rendered events only if enabled
-        if (eventEnablement.annotationLayerRendered) {
-          const renderData = {
-            pageNumber: event.pageNumber || 1,
-            error: event.error || null,
-            timestamp: performance.now()
-          };
-          sendEventNotification('annotationLayerRendered', renderData);
-        }
-      });
-      
-      // Reset idle timer when PDF document changes (event-driven approach)
-      // Set up idle timer only if enabled
-      if (eventEnablement.idle) {
-        app.eventBus.on('documentloaded', () => {
-          if (typeof resetIdleTimer === 'function') {
-            resetIdleTimer();
-            log('Idle timer reset on document load');
-          }
-        });
-      }
-    }
-
-    // Initialize custom event implementations
-    initializeCustomEvents(app);
-
-
-  }
-
-  // Initialize custom event implementations
-  function initializeCustomEvents(app) {
-    setupIdleDetection();
-    interceptOutlineClicks(app);
-  }
-
-  // Idle Detection - Custom activity tracking
-  let idleTimer = null;
-  let idleListenersSetup = false;
-  let idleCleanupListeners = []; // Track listeners for cleanup
-  const IDLE_TIMEOUT = 30000; // 30 seconds default
-
-  function resetIdleTimer() {
-    if (idleTimer) {
-      clearTimeout(idleTimer);
-      idleTimer = null;
-    }
-    // Set up idle timer only if enabled
-    if (eventEnablement.idle) {
-      idleTimer = setTimeout(() => {
-        sendEventNotification('idle', null);
-      }, IDLE_TIMEOUT);
-    }
-  }
-
-  function cleanupIdleDetection() {
-    // Clear timer
-    if (idleTimer) {
-      clearTimeout(idleTimer);
-      idleTimer = null;
-    }
-    
-    // Remove all tracked event listeners
-    idleCleanupListeners.forEach(({ element, event, handler, options }) => {
-      element.removeEventListener(event, handler, options);
-    });
-    idleCleanupListeners = [];
-    idleListenersSetup = false;
-    
-    log('Idle detection cleanup completed');
-  }
-
-  function setupIdleDetection() {
-    // Prevent multiple setups
-    if (idleListenersSetup) {
-      log('Idle detection already setup, skipping');
-      return;
-    }
-    
-    idleListenersSetup = true;
-    
-    // Helper to add and track event listeners
-    const addTrackedListener = (element, event, handler, options) => {
-      element.addEventListener(event, handler, options);
-      idleCleanupListeners.push({ element, event, handler, options });
-    };
-
-    // Track mouse activity
-    addTrackedListener(document, 'mousemove', resetIdleTimer, { passive: true });
-    addTrackedListener(document, 'mousedown', resetIdleTimer, { passive: true });
-    addTrackedListener(document, 'click', resetIdleTimer, { passive: true });
-    
-    // Track keyboard activity  
-    addTrackedListener(document, 'keydown', resetIdleTimer, { passive: true });
-    addTrackedListener(document, 'keypress', resetIdleTimer, { passive: true });
-    
-    // Track scroll activity
-    addTrackedListener(document, 'scroll', resetIdleTimer, { passive: true });
-    addTrackedListener(document, 'wheel', resetIdleTimer, { passive: true });
-    
-    // Track touch activity
-    addTrackedListener(document, 'touchstart', resetIdleTimer, { passive: true });
-    addTrackedListener(document, 'touchmove', resetIdleTimer, { passive: true });
-    
-    // Start initial timer
-    resetIdleTimer();
-
-    // Cleanup on document unload
-    const unloadHandler = () => {
-      cleanupIdleDetection();
-    };
-    addTrackedListener(window, 'beforeunload', unloadHandler, { passive: true });
-
-
-  }
-
-  // Bookmark Click - Intercept outline item clicks
-  let bookmarkInterceptionSetup = false;
-  
-  function interceptOutlineClicks(app) {
-    // Prevent multiple setups
-    if (bookmarkInterceptionSetup) {
-      log('Bookmark click interception already setup, skipping');
-      return;
-    }
-    
-    // Check if PDF outline viewer is available immediately
-    if (app && app.pdfOutlineViewer && app.pdfOutlineViewer._bindLink) {
-      const originalBindLink = app.pdfOutlineViewer._bindLink;
-      
-      app.pdfOutlineViewer._bindLink = function(element, params) {
-        // Call original bind method first
-        originalBindLink.call(this, element, params);
-        
-        // Intercept bookmark clicks only if enabled
-        if (eventEnablement.bookmarkClick) {
-          const originalOnClick = element.onclick;
-          element.onclick = function(evt) {
-            // Extract bookmark data
-            const bookmarkData = {
-              title: element.textContent?.trim() || 'Unknown',
-              dest: params.dest || null,
-              action: params.action || undefined,
-              url: params.url || undefined,
-              pageNumber: undefined, // Will be resolved by linkService
-              isCurrentItem: element.classList.contains('currentTreeItem')
-            };
-            
-            log(`Bookmark clicked: ${bookmarkData.title}`);
-            sendEventNotification('bookmarkClick', bookmarkData);
-            
-            // Call original handler to preserve navigation functionality
-            if (originalOnClick) {
-              return originalOnClick.call(this, evt);
-            }
-            return false;
-          };
-        }
-      };
-      
-      bookmarkInterceptionSetup = true;
-
-    } else {
-      // If outline viewer is not available yet, defer setup using event-driven approach
-      // Hook into outlineloaded event to retry when outline becomes available
-      if (app && app.eventBus) {
-        const outlineLoadedHandler = () => {
-          if (!bookmarkInterceptionSetup) {
-            interceptOutlineClicks(app); // Retry when outline is loaded
-          }
-        };
-        app.eventBus.on('outlineloaded', outlineLoadedHandler);
-        log('Bookmark click interception deferred until outline loads');
-      } else {
-        log('Unable to setup bookmark click interception - event bus not available', 'warn');
-      }
-    }
-  }
-  // #endregion
-
-  // Start the initialization process
-  waitForViewer();
+(function() {
+  'use strict';
+  
+  // This will be wrapped in diagnostic logs check after diagnosticLogs is set
+  
+  // #region URL Security Validation
+  let originalFileUrl = null;
+  let urlValidationEnabled = true;
+  
+  function initializeUrlValidation() {
+    // Get the initial file URL from query parameters
+    const urlParams = new URLSearchParams(window.location.search);
+    const currentFileUrl = urlParams.get('file');
+    
+    // Check if we already have a stored original URL
+    const storedOriginalUrl = sessionStorage.getItem('ng2-pdfjs-viewer-original-file-url');
+    
+    if (storedOriginalUrl) {
+      // Use the stored original URL (from previous page load)
+      originalFileUrl = storedOriginalUrl;
+    } else if (currentFileUrl) {
+      // Store the current URL as the original (first time loading)
+      originalFileUrl = currentFileUrl;
+      sessionStorage.setItem('ng2-pdfjs-viewer-original-file-url', originalFileUrl);
+    }
+  }
+  
+  function validateCurrentUrl() {
+    if (!urlValidationEnabled || !originalFileUrl) {
+      return true; // Skip validation if disabled or no original URL
+    }
+    
+    const currentFileParam = new URLSearchParams(window.location.search).get('file');
+    
+    // Compare the file parameter specifically
+    if (currentFileParam !== originalFileUrl) {
+      console.error('🚨 SECURITY ALERT: File URL has been modified!');
+      console.error('Original:', originalFileUrl);
+      console.error('Current:', currentFileParam);
+      
+      // Prevent loading and show error
+      showSecurityError('Unauthorized file access detected. The file URL has been tampered with.');
+      return false;
+    }
+    
+    return true;
+  }
+  
+  function showSecurityError(message) {
+    // Simple console warning (less intrusive)
+    console.warn('🚨 Security Warning:', message);
+    
+    // Send notification to parent window for Angular template handling
+    if (window.parent && window.parent !== window) {
+      window.parent.postMessage({
+        type: 'ng2-pdfjs-viewer-security-warning',
+        message: message,
+        originalUrl: originalFileUrl,
+        currentUrl: new URLSearchParams(window.location.search).get('file')
+      }, '*');
+    }
+  }
+  
+  // Initialize URL validation on page load
+  initializeUrlValidation();
+  
+  // Add validation check before PDF.js loads
+  window.addEventListener('DOMContentLoaded', () => {
+    if (!validateCurrentUrl()) {
+      // Prevent PDF.js from loading if URL validation fails
+      return;
+    }
+  });
+  
+  // Validate on page load
+  window.addEventListener('load', () => {
+    validateCurrentUrl();
+  });
+  
+  // Also validate on hash change (in case user tries to modify URL)
+  window.addEventListener('hashchange', () => {
+    validateCurrentUrl();
+  });
+  
+  // Validate on popstate (back/forward navigation)
+  window.addEventListener('popstate', () => {
+    validateCurrentUrl();
+  });
+  
+  // Run validation immediately (in case page is already loaded)
+  validateCurrentUrl();
+  // #endregion
+  
+  // Override the webviewerloaded event to dispatch to parent window
+  // This allows us to capture the event outside the iframe and set locale before PDF.js initializes
+  const originalDispatchEvent = document.dispatchEvent;
+  document.dispatchEvent = function(event) {
+    if (event.type === 'webviewerloaded') {
+      // Dispatch to parent window so it can be captured outside the iframe
+      if (window.parent && window.parent !== window) {
+        window.parent.document.dispatchEvent(event);
+      }
+    }
+    return originalDispatchEvent.call(this, event);
+  };
+  
+  // #region Constants and Configuration
+  // Command tracking for zoom to prevent infinite loops
+  const ZoomCommandTracker = {
+    activeZoomCommand: false,
+    
+    markZoomCommandStart() {
+      this.activeZoomCommand = true;
+    },
+    
+    markZoomCommandEnd() {
+      this.activeZoomCommand = false;
+    },
+    
+    isZoomCommandActive() {
+      return this.activeZoomCommand;
+    }
+  };
+  
+  // Readiness state management
+  const ViewerReadiness = {
+    NOT_LOADED: 0,
+    VIEWER_LOADED: 1,      // PDFViewerApplication exists
+    VIEWER_INITIALIZED: 2, // PDFViewerApplication.initialized = true
+    EVENTBUS_READY: 3,     // Event bus is available and ready
+    COMPONENTS_READY: 4,   // All required components available
+    DOCUMENT_LOADED: 5     // PDF document fully loaded
+  };
+  
+  // Pure event-driven architecture - no action categorization needed
+  // All actions are dispatched at required readiness levels by Universal Dispatcher
+  // #endregion
+
+  // #region State Management
+  let currentReadiness = ViewerReadiness.NOT_LOADED;
+  let readinessCallbacks = [];
+  let diagnosticLogs = false; // Default to false for production
+  // #endregion
+
+  // #region Utility Functions
+  function log(message, level = 'info') {
+    if (!diagnosticLogs) return; // Only log when diagnostic logs are enabled
+    
+    const timestamp = new Date().toISOString();
+    const prefix = '[PostMessage]';
+    
+      switch (level) {
+        case 'error':
+        console.error(`${prefix} ${timestamp} ERROR: ${message}`);
+          break;
+        case 'warn':
+        console.warn(`${prefix} ${timestamp} WARN: ${message}`);
+          break;
+        default:
+        console.log(`${prefix} ${timestamp} INFO: ${message}`);
+    }
+  }
+
+  // Set diagnostic logs mode
+  function setDiagnosticLogs(enabled) {
+    diagnosticLogs = enabled;
+  }
+
+  // Button visibility control helper (consolidated from separate module)
+  function toggleButtonVisibility(primaryId, secondaryId, visible) {
+    const primary = document.getElementById(primaryId);
+    const secondary = secondaryId ? document.getElementById(secondaryId) : null;
+    if (primary) primary.classList.toggle('hidden', !visible);
+    if (secondary) secondary.classList.toggle('hidden', !visible);
+  }
+
+  // Generic element visibility control for toolbar/sidebar groups
+  function toggleElementVisibilityById(elementId, visible) {
+    const el = document.getElementById(elementId);
+    if (!el) {
+      log(`Element not found for visibility toggle: ${elementId}`, 'warn');
+      return;
+    }
+    el.classList.toggle('hidden', !visible);
+  }
+
+  // Toolbar section visibility control that preserves layout
+  function toggleToolbarSectionVisibility(elementId, visible) {
+    const el = document.getElementById(elementId);
+    if (!el) {
+      log(`Toolbar section not found for visibility toggle: ${elementId}`, 'warn');
+      return;
+    }
+    
+    // Use CSS class instead of inline styles (CSP-safe)
+    el.classList.toggle('ng2-hidden-section', !visible);
+  }
+  
+  // Readiness state management
+  function setReadiness(readiness) {
+    if (readiness > currentReadiness) {
+      log(`Readiness state changed: ${currentReadiness} → ${readiness}`);
+      currentReadiness = readiness;
+      
+      // Execute callbacks for this readiness level
+      readinessCallbacks.forEach(callback => {
+        if (callback.readiness <= readiness && !callback.executed) {
+          callback.executed = true;
+          callback.callback();
+        }
+      });
+    }
+  }
+  
+  function onReadiness(readiness, callback) {
+    if (currentReadiness >= readiness) {
+      callback();
+    } else {
+      readinessCallbacks.push({ readiness, callback, executed: false });
+    }
+  }
+  
+  // Note: Density styles now loaded from external ng2-customization.css (CSP-safe)
+  
+  // Enhanced zoom transformation function
+  function transformZoomFromViewer(scale, app) {
+    if (typeof scale === 'string') {
+      return scale;
+    }
+    
+    if (app?.pdfViewer) {
+      const viewer = app.pdfViewer;
+      
+      // Check for special zoom modes
+      const specialModes = ['page-fit', 'page-width', 'page-actual', 'auto'];
+      if (specialModes.includes(viewer.currentScaleValue)) {
+        return viewer.currentScaleValue;
+      }
+      
+      // Check predefined zoom levels
+      const predefinedZooms = {
+        0.5: '0.5', 0.75: '0.75', 1: '1', 1.25: '1.25', 
+        1.5: '1.5', 2: '2', 3: '3', 4: '4'
+      };
+      
+      for (const [zoomLevel, zoomValue] of Object.entries(predefinedZooms)) {
+        if (Math.abs(scale - parseFloat(zoomLevel)) < 0.01) {
+          return zoomValue;
+        }
+      }
+    }
+    
+    return typeof scale === 'number' ? `${Math.round(scale * 100)}%` : 'auto';
+  }
+
+  // Send state change notifications to Angular component
+  function sendStateChangeNotification(property, value, source = 'user') {
+    try {
+      const message = {
+        type: 'state-change',
+        property: property,
+        value: value,
+        source: source,
+        timestamp: Date.now()
+      };
+      
+      window.parent.postMessage(message, '*');
+    } catch (error) {
+      log(`Failed to send state change notification: ${error.message}`, 'error');
+    }
+  }
+
+  // Send event notifications to Angular component
+  function sendEventNotification(eventName, eventData) {
+    try {
+      const message = {
+        type: 'event-notification',
+        eventName: eventName,
+        eventData: eventData,
+        timestamp: Date.now()
+      };
+      
+      window.parent.postMessage(message, '*');
+    } catch (error) {
+      log(`Failed to send event notification: ${error.message}`, 'error');
+    }
+  }
+
+  function sendResponse(id, response) {
+    if (id && window.parent) {
+      window.parent.postMessage({
+        type: 'control-response',
+        id: id,
+        ...response,
+        timestamp: Date.now()
+      }, '*');
+    }
+  }
+
+  function getState() {
+    const app = PDFViewerApplication;
+    if (!app) {
+      return { ready: false };
+    }
+    
+    return {
+      ready: app.initialized,
+      page: app.page,
+      pagesCount: app.pagesCount,
+      currentScale: app.pdfViewer ? app.pdfViewer.currentScale : null,
+      currentScaleValue: app.pdfViewer ? app.pdfViewer.currentScaleValue : null,
+      pagesRotation: app.pdfViewer ? app.pdfViewer.pagesRotation : null,
+      scrollMode: app.pdfViewer ? app.pdfViewer.scrollMode : null,
+      spreadMode: app.pdfViewer ? app.pdfViewer.spreadMode : null
+    };
+  }
+
+  // Common control update utilities
+  const ControlUtils = {
+    // Common button visibility update pattern
+    updateButtonVisibility: function(buttonId, secondaryId, visible) {
+      const button = document.getElementById(buttonId);
+      const secondaryButton = secondaryId ? document.getElementById(secondaryId) : null;
+      
+      if (button) {
+        button.classList.toggle('hidden', !visible);
+      }
+      if (secondaryButton) {
+        secondaryButton.classList.toggle('hidden', !visible);
+      }
+      
+    },
+
+    // Common mode update pattern with event bus
+    updateModeViaEventBus: function(eventName, modeValue, modeMap, propertyName) {
+      const app = PDFViewerApplication;
+      if (!app?.eventBus) {
+        log('EventBus not available for mode update', 'error');
+        return;
+      }
+
+      try {
+        const upperMode = typeof modeValue === 'string' ? modeValue.toUpperCase() : modeValue;
+        const mode = modeMap[upperMode];
+        
+        if (mode !== undefined) {
+          app.eventBus.dispatch(eventName, { mode });
+          
+          // NOTE: State change notifications are sent by the bidirectional event listeners
+          // when the actual mode change occurs in PDF.js, not immediately when we dispatch
+          // This prevents infinite loops and ensures we only notify on actual changes
+        } else {
+          log(`Unknown ${propertyName} mode: ${modeValue}`, 'warn');
+        }
+      } catch (error) {
+        log(`Error updating ${propertyName} mode: ${error.message}`, 'error');
+      }
+    },
+
+    // Common direct property update pattern
+    updatePropertyDirectly: function(propertyPath, value, propertyName) {
+      const app = PDFViewerApplication;
+      if (!app?.pdfViewer) {
+        log(`PDFViewer not available for ${propertyName} update`, 'warn');
+        return;
+      }
+
+      try {
+        // Navigate to nested property
+        const pathParts = propertyPath.split('.');
+        let target = app;
+        
+        for (let i = 0; i < pathParts.length - 1; i++) {
+          target = target[pathParts[i]];
+          if (!target) {
+            log(`Property path ${propertyPath} not found for ${propertyName}`, 'warn');
+            return;
+          }
+        }
+        
+        target[pathParts[pathParts.length - 1]] = value;
+      } catch (error) {
+        log(`Direct ${propertyName} update failed: ${error.message}`, 'warn');
+      }
+    },
+
+    // Common validation pattern
+    validateAndExecute: function(condition, action, errorMessage) {
+      if (condition) {
+        action();
+      } else {
+        log(errorMessage, 'warn');
+      }
+    }
+  };
+  // #endregion
+
+  // #region Initialization and Setup
+  
+  // Enhanced readiness checking with proper async initialization handling
+  function checkViewerReadiness() {
+    const app = PDFViewerApplication;
+    
+    if (!app) {
+      setReadiness(ViewerReadiness.NOT_LOADED);
+      return;
+    }
+    
+    setReadiness(ViewerReadiness.VIEWER_LOADED);
+    
+    // Handle async initialization properly
+    if (app.initializedPromise) {
+      app.initializedPromise.then(() => {
+        setReadiness(ViewerReadiness.VIEWER_INITIALIZED);
+        
+        // Check if event bus is ready
+        if (app.eventBus && typeof app.eventBus.dispatch === 'function') {
+          setReadiness(ViewerReadiness.EVENTBUS_READY);
+          
+          // Check if key components are available
+          if (app.pdfViewer && app.pdfCursorTools) {
+            setReadiness(ViewerReadiness.COMPONENTS_READY);
+            
+            // CSS zoom setting is now handled via PostMessage configuration
+            // No need to check global window variables
+          }
+        }
+      }).catch(error => {
+        log(`PDFViewerApplication initialization failed: ${error.message}`, 'error');
+      });
+    } else if (app.initialized) {
+      // Fallback for synchronous check (though this should be async)
+      setReadiness(ViewerReadiness.VIEWER_INITIALIZED);
+      
+      // Check if event bus is ready
+      if (app.eventBus && typeof app.eventBus.dispatch === 'function') {
+        setReadiness(ViewerReadiness.EVENTBUS_READY);
+        
+        // Check if key components are available
+        if (app.pdfViewer && app.pdfCursorTools) {
+          setReadiness(ViewerReadiness.COMPONENTS_READY);
+          
+          // CSS zoom setting is now handled via PostMessage configuration
+          // No need to check global window variables
+        }
+      }
+    }
+  }
+  
+  // Wait for PDF.js viewer to be ready with event-driven approach
+  function waitForViewer() {
+    // Use MutationObserver to detect when PDFViewerApplication becomes available
+    const observer = new MutationObserver((mutations, obs) => {
+      if (typeof PDFViewerApplication !== 'undefined') {
+        obs.disconnect(); // Stop observing
+        checkViewerReadiness();
+        
+        // Set up event-driven readiness monitoring
+        setupEventDrivenReadinessMonitoring();
+      }
+    });
+    
+    // Start observing DOM changes
+    observer.observe(document, {
+      childList: true,
+      subtree: true
+    });
+    
+    // Also check immediately in case it's already available
+    if (typeof PDFViewerApplication !== 'undefined') {
+      log('PDFViewerApplication already available, starting readiness check');
+      observer.disconnect();
+      checkViewerReadiness();
+      setupEventDrivenReadinessMonitoring();
+    }
+  }
+  
+  // Set up event-driven readiness monitoring
+  function setupEventDrivenReadinessMonitoring() {
+    // Use a custom event system for readiness changes
+    const readinessEventTarget = new EventTarget();
+    
+    // Override setReadiness to emit events
+    const originalSetReadiness = setReadiness;
+    setReadiness = function(readiness) {
+      originalSetReadiness(readiness);
+      
+      // Emit custom event for readiness change
+      readinessEventTarget.dispatchEvent(new CustomEvent('readiness-change', {
+        detail: { readiness, previousReadiness: currentReadiness }
+      }));
+    };
+    
+    // Listen for readiness changes
+    readinessEventTarget.addEventListener('readiness-change', (event) => {
+      const { readiness } = event.detail;
+      
+      if (readiness >= ViewerReadiness.EVENTBUS_READY) {
+
+        initializePostMessageAPI();
+      }
+    });
+    
+    // Check initial readiness
+    if (currentReadiness >= ViewerReadiness.EVENTBUS_READY) {
+
+      initializePostMessageAPI();
+    }
+  }
+
+  function initializePostMessageAPI() {
+    // Add message listener
+    window.addEventListener('message', handleControlMessage);
+    
+    // Expose API for external access
+    window.Ng2PdfJsViewerAPI = {
+      updateControl: updateControl,
+      getState: getState,
+      isReady: () => currentReadiness >= ViewerReadiness.EVENTBUS_READY,
+      getReadiness: () => currentReadiness
+    };
+    
+    // Notify parent that PostMessage API is ready
+    window.parent.postMessage({
+      type: 'postmessage-ready',
+      timestamp: Date.now(),
+      readiness: currentReadiness
+    }, '*');
+    
+    // Set up event listeners for readiness changes
+    setupReadinessEventListeners();
+  }
+  
+  function setupReadinessEventListeners() {
+    const app = PDFViewerApplication;
+    if (!app || !app.eventBus) return;
+    
+    // Set up error event listeners immediately (before document loads)
+    setupErrorEventListeners();
+    
+    // Listen for document loaded event
+    app.eventBus.on('documentloaded', () => {
+      setReadiness(ViewerReadiness.DOCUMENT_LOADED);
+      
+      // Set up bidirectional event listeners once document is loaded
+      setupBidirectionalEventListeners();
+    });
+    
+    // Listen for pages loaded event
+    app.eventBus.on('pagesloaded', () => {
+      // Ensure we're at least at components ready level
+      if (currentReadiness < ViewerReadiness.COMPONENTS_READY) {
+        setReadiness(ViewerReadiness.COMPONENTS_READY);
+      }
+    });
+  }
+  // #endregion
+
+  // #region Message Handling
+  function handleControlMessage(event) {
+    const { type, action, payload, id } = event.data;
+    
+    if (type === 'control-update') {
+      try {
+        
+        // Universal Dispatcher has already verified readiness - just execute
+        updateControl(action, payload);
+        sendResponse(id, { success: true, action, payload });
+      } catch (error) {
+        const errorMsg = `Error processing ${action}: ${error.message}`;
+        log(errorMsg, 'error');
+        sendResponse(id, { success: false, error: errorMsg });
+      }
+    }
+  }
+  // #endregion
+
+  // #region Control Update Functions
+  function updateControl(action, payload) {
+    const app = PDFViewerApplication;
+    
+    // Validate that PDFViewerApplication is available
+    if (!app) {
+      log('PDFViewerApplication not available', 'error');
+      return;
+    }
+    
+    try {
+      // Note: Density styles loaded from external ng2-customization.css (CSP-safe)
+      switch (action) {
+        // Button visibility controls (using consolidated helper function)
+        case 'show-download':
+          toggleButtonVisibility('downloadButton', 'secondaryDownload', payload);
+          break;
+        case 'show-print':
+          toggleButtonVisibility('printButton', 'secondaryPrint', payload);
+          break;
+        case 'show-fullscreen':
+          toggleButtonVisibility('presentationMode', null, payload);
+          break;
+        case 'show-find':
+          toggleButtonVisibility('viewFindButton', null, payload);
+          break;
+        case 'show-bookmark':
+          toggleButtonVisibility('viewBookmark', null, payload);
+          break;
+        case 'show-openfile':
+          toggleButtonVisibility('openFile', 'secondaryOpenFile', payload);
+          break;
+        case 'show-annotations':
+          toggleElementVisibilityById('editorModeButtons', payload);
+          break;
+        
+        case 'set-toolbar-density': {
+          // Apply compact/comfortable density by toggling a class on #toolbarContainer
+          const container = document.getElementById('toolbarContainer');
+          if (container) {
+            container.classList.remove('density-default','density-compact','density-comfortable');
+            const density = typeof payload === 'string' ? payload : 'default';
+            container.classList.add(`density-${density}`);
+          }
+          break;
+        }
+        case 'set-sidebar-width': {
+          // Use CSS variable only (CSP-safe) - width applied via ng2-customization.css
+          const outer = document.getElementById('outerContainer');
+          if (outer && typeof payload === 'string' && payload.trim() !== '') {
+            outer.style.setProperty('--sidebar-width', payload);
+          }
+          break;
+        }
+        case 'set-toolbar-position': {
+          const outer = document.getElementById('outerContainer');
+          if (outer) {
+            outer.classList.remove('toolbar-bottom');
+            if (payload === 'bottom') outer.classList.add('toolbar-bottom');
+          }
+          break;
+        }
+        case 'set-sidebar-position': {
+          const outer = document.getElementById('outerContainer');
+          if (outer) {
+            outer.classList.remove('sidebar-right');
+            if (payload === 'right') outer.classList.add('sidebar-right');
+          }
+          break;
+        }
+        case 'set-responsive-breakpoint': {
+          const value = typeof payload === 'number' ? `${payload}px` : `${payload}`;
+          const outer = document.getElementById('outerContainer');
+          if (outer && value) {
+            outer.style.setProperty('--ng2-responsive-breakpoint', value);
+          }
+          break;
+        }
+        
+        case 'show-toolbar-left':
+          toggleToolbarSectionVisibility('toolbarViewerLeft', payload);
+          break;
+        case 'show-toolbar-middle':
+          toggleToolbarSectionVisibility('toolbarViewerMiddle', payload);
+          break;
+        case 'show-toolbar-right':
+          toggleToolbarSectionVisibility('toolbarViewerRight', payload);
+          break;
+        case 'show-secondary-toolbar-toggle':
+          toggleElementVisibilityById('secondaryToolbarToggle', payload);
+          break;
+        case 'show-sidebar':
+          toggleElementVisibilityById('sidebarContainer', payload);
+          break;
+        case 'show-sidebar-left':
+          toggleElementVisibilityById('toolbarSidebarLeft', payload);
+          break;
+        case 'show-sidebar-right':
+          toggleElementVisibilityById('toolbarSidebarRight', payload);
+          break;
+        
+        // Mode controls
+        case 'set-zoom':
+          updateZoom(payload);
+          break;
+        case 'set-cursor':
+          updateCursor(payload);
+          break;
+        case 'set-scroll':
+          ControlUtils.updateModeViaEventBus('switchscrollmode', payload, 
+            { 'VERTICAL': 0, 'V': 0, 'HORIZONTAL': 1, 'H': 1, 'WRAPPED': 2, 'W': 2, 'PAGE': 3, 'P': 3 }, 
+            'scroll mode');
+          ControlUtils.updatePropertyDirectly('pdfViewer.scrollMode', 
+            ({ 'VERTICAL': 0, 'V': 0, 'HORIZONTAL': 1, 'H': 1, 'WRAPPED': 2, 'W': 2, 'PAGE': 3, 'P': 3 })[payload?.toUpperCase()] || 0, 
+            'scroll mode');
+          break;
+        case 'set-spread':
+          ControlUtils.updateModeViaEventBus('switchspreadmode', payload, 
+            { 'NONE': 0, 'N': 0, 'ODD': 1, 'O': 1, 'EVEN': 2, 'E': 2 }, 
+            'spread mode');
+          ControlUtils.updatePropertyDirectly('pdfViewer.spreadMode', 
+            ({ 'NONE': 0, 'N': 0, 'ODD': 1, 'O': 1, 'EVEN': 2, 'E': 2 })[payload?.toUpperCase()] || 0, 
+            'spread mode');
+          break;
+        
+        // Navigation controls
+        case 'set-page':
+          // Universal Dispatcher guarantees PDFViewerApplication.initialized at readiness level 5
+          const pageNumber = parseInt(payload, 10);
+          if (pageNumber > 0 && pageNumber <= PDFViewerApplication.pagesCount) {
+            PDFViewerApplication.page = pageNumber;
+          } else {
+            log(`Invalid page number: ${payload}`, 'warn');
+          }
+          break;
+        case 'set-rotation':
+          // Universal Dispatcher guarantees PDFViewerApplication.initialized at readiness level 5
+          const rotation = parseInt(payload, 10);
+          if ([0, 90, 180, 270].includes(rotation)) {
+            // Set rotation on pdfViewer to trigger proper refresh
+            PDFViewerApplication.pdfViewer.pagesRotation = rotation;
+            // Note: No need to send state change notification here - 
+            // PDF.js will fire 'rotationchanging' event which we handle separately
+          } else {
+            log(`Invalid rotation: ${payload}`, 'warn');
+          }
+          break;
+        case 'go-to-last-page':
+          if (payload === true) {
+            // Universal Dispatcher guarantees PDFViewerApplication.initialized at readiness level 5
+            const lastPage = PDFViewerApplication.pagesCount;
+            PDFViewerApplication.page = lastPage;
+          }
+          break;
+        case 'go-to-named-dest':
+          // Validate that payload is not empty or null before processing
+          if (!payload || typeof payload !== 'string' || payload.trim() === '') {
+            log(`Skipping invalid named destination: "${payload}"`);
+            break;
+          }
+          
+          // Universal Dispatcher guarantees PDFViewerApplication.pdfLinkService at readiness level 5
+          PDFViewerApplication.pdfLinkService.goToDestination(payload);
+          break;
+        case 'update-page-mode':
+          // Universal Dispatcher guarantees PDFViewerApplication.eventBus at readiness level 4
+          const mode = payload ? payload.toLowerCase() : 'none';
+          PDFViewerApplication.eventBus.dispatch('pagemode', { mode });
+          break;
+        
+        // Configuration actions
+        case 'set-download-filename':
+          setDownloadFilename(payload);
+          break;
+
+        // Auto actions - Universal Dispatcher guarantees eventBus availability at readiness level 5
+        case 'trigger-download':
+          if (payload === true) {
+            PDFViewerApplication.eventBus.dispatch('download');
+          }
+          break;
+        case 'trigger-print':
+          if (payload === true) {
+            PDFViewerApplication.eventBus.dispatch('print');
+          }
+          break;
+        case 'trigger-rotate-cw':
+          if (payload === true) {
+            PDFViewerApplication.eventBus.dispatch('rotatecw');
+          }
+          break;
+        case 'trigger-rotate-ccw':
+          if (payload === true) {
+            PDFViewerApplication.eventBus.dispatch('rotateccw');
+          }
+          break;
+        
+        // Error handling
+        case 'set-error-message':
+          setErrorMessage(payload);
+          break;
+        case 'set-error-override':
+          setErrorOverride(payload);
+          break;
+        case 'set-error-append':
+          setErrorAppend(payload);
+          break;
+        
+        // CSS zoom
+        case 'set-css-zoom':
+          setCssZoom(payload);
+          break;
+        
+        // Event enablement
+        case 'enable-before-print':
+          enableBeforePrint(payload);
+          break;
+        case 'enable-after-print':
+          enableAfterPrint(payload);
+          break;
+        case 'enable-pages-loaded':
+          enablePagesLoaded(payload);
+          break;
+        case 'enable-page-change':
+          enablePageChange(payload);
+          break;
+        
+        // New high-value event enablement
+        case 'enable-document-error':
+          enableDocumentError(payload);
+          break;
+        case 'enable-document-init':
+          enableDocumentInit(payload);
+          break;
+        case 'enable-pages-init':
+          enablePagesInit(payload);
+          break;
+        case 'enable-presentation-mode-changed':
+          enablePresentationModeChanged(payload);
+          break;
+        case 'enable-open-file':
+          enableOpenFile(payload);
+          break;
+        case 'enable-find':
+          enableFind(payload);
+          break;
+        case 'enable-update-find-matches-count':
+          enableUpdateFindMatchesCount(payload);
+          break;
+        case 'enable-metadata-loaded':
+          enableMetadataLoaded(payload);
+          break;
+        case 'enable-outline-loaded':
+          enableOutlineLoaded(payload);
+          break;
+        case 'enable-page-rendered':
+          enablePageRendered(payload);
+          break;
+        
+        // New high-value events
+        case 'enable-annotation-layer-rendered':
+          enableAnnotationLayerRendered(payload);
+          break;
+        case 'enable-bookmark-click':
+          enableBookmarkClick(payload);
+          break;
+        case 'enable-idle':
+          enableIdle(payload);
+          break;
+        
+        // Theme & Visual Customization Actions
+        case 'set-theme':
+          setTheme(payload);
+          break;
+        case 'set-primary-color':
+          setPrimaryColor(payload);
+          break;
+        case 'set-background-color':
+          setBackgroundColor(payload);
+          break;
+        case 'set-page-border-color':
+          setPageBorderColor(payload);
+          break;
+        case 'set-page-spacing':
+          setPageSpacing(payload.margin, payload.spreadMargin, payload.border);
+          break;
+        case 'set-toolbar-color':
+          setToolbarColor(payload);
+          break;
+        case 'set-text-color':
+          setTextColor(payload);
+          break;
+        case 'set-border-radius':
+          setBorderRadius(payload);
+          break;
+        case 'set-custom-css':
+          // Handle both old format (string) and new format (object with nonce)
+          if (typeof payload === 'string') {
+            setCustomCSS(payload, null);
+          } else if (payload && typeof payload === 'object') {
+            setCustomCSS(payload.css, payload.nonce);
+          }
+          break;
+        
+        case 'set-diagnostic-logs':
+          setDiagnosticLogs(payload);
+          break;
+        case 'set-url-validation':
+          urlValidationEnabled = payload === true;
+          log(`URL validation ${urlValidationEnabled ? 'enabled' : 'disabled'}`);
+          break;
+        
+        default:
+          log(`Unknown action: ${action}`, 'warn');
+      }
+    } catch (error) {
+      log(`Error in updateControl for action ${action}: ${error.message}`, 'error');
+      throw error;
+    }
+  }
+  // #endregion
+
+  // #region Button Visibility Functions
+  function updateDownloadButton(visible) {
+    const button = document.getElementById('downloadButton');
+    const secondaryButton = document.getElementById('secondaryDownload');
+    if (button) {
+      button.classList.toggle('hidden', !visible);
+    }
+    if (secondaryButton) {
+      secondaryButton.classList.toggle('hidden', !visible);
+      }
+  }
+
+  function updatePrintButton(visible) {
+    const button = document.getElementById('printButton');
+    const secondaryButton = document.getElementById('secondaryPrint');
+    if (button) {
+      button.classList.toggle('hidden', !visible);
+    }
+    if (secondaryButton) {
+      secondaryButton.classList.toggle('hidden', !visible);
+      }
+  }
+
+  function updateFullScreenButton(visible) {
+    const button = document.getElementById('presentationMode');
+    if (button) {
+      button.classList.toggle('hidden', !visible);
+      }
+  }
+
+  function updateFindButton(visible) {
+    const button = document.getElementById('viewFindButton');
+    if (button) {
+      button.classList.toggle('hidden', !visible);
+      }
+  }
+
+  function updateBookmarkButton(visible) {
+    const button = document.getElementById('viewBookmark');
+    if (button) {
+      button.classList.toggle('hidden', !visible);
+      }
+  }
+
+  function updateOpenFileButton(visible) {
+    const button = document.getElementById('openFile');
+    const secondaryButton = document.getElementById('secondaryOpenFile');
+    if (button) {
+      button.classList.toggle('hidden', !visible);
+    }
+    if (secondaryButton) {
+      secondaryButton.classList.toggle('hidden', !visible);
+      }
+  }
+  function updateAnnotationsButton(visible) {
+    // Handle annotations button visibility
+    // This might need to be implemented based on the specific annotation system
+    log(`Annotations button visibility set to: ${visible}`);
+  }
+  // #endregion
+
+  // #region Mode Control Functions
+  function updateZoom(zoom) {
+    const app = PDFViewerApplication;
+    if (!app || !app.pdfViewer || !app.eventBus) {
+      log('PDFViewerApplication, pdfViewer, or eventBus not ready for zoom update', 'warn');
+      return;
+    }
+
+    // Mark zoom command as active to prevent infinite loop
+    ZoomCommandTracker.markZoomCommandStart();
+    
+    try {
+      // Acceptable values: "auto", "page-fit", "page-width", "page-actual", "page-height", or a number/string number like "1.25"
+      const validStringZooms = ['auto', 'page-actual', 'page-fit', 'page-width', 'page-height'];
+      
+      // Check if it's a valid string zoom
+      if (validStringZooms.includes(zoom)) {
+        // Dispatch the scalechanged event exactly like the UI does
+        app.eventBus.dispatch("scalechanged", {
+          source: app.toolbar,  // Use toolbar as source, just like the UI does
+          value: zoom
+        });
+        return;
+      }
+      
+      // Check if it's a valid numeric zoom (including decimal strings like "1.25")
+      const numericZoom = Number(zoom);
+      if (!isNaN(numericZoom) && numericZoom > 0) {
+        // Dispatch the scalechanged event exactly like the UI does
+        app.eventBus.dispatch("scalechanged", {
+          source: app.toolbar,  // Use toolbar as source, just like the UI does
+          value: zoom
+        });
+        return;
+      }
+      
+      // If we get here, it's invalid
+      log(`Invalid zoom value: ${zoom}`, 'warn');
+    } finally {
+      // Always clear the command flag, even if there's an error
+      ZoomCommandTracker.markZoomCommandEnd();
+    }
+  }
+
+  function updateCursor(cursor) {
+    // Universal Dispatcher guarantees PDFViewerApplication availability at readiness level 4
+    const app = PDFViewerApplication;
+    
+    try {
+      const cursorTool = cursor ? cursor.toUpperCase() : 'SELECT';
+      
+      let toolId = 0; // Default to SELECT
+      switch (cursorTool) {
+        case 'HAND':
+        case 'H':
+          toolId = 1; // HAND
+            break;
+        case 'SELECT':
+        case 'S':
+          toolId = 0; // SELECT
+            break;
+        case 'ZOOM':
+        case 'Z':
+          toolId = 2; // ZOOM  
+            break;
+          default:
+          log(`Unknown cursor tool: ${cursorTool}, defaulting to SELECT`, 'warn');
+          toolId = 0;
+      }
+      
+      // Update cursor using event bus dispatch (PDF.js v4.x)
+      if (app.eventBus && typeof app.eventBus.dispatch === 'function') {
+          app.eventBus.dispatch('switchcursortool', {
+            tool: toolId
+          });
+      } else {
+        log('EventBus not available for cursor update', 'warn');
+      }
+    } catch (error) {
+      log(`Error updating cursor: ${error.message}`, 'error');
+    }
+  }
+
+  function updateScroll(scroll) {
+    // Universal Dispatcher guarantees PDFViewerApplication availability at readiness level 4
+    
+    try {
+      const scrollMode = scroll ? scroll.toUpperCase() : 'VERTICAL';
+      log(`Attempting to update scroll mode to: ${scrollMode}`);
+      
+      if (PDFViewerApplication.eventBus) {
+        // Use PDF.js v4.x event bus dispatch for scroll mode switching
+        switch (scrollMode) {
+          case 'VERTICAL':
+          case 'V':
+            log('Dispatching switchscrollmode with VERTICAL mode');
+            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
+              mode: 0 // ScrollMode.VERTICAL
+            });
+            break;
+          case 'HORIZONTAL':
+          case 'H':
+            log('Dispatching switchscrollmode with HORIZONTAL mode');
+            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
+              mode: 1 // ScrollMode.HORIZONTAL
+            });
+            break;
+          case 'WRAPPED':
+          case 'W':
+            log('Dispatching switchscrollmode with WRAPPED mode');
+            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
+              mode: 2 // ScrollMode.WRAPPED
+            });
+            break;
+          case 'PAGE':
+          case 'P':
+            log('Dispatching switchscrollmode with PAGE mode');
+            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
+              mode: 3 // ScrollMode.PAGE
+            });
+            break;
+          default:
+            log(`Unknown scroll mode: ${scrollMode}, defaulting to VERTICAL`, 'warn');
+            PDFViewerApplication.eventBus.dispatch('switchscrollmode', {
+              mode: 0
+            });
+        }
+      } else {
+        // Fallback to direct property setting if event bus not available
+      if (PDFViewerApplication.pdfViewer) {
+          switch (scrollMode) {
+            case 'VERTICAL':
+            case 'V':
+              PDFViewerApplication.pdfViewer.scrollMode = 0;
+              break;
+            case 'HORIZONTAL':
+            case 'H':
+              PDFViewerApplication.pdfViewer.scrollMode = 1;
+              break;
+            case 'WRAPPED':
+            case 'W':
+              PDFViewerApplication.pdfViewer.scrollMode = 2;
+              break;
+            case 'PAGE':
+            case 'P':
+              PDFViewerApplication.pdfViewer.scrollMode = 3;
+              break;
+          }
+        }
+      }
+      
+      log(`Scroll mode update completed for: ${scrollMode}`);
+    } catch (error) {
+      log(`Error updating scroll mode: ${error.message}`, 'error');
+    }
+  }
+
+  function updateSpread(spread) {
+    // Universal Dispatcher guarantees PDFViewerApplication availability at readiness level 4
+    
+    try {
+      const spreadMode = spread ? spread.toUpperCase() : 'NONE';
+      log(`Attempting to update spread mode to: ${spreadMode}`);
+      
+      if (PDFViewerApplication.eventBus) {
+        // Use PDF.js v4.x event bus dispatch for spread mode switching
+        switch (spreadMode) {
+          case 'NONE':
+          case 'N':
+            log('Dispatching switchspreadmode with NONE mode');
+            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
+              mode: 0 // SpreadMode.NONE
+            });
+            break;
+          case 'ODD':
+          case 'O':
+            log('Dispatching switchspreadmode with ODD mode');
+            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
+              mode: 1 // SpreadMode.ODD
+            });
+            break;
+          case 'EVEN':
+          case 'E':
+            log('Dispatching switchspreadmode with EVEN mode');
+            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
+              mode: 2 // SpreadMode.EVEN
+            });
+            break;
+          default:
+            log(`Unknown spread mode: ${spreadMode}, defaulting to NONE`, 'warn');
+            PDFViewerApplication.eventBus.dispatch('switchspreadmode', {
+              mode: 0
+            });
+        }
+      } else {
+        // Fallback to direct property setting if event bus not available
+      if (PDFViewerApplication.pdfViewer) {
+          switch (spreadMode) {
+            case 'NONE':
+            case 'N':
+              PDFViewerApplication.pdfViewer.spreadMode = 0;
+              break;
+            case 'ODD':
+            case 'O':
+              PDFViewerApplication.pdfViewer.spreadMode = 1;
+              break;
+            case 'EVEN':
+            case 'E':
+              PDFViewerApplication.pdfViewer.spreadMode = 2;
+              break;
+          }
+        }
+      }
+      
+      log(`Spread mode update completed for: ${spreadMode}`);
+    } catch (error) {
+      log(`Error updating spread mode: ${error.message}`, 'error');
+    }
+  }
+  // #endregion
+
+  // Note: Legacy navigation and auto-action functions removed.
+  // All functionality now handled through the main updateControl switch statement
+  // which trusts the Universal Dispatcher's readiness guarantees.
+
+  // #region Error Handling Functions
+  // Error state is managed internally and communicated via PostMessage
+  // No need for global window variables - events drive the behavior
+  function setErrorMessage(message) {
+    // Error messages are sent directly via PostMessage when errors occur
+    // No need to store in global variables
+  }
+
+  function setErrorOverride(override) {
+    // Error override is handled by the Angular component
+    // No need to store in global variables
+  }
+
+  function setErrorAppend(append) {
+    // Error append is handled by the Angular component
+    // No need to store in global variables
+  }
+  // #endregion
+
+  // #region CSS Zoom Functions
+
+  function setCssZoom(useCssZoom) {
+    try {
+      if (PDFViewerApplication && PDFViewerApplication.pdfViewer) {
+        // Set CSS zoom mode
+        PDFViewerApplication.pdfViewer.useOnlyCssZoom = useCssZoom === true;
+      } else {
+        // CSS zoom will be set when viewer becomes ready via readiness-based dispatch
+        // No need to store in global variables
+      }
+    } catch (error) {
+      log(`Error setting CSS zoom: ${error.message}`, 'error');
+    }
+  }
+
+  function setDownloadFilename(filename) {
+    try {
+      if (filename && PDFViewerApplication) {
+        // Ensure filename ends with .pdf if not already present
+        const processedFilename = filename.endsWith('.pdf') ? filename : `${filename}.pdf`;
+        
+        // Set the content disposition filename that PDF.js uses for downloads
+        PDFViewerApplication._contentDispositionFilename = processedFilename;
+      } else {
+        log('Cannot set download filename - invalid filename or PDFViewerApplication not available', 'warn');
+      }
+    } catch (error) {
+      log(`Error setting download filename: ${error.message}`, 'error');
+    }
+  }
+  // #endregion
+
+  // #region Event Configuration Functions
+  // Event enablement state stored locally (not in global window variables)
+  // This follows v5-upgrade.md principles while maintaining functionality
+  
+  // Local state for event enablement
+  const eventEnablement = {
+    beforePrint: false,
+    afterPrint: false,
+    pagesLoaded: false,
+    pageChange: false,
+    documentError: false,
+    documentInit: false,
+    pagesInit: false,
+    presentationModeChanged: false,
+    openFile: false,
+    find: false,
+    updateFindMatchesCount: false,
+    metadataLoaded: false,
+    outlineLoaded: false,
+    pageRendered: false,
+    annotationLayerRendered: false,
+    bookmarkClick: false,
+    idle: false
+  };
+  
+  function enableBeforePrint(enable) { eventEnablement.beforePrint = enable === true; }
+  function enableAfterPrint(enable) { eventEnablement.afterPrint = enable === true; }
+  function enablePagesLoaded(enable) { eventEnablement.pagesLoaded = enable === true; }
+  function enablePageChange(enable) { eventEnablement.pageChange = enable === true; }
+  function enableDocumentError(enable) { eventEnablement.documentError = enable === true; }
+  function enableDocumentInit(enable) { eventEnablement.documentInit = enable === true; }
+  function enablePagesInit(enable) { eventEnablement.pagesInit = enable === true; }
+  function enablePresentationModeChanged(enable) { eventEnablement.presentationModeChanged = enable === true; }
+  function enableOpenFile(enable) { eventEnablement.openFile = enable === true; }
+  function enableFind(enable) { eventEnablement.find = enable === true; }
+  function enableUpdateFindMatchesCount(enable) { eventEnablement.updateFindMatchesCount = enable === true; }
+  function enableMetadataLoaded(enable) { eventEnablement.metadataLoaded = enable === true; }
+  function enableOutlineLoaded(enable) { eventEnablement.outlineLoaded = enable === true; }
+  function enablePageRendered(enable) { eventEnablement.pageRendered = enable === true; }
+  function enableAnnotationLayerRendered(enable) { eventEnablement.annotationLayerRendered = enable === true; }
+  function enableBookmarkClick(enable) { eventEnablement.bookmarkClick = enable === true; }
+  function enableIdle(enable) { eventEnablement.idle = enable === true; }
+  // #endregion
+
+  // #region Theme & Visual Customization Functions
+  
+  // Theme management variables
+  let currentTheme = 'light';
+  
+  function setTheme(theme) {
+    currentTheme = theme || 'light';
+    
+    // Apply theme-specific CSS classes (CSP-safe)
+    const body = document.body;
+    if (body) {
+      // Remove ALL theme classes including active states
+      body.classList.remove('ng2-theme-light', 'ng2-theme-dark', 'ng2-theme-auto', 
+                           'ng2-theme-dark-active', 'ng2-theme-light-active');
+      
+      // Add new theme class
+      body.classList.add(`ng2-theme-${currentTheme}`);
+      
+      // Apply auto theme detection
+      if (currentTheme === 'auto') {
+        const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+        const activeClass = prefersDark ? 'ng2-theme-dark-active' : 'ng2-theme-light-active';
+        body.classList.add(activeClass);
+        
+        // Listen for theme changes
+        if (!window.ng2ThemeMediaListener) {
+          const mediaListener = window.matchMedia('(prefers-color-scheme: dark)');
+          mediaListener.addListener((e) => {
+            if (currentTheme === 'auto') {
+              body.classList.remove('ng2-theme-dark-active', 'ng2-theme-light-active');
+              const newActiveClass = e.matches ? 'ng2-theme-dark-active' : 'ng2-theme-light-active';
+              body.classList.add(newActiveClass);
+            }
+          });
+          window.ng2ThemeMediaListener = mediaListener;
+        }
+      }
+      
+      // Force style recalculation
+      body.offsetHeight; // Trigger reflow
+    }
+    
+    // Note: Theme styles now loaded from external ng2-customization.css (CSP-safe)
+  }
+  
+  function setPrimaryColor(color) {
+    setCSSVariable('--ng2-primary-color', color);
+  }
+  
+  function setBackgroundColor(color) {
+    setCSSVariable('--ng2-background-color', color);
+  }
+  
+  function setPageSpacing(margin, spreadMargin, border) {
+    if (margin !== undefined) {
+      setCSSVariable('--page-margin', margin);
+    }
+    if (spreadMargin !== undefined) {
+      setCSSVariable('--spreadHorizontalWrapped-margin-LR', spreadMargin);
+    }
+    if (border !== undefined) {
+      setCSSVariable('--page-border', border);
+    }
+  }
+  
+  function setPageBorderColor(color) {
+    setCSSVariable('--ng2-page-border-color', color);
+  }
+  
+  function setToolbarColor(color) {
+    setCSSVariable('--ng2-toolbar-color', color);
+  }
+  
+  function setTextColor(color) {
+    setCSSVariable('--ng2-text-color', color);
+  }
+  
+  function setBorderRadius(radius) {
+    setCSSVariable('--ng2-border-radius', radius);
+  }
+  
+  function setCustomCSS(css, nonce) {
+    // Remove existing custom CSS
+    const existingStyle = document.getElementById('ng2-custom-css');
+    if (existingStyle) {
+      existingStyle.remove();
+    }
+    
+    // Apply new custom CSS with optional nonce for CSP support
+    if (css) {
+      const style = document.createElement('style');
+      style.id = 'ng2-custom-css';
+      style.textContent = css;
+      
+      // Add nonce if provided (CSP support)
+      if (nonce) {
+        style.setAttribute('nonce', nonce);
+      }
+      
+      document.head.appendChild(style);
+    }
+  }
+  
+  // Helper function to set CSS custom properties
+  function setCSSVariable(property, value) {
+    if (value) {
+      document.documentElement.style.setProperty(property, value);
+      // Also set on body for better compatibility
+      document.body.style.setProperty(property, value);
+    } else {
+      document.documentElement.style.removeProperty(property);
+      document.body.style.removeProperty(property);
+    }
+  }
+  
+  // Note: Theme styles now loaded from external ng2-customization.css (CSP-safe)
+  
+  // #endregion
+
+  // #region Error Event Listeners (Early Setup)
+  let errorListenersSetup = false; // Flag to prevent multiple setups
+  
+  function setupErrorEventListeners() {
+    // Prevent multiple setups
+    if (errorListenersSetup) {
+      return;
+    }
+    
+    const app = PDFViewerApplication;
+    if (!app || !app.eventBus) {
+      log('Cannot setup error listeners: EventBus not available', 'warn');
+      return;
+    }
+
+    // Listen for document errors (including file origin errors)
+    app.eventBus.on('documenterror', (event) => {
+      log(`🔴 DOCUMENT ERROR EVENT FIRED: ${event.message}`, 'error');
+      // Always hide loading spinner on document error
+      sendStateChangeNotification('loading', false, 'system');
+      
+      // Send error state notification for custom error display
+      const errorMessage = event.message || 'An error occurred while loading the PDF.';
+      sendStateChangeNotification('error', errorMessage, 'system');
+      
+      // Send document error events only if enabled
+      if (eventEnablement.documentError) {
+        log(`Document error event received: ${event.message}`);
+        const errorData = {
+          message: event.message || 'Unknown document error',
+          source: event.source ? 'PDFViewerApplication' : 'unknown',
+          name: event.name || 'DocumentError'
+        };
+        sendEventNotification('documentError', errorData);
+      }
+    });
+
+    // Listen for other potential error events
+    app.eventBus.on('loaderror', (event) => {
+      log(`🔴 LOAD ERROR EVENT FIRED: ${event.message}`, 'error');
+      // Hide loading spinner on load error
+      sendStateChangeNotification('loading', false, 'system');
+    });
+
+    app.eventBus.on('error', (event) => {
+      log(`🔴 GENERIC ERROR EVENT FIRED: ${event.message}`, 'error');
+      // Hide loading spinner on any error
+      sendStateChangeNotification('loading', false, 'system');
+    });
+
+    errorListenersSetup = true;
+    log('Error event listeners set up successfully', 'info');
+  }
+
+  // #region Bidirectional Event Listeners
+  let bidirectionalListenersSetup = false; // Flag to prevent multiple setups
+  
+  function setupBidirectionalEventListeners() {
+    // Prevent multiple setups
+    if (bidirectionalListenersSetup) {
+      return;
+    }
+
+    // Add global error handler for iframe-level errors
+    window.addEventListener('error', (event) => {
+      log(`🔴 GLOBAL ERROR: ${event.message}`, 'error');
+      // Hide loading spinner on any global error
+      sendStateChangeNotification('loading', false, 'system');
+    });
+
+    window.addEventListener('unhandledrejection', (event) => {
+      log(`🔴 UNHANDLED PROMISE REJECTION: ${event.reason}`, 'error');
+      // Hide loading spinner on unhandled promise rejection
+      sendStateChangeNotification('loading', false, 'system');
+    });
+    
+    bidirectionalListenersSetup = true;
+    const app = PDFViewerApplication;
+    if (!app || !app.eventBus) {
+      log('Cannot setup bidirectional listeners: EventBus not available', 'warn');
+      return;
+    }
+
+    
+    // Test sending a state change notification immediately
+    sendStateChangeNotification('test', 'initial-setup', 'system');
+
+    // Cursor tool changes are handled via switchcursortool event listener only
+
+    // Note: Scroll and spread mode changes are handled via event listeners
+    // No method interception needed for PDF.js v5.3.93
+    if (app.pdfViewer) {
+      
+      // Monitor scroll mode changes - setScrollMode doesn't exist in v5.3.93
+      // The scroll mode changes are handled via event listeners instead
+
+      // Spread mode changes are handled via switchspreadmode event listener only
+
+      // Monitor zoom changes via currentScale property
+      let lastKnownScale = app.pdfViewer.currentScale;
+      const originalSetCurrentScale = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(app.pdfViewer), 'currentScale');
+      if (originalSetCurrentScale && originalSetCurrentScale.set) {
+        Object.defineProperty(app.pdfViewer, 'currentScale', {
+          get: originalSetCurrentScale.get,
+          set: function(scale) {
+            const result = originalSetCurrentScale.set.call(this, scale);
+            
+            if (scale !== lastKnownScale) {
+              lastKnownScale = scale;
+              
+              // Use enhanced zoom transformation
+              const zoomValue = transformZoomFromViewer(scale, app);
+              
+              log(`Zoom changed via currentScale to: ${zoomValue} (scale: ${scale}, currentScaleValue: ${app.pdfViewer.currentScaleValue})`);
+              sendStateChangeNotification('zoom', zoomValue, 'user');
+            }
+            
+            return result;
+          },
+          configurable: true,
+          enumerable: true
+        });
+        } else {
+        log('pdfViewer.currentScale setter not found', 'warn');
+      }
+    } else {
+      log('pdfViewer not available', 'warn');
+    }
+
+    // Listen for sidebar/page mode changes
+    if (app.pdfSidebar) {
+      
+      // Monitor sidebar view changes
+      const originalSetView = app.pdfSidebar.setView;
+      if (originalSetView) {
+        app.pdfSidebar.setView = function(view) {
+          const result = originalSetView.apply(this, arguments);
+          
+          // Map PDF.js sidebar view numbers to our page mode names
+          const pageModeMap = {
+            0: 'none',        // SidebarView.NONE
+            1: 'thumbs',      // SidebarView.THUMBS
+            2: 'bookmarks',   // SidebarView.OUTLINE
+            3: 'attachments', // SidebarView.ATTACHMENTS
+            4: 'layers'       // SidebarView.LAYERS
+          };
+          
+          const pageModeName = pageModeMap[view] || 'none';
+          log(`Page mode changed to: ${pageModeName} (view: ${view})`);
+          sendStateChangeNotification('pageMode', pageModeName, 'user');
+          
+          return result;
+        };
+        } else {
+    }
+    } else {
+      log('pdfSidebar not available', 'warn');
+    }
+
+    // Listen for additional PDF.js events that might indicate property changes
+    if (app.eventBus) {
+      
+      // Listen for scale changing events with intelligent user vs programmatic detection
+      app.eventBus.on('scalechanging', (event) => {
+
+        
+        // Skip notification if this is from our own zoom command
+        if (ZoomCommandTracker.isZoomCommandActive()) {
+          log('Skipping zoom notification - programmatic change from our command');
+          return;
+        }
+        
+        // Use event context to determine if this is a user-initiated change
+        let isUserInitiated = false;
+        let zoomValue;
+        
+        if (event.presetValue && typeof event.presetValue === 'string') {
+          // User clicked zoom buttons (Page Fit, Page Width, Auto, etc.)
+
+          isUserInitiated = true;
+          zoomValue = event.presetValue;
+        } else if (typeof event.scale === 'number' && !event.presetValue) {
+          // Could be mouse wheel (user) or other programmatic change
+          // For now, assume it's user-initiated (mouse wheel, etc.)
+          // Future enhancement: could add more sophisticated detection
+          log('Assuming user-initiated scale change (mouse wheel, etc.)');
+          isUserInitiated = true;
+          zoomValue = transformZoomFromViewer(event.scale, app);
+        }
+        
+        if (isUserInitiated) {
+
+          sendStateChangeNotification('zoom', zoomValue, 'user');
+      } else {
+          log('Skipping zoom notification - not identified as user-initiated');
+        }
+      });
+
+      // Listen for other relevant events
+      app.eventBus.on('switchscrollmode', (event) => {
+        
+        const scrollMap = {
+          0: 'vertical',   // ScrollMode.VERTICAL
+          1: 'horizontal', // ScrollMode.HORIZONTAL
+          2: 'wrapped',    // ScrollMode.WRAPPED
+          3: 'page'        // ScrollMode.PAGE
+        };
+        
+        const scrollName = scrollMap[event.mode] || 'vertical';
+        log(`Scroll mode changed via event to: ${scrollName}`);
+        sendStateChangeNotification('scroll', scrollName, 'user');
+      });
+
+      app.eventBus.on('switchspreadmode', (event) => {
+        
+        const spreadMap = {
+          0: 'none', // SpreadMode.NONE
+          1: 'odd',  // SpreadMode.ODD
+          2: 'even'  // SpreadMode.EVEN
+        };
+        
+        const spreadName = spreadMap[event.mode] || 'none';
+        log(`Spread mode changed via event to: ${spreadName}`);
+        sendStateChangeNotification('spread', spreadName, 'user');
+      });
+
+      app.eventBus.on('switchcursortool', (event) => {
+        
+        const cursorMap = {
+          0: 'select', // CursorTool.SELECT
+          1: 'hand',   // CursorTool.HAND
+          2: 'zoom'    // CursorTool.ZOOM
+        };
+        
+        const cursorName = cursorMap[event.tool] || 'select';
+        log(`Cursor changed via event to: ${cursorName}`);
+        sendStateChangeNotification('cursor', cursorName, 'user');
+      });
+
+      app.eventBus.on('sidebarviewchanged', (event) => {
+        
+        const pageModeMap = {
+          0: 'none',        // SidebarView.NONE
+          1: 'thumbs',      // SidebarView.THUMBS
+          2: 'bookmarks',   // SidebarView.OUTLINE
+          3: 'attachments', // SidebarView.ATTACHMENTS
+          4: 'layers'       // SidebarView.LAYERS
+        };
+        
+        const pageModeName = pageModeMap[event.view] || 'none';
+        log(`Page mode changed via event to: ${pageModeName}`);
+        sendStateChangeNotification('pageMode', pageModeName, 'user');
+      });
+
+      // Listen for rotation changes (when user rotates via UI or programmatically)
+      app.eventBus.on('rotationchanging', (event) => {
+        log(`Rotation changed via event to: ${event.pagesRotation}`);
+        sendStateChangeNotification('rotation', event.pagesRotation, 'user');
+      });
+
+      // Note: Error event listeners are set up earlier in setupErrorEventListeners()
+
+      app.eventBus.on('documentinit', (event) => {
+        // Send document init events only if enabled
+        if (eventEnablement.documentInit) {
+          sendEventNotification('documentInit', null);
+        }
+      });
+
+      app.eventBus.on('pagesinit', (event) => {
+        // Send pages init events only if enabled
+        if (eventEnablement.pagesInit) {
+          const pageCount = app.pagesCount || 0;
+          const pagesData = {
+            pagesCount: pageCount
+          };
+          sendEventNotification('pagesInit', pagesData);
+        }
+      });
+
+      app.eventBus.on('presentationmodechanged', (event) => {
+        // Send presentation mode events only if enabled
+        if (eventEnablement.presentationModeChanged) {
+          // Map PDF.js PresentationModeState to boolean
+          // FULLSCREEN = 3, CHANGING = 2, NORMAL = 1, UNKNOWN = 0
+          const isActive = event.state === 3; // PresentationModeState.FULLSCREEN
+          const isChanging = event.state === 2; // PresentationModeState.CHANGING
+          const presentationData = {
+            active: isActive,
+            switchInProgress: isChanging
+          };
+          sendEventNotification('presentationModeChanged', presentationData);
+        }
+      });
+
+      app.eventBus.on('fileinputchange', (event) => {
+        // Send open file events only if enabled
+        if (eventEnablement.openFile) {
+          sendEventNotification('openFile', null);
+        }
+      });
+
+      app.eventBus.on('find', (event) => {
+        // Send find events only if enabled
+        if (eventEnablement.find) {
+          const findData = {
+            query: event.query || '',
+            phraseSearch: false, // Not available in PDF.js v5.3.93
+            caseSensitive: event.caseSensitive || false,
+            entireWord: event.entireWord || false,
+            highlightAll: event.highlightAll || false,
+            findPrevious: event.findPrevious || false
+          };
+          sendEventNotification('find', findData);
+        }
+      });
+
+      app.eventBus.on('updatefindmatchescount', (event) => {
+        // Send find matches count events only if enabled
+        if (eventEnablement.updateFindMatchesCount) {
+          const countData = {
+            current: event.matchesCount?.current || 0,
+            total: event.matchesCount?.total || 0
+          };
+          sendEventNotification('updateFindMatchesCount', countData);
+        }
+      });
+
+      app.eventBus.on('metadataloaded', (event) => {
+        // Send metadata loaded events only if enabled
+        if (eventEnablement.metadataLoaded) {
+          const info = app.documentInfo;
+          const metadataData = {
+            title: info?.Title,
+            author: info?.Author,
+            subject: info?.Subject,
+            keywords: info?.Keywords,
+            creator: info?.Creator,
+            producer: info?.Producer,
+            creationDate: info?.CreationDate,
+            modificationDate: info?.ModDate,
+            pdfFormatVersion: info?.PDFFormatVersion,
+            isLinearized: info?.IsLinearized,
+            isAcroFormPresent: info?.IsAcroFormPresent,
+            isXFAPresent: info?.IsXFAPresent,
+            isCollectionPresent: info?.IsCollectionPresent
+          };
+          sendEventNotification('metadataLoaded', metadataData);
+        }
+      });
+
+      app.eventBus.on('outlineloaded', (event) => {
+        // Send outline loaded events only if enabled
+        if (eventEnablement.outlineLoaded) {
+          const outlineData = {
+            items: [], // Outline items are not available in the event, but consumers can check hasOutline
+            hasOutline: (event.outlineCount || 0) > 0
+          };
+          sendEventNotification('outlineLoaded', outlineData);
+        }
+      });
+
+      app.eventBus.on('pagerendered', (event) => {
+        // Send page rendered events only if enabled
+        if (eventEnablement.pageRendered) {
+          const renderData = {
+            pageNumber: event.pageNumber || 1,
+            // Don't include source as it contains canvas element that can't be cloned
+        timestamp: Date.now()
+          };
+          sendEventNotification('pageRendered', renderData);
+        }
+      });
+
+      // Loading state integration for overlay control
+      // Event-driven only; idempotent notifications, no flags or polling
+      app.eventBus.on('documentinit', () => sendStateChangeNotification('loading', true, 'system'));
+      app.eventBus.on('pagesinit', () => sendStateChangeNotification('loading', true, 'system'));
+      app.eventBus.on('pagerendered', () => sendStateChangeNotification('loading', false, 'system'));
+      app.eventBus.on('pagesloaded', () => sendStateChangeNotification('loading', false, 'system'));
+
+      // New high-value events
+      
+      // Annotation Layer Rendered - Native PDF.js event
+      app.eventBus.on('annotationlayerrendered', (event) => {
+        // Send annotation layer rendered events only if enabled
+        if (eventEnablement.annotationLayerRendered) {
+          const renderData = {
+            pageNumber: event.pageNumber || 1,
+            error: event.error || null,
+            timestamp: performance.now()
+          };
+          sendEventNotification('annotationLayerRendered', renderData);
+        }
+      });
+      
+      // Reset idle timer when PDF document changes (event-driven approach)
+      // Set up idle timer only if enabled
+      if (eventEnablement.idle) {
+        app.eventBus.on('documentloaded', () => {
+          if (typeof resetIdleTimer === 'function') {
+            resetIdleTimer();
+            log('Idle timer reset on document load');
+          }
+        });
+      }
+    }
+
+    // Initialize custom event implementations
+    initializeCustomEvents(app);
+
+
+  }
+
+  // Initialize custom event implementations
+  function initializeCustomEvents(app) {
+    setupIdleDetection();
+    interceptOutlineClicks(app);
+  }
+
+  // Idle Detection - Custom activity tracking
+  let idleTimer = null;
+  let idleListenersSetup = false;
+  let idleCleanupListeners = []; // Track listeners for cleanup
+  const IDLE_TIMEOUT = 30000; // 30 seconds default
+
+  function resetIdleTimer() {
+    if (idleTimer) {
+      clearTimeout(idleTimer);
+      idleTimer = null;
+    }
+    // Set up idle timer only if enabled
+    if (eventEnablement.idle) {
+      idleTimer = setTimeout(() => {
+        sendEventNotification('idle', null);
+      }, IDLE_TIMEOUT);
+    }
+  }
+
+  function cleanupIdleDetection() {
+    // Clear timer
+    if (idleTimer) {
+      clearTimeout(idleTimer);
+      idleTimer = null;
+    }
+    
+    // Remove all tracked event listeners
+    idleCleanupListeners.forEach(({ element, event, handler, options }) => {
+      element.removeEventListener(event, handler, options);
+    });
+    idleCleanupListeners = [];
+    idleListenersSetup = false;
+    
+    log('Idle detection cleanup completed');
+  }
+
+  function setupIdleDetection() {
+    // Prevent multiple setups
+    if (idleListenersSetup) {
+      log('Idle detection already setup, skipping');
+      return;
+    }
+    
+    idleListenersSetup = true;
+    
+    // Helper to add and track event listeners
+    const addTrackedListener = (element, event, handler, options) => {
+      element.addEventListener(event, handler, options);
+      idleCleanupListeners.push({ element, event, handler, options });
+    };
+
+    // Track mouse activity
+    addTrackedListener(document, 'mousemove', resetIdleTimer, { passive: true });
+    addTrackedListener(document, 'mousedown', resetIdleTimer, { passive: true });
+    addTrackedListener(document, 'click', resetIdleTimer, { passive: true });
+    
+    // Track keyboard activity  
+    addTrackedListener(document, 'keydown', resetIdleTimer, { passive: true });
+    addTrackedListener(document, 'keypress', resetIdleTimer, { passive: true });
+    
+    // Track scroll activity
+    addTrackedListener(document, 'scroll', resetIdleTimer, { passive: true });
+    addTrackedListener(document, 'wheel', resetIdleTimer, { passive: true });
+    
+    // Track touch activity
+    addTrackedListener(document, 'touchstart', resetIdleTimer, { passive: true });
+    addTrackedListener(document, 'touchmove', resetIdleTimer, { passive: true });
+    
+    // Start initial timer
+    resetIdleTimer();
+
+    // Cleanup on document unload
+    const unloadHandler = () => {
+      cleanupIdleDetection();
+    };
+    addTrackedListener(window, 'beforeunload', unloadHandler, { passive: true });
+
+
+  }
+
+  // Bookmark Click - Intercept outline item clicks
+  let bookmarkInterceptionSetup = false;
+  
+  function interceptOutlineClicks(app) {
+    // Prevent multiple setups
+    if (bookmarkInterceptionSetup) {
+      log('Bookmark click interception already setup, skipping');
+      return;
+    }
+    
+    // Check if PDF outline viewer is available immediately
+    if (app && app.pdfOutlineViewer && app.pdfOutlineViewer._bindLink) {
+      const originalBindLink = app.pdfOutlineViewer._bindLink;
+      
+      app.pdfOutlineViewer._bindLink = function(element, params) {
+        // Call original bind method first
+        originalBindLink.call(this, element, params);
+        
+        // Intercept bookmark clicks only if enabled
+        if (eventEnablement.bookmarkClick) {
+          const originalOnClick = element.onclick;
+          element.onclick = function(evt) {
+            // Extract bookmark data
+            const bookmarkData = {
+              title: element.textContent?.trim() || 'Unknown',
+              dest: params.dest || null,
+              action: params.action || undefined,
+              url: params.url || undefined,
+              pageNumber: undefined, // Will be resolved by linkService
+              isCurrentItem: element.classList.contains('currentTreeItem')
+            };
+            
+            log(`Bookmark clicked: ${bookmarkData.title}`);
+            sendEventNotification('bookmarkClick', bookmarkData);
+            
+            // Call original handler to preserve navigation functionality
+            if (originalOnClick) {
+              return originalOnClick.call(this, evt);
+            }
+            return false;
+          };
+        }
+      };
+      
+      bookmarkInterceptionSetup = true;
+
+    } else {
+      // If outline viewer is not available yet, defer setup using event-driven approach
+      // Hook into outlineloaded event to retry when outline becomes available
+      if (app && app.eventBus) {
+        const outlineLoadedHandler = () => {
+          if (!bookmarkInterceptionSetup) {
+            interceptOutlineClicks(app); // Retry when outline is loaded
+          }
+        };
+        app.eventBus.on('outlineloaded', outlineLoadedHandler);
+        log('Bookmark click interception deferred until outline loads');
+      } else {
+        log('Unable to setup bookmark click interception - event bus not available', 'warn');
+      }
+    }
+  }
+  // #endregion
+
+  // Start the initialization process
+  waitForViewer();
 })();