Add @internal to what is not covered by our BC promise

calendar-bundle/src/ContaoManager/Plugin.php

@@ -18,6 +18,9 @@
 use Contao\ManagerPlugin\Bundle\Config\BundleConfig;
 use Contao\ManagerPlugin\Bundle\Parser\ParserInterface;
 
+/**
+ * @internal
+ */
 class Plugin implements BundlePluginInterface
 {
     /**

calendar-bundle/src/EventListener/GeneratePageListener.php

@@ -21,6 +21,9 @@
 use Contao\StringUtil;
 use Contao\Template;
 
+/**
+ * @internal
+ */
 class GeneratePageListener
 {
     /**

calendar-bundle/src/EventListener/InsertTagsListener.php

@@ -18,6 +18,9 @@
 use Contao\Events;
 use Contao\StringUtil;
 
+/**
+ * @internal
+ */
 class InsertTagsListener
 {
     private const SUPPORTED_TAGS = [

calendar-bundle/src/EventListener/PreviewUrlConvertListener.php

@@ -19,6 +19,9 @@
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\RequestStack;
 
+/**
+ * @internal
+ */
 class PreviewUrlConvertListener
 {
     /**

calendar-bundle/src/EventListener/PreviewUrlCreateListener.php

@@ -18,6 +18,9 @@
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\RequestStack;
 
+/**
+ * @internal
+ */
 class PreviewUrlCreateListener
 {
     /**

calendar-bundle/src/Picker/EventPickerProvider.php

@@ -33,6 +33,9 @@ class EventPickerProvider extends AbstractInsertTagPickerProvider implements Dca
      */
     private $security;
 
+    /**
+     * @internal Do not inherit from this class; decorate the "contao.cache.clear_internal" service instead
+     */
     public function __construct(FactoryInterface $menuFactory, RouterInterface $router, ?TranslatorInterface $translator, Security $security)
     {
         parent::__construct($menuFactory, $router, $translator);

comments-bundle/src/ContaoManager/Plugin.php

@@ -18,6 +18,9 @@
 use Contao\ManagerPlugin\Bundle\Config\BundleConfig;
 use Contao\ManagerPlugin\Bundle\Parser\ParserInterface;
 
+/**
+ * @internal
+ */
 class Plugin implements BundlePluginInterface
 {
     /**

core-bundle/src/Cache/ContaoCacheClearer.php

@@ -22,6 +22,9 @@ class ContaoCacheClearer implements CacheClearerInterface
      */
     private $filesystem;
 
+    /**
+     * @internal Do not inherit from this class; decorate the "contao.cache.clear_internal" service instead
+     */
     public function __construct(Filesystem $filesystem)
     {
         $this->filesystem = $filesystem;

core-bundle/src/Cache/ContaoCacheWarmer.php

@@ -59,6 +59,9 @@ class ContaoCacheWarmer implements CacheWarmerInterface
      */
     private $framework;
 
+    /**
+     * @internal Do not inherit from this class; decorate the "contao.cache.warm_internal" service instead
+     */
     public function __construct(Filesystem $filesystem, ResourceFinderInterface $finder, FileLocator $locator, string $rootDir, Connection $connection, ContaoFramework $framework)
     {
         $this->filesystem = $filesystem;

core-bundle/src/Command/AutomatorCommand.php

@@ -23,6 +23,8 @@
 
 /**
  * Runs Contao automator tasks on the command line.
+ *
+ * @internal
  */
 class AutomatorCommand extends Command
 {

core-bundle/src/Command/DebugDcaCommand.php

@@ -23,6 +23,8 @@
 
 /**
  * Dumps debug information about a Contao DCA.
+ *
+ * @internal
  */
 class DebugDcaCommand extends Command
 {

core-bundle/src/Command/FilesyncCommand.php

@@ -21,6 +21,8 @@
 
 /**
  * Synchronizes the file system with the database.
+ *
+ * @internal
  */
 class FilesyncCommand extends Command implements FrameworkAwareInterface
 {

core-bundle/src/Command/InstallCommand.php

@@ -21,6 +21,8 @@
 
 /**
  * Installs the required Contao directories.
+ *
+ * @internal
  */
 class InstallCommand extends Command
 {

core-bundle/src/Command/ResizeImagesCommand.php

@@ -33,6 +33,8 @@
 
 /**
  * Resize deferred images that have not been processed yet.
+ *
+ * @internal
  */
 class ResizeImagesCommand extends Command
 {

core-bundle/src/Command/SymlinksCommand.php

@@ -29,6 +29,8 @@
 
 /**
  * Symlinks the public resources into the web directory.
+ *
+ * @internal
  */
 class SymlinksCommand extends Command
 {

core-bundle/src/Command/UserPasswordCommand.php

@@ -31,6 +31,8 @@
 
 /**
  * Changes the password of a Contao back end user.
+ *
+ * @internal
  */
 class UserPasswordCommand extends Command
 {

core-bundle/src/Command/VersionCommand.php

@@ -18,6 +18,8 @@
 use Symfony\Component\Console\Output\OutputInterface;
 
 /**
+ * @internal
+ *
  * @deprecated Deprecated since Contao 4.4, to be removed in Contao 5.0; use
  *             "composer show | grep contao/core-bundle | awk '{ print $2 }'" instead
  */

core-bundle/src/ContaoManager/Plugin.php

@@ -36,6 +36,9 @@
 use Symfony\Component\Routing\RouteCollection;
 use Terminal42\ServiceAnnotationBundle\Terminal42ServiceAnnotationBundle;
 
+/**
+ * @internal
+ */
 class Plugin implements BundlePluginInterface, RoutingPluginInterface
 {
     /**

core-bundle/src/Cors/WebsiteRootsConfigProvider.php

@@ -24,6 +24,9 @@ class WebsiteRootsConfigProvider implements ProviderInterface
      */
     private $connection;
 
+    /**
+     * @internal Do not inherit from this class; decorate the "contao.cors.website_roots_config_provider" service instead
+     */
     public function __construct(Connection $connection)
     {
         $this->connection = $connection;

core-bundle/src/DataCollector/ContaoDataCollector.php

@@ -22,6 +22,9 @@
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\HttpKernel\DataCollector\DataCollector;
 
+/**
+ * @internal
+ */
 class ContaoDataCollector extends DataCollector implements FrameworkAwareInterface
 {
     use FrameworkAwareTrait;

core-bundle/src/DependencyInjection/Compiler/AddAssetsPackagesPass.php

@@ -21,6 +21,9 @@
 use Symfony\Component\DependencyInjection\Definition;
 use Symfony\Component\DependencyInjection\Reference;
 
+/**
+ * @internal
+ */
 class AddAssetsPackagesPass implements CompilerPassInterface
 {
     /**

core-bundle/src/DependencyInjection/Compiler/AddPackagesPass.php

@@ -19,6 +19,8 @@
 
 /**
  * Adds the composer packages and version numbers to the container.
+ *
+ * @internal
  */
 class AddPackagesPass implements CompilerPassInterface
 {

core-bundle/src/DependencyInjection/Compiler/AddResourcesPathsPass.php

@@ -16,6 +16,9 @@
 use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 
+/**
+ * @internal
+ */
 class AddResourcesPathsPass implements CompilerPassInterface
 {
     /**

core-bundle/src/DependencyInjection/Compiler/AddSessionBagsPass.php

@@ -16,6 +16,9 @@
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Reference;
 
+/**
+ * @internal
+ */
 class AddSessionBagsPass implements CompilerPassInterface
 {
     /**

core-bundle/src/DependencyInjection/Compiler/DataContainerCallbackPass.php

@@ -17,6 +17,9 @@
 use Symfony\Component\DependencyInjection\Container;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 
+/**
+ * @internal
+ */
 class DataContainerCallbackPass implements CompilerPassInterface
 {
     /**

core-bundle/src/DependencyInjection/Compiler/MakeServicesPublicPass.php

@@ -17,6 +17,8 @@
 
 /**
  * Makes services public that we need to retrieve directly.
+ *
+ * @internal
  */
 class MakeServicesPublicPass implements CompilerPassInterface
 {

core-bundle/src/DependencyInjection/Compiler/MapFragmentsToGlobalsPass.php

@@ -23,6 +23,9 @@
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Definition;
 
+/**
+ * @internal
+ */
 class MapFragmentsToGlobalsPass implements CompilerPassInterface
 {
     use PriorityTaggedServiceTrait;

core-bundle/src/DependencyInjection/Compiler/PickerProviderPass.php

@@ -16,6 +16,9 @@
 use Symfony\Component\DependencyInjection\Compiler\PriorityTaggedServiceTrait;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 
+/**
+ * @internal
+ */
 class PickerProviderPass implements CompilerPassInterface
 {
     use PriorityTaggedServiceTrait;

core-bundle/src/DependencyInjection/Compiler/RegisterHookListenersPass.php

@@ -16,6 +16,9 @@
 use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 
+/**
+ * @internal
+ */
 class RegisterHookListenersPass implements CompilerPassInterface
 {
     /**

core-bundle/src/DependencyInjection/Compiler/RemembermeServicesPass.php

@@ -16,6 +16,9 @@
 use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 
+/**
+ * @internal
+ */
 class RemembermeServicesPass implements CompilerPassInterface
 {
     public const OVERRIDE_PREFIX = 'security.authentication.rememberme.services.simplehash';

core-bundle/src/DependencyInjection/Compiler/SearchIndexerPass.php

@@ -17,6 +17,9 @@
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Reference;
 
+/**
+ * @internal
+ */
 class SearchIndexerPass implements CompilerPassInterface
 {
     use PriorityTaggedServiceTrait;

core-bundle/src/DependencyInjection/Compiler/TranslationDataCollectorPass.php

@@ -16,6 +16,9 @@
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Reference;
 
+/**
+ * @internal
+ */
 class TranslationDataCollectorPass implements CompilerPassInterface
 {
     /**

core-bundle/src/Doctrine/Schema/DcaSchemaProvider.php

@@ -36,6 +36,9 @@ class DcaSchemaProvider
      */
     private $doctrine;
 
+    /**
+     * @internal Do not inherit from this class; decorate the "contao.doctrine.schema_provider" service instead
+     */
     public function __construct(ContaoFramework $framework, Registry $doctrine)
     {
         $this->framework = $framework;

core-bundle/src/EventListener/BackendLocaleListener.php

@@ -17,6 +17,9 @@
 use Symfony\Component\Security\Core\Security;
 use Symfony\Contracts\Translation\LocaleAwareInterface;
 
+/**
+ * @internal
+ */
 class BackendLocaleListener
 {
     /**

core-bundle/src/EventListener/BackendMenuListener.php

@@ -18,6 +18,9 @@
 use Knp\Menu\ItemInterface;
 use Symfony\Component\Security\Core\Security;
 
+/**
+ * @internal
+ */
 class BackendMenuListener
 {
     /**

core-bundle/src/EventListener/BypassMaintenanceListener.php

@@ -15,6 +15,9 @@
 use Contao\CoreBundle\Security\Authentication\Token\TokenChecker;
 use Symfony\Component\HttpKernel\Event\RequestEvent;
 
+/**
+ * @internal
+ */
 class BypassMaintenanceListener
 {
     /**

core-bundle/src/EventListener/ClearSessionDataListener.php

@@ -15,6 +15,9 @@
 use Symfony\Component\HttpFoundation\Session\Attribute\AttributeBag;
 use Symfony\Component\HttpKernel\Event\ResponseEvent;
 
+/**
+ * @internal
+ */
 class ClearSessionDataListener
 {
     /**

core-bundle/src/EventListener/CommandSchedulerListener.php

@@ -20,6 +20,9 @@
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpKernel\Event\TerminateEvent;
 
+/**
+ * @internal
+ */
 class CommandSchedulerListener
 {
     /**

core-bundle/src/EventListener/CsrfTokenCookieListener.php

@@ -21,6 +21,9 @@
 use Symfony\Component\HttpKernel\Event\RequestEvent;
 use Symfony\Component\HttpKernel\Event\ResponseEvent;
 
+/**
+ * @internal
+ */
 class CsrfTokenCookieListener
 {
     /**

core-bundle/src/EventListener/DataContainerCallbackListener.php

@@ -12,6 +12,9 @@
 
 namespace Contao\CoreBundle\EventListener;
 
+/**
+ * @internal
+ */
 class DataContainerCallbackListener
 {
     private const SINGLETONS = [

core-bundle/src/EventListener/DoctrineSchemaListener.php

@@ -19,6 +19,9 @@
 use Doctrine\DBAL\Schema\Index;
 use Doctrine\ORM\Tools\Event\GenerateSchemaEventArgs;
 
+/**
+ * @internal
+ */
 class DoctrineSchemaListener
 {
     /**