주석화 진행상황 정리하고 핵심 모듈에 한글 주석 추가

lib/widgets/components/form_field.dart

@@ -17,12 +17,19 @@ class SuperportFormField extends StatelessWidget {
     this.spacing = _kFieldSpacing,
   });
 
+  /// 폼 필드 라벨 텍스트.
   final String label;
+  /// 입력 영역으로 렌더링할 위젯.
   final Widget child;
+  /// 필수 여부. true면 라벨 옆에 `*` 표시를 추가한다.
   final bool required;
+  /// 보조 설명 문구. 에러가 없을 때만 출력된다.
   final String? caption;
+  /// 에러 메시지. 존재하면 캡션 대신 우선적으로 노출된다.
   final String? errorText;
+  /// 라벨 우측에 배치할 추가 위젯(예: 도움말 버튼).
   final Widget? trailing;
+  /// 라벨과 본문 사이 간격.
   final double spacing;
 
   @override
@@ -81,14 +88,23 @@ class SuperportTextInput extends StatelessWidget {
   });
 
   final TextEditingController? controller;
+  /// 입력 없을 때 보여줄 플레이스홀더 위젯.
   final Widget? placeholder;
+  /// 입력 변경 콜백.
   final ValueChanged<String>? onChanged;
+  /// 제출(Enter) 시 호출되는 콜백.
   final ValueChanged<String>? onSubmitted;
+  /// 키보드 타입. 숫자/이메일 등으로 지정 가능.
   final TextInputType? keyboardType;
+  /// 입력 활성 여부.
   final bool enabled;
+  /// 읽기 전용 여부. true면 수정 불가.
   final bool readOnly;
+  /// 최대 줄 수. 1보다 크면 멀티라인 입력을 지원한다.
   final int maxLines;
+  /// 앞에 붙일 위젯 (아이콘 등).
   final Widget? leading;
+  /// 뒤에 붙일 위젯 (버튼 등).
   final Widget? trailing;
 
   @override
@@ -118,9 +134,13 @@ class SuperportSwitchField extends StatelessWidget {
     this.caption,
   });
 
+  /// 스위치 현재 상태.
   final bool value;
+  /// 상태 변경 시 호출되는 콜백.
   final ValueChanged<bool> onChanged;
+  /// 스위치 상단에 표시할 제목.
   final String? label;
+  /// 보조 설명 문구.
   final String? caption;
 
   @override