Lỗi Starlight Plugins Config - Expected type "object", received "array"

Lỗi Starlight Plugins Config

Thông báo lỗi

[AstroUserError] Invalid plugins config passed to starlight integration
  Hint:
    0: Expected type "object", received "array"

Nguyên nhân

Lỗi này xảy ra khi bạn cấu hình plugins trong Starlight dưới dạng array ([]) thay vì object ({}).

Code gây lỗi

// ❌ Sai - dạng array
plugins: [
  starlightPluginIcons(),
  starlightMarkdownBlocks({ ... }),
],

Code đúng

// ✅ Đúng - dạng object
plugins: {
  starlightPluginIcons: starlightPluginIcons(),
  starlightMarkdownBlocks: starlightMarkdownBlocks({ ... }),
},

Tuy nhiên: Phiên bản mới của @astrojs/starlight có thể không hỗ trợ plugins theo cách này. Tham khảo Starlight Plugins Documentation để biết cách cấu hình đúng.

Cách khắc phục

Cách 1: Xóa plugins (khuyến nghị)

Nếu không cần thiết, xóa plugins khỏi cấu hình:

export default defineConfig({
  integrations: [
    starlight({
      title: 'My Docs',
      customCss: ['./src/styles/custom.css'],
      // Không có plugins
    }),
  ],
});

Cách 2: Kiểm tra phiên bản

Kiểm tra phiên bản đang sử dụng:

npm list @astrojs/starlight

Đảm bảo sử dụng phiên bản mới nhất:

npm update @astrojs/starlight

Cách 3: Tham khảo docs chính thức

Xem Starlight Plugins để biết cách cấu hình đúng cho phiên bản bạn đang dùng.