From 44847558f780eb767fdb909c29eb7b02b2fbf667 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Igor=20Ste=CC=A8pien=CC=81?= <igor@istepien.dev>
Date: Mon, 23 Oct 2023 01:04:36 +0200
Subject: [PATCH] checkout jsdocs

---
 .../theme/core/checkout/checkoutController.js | 29 ++++++----------
 .../handler/address/editAddressHandler.js     |  6 ++--
 .../address/showAddressErrorMessageHandler.js |  4 ++-
 .../delivery/changeDeliveryMethodHandler.js   |  6 ++--
 .../delivery/editDeliveryStepHandler.js       |  6 ++--
 .../handler/payment/confirmOrderHandler.js    |  8 +++++
 .../payment/orderConfirmationErrorsHandler.js |  8 +++--
 .../payment/toggleOrderButtonStateHandler.js  |  6 ++++
 .../payment/togglePaymentOptionsHandler.js    |  6 ++++
 .../process/checkoutFormSubmitHandler.js      |  7 ++--
 .../process/checkoutStepChangeHandler.js      |  7 ++--
 _dev/js/theme/core/checkout/index.js          | 15 ++++++++-
 .../request/checkCartStillOrderableRequest.js | 17 ++++++----
 .../request/selectDeliveryMethodRequest.js    | 25 ++++++++------
 .../checkout/utils/areConditionsAccepted.js   | 33 +++++++++++++++++--
 .../core/checkout/utils/canProceedOrder.js    | 21 ++++++++++--
 .../utils/collapseAllPaymentOptions.js        | 22 ++++++++++++-
 .../core/checkout/utils/getEditAddress.js     |  6 ++--
 .../utils/getSelectedPaymentOption.js         |  6 ++--
 .../checkout/utils/refreshCheckoutPage.js     |  6 ++--
 .../switchConfirmAddressesButtonState.js      |  9 ++---
 .../utils/switchEditAddressButtonColor.js     | 13 ++++----
 .../toggleOrderConfirmationButtonState.js     |  9 ++---
 23 files changed, 200 insertions(+), 75 deletions(-)

diff --git a/_dev/js/theme/core/checkout/checkoutController.js b/_dev/js/theme/core/checkout/checkoutController.js
index 5be4ff1d..0722249c 100644
--- a/_dev/js/theme/core/checkout/checkoutController.js
+++ b/_dev/js/theme/core/checkout/checkoutController.js
@@ -1,23 +1,8 @@
-import prestashop from 'prestashop';
-import useEvent from '../../components/event/useEvent';
-import editAddressHandler from './handler/address/editAddressHandler';
-import changeAddressHandler from './handler/address/changeAddressHandler';
-import changeDeliveryMethodHandler from './handler/delivery/changeDeliveryMethodHandler';
-import editDeliveryStepHandler from './handler/delivery/editDeliveryStepHandler';
-import showAddressErrorMessageHandler from './handler/address/showAddressErrorMessageHandler';
-import orderConfirmationErrorsHandler from './handler/payment/orderConfirmationErrorsHandler';
-import toggleOrderButtonStateHandler from './handler/payment/toggleOrderButtonStateHandler';
-import togglePaymentOptionsHandler from './handler/payment/togglePaymentOptionsHandler';
-import confirmOrderHandler from './handler/payment/confirmOrderHandler';
-import checkoutFormSubmitHandler from './handler/process/checkoutFormSubmitHandler';
-import checkoutStepChangeHandler from './handler/process/checkoutStepChangeHandler';
-
-const { on } = useEvent();
-
 /**
- * Checkout controller
- * @returns {object} return
- * @returns {function} return.init initialize checkout controller
+ * Checkout controller.
+ *
+ * @returns {object} The checkout controller object.
+ * @property {function} init - Initializes the checkout controller.
  */
 const checkoutController = () => {
   const {
@@ -29,6 +14,12 @@ const checkoutController = () => {
     confirmationSelector,
   } = prestashop.selectors.checkout;
 
+  /**
+   * Initializes the checkout controller by attaching event handlers.
+   *
+   * @function
+   * @returns {void}
+   */
   const init = () => {
     on(document, 'click', editAddresses, editAddressHandler);
     on(document, 'click', deliveryAddressRadios, changeAddressHandler);
diff --git a/_dev/js/theme/core/checkout/handler/address/editAddressHandler.js b/_dev/js/theme/core/checkout/handler/address/editAddressHandler.js
index 8e219f5c..59fd777d 100644
--- a/_dev/js/theme/core/checkout/handler/address/editAddressHandler.js
+++ b/_dev/js/theme/core/checkout/handler/address/editAddressHandler.js
@@ -1,8 +1,10 @@
 import prestashop from 'prestashop';
 
 /**
- * Edit address handler
- * @param event {object} - click event
+ * Handles the click event for editing an address in the Prestashop checkout process.
+ *
+ * @function
+ * @param {object} event - The click event object.
  */
 const editAddressHandler = (event) => {
   const {
diff --git a/_dev/js/theme/core/checkout/handler/address/showAddressErrorMessageHandler.js b/_dev/js/theme/core/checkout/handler/address/showAddressErrorMessageHandler.js
index ab34a2ac..12d65f4c 100644
--- a/_dev/js/theme/core/checkout/handler/address/showAddressErrorMessageHandler.js
+++ b/_dev/js/theme/core/checkout/handler/address/showAddressErrorMessageHandler.js
@@ -6,7 +6,9 @@ import { isElementVisible } from '../../../../utils/DOMHelpers';
 import getEditAddress from '../../utils/getEditAddress';
 
 /**
- * Show address error message handler
+ * Handles the display of address error messages in the Prestashop checkout process.
+ *
+ * @function
  * @returns {void}
  */
 const showAddressErrorMessageHandler = () => {
diff --git a/_dev/js/theme/core/checkout/handler/delivery/changeDeliveryMethodHandler.js b/_dev/js/theme/core/checkout/handler/delivery/changeDeliveryMethodHandler.js
index be17acc4..0e6d2cea 100644
--- a/_dev/js/theme/core/checkout/handler/delivery/changeDeliveryMethodHandler.js
+++ b/_dev/js/theme/core/checkout/handler/delivery/changeDeliveryMethodHandler.js
@@ -6,8 +6,10 @@ import refreshCheckoutPage from '../../utils/refreshCheckoutPage';
 import { each } from '../../../../utils/DOMHelpers';
 
 /**
- * Change delivery method handler
- * @param event {object} - change event
+ * Handles the change of delivery method in the Prestashop checkout process.
+ *
+ * @function
+ * @param {object} event - The change event.
  * @returns {Promise<void>}
  */
 const changeDeliveryMethodHandler = async (event) => {
diff --git a/_dev/js/theme/core/checkout/handler/delivery/editDeliveryStepHandler.js b/_dev/js/theme/core/checkout/handler/delivery/editDeliveryStepHandler.js
index f1ffe1f3..0998f85b 100644
--- a/_dev/js/theme/core/checkout/handler/delivery/editDeliveryStepHandler.js
+++ b/_dev/js/theme/core/checkout/handler/delivery/editDeliveryStepHandler.js
@@ -2,8 +2,10 @@ import prestashop from 'prestashop';
 import useCheckoutStepsController from '../../components/useCheckoutStepsController';
 
 /**
- * Edit delivery step handler
- * @param event {object} - click event
+ * Handles the click event to edit the delivery step in the Prestashop checkout process.
+ *
+ * @function
+ * @param {object} event - The click event.
  */
 const editDeliveryStepHandler = (event) => {
   event.preventDefault();
diff --git a/_dev/js/theme/core/checkout/handler/payment/confirmOrderHandler.js b/_dev/js/theme/core/checkout/handler/payment/confirmOrderHandler.js
index 7b133b40..6a3c77f0 100644
--- a/_dev/js/theme/core/checkout/handler/payment/confirmOrderHandler.js
+++ b/_dev/js/theme/core/checkout/handler/payment/confirmOrderHandler.js
@@ -13,6 +13,14 @@ const showNativeFormErrors = () => {
   });
 };
 
+/**
+ * Handles the click event to confirm the order in the Prestashop checkout process.
+ *
+ * @async
+ * @function
+ * @param {object} e - The click event.
+ * @returns {Promise<void>}
+ */
 const confirmOrderHandler = async (e) => {
   e.preventDefault();
 
diff --git a/_dev/js/theme/core/checkout/handler/payment/orderConfirmationErrorsHandler.js b/_dev/js/theme/core/checkout/handler/payment/orderConfirmationErrorsHandler.js
index 516029f5..9a88324b 100644
--- a/_dev/js/theme/core/checkout/handler/payment/orderConfirmationErrorsHandler.js
+++ b/_dev/js/theme/core/checkout/handler/payment/orderConfirmationErrorsHandler.js
@@ -1,6 +1,10 @@
 /**
- * Redirect to cart page if there are errors on order confirmation
- * @param event {object} - event object
+ * Handles errors on order confirmation by redirecting to the cart page if needed.
+ *
+ * @function
+ * @param {object} event - The event object containing the response information.
+ * @param {object} event.resp - The response object.
+ * @returns {void}
  */
 const orderConfirmationErrorsHandler = ({ resp }) => {
   if (resp?.cartUrl !== '') {
diff --git a/_dev/js/theme/core/checkout/handler/payment/toggleOrderButtonStateHandler.js b/_dev/js/theme/core/checkout/handler/payment/toggleOrderButtonStateHandler.js
index e015bed1..5cd6c560 100644
--- a/_dev/js/theme/core/checkout/handler/payment/toggleOrderButtonStateHandler.js
+++ b/_dev/js/theme/core/checkout/handler/payment/toggleOrderButtonStateHandler.js
@@ -6,6 +6,12 @@ import { each } from '../../../../utils/DOMHelpers';
 
 const { toggle } = useToggleDisplay();
 
+/**
+ * Handles toggling the order button state based on the conditions and emits an event with the updated terms status.
+ *
+ * @function
+ * @returns {void}
+ */
 const toggleOrderButtonStateHandler = () => {
   const { conditionAlertSelector } = prestashop.selectors.checkout;
 
diff --git a/_dev/js/theme/core/checkout/handler/payment/togglePaymentOptionsHandler.js b/_dev/js/theme/core/checkout/handler/payment/togglePaymentOptionsHandler.js
index b9592dd3..17200098 100644
--- a/_dev/js/theme/core/checkout/handler/payment/togglePaymentOptionsHandler.js
+++ b/_dev/js/theme/core/checkout/handler/payment/togglePaymentOptionsHandler.js
@@ -7,6 +7,12 @@ import { each } from '../../../../utils/DOMHelpers';
 
 const { show } = useToggleDisplay();
 
+/**
+ * Handles toggling the visibility of payment options based on the selected payment method, and updates the order button state accordingly.
+ *
+ * @function
+ * @returns {void}
+ */
 const togglePaymentOptionsHandler = () => {
   const paymentBtnEnabled = canProceedOrder();
 
diff --git a/_dev/js/theme/core/checkout/handler/process/checkoutFormSubmitHandler.js b/_dev/js/theme/core/checkout/handler/process/checkoutFormSubmitHandler.js
index a6db247b..9df23b9e 100644
--- a/_dev/js/theme/core/checkout/handler/process/checkoutFormSubmitHandler.js
+++ b/_dev/js/theme/core/checkout/handler/process/checkoutFormSubmitHandler.js
@@ -2,8 +2,11 @@ import prestashop from 'prestashop';
 import { each } from '../../../../utils/DOMHelpers';
 
 /**
- * Checkout form submit handler
- * @param event {object} - submit event
+ * Handles the submission of the checkout form, disables submit buttons, and emits a 'submitCheckoutForm' event.
+ *
+ * @function
+ * @param {object} event - The submit event object.
+ * @returns {void}
  */
 const checkoutFormSubmitHandler = (event) => {
   const submitButtons = event.target.querySelectorAll('button[type="submit"]');
diff --git a/_dev/js/theme/core/checkout/handler/process/checkoutStepChangeHandler.js b/_dev/js/theme/core/checkout/handler/process/checkoutStepChangeHandler.js
index df3430c7..0240e4ad 100644
--- a/_dev/js/theme/core/checkout/handler/process/checkoutStepChangeHandler.js
+++ b/_dev/js/theme/core/checkout/handler/process/checkoutStepChangeHandler.js
@@ -2,8 +2,11 @@ import prestashop from 'prestashop';
 import useCheckoutStepsController from '../../components/useCheckoutStepsController';
 
 /**
- * Checkout step change handler
- * @param event {object} - click event
+ * Handles the change of a checkout step, preventing the default click event, updating the step, and emitting a 'changedCheckoutStep' event.
+ *
+ * @function
+ * @param {object} event - The click event object.
+ * @returns {void}
  */
 const checkoutStepChangeHandler = (event) => {
   event.preventDefault();
diff --git a/_dev/js/theme/core/checkout/index.js b/_dev/js/theme/core/checkout/index.js
index b8342142..ffa7b897 100644
--- a/_dev/js/theme/core/checkout/index.js
+++ b/_dev/js/theme/core/checkout/index.js
@@ -5,7 +5,13 @@ import checkoutController from './checkoutController';
 
 prestashop.checkout = prestashop.checkout || {};
 
-// GLOBAL
+/**
+ * Event handler for checking orderable cart response.
+ *
+ * @param {object} resp - Response object.
+ * @param {object} paymentObject - Payment object.
+ * @returns {boolean} Returns true if there are errors; otherwise, returns false.
+ */
 prestashop.checkout.onCheckOrderableCartResponse = (resp, paymentObject) => {
   if (resp.errors === true) {
     prestashop.emit('orderConfirmationErrors', {
@@ -19,6 +25,11 @@ prestashop.checkout.onCheckOrderableCartResponse = (resp, paymentObject) => {
   return false;
 };
 
+/**
+ * Initializes the checkout process if the page is the checkout page.
+ *
+ * @returns {void}
+ */
 const initCheckout = () => {
   if (prestashop.page.page_name !== 'checkout') {
     return;
@@ -29,6 +40,8 @@ const initCheckout = () => {
   init();
 };
 
+// Event listener for DOM ready event.
 DOMReady(() => {
+  // Initialize the checkout process when the DOM is ready.
   initCheckout();
 });
diff --git a/_dev/js/theme/core/checkout/request/checkCartStillOrderableRequest.js b/_dev/js/theme/core/checkout/request/checkCartStillOrderableRequest.js
index 1793f3c2..660644eb 100644
--- a/_dev/js/theme/core/checkout/request/checkCartStillOrderableRequest.js
+++ b/_dev/js/theme/core/checkout/request/checkCartStillOrderableRequest.js
@@ -2,18 +2,23 @@ import prestashop from 'prestashop';
 import useDefaultHttpRequest from '../../../components/http/useDefaultHttpRequest';
 
 /**
- * @typedef ServerResponse
- * @type {object}
- * @property {string} cartUrl - cart page url
- * @property {boolean} errors - errors flag (true if errors)
+ * Represents the server response from a check cart still orderable request.
+ * @typedef {object} ServerResponse
+ * @property {string} cartUrl - The URL of the cart page.
+ * @property {boolean} errors - A flag indicating whether there are errors (true if there are errors).
  */
 
 /**
- * Check cart still orderable request
+ * Provides a check cart still orderable request with a method to get the request promise.
+ *
+ * @function
  * @returns {{getRequest: (function(): Promise<ServerResponse>)}}
  */
 const checkCartStillOrderableRequest = () => {
-  // payload not typed because it isn't needed
+  /**
+   * Payload not typed because it isn't needed.
+   * @type {object}
+   */
   const payloadToSend = {
     ajax: 1,
     action: 'checkCartStillOrderable',
diff --git a/_dev/js/theme/core/checkout/request/selectDeliveryMethodRequest.js b/_dev/js/theme/core/checkout/request/selectDeliveryMethodRequest.js
index 1927f09e..8198eed5 100644
--- a/_dev/js/theme/core/checkout/request/selectDeliveryMethodRequest.js
+++ b/_dev/js/theme/core/checkout/request/selectDeliveryMethodRequest.js
@@ -1,18 +1,20 @@
 import useDefaultHttpRequest from '../../../components/http/useDefaultHttpRequest';
 
 /**
- * @typedef ServerResponse
- * @type {object}
- * @property {string} preview - checkout summary html content
+ * Represents the server response from a select delivery method request.
+ * @typedef {object} ServerResponse
+ * @property {string} preview - The HTML content of the checkout summary.
  */
 
 /**
- * Select delivery method request
- * @param url {string} - checkout url to send request
- * @param payload {object} - request payload
- * @param payload.delivery_option[id] {string} - delivery option id with id_address_delivery
- * @param payload.ajax {number} - optional
- * @param payload.action {string} - optional
+ * Provides a select delivery method request with a method to get the request promise.
+ *
+ * @function
+ * @param {string} url - The checkout URL to send the request.
+ * @param {object} payload - The request payload.
+ * @param {object} payload.delivery_option[id] - The delivery option ID with id_address_delivery.
+ * @param {number} payload.ajax - An optional parameter.
+ * @param {string} payload.action - An optional parameter.
  * @example
  * const payload = {
  *   'delivery_option[1]': '2,',
@@ -29,7 +31,10 @@ import useDefaultHttpRequest from '../../../components/http/useDefaultHttpReques
  * @returns {{getRequest: (function(): Promise<ServerResponse>)}}
  */
 const selectDeliveryMethodRequest = (url, payload) => {
-  // payload not typed because delivery option parameter is dynamic
+  /**
+   * Payload not typed because the delivery option parameter is dynamic.
+   * @type {object}
+   */
   const payloadToSend = {
     ajax: 1,
     action: 'selectDeliveryOption',
diff --git a/_dev/js/theme/core/checkout/utils/areConditionsAccepted.js b/_dev/js/theme/core/checkout/utils/areConditionsAccepted.js
index a50d9cff..df6d2961 100644
--- a/_dev/js/theme/core/checkout/utils/areConditionsAccepted.js
+++ b/_dev/js/theme/core/checkout/utils/areConditionsAccepted.js
@@ -2,14 +2,42 @@ import prestashop from 'prestashop';
 import { each } from '../../../utils/DOMHelpers';
 
 /**
- * Check if all conditions are accepted
- * @returns {boolean} true if all conditions are accepted or false otherwise
+ * Checks if all conditions are accepted.
+ *
+ * @function
+ * @returns {boolean} True if all conditions are accepted, or false otherwise.
  */
 const areConditionsAccepted = () => {
+  /**
+   * The flag indicating whether all conditions are accepted.
+   * @type {boolean}
+   */
   let accepted = true;
+
+  /**
+   * The selector for conditions.
+   * @type {string}
+   */
   const { conditionsSelector } = prestashop.selectors.checkout;
+
+  /**
+   * The list of conditions.
+   * @type {NodeList<HTMLInputElement>}
+   */
   const conditions = document.querySelectorAll(`${conditionsSelector} input[type="checkbox"]`);
 
+  /**
+   * Iterates through each condition and checks if it is accepted.
+   *
+   * @callback eachCallback
+   * @param {HTMLInputElement} condition - The current condition.
+   * @returns {void}
+   */
+
+  /**
+   * The helper function for iterating through each condition.
+   * @type {eachCallback}
+   */
   each(conditions, (condition) => {
     if (!condition.checked) {
       accepted = false;
@@ -20,3 +48,4 @@ const areConditionsAccepted = () => {
 };
 
 export default areConditionsAccepted;
+
diff --git a/_dev/js/theme/core/checkout/utils/canProceedOrder.js b/_dev/js/theme/core/checkout/utils/canProceedOrder.js
index b213a90d..5e38b06b 100644
--- a/_dev/js/theme/core/checkout/utils/canProceedOrder.js
+++ b/_dev/js/theme/core/checkout/utils/canProceedOrder.js
@@ -2,13 +2,28 @@ import areConditionsAccepted from './areConditionsAccepted';
 import getSelectedPaymentOption from './getSelectedPaymentOption';
 
 /**
- * Check if order can be proceeded
- * @returns {boolean} true if order can be proceeded or false otherwise
+ * Checks if the order can be proceeded.
+ *
+ * @function
+ * @returns {boolean} True if the order can be proceeded, or false otherwise.
  */
 const canProceedOrder = () => {
+  /**
+   * The flag indicating whether the conditions are accepted.
+   * @type {boolean}
+   */
   let proceed = areConditionsAccepted();
 
-  if (!getSelectedPaymentOption()) {
+  /**
+   * The selected payment option.
+   * @type {HTMLElement | null}
+   */
+  const selectedPaymentOption = getSelectedPaymentOption();
+
+  /**
+   * Checks if a payment option is selected.
+   */
+  if (!selectedPaymentOption) {
     proceed = false;
   }
 
diff --git a/_dev/js/theme/core/checkout/utils/collapseAllPaymentOptions.js b/_dev/js/theme/core/checkout/utils/collapseAllPaymentOptions.js
index b11e71ba..76a5ea78 100644
--- a/_dev/js/theme/core/checkout/utils/collapseAllPaymentOptions.js
+++ b/_dev/js/theme/core/checkout/utils/collapseAllPaymentOptions.js
@@ -3,11 +3,31 @@ import { each } from '../../../utils/DOMHelpers';
 import useToggleDisplay from '../../../components/display/useToggleDisplay';
 
 /**
- * Collapse all payment options additional information blocks and options form
+ * Collapses all payment options' additional information blocks and options forms.
+ *
+ * @function
+ * @returns {void}
  */
 const collapseAllPaymentOptions = () => {
+  /**
+   * The selectors related to payment options.
+   * @type {object}
+   * @property {string} additionalInformatonSelector - Selector for additional information blocks.
+   * @property {string} optionsForm - Selector for options forms.
+   */
   const { additionalInformatonSelector, optionsForm } = prestashop.selectors.checkout;
+
+  /**
+   * All payment-related blocks to be collapsed.
+   * @type {NodeListOf<Element>}
+   */
   const paymentRelatedBlocks = document.querySelectorAll(`${additionalInformatonSelector}, ${optionsForm}`);
+
+  /**
+   * The toggle display utility.
+   * @type {object}
+   * @property {function} hide - Function to hide an element.
+   */
   const { hide } = useToggleDisplay();
 
   each(paymentRelatedBlocks, hide);
diff --git a/_dev/js/theme/core/checkout/utils/getEditAddress.js b/_dev/js/theme/core/checkout/utils/getEditAddress.js
index 2fce3e2e..853ab008 100644
--- a/_dev/js/theme/core/checkout/utils/getEditAddress.js
+++ b/_dev/js/theme/core/checkout/utils/getEditAddress.js
@@ -1,6 +1,8 @@
 /**
- * Check if browser url contains editAddress parameter
- * @returns {string | null} editAddress parameter value or null if not found
+ * Checks if the browser URL contains the 'editAddress' parameter.
+ *
+ * @function
+ * @returns {string | null} The value of the 'editAddress' parameter, or null if not found.
  */
 const getEditAddress = () => {
   const urlParams = new URLSearchParams(window.location.search);
diff --git a/_dev/js/theme/core/checkout/utils/getSelectedPaymentOption.js b/_dev/js/theme/core/checkout/utils/getSelectedPaymentOption.js
index 7ab0144f..715f21e0 100644
--- a/_dev/js/theme/core/checkout/utils/getSelectedPaymentOption.js
+++ b/_dev/js/theme/core/checkout/utils/getSelectedPaymentOption.js
@@ -1,6 +1,8 @@
 /**
- * Get selected payment option
- * @returns {HTMLElement|null} Selected payment option HTMLElement or null if not found
+ * Gets the selected payment option.
+ *
+ * @function
+ * @returns {HTMLElement | null} The selected payment option HTMLElement, or null if not found.
  */
 const getSelectedPaymentOption = () => document.querySelector('input[name="payment-option"]:checked');
 
diff --git a/_dev/js/theme/core/checkout/utils/refreshCheckoutPage.js b/_dev/js/theme/core/checkout/utils/refreshCheckoutPage.js
index 94eec1a1..cedfc3d7 100644
--- a/_dev/js/theme/core/checkout/utils/refreshCheckoutPage.js
+++ b/_dev/js/theme/core/checkout/utils/refreshCheckoutPage.js
@@ -1,12 +1,14 @@
 /**
- * Refresh checkout page with updated transaction parameter
+ * Refreshes the checkout page with an updated transaction parameter.
+ *
+ * @function
+ * @returns {void}
  */
 const refreshCheckoutPage = () => {
   const urlParams = new URLSearchParams(window.location.search);
 
   if (urlParams.has('updatedTransaction')) {
     window.location.reload();
-
     return;
   }
 
diff --git a/_dev/js/theme/core/checkout/utils/switchConfirmAddressesButtonState.js b/_dev/js/theme/core/checkout/utils/switchConfirmAddressesButtonState.js
index 2f115664..63667e5d 100644
--- a/_dev/js/theme/core/checkout/utils/switchConfirmAddressesButtonState.js
+++ b/_dev/js/theme/core/checkout/utils/switchConfirmAddressesButtonState.js
@@ -1,8 +1,9 @@
-import { each } from '../../../utils/DOMHelpers';
-
 /**
- * Switch confirm addresses button state
- * @param enable {boolean} - false if button should be disabled
+ * Switches the state of the confirm addresses button.
+ *
+ * @function
+ * @param {boolean} enable - `false` if the button should be disabled.
+ * @returns {void}
  */
 const switchConfirmAddressesButtonState = (enable) => {
   each('button[name=confirm-addresses]', (button) => {
diff --git a/_dev/js/theme/core/checkout/utils/switchEditAddressButtonColor.js b/_dev/js/theme/core/checkout/utils/switchEditAddressButtonColor.js
index c41eb6a6..5e8eb3c6 100644
--- a/_dev/js/theme/core/checkout/utils/switchEditAddressButtonColor.js
+++ b/_dev/js/theme/core/checkout/utils/switchEditAddressButtonColor.js
@@ -1,10 +1,11 @@
-import { each } from '../../../utils/DOMHelpers';
-
 /**
- * Change the color of the edit button for the wrong address
- * @param {boolean} enabled - true if button should be dangered or false otherwise
- * @param {number} id - address id
- * @param {string} type - address type (delivery or invoice)
+ * Changes the color of the edit button for the wrong address.
+ *
+ * @function
+ * @param {boolean} enabled - `true` if the button should be dangered, `false` otherwise.
+ * @param {number} id - Address ID.
+ * @param {string} type - Address type (`delivery` or `invoice`).
+ * @returns {void}
  */
 const switchEditAddressButtonColor = (
   enabled,
diff --git a/_dev/js/theme/core/checkout/utils/toggleOrderConfirmationButtonState.js b/_dev/js/theme/core/checkout/utils/toggleOrderConfirmationButtonState.js
index 8c55914c..d97740f4 100644
--- a/_dev/js/theme/core/checkout/utils/toggleOrderConfirmationButtonState.js
+++ b/_dev/js/theme/core/checkout/utils/toggleOrderConfirmationButtonState.js
@@ -1,8 +1,9 @@
-import prestashop from 'prestashop';
-
 /**
- * Toggle order confirmation button state
- * @param active {boolean} - false if button should be disabled
+ * Toggles the order confirmation button state.
+ *
+ * @function
+ * @param {boolean} active - `false` if the button should be disabled, `true` otherwise.
+ * @returns {void}
  */
 const toggleOrderConfirmationButtonState = (active = false) => {
   const { confirmationSelector } = prestashop.selectors.checkout;