@uuv/cypress 2.1.0 → 2.2.0

package/src/cucumber/step_definitions/cypress/generated/_fr-generated-cucumber-steps-definition.ts

@@ -24,13 +24,19 @@ import { Method } from "cypress/types/net-stubbing";
 import { KEY_PRESS } from "@uuv/runner-commons";
 
 import {
-  assertTextContent,
-  findWithRoleAndName,
-  findWithRoleAndNameAndContent, findWithRoleAndNameAndContentDisable, findWithRoleAndNameAndContentEnable,
-  notFoundWithRoleAndName,
-  withinRoleAndName
+    assertTextContent,
+    findWithRoleAndName,
+    findWithRoleAndNameAndContent,
+    findWithRoleAndNameAndContentDisable,
+    findWithRoleAndNameAndContentEnable,
+    notFoundWithRoleAndName,
+    withinRoleAndName
 } from "../core-engine";
+import { A11yReferenceEnum } from "@uuv/a11y";
 
+/**
+ * Navigue vers l'Uri passé en paramètre (url complète étant constituée de la BASE_URL + Uri) ou navigue vers l'Url si ça commence par http:// ou https://
+ * */
 When(`je visite l'Url {string}`, function(siteUrl: string) {
   if (siteUrl.match("^http:\\/\\/|https:\\/\\/")) {
     return cy.visit(`${siteUrl}`);
@@ -38,20 +44,32 @@ When(`je visite l'Url {string}`, function(siteUrl: string) {
   return cy.visit(`${Cypress.config().baseUrl}${siteUrl}`);
 });
 
+/**
+ * Déclenche un click sur l'élément sélectionné.<br/>Assurez vous d'avoir effectué une sélection d'élément avant avec les phrases <strong>Je vais à l'intérieur...</strong>.
+ * */
 When(`je clique`, function() {
   cy.uuvCheckContextFocusedElement().then(context => {
     context.focusedElement!.click();
   });
 });
 
+/**
+ * Déclenche un click sur le bouton avec le nom donné
+ * */
 When(`je clique sur le bouton nommé {string}`, function(name: string) {
   click("button", name);
 });
 
+/**
+ * Déclenche un click sur un élément avec le rôle et le nom donnés
+ * */
 When(`je clique sur l'élément avec le rôle {string} et le nom {string}`, function(role: string, name: string) {
   click(role, name);
 });
 
+/**
+ * Saisit de la phrase passée en paramètre (utile par exemple pour remplir un champ de formulaire).<br/>Assurez vous d'avoir effectué une sélection d'élément avant avec les phrases <strong>Je vais à l'intérieur...</strong>.
+ * */
 When(`je saisie le(s) mot(s) {string}`, function(textToType: string) {
   cy.uuvCheckContextFocusedElement().then((context) => {
     context.focusedElement!.focus();
@@ -59,6 +77,9 @@ When(`je saisie le(s) mot(s) {string}`, function(textToType: string) {
   });
 });
 
+/**
+ * Répète la touche le nombre de fois spécifié en utilisant | comme ceci : num|{key}
+ * */
 When(`j'appuie {int} fois sur {string}`, function(nbTimes: number, key: string) {
   for (let i = 1; i <= nbTimes; i++) {
     cy.uuvCheckContextFocusedElement().then((context) => {
@@ -68,6 +89,9 @@ When(`j'appuie {int} fois sur {string}`, function(nbTimes: number, key: string)
   }
 });
 
+/**
+ * Simule un appui sur la touche spécifiée : <table><thead><tr><th>Touche</th><th>Description</th></tr></thead><tbody><tr><td>{tab}</td><td>Tabulation</td></tr><tr><td>{reverseTab}</td><td>Tabulation arrière</td></tr><tr><td>{down}</td><td>Flèche du bas</td></tr><tr><td>{right}</td><td>Flèche de droite</td></tr><tr><td>{left}</td><td>Flèche de gauche</td></tr><tr><td>{up}</td><td>Flèche du haut</td></tr></tbody></table>.<br/>Assurez vous d'avoir effectué une sélection d'élément avant avec les phrases <strong>Je vais à l'intérieur...</strong>.
+ * */
 When(`j'appuie sur {string}`, function(key: string) {
   cy.uuvCheckContextFocusedElement().then((context) => {
     context.focusedElement!.focus();
@@ -79,10 +103,16 @@ When(`j'appuie sur {string}`, function(key: string) {
 // Context ACTIONS
 ////////////////////////////////////////////
 
+/**
+ * Configure les dimensions de la fenêtre avec à un des préréglages définit par le moteur d'exécution à savoir pour Cypress: [lien](https://docs.cypress.io/api/commands/viewport#Preset) et pour Playwright: [lien](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/deviceDescriptorsSource.json)
+ * */
 Given(`je redimensionne la fenêtre à la vue {string}`, function(viewportPreset: string) {
   return cy.viewport(viewportPreset as Cypress.ViewportPreset);
 });
 
+/**
+ * Configure les dimensions de la fenêtre à la largeur et la longueur spécifiées
+ * */
 Given(
  `je redimensionne la fenêtre avec une largeur de {int} px et une longueur de {int} px`,
  function(width: number, height: number) {
@@ -90,16 +120,25 @@ Given(
  }
 );
 
+/**
+ * Positionne le timeout (en milliseconde) pour la recherche des éléments dans le dom <br />⚠ pensez à déselectionner l'élement avec <b>[je reinitialise le contexte](#je-reinitialise-le-contexte)</b> si vous n'agissez plus dessus
+ * */
 When(`je positionne le timeout à {int} secondes`, function(newTimeout: number) {
   return cy.uuvPatchContext({
     timeout: newTimeout
   });
 });
 
+/**
+ * key.when.withinElement.description
+ * */
 When(`je vais à l'intérieur de l'élément ayant pour rôle {string} et pour nom {string}`, function(role: string, name: string) {
   return withinRoleAndName(role, name);
 });
 
+/**
+ * Sélectionne l'élément dont l'aria-label est spécifié <br />⚠ pensez à déselectionner l'élement avec <b>[je reinitialise le contexte](#je-reinitialise-le-contexte)</b> si vous n'agissez plus dessus
+ * */
 When(`je vais à l'intérieur de l'élément ayant pour aria-label {string}`, function(expectedAriaLabel: string) {
   const foundedElement = cy.uuvFindByLabelText(expectedAriaLabel, {})
    .uuvFoundedElement()
@@ -110,6 +149,9 @@ When(`je vais à l'intérieur de l'élément ayant pour aria-label {string}`, fu
   });
 });
 
+/**
+ * key.when.withinElement.description
+ * */
 When(`je vais à l'intérieur de l'élément ayant pour testId {string}`, function(testId: string) {
   const foundedElement = cy.uuvFindByTestId(testId)
    .uuvFoundedElement()
@@ -120,6 +162,9 @@ When(`je vais à l'intérieur de l'élément ayant pour testId {string}`, functi
   });
 });
 
+/**
+ * Sélectionne l'élément dont le sélecteur est spécifié <br />⚠ pensez à déselectionner l'élement avec <b>[je reinitialise le contexte](#je-reinitialise-le-contexte)</b> si vous n'agissez plus dessus
+ * */
 When(`je vais à l'intérieur de l'élément ayant pour sélecteur {string}`, function(selector: string) {
   const foundedElement = cy.uuvGetContext().then(context => {
     const parentElement = context.focusedElement;
@@ -139,10 +184,16 @@ When(`je vais à l'intérieur de l'élément ayant pour sélecteur {string}`, fu
   });
 });
 
+/**
+ * Supprime l'élément sélectionné et le timeout du contexte
+ * */
 When(`je reinitialise le contexte`, function() {
   return cy.wrap(new Context()).as("context");
 });
 
+/**
+ * Simule une réponse d'API avec un contenu spécifique. <i>Si vous utilisez Playwright comme moteur d'exécution, les attributs <b>méthode de requête</b> et <b>nom</b> ne sont pas utilisés.</i>
+ * */
 When(
  `je simule une requête {} sur l'url {string} nommée {string} avec le contenu suivant {}`,
  function(verb: Method, uri: string, name: string, body: any) {
@@ -154,6 +205,9 @@ When(
  }
 );
 
+/**
+ * Simule une réponse d'API avec un code http spécifique
+ * */
 When(
  `je simule une requête {} sur l'url {string} nommée {string} avec le code http {int}`,
  function(verb: Method, uri: string, name: string, statusCode: number) {
@@ -165,6 +219,9 @@ When(
  }
 );
 
+/**
+ * Simule une réponse d'API avec un fichier spécifique ayant pour extension .json, .js, .coffee, .html, .txt, .csv, .png, .jpg, .jpeg, .gif, .tif, .tiff, .zip
+ * */
 When(
  `je simule une requête {} sur l'url {string} nommée {string} avec le fichier suivant {}`,
  function(verb: Method, uri: string, name: string, fixture: any) {
@@ -179,6 +236,9 @@ When(
 ////////////////////////////////////////////
 // INTERCEPTION
 ////////////////////////////////////////////
+/**
+ * Positionne un ou plusieurs headers à la requête http indiquée et uniquement pour la méthode Http (GET / POST / etc...) passée en paramètre. <i>Si le moteur d'exécution est playwright, la <b>méthode</b> n'est pas gérée.</i>
+ * */
 When(
  `je saisie le(s) header(s) pour l'Uri {string} et la methode {string}`,
  function(url: string, method: string, headersToSet: DataTable) {
@@ -192,6 +252,9 @@ When(
  }
 );
 
+/**
+ * Positionne un ou plusieurs headers à la requête http indiquée
+ * */
 When(`je saisie le(s) header(s) pour l'Uri {string}`, function(url: string, headersToSet: DataTable) {
   cy.intercept(url, (req) => {
     req.headers = {
@@ -207,34 +270,49 @@ When(`je saisie le(s) header(s) pour l'Uri {string}`, function(url: string, head
 ////////////////////////////////////////////
 
 /**
- * Look for an element based on its content
- */
+ * Vérifie qu'un élément Html existe avec le contenu spécifié
+ * */
 Then(`je dois voir un élément qui contient {string}`, async function(textContent: string) {
   cy.uuvFindByText(textContent, {})
    .uuvFoundedElement()
    .should("exist");
 });
 
+/**
+ * Vérifie qu'un élément Html n'existe pas avec le contenu spécifié
+ * */
 Then(`je ne dois pas voir un élément qui contient {string}`, async function(textContent: string) {
   cy.uuvFindByText(textContent, {})
    .should("not.exist");
 });
 
+/**
+ * Vérifie qu'un élément Html existe avec l'attribut data-testid spécifié
+ * */
 Then(`je dois voir un élément ayant pour testId {string}`, async function(testId: string) {
   cy.uuvFindByTestId(testId)
    .uuvFoundedElement()
    .should("exist");
 });
 
+/**
+ * Vérifie qu'un élément Html n'existe pas avec l'attribut data-testid spécifié
+ * */
 Then(`je ne dois pas voir un élément ayant pour testId {string}`, async function(testId: string) {
   cy.uuvFindByTestId(testId)
    .should("not.exist");
 });
 
+/**
+ * Vérifie qu'un élément Html existe avec le [rôle accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) et le [nom accessible](https://russmaxdesign.github.io/html-elements-names/) spécifiés
+ * */
 Then(`je dois voir un élément avec le rôle {string} et le nom {string}`, async function(role: string, name: string) {
   findWithRoleAndName(role, name);
 });
 
+/**
+ * Vérifie qu'un élément Html n'existe pas avec le [rôle accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) et le [nom accessible](https://russmaxdesign.github.io/html-elements-names/) spécifiés
+ * */
 Then(
  `je ne dois pas voir un élément avec le rôle {string} et le nom {string}`,
  async function(role: string, name: string) {
@@ -242,6 +320,9 @@ Then(
  }
 );
 
+/**
+ * Vérifie qu'un élément Html existe avec le [rôle accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), le [nom accessible](https://russmaxdesign.github.io/html-elements-names/) et le contenu spécifiés
+ * */
 Then(
  `je dois voir un élément avec le rôle {string} et le nom {string} et pour contenu {string}`,
  async function(expectedRole: string, name: string, expectedTextContent: string) {
@@ -249,6 +330,9 @@ Then(
  }
 );
 
+/**
+ * Vérifie qu'un élément Html existe avec le [rôle accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), le [nom accessible](https://russmaxdesign.github.io/html-elements-names/) et le contenu spécifiés, et avec l'attribut disabled à true
+ * */
 Then(
  `je dois voir un élément avec le rôle {string} et le nom {string} et pour contenu {string} inactif`,
  async function(expectedRole: string, name: string, expectedTextContent: string) {
@@ -256,6 +340,9 @@ Then(
  }
 );
 
+/**
+ * Vérifie qu'un élément Html existe avec le [rôle accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), le [nom accessible](https://russmaxdesign.github.io/html-elements-names/) et le contenu spécifiés et avec l'attribut disabled à false
+ * */
 Then(
  `je dois voir un élément avec le rôle {string} et le nom {string} et pour contenu {string} actif`,
  async function(expectedRole: string, name: string, expectedTextContent: string) {
@@ -263,17 +350,26 @@ Then(
  }
 );
 
+/**
+ * Vérifie qu'un élément Html existe avec l'attribut aria-label spécifié
+ * */
 Then(`je dois voir un élément ayant pour aria-label {string}`, async function(expectedAriaLabel: string) {
   cy.uuvFindByLabelText(expectedAriaLabel, {})
    .uuvFoundedElement()
    .should("exist");
 });
 
+/**
+ * Vérifie qu'un élément Html n'existe pas avec l'attribut aria-label spécifié
+ * */
 Then(`je ne dois pas voir un élément ayant pour aria-label {string}`, async function(expectedAriaLabel: string) {
   cy.uuvFindByLabelText(expectedAriaLabel, {})
    .should("not.exist");
 });
 
+/**
+ * Vérifie qu'un élément Html existe avec l'attribut aria-label et le contenu spécifiés
+ * */
 Then(
  `je dois voir un élément ayant pour aria-label {string} et pour contenu {string}`,
  async function(expectedAriaLabel: string, expectedTextContent: string) {
@@ -287,14 +383,23 @@ Then(
  }
 );
 
+/**
+ * Vérifie qu'un bouchon nommé ait bien été consommé
+ * */
 Then(`je dois consommer le bouchon nommé {string}`, async function(name: string) {
   cy.wait([`@${name}`]);
 });
 
+/**
+ * key.when.click.withContext.description
+ * */
 Then(`j'attends {int} ms`, async function(ms: number) {
   cy.wait(ms);
 });
 
+/**
+ * Vérifie qu'il existe une liste avec le nom et le contenu spécifiés.<br/>Voici un <a href='https://github.com/Orange-OpenSource/uuv/blob/9e3c9914420c6d527f7ad8b0017a0f8e26250f86/example/weather-app.feature#L17'>exemple</a>
+ * */
 Then(
  `je dois voir des elements de la liste ayant pour nom {string}`,
  async function(expectedListName: string, expectedElementsOfList: DataTable) {
@@ -311,13 +416,16 @@ Then(
         assert.deepEqual(
          foundedElement,
          expectedElementsOfList.raw(),
-         `expected [${expectedElementsOfList.raw()}] to be [${foundedElement}]`
+         `expected [${foundedElement}] to be [${expectedElementsOfList.raw()}]`
         );
       });
     });
  }
 );
 
+/**
+ * Vérifie des attributs Html de l'élément sélectionné
+ * */
 Then(
  `je dois voir les attributs avec valeurs suivantes`,
  async function(expectedAttributeList: DataTable) {
@@ -334,20 +442,28 @@ Then(
  }
 );
 
+/**
+ * Vérifie qu'un élément Html existe avec le sélecteur spécifié
+ * */
 Then(`je dois voir un élément ayant pour sélecteur {string}`, async function(selector: string) {
   cy.get(selector).should("exist");
 });
 
-
+/**
+ * Vérifie sur la page courante qu'il n'y a aucune erreur d'accessibilité [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md)
+ * */
 Then(
- `je ne dois pas avoir de problèmes d'accessibilité`,
+ `je ne dois pas avoir de problèmes d'accessibilité axe-core`,
  async function() {
    cy.injectAxe();
    cy.checkA11y();
  });
 
+/**
+ * Vérifie sur la page courante qu'il n'y a aucune erreur d'accessibilité [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) de niveau critique
+ * */
 Then(
- `je ne dois pas avoir de problèmes d'accessibilité de niveau critique`,
+ `je ne dois pas avoir de problèmes d'accessibilité axe-core de niveau critique`,
  async function() {
    cy.injectAxe();
    cy.checkA11y(undefined, {
@@ -355,8 +471,11 @@ Then(
    });
  });
 
+/**
+ * Vérifie sur la page courante qu'il n'y a aucune erreur d'accessibilité [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md)avec un ou plusieurs impacts parmi : 'minor','moderate','serious','critical'
+ * */
 Then(
- `je ne dois pas avoir de problèmes d'accessibilité avec l(es) impact(s) {}`,
+ `je ne dois pas avoir de problèmes d'accessibilité axe-core avec l(es) impact(s) {}`,
  async function(impacts: any) {
    cy.injectAxe();
    cy.checkA11y(undefined, {
@@ -364,8 +483,11 @@ Then(
    });
  });
 
+/**
+ * Vérifie sur la page courante qu'il n'y a aucune erreur d'accessibilité [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) [avec le ou les standards d'accessibilité](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#axe-core-tags)
+ * */
 Then(
- `je ne dois pas avoir de problèmes d'accessibilité avec le(s) standard(s) {}`,
+ `je ne dois pas avoir de problèmes d'accessibilité axe-core avec le(s) standard(s) {}`,
  async function(tags: any) {
    cy.injectAxe();
    cy.checkA11y(undefined, {
@@ -376,8 +498,11 @@ Then(
    });
  });
 
+/**
+ * Vérifie sur la page courante qu'il n'y a aucune erreur d'accessibilité [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) [avec l'option](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#options-parameter) sur le [contexte donné](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#context-parameter)
+ * */
 Then(
- `je ne dois pas avoir de problèmes d'accessibilité sur le fichier json suivant de contexte {} et avec le fichier json suivant d'option {}`,
+ `je ne dois pas avoir de problèmes d'accessibilité axe-core sur le fichier json suivant de contexte {} et avec le fichier json suivant d'option {}`,
  async function(context: any, option: any) {
    cy.injectAxe();
    cy.fixture(context).then(context => {
@@ -387,8 +512,11 @@ Then(
    });
  });
 
+/**
+ * Vérifie sur la page courante qu'il n'y a aucune erreur d'accessibilité [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) [avec l'option](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#options-parameter)
+ * */
 Then(
- `je ne dois pas avoir de problèmes d'accessibilité avec le fichier json suivant d'option {}`,
+ `je ne dois pas avoir de problèmes d'accessibilité axe-core avec le fichier json suivant d'option {}`,
  async function(option: any) {
    cy.injectAxe();
    cy.fixture(option).then(data => {
@@ -396,6 +524,53 @@ Then(
    });
  });
 
+
+/**
+ * Vérifie sur la page courante qu'il n'y a aucune [erreur de conformité d'accessibilité](https://la-va11ydette.orange.com) avec un des référentiels : WCAG-WEB, RGAA et une des versions 4.1
+ * */
+Then(
+ `je ne dois pas avoir de problèmes d'accessibilité rgaa`,
+ async function() {
+     cy.injectUvvA11y();
+     cy.checkUvvA11y(A11yReferenceEnum.RGAA);
+    // const versionAlix = "5.2.1";
+    // cy.url().then(async (url) => {
+        // const rgaaChecker = new RgaaChecker(url);
+        // return rgaaChecker.validate()
+        //     .pipe(
+        //         tap((result: A11yResult) => {
+        //             result.ruleResults.forEach(ruleResult => {
+        //                 logValidatingA11yRule(result.reference, ruleResult);
+        //                 logA11yRuleResult(result.reference, ruleResult);
+        //             });
+        //             assert.equal(result.status, A11yResultStatus.SUCCESS, "A11y validation failed");
+        //         })
+        //     )
+        //     .toPromise();
+        // switch (reference) {
+        //     case "RGAA":
+        //         await new RgaaChecker(url, a11yCypressEngine).checkCriteria();
+        //     // new AlixError(versionAlix).checkCriteria();
+        //     // new AlixWarning(versionAlix).checkCriteria();
+        //     // new AlixAdvice(versionAlix).checkCriteria();
+        //     // new AlixObsolete(versionAlix).checkCriteria();
+        //     case "WCAG-WEB":
+        //         break;
+        //     case "WCAG-ANDROID":
+        //         break;
+        //     case "WCAG-IOS":
+        //         break;
+        // }
+    // });
+ });
+
+Then(
+    `je dois avoir les résultats suivants selon le référentiel rgaa`,
+    async function(expectedResult: string) {
+        cy.injectUvvA11y();
+        cy.checkUvvA11y(A11yReferenceEnum.RGAA, JSON.parse(expectedResult));
+});
+
 function pressKey(context: Cypress.Chainable<JQuery<HTMLElement>>, key: string) {
   switch (key) {
     case KEY_PRESS.TAB:
@@ -436,3 +611,4 @@ function click(role: string, name: string) {
     }
   });
 }
+

package/src/cucumber/step_definitions/cypress/generated/enriched/en/_en-generated-steps-definition_alert.ts

@@ -29,14 +29,23 @@ import {
 } from "../../../core-engine";
 
 
+/**
+ * Selects the element whose [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and accessible [name](https://russmaxdesign.github.io/html-elements-names/) are specified <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 When(`within an alert named {string}`, function(name: string) {
     return withinRoleAndName("alert", name);
 });
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 Then(`I should see an alert named {string}`, async function(name: string) {
     findWithRoleAndName("alert", name);
 });
 
+/**
+ * Checks that an Html element does not exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 Then(
     `I should not see an alert named {string}`,
     async function(name: string) {
@@ -44,10 +53,16 @@ Then(
     }
 );
 
+/**
+ * Writes the sentence given as a parameter inside the specified field (useful for example to fill in a form field)
+ * */
 When(`I type the sentence {string} in the alert named {string}`, function(textToType: string, name: string) {
     cy.uuvFindByRole("alert", { name: name }).uuvFoundedElement().type(textToType);
 });
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content
+ * */
 Then(
     `I should see an alert named {string} and containing {string}`,
     async function(name: string, expectedTextContent: string) {
@@ -55,6 +70,9 @@ Then(
     }
 );
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to true
+ * */
 Then(
     `I should see an alert named {string} and containing {string} disabled`,
     async function(name: string, expectedTextContent: string) {
@@ -62,6 +80,9 @@ Then(
     }
 );
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to false
+ * */
 Then(
     `I should see an alert named {string} and containing {string} enabled`,
     async function(name: string, expectedTextContent: string) {

package/src/cucumber/step_definitions/cypress/generated/enriched/en/_en-generated-steps-definition_alertdialog.ts

@@ -29,14 +29,23 @@ import {
 } from "../../../core-engine";
 
 
+/**
+ * Selects the element whose [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and accessible [name](https://russmaxdesign.github.io/html-elements-names/) are specified <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 When(`within an alert dialog named {string}`, function(name: string) {
     return withinRoleAndName("alertdialog", name);
 });
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 Then(`I should see an alert dialog named {string}`, async function(name: string) {
     findWithRoleAndName("alertdialog", name);
 });
 
+/**
+ * Checks that an Html element does not exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 Then(
     `I should not see an alert dialog named {string}`,
     async function(name: string) {
@@ -44,10 +53,16 @@ Then(
     }
 );
 
+/**
+ * Writes the sentence given as a parameter inside the specified field (useful for example to fill in a form field)
+ * */
 When(`I type the sentence {string} in the alert dialog named {string}`, function(textToType: string, name: string) {
     cy.uuvFindByRole("alertdialog", { name: name }).uuvFoundedElement().type(textToType);
 });
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content
+ * */
 Then(
     `I should see an alert dialog named {string} and containing {string}`,
     async function(name: string, expectedTextContent: string) {
@@ -55,6 +70,9 @@ Then(
     }
 );
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to true
+ * */
 Then(
     `I should see an alert dialog named {string} and containing {string} disabled`,
     async function(name: string, expectedTextContent: string) {
@@ -62,6 +80,9 @@ Then(
     }
 );
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to false
+ * */
 Then(
     `I should see an alert dialog named {string} and containing {string} enabled`,
     async function(name: string, expectedTextContent: string) {

package/src/cucumber/step_definitions/cypress/generated/enriched/en/_en-generated-steps-definition_application.ts

@@ -29,14 +29,23 @@ import {
 } from "../../../core-engine";
 
 
+/**
+ * Selects the element whose [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and accessible [name](https://russmaxdesign.github.io/html-elements-names/) are specified <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 When(`within an application named {string}`, function(name: string) {
     return withinRoleAndName("application", name);
 });
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 Then(`I should see an application named {string}`, async function(name: string) {
     findWithRoleAndName("application", name);
 });
 
+/**
+ * Checks that an Html element does not exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 Then(
     `I should not see an application named {string}`,
     async function(name: string) {
@@ -44,10 +53,16 @@ Then(
     }
 );
 
+/**
+ * Writes the sentence given as a parameter inside the specified field (useful for example to fill in a form field)
+ * */
 When(`I type the sentence {string} in the application named {string}`, function(textToType: string, name: string) {
     cy.uuvFindByRole("application", { name: name }).uuvFoundedElement().type(textToType);
 });
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content
+ * */
 Then(
     `I should see an application named {string} and containing {string}`,
     async function(name: string, expectedTextContent: string) {
@@ -55,6 +70,9 @@ Then(
     }
 );
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to true
+ * */
 Then(
     `I should see an application named {string} and containing {string} disabled`,
     async function(name: string, expectedTextContent: string) {
@@ -62,6 +80,9 @@ Then(
     }
 );
 
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to false
+ * */
 Then(
     `I should see an application named {string} and containing {string} enabled`,
     async function(name: string, expectedTextContent: string) {