add comprehensive javadoc comments for all classes

- Add class-level documentation for all mapper and multilingual classes
- Add complete javadoc for all public methods with @param and @return tags
- Add field-level comments for better code readability
- Improve documentation for initialization blocks and constructors

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

src/main/java/com/imyeyu/lang/mapper/LanguageMap.java

@@ -10,13 +10,20 @@ import java.util.LinkedHashMap;
 import java.util.Map;
 
 /**
+ * 基于内存的语言映射实现
+ * <p>
+ * 使用 HashMap 存储语言映射关系，支持二次映射、模糊匹配等功能
+ * </p>
+ *
  * @author 夜雨
  * @version 2024-04-03 10:11
  */
 public class LanguageMap extends AbstractLanguageMapper {
 
+	/** 语言键值映射表 */
 	protected final Map<String, String> map;
 
+	// 初始化字符串插值器过滤器，支持 @key 格式的语言映射引用
 	{
 		INTERPOLATOR.putFilter("lang", value -> {
 			if (value.startsWith("@")) {
@@ -36,15 +43,35 @@ public class LanguageMap extends AbstractLanguageMapper {
 		this.map = new HashMap<>();
 	}
 
+	/**
+	 * 合并另一个语言映射表
+	 * <p>
+	 * 将另一个映射表的所有键值对合并到当前映射表中，如果存在相同键则覆盖
+	 * </p>
+	 *
+	 * @param map 要合并的语言映射表
+	 */
 	public void union(LanguageMap map) {
 		this.map.putAll(map.map);
 	}
 
+	/**
+	 * 添加语言映射
+	 *
+	 * @param key   键
+	 * @param value 值
+	 */
 	@Override
 	public void add(String key, String value) {
 		map.put(key, value);
 	}
 
+	/**
+	 * 检查是否存在指定键的映射
+	 *
+	 * @param key 键
+	 * @return true 为存在
+	 */
 	@Override
 	public boolean has(String key) {
 		return map.containsKey(key);