Road grading. Makes annotations mutable on purpose. (#35)

Signed-off-by: Laird Nelson <ljnelson@gmail.com>

Author: ljnelson

README.md

@@ -36,7 +36,7 @@ dependency:
     Always check https://search.maven.org/artifact/org.microbean/microbean-construct
     for up-to-date available versions.
   -->
-  <version>0.0.19</version>
+  <version>0.0.20</version>
 </dependency>
 ```
 

pom.xml

@@ -271,7 +271,7 @@
         <plugin>
           <groupId>org.sonatype.central</groupId>
           <artifactId>central-publishing-maven-plugin</artifactId>
-          <version>0.9.0</version>
+          <version>0.10.0</version>
           <extensions>true</extensions>
           <configuration>
             <publishingServerId>central.sonatype.com</publishingServerId>

src/main/java/org/microbean/construct/Domain.java

@@ -1511,10 +1511,10 @@ public default TypeVariable typeVariable(Parameterizable p, final CharSequence n
   }
 
   /**
-   * A convenience method that returns the first {@link VariableElement} with a {@linkplain ElementKind#isVariable()
-   * variable <code>ElementKind</code>} and {@linkplain Element#getSimpleName() bearing} the supplied {@code simpleName}
-   * that the supplied {@code enclosingElement} {@linkplain Element#getEnclosedElements() encloses}, <strong>or {@code
-   * null} if there is no such {@link VariableElement}</strong>.
+   * A convenience method that returns the first {@link VariableElement} {@linkplain Element#getSimpleName() bearing}
+   * the supplied {@code simpleName} that the supplied {@code enclosingElement} {@linkplain
+   * Element#getEnclosedElements() encloses}, <strong>or {@code null} if there is no such {@link
+   * VariableElement}</strong>.
    *
    * @param enclosingElement an {@link Element}; must not be {@code null}
    *
@@ -1526,8 +1526,6 @@ public default TypeVariable typeVariable(Parameterizable p, final CharSequence n
    *
    * @see Element#getEnclosedElements()
    *
-   * @see ElementKind#isVariable()
-   *
    * @see Element#getSimpleName()
    *
    * @see VariableElement
@@ -1539,7 +1537,7 @@ public default VariableElement variableElement(final Element enclosingElement, f
     case null -> throw new NullPointerException("enclosingElement");
     case UniversalElement ue -> {
       for (final UniversalElement ee : ue.getEnclosedElements()) {
-        if (ee.getKind().isVariable() && ee.getSimpleName().contentEquals(simpleName)) {
+        if (ee.getSimpleName().contentEquals(simpleName)) {
           yield ee;
         }
       }
@@ -1548,7 +1546,7 @@ public default VariableElement variableElement(final Element enclosingElement, f
     default -> {
       try (var lock = lock()) {
         for (final Element ee : enclosingElement.getEnclosedElements()) {
-          if (ee.getKind().isVariable() && ee.getSimpleName().contentEquals(simpleName)) {
+          if (ee.getSimpleName().contentEquals(simpleName)) {
             yield (VariableElement)ee;
           }
         }

src/main/java/org/microbean/construct/UniversalConstruct.java

@@ -753,6 +753,23 @@ yield describe(t.getExtendsBound(), d)
     };
   }
 
+  /**
+   * Returns a nominal descriptor for the supplied {@link List}, or an {@linkplain Optional#empty() empty} {@link
+   * Optional} if the supplied {@link List} cannot be described.
+   *
+   * @param <E> the supplied {@code list}'s element type
+   *
+   * @param list a {@link List} to be described; may be {@code null}; if non-{@code null} <strong>must be immutable and
+   * must not contain {@code null} elements</strong> or undefined behavior will result
+   *
+   * @return a non-{@code null} {@link Optional}
+   *
+   * @see #describe(List, Function)
+   */
+  public static final <E> Optional<? extends ConstantDesc> describe(final List<? extends E> list) {
+    return describe(list, e -> e instanceof Constable c ? c.describeConstable() : Optional.empty());
+  }
+  
   /**
    * Returns a nominal descriptor for the supplied {@link List}, or an {@linkplain Optional#empty() empty} {@link
    * Optional} if the supplied {@link List} cannot be described.