Merge branch 'extend-phpdoc-coverage' into rector-phpdoc-html

Author: adriendupuis

tools/php_api_ref/.phpdoc/template/base.html.twig

@@ -1,6 +1,6 @@
 {% extends 'layout.html.twig' %}
 
-{% set symfony_version = '5.4' %}
+{% set symfony_version = 'SF_VERSION' %}
 
 {% block javascripts %}
     {{ parent() }}

tools/php_api_ref/.phpdoc/template/components/constant.html.twig

@@ -9,3 +9,4 @@
 {% include 'components/description.html.twig' with { node: constant } %}
 {% include 'components/description.html.twig' with { node: constant.var[0] } %}
 {% include 'components/tags.html.twig' with {node: constant } %}
+{% include 'components/attributes.html.twig' with { node: constant } %}

tools/php_api_ref/.phpdoc/template/components/enum-case.html.twig

@@ -0,0 +1,10 @@
+<article class="phpdocumentor-element-enum-case">
+    {% embed 'components/content-header.html.twig' with { node: case, anchor: 'enumcase_' ~ case.name, anchor_link: link(case), header_tag: 'h3' } %}
+    {% endembed %}
+    {% include 'components/summary.html.twig' with { node: case } %}
+    {% include 'components/deprecation.html.twig' with { node: case } %}
+    {% include 'components/description.html.twig' with { node: case } %}
+    {% include 'components/description.html.twig' with { node: case.var[0] } %}
+    {% include 'components/tags.html.twig' with { node: case } %}
+    {% include 'components/attributes.html.twig' with { node: case } %}
+</article>

tools/php_api_ref/.phpdoc/template/components/enum-title.html.twig

@@ -0,0 +1,21 @@
+{% set breadcrumbs = usesNamespaces ? breadcrumbs(node) : packages(node) %}
+{% set fqcn = breadcrumbs|map(breadcrumb => breadcrumb.name)|join('\\') ~ '\\' ~ node.name %}
+
+{% embed 'components/content-header.html.twig' with {
+    anchor: node.name,
+    anchor_link: '#' ~ node.name,
+    fqcn,
+    add_edition: true,
+} %}
+    {% block name %}
+        {{ node.name }}
+    {% endblock %}
+    {% block subheader %}
+        <div class="content-header__subheader">
+            Enum
+            {%- if node.backedType -%}
+                : {{ node.backedType }}
+            {% endif %}
+        </div>
+    {% endblock %}
+{% endembed %}

tools/php_api_ref/.phpdoc/template/components/menu-entry.html.twig

@@ -1,4 +1,4 @@
-{% set is_nested = entry.children.count or entry.interfaces[0] is defined or entry.classes[0] is defined or entry.traits[0] is defined %}
+{% set is_nested = entry.children.count or entry.interfaces[0] is defined or entry.classes[0] is defined or entry.traits[0] is defined or entry.enums[0] is defined %}
 {% set url = entry|route("url")|raw %}
 {% set type = type|default('') %}
 

tools/php_api_ref/.phpdoc/template/components/menu.html.twig

@@ -35,10 +35,10 @@
         </ul>
     {% endif %}
 
-    {% if entry.interfaces[0] is defined or entry.classes[0] is defined or entry.traits[0] is defined %}
+    {% if entry.interfaces[0] is defined or entry.classes[0] is defined or entry.traits[0] is defined or entry.enums[0] is defined %}
         {% if depth > 1 %}
             <label class="md-nav__list-title">
-                Interfaces, classes, and traits
+                Interfaces, classes, traits, and enums
             </label>
         {% endif %}
         <ul class="md-nav__list">
@@ -78,6 +78,19 @@
                         icon: 'file.svg',
                     } %}
 
+                    {% set index = index + 1 %}
+                {% endfor %}
+            {% endif %}
+            {% if entry.enums[0] is defined %}
+                {% for element in entry.enums|sort_asc %}
+                    {% include 'components/menu-entry.html.twig' with {
+                        title: element.name|shortFQSEN,
+                        nav_id: nav_id ~ '-' ~ index,
+                        entry: element,
+                        expanded: false,
+                        icon: 'file.svg',
+                    } %}
+
                     {% set index = index + 1 %}
                 {% endfor %}
             {% endif %}

tools/php_api_ref/.phpdoc/template/components/method.html.twig

@@ -15,3 +15,4 @@
 {% include 'components/method-arguments.html.twig' with { node: method } %}
 {% include 'components/method-response.html.twig' with { node: method } %}
 {% include 'components/tags.html.twig' with { node: method } %}
+{% include 'components/attributes.html.twig' with { node: method } %}

tools/php_api_ref/.phpdoc/template/components/property.html.twig

@@ -13,3 +13,4 @@
 {% include 'components/description.html.twig' with { node: property } %}
 {% include 'components/description.html.twig' with { node: property.var[0] } %}
 {% include 'components/tags.html.twig' with {node: property } %}
+{% include 'components/attributes.html.twig' with { node: property } %}

tools/php_api_ref/.phpdoc/template/components/table-of-contents.html.twig

@@ -52,14 +52,17 @@
 {% if node.traits[0] is defined %}
     {% set joined_data = joined_data|merge(node.traits) %}
 {% endif %}
+{% if node.enums[0] is defined %}
+    {% set joined_data = joined_data|merge(node.enums) %}
+{% endif %}
 
 {% if joined_data is not empty %}
     <h2 id="interfaces">
-        Interfaces, classes, and traits
+        Interfaces, classes, traits, and enums
         {%- include 'components/anchor.html.twig' with { anchor_link: link(node) ~ '#interfaces' } -%}
     </h2>
     <ul class="namespace-list">
-        {% for entry in joined_data %}
+        {% for entry in joined_data|sort((entry1, entry2) => entry1.name <=> entry2.name) %}
             <li>
                 <span>
                     <img src="./images/arrow-right.svg" class="arrow" />

tools/php_api_ref/.phpdoc/template/css/base.css.twig

@@ -585,6 +585,6 @@ ul.breadcrumbs li.breadcrumb-item-current span {
 
 }
 
-.phpdocumentor-admonition article {
+.phpdocumentor-admonition article, .phpdocumentor-cases article {
     padding-bottom: 0;
 }