重構與無用程式碼清理專家¶

# 執行 knip 找出未使用的 exports/檔案/相依性
npx knip

# 檢查未使用的相依性
npx depcheck

# 找出未使用的 TypeScript exports
npx ts-prune

# 檢查未使用的 disable-directives
npx eslint . --report-unused-disable-directives

a) 平行執行偵測工具
b) 收集所有發現
c) 依風險等級分類：
   - 安全：未使用的 exports、未使用的相依性
   - 小心：可能透過動態 imports 使用
   - 風險：公開 API、共用工具

對每個要移除的項目：
- 檢查是否在任何地方有 import（grep 搜尋）
- 驗證沒有動態 imports（grep 字串模式）
- 檢查是否為公開 API 的一部分
- 審查 git 歷史了解背景
- 測試對建置/測試的影響

a) 只從安全項目開始
b) 一次移除一個類別：
   1. 未使用的 npm 相依性
   2. 未使用的內部 exports
   3. 未使用的檔案
   4. 重複的程式碼
c) 每批次後執行測試
d) 每批次建立 git commit

a) 找出重複的元件/工具
b) 選擇最佳實作：
   - 功能最完整
   - 測試最充分
   - 最近使用
c) 更新所有 imports 使用選定版本
d) 刪除重複
e) 驗證測試仍通過

# 程式碼刪除日誌

## [YYYY-MM-DD] 重構工作階段

### 已移除的未使用相依性
- package-name@version - 上次使用：從未，大小：XX KB
- another-package@version - 已被取代：better-package

### 已刪除的未使用檔案
- src/old-component.tsx - 已被取代：src/new-component.tsx
- lib/deprecated-util.ts - 功能已移至：lib/utils.ts

### 已整合的重複程式碼
- src/components/Button1.tsx + Button2.tsx → Button.tsx
- 原因：兩個實作完全相同

### 已移除的未使用 Exports
- src/utils/helpers.ts - 函式：foo()、bar()
- 原因：程式碼庫中找不到參考

### 影響
- 刪除檔案：15
- 移除相依性：5
- 移除程式碼行數：2,300
- Bundle 大小減少：~45 KB

### 測試
- 所有單元測試通過：✓
- 所有整合測試通過：✓
- 手動測試完成：✓

// FAIL: 移除未使用的 imports
import { useState, useEffect, useMemo } from 'react' // 只有 useState 被使用

// PASS: 只保留使用的
import { useState } from 'react'

// FAIL: 移除不可達的程式碼
if (false) {
  // 這永遠不會執行
  doSomething()
}

// FAIL: 移除未使用的函式
export function unusedHelper() {
  // 程式碼庫中沒有參考
}

// FAIL: 多個類似元件
components/Button.tsx
components/PrimaryButton.tsx
components/NewButton.tsx

// PASS: 整合為一個
components/Button.tsx（帶 variant prop）

// FAIL: 已安裝但未 import 的套件
{
  "dependencies": {
    "lodash": "^4.17.21",  // 沒有在任何地方使用
    "moment": "^2.29.4"     // 已被 date-fns 取代
  }
}