feat(08): add support clean type on command feature

.commands/test-lint.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+set -e
+
+ARGUMENTS="$@"
+
+eslint --quiet $ARGUMENTS

.commands/test-tu.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+set -e
+
+ARGUMENTS="$@"
+
+vitest --coverage $ARGUMENTS

.commands/test-types.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+set -e
+
+tsc -p tsconfig.test.json
+
+# docs
+npm -w docs run test:types

.vscode/settings.json

@@ -18,11 +18,12 @@
 	"editor.codeActionsOnSave": {
 		"source.fixAll.eslint": "explicit"
 	},
-
-	"typescript.tsdk": "node_modules/typescript/lib",
-
 	"deno.enable": true,
 	"deno.enablePaths": ["integration/deno"],
 	"deno.disablePaths": ["dist", "node_modules"],
-	"deno.config": "./integration/deno/deno.json"
+	"deno.config": "./integration/deno/deno.json",
+	"js/ts.tsdk.path": "node_modules/typescript/lib",
+	"cSpell.words": [
+		"vitest"
+	]
 }

docs/.commands/test-types.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+set -e
+
+tsc -p tsconfig.app.json
+tsc -p tsconfig.v0.json

docs/.vitepress/config.ts

@@ -95,25 +95,25 @@ export default defineConfig({
 						({ namedGroups }) => A.join(
 							[
 								"// @filename: @duplojs/server-utils.ts",
-								`export * from "@v${namedGroups?.version ?? ""}";`,
+								`export * from "@server-utils/v${namedGroups?.version ?? ""}";`,
 
 								"// @filename: @duplojs/server-utils/file.ts",
-								`export * from "@v${namedGroups?.version ?? ""}/file";`,
+								`export * from "@server-utils/v${namedGroups?.version ?? ""}/file";`,
 
 								"// @filename: @duplojs/server-utils/common.ts",
-								`export * from "@v${namedGroups?.version ?? ""}/common";`,
+								`export * from "@server-utils/v${namedGroups?.version ?? ""}/common";`,
 
 								"// @filename: @duplojs/server-utils/dataParser.ts",
-								`export * from "@v${namedGroups?.version ?? ""}/dataParser";`,
+								`export * from "@server-utils/v${namedGroups?.version ?? ""}/dataParser";`,
 
 								"// @filename: @duplojs/server-utils/dataParserCoerce.ts",
-								`export * from "@v${namedGroups?.version ?? ""}/dataParserCoerce";`,
+								`export * from "@server-utils/v${namedGroups?.version ?? ""}/dataParserCoerce";`,
 
 								"// @filename: @duplojs/server-utils/dataParserExtended.ts",
-								`export * from "@v${namedGroups?.version ?? ""}/dataParserExtended";`,
+								`export * from "@server-utils/v${namedGroups?.version ?? ""}/dataParserExtended";`,
 
 								"// @filename: @duplojs/server-utils/command.ts",
-								`export * from "@v${namedGroups?.version ?? ""}/command";`,
+								`export * from "@server-utils/v${namedGroups?.version ?? ""}/command";`,
 
 								"// @filename: index.ts",
 								"// ---cut---",
@@ -134,13 +134,13 @@ export default defineConfig({
 						moduleResolution: ModuleResolutionKind.Bundler,
 						moduleDetection: ModuleDetectionKind.Force,
 						paths: {
-							"@v0": ["libs/v0/index"],
-							"@v0/common": ["libs/v0/common/index"],
-							"@v0/file": ["libs/v0/file/index"],
-							"@v0/dataParser": ["libs/v0/dataParser/index"],
-							"@v0/dataParserCoerce": ["libs/v0/dataParser/parsers/coerce/index"],
-							"@v0/dataParserExtended": ["libs/v0/dataParser/extended/index"],
-							"@v0/command": ["libs/v0/command/index"],
+							"@server-utils/v0": ["libs/v0/index"],
+							"@server-utils/v0/common": ["libs/v0/common/index"],
+							"@server-utils/v0/file": ["libs/v0/file/index"],
+							"@server-utils/v0/dataParser": ["libs/v0/dataParser/index"],
+							"@server-utils/v0/dataParserCoerce": ["libs/v0/dataParser/parsers/coerce/index"],
+							"@server-utils/v0/dataParserExtended": ["libs/v0/dataParser/extended/index"],
+							"@server-utils/v0/command": ["libs/v0/command/index"],
 						},
 					},
 				},

docs/en/v0/api/command/create.md

@@ -6,14 +6,13 @@ prev:
 next:
   text: "createBooleanOption"
   link: "/en/v0/api/command/createBooleanOption"
-description: "Creates a CLI command with a name, an execute handler, and optional configuration."
+description: "Creates a CLI command with a name, optional options/subject, and an execute handler."
 ---
 
 # create
 
-`create` is used to declare a CLI command.
-You provide a name and an execute function.
-You can also add options, a subject (positional arguments), or sub-commands.
+`create` declares a CLI command.
+You provide a name and an execute function, and you can also add options, a subject for positional arguments, or child commands.
 
 ## Example
 
@@ -48,8 +47,8 @@ function create<
 - `params` (`CreateCommandParams`, optional) : command configuration.
 - `params.description` (`string`, optional) : help description.
 - `params.options` (`Option[]`, optional) : option parsers.
-- `params.subject` (`Subject | Command[]`, optional) : parser for positional data or sub-commands list.
-- `execute` : command handler. Receives typed `options` and optional typed `subject`.
+- `params.subject` (`Subject | Command[]`, optional) : parser-like contract for positional data or sub-commands list.
+- `execute` : command handler. Receives typed `options` and, when present, a typed `subject`.
 
 ## Return value
 

docs/en/v0/api/command/createArrayOption.md

@@ -6,7 +6,7 @@ prev:
 next:
   text: "API Reference"
   link: "/en/v0/api/"
-description: "Creates an option that parses a delimited list into a typed array."
+description: "Creates an option that parses a delimited list into a typed array from a DataParser or clean contract."
 ---
 
 # createArrayOption
@@ -25,11 +25,11 @@ Creates an option that parses a delimited list into a typed array.
 ```typescript
 function createArrayOption<
   GenericName extends string,
-  GenericSchema extends EligibleDataParser,
+  GenericContract extends EligibleContract,
   GenericMinValues extends number
 >(
   name: GenericName,
-  schema: GenericSchema,
+  contract: GenericContract,
   params: {
     description?: string
     aliases?: readonly string[]
@@ -41,18 +41,18 @@ function createArrayOption<
 ): Option<
   GenericName,
   [
-    ...A.CreateTuple<DP.Output<GenericSchema>, GenericMinValues>,
-    ...DP.Output<GenericSchema>[]
+    ...A.CreateTuple<ComputeOptionContract<GenericContract>, GenericMinValues>,
+    ...ComputeOptionContract<GenericContract>[]
   ]
 >
 
 function createArrayOption<
   GenericName extends string,
-  GenericSchema extends EligibleDataParser,
+  GenericContract extends EligibleContract,
   GenericMinValues extends number
 >(
   name: GenericName,
-  schema: GenericSchema,
+  contract: GenericContract,
   params?: {
     description?: string
     aliases?: readonly string[]
@@ -63,8 +63,8 @@ function createArrayOption<
 ): Option<
   GenericName,
   | [
-      ...A.CreateTuple<DP.Output<GenericSchema>, GenericMinValues>,
-      ...DP.Output<GenericSchema>[]
+      ...A.CreateTuple<ComputeOptionContract<GenericContract>, GenericMinValues>,
+      ...ComputeOptionContract<GenericContract>[]
     ]
   | undefined
 >
@@ -73,7 +73,7 @@ function createArrayOption<
 ## Parameters
 
 - `name` (`string`) : option name used as `--name`.
-- `schema` (`EligibleDataParser`) : parser for each array element.
+- `contract` (`EligibleContract`) : parser or clean contract for each array element.
 - `params` (optional) : option metadata and array constraints.
 - `params.required` (`true`, optional) : throws when option is missing.
 - `params.min` (`number`, optional) : minimum number of values.
@@ -87,6 +87,10 @@ function createArrayOption<
 - Required mode: `Option<GenericName, [..items]>`.
 - Optional mode: `Option<GenericName, [..items] | undefined>`.
 
+## Notes
+
+- Primitive parsers and clean primitive contracts are coerced from CLI string input automatically.
+
 ## See also
 
 - [`createOption`](/en/v0/api/command/createOption) - Builds a single-value option.

docs/en/v0/api/command/createOption.md

@@ -6,12 +6,12 @@ prev:
 next:
   text: "createArrayOption"
   link: "/en/v0/api/command/createArrayOption"
-description: "Creates an option with a single parsed value from a DataParser schema."
+description: "Creates an option with a single parsed value from a DataParser or clean contract."
 ---
 
 # createOption
 
-Creates an option with a single parsed value from a DataParser schema.
+Creates an option with a single parsed value from a DataParser or clean contract.
 
 ## Example
 
@@ -25,43 +25,49 @@ Creates an option with a single parsed value from a DataParser schema.
 ```typescript
 function createOption<
   GenericName extends string,
-  GenericSchema extends EligibleDataParser
+  GenericContract extends EligibleContract,
+  GenericOutput extends ComputeOptionContract<GenericContract> = ComputeOptionContract<GenericContract>
 >(
   name: GenericName,
-  schema: GenericSchema,
+  contract: GenericContract,
   params: {
     description?: string
     aliases?: readonly string[]
     required: true
   }
-): Option<GenericName, DP.Output<GenericSchema>>
+): Option<GenericName, GenericOutput>
 
 function createOption<
   GenericName extends string,
-  GenericSchema extends EligibleDataParser
+  GenericContract extends EligibleContract,
+  GenericOutput extends ComputeOptionContract<GenericContract> = ComputeOptionContract<GenericContract>
 >(
   name: GenericName,
-  schema: GenericSchema,
+  contract: GenericContract,
   params?: {
     description?: string
     aliases?: readonly string[]
   }
-): Option<GenericName, DP.Output<GenericSchema> | undefined>
+): Option<GenericName, GenericOutput | undefined>
 ```
 
 ## Parameters
 
 - `name` (`string`) : option name used as `--name`.
-- `schema` (`EligibleDataParser`) : parser used to validate/transform the value.
+- `contract` (`EligibleContract`) : parser or clean contract used to validate/transform the value.
 - `params` (optional) : option metadata and requirement behavior.
 - `params.required` (`true`, optional) : throws when option is missing.
 - `params.description` (`string`, optional) : help description.
 - `params.aliases` (`string[]`, optional) : short aliases.
 
 ## Return value
 
-- `Option<GenericName, DP.Output<GenericSchema>>` when `required: true`.
-- `Option<GenericName, DP.Output<GenericSchema> | undefined>` otherwise.
+- `Option<GenericName, GenericOutput>` when `required: true`.
+- `Option<GenericName, GenericOutput | undefined>` otherwise.
+
+## Notes
+
+- Primitive parsers and clean primitive contracts are coerced from CLI string input automatically.
 
 ## See also
 

docs/examples/v0/api/command/createArrayOption/main.ts

@@ -1,5 +1,7 @@
 import { SC } from "@duplojs/server-utils";
-import { DP, type ExpectType } from "@duplojs/utils";
+import { C, DP, type ExpectType } from "@duplojs/utils";
+
+const UserId = C.createNewType("user-id", DP.number(), C.Positive);
 
 const command = SC.create(
 	"batch",
@@ -18,6 +20,8 @@ const command = SC.create(
 					separator: ";",
 				},
 			),
+			SC.createArrayOption("emails", C.Email),
+			SC.createArrayOption("userIds", UserId),
 		],
 	},
 	({ options }) => {
@@ -26,6 +30,8 @@ const command = SC.create(
 			{
 				tags: string[] | undefined;
 				files: [string, ...string[]];
+				emails: C.Email[] | undefined;
+				userIds: C.GetNewType<typeof UserId>[] | undefined;
 			},
 			"strict"
 		>;
@@ -35,4 +41,6 @@ const command = SC.create(
 await command.execute([
 	"--tags=api,docs",
 	"--files=src/a.ts;src/b.ts",
+	"--emails=dev@duplojs.dev,ops@duplojs.dev",
+	"--userIds=1,2",
 ]);

docs/examples/v0/api/command/createOption/main.ts

@@ -1,5 +1,7 @@
 import { SC } from "@duplojs/server-utils";
-import { DP, type ExpectType } from "@duplojs/utils";
+import { C, DP, type ExpectType } from "@duplojs/utils";
+
+const UserId = C.createNewType("user-id", DP.number(), C.Positive);
 
 const command = SC.create(
 	"serve",
@@ -8,13 +10,15 @@ const command = SC.create(
 			SC.createOption("host", DP.string()),
 			SC.createOption(
 				"port",
-				DP.coerce.number(),
+				DP.number(),
 				{ required: true },
 			),
 			SC.createOption(
 				"environment",
 				DP.literal(["dev", "prod"]),
 			),
+			SC.createOption("email", C.Email),
+			SC.createOption("userId", UserId),
 		],
 	},
 	({ options }) => {
@@ -24,6 +28,8 @@ const command = SC.create(
 				host: string | undefined;
 				port: number;
 				environment: "dev" | "prod" | undefined;
+				email: C.Email | undefined;
+				userId: C.GetNewType<typeof UserId> | undefined;
 			},
 			"strict"
 		>;
@@ -35,4 +41,6 @@ await command.execute([
 	"0.0.0.0",
 	"--port=8080",
 	"--environment=prod",
+	"--email=dev@duplojs.dev",
+	"--userId=42",
 ]);

docs/fr/v0/api/command/create.md

@@ -6,14 +6,13 @@ prev:
 next:
   text: "createBooleanOption"
   link: "/fr/v0/api/command/createBooleanOption"
-description: "Crée une commande CLI avec son nom, son comportement, et une configuration optionnelle."
+description: "Crée une commande CLI avec un nom, des options/sujets optionnels et un handler d'exécution."
 ---
 
 # create
 
 `create` sert à déclarer une commande CLI.
-Vous donnez un nom et une fonction à exécuter.
-Vous pouvez aussi ajouter des options, un sujet (arguments positionnels), ou des sous-commandes.
+Vous fournissez un nom et une fonction d'exécution, et vous pouvez aussi ajouter des options, un sujet pour les arguments positionnels, ou des sous-commandes.
 
 ## Exemple
 
@@ -48,8 +47,8 @@ function create<
 - `params` (`CreateCommandParams`, optionnel) : configuration de la commande.
 - `params.description` (`string`, optionnel) : description affichée dans le help.
 - `params.options` (`Option[]`, optionnel) : parseurs d'options.
-- `params.subject` (`Subject | Command[]`, optionnel) : parser de données positionnelles ou liste de sous-commandes.
-- `execute` : handler de commande. Reçoit `options` typées et `subject` typé optionnel.
+- `params.subject` (`Subject | Command[]`, optionnel) : contrat de parsing pour les données positionnelles ou liste de sous-commandes.
+- `execute` : handler de commande. Reçoit des `options` typées et, si présent, un `subject` typé.
 
 ## Valeur de retour