effect 4.0.0-beta.99 → 4.0.0-rc.108

package/dist/unstable/cli/Argument.d.ts

@@ -40,10 +40,11 @@ export interface Argument<A> extends Param.Param<typeof Param.argumentKind, A> {
  *
  * **Example** (Creating a string argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const filename = Argument.string("filename")
+ * filename.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -55,10 +56,11 @@ export declare const string: (name: string) => Argument<string>;
  *
  * **Example** (Creating an integer argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const count = Argument.integer("count")
+ * count.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -70,11 +72,12 @@ export declare const integer: (name: string) => Argument<number>;
  *
  * **Example** (Creating file path arguments)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const inputFile = Argument.file("input", { mustExist: true }) // Must exist
  * const outputFile = Argument.file("output", { mustExist: false }) // Must not exist
+ * const kinds = [inputFile.kind, outputFile.kind] // => ["argument", "argument"]
  * ```
  *
  * @category constructors
@@ -88,10 +91,11 @@ export declare const file: (name: string, options?: {
  *
  * **Example** (Creating a directory path argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const workspace = Argument.directory("workspace", { mustExist: true }) // Must exist
+ * workspace.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -105,10 +109,11 @@ export declare const directory: (name: string, options?: {
  *
  * **Example** (Creating a float argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const ratio = Argument.float("ratio")
+ * ratio.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -120,10 +125,11 @@ export declare const float: (name: string) => Argument<number>;
  *
  * **Example** (Creating a date argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const startDate = Argument.date("start-date")
+ * startDate.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -135,10 +141,11 @@ export declare const date: (name: string) => Argument<Date>;
  *
  * **Example** (Creating a choice argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const environment = Argument.choice("environment", ["dev", "staging", "prod"])
+ * environment.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -150,10 +157,11 @@ export declare const choice: <const Choices extends ReadonlyArray<string>>(name:
  *
  * **Example** (Creating a path argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const configPath = Argument.path("config")
+ * configPath.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -168,10 +176,11 @@ export declare const path: (name: string, options?: {
  *
  * **Example** (Creating a redacted argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const secret = Argument.redacted("secret")
+ * secret.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -183,10 +192,11 @@ export declare const redacted: (name: string) => Argument<Redacted.Redacted<stri
  *
  * **Example** (Reading file text)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const config = Argument.fileText("config-file")
+ * config.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -204,10 +214,11 @@ export declare const fileText: (name: string) => Argument<string>;
  *
  * **Example** (Parsing file content)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const config = Argument.fileParse("config", { format: "json" })
+ * config.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -219,7 +230,7 @@ export declare const fileParse: (name: string, options?: Primitive.FileParseOpti
  *
  * **Example** (Validating file content with a schema)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Schema } from "effect"
  * import { Argument } from "effect/unstable/cli"
  *
@@ -229,6 +240,7 @@ export declare const fileParse: (name: string, options?: Primitive.FileParseOpti
  * })
  *
  * const config = Argument.fileSchema("config", ConfigSchema)
+ * config.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -240,11 +252,12 @@ export declare const fileSchema: <A>(name: string, schema: Schema.ConstraintDeco
  *
  * **Example** (Creating a sentinel argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * // Used as a placeholder or default in combinators
  * const noArg = Argument.none
+ * noArg.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -256,10 +269,11 @@ export declare const none: Argument<never>;
  *
  * **Example** (Making an argument optional)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const optionalVersion = Argument.string("version").pipe(Argument.optional)
+ * optionalVersion.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -271,12 +285,13 @@ export declare const optional: <A>(arg: Argument<A>) => Argument<Option.Option<A
  *
  * **Example** (Adding an argument description)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const filename = Argument.string("filename").pipe(
  *   Argument.withDescription("The input file to process")
  * )
+ * filename.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -288,12 +303,13 @@ export declare const withDescription: {
      *
      * **Example** (Adding an argument description)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const filename = Argument.string("filename").pipe(
      *   Argument.withDescription("The input file to process")
      * )
+     * filename.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -305,12 +321,13 @@ export declare const withDescription: {
      *
      * **Example** (Adding an argument description)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const filename = Argument.string("filename").pipe(
      *   Argument.withDescription("The input file to process")
      * )
+     * filename.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -323,10 +340,11 @@ export declare const withDescription: {
  *
  * **Example** (Providing a default value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const port = Argument.integer("port").pipe(Argument.withDefault(8080))
+ * port.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -338,10 +356,11 @@ export declare const withDefault: {
      *
      * **Example** (Providing a default value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const port = Argument.integer("port").pipe(Argument.withDefault(8080))
+     * port.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -353,10 +372,11 @@ export declare const withDefault: {
      *
      * **Example** (Providing a default value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const port = Argument.integer("port").pipe(Argument.withDefault(8080))
+     * port.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -369,13 +389,14 @@ export declare const withDefault: {
  *
  * **Example** (Loading a fallback config)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Config } from "effect"
  * import { Argument } from "effect/unstable/cli"
  *
  * const repository = Argument.string("repository").pipe(
  *   Argument.withFallbackConfig(Config.string("REPOSITORY"))
  * )
+ * repository.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -387,13 +408,14 @@ export declare const withFallbackConfig: {
      *
      * **Example** (Loading a fallback config)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Config } from "effect"
      * import { Argument } from "effect/unstable/cli"
      *
      * const repository = Argument.string("repository").pipe(
      *   Argument.withFallbackConfig(Config.string("REPOSITORY"))
      * )
+     * repository.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -405,13 +427,14 @@ export declare const withFallbackConfig: {
      *
      * **Example** (Loading a fallback config)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Config } from "effect"
      * import { Argument } from "effect/unstable/cli"
      *
      * const repository = Argument.string("repository").pipe(
      *   Argument.withFallbackConfig(Config.string("REPOSITORY"))
      * )
+     * repository.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -424,12 +447,13 @@ export declare const withFallbackConfig: {
  *
  * **Example** (Showing a fallback prompt)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument, Prompt } from "effect/unstable/cli"
  *
  * const filename = Argument.string("filename").pipe(
  *   Argument.withFallbackPrompt(Prompt.text({ message: "Filename" }))
  * )
+ * filename.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -441,12 +465,13 @@ export declare const withFallbackPrompt: {
      *
      * **Example** (Showing a fallback prompt)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument, Prompt } from "effect/unstable/cli"
      *
      * const filename = Argument.string("filename").pipe(
      *   Argument.withFallbackPrompt(Prompt.text({ message: "Filename" }))
      * )
+     * filename.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -458,12 +483,13 @@ export declare const withFallbackPrompt: {
      *
      * **Example** (Showing a fallback prompt)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument, Prompt } from "effect/unstable/cli"
      *
      * const filename = Argument.string("filename").pipe(
      *   Argument.withFallbackPrompt(Prompt.text({ message: "Filename" }))
      * )
+     * filename.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -476,7 +502,7 @@ export declare const withFallbackPrompt: {
  *
  * **Example** (Accepting multiple values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * // Accept any number of files
@@ -491,6 +517,8 @@ export declare const withFallbackPrompt: {
  * const limitedFiles = Argument.string("files").pipe(
  *   Argument.variadic({ min: 1, max: 5 })
  * )
+ *
+ * const kinds = [anyFiles.kind, atLeastOneFile.kind, limitedFiles.kind] // => ["argument", "argument", "argument"]
  * ```
  *
  * @category combinators
@@ -502,7 +530,7 @@ export declare const variadic: {
      *
      * **Example** (Accepting multiple values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * // Accept any number of files
@@ -517,6 +545,8 @@ export declare const variadic: {
      * const limitedFiles = Argument.string("files").pipe(
      *   Argument.variadic({ min: 1, max: 5 })
      * )
+     *
+     * const kinds = [anyFiles.kind, atLeastOneFile.kind, limitedFiles.kind] // => ["argument", "argument", "argument"]
      * ```
      *
      * @category combinators
@@ -528,7 +558,7 @@ export declare const variadic: {
      *
      * **Example** (Accepting multiple values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * // Accept any number of files
@@ -543,6 +573,8 @@ export declare const variadic: {
      * const limitedFiles = Argument.string("files").pipe(
      *   Argument.variadic({ min: 1, max: 5 })
      * )
+     *
+     * const kinds = [anyFiles.kind, atLeastOneFile.kind, limitedFiles.kind] // => ["argument", "argument", "argument"]
      * ```
      *
      * @category combinators
@@ -555,12 +587,13 @@ export declare const variadic: {
  *
  * **Example** (Mapping parsed values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const port = Argument.integer("port").pipe(
  *   Argument.map((p) => ({ port: p, url: `http://localhost:${p}` }))
  * )
+ * port.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -572,12 +605,13 @@ export declare const map: {
      *
      * **Example** (Mapping parsed values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const port = Argument.integer("port").pipe(
      *   Argument.map((p) => ({ port: p, url: `http://localhost:${p}` }))
      * )
+     * port.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -589,12 +623,13 @@ export declare const map: {
      *
      * **Example** (Mapping parsed values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const port = Argument.integer("port").pipe(
      *   Argument.map((p) => ({ port: p, url: `http://localhost:${p}` }))
      * )
+     * port.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -607,9 +642,27 @@ export declare const map: {
  *
  * **Example** (Validating values effectfully)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Argument, CliError } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * const files = Argument.string("files").pipe(
  *   Argument.mapEffect((file) =>
@@ -617,11 +670,17 @@ export declare const map: {
  *       ? Effect.succeed(file)
  *       : Effect.fail(
  *         new CliError.UserError({
- *           cause: new Error("Only .txt files allowed")
+ *           cause: new Error(`Unsupported file extension: ${file}`),
+ *           userMessage: "Only .txt files allowed"
  *         })
  *       )
  *   )
  * )
+ *
+ * const [, value] = await Effect.runPromise(
+ *   files.parse({ arguments: ["notes.txt"], flags: {} }).pipe(Effect.provide(CliTestLayer))
+ * )
+ * value // => "notes.txt"
  * ```
  *
  * @category combinators
@@ -633,9 +692,27 @@ export declare const mapEffect: {
      *
      * **Example** (Validating values effectfully)
      *
-     * ```ts
-     * import { Effect } from "effect"
+     * ```ts import.meta.vitest
+     * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
      * import { Argument, CliError } from "effect/unstable/cli"
+     * import { ChildProcessSpawner } from "effect/unstable/process"
+     *
+     * const CliTestLayer = Layer.mergeAll(
+     *   FileSystem.layerNoop({}),
+     *   Path.layer,
+     *   Stdio.layerTest({}),
+     *   Layer.succeed(Terminal.Terminal, Terminal.make({
+     *     columns: Effect.succeed(80),
+     *     rows: Effect.succeed(24),
+     *     readInput: Effect.die("unused"),
+     *     readLine: Effect.die("unused"),
+     *     display: () => Effect.void
+     *   })),
+     *   Layer.succeed(
+     *     ChildProcessSpawner.ChildProcessSpawner,
+     *     ChildProcessSpawner.make(() => Effect.die("unused"))
+     *   )
+     * )
      *
      * const files = Argument.string("files").pipe(
      *   Argument.mapEffect((file) =>
@@ -643,11 +720,17 @@ export declare const mapEffect: {
      *       ? Effect.succeed(file)
      *       : Effect.fail(
      *         new CliError.UserError({
-     *           cause: new Error("Only .txt files allowed")
+     *           cause: new Error(`Unsupported file extension: ${file}`),
+     *           userMessage: "Only .txt files allowed"
      *         })
      *       )
      *   )
      * )
+     *
+     * const [, value] = await Effect.runPromise(
+     *   files.parse({ arguments: ["notes.txt"], flags: {} }).pipe(Effect.provide(CliTestLayer))
+     * )
+     * value // => "notes.txt"
      * ```
      *
      * @category combinators
@@ -659,9 +742,27 @@ export declare const mapEffect: {
      *
      * **Example** (Validating values effectfully)
      *
-     * ```ts
-     * import { Effect } from "effect"
+     * ```ts import.meta.vitest
+     * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
      * import { Argument, CliError } from "effect/unstable/cli"
+     * import { ChildProcessSpawner } from "effect/unstable/process"
+     *
+     * const CliTestLayer = Layer.mergeAll(
+     *   FileSystem.layerNoop({}),
+     *   Path.layer,
+     *   Stdio.layerTest({}),
+     *   Layer.succeed(Terminal.Terminal, Terminal.make({
+     *     columns: Effect.succeed(80),
+     *     rows: Effect.succeed(24),
+     *     readInput: Effect.die("unused"),
+     *     readLine: Effect.die("unused"),
+     *     display: () => Effect.void
+     *   })),
+     *   Layer.succeed(
+     *     ChildProcessSpawner.ChildProcessSpawner,
+     *     ChildProcessSpawner.make(() => Effect.die("unused"))
+     *   )
+     * )
      *
      * const files = Argument.string("files").pipe(
      *   Argument.mapEffect((file) =>
@@ -669,11 +770,17 @@ export declare const mapEffect: {
      *       ? Effect.succeed(file)
      *       : Effect.fail(
      *         new CliError.UserError({
-     *           cause: new Error("Only .txt files allowed")
+     *           cause: new Error(`Unsupported file extension: ${file}`),
+     *           userMessage: "Only .txt files allowed"
      *         })
      *       )
      *   )
      * )
+     *
+     * const [, value] = await Effect.runPromise(
+     *   files.parse({ arguments: ["notes.txt"], flags: {} }).pipe(Effect.provide(CliTestLayer))
+     * )
+     * value // => "notes.txt"
      * ```
      *
      * @category combinators
@@ -686,8 +793,27 @@ export declare const mapEffect: {
  *
  * **Example** (Mapping values that may throw)
  *
- * ```ts
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Argument } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * const json = Argument.string("data").pipe(
  *   Argument.mapTryCatch(
@@ -696,6 +822,11 @@ export declare const mapEffect: {
  *       `Invalid JSON: ${error instanceof Error ? error.message : String(error)}`
  *   )
  * )
+ *
+ * const [, value] = await Effect.runPromise(
+ *   json.parse({ arguments: ['{"enabled":true}'], flags: {} }).pipe(Effect.provide(CliTestLayer))
+ * )
+ * value // => { enabled: true }
  * ```
  *
  * @category combinators
@@ -707,8 +838,27 @@ export declare const mapTryCatch: {
      *
      * **Example** (Mapping values that may throw)
      *
-     * ```ts
+     * ```ts import.meta.vitest
+     * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
      * import { Argument } from "effect/unstable/cli"
+     * import { ChildProcessSpawner } from "effect/unstable/process"
+     *
+     * const CliTestLayer = Layer.mergeAll(
+     *   FileSystem.layerNoop({}),
+     *   Path.layer,
+     *   Stdio.layerTest({}),
+     *   Layer.succeed(Terminal.Terminal, Terminal.make({
+     *     columns: Effect.succeed(80),
+     *     rows: Effect.succeed(24),
+     *     readInput: Effect.die("unused"),
+     *     readLine: Effect.die("unused"),
+     *     display: () => Effect.void
+     *   })),
+     *   Layer.succeed(
+     *     ChildProcessSpawner.ChildProcessSpawner,
+     *     ChildProcessSpawner.make(() => Effect.die("unused"))
+     *   )
+     * )
      *
      * const json = Argument.string("data").pipe(
      *   Argument.mapTryCatch(
@@ -717,6 +867,11 @@ export declare const mapTryCatch: {
      *       `Invalid JSON: ${error instanceof Error ? error.message : String(error)}`
      *   )
      * )
+     *
+     * const [, value] = await Effect.runPromise(
+     *   json.parse({ arguments: ['{"enabled":true}'], flags: {} }).pipe(Effect.provide(CliTestLayer))
+     * )
+     * value // => { enabled: true }
      * ```
      *
      * @category combinators
@@ -728,8 +883,27 @@ export declare const mapTryCatch: {
      *
      * **Example** (Mapping values that may throw)
      *
-     * ```ts
+     * ```ts import.meta.vitest
+     * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
      * import { Argument } from "effect/unstable/cli"
+     * import { ChildProcessSpawner } from "effect/unstable/process"
+     *
+     * const CliTestLayer = Layer.mergeAll(
+     *   FileSystem.layerNoop({}),
+     *   Path.layer,
+     *   Stdio.layerTest({}),
+     *   Layer.succeed(Terminal.Terminal, Terminal.make({
+     *     columns: Effect.succeed(80),
+     *     rows: Effect.succeed(24),
+     *     readInput: Effect.die("unused"),
+     *     readLine: Effect.die("unused"),
+     *     display: () => Effect.void
+     *   })),
+     *   Layer.succeed(
+     *     ChildProcessSpawner.ChildProcessSpawner,
+     *     ChildProcessSpawner.make(() => Effect.die("unused"))
+     *   )
+     * )
      *
      * const json = Argument.string("data").pipe(
      *   Argument.mapTryCatch(
@@ -738,6 +912,11 @@ export declare const mapTryCatch: {
      *       `Invalid JSON: ${error instanceof Error ? error.message : String(error)}`
      *   )
      * )
+     *
+     * const [, value] = await Effect.runPromise(
+     *   json.parse({ arguments: ['{"enabled":true}'], flags: {} }).pipe(Effect.provide(CliTestLayer))
+     * )
+     * value // => { enabled: true }
      * ```
      *
      * @category combinators
@@ -750,10 +929,11 @@ export declare const mapTryCatch: {
  *
  * **Example** (Requiring a minimum number of values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const files = Argument.string("files").pipe(Argument.atLeast(1))
+ * files.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -765,10 +945,11 @@ export declare const atLeast: {
      *
      * **Example** (Requiring a minimum number of values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const files = Argument.string("files").pipe(Argument.atLeast(1))
+     * files.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -780,10 +961,11 @@ export declare const atLeast: {
      *
      * **Example** (Requiring a minimum number of values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const files = Argument.string("files").pipe(Argument.atLeast(1))
+     * files.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -796,10 +978,11 @@ export declare const atLeast: {
  *
  * **Example** (Limiting the maximum number of values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const files = Argument.string("files").pipe(Argument.atMost(5))
+ * files.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -811,10 +994,11 @@ export declare const atMost: {
      *
      * **Example** (Limiting the maximum number of values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const files = Argument.string("files").pipe(Argument.atMost(5))
+     * files.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -826,10 +1010,11 @@ export declare const atMost: {
      *
      * **Example** (Limiting the maximum number of values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const files = Argument.string("files").pipe(Argument.atMost(5))
+     * files.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -842,10 +1027,11 @@ export declare const atMost: {
  *
  * **Example** (Requiring a range of values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const files = Argument.string("files").pipe(Argument.between(1, 5))
+ * files.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -857,10 +1043,11 @@ export declare const between: {
      *
      * **Example** (Requiring a range of values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const files = Argument.string("files").pipe(Argument.between(1, 5))
+     * files.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -872,10 +1059,11 @@ export declare const between: {
      *
      * **Example** (Requiring a range of values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const files = Argument.string("files").pipe(Argument.between(1, 5))
+     * files.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -888,13 +1076,14 @@ export declare const between: {
  *
  * **Example** (Validating parsed values with a schema)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Schema } from "effect"
  * import { Argument } from "effect/unstable/cli"
  *
  * const input = Argument.string("input").pipe(
  *   Argument.withSchema(Schema.NonEmptyString)
  * )
+ * input.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -906,13 +1095,14 @@ export declare const withSchema: {
      *
      * **Example** (Validating parsed values with a schema)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Schema } from "effect"
      * import { Argument } from "effect/unstable/cli"
      *
      * const input = Argument.string("input").pipe(
      *   Argument.withSchema(Schema.NonEmptyString)
      * )
+     * input.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -924,13 +1114,14 @@ export declare const withSchema: {
      *
      * **Example** (Validating parsed values with a schema)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Schema } from "effect"
      * import { Argument } from "effect/unstable/cli"
      *
      * const input = Argument.string("input").pipe(
      *   Argument.withSchema(Schema.NonEmptyString)
      * )
+     * input.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -943,7 +1134,7 @@ export declare const withSchema: {
  *
  * **Example** (Mapping choices to values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const logLevel = Argument.choiceWithValue("level", [
@@ -952,6 +1143,7 @@ export declare const withSchema: {
  *   ["warn", 2],
  *   ["error", 3]
  * ])
+ * logLevel.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -968,12 +1160,13 @@ export declare const choiceWithValue: <const Choices extends ReadonlyArray<reado
  *
  * **Example** (Setting a metavar)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const port = Argument.integer("port").pipe(
  *   Argument.withMetavar("PORT")
  * )
+ * port.kind // => "argument"
  * ```
  *
  * @category metadata
@@ -990,12 +1183,13 @@ export declare const withMetavar: {
      *
      * **Example** (Setting a metavar)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const port = Argument.integer("port").pipe(
      *   Argument.withMetavar("PORT")
      * )
+     * port.kind // => "argument"
      * ```
      *
      * @category metadata
@@ -1012,12 +1206,13 @@ export declare const withMetavar: {
      *
      * **Example** (Setting a metavar)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const port = Argument.integer("port").pipe(
      *   Argument.withMetavar("PORT")
      * )
+     * port.kind // => "argument"
      * ```
      *
      * @category metadata
@@ -1030,7 +1225,7 @@ export declare const withMetavar: {
  *
  * **Example** (Filtering parsed values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const positiveInt = Argument.integer("count").pipe(
@@ -1039,6 +1234,7 @@ export declare const withMetavar: {
  *     (n) => `Expected positive integer, got ${n}`
  *   )
  * )
+ * positiveInt.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -1050,7 +1246,7 @@ export declare const filter: {
      *
      * **Example** (Filtering parsed values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const positiveInt = Argument.integer("count").pipe(
@@ -1059,6 +1255,7 @@ export declare const filter: {
      *     (n) => `Expected positive integer, got ${n}`
      *   )
      * )
+     * positiveInt.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -1070,7 +1267,7 @@ export declare const filter: {
      *
      * **Example** (Filtering parsed values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const positiveInt = Argument.integer("count").pipe(
@@ -1079,6 +1276,7 @@ export declare const filter: {
      *     (n) => `Expected positive integer, got ${n}`
      *   )
      * )
+     * positiveInt.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -1092,7 +1290,7 @@ export declare const filter: {
  *
  * **Example** (Filtering and mapping parsed values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  * import { Argument } from "effect/unstable/cli"
  *
@@ -1102,6 +1300,7 @@ export declare const filter: {
  *     (n) => `Expected positive integer, got ${n}`
  *   )
  * )
+ * positiveInt.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -1114,7 +1313,7 @@ export declare const filterMap: {
      *
      * **Example** (Filtering and mapping parsed values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      * import { Argument } from "effect/unstable/cli"
      *
@@ -1124,6 +1323,7 @@ export declare const filterMap: {
      *     (n) => `Expected positive integer, got ${n}`
      *   )
      * )
+     * positiveInt.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -1136,7 +1336,7 @@ export declare const filterMap: {
      *
      * **Example** (Filtering and mapping parsed values)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      * import { Argument } from "effect/unstable/cli"
      *
@@ -1146,6 +1346,7 @@ export declare const filterMap: {
      *     (n) => `Expected positive integer, got ${n}`
      *   )
      * )
+     * positiveInt.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -1158,12 +1359,13 @@ export declare const filterMap: {
  *
  * **Example** (Providing a fallback argument)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const value = Argument.integer("value").pipe(
  *   Argument.orElse(() => Argument.string("value"))
  * )
+ * value.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -1175,12 +1377,13 @@ export declare const orElse: {
      *
      * **Example** (Providing a fallback argument)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const value = Argument.integer("value").pipe(
      *   Argument.orElse(() => Argument.string("value"))
      * )
+     * value.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -1192,12 +1395,13 @@ export declare const orElse: {
      *
      * **Example** (Providing a fallback argument)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const value = Argument.integer("value").pipe(
      *   Argument.orElse(() => Argument.string("value"))
      * )
+     * value.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -1210,13 +1414,14 @@ export declare const orElse: {
  *
  * **Example** (Returning which fallback succeeded)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const source = Argument.file("source").pipe(
  *   Argument.orElseResult(() => Argument.string("url"))
  * )
  * // Returns Result<string, string>
+ * source.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -1228,13 +1433,14 @@ export declare const orElseResult: {
      *
      * **Example** (Returning which fallback succeeded)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const source = Argument.file("source").pipe(
      *   Argument.orElseResult(() => Argument.string("url"))
      * )
      * // Returns Result<string, string>
+     * source.kind // => "argument"
      * ```
      *
      * @category combinators
@@ -1246,13 +1452,14 @@ export declare const orElseResult: {
      *
      * **Example** (Returning which fallback succeeded)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Argument } from "effect/unstable/cli"
      *
      * const source = Argument.file("source").pipe(
      *   Argument.orElseResult(() => Argument.string("url"))
      * )
      * // Returns Result<string, string>
+     * source.kind // => "argument"
      * ```
      *
      * @category combinators