fix: API v2 images (#1010)

* fix: consider OpenAPI images in the `ImageUsageAnalyzer`

* fix: Restore API V2 images

Author: vicfergar

.gitignore

@@ -5,4 +5,5 @@ package-lock.json
 build
 .idea
 
-scripts/image_analysis/
+scripts/image_analysis/
+__pycache__/

scripts/analyze_image_usage.py

@@ -21,6 +21,7 @@ def __init__(self, root_dir: str = "."):
         self.root_dir = Path(root_dir)
         self.docs_dir = self.root_dir / "docs"
         self.src_dir = self.root_dir / "src"
+        self.openapi_dir = self.root_dir / "openapi-spec"
         self.static_dir = self.root_dir / "static"
         self.icons_dir = self.static_dir / "icons"
         # Create image_analysis folder in the same directory as the script
@@ -57,9 +58,9 @@ def __init__(self, root_dir: str = "."):
             r'["\']([^"\']*?/images/[^"\']*?\.(?:png|jpg|jpeg|gif|svg|webp))["\']',
         ]
 
-        self.referenced_images = set()
-        self.static_images = set()
-        self.unused_images = set()
+        self.referenced_images: Set[str] = set()
+        self.static_images: Set[str] = set()
+        self.unused_images: Set[str] = set()
 
     def find_all_static_images(self) -> Set[str]:
         """Find all images in the static directory (excluding icons)."""
@@ -95,6 +96,10 @@ def normalize_image_path(self, path: str) -> str:
             path = path[8:]   # Remove '/static/'
         elif path.startswith('static/'):
             path = path[7:]   # Remove 'static/'
+        elif path.startswith('/docs/'):
+            path = path[6:]   # Remove '/docs/' (this maps to static directory)
+        elif path.startswith('docs/'):
+            path = path[5:]   # Remove 'docs/' (this maps to static directory)
         elif path.startswith('../../../static/'):
             path = path[16:]  # Remove '../../../static/' (16 characters)
         elif path.startswith('../../static/'):
@@ -168,6 +173,32 @@ def find_referenced_images(self) -> Set[str]:
                 except Exception as e:
                     print(f"   ⚠️  Error reading {file_path}: {e}")
 
+        # Scan OpenAPI spec files (YAML)
+        if self.openapi_dir.exists():
+            print(f"   📋 Scanning openapi-spec directory...")
+            yaml_files = []
+            for pattern in ['**/*.yaml', '**/*.yml']:
+                yaml_files.extend(glob.glob(str(self.openapi_dir / pattern), recursive=True))
+            
+            print(f"   📋 Found {len(yaml_files)} YAML files")
+            total_files += len(yaml_files)
+            
+            for file_path in yaml_files:
+                try:
+                    with open(file_path, 'r', encoding='utf-8') as f:
+                        content = f.read()
+                        
+                    # Apply all image patterns
+                    for pattern in self.image_patterns:
+                        matches = re.findall(pattern, content, re.IGNORECASE | re.MULTILINE)
+                        for match in matches:
+                            normalized_path = self.normalize_image_path(match)
+                            if normalized_path:
+                                referenced_images.add(normalized_path)
+                
+                except Exception as e:
+                    print(f"   ⚠️  Error reading {file_path}: {e}")
+        
         print(f"📊 Scanned {total_files} total files")
         print(f"📊 Found {len(referenced_images)} unique image references")
         return referenced_images
@@ -280,6 +311,7 @@ def save_results(self, results: Dict):
             f.write("- Properly handles markdown image syntax with alt text\n")
             f.write("- Scans all .md and .mdx files in the /docs directory\n")
             f.write("- Scans all .js, .jsx, .ts, .tsx, .css, .scss files in the /src directory\n")
+            f.write("- Scans all .yaml and .yml files in the /openapi-spec directory\n")
             f.write("- Detects both image syntax (![...]) and link syntax ([...]) pointing to images\n")
             f.write("- Excludes images in the /static/icons directory\n")
             f.write("- Excludes specific ignored images (logos, etc.) from cleanup analysis\n")

scripts/cleanup_unused_images.py

@@ -66,11 +66,12 @@ def calculate_total_size(self, file_paths: List[Path]) -> int:
 
     def format_size(self, size_bytes: int) -> str:
         """Format file size in human readable format."""
+        size = float(size_bytes)
         for unit in ['B', 'KB', 'MB', 'GB']:
-            if size_bytes < 1024.0:
-                return f"{size_bytes:.1f} {unit}"
-            size_bytes /= 1024.0
-        return f"{size_bytes:.1f} TB"
+            if size < 1024.0:
+                return f"{size:.1f} {unit}"
+            size /= 1024.0
+        return f"{size:.1f} TB"
 
     def confirm_deletion(self, file_paths: List[Path]) -> bool:
         """Ask user for confirmation before deleting files."""