minor #22153 [WebpackEncore] Minor updates (Kocal)

This PR was merged into the 6.4 branch.

Discussion
----------

[WebpackEncore] Minor updates

I asked Claude Opus 4.6 to see what could changed in Encore documentation, since she has been somewhat forgotten for a while... 😅

Commits
-------

d505c96 [WebpackEncore] Minor updates

Author: javiereguiluz

frontend/encore/advanced-config.rst

@@ -268,7 +268,7 @@ normally use from the command-line interface:
     Encore.configureRuntimeEnvironment('dev-server', {
         // Same options you would use with the
         // CLI utility, with their name in camelCase.
-        https: true,
+        serverType: 'https',
         keepPublicPath: true,
     });
 
@@ -280,22 +280,19 @@ The method ``configureLoaderRule()`` provides a clean way to configure Webpack l
 This is a low-level method. All your modifications will be applied just before pushing the loaders rules to Webpack.
 It means that you can override the default configuration provided by Encore, which may break things. Be careful when using it.
 
-One use might be to configure the ``eslint-loader`` to lint Vue files too.
-The following code is equivalent:
+For example, you could use it to configure the ``vue`` loader to enable a specific option:
 
 .. code-block:: javascript
 
     // Manually
     const webpackConfig = Encore.getWebpackConfig();
 
-    const eslintLoader = webpackConfig.module.rules.find(rule => rule.loader === 'eslint-loader');
-    eslintLoader.test = /\.(jsx?|vue)$/;
-
-    return webpackConfig;
+    const vueLoader = webpackConfig.module.rules.find(rule => /vue-loader/.test(rule.loader);
+    vueLoader.options.experimentalInlineMatchResource = true;
 
     // Using Encore.configureLoaderRule()
-    Encore.configureLoaderRule('eslint', loaderRule => {
-        loaderRule.test = /\.(jsx?|vue)$/
+    Encore.configureLoaderRule('vue', loaderRule => {
+        loaderRule.options.experimentalInlineMatchResource = true;
     });
 
     return Encore.getWebpackConfig();
@@ -310,7 +307,6 @@ The following loaders are configurable with ``configureLoaderRule()``:
   - ``stylus``
   - ``svelte``
   - ``vue``
-  - ``eslint``
   - ``typescript`` (alias ``ts``)
   - ``handlebars``
 

frontend/encore/css-preprocessors.rst

@@ -30,4 +30,31 @@ Encore, you're done!
 You can also pass configuration options to each of the loaders. See the
 `Encore's index.js file`_ for detailed documentation.
 
+.. tip::
+
+    Since Encore 6.0, ``sass-loader`` uses the `modern Sass API`_ by default.
+    This means that some options have changed. For example, ``includePaths`` is
+    now ``loadPaths``:
+
+    .. code-block:: javascript
+
+        // webpack.config.js
+        // ...
+
+        Encore
+            // ...
+
+            // with the modern API (default):
+            .enableSassLoader((options) => {
+                options.loadPaths = [/* ... */];
+            })
+
+            // if you need the legacy API (not recommended):
+            .enableSassLoader((options) => {
+                options.api = 'legacy';
+                options.includePaths = [/* ... */];
+            })
+        ;
+
 .. _`Encore's index.js file`: https://github.com/symfony/webpack-encore/blob/master/index.js
+.. _`modern Sass API`: https://sass-lang.com/documentation/js-api/interfaces/options

frontend/encore/dev-server.rst

@@ -100,8 +100,6 @@ the following option:
 
         .configureDevServerOptions(options => {
             options.allowedHosts = 'all';
-            // in older Webpack Dev Server versions, use this option instead:
-            // options.firewall = false;
         })
 
 Beware that this is not a recommended security practice in general, but here

frontend/encore/simple-example.rst

@@ -425,7 +425,7 @@ you need a feature, Encore will tell you what you need to install. Run:
 
 .. code-block:: terminal
 
-    $ npm install sass-loader@^13.0.0 sass --save-dev
+    $ npm install sass-loader@^16.0.0 sass --save-dev
     $ npm run watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See

frontend/encore/vuejs.rst

@@ -106,7 +106,7 @@ Next, run or restart Encore. When you do, you will see an error message helping
 you install any missing dependencies. After running that command and restarting
 Encore, you're done!
 
-Your ``.jsx`` files will now be transformed through ``@vue/babel-preset-jsx``.
+Your ``.jsx`` files will now be transformed through ``@vue/babel-plugin-jsx``.
 
 Using styles
 ~~~~~~~~~~~~