fix: media usage search never reports a capped scan as unused

Adds widgets and header/background theme mods, integer galleryIds,
wider pre-filter, regex failures as possible usages, newest-first
candidates, and usages_complete/usages_truncated in media-get.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01At3V6SjwbMe6eMzVGW3Hs7

src/Integrations/Media/MediaGetAbility.php

@@ -29,6 +29,8 @@ final class MediaGetAbility implements Ability
             . 'Bildunterschrift, Beschreibung und die Verwendungsorte (Beitragsbild, Inhalte inkl. Divi, '
             . 'Bildfelder, Website-Icon, Logo). certainty "sicher" = per ID eingebunden, "möglicherweise" = nur '
             . 'die Datei-URL gefunden. Einträge ohne Leserecht erscheinen als "(nicht lesbar)". '
+            . 'usages_truncated: true = es gibt mehr Verwendungen als gelistet; usages_complete: false = die '
+            . 'Inhaltssuche wurde begrenzt, weitere Verwendungen sind möglich. '
             . 'Vorschaubild über lit-media-preview.';
     }
 
@@ -44,7 +46,12 @@ final class MediaGetAbility implements Ability
 
     public function outputSchema(): ?array
     {
-        return MediaPresenter::fullSchema();
+        $schema = MediaPresenter::fullSchema();
+        $schema['properties']['usages_complete'] = ['type' => 'boolean'];
+        $schema['properties']['usages_truncated'] = ['type' => 'boolean'];
+        $schema['required'] = array_merge($schema['required'], ['usages_complete', 'usages_truncated']);
+
+        return $schema;
     }
 
     public function annotations(): array
@@ -71,6 +78,11 @@ final class MediaGetAbility implements Ability
             return $attachment;
         }
 
-        return $this->presenter->full($attachment, $this->finder->usages((int) $attachment->ID));
+        $scan = $this->finder->scan((int) $attachment->ID);
+
+        return array_merge($this->presenter->full($attachment, $scan['usages']), [
+            'usages_complete' => $scan['complete'],
+            'usages_truncated' => $scan['truncated'],
+        ]);
     }
 }