Bug 1991124 - Fix ESLint require-jsdoc issues in genai code. r=firefox-ai-ml-reviewers,ngrato

Differential Revision: https://phabricator.services.mozilla.com/D266631

Author: Standard8

browser/components/genai/PageAssistChild.sys.mjs

@@ -8,6 +8,9 @@ ChromeUtils.defineESModuleGetters(lazy, {
   Readerable: "resource://gre/modules/Readerable.sys.mjs",
 });
 
+/**
+ * Represents a child actor for getting page data from the browser.
+ */
 export class PageAssistChild extends JSWindowActorChild {
   async receiveMessage(message) {
     switch (message.name) {

browser/components/genai/content/page-assist.mjs

@@ -16,6 +16,9 @@ ChromeUtils.defineESModuleGetters(lazy, {
 
 import MozInputText from "chrome://global/content/elements/moz-input-text.mjs";
 
+/**
+ * A custom element for managing the page assistant input.
+ */
 export class PageAssistInput extends MozInputText {
   static properties = {
     class: { type: String, reflect: true },
@@ -45,6 +48,9 @@ export class PageAssistInput extends MozInputText {
 }
 customElements.define("page-assists-input", PageAssistInput);
 
+/**
+ * A custom element for managing the page assistant sidebar.
+ */
 export class PageAssist extends MozLitElement {
   _progressListener = null;
   _onTabSelect = null;

browser/components/genai/content/smart-assist.mjs

@@ -17,6 +17,9 @@ ChromeUtils.defineESModuleGetters(lazy, {
 
 const FULL_PAGE_URL = "chrome://browser/content/genai/smartAssistPage.html";
 
+/**
+ * A custom element for managing the smart assistant sidebar.
+ */
 export class SmartAssist extends MozLitElement {
   static properties = {
     userPrompt: { type: String },
@@ -102,6 +105,9 @@ export class SmartAssist extends MozLitElement {
 
   /**
    * Mock Functionality to open full page UX
+   *
+   * @param {boolean} enable
+   *   Whether or not to override the new tab page.
    */
   _applyNewTabOverride(enable) {
     try {

browser/components/genai/tests/browser/browser_page_assist_actors.js

@@ -28,6 +28,7 @@ const TEST_LINK_URL_EN =
 /**
  * Helpers
  */
+
 function getPageAssistParentActor(browser) {
   return browser.browsingContext.currentWindowGlobal.getActor("PageAssist");
 }

eslint-rollouts.config.mjs

@@ -470,10 +470,6 @@ export default [
       // Bug 1991124 - Re-enable for these files which regressed whilst
       // require-jsdoc was accidentally not enabled.
       "browser/components/backup/tests/xpcshell/test_PreferencesBackupResource.js",
-      "browser/components/genai/PageAssistChild.sys.mjs",
-      "browser/components/genai/content/page-assist.mjs",
-      "browser/components/genai/content/smart-assist.mjs",
-      "browser/components/genai/tests/browser/browser_page_assist_actors.js",
       "browser/components/mozcachedohttp/MozCachedOHTTPProtocolHandler.sys.mjs",
       "browser/components/security/unexpectedScriptLoad.js",
       "browser/components/webrtc/content/webrtc-preview/webrtc-preview.mjs",