docs: Theme Builder guide, instructions, readme and spec for 0.5.0

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

src/Guides/InstructionsBuilder.php

@@ -19,6 +19,9 @@ final class InstructionsBuilder
     /** Tool group of the Divi Library (LibraryAccess::GROUP); its rule needs a writable group. */
     private const LIBRARY_GROUP = 'divi-library';
 
+    /** Tool group of the Divi Theme Builder (ThemeBuilderAccess::GROUP); its rule needs a writable group. */
+    private const THEME_BUILDER_GROUP = 'divi-theme-builder';
+
     /** @var (callable(): list<string>)|null */
     private $postTypeNames;
 
@@ -75,6 +78,15 @@ final class InstructionsBuilder
             ]
             : [];
 
+        $themeBuilder = str_contains(', ' . $active . ',', ', ' . self::THEME_BUILDER_GROUP . ',')
+            && $this->policy->groupWritable(self::THEME_BUILDER_GROUP)
+            ? [
+                '- Divi Theme Builder: neue Vorlagen entstehen deaktiviert; aktivieren nur auf ausdrücklichen '
+                    . 'Wunsch mit lit/tb-activate (Probelauf, dann confirm: true); '
+                    . 'Ablauf: lit-guide topic "theme-builder".',
+            ]
+            : [];
+
         return implode("\n", array_merge($lines, [
             'Regeln:',
             '- Vor dem ersten Arbeitsschritt lit-guide (ohne Topic) aufrufen; Details je Thema über lit-guide '
@@ -86,6 +98,6 @@ final class InstructionsBuilder
             '- Beim Bearbeiten immer den rev-Wert aus dem letzten Lesevorgang mitgeben (Pflicht).',
             '- Löschen und Ersetzen erst nach Rückfrage beim Nutzer (confirm: true).',
             '- Fehler enthalten einen hint – ihm folgen, statt blind zu wiederholen.',
-        ], $divi, $library));
+        ], $divi, $library, $themeBuilder));
     }
 }

src/Integrations/Divi/Pages/DiviSchema.php

@@ -20,8 +20,9 @@ final class DiviSchema
             ],
             'confirm' => [
                 'type' => 'boolean',
-                'description' => 'Bei globalen Bibliothekseinträgen (und beim Löschen): true erst, nachdem der Nutzer '
-                    . 'den Probelauf (confirm_required mit den betroffenen Seiten) bestätigt hat.',
+                'description' => 'Bei globalen Bibliothekseinträgen, bei Theme-Builder-Layouts aktiver Vorlagen (und '
+                    . 'beim Löschen): true erst, nachdem der Nutzer den Probelauf (confirm_required mit den '
+                    . 'betroffenen Seiten bzw. Vorlagen) bestätigt hat.',
             ],
         ];
     }

src/Plugin.php

@@ -45,7 +45,7 @@ defined('ABSPATH') || exit;
  */
 final class Plugin
 {
-    public const VERSION = '0.4.0';
+    public const VERSION = '0.5.0';
 
     private static string $pluginFile = '';
     private static ?SettingsPage $settingsPage = null;