@duplojs/agents-kit 0.0.0-stage → 0.1.0-beta.6

package/docs/API/60-playwright/20-actions/10-forceClick.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Actions.forceClick
+ *
+ * Forcer le clic sans contrôle préalable de visibilité.
+ */
+import { Actions } from "@duplojs/playwright";
+import { navigation } from "../fixtures/component";
+
+// Force le clic Playwright ; aucun contrôle préalable de visibilité n’est effectué.
+await Actions.forceClick(navigation, "menuButton");

package/docs/API/60-playwright/20-actions/10-hover.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Actions.hover
+ *
+ * Survoler un élément visible.
+ */
+import { Actions } from "@duplojs/playwright";
+import { navigation } from "../fixtures/component";
+
+await Actions.hover(navigation, "menuButton");

package/docs/API/60-playwright/20-actions/10-press.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Actions.press
+ *
+ * Appuyer sur une touche dans un élément visible.
+ */
+import { Actions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+await Actions.press(searchForm, "query", "Enter");

package/docs/API/60-playwright/20-actions/10-selectOption.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Actions.selectOption
+ *
+ * Sélectionner des options et retourner leurs valeurs.
+ */
+import { Actions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+// Le select autorise plusieurs valeurs ; au runtime, le résultat contient les valeurs sélectionnées.
+const selected = await Actions.selectOption(searchForm, "categories", ["typescript", "testing"]);

package/docs/API/60-playwright/20-actions/10-type.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Actions.type
+ *
+ * Saisir le texte caractère par caractère dans un élément visible.
+ */
+import { Actions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+// Contrairement à fill, la saisie déclenche une séquence de touches pour chaque caractère.
+await Actions.type(searchForm, "query", "Ada", { delay: 20 });

package/docs/API/60-playwright/20-actions/10-uncheck.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Actions.uncheck
+ *
+ * Décocher un élément visible.
+ */
+import { Actions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+await Actions.uncheck(searchForm, "onlyPublished");

package/docs/API/60-playwright/20-actions/10-withStep.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Actions.withStep
+ *
+ * Ajouter une étape Playwright nommée autour d’une interaction.
+ */
+import { Actions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+// Cette étape englobe celle produite par click dans le rapport Playwright.
+await Actions.withStep("Lancer la recherche").click(searchForm, "submit");

package/docs/API/60-playwright/20-actions/index.llms.md

@@ -0,0 +1,60 @@
+## Actions
+
+Interactions avec les éléments nommés des pages et composants.
+
+### [Actions.check](10-check.ts)
+
+Cocher un élément visible.
+ 
+### [Actions.clear](10-clear.ts)
+
+Effacer un champ visible.
+ 
+### [Actions.click](10-click.ts)
+
+Cliquer sur un élément visible.
+ 
+### [Actions.dragTo](10-dragTo.ts)
+
+Glisser un élément visible vers une cible visible.
+ 
+### [Actions.extractContent](10-extractContent.ts)
+
+Extraire le contenu textuel d’un élément visible.
+ 
+### [Actions.fill](10-fill.ts)
+
+Remplacer la valeur d’un champ visible.
+ 
+### [Actions.focus](10-focus.ts)
+
+Donner le focus à un élément visible.
+ 
+### [Actions.forceClick](10-forceClick.ts)
+
+Forcer le clic sans contrôle préalable de visibilité.
+ 
+### [Actions.hover](10-hover.ts)
+
+Survoler un élément visible.
+ 
+### [Actions.press](10-press.ts)
+
+Appuyer sur une touche dans un élément visible.
+ 
+### [Actions.selectOption](10-selectOption.ts)
+
+Sélectionner des options et retourner leurs valeurs.
+ 
+### [Actions.type](10-type.ts)
+
+Saisir le texte caractère par caractère dans un élément visible.
+ 
+### [Actions.uncheck](10-uncheck.ts)
+
+Décocher un élément visible.
+ 
+### [Actions.withStep](10-withStep.ts)
+
+Ajouter une étape Playwright nommée autour d’une interaction.
+ 

package/docs/API/60-playwright/20-actions/index.md

@@ -0,0 +1,3 @@
+## Actions
+
+Interactions avec les éléments nommés des pages et composants.

package/docs/API/60-playwright/30-assertions/10-toBeBusy.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Assertions.toBeBusy
+ *
+ * Vérifier aria-busy="true" sur un élément visible.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { articleList } from "../fixtures/component";
+
+// Exige aria-busy="true" sur cet élément visible.
+await Assertions.toBeBusy(articleList, "loading");

package/docs/API/60-playwright/30-assertions/10-toBeChecked.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toBeChecked
+ *
+ * Vérifier qu’un élément visible est coché.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+await Assertions.toBeChecked(searchForm, "onlyPublished");

package/docs/API/60-playwright/30-assertions/10-toBeDisabled.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toBeDisabled
+ *
+ * Vérifier qu’un élément visible est désactivé.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+await Assertions.toBeDisabled(searchForm, "submit");

package/docs/API/60-playwright/30-assertions/10-toBeEnabled.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toBeEnabled
+ *
+ * Vérifier qu’un élément visible est activé.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+await Assertions.toBeEnabled(searchForm, "submit");

package/docs/API/60-playwright/30-assertions/10-toBeHidden.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toBeHidden
+ *
+ * Vérifier que l’élément est caché.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { navigation } from "../fixtures/component";
+
+await Assertions.toBeHidden(navigation, "menu");

package/docs/API/60-playwright/30-assertions/10-toBeNotBusy.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Assertions.toBeNotBusy
+ *
+ * Vérifier aria-busy="false" sur un élément visible.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { articleList } from "../fixtures/component";
+
+// Exige aria-busy="false", et non simplement l’absence de l’attribut.
+await Assertions.toBeNotBusy(articleList, "loading");

package/docs/API/60-playwright/30-assertions/10-toBeVisible.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Assertions.toBeVisible
+ *
+ * Faire défiler jusqu’à l’élément puis vérifier sa visibilité.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { navigation } from "../fixtures/component";
+
+// L’élément est d’abord défilé dans la vue, puis sa visibilité est vérifiée.
+await Assertions.toBeVisible(navigation, "menu");

package/docs/API/60-playwright/30-assertions/10-toContainText.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toContainText
+ *
+ * Vérifier une partie du texte d’un élément visible.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { articleList } from "../fixtures/component";
+
+await Assertions.toContainText(articleList, "title", /TypeScript/);

package/docs/API/60-playwright/30-assertions/10-toHaveAttribute.ts

@@ -0,0 +1,12 @@
+/**
+ * @title Assertions.toHaveAttribute
+ *
+ * Vérifier un attribut d’un élément visible.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { navigation } from "../fixtures/component";
+
+await Assertions.toHaveAttribute(navigation, "menuButton", "aria-expanded", "true");
+
+// Sans valeur, l’attribut doit correspondre à /.+/ : une valeur vide ne suffit pas.
+await Assertions.toHaveAttribute(navigation, "menuButton", "aria-controls");

package/docs/API/60-playwright/30-assertions/10-toHaveClass.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toHaveClass
+ *
+ * Vérifier les classes d’un élément visible.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { navigation } from "../fixtures/component";
+
+await Assertions.toHaveClass(navigation, "menuButton", /active/);

package/docs/API/60-playwright/30-assertions/10-toHaveNoText.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Assertions.toHaveNoText
+ *
+ * Vérifier que le texte d’un élément visible est vide.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+// Le message visible doit avoir un texte vide.
+await Assertions.toHaveNoText(searchForm, "feedback");

package/docs/API/60-playwright/30-assertions/10-toHaveQuantity.ts

@@ -0,0 +1,20 @@
+/**
+ * @title Assertions.toHaveQuantity
+ *
+ * Vérifier le nombre d’éléments correspondants.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { articleList } from "../fixtures/component";
+
+// Sans opérateur, ou avec "e", le nombre doit être exact.
+await Assertions.toHaveQuantity(articleList, "articles", { quantity: 2 });
+
+// Les bornes sont inclusives ; le comptage est réessayé pendant 5 secondes au plus.
+await Assertions.toHaveQuantity(articleList, "articles", {
+	quantity: 1,
+	operator: "gte",
+});
+await Assertions.toHaveQuantity(articleList, "articles", {
+	quantity: 3,
+	operator: "lte",
+});

package/docs/API/60-playwright/30-assertions/10-toHaveText.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toHaveText
+ *
+ * Vérifier le texte complet d’un élément visible.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { articleList } from "../fixtures/component";
+
+await Assertions.toHaveText(articleList, "title", "Introduction à TypeScript");

package/docs/API/60-playwright/30-assertions/10-toHaveValue.ts

@@ -0,0 +1,9 @@
+/**
+ * @title Assertions.toHaveValue
+ *
+ * Vérifier la valeur d’un élément visible.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+await Assertions.toHaveValue(searchForm, "query", "TypeScript");

package/docs/API/60-playwright/30-assertions/10-withStep.ts

@@ -0,0 +1,10 @@
+/**
+ * @title Assertions.withStep
+ *
+ * Ajouter une étape Playwright nommée autour d’une interaction.
+ */
+import { Assertions } from "@duplojs/playwright";
+import { searchForm } from "../fixtures/component";
+
+// Cette étape englobe celle produite par l’assertion dans le rapport Playwright.
+await Assertions.withStep("Vérifier la recherche").toBeEnabled(searchForm, "submit");

package/docs/API/60-playwright/30-assertions/index.llms.md

@@ -0,0 +1,64 @@
+## Assertions
+
+Vérifications de l’état des éléments nommés des pages et composants.
+
+### [Assertions.toBeBusy](10-toBeBusy.ts)
+
+Vérifier aria-busy="true" sur un élément visible.
+ 
+### [Assertions.toBeChecked](10-toBeChecked.ts)
+
+Vérifier qu’un élément visible est coché.
+ 
+### [Assertions.toBeDisabled](10-toBeDisabled.ts)
+
+Vérifier qu’un élément visible est désactivé.
+ 
+### [Assertions.toBeEnabled](10-toBeEnabled.ts)
+
+Vérifier qu’un élément visible est activé.
+ 
+### [Assertions.toBeHidden](10-toBeHidden.ts)
+
+Vérifier que l’élément est caché.
+ 
+### [Assertions.toBeNotBusy](10-toBeNotBusy.ts)
+
+Vérifier aria-busy="false" sur un élément visible.
+ 
+### [Assertions.toBeVisible](10-toBeVisible.ts)
+
+Faire défiler jusqu’à l’élément puis vérifier sa visibilité.
+ 
+### [Assertions.toContainText](10-toContainText.ts)
+
+Vérifier une partie du texte d’un élément visible.
+ 
+### [Assertions.toHaveAttribute](10-toHaveAttribute.ts)
+
+Vérifier un attribut d’un élément visible.
+ 
+### [Assertions.toHaveClass](10-toHaveClass.ts)
+
+Vérifier les classes d’un élément visible.
+ 
+### [Assertions.toHaveNoText](10-toHaveNoText.ts)
+
+Vérifier que le texte d’un élément visible est vide.
+ 
+### [Assertions.toHaveQuantity](10-toHaveQuantity.ts)
+
+Vérifier le nombre d’éléments correspondants.
+ 
+### [Assertions.toHaveText](10-toHaveText.ts)
+
+Vérifier le texte complet d’un élément visible.
+ 
+### [Assertions.toHaveValue](10-toHaveValue.ts)
+
+Vérifier la valeur d’un élément visible.
+ 
+### [Assertions.withStep](10-withStep.ts)
+
+Ajouter une étape Playwright nommée autour d’une interaction.
+ 

package/docs/API/60-playwright/30-assertions/index.md

@@ -0,0 +1,3 @@
+## Assertions
+
+Vérifications de l’état des éléments nommés des pages et composants.

package/docs/API/60-playwright/fixtures/component.ts

@@ -0,0 +1,44 @@
+import { createComponent, type Website } from "@duplojs/playwright";
+
+declare const website: Website;
+
+const searchFormEngine = createComponent("search form", {
+	getMainElement: ({ body }) => body.locator("form[data-search]"),
+	getElements: ({ mainElement }) => ({
+		query: mainElement.locator("input[name='query']"),
+		submit: mainElement.locator("button[type='submit']"),
+		onlyPublished: mainElement.locator("input[name='published']"),
+		categories: mainElement.locator("select[name='categories'][multiple]"),
+		feedback: mainElement.locator("[role='status']"),
+	}),
+});
+
+const articleListEngine = createComponent("article list", {
+	getMainElement: ({ body }) => body.locator("[data-article-list]"),
+	getElements: ({ mainElement }) => ({
+		articles: mainElement.locator("article"),
+		title: mainElement.locator("h2").first(),
+		loading: mainElement.locator("[data-loading]"),
+	}),
+});
+
+const navigationEngine = createComponent("navigation", {
+	getMainElement: ({ body }) => body.locator("nav"),
+	getElements: ({ mainElement }) => ({
+		menuButton: mainElement.locator("button[data-menu]"),
+		menu: mainElement.locator("[data-menu-items]"),
+	}),
+});
+
+const boardEngine = createComponent("kanban board", {
+	getMainElement: ({ body }) => body.locator("[data-board]"),
+	getElements: ({ mainElement }) => ({
+		task: mainElement.locator("[data-task='review']"),
+		doneColumn: mainElement.locator("[data-column='done']"),
+	}),
+});
+
+export const searchForm = searchFormEngine(website);
+export const articleList = articleListEngine(website);
+export const navigation = navigationEngine(website);
+export const board = boardEngine(website);

package/docs/API/60-playwright/index.md

@@ -0,0 +1,3 @@
+# @duplojs/playwright
+
+Fabriques de site, pages et composants, interactions et assertions pour les parcours E2E.

package/docs/API/index.md

@@ -0,0 +1,3 @@
+# Référence API
+
+Références des fonctions publiques de l’écosystème DuploJS, organisées par package, namespace et domaine.

package/docs/API.llms.md

@@ -0,0 +1,115 @@
+# Référence API
+
+Références des fonctions publiques de l’écosystème DuploJS, organisées par package, namespace et domaine.
+
+# @duplojs/lang
+
+Primitives fonctionnelles indépendantes de la plateforme pour composer des transformations, manipuler les données et préserver leurs garanties de typage.
+
+## [DArray](API/10-lang/10-array/index.llms.md)
+
+Opérations immuables de lecture, transformation, sélection, réduction et modification de tableaux, avec prise en compte de leurs contraintes de typage.
+
+## [DChrono](API/10-lang/10-chrono/index.llms.md)
+
+Création, calcul, comparaison, sérialisation et formatage des dates, heures, durées et fuseaux horaires dans les représentations Chrono de DuploJS.
+
+## [DCommon](API/10-lang/10-common/index.llms.md)
+
+Fonctions générales de composition, de transformation, de contrôle de flux et de manipulation des valeurs partagées par les autres domaines DuploJS.
+
+## [DDataStructure](API/10-lang/10-dataStructure/index.llms.md)
+
+Construction de contrats de données validables au runtime, composables et reflétés dans les types TypeScript.
+
+## [DEither](API/10-lang/10-either/index.llms.md)
+
+Création, discrimination, transformation et propagation des réussites ou des échecs représentés par `Either`.
+
+## [DGenerator](API/10-lang/10-generator/index.llms.md)
+
+Création et composition de génératrices synchrones ou asynchrones pour produire, transformer, filtrer, réduire et consommer des séquences de valeurs.
+
+## [DNumber](API/10-lang/10-number/index.llms.md)
+
+Prédicats et transformations fonctionnelles pour comparer, vérifier, agréger et trier des nombres tout en conservant leurs contraintes de typage.
+
+## [DObject](API/10-lang/10-object/index.llms.md)
+
+Fonctions fonctionnelles pour lire, discriminer, transformer, fusionner et reconstruire des objets en conservant les informations de typage utiles.
+
+## [DPath](API/10-lang/10-path/index.llms.md)
+
+Chemins Unix typés : déclarer des littéraux, valider et normaliser des chaînes runtime, extraire des segments, résoudre des chemins ou sélectionner des motifs glob, indépendamment du système de fichiers.
+
+## [DPattern](API/10-lang/10-pattern/index.llms.md)
+
+Sélectionner et traiter les variantes d’une union par identité, valeur littérale, motif structurel ou predicate, avec couverture exhaustive ou branche de repli.
+
+## [DPrinter](API/10-lang/10-printer/index.llms.md)
+
+Fonctions et constantes pour assembler du texte, formater des lignes et paragraphes, ajouter une indentation ou des styles ANSI.
+
+## [DString](API/10-lang/10-string/index.llms.md)
+
+Fonctions de manipulation, recherche, validation et transformation des chaînes de caractères, avec des formes curifiées et des contraintes de typage lorsque l'API peut les établir.
+
+## [DTuple](API/10-lang/10-tuple/index.llms.md)
+
+Manipulation et typage des tuples : convertir les garanties de cardinalité en positions typées, puis transformer leurs éléments en conservant leur forme.
+
+# @duplojs/json-web-token
+
+Politiques JWT réutilisables, signature, chiffrement facultatif et primitives cryptographiques.
+
+## [TokenHandler](API/40-json-web-token/10-tokenHandler/index.llms.md)
+
+Définir une politique et créer, décoder ou vérifier les tokens associés.
+
+## [Signer](API/40-json-web-token/20-signer/index.llms.md)
+
+Configurer la signature et la vérification cryptographiques.
+
+## [Cipher](API/40-json-web-token/30-cipher/index.llms.md)
+
+Configurer le chiffrement et le déchiffrement facultatifs des tokens.
+
+## [Utilitaires JWT](API/40-json-web-token/40-utils/index.llms.md)
+
+Manipuler les encodages et les primitives cryptographiques publiques.
+
+# @duplojs/form
+
+Construction de formulaires typés à partir de champs composables et de leurs validations.
+
+## Form pour Vue
+
+Fabriques de formulaires, de champs et de templates pour l'intégration Vue.
+
+### [Construction de formulaires](API/50-form/10-vue/10-construction/index.llms.md)
+
+Fabriques de formulaires, de champs et de templates.
+
+### [Layouts](API/50-form/10-vue/20-layouts/index.llms.md)
+
+Composition des champs et ajout de structure, validation, contrôle de flux et slots.
+
+### [Design system](API/50-form/10-vue/30-designSystem/index.llms.md)
+
+Composants et inputs prêts à l'emploi pour construire les formulaires et les commandes des templates Grid.
+
+# @duplojs/playwright
+
+Fabriques de site, pages et composants, interactions et assertions pour les parcours E2E.
+
+## [Construction](API/60-playwright/10-construction/index.llms.md)
+
+Fabriques de sites, pages, composants, interactions et wrappers de parcours.
+
+## [Actions](API/60-playwright/20-actions/index.llms.md)
+
+Interactions avec les éléments nommés des pages et composants.
+
+## [Assertions](API/60-playwright/30-assertions/index.llms.md)
+
+Vérifications de l’état des éléments nommés des pages et composants.

package/docs/concepts/01-fundamental/01-constraint/01-use.ts

@@ -0,0 +1,22 @@
+/**
+ * @title Acquisition des contraintes.
+ *
+ * Vérification runtime et narrowing vers un type contraint.
+ */
+import * as DNumber from "@duplojs/lang/number";
+
+// Une contrainte existe uniquement dans le typage : elle ne modifie ni ne valide la valeur.
+// L’intersection compose ici deux garanties établies par les predicates.
+type Age = number & DNumber.Integer & DNumber.Positive;
+
+// @ts-expect-error Le littéral seul ne porte pas les contraintes attendues.
+const age: Age = 12;
+
+// Chaque vérification réussie enrichit le type sans changer la valeur runtime.
+const maybeAge = 12;
+if (
+	DNumber.isInteger(maybeAge)
+	&& DNumber.isPositive(maybeAge)
+) {
+	const age: Age = maybeAge;
+}

package/docs/concepts/01-fundamental/01-constraint/10-built-in-constraint.ts

@@ -0,0 +1,37 @@
+/**
+ * @title Composition des contraintes fournies.
+ *
+ * Réutilisation et composition des contraintes disponibles dans les domaines.
+ */
+import type * as DArray from "@duplojs/lang/array";
+import type * as DNumber from "@duplojs/lang/number";
+import type * as DString from "@duplojs/lang/string";
+
+// Avant de créer une contrainte, vérifier celles du domaine concerné.
+// Une intersection cumule les garanties ; déclarer ce type ne valide aucune donnée.
+// Nom sans espaces aux extrémités, contenant entre 5 et 35 caractères.
+type Name = (
+	& string
+	& DString.MaxCharacters<35>
+	& DString.MinCharacters<5>
+	& DString.Trimmed
+);
+
+// Entier strictement positif, supérieur ou égal à 18 et strictement inférieur à 100.
+type Age = (
+	& number
+	& DNumber.Integer
+	& DNumber.StrictPositive
+	& DNumber.GreaterThanOrEqual<18>
+	& DNumber.LessThan<100>
+);
+
+// Tableau de 1 à 15 éléments, dont chaque élément respecte aussi son contrat.
+type Friends = (
+	& {
+		name: Name;
+		age: Age;
+	}[]
+	& DArray.MinElements<1>
+	& DArray.MaxElements<15>
+);