refactor: avoid unpopular negative options in help (#4688)

Author: alexander-akait

packages/webpack-cli/src/webpack-cli.ts

@@ -130,6 +130,7 @@ interface CommandOption {
   negatedDescription?: string;
   defaultValue?: string;
   hidden?: boolean;
+  negativeHidden?: boolean;
   group?: "core";
 }
 
@@ -831,7 +832,7 @@ class WebpackCLI {
         false,
       );
 
-      optionForCommand.hidden = option.hidden || false;
+      optionForCommand.hidden = option.hidden || option.negativeHidden || false;
 
       command.addOption(optionForCommand);
     }
@@ -1010,8 +1011,10 @@ class WebpackCLI {
       },
     ];
 
-    // Options from webpack core to be included in the minimum help output
-    const minimumHelpFlags = [
+    // Extract all the flags being exported from core.
+    // A list of cli flags generated by core can be found here https://github.com/webpack/webpack/blob/main/test/__snapshots__/Cli.basictest.js.snap
+    // Fast search, `includes` is slow
+    const minHelpSet = new Set([
       "mode",
       "watch",
       "watch-options-stdin",
@@ -1022,12 +1025,8 @@ class WebpackCLI {
       "name",
       "output-path",
       "extends",
-    ];
-
-    // Extract all the flags being exported from core.
-    // A list of cli flags generated by core can be found here https://github.com/webpack/webpack/blob/main/test/__snapshots__/Cli.basictest.js.snap
-    // Fast search, `includes` is slow
-    const minHelpSet = new Set(minimumHelpFlags);
+    ]);
+    const minimumNegativeHelpFlags = new Set(["devtool"]);
     const coreArgs = this.webpack.cli.getArguments();
     // Take memory
     const options: CommandOption[] = Array.from({
@@ -1047,6 +1046,7 @@ class WebpackCLI {
         description: meta.description,
         group: "core",
         hidden: !minHelpSet.has(name),
+        negativeHidden: !minimumNegativeHelpFlags.has(name),
       };
     }