feat: allow specific description for CLI options

lib/cli.js

@@ -37,6 +37,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
 /**
  * @typedef {Object} ArgumentConfig
  * @property {string} description
+ * @property {string} [negatedDescription]
  * @property {string} path
  * @property {boolean} multiple
  * @property {"enum"|"string"|"path"|"number"|"boolean"|"RegExp"|"reset"} type
@@ -97,10 +98,23 @@ const getArguments = (schema = webpackSchema) => {
 	const getDescription = path => {
 		for (const { schema } of path) {
 			if (schema.cli && schema.cli.helper) continue;
+			if (schema.cliDescription) return schema.cliDescription;
 			if (schema.description) return schema.description;
 		}
 	};
 
+	/**
+	 *
+	 * @param {PathItem[]} path path in the schema
+	 * @returns {string | undefined} negative description
+	 */
+	const getNegatedDescription = path => {
+		for (const { schema } of path) {
+			if (schema.cli && schema.cli.helper) continue;
+			if (schema.negatedDescription) return schema.negatedDescription;
+		}
+	};
+
 	/**
 	 *
 	 * @param {any} schemaPart schema
@@ -167,6 +181,7 @@ const getArguments = (schema = webpackSchema) => {
 		const argConfigBase = schemaToArgumentConfig(path[0].schema);
 		if (!argConfigBase) return 0;
 
+		const negatedDescription = getNegatedDescription(path);
 		const name = pathToArgumentName(path[0].path);
 		/** @type {ArgumentConfig} */
 		const argConfig = {
@@ -176,6 +191,10 @@ const getArguments = (schema = webpackSchema) => {
 			path: path[0].path
 		};
 
+		if (negatedDescription) {
+			argConfig.negatedDescription = negatedDescription;
+		}
+
 		if (!flags[name]) {
 			flags[name] = {
 				configs: [],

test/Cli.basictest.js

@@ -5,6 +5,34 @@ describe("Cli", () => {
 		expect(getArguments()).toMatchSnapshot();
 	});
 
+	it("should generate the correct cli flags with custom schema", () => {
+		const schema = {
+			title: "custom CLI options",
+			type: "object",
+			additionalProperties: false,
+			properties: {
+				"with-cli-description": {
+					type: "string",
+					description: "original description",
+					cliDescription: "description for CLI option"
+				},
+				"with-negative-description": {
+					type: "boolean",
+					description: "original description",
+					negatedDescription: "custom negative description"
+				},
+				"with-both-cli-and-negative-description": {
+					type: "boolean",
+					description: "original description",
+					cliDescription: "description for CLI option",
+					negatedDescription: "custom negative description"
+				}
+			}
+		};
+
+		expect(getArguments(schema)).toMatchSnapshot();
+	});
+
 	const test = (name, values, config, fn) => {
 		it(`should correctly process arguments for ${name}`, () => {
 			const args = getArguments();

test/__snapshots__/Cli.basictest.js.snap

@@ -8931,3 +8931,49 @@ Object {
   },
 }
 `;
+
+exports[`Cli should generate the correct cli flags with custom schema 1`] = `
+Object {
+  "with-both-cli-and-negative-description": Object {
+    "configs": Array [
+      Object {
+        "description": "description for CLI option",
+        "multiple": false,
+        "negatedDescription": "custom negative description",
+        "path": "with-both-cli-and-negative-description",
+        "type": "boolean",
+      },
+    ],
+    "description": "description for CLI option",
+    "multiple": false,
+    "simpleType": "boolean",
+  },
+  "with-cli-description": Object {
+    "configs": Array [
+      Object {
+        "description": "description for CLI option",
+        "multiple": false,
+        "path": "with-cli-description",
+        "type": "string",
+      },
+    ],
+    "description": "description for CLI option",
+    "multiple": false,
+    "simpleType": "string",
+  },
+  "with-negative-description": Object {
+    "configs": Array [
+      Object {
+        "description": "original description",
+        "multiple": false,
+        "negatedDescription": "custom negative description",
+        "path": "with-negative-description",
+        "type": "boolean",
+      },
+    ],
+    "description": "original description",
+    "multiple": false,
+    "simpleType": "boolean",
+  },
+}
+`;

types.d.ts

@@ -215,6 +215,7 @@ declare interface Argument {
 }
 declare interface ArgumentConfig {
 	description: string;
+	negatedDescription?: string;
 	path: string;
 	multiple: boolean;
 	type: "string" | "number" | "boolean" | "path" | "enum" | "RegExp" | "reset";