# Major Dependency Upgrade Hold-Off

**Last Updated:** 2026-02-16  
**Status:** Intentional — upgrades require testing before applying

---

## Overview

The following major upgrades were identified as outdated but are **intentionally held** until tested. Do not upgrade without running the full test suite and manual verification.

## Packages on Hold

| Package | Current | Target | Dependents | Risk |
|---------|---------|--------|------------|------|
| ESLint | 8.x / 9.x | 10.x | alltra-lifi-settlement, bridge-dapp, proxmox-helper-scripts-website | High — config/flat config migration |
| Jest | 29.x | 30.x | alltra-lifi-settlement | Medium — API changes |
| @types/react | 18.x | 19.x | bridge-dapp | Medium — React 19 types |
| @types/react-dom | 18.x | 19.x | bridge-dapp | Medium |
| @typescript-eslint/* | 6.x / 8.x | 8.55 | multiple | Medium — rule changes |
| @vitejs/plugin-react | 4.x | 5.x | bridge-dapp | Medium |
| @vitest/ui | 1.x | 4.x | bridge-dapp | High — major version jump |
| @types/express | 4.x | 5.x | multi-chain-execution, rpc-translator-138 | Medium |
| commander | 11.x | 14.x | site-manager-api, unifi-api | Medium |

## Upgrade Procedure (when ready)

1. **Create a branch** for the upgrade.
2. **Upgrade one package** (or related group) at a time.
3. **Run tests:** `pnpm run test` in affected packages.
4. **Run builds:** `pnpm run build` (or package-specific build).
5. **Manual QA** of affected UIs (bridge-dapp, frontend, etc.).
6. **Document** any config or code changes required.
7. **Merge** only after all checks pass.

## Related

- [REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS](REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md)
- [PNPM_OUTDATED_SUMMARY](../../reports/PNPM_OUTDATED_SUMMARY.md) — if present