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.