Migration Guide

Mỗi major của @tasco/* có một mục migration. Các package @tasco/* đi lockstep (cùng version), nên nâng cấp đồng loạt.

Nguyên tắc nâng cấp

1. Đọc mục migration của major đích (bên dưới).
2. Bump @tasco/nuxt-layer-base (kéo theo ui/theme/composables cùng version).
3. Chạy pnpm install, rồi pnpm typecheck để bắt breaking ở mức type trước.
4. Test trên channel next/beta trước khi lên latest (xem Release).

# thử bản beta
pnpm add @tasco/nuxt-layer-base@beta

Mẫu mục migration (cho core team)

Khi phát hành major Y, thêm một mục theo mẫu này.

vX → vY

Breaking changes

• Mô tả thay đổi phá vỡ, lý do.

Hành động cần làm

• Bước cụ thể team sản phẩm phải làm (đổi API, đổi config...).

Codemod / tự động hoá (nếu có)

• Lệnh/script hỗ trợ.

---

v0 → v1 (ví dụ)

Breaking changes

• useApi trả về instance gọi trực tiếp thay vì object { get, post } (ví dụ minh hoạ).

Hành động cần làm

- const { get } = useApi()
- const data = await get('/orders')
+ const api = useApi()
+ const data = await api('/orders')