Nuxt UI v4.13.0: файлы и очередь в AI-чате, toast.promise и ESLint для токенов TailwindЗаметка · дайджест за 19 ноября
Nuxt UI v4.13.0: файлы и очередь в AI-чате, toast.promise и ESLint для токенов Tailwind
Заметка3 раздела≈ 4 мин

Nuxt UI v4.13.0: файлы и очередь в AI-чате, toast.promise и ESLint для токенов Tailwind

18 ноября 2026 года вышел минорный релиз Nuxt UI v4.13.0 для Nuxt (>=4.1.0) и Vue 3 на Tailwind CSS v4 — без ломающих изменений. Внутри 13 новых фич и полсотни фиксов, но главное: обновление закрывает четыре частые боли, на которые в проектах вечно уходят вечера с самописными костылями.

AI-чат с файлами и очередью, плюс тумблеры

Если ты собирал AI-чат, то знаешь сценарий: поле ввода готово, а потом просят вставку картинок, перетаскивание файлов и отправку нового вопроса, пока модель ещё допечатывает ответ. В v4.13.0 <UChatPrompt> получил v-model:files (работают paste и drag-and-drop), а список вложений рисует новый <ChatAttachment>.

<template>
  <!-- Файлы можно вставить из буфера или бросить мышью -->
  <UChatPrompt
    v-model="input"
    v-model:files="files"
    v-model:queue="queue"
    @submit="onSubmit"
  >
    <UChatPromptSubmit :status="status" />
  </UChatPrompt>
</template>

Под Vercel AI SDK (ai ^6 || ^7) добавили утилиту toFileUIParts из @nuxt/ui/utils/ai — она переводит браузерные File в формат частей сообщения для модели. Директива v-model:queue выручает при стриминге, когда ответ приходит по частям: новая реплика встаёт в очередь и уходит после завершения потока. Заодно UChatPrompt перестал дублировать отправку во время стриминга, а ChatMessages держит скролл и получил ARIA live region.

Для тулбаров и фильтров появились переключатели <UToggle> и <UToggleGroup> — больше не нужно притворяться тумблерами через <UButton>.

<script setup lang="ts">
const bold = ref(false)
const align = ref('left')

// Пункты группы переключателей
const items = [
  { value: 'left', icon: 'i-lucide-align-left', 'aria-label': 'Left' },
  { value: 'center', icon: 'i-lucide-align-center', 'aria-label': 'Center' },
  { value: 'right', icon: 'i-lucide-align-right', 'aria-label': 'Right' }
]
</script>

<template>
  <!-- Одиночный переключатель -->
  <UToggle v-model="bold" icon="i-lucide-bold" aria-label="Bold" />
  <!-- Для мультивыбора добавь type="multiple" -->
  <UToggleGroup v-model="align" :items="items" />
</template>

Оба компонента принимают пропсы Button, плюс active-color и active-variant для нажатого состояния. Меньше условных классов в шаблоне — чище код.

Тосты одной строкой и ускорение рендера

Раньше для асинхронного уведомления приходилось показывать «Сохраняем...», хранить id тоста и обновлять его вручную в try / catch. Теперь у useToast() есть promise().

const toast = useToast()

// Один вызов вместо ручного try/catch и обновления по id
await toast.promise($fetch('/api/save', { method: 'POST' }), {
  loading: 'Сохраняем...',
  success: { title: 'Готово', color: 'success' },
  error: (error: any) => ({ title: error.message, color: 'error' })
})

Если запрос прошёл — тост сам становится зелёным; если упал — берёт текст из колбэка. Плюс в релизе ускорили рендер: мемоизировали tv по теме и одинаковым пропсам, перевели tailwindcss/colors на ленивую загрузку при гидратации, убрали лишние reactiveOmit/reactivePick, а Table перестал перерисовывать виртуализированные строки на каждый скролл. На больших админках прокрутка заметно плавнее.

Линтер против хардкода text-gray-500

Встроенный конфиг @nuxt/ui/eslint из PR #7329 поверх eslint-plugin-better-tailwindcss (^4.10) ловит частую привычку разработчиков и ИИ-агентов писать сырые цвета вроде text-gray-500 вместо семантических дизайн-токенов Tailwind (text-muted, bg-error-500), которые сами подстраиваются под светлую и тёмную темы. Доставляешь плагин в devDependencies и включаешь опцию в конфиге (для чистого Vue без Nuxt есть фабрика в документации по интеграции с ESLint):

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxt/eslint', '@nuxt/ui'],
  css: ['~/assets/css/main.css'],
  ui: {
    // Проверка классов Tailwind через @nuxt/ui/eslint
    eslint: true
  }
})

Конфиг читает твой CSS и app.config.ts, проверяя class, пропсы :ui и <UTheme>. По умолчанию с уровнем warn работают no-palette-colors (подсказывает токен вместо цвета палитры) и no-conflicting-classes (ловит конфликты вроде p-2 p-4) — без автофикса, чтобы не угадывать замысел. Через ui.eslint.rules можно добрать no-unknown-classes и enforce-logical-properties для RTL (у него автофикс есть).

Почему опция выключена по умолчанию

Если eslint-plugin-better-tailwindcss уже подключён неявно через чужой shared-конфиг, автодетект Nuxt UI его не увидит, и ESLint упадёт с ошибкой "Different instances of plugin". Поэтому в v4 проверку оставили opt-in.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 4