fix: better display of rule array option defaults

bmish · Nov 16, 2023 · 55d415d · 55d415d
1 parent 7cbab78
commit 55d415d
Show file tree

Hide file tree

Showing 3 changed files with 27 additions and 11 deletions.
diff --git a/lib/rule-options-list.ts b/lib/rule-options-list.ts
@@ -55,6 +55,12 @@ function ruleOptionToColumnValues(ruleOption: RuleOption): {
     [COLUMN_TYPE.DEFAULT]:
       ruleOption.default === undefined
         ? undefined
+        : Array.isArray(ruleOption.default)
+        ? `${ruleOption.default.length === 0 ? '`' : ''}[${
+            ruleOption.default.length > 0 ? '`' : ''
+          }${ruleOption.default.join('`, `')}${
+            ruleOption.default.length > 0 ? '`' : ''
+          }]${ruleOption.default.length === 0 ? '`' : ''}`
         : `\`${String(ruleOption.default)}\``,
     [COLUMN_TYPE.DEPRECATED]: ruleOption.deprecated ? 'Yes' : undefined,
     [COLUMN_TYPE.DESCRIPTION]: ruleOption.description,

diff --git a/test/lib/generate/__snapshots__/rule-options-list-test.ts.snap b/test/lib/generate/__snapshots__/rule-options-list-test.ts.snap
@@ -7,17 +7,19 @@ exports[`generate (rule options list) basic generates the documentation 1`] = `
 ## Options
 <!-- begin auto-generated rule options list -->
 
-| Name                       | Description                   | Type                | Choices           | Default  | Required | Deprecated |
-| :------------------------- | :---------------------------- | :------------------ | :---------------- | :------- | :------- | :--------- |
-| \`arr1\`                     |                               | Array               |                   |          |          |            |
-| \`arrWithArrType\`           |                               | String, Boolean     |                   |          |          |            |
-| \`arrWithArrTypeSingleItem\` |                               | String              |                   |          |          |            |
-| \`arrWithItemsArrayType\`    |                               | (String, Boolean)[] |                   |          |          |            |
-| \`arrWithItemsType\`         |                               | String[]            |                   |          |          |            |
-| \`bar\`                      | Choose how to use the rule.   | String              | \`always\`, \`never\` | \`always\` | Yes      |            |
-| \`baz\`                      |                               |                     |                   | \`true\`   | Yes      |            |
-| \`biz\`                      |                               |                     |                   |          |          |            |
-| \`foo\`                      | Enable some kind of behavior. | Boolean             |                   | \`false\`  |          | Yes        |
+| Name                       | Description                   | Type                | Choices           | Default                                | Required | Deprecated |
+| :------------------------- | :---------------------------- | :------------------ | :---------------- | :------------------------------------- | :------- | :--------- |
+| \`arr1\`                     |                               | Array               |                   |                                        |          |            |
+| \`arrWithArrType\`           |                               | String, Boolean     |                   |                                        |          |            |
+| \`arrWithArrTypeSingleItem\` |                               | String              |                   |                                        |          |            |
+| \`arrWithDefault\`           |                               | Array               |                   | [\`hello world\`, \`1\`, \`2\`, \`3\`, \`true\`] |          |            |
+| \`arrWithDefaultEmpty\`      |                               | Array               |                   | \`[]\`                                   |          |            |
+| \`arrWithItemsArrayType\`    |                               | (String, Boolean)[] |                   |                                        |          |            |
+| \`arrWithItemsType\`         |                               | String[]            |                   |                                        |          |            |
+| \`bar\`                      | Choose how to use the rule.   | String              | \`always\`, \`never\` | \`always\`                               | Yes      |            |
+| \`baz\`                      |                               |                     |                   | \`true\`                                 | Yes      |            |
+| \`biz\`                      |                               |                     |                   |                                        |          |            |
+| \`foo\`                      | Enable some kind of behavior. | Boolean             |                   | \`false\`                                |          | Yes        |
 
 <!-- end auto-generated rule options list -->"
 `;

diff --git a/test/lib/generate/rule-options-list-test.ts b/test/lib/generate/rule-options-list-test.ts
@@ -66,6 +66,14 @@ describe('generate (rule options list)', function () {
                             type: ["string", "boolean"]
                           }
                         },
+                        arrWithDefaultEmpty: {
+                          type: "array",
+                          default: [],
+                        },
+                        arrWithDefault: {
+                          type: "array",
+                          default: ['hello world', 1, 2, 3, true],
+                        },
                     },
                     required: ["bar"],
                     additionalProperties: false