Add jsdoc

public/components/AuthForm/AuthForm.js

@@ -19,6 +19,12 @@ export class AuthForm {
     return this.#config;
   }
 
+  /**
+   * Authorization fields validation
+   * @param {string} emailValue - email value entered by user
+   * @param {string} passwordValue - password value entered by user
+   * @returns {boolean} - true if the entered fields are valid
+   */
   validateFormFields(emailValue, passwordValue) {
     const emailInput = document.getElementById('form-auth-email');
     const passwordInput = document.getElementById('form-auth-password');
@@ -43,13 +49,24 @@ export class AuthForm {
     }
   }
 
+  /**
+   * Send authorization request
+   * @param {string} emailValue - email value entered by user
+   * @param {string} passwordValue - password value entered by user
+   * @returns {}
+   */
   async authRequest(emailValue, passwordValue) {
     const response = await apiClient.post({
       path: 'tasks',
       body: { email: emailValue, password: passwordValue },
     });
   }
 
+  /**
+   * Processing of clicking on the authorization button
+   * @param {}
+   * @returns {}
+   */
   onAuthButtonClick() {
     const authBtn = document.getElementById('form-auth-btn');
     authBtn.addEventListener('click', async (e) => {
@@ -65,6 +82,11 @@ export class AuthForm {
     });
   }
 
+  /**
+   * Navigate to registration
+   * @param {}
+   * @returns {}
+   */
   handleRegLinkClick() {
     const regLink = document.getElementById('form-auth-reg-link');
     regLink.addEventListener('click', (e) => {

public/components/ConfirmModal/ConfirmModal.js

@@ -47,6 +47,11 @@ export class ConfirmModal {
     });
   }
 
+  /**
+   * Hide modal window
+   * @param {}
+   * @returns {}
+   */
   hideModal() {
     const root = document.getElementById('root');
     const modal = document.getElementById('modal');

public/components/GridBlock/GridBlock.js

@@ -21,6 +21,11 @@ export class GridBlock {
     return this.#movies.slice(0, 3);
   }
 
+  /**
+   * Navigate to category page
+   * @param {}
+   * @returns {}
+   */
   onMoreClick() {
     const more = document.getElementById('grid-block-header-more');
     const main = document.querySelector('main');

public/components/Loader/Loader.js

@@ -15,6 +15,11 @@ export class Loader {
     this.#parent.innerHTML = template();
   }
 
+  /**
+   * Delete loader from page and show loaded page
+   * @param {}
+   * @returns {}
+   */
   kill() {
     this.#parent.innerHTML = this.#element;
   }

public/components/RegForm/RegForm.js

@@ -20,6 +20,14 @@ export class RegForm {
     return this.#config;
   }
 
+  /**
+   * Registration fields validation
+   * @param {string} loginValue - login value entered by user
+   * @param {string} emailValue - email value entered by user
+   * @param {string} passwordValue - password value entered by user
+   * @param {string} passwordConfirmInput - password confirmation value entered by user
+   * @returns {boolean} - true if the entered fields are valid
+   */
   validateFormFields(loginValue, emailValue, passwordValue, confirmValue) {
     const emailInput = document.getElementById('form-reg-email');
     const loginInput = document.getElementById('form-reg-login');
@@ -67,6 +75,14 @@ export class RegForm {
     }
   }
 
+  /**
+   * Send registration request
+   * @param {string} loginValue - login value entered by user
+   * @param {string} emailValue - email value entered by user
+   * @param {string} passwordValue - password value entered by user
+   * @param {string} passwordConfirmInput - password confirmation value entered by user
+   * @returns {}
+   */
   async regRequest(loginValue, emailValue, passwordValue, confirmValue) {
     const response = await apiClient.post({
       path: 'tasks',
@@ -79,6 +95,11 @@ export class RegForm {
     });
   }
 
+  /**
+   * Processing of clicking on the registration button
+   * @param {}
+   * @returns {}
+   */
   onRegButtonClick() {
     const regBtn = document.getElementById('form-reg-btn');
     regBtn.addEventListener('click', async (e) => {
@@ -105,6 +126,11 @@ export class RegForm {
     });
   }
 
+  /**
+   * Navigate to authorization
+   * @param {}
+   * @returns {}
+   */
   handleAuthLinkClick() {
     const authLink = document.getElementById('form-reg-auth-link');
     authLink.addEventListener('click', (e) => {

public/components/Slider/Slider.js

@@ -20,6 +20,11 @@ export class Slider {
     this.renderTemplate();
   }
 
+  /**
+   * checking the slider's boundary values
+   * @param {}
+   * @returns {}
+   */
   checkBtns() {
     const btnNext = document.getElementById('slider-btn-next');
     const btnPrev = document.getElementById('slider-btn-prev');

public/modules/ApiClient.js

@@ -6,6 +6,14 @@ const HTTP_METHOD_PUT = 'PUT';
 const HTTP_METHOD_DELETE = 'DELETE';
 
 class ApiClient {
+  /**
+   * GET request
+   * @param {Object} params - request parameters
+   * @param {string} params.path - API endpoint path
+   * @param {number} params.id - item ID (optional)
+   * @returns {Promise<Object>} - response from the API
+   * @throws {Error} - if the request fails
+   */
   get({ path, id }) {
     return this._apiClient({
       method: HTTP_METHOD_GET,
@@ -14,6 +22,14 @@ class ApiClient {
     });
   }
 
+  /**
+   * POST request
+   * @param {Object} params - request parameters
+   * @param {string} params.path - API endpoint path
+   * @param {Object} params.body - request payload (data to be sent)
+   * @returns {Promise<Object>} - response from the API
+   * @throws {Error} - if the request fails
+   */
   post({ path, body }) {
     return this._apiClient({
       method: HTTP_METHOD_POST,
@@ -22,6 +38,15 @@ class ApiClient {
     });
   }
 
+  /**
+   * PUT request
+   * @param {Object} params - request parameters
+   * @param {string} params.path - API endpoint path
+   * @param {number|string} params.id - item ID to update
+   * @param {Object} params.body - request payload (data to be updated)
+   * @returns {Promise<Object>} - response from the API
+   * @throws {Error} - if the request fails
+   */
   put({ path, id, body }) {
     return this._apiClient({
       method: HTTP_METHOD_PUT,
@@ -31,6 +56,14 @@ class ApiClient {
     });
   }
 
+  /**
+   * DELETE request
+   * @param {Object} params - request parameters
+   * @param {string} params.path - API endpoint path
+   * @param {number|string} params.id - item ID to delete
+   * @returns {Promise<Object>} - response from the API
+   * @throws {Error} - if the request fails
+   */
   delete({ path, id }) {
     return this._apiClient({
       method: HTTP_METHOD_DELETE,
@@ -39,6 +72,17 @@ class ApiClient {
     });
   }
 
+  /**
+   * Send request to API
+   * @param {Object} params - request parameters
+   * @param {string} params.method - HTTP method (GET, POST, PUT, DELETE)
+   * @param {string} params.path - API endpoint path
+   * @param {number|string} [params.id=null] - item ID (optional)
+   * @param {Object} [params.body=null] - request payload (optional)
+   * @returns {Promise<Object>} - response from the API
+   * @throws {Error} - if the request fails
+   * @private
+   */
   async _apiClient({ method, path, id = null, body = null }) {
     const url = API_URL + path + (id ? `/${id}` : '');
     const response = await fetch(url, {

public/modules/Validators.js

@@ -1,3 +1,8 @@
+/**
+ * Email validation
+ * @param {string} emailAddress - email value
+ * @returns {boolean} - true if email value is valid
+ */
 export function validateEmailAddress(emailAddress) {
   let atSymbol = emailAddress.indexOf('@');
   let dotSymbol = emailAddress.lastIndexOf('.');
@@ -20,6 +25,11 @@ export function validateEmailAddress(emailAddress) {
   }
 }
 
+/**
+ * Password validation
+ * @param {string} password - password value
+ * @returns {boolean} - true if password value is valid
+ */
 export function validatePassword(password) {
   if (password.length < 8) {
     return false;
@@ -37,6 +47,11 @@ export function validatePassword(password) {
 }
 
 // TODO: уточнить (сейчас проверяем на длину, только англ символы и разрешение .)
+/**
+ * Login validation
+ * @param {string} username - username value
+ * @returns {boolean} - true if username value is valid
+ */
 export function validateLogin(username) {
   if (username.length <= 5) {
     return false;

public/pages/CategoryPage/CategoryPage.js

@@ -21,6 +21,11 @@ export class CategoryPage {
     return this.#movies.slice(0, 3);
   }
 
+  /**
+   * Send get movies from category request
+   * @param {}
+   * @returns {}
+   */
   async getCategoryMovies() {
     const response = await apiClient.get({
       path: 'movies',
@@ -32,6 +37,11 @@ export class CategoryPage {
     moviesList.render();
   }
 
+  /**
+   * Navigate to previous page
+   * @param {}
+   * @returns {}
+   */
   goBack() {
     const backButton = document.getElementById('category-page-button-back');
     const main = document.querySelector('main');

public/pages/MainPage/MainPage.js

@@ -65,6 +65,11 @@ export class MainPage {
     this.#newMovies = response;
   }
 
+  /**
+   * Render movies blocks
+   * @param {}
+   * @returns {}
+   */
   async renderBlocks() {
     await Promise.all([
       this.getTrendMovies(),