Mark built-in token parsers as @internal

src/TokenParser/ApplyTokenParser.php

@@ -23,6 +23,8 @@ use Twig\Token;
  *   {% apply upper %}
  *      This text becomes uppercase
  *   {% endapply %}
+ *
+ * @internal
  */
 final class ApplyTokenParser extends AbstractTokenParser
 {

src/TokenParser/AutoEscapeTokenParser.php

@@ -19,6 +19,8 @@ use Twig\Token;
 
 /**
  * Marks a section of a template to be escaped or not.
+ *
+ * @internal
  */
 final class AutoEscapeTokenParser extends AbstractTokenParser
 {

src/TokenParser/BlockTokenParser.php

@@ -26,6 +26,8 @@ use Twig\Token;
  *    <link rel="stylesheet" href="style.css" />
  *    <title>{% block title %}{% endblock %} - My Webpage</title>
  *  {% endblock %}
+ *
+ * @internal
  */
 final class BlockTokenParser extends AbstractTokenParser
 {

src/TokenParser/DeprecatedTokenParser.php

@@ -22,6 +22,8 @@ use Twig\Token;
  *    {% extends 'layout.html.twig' %}
  *
  * @author Yonel Ceruto <yonelceruto@gmail.com>
+ *
+ * @internal
  */
 final class DeprecatedTokenParser extends AbstractTokenParser
 {

src/TokenParser/DoTokenParser.php

@@ -17,6 +17,8 @@ use Twig\Token;
 
 /**
  * Evaluates an expression, discarding the returned value.
+ *
+ * @internal
  */
 final class DoTokenParser extends AbstractTokenParser
 {

src/TokenParser/EmbedTokenParser.php

@@ -19,6 +19,8 @@ use Twig\Token;
 
 /**
  * Embeds a template.
+ *
+ * @internal
  */
 final class EmbedTokenParser extends IncludeTokenParser
 {

src/TokenParser/ExtendsTokenParser.php

@@ -20,6 +20,8 @@ use Twig\Token;
  * Extends a template by another one.
  *
  *  {% extends "base.html" %}
+ *
+ * @internal
  */
 final class ExtendsTokenParser extends AbstractTokenParser
 {

src/TokenParser/FlushTokenParser.php

@@ -19,6 +19,8 @@ use Twig\Token;
  * Flushes the output to the client.
  *
  * @see flush()
+ *
+ * @internal
  */
 final class FlushTokenParser extends AbstractTokenParser
 {

src/TokenParser/ForTokenParser.php

@@ -25,6 +25,8 @@ use Twig\Token;
  *      <li>{{ user.username|e }}</li>
  *    {% endfor %}
  *   </ul>
+ *
+ * @internal
  */
 final class ForTokenParser extends AbstractTokenParser
 {

src/TokenParser/FromTokenParser.php

@@ -20,6 +20,8 @@ use Twig\Token;
  * Imports macros.
  *
  *   {% from 'forms.html' import forms %}
+ *
+ * @internal
  */
 final class FromTokenParser extends AbstractTokenParser
 {

src/TokenParser/IfTokenParser.php

@@ -27,6 +27,8 @@ use Twig\Token;
  *      {% endfor %}
  *    </ul>
  *   {% endif %}
+ *
+ * @internal
  */
 final class IfTokenParser extends AbstractTokenParser
 {

src/TokenParser/ImportTokenParser.php

@@ -20,6 +20,8 @@ use Twig\Token;
  * Imports macros.
  *
  *   {% import 'forms.html' as forms %}
+ *
+ * @internal
  */
 final class ImportTokenParser extends AbstractTokenParser
 {

src/TokenParser/IncludeTokenParser.php

@@ -22,6 +22,8 @@ use Twig\Token;
  *   {% include 'header.html' %}
  *     Body
  *   {% include 'footer.html' %}
+ *
+ * @internal
  */
 class IncludeTokenParser extends AbstractTokenParser
 {

src/TokenParser/MacroTokenParser.php

@@ -23,6 +23,8 @@ use Twig\Token;
  *   {% macro input(name, value, type, size) %}
  *      <input type="{{ type|default('text') }}" name="{{ name }}" value="{{ value|e }}" size="{{ size|default(20) }}" />
  *   {% endmacro %}
+ *
+ * @internal
  */
 final class MacroTokenParser extends AbstractTokenParser
 {

src/TokenParser/SandboxTokenParser.php

@@ -26,6 +26,8 @@ use Twig\Token;
  *    {% endsandbox %}
  *
  * @see https://twig.symfony.com/doc/api.html#sandbox-extension for details
+ *
+ * @internal
  */
 final class SandboxTokenParser extends AbstractTokenParser
 {

src/TokenParser/SetTokenParser.php

@@ -25,6 +25,8 @@ use Twig\Token;
  *  {% set foo = 'foo' ~ 'bar' %}
  *  {% set foo, bar = 'foo', 'bar' %}
  *  {% set foo %}Some content{% endset %}
+ *
+ * @internal
  */
 final class SetTokenParser extends AbstractTokenParser
 {

src/TokenParser/UseTokenParser.php

@@ -27,6 +27,8 @@ use Twig\Token;
  *    {% block content %}{% endblock %}
  *
  * @see https://twig.symfony.com/doc/templates.html#horizontal-reuse for details.
+ *
+ * @internal
  */
 final class UseTokenParser extends AbstractTokenParser
 {

src/TokenParser/WithTokenParser.php

@@ -19,6 +19,8 @@ use Twig\Token;
  * Creates a nested scope.
  *
  * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @internal
  */
 final class WithTokenParser extends AbstractTokenParser
 {