@duplojs/agents-kit 0.1.0-beta.6 → 0.1.0-beta.7

package/docs/API/10-lang/10-printer/10-primitives.md

@@ -1,10 +1,18 @@
 ### Constantes et types de DPrinter
 
-Les constantes publiques fournissent les séparateurs textuels usuels, tandis que les types décrivent les couleurs et les valeurs acceptées par les fonctions de rendu.
+Les enums publiques sélectionnent les fins de ligne et les unités d'indentation, tandis que les types décrivent les paramètres et les valeurs acceptées par les fonctions de rendu.
 
 ---
 
-Les constantes `back`, `dash` et `tab` valent respectivement `"\n"`, `"-"` et `"\t"`. Elles peuvent servir de séparateurs pour `render` ou pour assembler du texte dans d’autres traitements.
+`Indent` est une enum créée avec `DCommon.createEnum`, qui propose `tab`, `space1`, `space2`, `space3` et `space4`. `Back` propose `LF` et `CRLF`. Les types du même nom représentent leurs valeurs respectives. Ces enums ne produisent pas de texte : leur interprétation appartient aux fonctions de rendu.
+
+`RenderLineParams` expose un `joinCharacter` optionnel, égal à une espace par défaut. `RenderParagraphParams` expose un `back` optionnel, égal à `Back.LF` par défaut ; le séparateur du paragraphe est exclusivement cette fin de ligne.
+
+Les deux fonctions acceptent un `indent` optionnel, sélectionné avec `Indent`, et un `indentLevel` optionnel, égal à `0` par défaut. Sans type ou sans quantité, aucune indentation n'est ajoutée. La quantité multiplie l'unité choisie : `Indent.space2` avec `indentLevel: 3` produit six espaces. Les quantités négatives ou non finies désactivent l'indentation ; les fractions positives sont tronquées.
+
+`renderLine` préfixe uniquement le début du texte assemblé. `renderParagraph` préfixe chaque ligne, y compris celles déjà présentes dans les chaînes d'entrée, en préservant leurs fins de ligne. Un tableau sans valeur rendable produit toujours une chaîne vide.
+
+La constante `dash` vaut `"-"`.
 
 `Colors` est l’union des couleurs ANSI disponibles : `"red"`, `"green"`, `"yellow"`, `"blue"`, `"magenta"`, `"cyan"` et `"gray"`. Les fonctions `colorized` et `colorizedBold` utilisent cette union pour sélectionner leur couleur.
 

package/docs/API/10-lang/10-printer/10-renderLine.ts

@@ -10,3 +10,27 @@ const line = DPrinter.renderLine(["Nom", [true, "Ada"], false]);
 
 // La valeur obtenue est "Nom true Ada" ; false ne produit aucun texte.
 type _CheckLine = DCommon.ExpectType<typeof line, string, "strict">;
+
+const indentedLine = DPrinter.renderLine(["Nom", "Ada"], {
+	indent: DPrinter.Indent.space2,
+	indentLevel: 1,
+});
+// La valeur obtenue est "  Nom Ada" : l'indentation préfixe la ligne une seule fois.
+type _CheckIndentedLine = DCommon.ExpectType<typeof indentedLine, string, "strict">;
+
+// Un séparateur personnalisé permet notamment d'assembler des fragments sans espace.
+const compact = DPrinter.renderLine(["Nom", ": ", "Ada"], {
+	joinCharacter: "",
+	indent: DPrinter.Indent.tab,
+	indentLevel: 2,
+});
+// La valeur obtenue est "\t\tNom: Ada".
+type _CheckCompact = DCommon.ExpectType<typeof compact, string, "strict">;
+
+// Une chaîne multiligne conserve ses lignes suivantes sans indentation ajoutée.
+const multiline = DPrinter.renderLine(["Nom\nAda"], {
+	indent: DPrinter.Indent.space2,
+	indentLevel: 1,
+});
+// La valeur obtenue est "  Nom\nAda".
+type _CheckMultiline = DCommon.ExpectType<typeof multiline, string, "strict">;

package/docs/API/10-lang/10-printer/10-renderParagraph.ts

@@ -4,7 +4,7 @@
  * Assembler récursivement des valeurs en séparant les éléments par un saut de ligne.
  */
 import * as DPrinter from "@duplojs/lang/printer";
-import type * as DCommon from "@duplojs/lang/common";
+import * as DCommon from "@duplojs/lang/common";
 
 const paragraph = DPrinter.renderParagraph([
 	"Première ligne",
@@ -14,3 +14,24 @@ const paragraph = DPrinter.renderParagraph([
 
 // La valeur obtenue est "Première ligne\nDeuxième ligne\nTroisième ligne".
 type _CheckParagraph = DCommon.ExpectType<typeof paragraph, string, "strict">;
+
+// Le rendu direct permet de choisir CRLF et une indentation par ligne.
+const windowsParagraph = DPrinter.renderParagraph(["Première", "Deuxième"], {
+	back: DPrinter.Back.CRLF,
+	indent: DPrinter.Indent.tab,
+	indentLevel: 1,
+});
+// La valeur obtenue est "\tPremière\r\n\tDeuxième".
+type _CheckWindowsParagraph = DCommon.ExpectType<typeof windowsParagraph, string, "strict">;
+
+// La forme curifiée configure le rendu avant de recevoir les valeurs du pipe.
+const spacedParagraph = DCommon.pipe(
+	["Première", ["Deuxième", false]],
+	DPrinter.renderParagraph({
+		back: DPrinter.Back.LF,
+		indent: DPrinter.Indent.space2,
+		indentLevel: 1,
+	}),
+);
+// La valeur obtenue est "  Première\n  Deuxième".
+type _CheckSpacedParagraph = DCommon.ExpectType<typeof spacedParagraph, string, "strict">;

package/docs/API/10-lang/10-printer/index.llms.md

@@ -4,7 +4,7 @@ Fonctions et constantes pour assembler du texte, formater des lignes et paragrap
 
 ### [Constantes et types de DPrinter](10-primitives.md)
 
-Les constantes publiques fournissent les séparateurs textuels usuels, tandis que les types décrivent les couleurs et les valeurs acceptées par les fonctions de rendu.
+Les enums publiques sélectionnent les fins de ligne et les unités d'indentation, tandis que les types décrivent les paramètres et les valeurs acceptées par les fonctions de rendu.
 
 
 ### [DPrinter.bold](10-bold.ts)
@@ -19,14 +19,6 @@ Encadrer une chaîne par les codes ANSI d’une couleur sélectionnée.
 
 Appliquer une couleur ANSI et le style gras à une chaîne.
  
-### [DPrinter.indent](10-indent.ts)
-
-Produire une chaîne contenant le nombre demandé de tabulations.
- 
-### [DPrinter.render](10-render.ts)
-
-Assembler récursivement des valeurs rendables avec un séparateur choisi.
- 
 ### [DPrinter.renderLine](10-renderLine.ts)
 
 Assembler récursivement des valeurs en séparant les éléments par une espace.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duplojs/agents-kit",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.7",
   "license": "MIT",
   "author": {
     "name": "DuploJS",
@@ -32,19 +32,19 @@
     "./docs/API/*/index.llms.md": "./docs/API/*/index.llms.md"
   },
   "dependencies": {
-    "@duplojs/lang": "0.1.0-beta.6",
-    "@duplojs/server": "0.1.0-beta.6"
+    "@duplojs/lang": "0.1.0-beta.7",
+    "@duplojs/server": "0.1.0-beta.7"
   },
   "peerDependencies": {
-    "@duplojs/code-config": "0.1.0-beta.6",
-    "@duplojs/eslint": "0.1.0-beta.6",
-    "@duplojs/form": "0.1.0-beta.6",
-    "@duplojs/http": "0.1.0-beta.6",
-    "@duplojs/json-web-token": "0.1.0-beta.6",
-    "@duplojs/lang": "0.1.0-beta.6",
-    "@duplojs/playwright": "0.1.0-beta.6",
-    "@duplojs/server": "0.1.0-beta.6",
-    "@duplojs/tools": "0.1.0-beta.6"
+    "@duplojs/code-config": "0.1.0-beta.7",
+    "@duplojs/eslint": "0.1.0-beta.7",
+    "@duplojs/form": "0.1.0-beta.7",
+    "@duplojs/http": "0.1.0-beta.7",
+    "@duplojs/json-web-token": "0.1.0-beta.7",
+    "@duplojs/lang": "0.1.0-beta.7",
+    "@duplojs/playwright": "0.1.0-beta.7",
+    "@duplojs/server": "0.1.0-beta.7",
+    "@duplojs/tools": "0.1.0-beta.7"
   },
   "peerDependenciesMeta": {
     "@duplojs/code-config": {
@@ -70,8 +70,8 @@
     }
   },
   "devDependencies": {
-    "@duplojs/code-config": "0.1.0-beta.6",
-    "@duplojs/eslint": "0.1.0-beta.6",
+    "@duplojs/code-config": "0.1.0-beta.7",
+    "@duplojs/eslint": "0.1.0-beta.7",
     "@types/node": "24.13.3",
     "@types/web": "0.0.358",
     "vue": "3.5.43",

package/docs/API/10-lang/10-printer/10-indent.ts

@@ -1,20 +0,0 @@
-/**
- * @title DPrinter.indent
- *
- * Produire une chaîne contenant le nombre demandé de tabulations.
- */
-import * as DPrinter from "@duplojs/lang/printer";
-import type * as DCommon from "@duplojs/lang/common";
-
-// Deux niveaux produisent "\t\t".
-const nestedIndent = DPrinter.indent(2);
-type _CheckNestedIndent = DCommon.ExpectType<typeof nestedIndent, string, "strict">;
-
-// Une profondeur négative produit "".
-const rootIndent = DPrinter.indent(-1);
-type _CheckRootIndent = DCommon.ExpectType<typeof rootIndent, string, "strict">;
-
-// Les niveaux non finis sont ignorés ; une fraction positive est tronquée.
-const fractional = DPrinter.indent(2.5);
-// La valeur obtenue est "\t\t".
-type _CheckFractional = DCommon.ExpectType<typeof fractional, string, "strict">;

package/docs/API/10-lang/10-printer/10-render.ts

@@ -1,29 +0,0 @@
-/**
- * @title DPrinter.render
- *
- * Assembler récursivement des valeurs rendables avec un séparateur choisi.
- */
-import * as DPrinter from "@duplojs/lang/printer";
-import * as DCommon from "@duplojs/lang/common";
-
-// Appel direct : les tableaux imbriqués sont aplatis et true est rendu.
-// false, null et undefined sont ignorés.
-const summary = DPrinter.render(
-	["Éléments", [true, "validés"], false, null, undefined],
-	" ",
-);
-// La valeur obtenue est "Éléments true validés".
-type _CheckSummary = DCommon.ExpectType<typeof summary, string, "strict">;
-
-// Appel curifié dans un pipe : le séparateur est configuré avant de recevoir les valeurs.
-const compact = DCommon.pipe(
-	["nom", ["type", false], "statut"],
-	DPrinter.render(" · "),
-);
-// La valeur obtenue est "nom · type · statut".
-type _CheckCompact = DCommon.ExpectType<typeof compact, string, "strict">;
-
-// Une chaîne vide est conservée, contrairement à false, null et undefined.
-const emptyField = DPrinter.render(["nom", "", "statut"], "|");
-// La valeur obtenue est "nom||statut" ; un tableau sans élément rendable donnerait "".
-type _CheckEmptyField = DCommon.ExpectType<typeof emptyField, string, "strict">;