Add @internal to what is not covered by our BC promise (see #1045)

Description
-----------

Implements #1031 

**TODO**

* [x] What about controllers? Do they need an `@internal` tag, too?
* [x] What about `Contao\CoreBundle\Repository\RememberMeRepository`?
* [x] What about `Contao\ManagerBundle\Api\*`?
* [x] What about `Contao\ManagerBundle\ContaoManager\ApiCommand\*`?

Commits
-------

b3273e3 Add @internal to what is not covered by our BC promise (see #1031)
3c7da70 Fix a wrong service name and make controllers and API classes internal
a8aaee0 Do not make the ContaoUserProvider class internal

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_calendar.picker.event_provider" 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/Controller/BackendController.php

@@ -35,6 +35,8 @@
 
 /**
  * @Route(defaults={"_scope" = "backend", "_token_check" = true})
+ *
+ * @internal
  */
 class BackendController extends AbstractController
 {

core-bundle/src/Controller/BackendCsvImportController.php

@@ -58,6 +58,9 @@ class BackendCsvImportController
      */
     private $projectDir;
 
+    /**
+     * @internal Do not inherit from this class; decorate the "Contao\CoreBundle\Controller\BackendCsvImportController" service instead
+     */
     public function __construct(ContaoFramework $framework, Connection $connection, RequestStack $requestStack, TranslatorInterface $translator, string $projectDir)
     {
         $this->framework = $framework;

core-bundle/src/Controller/FaviconController.php

@@ -23,6 +23,8 @@
 
 /**
  * @Route(defaults={"_scope" = "frontend"})
+ *
+ * @internal
  */
 class FaviconController
 {

core-bundle/src/Controller/FrontendController.php

@@ -29,6 +29,8 @@
 
 /**
  * @Route(defaults={"_scope" = "frontend", "_token_check" = true})
+ *
+ * @internal
  */
 class FrontendController extends AbstractController
 {

core-bundle/src/Controller/FrontendModule/TwoFactorController.php

@@ -29,6 +29,9 @@
 use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
 use Symfony\Contracts\Translation\TranslatorInterface;
 
+/**
+ * @internal
+ */
 class TwoFactorController extends AbstractFrontendModuleController
 {
     /**

core-bundle/src/Controller/ImagesController.php

@@ -21,6 +21,9 @@
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
+/**
+ * @internal
+ */
 class ImagesController
 {
     /**

core-bundle/src/Controller/InitializeController.php

@@ -27,6 +27,8 @@
 /**
  * Custom controller to support legacy entry points.
  *
+ * @internal
+ *
  * @deprecated Deprecated in Contao 4.0, to be removed in Contao 5.0
  */
 class InitializeController extends AbstractController

core-bundle/src/Controller/RobotsTxtController.php

@@ -24,6 +24,8 @@
 
 /**
  * @Route(defaults={"_scope" = "frontend"})
+ *
+ * @internal
  */
 class RobotsTxtController
 {

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;