117616: Created documentation for the custom lint options

lint/src/rules/ts/alias-imports.ts

@@ -9,6 +9,7 @@ import { Scope } from '@typescript-eslint/utils/ts-eslint';
 import {
   DSpaceESLintRuleInfo,
   NamedTests,
+  OptionDoc,
 } from '../../util/structure';
 
 export enum Message {
@@ -17,13 +18,21 @@ export enum Message {
   MULTIPLE_ALIASES = 'multipleAliases',
 }
 
+interface AliasImportOptions {
+  aliases: AliasImportOption[];
+}
+
 interface AliasImportOption {
   package: string;
   imported: string;
   local: string;
 }
 
-export const info: DSpaceESLintRuleInfo<[[AliasImportOption]]> = {
+interface AliasImportDocOptions {
+  aliases: OptionDoc;
+}
+
+export const info: DSpaceESLintRuleInfo<[AliasImportOptions], [AliasImportDocOptions]> = {
   name: 'alias-imports',
   meta: {
     docs: {
@@ -36,35 +45,50 @@ export const info: DSpaceESLintRuleInfo<[[AliasImportOption]]> = {
     },
     fixable: 'code',
     type: 'problem',
-    schema: [
-      {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            package: { type: 'string' },
-            imported: { type: 'string' },
-            local: { type: 'string' },
-          },
+    schema: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          package: { type: 'string' },
+          imported: { type: 'string' },
+          local: { type: 'string' },
         },
       },
-    ],
+    },
   },
-  defaultOptions: [
-    [
-      {
-        package: 'rxjs',
-        imported: 'of',
-        local: 'observableOf',
+  optionDocs: [
+    {
+      aliases:  {
+        title: '`aliases`',
+        description: `A list of all the imports that you want to alias for clarity. Every alias should be declared in the following format:
+\`\`\`json
+{
+  "package": "rxjs",
+  "imported": "of",
+  "local": "observableOf"
+}
+\`\`\``,
       },
-    ],
+    },
+  ],
+  defaultOptions: [
+    {
+      aliases: [
+        {
+          package: 'rxjs',
+          imported: 'of',
+          local: 'observableOf',
+        },
+      ],
+    },
   ],
 };
 
 export const rule = ESLintUtils.RuleCreator.withoutDocs({
   ...info,
   create(context: TSESLint.RuleContext<Message, unknown[]>, options: any) {
-    return options[0].reduce((selectors: any, option: AliasImportOption) => {
+    return (options[0] as AliasImportOptions).aliases.reduce((selectors: any, option: AliasImportOption) => {
       selectors[`ImportDeclaration[source.value = "${option.package}"] > ImportSpecifier[imported.name = "${option.imported}"][local.name != "${option.local}"]`] = (node: TSESTree.ImportSpecifier) => handleUnaliasedImport(context, option, node);
       return selectors;
     }, {});

lint/src/rules/ts/themed-component-classes.ts

@@ -52,6 +52,7 @@ export const info = {
       [Message.WRAPPER_IMPORTS_BASE]: 'Themed component wrapper classes must only import the base class',
     },
   },
+  optionDocs: [],
   defaultOptions: [],
 } as DSpaceESLintRuleInfo;
 

lint/src/rules/ts/themed-component-selectors.ts

@@ -53,6 +53,7 @@ Unit tests are exempt from this rule, because they may redefine components using
       [Message.THEMED]: 'Theme override of themeable component should have a selector starting with \'ds-themed-\'',
     },
   },
+  optionDocs: [],
   defaultOptions: [],
 } as DSpaceESLintRuleInfo;
 

lint/src/rules/ts/themed-component-usages.ts

@@ -63,6 +63,7 @@ There are a few exceptions where the base class can still be used:
       [Message.BASE_IN_MODULE]: 'Base themeable components shouldn\'t be declared in modules',
     },
   },
+  optionDocs: [],
   defaultOptions: [],
 } as DSpaceESLintRuleInfo;
 

lint/src/rules/ts/themed-decorators.ts

@@ -10,6 +10,7 @@ import { isTestFile } from '../../util/filter';
 import {
   DSpaceESLintRuleInfo,
   NamedTests,
+  OptionDoc,
 } from '../../util/structure';
 import { getFileTheme } from '../../util/theme-support';
 
@@ -23,7 +24,11 @@ interface ThemedDecoratorsOption {
   decorators: { [name: string]: number };
 }
 
-export const info: DSpaceESLintRuleInfo<[ThemedDecoratorsOption]> = {
+interface ThemedDecoratorsDocsOption {
+  decorators: OptionDoc;
+}
+
+export const info: DSpaceESLintRuleInfo<[ThemedDecoratorsOption], [ThemedDecoratorsDocsOption]> = {
   name: 'themed-decorators',
   meta: {
     docs: {
@@ -47,6 +52,14 @@ export const info: DSpaceESLintRuleInfo<[ThemedDecoratorsOption]> = {
       },
     ],
   },
+  optionDocs: [
+    {
+      decorators: {
+        title: '`decorators`',
+        description: 'A mapping for all the existing themeable decorators, with the decorator name as the key and the index of the `theme` argument as the value.',
+      },
+    },
+  ],
   defaultOptions: [
     {
       decorators: {

lint/src/rules/ts/themed-wrapper-no-input-defaults.ts

@@ -26,6 +26,7 @@ export const info: DSpaceESLintRuleInfo = {
     type: 'problem',
     schema: [],
   },
+  optionDocs: [],
   defaultOptions: [],
 };
 

lint/src/rules/ts/unique-decorators.ts

@@ -9,6 +9,7 @@ import { isTestFile } from '../../util/filter';
 import {
   DSpaceESLintRuleInfo,
   NamedTests,
+  OptionDoc,
 } from '../../util/structure';
 
 export enum Message {
@@ -17,7 +18,15 @@ export enum Message {
 
 const decoratorCalls: Map<string, Set<string>> = new Map();
 
-export const info: DSpaceESLintRuleInfo = {
+export interface UniqueDecoratorsOptions {
+  decorators: string[];
+}
+
+export interface UniqueDecoratorsDocOptions {
+  decorators: OptionDoc;
+}
+
+export const info: DSpaceESLintRuleInfo<[UniqueDecoratorsOptions], [UniqueDecoratorsDocOptions]> = {
   name: 'unique-decorators',
   meta: {
     docs: {
@@ -41,6 +50,14 @@ export const info: DSpaceESLintRuleInfo = {
       },
     ],
   },
+  optionDocs: [
+    {
+      decorators: {
+        title: '`decorators`',
+        description: 'The list of all the decorators for which you want to enforce this behavior.',
+      },
+    },
+  ],
   defaultOptions: [
     {
       decorators: [