مولّد إعدادات Webpack

الإخراج الافتراضي

بالقيم الافتراضية (وضع production، وTypeScript، وBabel، ومحمّل CSS، وHtmlWebpackPlugin) يُنتج المولّد:

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  mode: 'production',
  entry: './src/index.js',
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: 'bundle.[contenthash].js',
    clean: true,
  },
  resolve: { extensions: ['.ts','.tsx','.js'] },
  module: {
    rules: [
      { test: /\.tsx?$/, use: 'ts-loader', exclude: /node_modules/ },
      { test: /\.jsx?$/, exclude: /node_modules/, use: 'babel-loader' },
      { test: /\.css$/, use: ['style-loader', 'css-loader'] },
    ],
  },
  plugins: [
    new HtmlWebpackPlugin({ template: './src/index.html' }),
  ],
};

ما الذي يكتبه كل خيار

خيارات ثابتة في الإخراج

لإبقاء الإعدادات الأولية بسيطة، تُضبط بعض القيم نيابةً عنك بدلًا من عرضها كحقول:

• أسماء ملفات مع تجزئة (hash). output.filename هو دائمًا bundle.[contenthash].js، ما يُبطل ذاكرة المتصفح المؤقتة في كل مرة تتغير فيها الحزمة.
• إخراج نظيف. output.clean: true يفرّغ مجلد الإخراج في كل عملية بناء، وهو بديل clean-webpack-plugin في webpack 5.
• يُدمَج CSS في الحزمة ولا يُستخرَج. يحقن style-loader الأنماط عبر JavaScript. لإخراج ملف .css منفصل في الإنتاج، أضف MiniCssExtractPlugin بنفسك.
• أساسيات خادم التطوير. عند تفعيله يضبط devServer القيم static وport: 3000 وhot: true. أضف خيارات مثل historyApiFallback أو proxy يدويًا إذا احتاجها تطبيقك.

كيف توسّعه أكثر

الملف المُنتَج هو نقطة بداية، وليس إعدادًا إنتاجيًا كاملًا. الخطوات التالية الشائعة التي تضيفها بنفسك: MiniCssExtractPlugin لاستخراج CSS، وsass-loader للملفات .scss، ووحدات asset في webpack 5 للصور والخطوط، وقيمة devtool لخرائط المصدر (source maps)، وكتلة splitChunks لتقسيم الكود.