feat: Add comprehensive test suite and fix TypeScript type safety

[bmthd]

概要

Vitest Browser Reactを使用した包括的なテストスイートを追加し、TypeScriptの型安全性の問題を修正しました。

🎯 主な変更内容

1. テストスイート追加（13テストケース）

READMEに記載されている全てのユースケースをカバーするテストを実装：

• ✅ 基本的なHoist機能（2テスト）
• ✅ 優先度ベースのソート（3テスト）
• ✅ 複数の独立したHoistingシステム（1テスト）
• ✅ 条件付きHoisting（1テスト）
• ✅ エッジケース（4テスト）
• ✅ 動的更新（2テスト）

2. Vitest Browser Mode設定

• Firefoxを使用（ARM環境対応）
• Playwright providerの設定
• 実際のブラウザ環境でのE2Eスタイルテスト

3. TypeScript型安全性の修正

修正箇所: `lib/src/create-hoistable-component.tsx:149`

// 修正前
const keyRef = useRef<symbol>(null);
if (!keyRef.current) {
  keyRef.current = Symbol("hoist-entry");
}

// 修正後
const keyRef = useRef<symbol>(Symbol("hoist-entry"));

改善点:

• 型安全性の向上
• 不要なnullチェックの削除
• コードの簡潔化

🔍 バグ調査結果

良いニュース: READMEで説明されている全ての機能が正しく動作していることを確認しました！

• ✅ 優先度のソートロジックが正しく実装されている
• ✅ 同じ優先度での挿入順序が保持されている
• ✅ 複数のHoistingシステムが独立して動作
• ✅ 条件付きHoistingが正常に機能
• ✅ 動的更新が正しく反映される

発見されたのは、TypeScriptの型注釈の不整合のみで、機能的なバグはありませんでした。

📦 追加された依存関係

{
  "@vitest/browser": "^4.0.15",
  "@vitest/browser-playwright": "^4.0.15",
  "playwright": "^1.57.0",
  "react": "^19.2.1",
  "react-dom": "^19.2.1"
}

🧪 テスト結果

✓ firefox src/create-hoistable-component.test.tsx (13 tests) 152ms

Test Files  1 passed (1)
Tests       13 passed (13)
Duration    3.57s

📝 ドキュメント

• `BUG_REPORT.md`: 詳細な調査結果とテスト結果
• `PULL_REQUEST_SUMMARY.md`: 実装の詳細説明

🚀 実行方法

# テスト実行
cd lib
bunx vitest run

# ウォッチモード
bunx vitest

# 注意: 'bun test' ではなく 'bunx vitest' を使用してください

⚠️ Breaking Changes

なし。型の修正は内部実装の改善のみで、公開APIに変更はありません。

📊 テストカバレッジ

全てのREADME記載のユースケースをカバー:

• Quick Start example
• Priority ordering example
• Multiple hoisting systems example
• Conditional hoisting example
• Dynamic updates

🔗 関連情報

詳細な調査結果は `BUG_REPORT.md` をご確認ください。

---

🤖 Generated with Claude Code