effect 4.0.0-rc.112 → 4.0.0-rc.113

package/src/unstable/cli/Flag.ts

@@ -14,7 +14,7 @@ import type * as Config from "../../Config.ts"
 import type * as Effect from "../../Effect.ts"
 import { dual, type LazyArg } from "../../Function.ts"
 import type * as Option from "../../Option.ts"
-import type * as Redacted from "../../Redacted.ts"
+import type * as Redacted_ from "../../Redacted.ts"
 import type * as Result from "../../Result.ts"
 import type * as Schema from "../../Schema.ts"
 import type * as CliError from "./CliError.ts"
@@ -46,7 +46,7 @@ export interface Flag<A> extends Param.Param<typeof Param.flagKind, A> {}
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const nameFlag = Flag.string("name")
+ * const nameFlag = Flag.String("name")
  * // Usage: --name "John Doe"
  * nameFlag.kind // => "flag"
  * ```
@@ -54,7 +54,7 @@ export interface Flag<A> extends Param.Param<typeof Param.flagKind, A> {}
  * @category constructors
  * @since 4.0.0
  */
-export const string = (name: string): Flag<string> => Param.string(Param.flagKind, name)
+export const String = (name: string): Flag<string> => Param.String(Param.flagKind, name)
 
 /**
  * Creates a boolean flag that can be enabled or disabled.
@@ -64,7 +64,7 @@ export const string = (name: string): Flag<string> => Param.string(Param.flagKin
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const verboseFlag = Flag.boolean("verbose")
+ * const verboseFlag = Flag.Boolean("verbose")
  * // Usage: --verbose (true) or --no-verbose (false)
  * // Omission fails unless the flag is made optional or given a fallback.
  * verboseFlag.kind // => "flag"
@@ -73,7 +73,7 @@ export const string = (name: string): Flag<string> => Param.string(Param.flagKin
  * @category constructors
  * @since 4.0.0
  */
-export const boolean = (name: string): Flag<boolean> => Param.boolean(Param.flagKind, name)
+export const Boolean = (name: string): Flag<boolean> => Param.Boolean(Param.flagKind, name)
 
 /**
  * Creates an integer flag that accepts whole number input.
@@ -83,7 +83,7 @@ export const boolean = (name: string): Flag<boolean> => Param.boolean(Param.flag
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const portFlag = Flag.integer("port")
+ * const portFlag = Flag.Int("port")
  * // Usage: --port 8080
  * portFlag.kind // => "flag"
  * ```
@@ -91,7 +91,7 @@ export const boolean = (name: string): Flag<boolean> => Param.boolean(Param.flag
  * @category constructors
  * @since 4.0.0
  */
-export const integer = (name: string): Flag<number> => Param.integer(Param.flagKind, name)
+export const Int = (name: string): Flag<number> => Param.Int(Param.flagKind, name)
 
 /**
  * Creates a float flag that accepts decimal number input.
@@ -101,7 +101,7 @@ export const integer = (name: string): Flag<number> => Param.integer(Param.flagK
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const rateFlag = Flag.float("rate")
+ * const rateFlag = Flag.Finite("rate")
  * // Usage: --rate 3.14
  * rateFlag.kind // => "flag"
  * ```
@@ -109,7 +109,7 @@ export const integer = (name: string): Flag<number> => Param.integer(Param.flagK
  * @category constructors
  * @since 4.0.0
  */
-export const float = (name: string): Flag<number> => Param.float(Param.flagKind, name)
+export const Finite = (name: string): Flag<number> => Param.Finite(Param.flagKind, name)
 
 /**
  * Creates a date flag that accepts date input in ISO format.
@@ -119,7 +119,7 @@ export const float = (name: string): Flag<number> => Param.float(Param.flagKind,
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const startDateFlag = Flag.date("start-date")
+ * const startDateFlag = Flag.Date("start-date")
  * // Usage: --start-date 2023-12-25
  * startDateFlag.kind // => "flag"
  * ```
@@ -127,7 +127,7 @@ export const float = (name: string): Flag<number> => Param.float(Param.flagKind,
  * @category constructors
  * @since 4.0.0
  */
-export const date = (name: string): Flag<Date> => Param.date(Param.flagKind, name)
+export const Date = (name: string): Flag<globalThis.Date> => Param.Date(Param.flagKind, name)
 
 /**
  * Constructs option parameters that represent a choice between several inputs.
@@ -139,10 +139,10 @@ export const date = (name: string): Flag<Date> => Param.date(Param.flagKind, nam
  * import { Flag } from "effect/unstable/cli"
  *
  * // simple enum like choice mapping directly to string union
- * const color = Flag.choice("color", ["red", "green", "blue"])
+ * const color = Flag.Literals("color", ["red", "green", "blue"])
  *
  * // choice with custom value mapping
- * const logLevel = Flag.choiceWithValue("log-level", [
+ * const logLevel = Flag.ChoiceWithValue("log-level", [
  *   ["debug", "Debug" as const],
  *   ["info", "Info" as const],
  *   ["error", "Error" as const]
@@ -153,33 +153,23 @@ export const date = (name: string): Flag<Date> => Param.date(Param.flagKind, nam
  * @category constructors
  * @since 4.0.0
  */
-export const choiceWithValue = <const Choice extends ReadonlyArray<readonly [string, any]>>(
+export const ChoiceWithValue = <const Choice extends ReadonlyArray<readonly [string, any]>>(
   name: string,
   choices: Choice
-): Flag<Choice[number][1]> => Param.choiceWithValue(Param.flagKind, name, choices)
+): Flag<Choice[number][1]> => Param.ChoiceWithValue(Param.flagKind, name, choices)
 
 /**
- * Creates a flag that accepts one of the provided string choices and returns
- * the selected string.
+ * Accepts one of the provided strings. An empty array rejects all input.
  *
- * **When to use**
- *
- * Use when you need to define a named CLI flag with fixed string choices and no
- * custom value mapping.
- *
- * **Gotchas**
- *
- * An empty choices array compiles, but no input value can parse successfully.
- *
- * @see {@link choiceWithValue} for mapping accepted strings to different typed values
+ * @see {@link ChoiceWithValue} for mapping accepted strings to different typed values
  *
  * @category constructors
  * @since 4.0.0
  */
-export const choice = <const Choices extends ReadonlyArray<string>>(
+export const Literals = <const Literals extends ReadonlyArray<string>>(
   name: string,
-  choices: Choices
-): Flag<Choices[number]> => Param.choice(Param.flagKind, name, choices)
+  literals: Literals
+): Flag<Literals[number]> => Param.Literals(Param.flagKind, name, literals)
 
 /**
  * Creates a path flag that accepts file system path input with validation options.
@@ -190,16 +180,16 @@ export const choice = <const Choices extends ReadonlyArray<string>>(
  * import { Flag } from "effect/unstable/cli"
  *
  * // Basic path flag
- * const pathFlag = Flag.path("config-path")
+ * const pathFlag = Flag.Path("config-path")
  *
  * // File-only path that must exist
- * const fileFlag = Flag.path("input-file", {
+ * const fileFlag = Flag.Path("input-file", {
  *   pathType: "file",
  *   mustExist: true
  * })
  *
  * // Directory path with custom type name
- * const dirFlag = Flag.path("output-dir", {
+ * const dirFlag = Flag.Path("output-dir", {
  *   pathType: "directory",
  *   typeName: "OUTPUT_DIRECTORY"
  * })
@@ -209,11 +199,11 @@ export const choice = <const Choices extends ReadonlyArray<string>>(
  * @category constructors
  * @since 4.0.0
  */
-export const path = (name: string, options?: {
+export const Path = (name: string, options?: {
   readonly pathType?: "file" | "directory" | "either" | undefined
   readonly mustExist?: boolean | undefined
   readonly typeName?: string | undefined
-}): Flag<string> => Param.path(Param.flagKind, name, options)
+}): Flag<string> => Param.Path(Param.flagKind, name, options)
 
 /**
  * Creates a file path flag that accepts file paths with optional existence validation.
@@ -224,11 +214,11 @@ export const path = (name: string, options?: {
  * import { Flag } from "effect/unstable/cli"
  *
  * // Basic file flag
- * const inputFlag = Flag.file("input")
+ * const inputFlag = Flag.File("input")
  * // Usage: --input ./data.json
  *
  * // File that must exist
- * const configFlag = Flag.file("config", { mustExist: true })
+ * const configFlag = Flag.File("config", { mustExist: true })
  * // Usage: --config ./config.yaml (file must exist)
  * const kinds = [inputFlag.kind, configFlag.kind] // => ["flag", "flag"]
  * ```
@@ -236,9 +226,9 @@ export const path = (name: string, options?: {
  * @category constructors
  * @since 4.0.0
  */
-export const file = (name: string, options?: {
+export const File = (name: string, options?: {
   readonly mustExist?: boolean | undefined
-}): Flag<string> => Param.file(Param.flagKind, name, options)
+}): Flag<string> => Param.File(Param.flagKind, name, options)
 
 /**
  * Creates a directory path flag that accepts directory paths with optional existence validation.
@@ -249,11 +239,11 @@ export const file = (name: string, options?: {
  * import { Flag } from "effect/unstable/cli"
  *
  * // Basic directory flag
- * const outputFlag = Flag.directory("output")
+ * const outputFlag = Flag.Directory("output")
  * // Usage: --output ./build
  *
  * // Directory that must exist
- * const sourceFlag = Flag.directory("source", { mustExist: true })
+ * const sourceFlag = Flag.Directory("source", { mustExist: true })
  * // Usage: --source ./src (directory must exist)
  * const kinds = [outputFlag.kind, sourceFlag.kind] // => ["flag", "flag"]
  * ```
@@ -261,9 +251,9 @@ export const file = (name: string, options?: {
  * @category constructors
  * @since 4.0.0
  */
-export const directory = (name: string, options?: {
+export const Directory = (name: string, options?: {
   readonly mustExist?: boolean | undefined
-}): Flag<string> => Param.directory(Param.flagKind, name, options)
+}): Flag<string> => Param.Directory(Param.flagKind, name, options)
 
 /**
  * Creates a string flag whose parsed value is wrapped in `Redacted.Redacted` so
@@ -298,7 +288,7 @@ export const directory = (name: string, options?: {
  *   )
  * )
  *
- * const passwordFlag = Flag.redacted("password")
+ * const passwordFlag = Flag.Redacted("password")
  *
  * const program = Effect.gen(function*() {
  *   const [, password] = yield* passwordFlag.parse({
@@ -314,7 +304,7 @@ export const directory = (name: string, options?: {
  * @category constructors
  * @since 4.0.0
  */
-export const redacted = (name: string): Flag<Redacted.Redacted<string>> => Param.redacted(Param.flagKind, name)
+export const Redacted = (name: string): Flag<Redacted_.Redacted<string>> => Param.Redacted(Param.flagKind, name)
 
 /**
  * Creates a flag that reads and returns file content as a string.
@@ -324,7 +314,7 @@ export const redacted = (name: string): Flag<Redacted.Redacted<string>> => Param
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const config = Flag.fileText("config-file")
+ * const config = Flag.FileText("config-file")
  * // --config-file ./app.json will read the file content
  * config.kind // => "flag"
  * ```
@@ -332,7 +322,7 @@ export const redacted = (name: string): Flag<Redacted.Redacted<string>> => Param
  * @category constructors
  * @since 4.0.0
  */
-export const fileText = (name: string): Flag<string> => Param.fileText(Param.flagKind, name)
+export const FileText = (name: string): Flag<string> => Param.FileText(Param.flagKind, name)
 
 /**
  * Creates a flag that reads and parses the content of the specified file.
@@ -349,20 +339,20 @@ export const fileText = (name: string): Flag<string> => Param.fileText(Param.fla
  *
  * // Will use the extension of the file passed on the command line to determine
  * // the parser to use
- * const config = Flag.fileParse("config")
+ * const config = Flag.FileParse("config")
  *
  * // Will use the JSON parser
- * const jsonConfig = Flag.fileParse("json-config", { format: "json" })
+ * const jsonConfig = Flag.FileParse("json-config", { format: "json" })
  * const kinds = [config.kind, jsonConfig.kind] // => ["flag", "flag"]
  * ```
  *
  * @category constructors
  * @since 4.0.0
  */
-export const fileParse = (
+export const FileParse = (
   name: string,
   options?: Primitive.FileParseOptions | undefined
-): Flag<unknown> => Param.fileParse(Param.flagKind, name, options)
+): Flag<unknown> => Param.FileParse(Param.flagKind, name, options)
 
 /**
  * Creates a flag that reads and validates file content using the specified
@@ -379,18 +369,18 @@ export const fileParse = (
  *   host: Schema.String
  * })
  *
- * const config = Flag.fileSchema("config", ConfigSchema, { format: "json" })
+ * const config = Flag.FileSchema("config", ConfigSchema, { format: "json" })
  * config.kind // => "flag"
  * ```
  *
  * @category constructors
  * @since 4.0.0
  */
-export const fileSchema = <A>(
+export const FileSchema = <A>(
   name: string,
   schema: Schema.ConstraintDecoder<A, Environment>,
   options?: Primitive.FileSchemaOptions | undefined
-): Flag<A> => Param.fileSchema(Param.flagKind, name, schema, options)
+): Flag<A> => Param.FileSchema(Param.flagKind, name, schema, options)
 
 /**
  * Creates a flag that parses key=value pairs.
@@ -410,7 +400,7 @@ export const fileSchema = <A>(
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const env = Flag.keyValuePair("env")
+ * const env = Flag.KeyValuePair("env")
  * // --env FOO=bar --env BAZ=qux will parse to { FOO: "bar", BAZ: "qux" }
  * env.kind // => "flag"
  * ```
@@ -418,11 +408,10 @@ export const fileSchema = <A>(
  * @category constructors
  * @since 4.0.0
  */
-export const keyValuePair = (name: string): Flag<Record<string, string>> => Param.keyValuePair(Param.flagKind, name)
+export const KeyValuePair = (name: string): Flag<Record<string, string>> => Param.KeyValuePair(Param.flagKind, name)
 
 /**
- * Creates an empty sentinel flag that always fails to parse.
- * This is useful for creating placeholder flags or for combinators.
+ * A flag that always fails to parse.
  *
  * **Example** (Creating sentinel flags)
  *
@@ -430,16 +419,16 @@ export const keyValuePair = (name: string): Flag<Record<string, string>> => Para
  * import { Flag } from "effect/unstable/cli"
  *
  * const makeValueFlag = (includeValue: boolean) =>
- *   includeValue ? Flag.string("value") : Flag.none
+ *   includeValue ? Flag.String("value") : Flag.Never
  *
- * makeValueFlag(true) === Flag.none // => false
- * makeValueFlag(false) === Flag.none // => true
+ * makeValueFlag(true) === Flag.Never // => false
+ * makeValueFlag(false) === Flag.Never // => true
  * ```
  *
  * @category constructors
  * @since 4.0.0
  */
-export const none: Flag<never> = Param.none(Param.flagKind)
+export const Never: Flag<never> = Param.Never(Param.flagKind)
 
 // -------------------------------------------------------------------------------------
 // combinators
@@ -454,12 +443,12 @@ export const none: Flag<never> = Param.none(Param.flagKind)
  * import { Flag } from "effect/unstable/cli"
  *
  * // Flag can be used as both --verbose and -v
- * const verboseFlag = Flag.boolean("verbose").pipe(
+ * const verboseFlag = Flag.Boolean("verbose").pipe(
  *   Flag.withAlias("v")
  * )
  *
  * // Multiple aliases can be chained
- * const helpFlag = Flag.boolean("help").pipe(
+ * const helpFlag = Flag.Boolean("help").pipe(
  *   Flag.withAlias("h"),
  *   Flag.withAlias("?")
  * )
@@ -483,12 +472,12 @@ export const withAlias: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Flag can be used as both --verbose and -v
-   * const verboseFlag = Flag.boolean("verbose").pipe(
+   * const verboseFlag = Flag.Boolean("verbose").pipe(
    *   Flag.withAlias("v")
    * )
    *
    * // Multiple aliases can be chained
-   * const helpFlag = Flag.boolean("help").pipe(
+   * const helpFlag = Flag.Boolean("help").pipe(
    *   Flag.withAlias("h"),
    *   Flag.withAlias("?")
    * )
@@ -512,12 +501,12 @@ export const withAlias: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Flag can be used as both --verbose and -v
-   * const verboseFlag = Flag.boolean("verbose").pipe(
+   * const verboseFlag = Flag.Boolean("verbose").pipe(
    *   Flag.withAlias("v")
    * )
    *
    * // Multiple aliases can be chained
-   * const helpFlag = Flag.boolean("help").pipe(
+   * const helpFlag = Flag.Boolean("help").pipe(
    *   Flag.withAlias("h"),
    *   Flag.withAlias("?")
    * )
@@ -538,11 +527,11 @@ export const withAlias: {
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const portFlag = Flag.integer("port").pipe(
+ * const portFlag = Flag.Int("port").pipe(
  *   Flag.withDescription("The port number to listen on")
  * )
  *
- * const configFlag = Flag.file("config").pipe(
+ * const configFlag = Flag.File("config").pipe(
  *   Flag.withDescription("Path to the configuration file")
  * )
  * const kinds = [portFlag.kind, configFlag.kind] // => ["flag", "flag"]
@@ -560,11 +549,11 @@ export const withDescription: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const portFlag = Flag.integer("port").pipe(
+   * const portFlag = Flag.Int("port").pipe(
    *   Flag.withDescription("The port number to listen on")
    * )
    *
-   * const configFlag = Flag.file("config").pipe(
+   * const configFlag = Flag.File("config").pipe(
    *   Flag.withDescription("Path to the configuration file")
    * )
    * const kinds = [portFlag.kind, configFlag.kind] // => ["flag", "flag"]
@@ -582,11 +571,11 @@ export const withDescription: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const portFlag = Flag.integer("port").pipe(
+   * const portFlag = Flag.Int("port").pipe(
    *   Flag.withDescription("The port number to listen on")
    * )
    *
-   * const configFlag = Flag.file("config").pipe(
+   * const configFlag = Flag.File("config").pipe(
    *   Flag.withDescription("Path to the configuration file")
    * )
    * const kinds = [portFlag.kind, configFlag.kind] // => ["flag", "flag"]
@@ -615,13 +604,13 @@ export const withDescription: {
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const databaseFlag = Flag.string("database-url").pipe(
+ * const databaseFlag = Flag.String("database-url").pipe(
  *   Flag.withMetavar("URL"),
  *   Flag.withDescription("Database connection URL")
  * )
  * // In help: --database-url URL
  *
- * const timeoutFlag = Flag.integer("timeout").pipe(
+ * const timeoutFlag = Flag.Int("timeout").pipe(
  *   Flag.withMetavar("SECONDS")
  * )
  * // In help: --timeout SECONDS
@@ -649,13 +638,13 @@ export const withMetavar: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const databaseFlag = Flag.string("database-url").pipe(
+   * const databaseFlag = Flag.String("database-url").pipe(
    *   Flag.withMetavar("URL"),
    *   Flag.withDescription("Database connection URL")
    * )
    * // In help: --database-url URL
    *
-   * const timeoutFlag = Flag.integer("timeout").pipe(
+   * const timeoutFlag = Flag.Int("timeout").pipe(
    *   Flag.withMetavar("SECONDS")
    * )
    * // In help: --timeout SECONDS
@@ -683,13 +672,13 @@ export const withMetavar: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const databaseFlag = Flag.string("database-url").pipe(
+   * const databaseFlag = Flag.String("database-url").pipe(
    *   Flag.withMetavar("URL"),
    *   Flag.withDescription("Database connection URL")
    * )
    * // In help: --database-url URL
    *
-   * const timeoutFlag = Flag.integer("timeout").pipe(
+   * const timeoutFlag = Flag.Int("timeout").pipe(
    *   Flag.withMetavar("SECONDS")
    * )
    * // In help: --timeout SECONDS
@@ -718,7 +707,7 @@ export const withMetavar: {
  * import { Flag } from "effect/unstable/cli"
  *
  * // Flag still parses --experimental-foo, but it does not appear in --help.
- * const experimental = Flag.boolean("experimental-foo").pipe(
+ * const experimental = Flag.Boolean("experimental-foo").pipe(
  *   Flag.withHidden
  * )
  * experimental.kind // => "flag"
@@ -756,7 +745,7 @@ export const withHidden = <A>(self: Flag<A>): Flag<A> => Param.withHidden(self)
  *   )
  * )
  *
- * const optionalPort = Flag.optional(Flag.integer("port"))
+ * const optionalPort = Flag.optional(Flag.Int("port"))
  *
  * const program = Effect.gen(function*() {
  *   const [, port] = yield* optionalPort.parse({
@@ -782,12 +771,12 @@ export const optional = <A>(param: Flag<A>): Flag<Option.Option<A>> => Param.opt
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const portFlag = Flag.integer("port").pipe(
+ * const portFlag = Flag.Int("port").pipe(
  *   Flag.withDefault(8080)
  * )
  * // If --port is not provided, defaults to 8080
  *
- * const hostFlag = Flag.string("host").pipe(
+ * const hostFlag = Flag.String("host").pipe(
  *   Flag.withDefault("localhost")
  * )
  * // If --host is not provided, defaults to "localhost"
@@ -806,12 +795,12 @@ export const withDefault: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const portFlag = Flag.integer("port").pipe(
+   * const portFlag = Flag.Int("port").pipe(
    *   Flag.withDefault(8080)
    * )
    * // If --port is not provided, defaults to 8080
    *
-   * const hostFlag = Flag.string("host").pipe(
+   * const hostFlag = Flag.String("host").pipe(
    *   Flag.withDefault("localhost")
    * )
    * // If --host is not provided, defaults to "localhost"
@@ -830,12 +819,12 @@ export const withDefault: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const portFlag = Flag.integer("port").pipe(
+   * const portFlag = Flag.Int("port").pipe(
    *   Flag.withDefault(8080)
    * )
    * // If --port is not provided, defaults to 8080
    *
-   * const hostFlag = Flag.string("host").pipe(
+   * const hostFlag = Flag.String("host").pipe(
    *   Flag.withDefault("localhost")
    * )
    * // If --host is not provided, defaults to "localhost"
@@ -860,8 +849,8 @@ export const withDefault: {
  * import { Config } from "effect"
  * import { Flag } from "effect/unstable/cli"
  *
- * const verbose = Flag.boolean("verbose").pipe(
- *   Flag.withFallbackConfig(Config.boolean("VERBOSE"))
+ * const verbose = Flag.Boolean("verbose").pipe(
+ *   Flag.withFallbackConfig(Config.Boolean("VERBOSE"))
  * )
  * verbose.kind // => "flag"
  * ```
@@ -879,8 +868,8 @@ export const withFallbackConfig: {
    * import { Config } from "effect"
    * import { Flag } from "effect/unstable/cli"
    *
-   * const verbose = Flag.boolean("verbose").pipe(
-   *   Flag.withFallbackConfig(Config.boolean("VERBOSE"))
+   * const verbose = Flag.Boolean("verbose").pipe(
+   *   Flag.withFallbackConfig(Config.Boolean("VERBOSE"))
    * )
    * verbose.kind // => "flag"
    * ```
@@ -898,8 +887,8 @@ export const withFallbackConfig: {
    * import { Config } from "effect"
    * import { Flag } from "effect/unstable/cli"
    *
-   * const verbose = Flag.boolean("verbose").pipe(
-   *   Flag.withFallbackConfig(Config.boolean("VERBOSE"))
+   * const verbose = Flag.Boolean("verbose").pipe(
+   *   Flag.withFallbackConfig(Config.Boolean("VERBOSE"))
    * )
    * verbose.kind // => "flag"
    * ```
@@ -918,8 +907,8 @@ export const withFallbackConfig: {
  * ```ts import.meta.vitest
  * import { Flag, Prompt } from "effect/unstable/cli"
  *
- * const name = Flag.string("name").pipe(
- *   Flag.withFallbackPrompt(Prompt.text({ message: "Name" }))
+ * const name = Flag.String("name").pipe(
+ *   Flag.withFallbackPrompt(Prompt.String({ message: "Name" }))
  * )
  * name.kind // => "flag"
  * ```
@@ -936,8 +925,8 @@ export const withFallbackPrompt: {
    * ```ts import.meta.vitest
    * import { Flag, Prompt } from "effect/unstable/cli"
    *
-   * const name = Flag.string("name").pipe(
-   *   Flag.withFallbackPrompt(Prompt.text({ message: "Name" }))
+   * const name = Flag.String("name").pipe(
+   *   Flag.withFallbackPrompt(Prompt.String({ message: "Name" }))
    * )
    * name.kind // => "flag"
    * ```
@@ -954,8 +943,8 @@ export const withFallbackPrompt: {
    * ```ts import.meta.vitest
    * import { Flag, Prompt } from "effect/unstable/cli"
    *
-   * const name = Flag.string("name").pipe(
-   *   Flag.withFallbackPrompt(Prompt.text({ message: "Name" }))
+   * const name = Flag.String("name").pipe(
+   *   Flag.withFallbackPrompt(Prompt.String({ message: "Name" }))
    * )
    * name.kind // => "flag"
    * ```
@@ -975,12 +964,12 @@ export const withFallbackPrompt: {
  * import { Flag } from "effect/unstable/cli"
  *
  * // Convert string to uppercase
- * const nameFlag = Flag.string("name").pipe(
+ * const nameFlag = Flag.String("name").pipe(
  *   Flag.map((name) => name.toUpperCase())
  * )
  *
  * // Convert port to URL
- * const urlFlag = Flag.integer("port").pipe(
+ * const urlFlag = Flag.Int("port").pipe(
  *   Flag.map((port) => `http://localhost:${port}`)
  * )
  * const kinds = [nameFlag.kind, urlFlag.kind] // => ["flag", "flag"]
@@ -999,12 +988,12 @@ export const map: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Convert string to uppercase
-   * const nameFlag = Flag.string("name").pipe(
+   * const nameFlag = Flag.String("name").pipe(
    *   Flag.map((name) => name.toUpperCase())
    * )
    *
    * // Convert port to URL
-   * const urlFlag = Flag.integer("port").pipe(
+   * const urlFlag = Flag.Int("port").pipe(
    *   Flag.map((port) => `http://localhost:${port}`)
    * )
    * const kinds = [nameFlag.kind, urlFlag.kind] // => ["flag", "flag"]
@@ -1023,12 +1012,12 @@ export const map: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Convert string to uppercase
-   * const nameFlag = Flag.string("name").pipe(
+   * const nameFlag = Flag.String("name").pipe(
    *   Flag.map((name) => name.toUpperCase())
    * )
    *
    * // Convert port to URL
-   * const urlFlag = Flag.integer("port").pipe(
+   * const urlFlag = Flag.Int("port").pipe(
    *   Flag.map((port) => `http://localhost:${port}`)
    * )
    * const kinds = [nameFlag.kind, urlFlag.kind] // => ["flag", "flag"]
@@ -1067,7 +1056,7 @@ export const map: {
  *   )
  * )
  *
- * const upperName = Flag.string("name").pipe(
+ * const upperName = Flag.String("name").pipe(
  *   Flag.mapEffect((name) => Effect.succeed(name.toUpperCase()))
  * )
  *
@@ -1111,7 +1100,7 @@ export const mapEffect: {
    *   )
    * )
    *
-   * const upperName = Flag.string("name").pipe(
+   * const upperName = Flag.String("name").pipe(
    *   Flag.mapEffect((name) => Effect.succeed(name.toUpperCase()))
    * )
    *
@@ -1155,7 +1144,7 @@ export const mapEffect: {
    *   )
    * )
    *
-   * const upperName = Flag.string("name").pipe(
+   * const upperName = Flag.String("name").pipe(
    *   Flag.mapEffect((name) => Effect.succeed(name.toUpperCase()))
    * )
    *
@@ -1208,7 +1197,7 @@ export const mapEffect: {
  * )
  *
  * // Parse JSON string with error handling
- * const jsonFlag = Flag.string("config").pipe(
+ * const jsonFlag = Flag.String("config").pipe(
  *   Flag.mapTryCatch(
  *     (json) => JSON.parse(json),
  *     (error) => `Invalid JSON: ${error}`
@@ -1216,7 +1205,7 @@ export const mapEffect: {
  * )
  *
  * // Parse URL with error handling
- * const urlFlag = Flag.string("url").pipe(
+ * const urlFlag = Flag.String("url").pipe(
  *   Flag.mapTryCatch(
  *     (url) => new URL(url),
  *     (error) => `Invalid URL: ${error}`
@@ -1264,7 +1253,7 @@ export const mapTryCatch: {
    * )
    *
    * // Parse JSON string with error handling
-   * const jsonFlag = Flag.string("config").pipe(
+   * const jsonFlag = Flag.String("config").pipe(
    *   Flag.mapTryCatch(
    *     (json) => JSON.parse(json),
    *     (error) => `Invalid JSON: ${error}`
@@ -1272,7 +1261,7 @@ export const mapTryCatch: {
    * )
    *
    * // Parse URL with error handling
-   * const urlFlag = Flag.string("url").pipe(
+   * const urlFlag = Flag.String("url").pipe(
    *   Flag.mapTryCatch(
    *     (url) => new URL(url),
    *     (error) => `Invalid URL: ${error}`
@@ -1320,7 +1309,7 @@ export const mapTryCatch: {
    * )
    *
    * // Parse JSON string with error handling
-   * const jsonFlag = Flag.string("config").pipe(
+   * const jsonFlag = Flag.String("config").pipe(
    *   Flag.mapTryCatch(
    *     (json) => JSON.parse(json),
    *     (error) => `Invalid JSON: ${error}`
@@ -1328,7 +1317,7 @@ export const mapTryCatch: {
    * )
    *
    * // Parse URL with error handling
-   * const urlFlag = Flag.string("url").pipe(
+   * const urlFlag = Flag.String("url").pipe(
    *   Flag.mapTryCatch(
    *     (url) => new URL(url),
    *     (error) => `Invalid URL: ${error}`
@@ -1362,11 +1351,11 @@ export const mapTryCatch: {
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const sourceFlag = Flag.atLeast(Flag.file("source"), 2)
+ * const sourceFlag = Flag.atLeast(Flag.File("source"), 2)
  * // Requires at least 2 source files
  * // Usage: --source file1.ts --source file2.ts
  *
- * const tagFlag = Flag.string("tag").pipe(
+ * const tagFlag = Flag.String("tag").pipe(
  *   Flag.atLeast(1)
  * )
  * // Requires at least 1 tag
@@ -1385,11 +1374,11 @@ export const atLeast: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const sourceFlag = Flag.atLeast(Flag.file("source"), 2)
+   * const sourceFlag = Flag.atLeast(Flag.File("source"), 2)
    * // Requires at least 2 source files
    * // Usage: --source file1.ts --source file2.ts
    *
-   * const tagFlag = Flag.string("tag").pipe(
+   * const tagFlag = Flag.String("tag").pipe(
    *   Flag.atLeast(1)
    * )
    * // Requires at least 1 tag
@@ -1408,11 +1397,11 @@ export const atLeast: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const sourceFlag = Flag.atLeast(Flag.file("source"), 2)
+   * const sourceFlag = Flag.atLeast(Flag.File("source"), 2)
    * // Requires at least 2 source files
    * // Usage: --source file1.ts --source file2.ts
    *
-   * const tagFlag = Flag.string("tag").pipe(
+   * const tagFlag = Flag.String("tag").pipe(
    *   Flag.atLeast(1)
    * )
    * // Requires at least 1 tag
@@ -1433,11 +1422,11 @@ export const atLeast: {
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const warningFlag = Flag.atMost(Flag.string("warning"), 3)
+ * const warningFlag = Flag.atMost(Flag.String("warning"), 3)
  * // Allows up to 3 warning flags
  * // Usage: --warning w1 --warning w2 --warning w3
  *
- * const debugFlag = Flag.string("debug").pipe(
+ * const debugFlag = Flag.String("debug").pipe(
  *   Flag.atMost(1)
  * )
  * // Allows at most 1 debug flag
@@ -1456,11 +1445,11 @@ export const atMost: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const warningFlag = Flag.atMost(Flag.string("warning"), 3)
+   * const warningFlag = Flag.atMost(Flag.String("warning"), 3)
    * // Allows up to 3 warning flags
    * // Usage: --warning w1 --warning w2 --warning w3
    *
-   * const debugFlag = Flag.string("debug").pipe(
+   * const debugFlag = Flag.String("debug").pipe(
    *   Flag.atMost(1)
    * )
    * // Allows at most 1 debug flag
@@ -1479,11 +1468,11 @@ export const atMost: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const warningFlag = Flag.atMost(Flag.string("warning"), 3)
+   * const warningFlag = Flag.atMost(Flag.String("warning"), 3)
    * // Allows up to 3 warning flags
    * // Usage: --warning w1 --warning w2 --warning w3
    *
-   * const debugFlag = Flag.string("debug").pipe(
+   * const debugFlag = Flag.String("debug").pipe(
    *   Flag.atMost(1)
    * )
    * // Allows at most 1 debug flag
@@ -1504,11 +1493,11 @@ export const atMost: {
  * ```ts import.meta.vitest
  * import { Flag } from "effect/unstable/cli"
  *
- * const hostFlag = Flag.between(Flag.string("host"), 1, 3)
+ * const hostFlag = Flag.between(Flag.String("host"), 1, 3)
  * // Requires 1-3 host flags
  * // Usage: --host host1 --host host2
  *
- * const excludeFlag = Flag.string("exclude").pipe(
+ * const excludeFlag = Flag.String("exclude").pipe(
  *   Flag.between(0, 5)
  * )
  * // Allows 0-5 exclude patterns
@@ -1527,11 +1516,11 @@ export const between: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const hostFlag = Flag.between(Flag.string("host"), 1, 3)
+   * const hostFlag = Flag.between(Flag.String("host"), 1, 3)
    * // Requires 1-3 host flags
    * // Usage: --host host1 --host host2
    *
-   * const excludeFlag = Flag.string("exclude").pipe(
+   * const excludeFlag = Flag.String("exclude").pipe(
    *   Flag.between(0, 5)
    * )
    * // Allows 0-5 exclude patterns
@@ -1550,11 +1539,11 @@ export const between: {
    * ```ts import.meta.vitest
    * import { Flag } from "effect/unstable/cli"
    *
-   * const hostFlag = Flag.between(Flag.string("host"), 1, 3)
+   * const hostFlag = Flag.between(Flag.String("host"), 1, 3)
    * // Requires 1-3 host flags
    * // Usage: --host host1 --host host2
    *
-   * const excludeFlag = Flag.string("exclude").pipe(
+   * const excludeFlag = Flag.String("exclude").pipe(
    *   Flag.between(0, 5)
    * )
    * // Allows 0-5 exclude patterns
@@ -1577,7 +1566,7 @@ export const between: {
  * import { Flag } from "effect/unstable/cli"
  *
  * // Parse positive integers only
- * const positiveInt = Flag.integer("count").pipe(
+ * const positiveInt = Flag.Int("count").pipe(
  *   Flag.filterMap(
  *     (n) => n > 0 ? Option.some(n) : Option.none(),
  *     (n) => `Expected positive integer, got ${n}`
@@ -1585,7 +1574,7 @@ export const between: {
  * )
  *
  * // Parse valid email addresses
- * const emailFlag = Flag.string("email").pipe(
+ * const emailFlag = Flag.String("email").pipe(
  *   Flag.filterMap(
  *     (email) => email.includes("@") ? Option.some(email) : Option.none(),
  *     (email) => `Invalid email address: ${email}`
@@ -1608,7 +1597,7 @@ export const filterMap: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Parse positive integers only
-   * const positiveInt = Flag.integer("count").pipe(
+   * const positiveInt = Flag.Int("count").pipe(
    *   Flag.filterMap(
    *     (n) => n > 0 ? Option.some(n) : Option.none(),
    *     (n) => `Expected positive integer, got ${n}`
@@ -1616,7 +1605,7 @@ export const filterMap: {
    * )
    *
    * // Parse valid email addresses
-   * const emailFlag = Flag.string("email").pipe(
+   * const emailFlag = Flag.String("email").pipe(
    *   Flag.filterMap(
    *     (email) => email.includes("@") ? Option.some(email) : Option.none(),
    *     (email) => `Invalid email address: ${email}`
@@ -1639,7 +1628,7 @@ export const filterMap: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Parse positive integers only
-   * const positiveInt = Flag.integer("count").pipe(
+   * const positiveInt = Flag.Int("count").pipe(
    *   Flag.filterMap(
    *     (n) => n > 0 ? Option.some(n) : Option.none(),
    *     (n) => `Expected positive integer, got ${n}`
@@ -1647,7 +1636,7 @@ export const filterMap: {
    * )
    *
    * // Parse valid email addresses
-   * const emailFlag = Flag.string("email").pipe(
+   * const emailFlag = Flag.String("email").pipe(
    *   Flag.filterMap(
    *     (email) => email.includes("@") ? Option.some(email) : Option.none(),
    *     (email) => `Invalid email address: ${email}`
@@ -1675,7 +1664,7 @@ export const filterMap: {
  * import { Flag } from "effect/unstable/cli"
  *
  * // Ensure port is in valid range
- * const portFlag = Flag.integer("port").pipe(
+ * const portFlag = Flag.Int("port").pipe(
  *   Flag.filter(
  *     (port) => port >= 1 && port <= 65535,
  *     (port) => `Port ${port} is out of range (1-65535)`
@@ -1683,7 +1672,7 @@ export const filterMap: {
  * )
  *
  * // Ensure non-empty string
- * const nameFlag = Flag.string("name").pipe(
+ * const nameFlag = Flag.String("name").pipe(
  *   Flag.filter(
  *     (name) => name.trim().length > 0,
  *     () => "Name cannot be empty"
@@ -1705,7 +1694,7 @@ export const filter: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Ensure port is in valid range
-   * const portFlag = Flag.integer("port").pipe(
+   * const portFlag = Flag.Int("port").pipe(
    *   Flag.filter(
    *     (port) => port >= 1 && port <= 65535,
    *     (port) => `Port ${port} is out of range (1-65535)`
@@ -1713,7 +1702,7 @@ export const filter: {
    * )
    *
    * // Ensure non-empty string
-   * const nameFlag = Flag.string("name").pipe(
+   * const nameFlag = Flag.String("name").pipe(
    *   Flag.filter(
    *     (name) => name.trim().length > 0,
    *     () => "Name cannot be empty"
@@ -1735,7 +1724,7 @@ export const filter: {
    * import { Flag } from "effect/unstable/cli"
    *
    * // Ensure port is in valid range
-   * const portFlag = Flag.integer("port").pipe(
+   * const portFlag = Flag.Int("port").pipe(
    *   Flag.filter(
    *     (port) => port >= 1 && port <= 65535,
    *     (port) => `Port ${port} is out of range (1-65535)`
@@ -1743,7 +1732,7 @@ export const filter: {
    * )
    *
    * // Ensure non-empty string
-   * const nameFlag = Flag.string("name").pipe(
+   * const nameFlag = Flag.String("name").pipe(
    *   Flag.filter(
    *     (name) => name.trim().length > 0,
    *     () => "Name cannot be empty"
@@ -1772,14 +1761,14 @@ export const filter: {
  *
  * // Try parsing as integer, fallback to string
  * const valueFlag = Flag.orElse(
- *   Flag.integer("value"),
- *   () => Flag.string("value")
+ *   Flag.Int("value"),
+ *   () => Flag.String("value")
  * )
  *
  * // Multiple input sources with fallback
  * const configFlag = Flag.orElse(
- *   Flag.file("config"),
- *   () => Flag.string("config-url")
+ *   Flag.File("config"),
+ *   () => Flag.String("config-url")
  * )
  * const kinds = [valueFlag.kind, configFlag.kind] // => ["flag", "flag"]
  * ```
@@ -1798,14 +1787,14 @@ export const orElse: {
    *
    * // Try parsing as integer, fallback to string
    * const valueFlag = Flag.orElse(
-   *   Flag.integer("value"),
-   *   () => Flag.string("value")
+   *   Flag.Int("value"),
+   *   () => Flag.String("value")
    * )
    *
    * // Multiple input sources with fallback
    * const configFlag = Flag.orElse(
-   *   Flag.file("config"),
-   *   () => Flag.string("config-url")
+   *   Flag.File("config"),
+   *   () => Flag.String("config-url")
    * )
    * const kinds = [valueFlag.kind, configFlag.kind] // => ["flag", "flag"]
    * ```
@@ -1824,14 +1813,14 @@ export const orElse: {
    *
    * // Try parsing as integer, fallback to string
    * const valueFlag = Flag.orElse(
-   *   Flag.integer("value"),
-   *   () => Flag.string("value")
+   *   Flag.Int("value"),
+   *   () => Flag.String("value")
    * )
    *
    * // Multiple input sources with fallback
    * const configFlag = Flag.orElse(
-   *   Flag.file("config"),
-   *   () => Flag.string("config-url")
+   *   Flag.File("config"),
+   *   () => Flag.String("config-url")
    * )
    * const kinds = [valueFlag.kind, configFlag.kind] // => ["flag", "flag"]
    * ```
@@ -1870,8 +1859,8 @@ export const orElse: {
  * )
  *
  * const sourceFlag = Flag.orElseResult(
- *   Flag.string("source"),
- *   () => Flag.string("source-url")
+ *   Flag.String("source"),
+ *   () => Flag.String("source-url")
  * )
  *
  * const program = Effect.gen(function*() {
@@ -1917,8 +1906,8 @@ export const orElseResult: {
    * )
    *
    * const sourceFlag = Flag.orElseResult(
-   *   Flag.string("source"),
-   *   () => Flag.string("source-url")
+   *   Flag.String("source"),
+   *   () => Flag.String("source-url")
    * )
    *
    * const program = Effect.gen(function*() {
@@ -1964,8 +1953,8 @@ export const orElseResult: {
    * )
    *
    * const sourceFlag = Flag.orElseResult(
-   *   Flag.string("source"),
-   *   () => Flag.string("source-url")
+   *   Flag.String("source"),
+   *   () => Flag.String("source-url")
    * )
    *
    * const program = Effect.gen(function*() {
@@ -2003,7 +1992,7 @@ export const orElseResult: {
  *   Schema.check(isEmail)
  * )
  *
- * const emailFlag = Flag.string("email").pipe(
+ * const emailFlag = Flag.String("email").pipe(
  *   Flag.withSchema(EmailSchema)
  * )
  *
@@ -2014,7 +2003,7 @@ export const orElseResult: {
  *   ssl: Schema.optional(Schema.Boolean)
  * }).pipe(Schema.fromJsonString)
  *
- * const configFlag = Flag.string("config").pipe(
+ * const configFlag = Flag.String("config").pipe(
  *   Flag.withSchema(ConfigSchema)
  * )
  * const kinds = [emailFlag.kind, configFlag.kind] // => ["flag", "flag"]
@@ -2042,7 +2031,7 @@ export const withSchema: {
    *   Schema.check(isEmail)
    * )
    *
-   * const emailFlag = Flag.string("email").pipe(
+   * const emailFlag = Flag.String("email").pipe(
    *   Flag.withSchema(EmailSchema)
    * )
    *
@@ -2053,7 +2042,7 @@ export const withSchema: {
    *   ssl: Schema.optional(Schema.Boolean)
    * }).pipe(Schema.fromJsonString)
    *
-   * const configFlag = Flag.string("config").pipe(
+   * const configFlag = Flag.String("config").pipe(
    *   Flag.withSchema(ConfigSchema)
    * )
    * const kinds = [emailFlag.kind, configFlag.kind] // => ["flag", "flag"]
@@ -2081,7 +2070,7 @@ export const withSchema: {
    *   Schema.check(isEmail)
    * )
    *
-   * const emailFlag = Flag.string("email").pipe(
+   * const emailFlag = Flag.String("email").pipe(
    *   Flag.withSchema(EmailSchema)
    * )
    *
@@ -2092,7 +2081,7 @@ export const withSchema: {
    *   ssl: Schema.optional(Schema.Boolean)
    * }).pipe(Schema.fromJsonString)
    *
-   * const configFlag = Flag.string("config").pipe(
+   * const configFlag = Flag.String("config").pipe(
    *   Flag.withSchema(ConfigSchema)
    * )
    * const kinds = [emailFlag.kind, configFlag.kind] // => ["flag", "flag"]