3.3.1

CHANGELOG.md

@@ -1,3 +1,13 @@
+## 3.3.1
+
+- **Surgical Font Assets & Pubspec Pruning:**
+  - `AssetAuditor` now explicitly recognizes font assets declared under `flutter -> fonts` in `pubspec.yaml`.
+  - Improved `_isFontUsed` to accurately match font families as quoted string literals in Dart code (e.g. `fontFamily: 'Cairo'`), preventing false positives when filenames share substrings with family names.
+  - `AssetCleaner` now surgically prunes unused font declarations (`- asset: ...`) along with their child properties (`weight`, `style`, comments) from `pubspec.yaml`.
+  - Automatically prunes empty `- family:` blocks when all their font assets are removed.
+  - Automatically prunes the `fonts:` section when all families are removed, preventing invalid YAML mapping issues.
+  - Automatically prunes empty directory patterns under `assets:` (e.g. `- assets/fonts/`) when all assets inside the directory are purged.
+
 ## 3.3.0
 
 - **AI Agent Optimization (LLMO / GEO Standard Compliance):**

lib/src/assets/asset_auditor.dart

@@ -325,7 +325,7 @@ class AssetAuditor {
   bool _isFontUsed(File file, PackageDescriptor ownerPkg, String codeCorpus) {
     final fileName = file.uri.pathSegments.safeLast ?? '';
 
-    // Check if filename is directly referenced
+    // Check if filename is directly referenced (e.g. 'assets/fonts/Cairo.ttf' or 'Cairo.ttf')
     if (codeCorpus.contains(fileName)) return true;
 
     // Check if any declared font family containing this asset is referenced in code
@@ -337,8 +337,9 @@ class AssetAuditor {
       final assets = entry.value;
 
       if (assets.any((a) => a.replaceAll(r'\', '/') == normPath)) {
-        // If the font family name is referenced in Dart code (e.g. fontFamily: 'MyFont')
-        if (codeCorpus.contains(family)) {
+        // If the font family name is referenced as a string literal in Dart code (e.g. fontFamily: 'MyFont' or "MyFont")
+        final familyPattern = RegExp('[\'"]${RegExp.escape(family)}[\'"]');
+        if (familyPattern.hasMatch(codeCorpus)) {
           return true;
         }
       }
@@ -360,11 +361,19 @@ class AssetAuditor {
     return '$first$rest';
   }
 
-  /// Checks if a file path was explicitly declared by full path in pubspec.yaml.
+  /// Checks if a file path was explicitly declared by full path in pubspec.yaml (assets or fonts).
   bool _isExplicitlyDeclared(String relPackage, PackageDescriptor pkg) {
     final norm = relPackage.replaceAll(r'\', '/');
-    return pkg.declaredAssetPatterns
-        .any((pat) => pat.replaceAll(r'\', '/') == norm);
+    if (pkg.declaredAssetPatterns
+        .any((pat) => pat.replaceAll(r'\', '/') == norm)) {
+      return true;
+    }
+    for (final fontList in pkg.declaredFonts.values) {
+      if (fontList.any((f) => f.replaceAll(r'\', '/') == norm)) {
+        return true;
+      }
+    }
+    return false;
   }
 }