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

package/src/unstable/cli/Argument.ts

@@ -49,10 +49,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
@@ -65,10 +66,11 @@ export const string = (name: string): Argument<string> => Param.string(Param.arg
  *
  * **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
@@ -81,11 +83,12 @@ export const integer = (name: string): Argument<number> => Param.integer(Param.a
  *
  * **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
@@ -100,10 +103,11 @@ export 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
@@ -118,10 +122,11 @@ export 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
@@ -134,10 +139,11 @@ export const float = (name: string): Argument<number> => Param.float(Param.argum
  *
  * **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
@@ -150,10 +156,11 @@ export const date = (name: string): Argument<Date> => Param.date(Param.argumentK
  *
  * **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
@@ -169,10 +176,11 @@ export const choice = <const Choices extends ReadonlyArray<string>>(
  *
  * **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
@@ -188,10 +196,11 @@ export 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
@@ -204,10 +213,11 @@ export const redacted = (name: string): Argument<Redacted.Redacted<string>> => P
  *
  * **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
@@ -226,10 +236,11 @@ export const fileText = (name: string): Argument<string> => Param.fileText(Param
  *
  * **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
@@ -245,7 +256,7 @@ export const fileParse = (
  *
  * **Example** (Validating file content with a schema)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Schema } from "effect"
  * import { Argument } from "effect/unstable/cli"
  *
@@ -255,6 +266,7 @@ export const fileParse = (
  * })
  *
  * const config = Argument.fileSchema("config", ConfigSchema)
+ * config.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -271,11 +283,12 @@ export const fileSchema = <A>(
  *
  * **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
@@ -292,10 +305,11 @@ export const none: Argument<never> = Param.none(Param.argumentKind)
  *
  * **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
@@ -308,12 +322,13 @@ export const optional = <A>(arg: Argument<A>): Argument<Option.Option<A>> => Par
  *
  * **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
@@ -325,12 +340,13 @@ export 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
@@ -342,12 +358,13 @@ export 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
@@ -361,10 +378,11 @@ export 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
@@ -376,10 +394,11 @@ export 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
@@ -391,10 +410,11 @@ export 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
@@ -411,13 +431,14 @@ export 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
@@ -429,13 +450,14 @@ export 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
@@ -447,13 +469,14 @@ export 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
@@ -467,12 +490,13 @@ export 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
@@ -484,12 +508,13 @@ export 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
@@ -501,12 +526,13 @@ export 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
@@ -520,7 +546,7 @@ export const withFallbackPrompt: {
  *
  * **Example** (Accepting multiple values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * // Accept any number of files
@@ -535,6 +561,8 @@ export 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
@@ -546,7 +574,7 @@ export const variadic: {
    *
    * **Example** (Accepting multiple values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Argument } from "effect/unstable/cli"
    *
    * // Accept any number of files
@@ -561,6 +589,8 @@ export 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
@@ -572,7 +602,7 @@ export const variadic: {
    *
    * **Example** (Accepting multiple values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Argument } from "effect/unstable/cli"
    *
    * // Accept any number of files
@@ -587,6 +617,8 @@ export 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
@@ -603,12 +635,13 @@ export 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
@@ -620,12 +653,13 @@ export 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
@@ -637,12 +671,13 @@ export 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
@@ -656,9 +691,27 @@ export 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) =>
@@ -666,11 +719,17 @@ export 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
@@ -682,9 +741,27 @@ export 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) =>
@@ -692,11 +769,17 @@ export 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
@@ -708,9 +791,27 @@ export 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) =>
@@ -718,11 +819,17 @@ export 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
@@ -742,8 +849,27 @@ export 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(
@@ -752,6 +878,11 @@ export 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
@@ -763,8 +894,27 @@ export 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(
@@ -773,6 +923,11 @@ export 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
@@ -784,8 +939,27 @@ export 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(
@@ -794,6 +968,11 @@ export 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
@@ -811,10 +990,11 @@ export 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
@@ -826,10 +1006,11 @@ export 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
@@ -841,10 +1022,11 @@ export 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
@@ -858,10 +1040,11 @@ export 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
@@ -873,10 +1056,11 @@ export 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
@@ -888,10 +1072,11 @@ export 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
@@ -905,10 +1090,11 @@ export 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
@@ -920,10 +1106,11 @@ export 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
@@ -935,10 +1122,11 @@ export 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
@@ -952,13 +1140,14 @@ export 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
@@ -970,13 +1159,14 @@ export 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
@@ -988,13 +1178,14 @@ export 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
@@ -1015,7 +1206,7 @@ export const withSchema: {
  *
  * **Example** (Mapping choices to values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const logLevel = Argument.choiceWithValue("level", [
@@ -1024,6 +1215,7 @@ export const withSchema: {
  *   ["warn", 2],
  *   ["error", 3]
  * ])
+ * logLevel.kind // => "argument"
  * ```
  *
  * @category constructors
@@ -1048,12 +1240,13 @@ export const choiceWithValue = <const Choices extends ReadonlyArray<readonly [st
  *
  * **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
@@ -1074,12 +1267,13 @@ export 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
@@ -1100,12 +1294,13 @@ export 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
@@ -1119,7 +1314,7 @@ export const withMetavar: {
  *
  * **Example** (Filtering parsed values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Argument } from "effect/unstable/cli"
  *
  * const positiveInt = Argument.integer("count").pipe(
@@ -1128,6 +1323,7 @@ export const withMetavar: {
  *     (n) => `Expected positive integer, got ${n}`
  *   )
  * )
+ * positiveInt.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -1139,7 +1335,7 @@ export const filter: {
    *
    * **Example** (Filtering parsed values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Argument } from "effect/unstable/cli"
    *
    * const positiveInt = Argument.integer("count").pipe(
@@ -1148,6 +1344,7 @@ export const filter: {
    *     (n) => `Expected positive integer, got ${n}`
    *   )
    * )
+   * positiveInt.kind // => "argument"
    * ```
    *
    * @category combinators
@@ -1159,7 +1356,7 @@ export const filter: {
    *
    * **Example** (Filtering parsed values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Argument } from "effect/unstable/cli"
    *
    * const positiveInt = Argument.integer("count").pipe(
@@ -1168,6 +1365,7 @@ export const filter: {
    *     (n) => `Expected positive integer, got ${n}`
    *   )
    * )
+   * positiveInt.kind // => "argument"
    * ```
    *
    * @category combinators
@@ -1186,7 +1384,7 @@ export const filter: {
  *
  * **Example** (Filtering and mapping parsed values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  * import { Argument } from "effect/unstable/cli"
  *
@@ -1196,6 +1394,7 @@ export const filter: {
  *     (n) => `Expected positive integer, got ${n}`
  *   )
  * )
+ * positiveInt.kind // => "argument"
  * ```
  *
  * @category combinators
@@ -1208,7 +1407,7 @@ export const filterMap: {
    *
    * **Example** (Filtering and mapping parsed values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    * import { Argument } from "effect/unstable/cli"
    *
@@ -1218,6 +1417,7 @@ export const filterMap: {
    *     (n) => `Expected positive integer, got ${n}`
    *   )
    * )
+   * positiveInt.kind // => "argument"
    * ```
    *
    * @category combinators
@@ -1230,7 +1430,7 @@ export const filterMap: {
    *
    * **Example** (Filtering and mapping parsed values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    * import { Argument } from "effect/unstable/cli"
    *
@@ -1240,6 +1440,7 @@ export const filterMap: {
    *     (n) => `Expected positive integer, got ${n}`
    *   )
    * )
+   * positiveInt.kind // => "argument"
    * ```
    *
    * @category combinators
@@ -1257,12 +1458,13 @@ export 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
@@ -1274,12 +1476,13 @@ export 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
@@ -1291,12 +1494,13 @@ export 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
@@ -1310,13 +1514,14 @@ export 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
@@ -1328,13 +1533,14 @@ export 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
@@ -1346,13 +1552,14 @@ export 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