⚡ Esora Документация

Vite-интеграция

Назначение и когда использовать

Vite нужен для TypeScript, CSS-препроцессоров, npm-пакетов и HMR. Для одиночного HTML-фрагмента оставьте esrc.js.

Установка и настройка

npm install -D vite @esora/vite-plugin
import { defineConfig } from 'vite';
import { esora } from '@esora/vite-plugin';
export default defineConfig({ plugins: [esora()] });

Разместите entry в app/Features/Blog/assets/index.js (или index.ts, index.css, app.*, main.*), затем:

npm run build

В PHP-шаблоне вызовите helper vite(string|array $entries):

<?= vite(['app/Features/Blog/assets/index.js']) ?>

Esora\Support\Vite::tags() читает public/hot в dev и public/build/manifest.json в production; возвращает module script/link tags.

Lifecycle и troubleshooting

Dev server + public/hot → HMR; build → manifest/chunks → helper tags. Пустой вывод helper означает отсутствие hot file, manifest или несовпадающий ключ entry. Проверяйте путь относительно корня проекта и не коммитьте секреты в env.