feat: Add global debugging utilities and improve head element management

Author: v01gh7

SeamlessRouter.umd.min.js

@@ -32,7 +32,7 @@ Download the ready-to-use UMD version from the project root:
 <script data-keep data-skip src="SeamlessRouter.umd.min.js"></script>
 ```
 
-**File size**: ~43.4KB (minified) | ~11.8KB gzipped
+**File size**: ~45.8KB (minified) | ~12.3KB gzipped
 
 #### Development Build
 ```bash

readme.md

@@ -51,7 +51,7 @@ export class AdvancedRouter {
     }
   }
 
-    /**
+  /**
    * Внедрить CSS стили для анимаций
    */
   private injectAnimationStyles(): void {
@@ -62,6 +62,8 @@ export class AdvancedRouter {
 
     const style = document.createElement('style');
     style.id = 'router-animation-styles';
+    style.setAttribute('data-keep', '');
+    style.setAttribute('data-skip', '');
     style.textContent = this.createAnimationStyles();
     document.head.appendChild(style);
   }
@@ -319,25 +321,55 @@ export class AdvancedRouter {
   private updateHead(newHead: HTMLHeadElement): void {
     const oldHead = document.head;
 
-    // Обновляем title
+    // Собираем все элементы из нового head, которые нужно сохранить
+    const elementsToKeep = new Set<Element>();
+    
+    // 1. Сначала находим элементы, которые должны остаться (с data-keep или data-skip)
+    Array.from(oldHead.children).forEach(element => {
+      if (element.hasAttribute('data-keep') || element.hasAttribute('data-skip')) {
+        elementsToKeep.add(element);
+      }
+    });
+    
+    // 2. Удаляем все старые элементы, кроме тех что нужно сохранить
+    Array.from(oldHead.children).forEach(element => {
+      if (!elementsToKeep.has(element)) {
+        oldHead.removeChild(element);
+      }
+    });
+    
+    // 3. Добавляем все новые элементы, кроме тех что уже есть с data-keep/data-skip
+    Array.from(newHead.children).forEach(newElement => {
+      // Проверяем, есть ли уже такой элемент с data-keep/data-skip
+      const shouldSkip = newElement.hasAttribute('data-skip');
+      const shouldKeep = newElement.hasAttribute('data-keep');
+      
+      if (shouldSkip) {
+        // Элементы с data-skip не добавляем
+        return;
+      }
+      
+      if (shouldKeep) {
+        // Для элементов с data-keep проверяем, не добавлен ли уже
+        const existingElement = oldHead.querySelector(`[data-keep][id="${newElement.id}"]`) || 
+                               oldHead.querySelector(`[data-keep][src="${newElement.getAttribute('src')}"]`);
+        if (!existingElement) {
+          oldHead.appendChild(newElement.cloneNode(true));
+        }
+      } else {
+        // Обычные элементы добавляем всегда
+        oldHead.appendChild(newElement.cloneNode(true));
+      }
+    });
+    
+    // 4. Убедимся, что title всегда обновляется
     const newTitle = newHead.querySelector('title');
     const oldTitle = oldHead.querySelector('title');
     if (newTitle && oldTitle) {
       oldTitle.textContent = newTitle.textContent;
+    } else if (newTitle && !oldTitle) {
+      oldHead.appendChild(newTitle.cloneNode(true));
     }
-
-    // Обновляем meta теги
-    const metaTagsToUpdate = ['description', 'keywords', 'viewport'];
-    metaTagsToUpdate.forEach(name => {
-      const newMeta = newHead.querySelector(`meta[name="${name}"]`);
-      const oldMeta = oldHead.querySelector(`meta[name="${name}"]`);
-      
-      if (newMeta && oldMeta) {
-        oldMeta.setAttribute('content', newMeta.getAttribute('content') || '');
-      } else if (newMeta && !oldMeta) {
-        oldHead.appendChild(newMeta.cloneNode(true));
-      }
-    });
   }
 
   /**

src/core/AdvancedRouter.ts

@@ -15,6 +15,93 @@ initGlobalSandbox();
 // Инициализируем роутер асинхронно
 router.init().then(() => {
   console.log('✅ AdvancedRouter fully initialized');
+  
+  // Добавляем глобальные функции для управления из консоли
+  if (typeof window !== 'undefined') {
+    // Очистить весь кэш роутера
+    (window as any).clearRouterCache = () => {
+      router.clearCache();
+      console.log('🧹 Router cache cleared');
+      return 'Router cache cleared successfully';
+    };
+    
+    // Очистить очередь предзагрузки
+    (window as any).clearPrefetchQueue = () => {
+      router.clearPrefetchQueue();
+      console.log('🧹 Prefetch queue cleared');
+      return 'Prefetch queue cleared successfully';
+    };
+    
+    // Очистить историю навигации
+    (window as any).clearNavigationHistory = () => {
+      router.clearNavigationHistory();
+      console.log('🧹 Navigation history cleared');
+      return 'Navigation history cleared successfully';
+    };
+    
+    // Очистить кэш Service Worker
+    (window as any).clearServiceWorkerCache = async () => {
+      const result = await router.clearServiceWorkerCache();
+      console.log('🧹 Service Worker cache cleared:', result);
+      return `Service Worker cache cleared: ${result}`;
+    };
+    
+    // Получить статистику кэша
+    (window as any).getCacheStats = () => {
+      const stats = router.getCacheManager().getStats();
+      console.log('📊 Cache stats:', stats);
+      return stats;
+    };
+    
+    // Получить статистику предзагрузки
+    (window as any).getPrefetchStats = () => {
+      const stats = router.getPrefetchManager().getStats();
+      console.log('📊 Prefetch stats:', stats);
+      return stats;
+    };
+    
+    // Получить все URL в кэше
+    (window as any).getCachedUrls = () => {
+      const urls = router.getCacheManager().getUrls();
+      console.log('📋 Cached URLs:', urls);
+      return urls;
+    };
+    
+    // Очистить ВСЁ (комплексная очистка)
+    (window as any).clearAllRouterData = async () => {
+      console.log('🧹 Starting comprehensive router data cleanup...');
+      
+      router.clearCache();
+      console.log('✅ Router cache cleared');
+      
+      router.clearPrefetchQueue();
+      console.log('✅ Prefetch queue cleared');
+      
+      router.clearNavigationHistory();
+      console.log('✅ Navigation history cleared');
+      
+      try {
+        const swResult = await router.clearServiceWorkerCache();
+        console.log('✅ Service Worker cache cleared:', swResult);
+      } catch (error) {
+        console.warn('⚠️ Could not clear Service Worker cache:', error);
+      }
+      
+      console.log('🎉 All router data cleared successfully');
+      return 'All router data cleared successfully';
+    };
+    
+    console.log('🔧 Global router management functions added to window object');
+    console.log('📋 Available functions:');
+    console.log('  - clearRouterCache() - Clear router cache');
+    console.log('  - clearPrefetchQueue() - Clear prefetch queue');
+    console.log('  - clearNavigationHistory() - Clear navigation history');
+    console.log('  - clearServiceWorkerCache() - Clear Service Worker cache');
+    console.log('  - clearAllRouterData() - Clear ALL router data');
+    console.log('  - getCacheStats() - Get cache statistics');
+    console.log('  - getPrefetchStats() - Get prefetch statistics');
+    console.log('  - getCachedUrls() - Get all cached URLs');
+  }
 }).catch(error => {
   console.error('❌ Failed to initialize AdvancedRouter:', error);
 });