fix: Address additional AI review feedback

Code improvements:
- Add type annotation to _normalize_range_data method
- Add empty data handling to prevent IndexError

Documentation improvements:
- Clarify metadata_only purpose: reduce response size (not processing load)
- Update parameter table descriptions for clarity
- Emphasize response size reduction in use cases

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

Author: k-ibaraki

docs/usage.md

@@ -188,7 +188,7 @@ The `sharepoint_excel` tool allows you to read and search Excel files in SharePo
 | `cell_range` | str \| None | None | Cell range (e.g., "A1:D10") |
 | `include_formatting` | bool | False | Include formatting information |
 | `include_header` | bool | True | Auto-detect and separate header rows using `freeze_panes` |
-| `metadata_only` | bool | False | Return only file and worksheet metadata without cell contents |
+| `metadata_only` | bool | False | Exclude data rows to return only metadata (reduce response size) |
 
 ### Basic Workflow
 
@@ -346,7 +346,7 @@ result = sharepoint_excel(
 - Inspect large file structure before fetching data
 - Understand what headers exist in each sheet
 - Determine the necessary `cell_range` before retrieving full data
-- Reduce token usage
+- Significantly reduce response size (save tokens)
 
 **Recommended Workflow:**
 1. Use `metadata_only=True` to inspect file structure

docs/usage_ja.md

@@ -188,7 +188,7 @@ SHAREPOINT_SITE_NAME=@onedrive,sales-team,customer-portal
 | `cell_range` | str \| None | None | セル範囲（例: "A1:D10"） |
 | `include_formatting` | bool | False | 書式情報を含めるか |
 | `include_header` | bool | True | ヘッダー行を自動検出して分離するか（`freeze_panes`を使用） |
-| `metadata_only` | bool | False | メタデータ（シート名やセル範囲など）のみを返し、セル内容は取得しないかどうか |
+| `metadata_only` | bool | False | データ行を除外してメタデータのみ返す（応答サイズを削減） |
 
 ### 基本的なワークフロー
 
@@ -346,7 +346,7 @@ result = sharepoint_excel(
 - 大きなファイルの構造を事前に確認
 - どのシートにどんなヘッダーがあるかを把握
 - 必要な`cell_range`を決定してから本データを取得
-- トークン使用量の削減
+- 応答サイズを大幅に削減（トークン使用量の節約）
 
 **推奨ワークフロー:**
 1. `metadata_only=True`でファイル構造を確認

src/sharepoint_excel.py

@@ -478,7 +478,7 @@ def _split_rows_by_header(
 
         return (header_rows, data_rows)
 
-    def _normalize_range_data(self, range_data):
+    def _normalize_range_data(self, range_data: Any) -> tuple[tuple[Cell, ...], ...]:
         """
         openpyxlの範囲データを統一的なタプルのタプル形式に変換
 
@@ -491,7 +491,10 @@ def _normalize_range_data(self, range_data):
         if isinstance(range_data, Cell):
             # 単一セルの場合
             return ((range_data,),)
-        elif range_data and not isinstance(range_data[0], tuple):
+        elif not range_data:
+            # 空の場合
+            return ()
+        elif not isinstance(range_data[0], tuple):
             # 単一列/行の場合
             return (range_data,)
         else: