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

lib/widgets/components/superport_table.dart

@@ -11,7 +11,10 @@ class SuperportTableSortState {
     required this.ascending,
   });
 
+  /// 정렬 대상이 되는 컬럼 인덱스.
   final int columnIndex;
+
+  /// 오름차순 여부. `false`면 내림차순이다.
   final bool ascending;
 }
 
@@ -25,10 +28,19 @@ class SuperportTablePagination {
     this.pageSizeOptions = const <int>[10, 20, 50],
   });
 
+  /// 현재 페이지 번호(1-base).
   final int currentPage;
+
+  /// 전체 페이지 수.
   final int totalPages;
+
+  /// 전체 데이터 건수.
   final int totalItems;
+
+  /// 현재 페이지네이션에서 선택된 페이지 크기.
   final int pageSize;
+
+  /// 사용자에게 노출할 페이지 크기 옵션 목록.
   final List<int> pageSizeOptions;
 }
 
@@ -55,6 +67,7 @@ class SuperportTable extends StatelessWidget {
        _headerCells = null,
        _rowCells = null;
 
+  /// 헤더와 행을 [ShadTableCell] 단위로 직접 전달할 때 사용하는 생성자.
   const SuperportTable.fromCells({
     super.key,
     required List<ShadTableCell> header,