docs: Fix docstring accuracy and improve code documentation

Self-review findings and fixes:

1. Fix validate_frozen_rows docstring accuracy
   - Corrected is_valid description: only False when exceeds limit
   - Clarified validated_frozen_rows behavior for negative values
   - Implementation and documentation now match

2. Improve expand_axis_range documentation
   - Add concrete examples first for better understanding
   - Add Args and Returns sections
   - Replace abstract description with clear examples

Quality metrics maintained:
- All 220 tests pass
- Coverage: 81-100% (helper classes)
- Type check, lint, format: all pass

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

Author: k-ibaraki

src/excel/pane_manager.py

@@ -67,8 +67,8 @@ def validate_frozen_rows(frozen_rows: int, max_limit: int) -> tuple[bool, int]:
 
         Returns:
             (is_valid, validated_frozen_rows)のタプル
-            - is_valid: 上限以内ならTrue、超過または負の場合はFalse
-            - validated_frozen_rows: 無効時は0、それ以外は元の値
+            - is_valid: 上限超過の場合のみFalse、それ以外はTrue
+            - validated_frozen_rows: 負の値は0に丸める、上限超過は0、それ以外は元の値
         """
         # 負の値は無効として0に丸める
         if frozen_rows < 0:

src/excel/range_calculator.py

@@ -117,11 +117,19 @@ def merge_ranges(range1: str, range2: str) -> str:
     @staticmethod
     def expand_axis_range(range_str: str) -> str:
         """
-        指定されたセル範囲を「枠分離」ではなく「方向に拡張」する。
-        - 単一セル (例: C5) -> C1:C5
-        - 単一列 (例: Z100:Z200) -> Z1:Z200
-        - 単一行 (例: D200:Z200) -> A200:Z200
-        - それ以外（矩形など）はそのまま
+        単一セル・列・行を1行目/A列まで拡張する
+
+        Examples:
+            - 単一セル: "C5" -> "C1:C5"（列方向に拡張）
+            - 単一列: "Z100:Z200" -> "Z1:Z200"（上端まで拡張）
+            - 単一行: "D200:Z200" -> "A200:Z200"（左端まで拡張）
+            - 矩形範囲: そのまま（変更なし）
+
+        Args:
+            range_str: セル範囲文字列
+
+        Returns:
+            拡張されたセル範囲（または元の範囲）
         """
         if not range_str:
             return range_str