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

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

@@ -14,7 +14,7 @@ import type * as Config from "../../Config.ts";
 import type * as Effect from "../../Effect.ts";
 import { 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";
@@ -37,7 +37,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"
  * ```
@@ -45,7 +45,7 @@ export interface Flag<A> extends Param.Param<typeof Param.flagKind, A> {
  * @category constructors
  * @since 4.0.0
  */
-export declare const string: (name: string) => Flag<string>;
+export declare const String: (name: string) => Flag<string>;
 /**
  * Creates a boolean flag that can be enabled or disabled.
  *
@@ -54,7 +54,7 @@ export declare const string: (name: string) => Flag<string>;
  * ```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"
@@ -63,7 +63,7 @@ export declare const string: (name: string) => Flag<string>;
  * @category constructors
  * @since 4.0.0
  */
-export declare const boolean: (name: string) => Flag<boolean>;
+export declare const Boolean: (name: string) => Flag<boolean>;
 /**
  * Creates an integer flag that accepts whole number input.
  *
@@ -72,7 +72,7 @@ export declare const boolean: (name: string) => Flag<boolean>;
  * ```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"
  * ```
@@ -80,7 +80,7 @@ export declare const boolean: (name: string) => Flag<boolean>;
  * @category constructors
  * @since 4.0.0
  */
-export declare const integer: (name: string) => Flag<number>;
+export declare const Int: (name: string) => Flag<number>;
 /**
  * Creates a float flag that accepts decimal number input.
  *
@@ -89,7 +89,7 @@ export declare const integer: (name: string) => Flag<number>;
  * ```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"
  * ```
@@ -97,7 +97,7 @@ export declare const integer: (name: string) => Flag<number>;
  * @category constructors
  * @since 4.0.0
  */
-export declare const float: (name: string) => Flag<number>;
+export declare const Finite: (name: string) => Flag<number>;
 /**
  * Creates a date flag that accepts date input in ISO format.
  *
@@ -106,7 +106,7 @@ export declare const float: (name: string) => Flag<number>;
  * ```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"
  * ```
@@ -114,7 +114,7 @@ export declare const float: (name: string) => Flag<number>;
  * @category constructors
  * @since 4.0.0
  */
-export declare const date: (name: string) => Flag<Date>;
+export declare const Date: (name: string) => Flag<globalThis.Date>;
 /**
  * Constructs option parameters that represent a choice between several inputs.
  * Each tuple maps a string flag value to an associated typed value.
@@ -125,10 +125,10 @@ export declare const date: (name: string) => Flag<Date>;
  * 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]
@@ -139,26 +139,16 @@ export declare const date: (name: string) => Flag<Date>;
  * @category constructors
  * @since 4.0.0
  */
-export declare const choiceWithValue: <const Choice extends ReadonlyArray<readonly [string, any]>>(name: string, choices: Choice) => Flag<Choice[number][1]>;
+export declare const ChoiceWithValue: <const Choice extends ReadonlyArray<readonly [string, any]>>(name: string, choices: Choice) => Flag<Choice[number][1]>;
 /**
- * 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 declare const choice: <const Choices extends ReadonlyArray<string>>(name: string, choices: Choices) => Flag<Choices[number]>;
+export declare const Literals: <const Literals extends ReadonlyArray<string>>(name: string, literals: Literals) => Flag<Literals[number]>;
 /**
  * Creates a path flag that accepts file system path input with validation options.
  *
@@ -168,16 +158,16 @@ export declare const choice: <const Choices extends ReadonlyArray<string>>(name:
  * 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"
  * })
@@ -187,7 +177,7 @@ export declare const choice: <const Choices extends ReadonlyArray<string>>(name:
  * @category constructors
  * @since 4.0.0
  */
-export declare const path: (name: string, options?: {
+export declare const Path: (name: string, options?: {
     readonly pathType?: "file" | "directory" | "either" | undefined;
     readonly mustExist?: boolean | undefined;
     readonly typeName?: string | undefined;
@@ -201,11 +191,11 @@ export declare 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"]
  * ```
@@ -213,7 +203,7 @@ export declare const path: (name: string, options?: {
  * @category constructors
  * @since 4.0.0
  */
-export declare const file: (name: string, options?: {
+export declare const File: (name: string, options?: {
     readonly mustExist?: boolean | undefined;
 }) => Flag<string>;
 /**
@@ -225,11 +215,11 @@ export declare 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"]
  * ```
@@ -237,7 +227,7 @@ export declare const file: (name: string, options?: {
  * @category constructors
  * @since 4.0.0
  */
-export declare const directory: (name: string, options?: {
+export declare const Directory: (name: string, options?: {
     readonly mustExist?: boolean | undefined;
 }) => Flag<string>;
 /**
@@ -273,7 +263,7 @@ export declare 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({
@@ -289,7 +279,7 @@ export declare const directory: (name: string, options?: {
  * @category constructors
  * @since 4.0.0
  */
-export declare const redacted: (name: string) => Flag<Redacted.Redacted<string>>;
+export declare const Redacted: (name: string) => Flag<Redacted_.Redacted<string>>;
 /**
  * Creates a flag that reads and returns file content as a string.
  *
@@ -298,7 +288,7 @@ export declare const redacted: (name: string) => Flag<Redacted.Redacted<string>>
  * ```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"
  * ```
@@ -306,7 +296,7 @@ export declare const redacted: (name: string) => Flag<Redacted.Redacted<string>>
  * @category constructors
  * @since 4.0.0
  */
-export declare const fileText: (name: string) => Flag<string>;
+export declare const FileText: (name: string) => Flag<string>;
 /**
  * Creates a flag that reads and parses the content of the specified file.
  *
@@ -322,17 +312,17 @@ export declare const fileText: (name: string) => Flag<string>;
  *
  * // 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 declare const fileParse: (name: string, options?: Primitive.FileParseOptions | undefined) => Flag<unknown>;
+export declare const FileParse: (name: string, options?: Primitive.FileParseOptions | undefined) => Flag<unknown>;
 /**
  * Creates a flag that reads and validates file content using the specified
  * schema.
@@ -348,14 +338,14 @@ export declare const fileParse: (name: string, options?: Primitive.FileParseOpti
  *   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 declare const fileSchema: <A>(name: string, schema: Schema.ConstraintDecoder<A, Environment>, options?: Primitive.FileSchemaOptions | undefined) => Flag<A>;
+export declare const FileSchema: <A>(name: string, schema: Schema.ConstraintDecoder<A, Environment>, options?: Primitive.FileSchemaOptions | undefined) => Flag<A>;
 /**
  * Creates a flag that parses key=value pairs.
  *
@@ -374,7 +364,7 @@ export declare const fileSchema: <A>(name: string, schema: Schema.ConstraintDeco
  * ```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"
  * ```
@@ -382,10 +372,9 @@ export declare const fileSchema: <A>(name: string, schema: Schema.ConstraintDeco
  * @category constructors
  * @since 4.0.0
  */
-export declare const keyValuePair: (name: string) => Flag<Record<string, string>>;
+export declare const KeyValuePair: (name: string) => Flag<Record<string, string>>;
 /**
- * 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)
  *
@@ -393,16 +382,16 @@ export declare const keyValuePair: (name: string) => Flag<Record<string, string>
  * 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 declare const none: Flag<never>;
+export declare const Never: Flag<never>;
 /**
  * Adds an alias to a flag, allowing it to be referenced by multiple names.
  *
@@ -412,12 +401,12 @@ export declare const none: Flag<never>;
  * 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("?")
  * )
@@ -437,12 +426,12 @@ export declare 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("?")
      * )
@@ -462,12 +451,12 @@ export declare 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("?")
      * )
@@ -487,11 +476,11 @@ export declare 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"]
@@ -509,11 +498,11 @@ export declare 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"]
@@ -531,11 +520,11 @@ export declare 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"]
@@ -559,13 +548,13 @@ export declare 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
@@ -589,13 +578,13 @@ export declare 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
@@ -619,13 +608,13 @@ export declare 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
@@ -653,7 +642,7 @@ export declare 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"
@@ -690,7 +679,7 @@ export declare const withHidden: <A>(self: Flag<A>) => Flag<A>;
  *   )
  * )
  *
- * const optionalPort = Flag.optional(Flag.integer("port"))
+ * const optionalPort = Flag.optional(Flag.Int("port"))
  *
  * const program = Effect.gen(function*() {
  *   const [, port] = yield* optionalPort.parse({
@@ -715,12 +704,12 @@ export declare const optional: <A>(param: Flag<A>) => Flag<Option.Option<A>>;
  * ```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"
@@ -739,12 +728,12 @@ export declare 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"
@@ -763,12 +752,12 @@ export declare 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"
@@ -789,8 +778,8 @@ export declare 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"
  * ```
@@ -808,8 +797,8 @@ export declare 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"
      * ```
@@ -827,8 +816,8 @@ export declare 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"
      * ```
@@ -846,8 +835,8 @@ export declare 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"
  * ```
@@ -864,8 +853,8 @@ export declare 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"
      * ```
@@ -882,8 +871,8 @@ export declare 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"
      * ```
@@ -902,12 +891,12 @@ export declare 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"]
@@ -926,12 +915,12 @@ export declare 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"]
@@ -950,12 +939,12 @@ export declare 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"]
@@ -993,7 +982,7 @@ export declare const map: {
  *   )
  * )
  *
- * const upperName = Flag.string("name").pipe(
+ * const upperName = Flag.String("name").pipe(
  *   Flag.mapEffect((name) => Effect.succeed(name.toUpperCase()))
  * )
  *
@@ -1037,7 +1026,7 @@ export declare const mapEffect: {
      *   )
      * )
      *
-     * const upperName = Flag.string("name").pipe(
+     * const upperName = Flag.String("name").pipe(
      *   Flag.mapEffect((name) => Effect.succeed(name.toUpperCase()))
      * )
      *
@@ -1081,7 +1070,7 @@ export declare const mapEffect: {
      *   )
      * )
      *
-     * const upperName = Flag.string("name").pipe(
+     * const upperName = Flag.String("name").pipe(
      *   Flag.mapEffect((name) => Effect.succeed(name.toUpperCase()))
      * )
      *
@@ -1127,7 +1116,7 @@ export declare 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}`
@@ -1135,7 +1124,7 @@ export declare 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}`
@@ -1183,7 +1172,7 @@ export declare 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}`
@@ -1191,7 +1180,7 @@ export declare 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}`
@@ -1239,7 +1228,7 @@ export declare 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}`
@@ -1247,7 +1236,7 @@ export declare 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}`
@@ -1276,11 +1265,11 @@ export declare 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
@@ -1299,11 +1288,11 @@ export declare 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
@@ -1322,11 +1311,11 @@ export declare 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
@@ -1346,11 +1335,11 @@ export declare 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
@@ -1369,11 +1358,11 @@ export declare 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
@@ -1392,11 +1381,11 @@ export declare 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
@@ -1416,11 +1405,11 @@ export declare 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
@@ -1439,11 +1428,11 @@ export declare 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
@@ -1462,11 +1451,11 @@ export declare 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
@@ -1488,7 +1477,7 @@ export declare 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}`
@@ -1496,7 +1485,7 @@ export declare 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}`
@@ -1519,7 +1508,7 @@ export declare 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}`
@@ -1527,7 +1516,7 @@ export declare 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}`
@@ -1550,7 +1539,7 @@ export declare 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}`
@@ -1558,7 +1547,7 @@ export declare 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}`
@@ -1581,7 +1570,7 @@ export declare 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)`
@@ -1589,7 +1578,7 @@ export declare 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"
@@ -1611,7 +1600,7 @@ export declare 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)`
@@ -1619,7 +1608,7 @@ export declare 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"
@@ -1641,7 +1630,7 @@ export declare 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)`
@@ -1649,7 +1638,7 @@ export declare 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"
@@ -1673,14 +1662,14 @@ export declare 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"]
  * ```
@@ -1699,14 +1688,14 @@ export declare 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"]
      * ```
@@ -1725,14 +1714,14 @@ export declare 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"]
      * ```
@@ -1770,8 +1759,8 @@ export declare 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*() {
@@ -1817,8 +1806,8 @@ export declare 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*() {
@@ -1864,8 +1853,8 @@ export declare 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*() {
@@ -1902,7 +1891,7 @@ export declare const orElseResult: {
  *   Schema.check(isEmail)
  * )
  *
- * const emailFlag = Flag.string("email").pipe(
+ * const emailFlag = Flag.String("email").pipe(
  *   Flag.withSchema(EmailSchema)
  * )
  *
@@ -1913,7 +1902,7 @@ export declare 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"]
@@ -1941,7 +1930,7 @@ export declare const withSchema: {
      *   Schema.check(isEmail)
      * )
      *
-     * const emailFlag = Flag.string("email").pipe(
+     * const emailFlag = Flag.String("email").pipe(
      *   Flag.withSchema(EmailSchema)
      * )
      *
@@ -1952,7 +1941,7 @@ export declare 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"]
@@ -1980,7 +1969,7 @@ export declare const withSchema: {
      *   Schema.check(isEmail)
      * )
      *
-     * const emailFlag = Flag.string("email").pipe(
+     * const emailFlag = Flag.String("email").pipe(
      *   Flag.withSchema(EmailSchema)
      * )
      *
@@ -1991,7 +1980,7 @@ export declare 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"]