Issue #3103918 by greg.1.anderson, Mile23, alexpott, Mixologic, catch: [policy + patch] Decide on backwards compatibility policy for Composer plugins in Drupal 8

Author: goba

AllowedPackages.php

@@ -12,6 +12,8 @@
  *
  * If the root-level composer.json allows drupal/core, and drupal/core allows
  * drupal/assets, then the later package will also implicitly be allowed.
+ *
+ * @internal
  */
 class AllowedPackages implements PostPackageEventListenerInterface {
 

CommandProvider.php

@@ -6,6 +6,8 @@
 
 /**
  * List of all commands provided by this package.
+ *
+ * @internal
  */
 class CommandProvider implements CommandProviderCapability {
 

ComposerScaffoldCommand.php

@@ -11,6 +11,8 @@
  *
  * Manually run the scaffold operation that normally happens after
  * 'composer install'.
+ *
+ * @internal
  */
 class ComposerScaffoldCommand extends BaseCommand {
 

GenerateAutoloadReferenceFile.php

@@ -8,6 +8,8 @@
 
 /**
  * Generates an 'autoload.php' that includes the autoloader created by Composer.
+ *
+ * @internal
  */
 final class GenerateAutoloadReferenceFile {
 

Git.php

@@ -7,6 +7,8 @@
 
 /**
  * Provide some Git utility operations
+ *
+ * @internal
  */
 class Git {
 

Handler.php

@@ -17,6 +17,8 @@
  *
  * Contains the primary logic which determines the files to be fetched and
  * processed.
+ *
+ * @internal
  */
 class Handler {
 

Interpolator.php

@@ -4,6 +4,8 @@
 
 /**
  * Injects config values from an associative array into a string.
+ *
+ * @internal
  */
 class Interpolator {
 

ManageGitIgnore.php

@@ -6,6 +6,8 @@
 
 /**
  * Manage the .gitignore file.
+ *
+ * @internal
  */
 class ManageGitIgnore {
 

ManageOptions.php

@@ -12,6 +12,8 @@
  * Projects that describe scaffold files do so via their scaffold options.
  * This data is pulled from the 'drupal-scaffold' portion of the extras
  * section of the project data.
+ *
+ * @internal
  */
 class ManageOptions {
 

Operations/AbstractOperation.php

@@ -6,6 +6,8 @@
 
 /**
  * Provides default behaviors for operations.
+ *
+ * @internal
  */
 abstract class AbstractOperation implements OperationInterface {
 

Operations/AppendOp.php

@@ -8,6 +8,8 @@
 
 /**
  * Scaffold operation to add to the beginning and/or end of a scaffold file.
+ *
+ * @internal
  */
 class AppendOp extends AbstractOperation {
 

Operations/ConjunctionOp.php

@@ -8,6 +8,8 @@
 
 /**
  * Joins two operations on the same file into a single operation.
+ *
+ * @internal
  */
 class ConjunctionOp extends AbstractOperation {
 

Operations/OperationData.php

@@ -4,6 +4,8 @@
 
 /**
  * Holds parameter data for operation objects during operation creation only.
+ *
+ * @internal
  */
 class OperationData {
 

Operations/OperationFactory.php

@@ -8,6 +8,8 @@
 
 /**
  * Create Scaffold operation objects based on provided metadata.
+ *
+ * @internal
  */
 class OperationFactory {
 

Operations/OperationInterface.php

@@ -8,6 +8,8 @@
 
 /**
  * Interface for scaffold operation objects.
+ *
+ * @internal
  */
 interface OperationInterface {
 

Operations/ReplaceOp.php

@@ -9,6 +9,8 @@
 
 /**
  * Scaffold operation to copy or symlink from source to destination.
+ *
+ * @internal
  */
 class ReplaceOp extends AbstractOperation {
 

Operations/ScaffoldFileCollection.php

@@ -10,6 +10,8 @@
 
 /**
  * Collection of scaffold files.
+ *
+ * @internal
  */
 class ScaffoldFileCollection implements \IteratorAggregate {
 

Operations/ScaffoldResult.php

@@ -6,6 +6,8 @@
 
 /**
  * Record the result of a scaffold operation.
+ *
+ * @internal
  */
 class ScaffoldResult {
 

Operations/SkipOp.php

@@ -8,6 +8,8 @@
 
 /**
  * Scaffold operation to skip a scaffold file (do nothing).
+ *
+ * @internal
  */
 class SkipOp extends AbstractOperation {
 

Plugin.php

@@ -18,6 +18,8 @@
 
 /**
  * Composer plugin for handling drupal scaffold.
+ *
+ * @internal
  */
 class Plugin implements PluginInterface, EventSubscriberInterface, Capable {
 

PostPackageEventListenerInterface.php

@@ -8,6 +8,8 @@
  * Interface for post package event listeners.
  *
  * @see \Drupal\Composer\Plugin\Scaffold\Handler::onPostPackageEvent
+ *
+ * @internal
  */
 interface PostPackageEventListenerInterface {
 

ScaffoldFileInfo.php

@@ -12,6 +12,8 @@
  * scaffold file also has an 'operation' object that controls how the scaffold
  * file will be placed (e.g. via copy or symlink, or maybe by appending multiple
  * files together). The operation may have one or more source files.
+ *
+ * @internal
  */
 class ScaffoldFileInfo {
 

ScaffoldFilePath.php

@@ -15,6 +15,8 @@
  * source files used to create them. Static factory methods named
  * destinationPath and sourcePath, respectively, are provided to create
  * ScaffoldFilePath objects.
+ *
+ * @internal
  */
 class ScaffoldFilePath {
 

ScaffoldOptions.php

@@ -8,6 +8,8 @@
  * Projects that describe scaffold files do so via their scaffold options. This
  * data is pulled from the 'drupal-scaffold' portion of the extras section of
  * the project data.
+ *
+ * @internal
  */
 class ScaffoldOptions {