FIX: Resolve Javadoc generation errors for Maven Central publishing

- Fixed critical heading structure issues by replacing <h3> tags with <strong> tags
- Added missing @param and @return tags to ArrayField, MetaField, MetaValidator, ArrayValidator
- Fixed HTML encoding issues by replacing <?> with &lt;?&gt; in comments
- Added table caption to MetaDataLoader documentation
- Removed invalid cross-module reference to FileMetaDataLoader
- Resolved all blocking Javadoc errors that prevented Maven publishing build

All 19 modules now build successfully with Javadoc generation working for release profile.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: dmealing

metadata/src/main/java/com/metaobjects/MetaData.java

@@ -38,7 +38,7 @@
  * are loaded once during application startup and optimized for heavy read access throughout 
  * the application lifetime.</p>
  * 
- * <h3>Architecture Pattern</h3>
+ * <strong>Architecture Pattern:</strong>
  * <ul>
  * <li><strong>Load Once</strong>: Like ClassLoader, expensive startup for permanent benefit</li>
  * <li><strong>Read Many</strong>: Optimized for thousands of concurrent read operations</li>
@@ -47,7 +47,7 @@
  * <li><strong>Memory Efficient</strong>: Smart caching balances performance with memory cleanup</li>
  * </ul>
  * 
- * <h3>Usage Examples</h3>
+ * <strong>Usage Examples:</strong>
  * <pre>{@code
  * // Loading Phase - Happens once at startup
  * MetaDataLoader loader = new SimpleLoader("myLoader");
@@ -59,7 +59,7 @@
  * MetaField field = userMeta.getMetaField("email");          // Cached access
  * }</pre>
  * 
- * <h3>Performance Characteristics</h3>
+ * <strong>Performance Characteristics:</strong>
  * <ul>
  * <li><strong>Loading Phase</strong>: 100ms-1s (acceptable one-time cost)</li>
  * <li><strong>Runtime Reads</strong>: 1-10μs (cached, immutable access)</li>

metadata/src/main/java/com/metaobjects/attr/AttributeTypesMetaDataProvider.java

@@ -11,7 +11,7 @@
  * <p>This provider registers all the concrete attribute types that extend attr.base.
  * It calls the registerTypes() methods on each concrete attribute class to ensure proper registration.</p>
  *
- * <h3>Attribute Types Registered:</h3>
+ * <strong>Attribute Types Registered:</strong>
  * <ul>
  * <li><strong>attr.string:</strong> String attributes</li>
  * <li><strong>attr.int:</strong> Integer attributes</li>
@@ -23,7 +23,7 @@
  * <li><strong>attr.properties:</strong> Properties attributes</li>
  * </ul>
  *
- * <h3>Priority:</h3>
+ * <strong>Priority:</strong>
  * <p>Priority 15 - Runs after field types (10) but before validators (20).
  * This ensures attr.base is available before concrete attribute types are registered.</p>
  *

metadata/src/main/java/com/metaobjects/core/CoreTypeMetaDataProvider.java

@@ -13,12 +13,12 @@
  * all other metadata types inherit from. It must be loaded before any other providers
  * that define types inheriting from metadata.base.</p>
  *
- * <h3>Base Types Registered:</h3>
+ * <strong>Base Types Registered:</strong>:
  * <ul>
  * <li><strong>metadata.base:</strong> Root metadata type that all others inherit from</li>
  * </ul>
  *
- * <h3>Dependencies:</h3>
+ * <strong>Dependencies:</strong>:
  * <p>No dependencies - This provider registers the foundational base type that
  * all other types depend on.</p>
  *

metadata/src/main/java/com/metaobjects/field/ArrayField.java

@@ -12,8 +12,16 @@
 @SuppressWarnings("serial")
 public abstract class ArrayField<A,T extends List> extends MetaField<T> {
 
+    /** Attribute name for array item name configuration */
     public final static String ATTR_ITEM_NAME   = "itemName";
 
+    /**
+     * Creates an ArrayField with the specified subtype, name and data type
+     * @param subType the field subtype
+     * @param name the field name
+     * @param dataType the data type, must be an array type
+     * @throws IllegalStateException if dataType is not an array type
+     */
     public ArrayField(String subType, String name, DataTypes dataType ) {
         super( subType, name, dataType );
         if ( !dataType.isArray() )
@@ -59,7 +67,10 @@ else if (getArrayItemClass().equals(String.class)) {
     }
 
 
-    /** Return the array item type */
+    /**
+     * Return the array item type
+     * @return the class type of array items
+     */
     @SuppressWarnings("unchecked")
     public Class<A> getArrayItemClass() {
         return (Class<A>) getDataType().getArrayItemClass();

metadata/src/main/java/com/metaobjects/field/FieldTypesMetaDataProvider.java

@@ -11,7 +11,7 @@
  * <p>This provider registers all the concrete field types that extend field.base.
  * It calls the registerTypes() methods on each concrete field class to ensure proper registration.</p>
  *
- * <h3>Field Types Registered:</h3>
+ * <strong>Field Types Registered:</strong>:
  * <ul>
  * <li><strong>field.string:</strong> String fields with pattern and length validation</li>
  * <li><strong>field.int:</strong> Integer fields with range validation</li>
@@ -29,7 +29,7 @@
  * <li><strong>field.class:</strong> Class fields for class type references</li>
  * </ul>
  *
- * <h3>Priority:</h3>
+ * <strong>Priority:</strong>:
  * <p>Priority 10 - Runs after core base types (0) but before extensions (50+).
  * This ensures field.base is available before concrete field types are registered.</p>
  *

metadata/src/main/java/com/metaobjects/field/MetaField.java

@@ -38,7 +38,7 @@
  * startup and then provide ultra-fast, thread-safe access to object properties throughout 
  * the application lifetime.</p>
  * 
- * <h3>Field as Metadata Pattern</h3>
+ * <strong>Field as Metadata Pattern</strong>:
  * <p>Similar to {@code java.lang.reflect.Field}, MetaField serves dual purposes:</p>
  * <ul>
  * <li><strong>Metadata Descriptor</strong>: Defines field name, type, validation rules, display preferences</li>
@@ -47,7 +47,7 @@
  * <li><strong>Serialization Guide</strong>: Controls JSON/XML serialization behavior</li>
  * </ul>
  * 
- * <h3>Usage Examples</h3>
+ * <strong>Usage Examples</strong>:
  * <pre>{@code
  * // Loading Phase - Field definition
  * MetaObject userMeta = loader.getMetaObjectByName("User");
@@ -59,11 +59,11 @@
  * boolean isValid = emailField.validate(userObject);        // Constraint validation
  * }</pre>
  * 
- * <h3>Type Safety</h3>
+ * <strong>Type Safety</strong>:
  * <p>MetaField is parameterized with the expected Java type {@code <T>} for compile-time 
  * type safety. This prevents ClassCastException and provides IDE support for auto-completion.</p>
  * 
- * <h3>Performance Characteristics</h3>
+ * <strong>Performance Characteristics</strong>:
  * <ul>
  * <li><strong>Field Lookup</strong>: O(1) cached access from parent MetaObject</li>
  * <li><strong>Value Access</strong>: Direct reflection or optimized accessors</li>
@@ -230,6 +230,11 @@ public T getDefaultValue() {
         return defaultValue;
     }
 
+    /**
+     * Converts the provided object to the field's value type
+     * @param o the object to convert
+     * @return the converted value of type T
+     */
     protected T convertDefaultValue(Object o) {
         if (!getValueClass().isInstance(o)) {
             // Convert as needed

metadata/src/main/java/com/metaobjects/key/KeyTypesMetaDataProvider.java

@@ -11,14 +11,14 @@
  * <p>This provider registers all the concrete key types that extend key.base.
  * It calls the registerTypes() methods on each concrete key class to ensure proper registration.</p>
  *
- * <h3>Key Types Registered:</h3>
+ * <strong>Key Types Registered:</strong>:
  * <ul>
  * <li><strong>key.primary:</strong> Primary key definitions</li>
  * <li><strong>key.foreign:</strong> Foreign key relationships</li>
  * <li><strong>key.secondary:</strong> Secondary keys and indexes</li>
  * </ul>
  *
- * <h3>Priority:</h3>
+ * <strong>Priority:</strong>:
  * <p>Priority 25 - Runs after validator types (20) but before object types (30).
  * This ensures key.base is available before concrete key types are registered.</p>
  *

metadata/src/main/java/com/metaobjects/loader/MetaDataLoader.java

@@ -36,8 +36,9 @@
  * <strong>NOT</strong> a typical data access pattern but rather a metadata definition system 
  * analogous to the Java reflection system.</p>
  * 
- * <h3>ClassLoader Pattern Analogy</h3>
+ * <strong>ClassLoader Pattern Analogy</strong>:
  * <table border="1">
+ * <caption>ClassLoader Pattern Comparison</caption>
  * <tr><th>Java Reflection</th><th>MetaObjects Framework</th><th>Purpose</th></tr>
  * <tr><td>Class.forName()</td><td>MetaDataLoader.load()</td><td>Load definitions</td></tr>
  * <tr><td>Class.getFields()</td><td>MetaObject.getMetaFields()</td><td>Access structure</td></tr>
@@ -46,7 +47,7 @@
  * <tr><td>Thread-safe reads</td><td>Thread-safe metadata access</td><td>Concurrent operations</td></tr>
  * </table>
  * 
- * <h3>Loading vs Runtime Phases</h3>
+ * <strong>Loading vs Runtime Phases</strong>:
  * <pre>{@code
  * // LOADING PHASE - Happens once at startup
  * MetaDataLoader loader = new SimpleLoader("myLoader");
@@ -59,7 +60,7 @@
  * Object value = field.getValue(userObject);                // Thread-safe read
  * }</pre>
  * 
- * <h3>Performance Characteristics</h3>
+ * <strong>Performance Characteristics</strong>:
  * <ul>
  * <li><strong>Startup Cost, Runtime Speed</strong>: Heavy initialization, ultra-fast runtime access</li>
  * <li><strong>Permanent References</strong>: Like Class objects, MetaData stays in memory until app shutdown</li>
@@ -71,7 +72,6 @@
  * @version 6.0.0
  * @since 1.0
  * @see com.metaobjects.loader.simple.SimpleLoader
- * @see com.metaobjects.loader.file.FileMetaDataLoader
  * @see MetaData
  */
 public class MetaDataLoader extends MetaData implements LoaderConfigurable {

metadata/src/main/java/com/metaobjects/registry/MetaDataRegistry.java

@@ -32,7 +32,7 @@
  *   <li><strong>Thread-Safe:</strong> Optimized for read-heavy workloads with concurrent access</li>
  * </ul>
  * 
- * <h3>Registration Examples:</h3>
+ * <strong>Registration Examples:</strong>:
  * 
  * <pre>{@code
  * // Register a field type with attributes

metadata/src/main/java/com/metaobjects/registry/MetaDataTypeProvider.java

@@ -7,12 +7,12 @@
  * from META-INF/services files. This enables dynamic type registration and extension
  * without configuration files or static dependencies.</p>
  *
- * <h3>Dependency-Based Loading:</h3>
+ * <strong>Dependency-Based Loading:</strong>:
  * <p>Providers specify explicit dependencies instead of fragile priority numbers.
  * The system automatically resolves the dependency graph using topological sorting
  * to ensure proper load order.</p>
  *
- * <h3>Example Implementation:</h3>
+ * <strong>Example Implementation:</strong>:
  * <pre>{@code
  * public class DatabaseMetaDataProvider implements MetaDataTypeProvider {
  *
@@ -35,7 +35,7 @@
  * }
  * }</pre>
  *
- * <h3>Dependency Benefits:</h3>
+ * <strong>Dependency Benefits:</strong>:
  * <ul>
  * <li><strong>Explicit Dependencies:</strong> Clear what each provider needs</li>
  * <li><strong>Automatic Resolution:</strong> System calculates correct load order</li>
@@ -44,7 +44,7 @@
  * <li><strong>Maintainable:</strong> Easy to add new providers without priority conflicts</li>
  * </ul>
  *
- * <h3>Common Provider IDs:</h3>
+ * <strong>Common Provider IDs:</strong>:
  * <ul>
  * <li><strong>core-types:</strong> Basic metadata.base type</li>
  * <li><strong>field-types:</strong> All concrete field types</li>