89 lines
3.7 KiB
TypeScript
89 lines
3.7 KiB
TypeScript
import ReactRefreshWebpackPlugin from '@pmmmwh/react-refresh-webpack-plugin'
|
||
import CompressionPlugin from 'compression-webpack-plugin'
|
||
import HtmlWebpackPlugin from 'html-webpack-plugin'
|
||
import MiniCssExtractPlugin from 'mini-css-extract-plugin'
|
||
import webpack from 'webpack'
|
||
import { BundleAnalyzerPlugin } from 'webpack-bundle-analyzer'
|
||
|
||
import { BuildOptions } from './types/config'
|
||
|
||
/**
|
||
* Конфигурация webpack плагинов
|
||
*
|
||
* Собирает все необходимые плагины для сборки приложения.
|
||
*
|
||
* Плагины для всех режимов:
|
||
* - HtmlWebpackPlugin: генерирует HTML файл и автоматически подключает скрипты
|
||
* - MiniCssExtractPlugin: извлекает CSS в отдельные файлы с хешами для кеширования
|
||
* - ProgressPlugin: показывает прогресс сборки в консоли
|
||
* - DefinePlugin: определяет глобальные константы для использования в коде
|
||
*
|
||
* Плагины только для разработки:
|
||
* - BundleAnalyzerPlugin: анализирует размер бандла (не открывается автоматически)
|
||
* - ReactRefreshWebpackPlugin: обеспечивает быструю перезагрузку React компонентов
|
||
* - HotModuleReplacementPlugin: включает горячую замену модулей (HMR)
|
||
*
|
||
* Плагины только для production:
|
||
* - CompressionPlugin: создает gzip-сжатые версии файлов для уменьшения размера передачи
|
||
*
|
||
* @param {BuildOptions} options - Опции сборки
|
||
* @param {BuildPaths} options.paths - Пути проекта
|
||
* @param {boolean} options.isDev - Флаг режима разработки
|
||
* @param {string} options.apiUrl - URL API для глобальной переменной __API__
|
||
* @param {string} options.project - Тип проекта для глобальной переменной __PROJECT__
|
||
* @returns {webpack.WebpackPluginInstance[]} Массив плагинов webpack
|
||
*
|
||
* @example
|
||
* // Глобальные константы доступны в коде:
|
||
* if (__IS_DEV__) {
|
||
* console.log('Development mode')
|
||
* }
|
||
*
|
||
* fetch(__API__ + '/users')
|
||
*/
|
||
export function buildPlugins({
|
||
paths,
|
||
isDev,
|
||
apiUrl,
|
||
project,
|
||
}: BuildOptions): webpack.WebpackPluginInstance[] {
|
||
const plugins = [
|
||
new HtmlWebpackPlugin({
|
||
template: paths.html,
|
||
}),
|
||
new MiniCssExtractPlugin({
|
||
filename: 'css/[name].[contenthash:8].css',
|
||
chunkFilename: 'css/[name].[contenthash:8].css',
|
||
}),
|
||
new webpack.ProgressPlugin(),
|
||
new webpack.DefinePlugin({
|
||
__IS_DEV__: JSON.stringify(isDev),
|
||
__API__: JSON.stringify(apiUrl),
|
||
__PROJECT__: JSON.stringify(project),
|
||
}),
|
||
]
|
||
|
||
if (isDev) {
|
||
plugins.push(
|
||
new BundleAnalyzerPlugin({
|
||
openAnalyzer: false,
|
||
analyzerMode: 'static',
|
||
})
|
||
)
|
||
plugins.push(new ReactRefreshWebpackPlugin({ overlay: false }))
|
||
plugins.push(new webpack.HotModuleReplacementPlugin())
|
||
} else {
|
||
// Сжатие файлов для production сборки
|
||
// Создает .gz файлы для всех JS и CSS файлов больше 10KB
|
||
plugins.push(
|
||
new CompressionPlugin({
|
||
algorithm: 'gzip',
|
||
test: /\.(js|css|html|svg)$/,
|
||
threshold: 10240, // Сжимаем только файлы больше 10KB
|
||
minRatio: 0.8, // Сжимаем только если размер уменьшается минимум на 20%
|
||
})
|
||
)
|
||
}
|
||
return plugins
|
||
}
|