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

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

@@ -16,7 +16,7 @@ import { type LazyArg } from "../../Function.ts";
 import * as Option from "../../Option.ts";
 import { type Pipeable } from "../../Pipeable.ts";
 import * as Predicate from "../../Predicate.ts";
-import type * as Redacted from "../../Redacted.ts";
+import type * as Redacted_ from "../../Redacted.ts";
 import * as Result from "../../Result.ts";
 import * as Schema from "../../Schema.ts";
 import type { Covariant } from "../../Types.ts";
@@ -242,7 +242,7 @@ export interface Variadic<Kind extends ParamKind, A> extends Param<Kind, Readonl
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const maybeParam = Param.string(Param.flagKind, "name")
+ * const maybeParam = Param.String(Param.flagKind, "name")
  *
  * Param.isParam(maybeParam) // => true
  * ```
@@ -259,7 +259,7 @@ export declare const isParam: (u: unknown) => u is Param<any, ParamKind>;
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const nameParam = Param.string(Param.flagKind, "name")
+ * const nameParam = Param.String(Param.flagKind, "name")
  * const optionalParam = Param.optional(nameParam)
  *
  * Param.isSingle(nameParam) // => true
@@ -300,10 +300,10 @@ export declare const makeSingle: <const Kind extends ParamKind, A>(params: {
  * import { Param } from "effect/unstable/cli"
  *
  * // Create a string flag
- * const nameFlag = Param.string(Param.flagKind, "name")
+ * const nameFlag = Param.String(Param.flagKind, "name")
  *
  * // Create a string argument
- * const fileArg = Param.string(Param.argumentKind, "file")
+ * const fileArg = Param.String(Param.argumentKind, "file")
  *
  * // Usage in CLI: --name "John Doe" or as positional argument
  * const kinds = [nameFlag.kind, fileArg.kind] // => ["flag", "argument"]
@@ -312,7 +312,7 @@ export declare const makeSingle: <const Kind extends ParamKind, A>(params: {
  * @category constructors
  * @since 4.0.0
  */
-export declare const string: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, string>;
+export declare const String: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, string>;
 /**
  * Creates a boolean parameter.
  *
@@ -322,10 +322,10 @@ export declare const string: <const Kind extends ParamKind>(kind: Kind, name: st
  * import { Param } from "effect/unstable/cli"
  *
  * // Create a boolean flag
- * const verboseFlag = Param.boolean(Param.flagKind, "verbose")
+ * const verboseFlag = Param.Boolean(Param.flagKind, "verbose")
  *
  * // Create a boolean argument
- * const enableArg = Param.boolean(Param.argumentKind, "enable")
+ * const enableArg = Param.Boolean(Param.argumentKind, "enable")
  *
  * // Usage in CLI: --verbose (true) or --no-verbose (false).
  * // The flag is required unless made optional or given a fallback.
@@ -336,7 +336,7 @@ export declare const string: <const Kind extends ParamKind>(kind: Kind, name: st
  * @category constructors
  * @since 4.0.0
  */
-export declare const boolean: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, boolean>;
+export declare const Boolean: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, boolean>;
 /**
  * Creates an integer parameter.
  *
@@ -346,10 +346,10 @@ export declare const boolean: <const Kind extends ParamKind>(kind: Kind, name: s
  * import { Param } from "effect/unstable/cli"
  *
  * // Create an integer flag
- * const portFlag = Param.integer(Param.flagKind, "port")
+ * const portFlag = Param.Int(Param.flagKind, "port")
  *
  * // Create an integer argument
- * const countArg = Param.integer(Param.argumentKind, "count")
+ * const countArg = Param.Int(Param.argumentKind, "count")
  *
  * // Usage in CLI: --port 8080 or as positional argument: 42
  * const kinds = [portFlag.kind, countArg.kind] // => ["flag", "argument"]
@@ -358,29 +358,26 @@ export declare const boolean: <const Kind extends ParamKind>(kind: Kind, name: s
  * @category constructors
  * @since 4.0.0
  */
-export declare const integer: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, number>;
+export declare const Int: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, number>;
 /**
- * Creates a floating-point number parameter.
+ * Creates a finite number parameter.
  *
- * **Example** (Creating float parameters)
+ * **Example** (Creating finite number parameters)
  *
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * // Create a float flag
- * const rateFlag = Param.float(Param.flagKind, "rate")
+ * const rateFlag = Param.Finite(Param.flagKind, "rate")
  *
- * // Create a float argument
- * const thresholdArg = Param.float(Param.argumentKind, "threshold")
+ * const thresholdArg = Param.Finite(Param.argumentKind, "threshold")
  *
- * // Usage in CLI: --rate 0.95 or as positional argument: 3.14159
  * const kinds = [rateFlag.kind, thresholdArg.kind] // => ["flag", "argument"]
  * ```
  *
  * @category constructors
  * @since 4.0.0
  */
-export declare const float: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, number>;
+export declare const Finite: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, number>;
 /**
  * Creates a date parameter that parses ISO date strings.
  *
@@ -390,10 +387,10 @@ export declare const float: <const Kind extends ParamKind>(kind: Kind, name: str
  * import { Param } from "effect/unstable/cli"
  *
  * // Create a date flag
- * const startFlag = Param.date(Param.flagKind, "start-date")
+ * const startFlag = Param.Date(Param.flagKind, "start-date")
  *
  * // Create a date argument
- * const dueDateArg = Param.date(Param.argumentKind, "due-date")
+ * const dueDateArg = Param.Date(Param.argumentKind, "due-date")
  *
  * // Usage in CLI: --start-date "2023-12-25" or as positional: "2023-01-01"
  * // Parses to JavaScript Date object
@@ -403,7 +400,7 @@ export declare const float: <const Kind extends ParamKind>(kind: Kind, name: str
  * @category constructors
  * @since 4.0.0
  */
-export declare const date: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, Date>;
+export declare const Date: <const Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, globalThis.Date>;
 /**
  * Constructs command-line params that represent a choice between several
  * inputs. The input will be mapped to it's associated value during parsing.
@@ -423,7 +420,7 @@ export declare const date: <const Kind extends ParamKind>(kind: Kind, name: stri
  *   readonly _tag: "Cat"
  * }
  *
- * const animal = Param.choiceWithValue(Param.flagKind, "animal", [
+ * const animal = Param.ChoiceWithValue(Param.flagKind, "animal", [
  *   ["dog", { _tag: "Dog" }],
  *   ["cat", { _tag: "Cat" }]
  * ])
@@ -433,7 +430,7 @@ export declare const date: <const Kind extends ParamKind>(kind: Kind, name: stri
  * @category constructors
  * @since 4.0.0
  */
-export declare const choiceWithValue: <const Kind extends ParamKind, const Choices extends ReadonlyArray<readonly [string, any]>>(kind: Kind, name: string, choices: Choices) => Param<Kind, Choices[number][1]>;
+export declare const ChoiceWithValue: <const Kind extends ParamKind, const Choices extends ReadonlyArray<readonly [string, any]>>(kind: Kind, name: string, choices: Choices) => Param<Kind, Choices[number][1]>;
 /**
  * Constructs command-line params that represent a choice between several
  * string inputs.
@@ -443,7 +440,7 @@ export declare const choiceWithValue: <const Kind extends ParamKind, const Choic
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const logLevel = Param.choice(Param.flagKind, "log-level", [
+ * const logLevel = Param.Literals(Param.flagKind, "log-level", [
  *   "debug",
  *   "info",
  *   "warn",
@@ -455,7 +452,7 @@ export declare const choiceWithValue: <const Kind extends ParamKind, const Choic
  * @category constructors
  * @since 4.0.0
  */
-export declare const choice: <const Kind extends ParamKind, const Choices extends ReadonlyArray<string>>(kind: Kind, name: string, choices: Choices) => Param<Kind, Choices[number]>;
+export declare const Literals: <const Kind extends ParamKind, const Choices extends ReadonlyArray<string>>(kind: Kind, name: string, choices: Choices) => Param<Kind, Choices[number]>;
 /**
  * Creates a path parameter that accepts file or directory paths.
  *
@@ -465,13 +462,13 @@ export declare const choice: <const Kind extends ParamKind, const Choices extend
  * import { Param } from "effect/unstable/cli"
  *
  * // Basic path parameter
- * const outputPath = Param.path(Param.flagKind, "output")
+ * const outputPath = Param.Path(Param.flagKind, "output")
  *
  * // Path that must exist
- * const inputPath = Param.path(Param.flagKind, "input", { mustExist: true })
+ * const inputPath = Param.Path(Param.flagKind, "input", { mustExist: true })
  *
  * // File-only path
- * const configFile = Param.path(Param.flagKind, "config", {
+ * const configFile = Param.Path(Param.flagKind, "config", {
  *   pathType: "file",
  *   mustExist: true,
  *   typeName: "config-file"
@@ -482,7 +479,7 @@ export declare const choice: <const Kind extends ParamKind, const Choices extend
  * @category constructors
  * @since 4.0.0
  */
-export declare const path: <Kind extends ParamKind>(kind: Kind, name: string, options?: {
+export declare const Path: <Kind extends ParamKind>(kind: Kind, name: string, options?: {
     readonly pathType?: Primitive.PathType | undefined;
     readonly mustExist?: boolean | undefined;
     readonly typeName?: string | undefined;
@@ -501,10 +498,10 @@ export declare const path: <Kind extends ParamKind>(kind: Kind, name: string, op
  * import { Param } from "effect/unstable/cli"
  *
  * // Basic directory parameter
- * const outputDir = Param.directory(Param.flagKind, "output-dir")
+ * const outputDir = Param.Directory(Param.flagKind, "output-dir")
  *
  * // Directory that must exist
- * const sourceDir = Param.directory(Param.flagKind, "source", { mustExist: true })
+ * const sourceDir = Param.Directory(Param.flagKind, "source", { mustExist: true })
  *
  * // Usage: --output-dir /path/to/dir --source /existing/dir
  * const kinds = [outputDir.kind, sourceDir.kind] // => ["flag", "flag"]
@@ -513,7 +510,7 @@ export declare const path: <Kind extends ParamKind>(kind: Kind, name: string, op
  * @category constructors
  * @since 4.0.0
  */
-export declare const directory: <Kind extends ParamKind>(kind: Kind, name: string, options?: {
+export declare const Directory: <Kind extends ParamKind>(kind: Kind, name: string, options?: {
     readonly mustExist?: boolean | undefined;
 }) => Param<Kind, string>;
 /**
@@ -530,10 +527,10 @@ export declare const directory: <Kind extends ParamKind>(kind: Kind, name: strin
  * import { Param } from "effect/unstable/cli"
  *
  * // Basic file parameter
- * const outputFile = Param.file(Param.flagKind, "output")
+ * const outputFile = Param.File(Param.flagKind, "output")
  *
  * // File that must exist
- * const inputFile = Param.file(Param.flagKind, "input", { mustExist: true })
+ * const inputFile = Param.File(Param.flagKind, "input", { mustExist: true })
  *
  * // Usage: --output result.txt --input existing-file.txt
  * const kinds = [outputFile.kind, inputFile.kind] // => ["flag", "flag"]
@@ -542,7 +539,7 @@ export declare const directory: <Kind extends ParamKind>(kind: Kind, name: strin
  * @category constructors
  * @since 4.0.0
  */
-export declare const file: <Kind extends ParamKind>(kind: Kind, name: string, options?: {
+export declare const File: <Kind extends ParamKind>(kind: Kind, name: string, options?: {
     readonly mustExist?: boolean | undefined;
 }) => Param<Kind, string>;
 /**
@@ -555,10 +552,10 @@ export declare const file: <Kind extends ParamKind>(kind: Kind, name: string, op
  * import { Param } from "effect/unstable/cli"
  *
  * // Create a password parameter
- * const password = Param.redacted(Param.flagKind, "password")
+ * const password = Param.Redacted(Param.flagKind, "password")
  *
  * // Create an API key argument
- * const apiKey = Param.redacted(Param.argumentKind, "api-key")
+ * const apiKey = Param.Redacted(Param.argumentKind, "api-key")
  *
  * // Usage: --password (value will be hidden in help/logs)
  * const kinds = [password.kind, apiKey.kind] // => ["flag", "argument"]
@@ -567,7 +564,7 @@ export declare const file: <Kind extends ParamKind>(kind: Kind, name: string, op
  * @category constructors
  * @since 4.0.0
  */
-export declare const redacted: <Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, Redacted.Redacted<string>>;
+export declare const Redacted: <Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, Redacted_.Redacted<string>>;
 /**
  * Creates a parameter that reads and returns file content as a string.
  *
@@ -577,10 +574,10 @@ export declare const redacted: <Kind extends ParamKind>(kind: Kind, name: string
  * import { Param } from "effect/unstable/cli"
  *
  * // Read a config file as string
- * const configContent = Param.fileText(Param.flagKind, "config")
+ * const configContent = Param.FileText(Param.flagKind, "config")
  *
  * // Read a template file as argument
- * const templateContent = Param.fileText(Param.argumentKind, "template")
+ * const templateContent = Param.FileText(Param.argumentKind, "template")
  *
  * // Usage: --config config.txt (reads file content into string)
  * const kinds = [configContent.kind, templateContent.kind] // => ["flag", "argument"]
@@ -589,7 +586,7 @@ export declare const redacted: <Kind extends ParamKind>(kind: Kind, name: string
  * @category constructors
  * @since 4.0.0
  */
-export declare const fileText: <Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, string>;
+export declare const FileText: <Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, string>;
 /**
  * Creates a param that reads and parses the content of the specified file.
  *
@@ -605,10 +602,10 @@ export declare const fileText: <Kind extends ParamKind>(kind: Kind, name: string
  *
  * // Will use the extension of the file passed on the command line to determine
  * // the parser to use
- * const config = Param.fileParse(Param.flagKind, "config")
+ * const config = Param.FileParse(Param.flagKind, "config")
  *
  * // Will use the JSON parser
- * const jsonConfig = Param.fileParse(Param.flagKind, "json-config", {
+ * const jsonConfig = Param.FileParse(Param.flagKind, "json-config", {
  *   format: "json"
  * })
  * const kinds = [config.kind, jsonConfig.kind] // => ["flag", "flag"]
@@ -617,7 +614,7 @@ export declare const fileText: <Kind extends ParamKind>(kind: Kind, name: string
  * @category constructors
  * @since 4.0.0
  */
-export declare const fileParse: <Kind extends ParamKind>(kind: Kind, name: string, options?: Primitive.FileParseOptions | undefined) => Param<Kind, unknown>;
+export declare const FileParse: <Kind extends ParamKind>(kind: Kind, name: string, options?: Primitive.FileParseOptions | undefined) => Param<Kind, unknown>;
 /**
  * Creates a parameter that reads and validates file content using a schema.
  *
@@ -632,12 +629,12 @@ export declare const fileParse: <Kind extends ParamKind>(kind: Kind, name: strin
  *   host: Schema.String
  * })
  *
- * const config = Param.fileSchema(Param.flagKind, "config", configSchema, {
+ * const config = Param.FileSchema(Param.flagKind, "config", configSchema, {
  *   format: "json"
  * })
  *
  * // Parse YAML file
- * const yamlConfig = Param.fileSchema(Param.flagKind, "config", configSchema, {
+ * const yamlConfig = Param.FileSchema(Param.flagKind, "config", configSchema, {
  *   format: "yaml"
  * })
  *
@@ -648,7 +645,7 @@ export declare const fileParse: <Kind extends ParamKind>(kind: Kind, name: strin
  * @category constructors
  * @since 4.0.0
  */
-export declare const fileSchema: <Kind extends ParamKind, A>(kind: Kind, name: string, schema: Schema.ConstraintDecoder<A, Environment>, options?: Primitive.FileSchemaOptions | undefined) => Param<Kind, A>;
+export declare const FileSchema: <Kind extends ParamKind, A>(kind: Kind, name: string, schema: Schema.ConstraintDecoder<A, Environment>, options?: Primitive.FileSchemaOptions | undefined) => Param<Kind, A>;
 /**
  * Creates a param that parses key=value pairs.
  *
@@ -667,10 +664,10 @@ export declare const fileSchema: <Kind extends ParamKind, A>(kind: Kind, name: s
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const env = Param.keyValuePair(Param.flagKind, "env")
+ * const env = Param.KeyValuePair(Param.flagKind, "env")
  * // --env FOO=bar --env BAZ=qux will parse to { FOO: "bar", BAZ: "qux" }
  *
- * const props = Param.keyValuePair(Param.flagKind, "property")
+ * const props = Param.KeyValuePair(Param.flagKind, "property")
  * // --property name=value --property debug=true
  * const kinds = [env.kind, props.kind] // => ["flag", "flag"]
  * ```
@@ -678,24 +675,19 @@ export declare const fileSchema: <Kind extends ParamKind, A>(kind: Kind, name: s
  * @category constructors
  * @since 4.0.0
  */
-export declare const keyValuePair: <Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, Record<string, string>>;
+export declare const KeyValuePair: <Kind extends ParamKind>(kind: Kind, name: string) => Param<Kind, Record<string, string>>;
 /**
- * Creates an empty sentinel parameter that always fails to parse.
- *
- * **When to use**
- *
- * Use when you need an empty CLI parameter sentinel for optional parameter
- * construction or internal combinators.
+ * A parameter that always fails to parse.
  *
  * **Example** (Creating sentinel parameters)
  *
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const disabledDebugParam = Param.none(Param.flagKind)
+ * const disabledDebugParam = Param.Never(Param.flagKind)
  *
  * const makeDebugParam = (enableDebug: boolean) =>
- *   enableDebug ? Param.string(Param.flagKind, "debug") : disabledDebugParam
+ *   enableDebug ? Param.String(Param.flagKind, "debug") : disabledDebugParam
  *
  * makeDebugParam(true) === disabledDebugParam // => false
  * makeDebugParam(false) === disabledDebugParam // => true
@@ -704,7 +696,7 @@ export declare const keyValuePair: <Kind extends ParamKind>(kind: Kind, name: st
  * @category constructors
  * @since 4.0.0
  */
-export declare const none: <Kind extends ParamKind>(kind: Kind) => Param<Kind, never>;
+export declare const Never: <Kind extends ParamKind>(kind: Kind) => Param<Kind, never>;
 /**
  * Adds an alias to an option.
  *
@@ -723,13 +715,13 @@ export declare const none: <Kind extends ParamKind>(kind: Kind) => Param<Kind, n
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const force = Param.boolean(Param.flagKind, "force").pipe(
+ * const force = Param.Boolean(Param.flagKind, "force").pipe(
  *   Param.withAlias("-f"),
  *   Param.withAlias("-F")
  * )
  *
  * // Also works on composed params:
- * const count = Param.integer(Param.flagKind, "count").pipe(
+ * const count = Param.Int(Param.flagKind, "count").pipe(
  *   Param.optional,
  *   Param.withAlias("-c") // finds the underlying Single and adds alias
  * )
@@ -758,13 +750,13 @@ export declare const withAlias: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const force = Param.boolean(Param.flagKind, "force").pipe(
+     * const force = Param.Boolean(Param.flagKind, "force").pipe(
      *   Param.withAlias("-f"),
      *   Param.withAlias("-F")
      * )
      *
      * // Also works on composed params:
-     * const count = Param.integer(Param.flagKind, "count").pipe(
+     * const count = Param.Int(Param.flagKind, "count").pipe(
      *   Param.optional,
      *   Param.withAlias("-c") // finds the underlying Single and adds alias
      * )
@@ -793,13 +785,13 @@ export declare const withAlias: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const force = Param.boolean(Param.flagKind, "force").pipe(
+     * const force = Param.Boolean(Param.flagKind, "force").pipe(
      *   Param.withAlias("-f"),
      *   Param.withAlias("-F")
      * )
      *
      * // Also works on composed params:
-     * const count = Param.integer(Param.flagKind, "count").pipe(
+     * const count = Param.Int(Param.flagKind, "count").pipe(
      *   Param.optional,
      *   Param.withAlias("-c") // finds the underlying Single and adds alias
      * )
@@ -824,7 +816,7 @@ export declare const withAlias: {
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const verbose = Param.boolean(Param.flagKind, "verbose").pipe(
+ * const verbose = Param.Boolean(Param.flagKind, "verbose").pipe(
  *   Param.withAlias("-v"),
  *   Param.withDescription("Enable verbose output")
  * )
@@ -848,7 +840,7 @@ export declare const withDescription: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const verbose = Param.boolean(Param.flagKind, "verbose").pipe(
+     * const verbose = Param.Boolean(Param.flagKind, "verbose").pipe(
      *   Param.withAlias("-v"),
      *   Param.withDescription("Enable verbose output")
      * )
@@ -872,7 +864,7 @@ export declare const withDescription: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const verbose = Param.boolean(Param.flagKind, "verbose").pipe(
+     * const verbose = Param.Boolean(Param.flagKind, "verbose").pipe(
      *   Param.withAlias("-v"),
      *   Param.withDescription("Enable verbose output")
      * )
@@ -898,7 +890,7 @@ export declare const withDescription: {
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const experimental = Param.boolean(Param.flagKind, "experimental-foo").pipe(
+ * const experimental = Param.Boolean(Param.flagKind, "experimental-foo").pipe(
  *   Param.withHidden
  * )
  * experimental.kind // => "flag"
@@ -916,7 +908,7 @@ export declare const withHidden: <Kind extends ParamKind, A>(self: Param<Kind, A
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const port = Param.integer(Param.flagKind, "port").pipe(
+ * const port = Param.Int(Param.flagKind, "port").pipe(
  *   Param.map((n) => ({ port: n, url: `http://localhost:${n}` }))
  * )
  * port.kind // => "flag"
@@ -934,7 +926,7 @@ export declare const map: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const port = Param.integer(Param.flagKind, "port").pipe(
+     * const port = Param.Int(Param.flagKind, "port").pipe(
      *   Param.map((n) => ({ port: n, url: `http://localhost:${n}` }))
      * )
      * port.kind // => "flag"
@@ -952,7 +944,7 @@ export declare const map: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const port = Param.integer(Param.flagKind, "port").pipe(
+     * const port = Param.Int(Param.flagKind, "port").pipe(
      *   Param.map((n) => ({ port: n, url: `http://localhost:${n}` }))
      * )
      * port.kind // => "flag"
@@ -990,7 +982,7 @@ export declare const map: {
  *   )
  * )
  *
- * const validatedEmail = Param.string(Param.flagKind, "email").pipe(
+ * const validatedEmail = Param.String(Param.flagKind, "email").pipe(
  *   Param.mapEffect((email) =>
  *     email.includes("@")
  *       ? Effect.succeed(email)
@@ -1045,7 +1037,7 @@ export declare const mapEffect: {
      *   )
      * )
      *
-     * const validatedEmail = Param.string(Param.flagKind, "email").pipe(
+     * const validatedEmail = Param.String(Param.flagKind, "email").pipe(
      *   Param.mapEffect((email) =>
      *     email.includes("@")
      *       ? Effect.succeed(email)
@@ -1100,7 +1092,7 @@ export declare const mapEffect: {
      *   )
      * )
      *
-     * const validatedEmail = Param.string(Param.flagKind, "email").pipe(
+     * const validatedEmail = Param.String(Param.flagKind, "email").pipe(
      *   Param.mapEffect((email) =>
      *     email.includes("@")
      *       ? Effect.succeed(email)
@@ -1157,7 +1149,7 @@ export declare const mapEffect: {
  *   )
  * )
  *
- * const parsedJson = Param.string(Param.flagKind, "config").pipe(
+ * const parsedJson = Param.String(Param.flagKind, "config").pipe(
  *   Param.mapTryCatch(
  *     (str) => JSON.parse(str),
  *     (error) =>
@@ -1206,7 +1198,7 @@ export declare const mapTryCatch: {
      *   )
      * )
      *
-     * const parsedJson = Param.string(Param.flagKind, "config").pipe(
+     * const parsedJson = Param.String(Param.flagKind, "config").pipe(
      *   Param.mapTryCatch(
      *     (str) => JSON.parse(str),
      *     (error) =>
@@ -1255,7 +1247,7 @@ export declare const mapTryCatch: {
      *   )
      * )
      *
-     * const parsedJson = Param.string(Param.flagKind, "config").pipe(
+     * const parsedJson = Param.String(Param.flagKind, "config").pipe(
      *   Param.mapTryCatch(
      *     (str) => JSON.parse(str),
      *     (error) =>
@@ -1294,7 +1286,7 @@ export declare const mapTryCatch: {
  * // Create an optional port option
  * // - When not provided: returns Option.none()
  * // - When provided: returns Option.some(parsedValue)
- * const port = Param.optional(Param.integer(Param.flagKind, "port"))
+ * const port = Param.optional(Param.Int(Param.flagKind, "port"))
  * port.kind // => "flag"
  * ```
  *
@@ -1316,12 +1308,12 @@ export declare const optional: <Kind extends ParamKind, A>(param: Param<Kind, A>
  * import { Param } from "effect/unstable/cli"
  *
  * // Using the pipe operator to make an option optional
- * const port = Param.integer(Param.flagKind, "port").pipe(
+ * const port = Param.Int(Param.flagKind, "port").pipe(
  *   Param.withDefault(8080)
  * )
  *
  * // Can also be used with other combinators
- * const verbose = Param.boolean(Param.flagKind, "verbose").pipe(
+ * const verbose = Param.Boolean(Param.flagKind, "verbose").pipe(
  *   Param.withAlias("-v"),
  *   Param.withDescription("Enable verbose output"),
  *   Param.withDefault(false)
@@ -1347,12 +1339,12 @@ export declare const withDefault: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Using the pipe operator to make an option optional
-     * const port = Param.integer(Param.flagKind, "port").pipe(
+     * const port = Param.Int(Param.flagKind, "port").pipe(
      *   Param.withDefault(8080)
      * )
      *
      * // Can also be used with other combinators
-     * const verbose = Param.boolean(Param.flagKind, "verbose").pipe(
+     * const verbose = Param.Boolean(Param.flagKind, "verbose").pipe(
      *   Param.withAlias("-v"),
      *   Param.withDescription("Enable verbose output"),
      *   Param.withDefault(false)
@@ -1378,12 +1370,12 @@ export declare const withDefault: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Using the pipe operator to make an option optional
-     * const port = Param.integer(Param.flagKind, "port").pipe(
+     * const port = Param.Int(Param.flagKind, "port").pipe(
      *   Param.withDefault(8080)
      * )
      *
      * // Can also be used with other combinators
-     * const verbose = Param.boolean(Param.flagKind, "verbose").pipe(
+     * const verbose = Param.Boolean(Param.flagKind, "verbose").pipe(
      *   Param.withAlias("-v"),
      *   Param.withDescription("Enable verbose output"),
      *   Param.withDefault(false)
@@ -1582,16 +1574,16 @@ export type VariadicParamOptions = {
  * import { Param } from "effect/unstable/cli"
  *
  * // Basic variadic parameter (0 to infinity)
- * const tags = Param.variadic(Param.string(Param.flagKind, "tag"))
+ * const tags = Param.variadic(Param.String(Param.flagKind, "tag"))
  *
  * // Variadic with minimum count
  * const inputs = Param.variadic(
- *   Param.string(Param.flagKind, "input"),
+ *   Param.String(Param.flagKind, "input"),
  *   { min: 1 } // at least 1 required
  * )
  *
  * // Variadic with both min and max
- * const limited = Param.variadic(Param.string(Param.flagKind, "item"), {
+ * const limited = Param.variadic(Param.String(Param.flagKind, "item"), {
  *   min: 2, // at least 2 times
  *   max: 2 // at most 2 times
  * })
@@ -1616,7 +1608,7 @@ export declare const variadic: <Kind extends ParamKind, A>(self: Param<Kind, A>,
  * import { Param } from "effect/unstable/cli"
  *
  * // Allow 1-3 file inputs
- * const files = Param.string(Param.flagKind, "file").pipe(
+ * const files = Param.String(Param.flagKind, "file").pipe(
  *   Param.between(1, 3),
  *   Param.withAlias("-f")
  * )
@@ -1625,7 +1617,7 @@ export declare const variadic: <Kind extends ParamKind, A>(self: Param<Kind, A>,
  * // Result: ["a.txt", "b.txt"]
  *
  * // Allow 0 or more tags
- * const tags = Param.string(Param.flagKind, "tag").pipe(
+ * const tags = Param.String(Param.flagKind, "tag").pipe(
  *   Param.between(0, Number.MAX_SAFE_INTEGER)
  * )
  *
@@ -1652,7 +1644,7 @@ export declare const between: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Allow 1-3 file inputs
-     * const files = Param.string(Param.flagKind, "file").pipe(
+     * const files = Param.String(Param.flagKind, "file").pipe(
      *   Param.between(1, 3),
      *   Param.withAlias("-f")
      * )
@@ -1661,7 +1653,7 @@ export declare const between: {
      * // Result: ["a.txt", "b.txt"]
      *
      * // Allow 0 or more tags
-     * const tags = Param.string(Param.flagKind, "tag").pipe(
+     * const tags = Param.String(Param.flagKind, "tag").pipe(
      *   Param.between(0, Number.MAX_SAFE_INTEGER)
      * )
      *
@@ -1688,7 +1680,7 @@ export declare const between: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Allow 1-3 file inputs
-     * const files = Param.string(Param.flagKind, "file").pipe(
+     * const files = Param.String(Param.flagKind, "file").pipe(
      *   Param.between(1, 3),
      *   Param.withAlias("-f")
      * )
@@ -1697,7 +1689,7 @@ export declare const between: {
      * // Result: ["a.txt", "b.txt"]
      *
      * // Allow 0 or more tags
-     * const tags = Param.string(Param.flagKind, "tag").pipe(
+     * const tags = Param.String(Param.flagKind, "tag").pipe(
      *   Param.between(0, Number.MAX_SAFE_INTEGER)
      * )
      *
@@ -1725,7 +1717,7 @@ export declare const between: {
  * import { Param } from "effect/unstable/cli"
  *
  * // Allow at most 3 warning suppressions
- * const suppressions = Param.string(Param.flagKind, "suppress").pipe(
+ * const suppressions = Param.String(Param.flagKind, "suppress").pipe(
  *   Param.atMost(3)
  * )
  *
@@ -1752,7 +1744,7 @@ export declare const atMost: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Allow at most 3 warning suppressions
-     * const suppressions = Param.string(Param.flagKind, "suppress").pipe(
+     * const suppressions = Param.String(Param.flagKind, "suppress").pipe(
      *   Param.atMost(3)
      * )
      *
@@ -1779,7 +1771,7 @@ export declare const atMost: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Allow at most 3 warning suppressions
-     * const suppressions = Param.string(Param.flagKind, "suppress").pipe(
+     * const suppressions = Param.String(Param.flagKind, "suppress").pipe(
      *   Param.atMost(3)
      * )
      *
@@ -1807,7 +1799,7 @@ export declare const atMost: {
  * import { Param } from "effect/unstable/cli"
  *
  * // Require at least 2 input files
- * const inputs = Param.string(Param.flagKind, "input").pipe(
+ * const inputs = Param.String(Param.flagKind, "input").pipe(
  *   Param.atLeast(2),
  *   Param.withAlias("-i")
  * )
@@ -1835,7 +1827,7 @@ export declare const atLeast: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Require at least 2 input files
-     * const inputs = Param.string(Param.flagKind, "input").pipe(
+     * const inputs = Param.String(Param.flagKind, "input").pipe(
      *   Param.atLeast(2),
      *   Param.withAlias("-i")
      * )
@@ -1863,7 +1855,7 @@ export declare const atLeast: {
      * import { Param } from "effect/unstable/cli"
      *
      * // Require at least 2 input files
-     * const inputs = Param.string(Param.flagKind, "input").pipe(
+     * const inputs = Param.String(Param.flagKind, "input").pipe(
      *   Param.atLeast(2),
      *   Param.withAlias("-i")
      * )
@@ -1892,7 +1884,7 @@ export declare const atLeast: {
  * ```ts import.meta.vitest
  * import { Option } from "effect"
  * import { Param } from "effect/unstable/cli"
- * const positiveInt = Param.integer(Param.flagKind, "count").pipe(
+ * const positiveInt = Param.Int(Param.flagKind, "count").pipe(
  *   Param.filterMap(
  *     (n) => n > 0 ? Option.some(n) : Option.none(),
  *     (n) => `Expected positive integer, got ${n}`
@@ -1919,7 +1911,7 @@ export declare const filterMap: {
      * ```ts import.meta.vitest
      * import { Option } from "effect"
      * import { Param } from "effect/unstable/cli"
-     * const positiveInt = Param.integer(Param.flagKind, "count").pipe(
+     * const positiveInt = Param.Int(Param.flagKind, "count").pipe(
      *   Param.filterMap(
      *     (n) => n > 0 ? Option.some(n) : Option.none(),
      *     (n) => `Expected positive integer, got ${n}`
@@ -1946,7 +1938,7 @@ export declare const filterMap: {
      * ```ts import.meta.vitest
      * import { Option } from "effect"
      * import { Param } from "effect/unstable/cli"
-     * const positiveInt = Param.integer(Param.flagKind, "count").pipe(
+     * const positiveInt = Param.Int(Param.flagKind, "count").pipe(
      *   Param.filterMap(
      *     (n) => n > 0 ? Option.some(n) : Option.none(),
      *     (n) => `Expected positive integer, got ${n}`
@@ -1968,7 +1960,7 @@ export declare const filterMap: {
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const evenNumber = Param.integer(Param.flagKind, "num").pipe(
+ * const evenNumber = Param.Int(Param.flagKind, "num").pipe(
  *   Param.filter(
  *     (n) => n % 2 === 0,
  *     (n) => `Expected even number, got ${n}`
@@ -1989,7 +1981,7 @@ export declare const filter: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const evenNumber = Param.integer(Param.flagKind, "num").pipe(
+     * const evenNumber = Param.Int(Param.flagKind, "num").pipe(
      *   Param.filter(
      *     (n) => n % 2 === 0,
      *     (n) => `Expected even number, got ${n}`
@@ -2010,7 +2002,7 @@ export declare const filter: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const evenNumber = Param.integer(Param.flagKind, "num").pipe(
+     * const evenNumber = Param.Int(Param.flagKind, "num").pipe(
      *   Param.filter(
      *     (n) => n % 2 === 0,
      *     (n) => `Expected even number, got ${n}`
@@ -2037,7 +2029,7 @@ export declare const filter: {
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const port = Param.integer(Param.flagKind, "port").pipe(
+ * const port = Param.Int(Param.flagKind, "port").pipe(
  *   Param.withMetavar("PORT"),
  *   Param.filter(
  *     (p) => p >= 1 && p <= 65535,
@@ -2064,7 +2056,7 @@ export declare const withMetavar: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const port = Param.integer(Param.flagKind, "port").pipe(
+     * const port = Param.Int(Param.flagKind, "port").pipe(
      *   Param.withMetavar("PORT"),
      *   Param.filter(
      *     (p) => p >= 1 && p <= 65535,
@@ -2091,7 +2083,7 @@ export declare const withMetavar: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const port = Param.integer(Param.flagKind, "port").pipe(
+     * const port = Param.Int(Param.flagKind, "port").pipe(
      *   Param.withMetavar("PORT"),
      *   Param.filter(
      *     (p) => p >= 1 && p <= 65535,
@@ -2120,7 +2112,7 @@ export declare const withMetavar: {
  *   Schema.check(isEmail)
  * )
  *
- * const email = Param.string(Param.flagKind, "email").pipe(
+ * const email = Param.String(Param.flagKind, "email").pipe(
  *   Param.withSchema(Email)
  * )
  * email.kind // => "flag"
@@ -2144,7 +2136,7 @@ export declare const withSchema: {
      *   Schema.check(isEmail)
      * )
      *
-     * const email = Param.string(Param.flagKind, "email").pipe(
+     * const email = Param.String(Param.flagKind, "email").pipe(
      *   Param.withSchema(Email)
      * )
      * email.kind // => "flag"
@@ -2168,7 +2160,7 @@ export declare const withSchema: {
      *   Schema.check(isEmail)
      * )
      *
-     * const email = Param.string(Param.flagKind, "email").pipe(
+     * const email = Param.String(Param.flagKind, "email").pipe(
      *   Param.withSchema(Email)
      * )
      * email.kind // => "flag"
@@ -2187,8 +2179,8 @@ export declare const withSchema: {
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const config = Param.file(Param.flagKind, "config").pipe(
- *   Param.orElse(() => Param.string(Param.flagKind, "config-url"))
+ * const config = Param.File(Param.flagKind, "config").pipe(
+ *   Param.orElse(() => Param.String(Param.flagKind, "config-url"))
  * )
  * config.kind // => "flag"
  * ```
@@ -2205,8 +2197,8 @@ export declare const orElse: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const config = Param.file(Param.flagKind, "config").pipe(
-     *   Param.orElse(() => Param.string(Param.flagKind, "config-url"))
+     * const config = Param.File(Param.flagKind, "config").pipe(
+     *   Param.orElse(() => Param.String(Param.flagKind, "config-url"))
      * )
      * config.kind // => "flag"
      * ```
@@ -2223,8 +2215,8 @@ export declare const orElse: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const config = Param.file(Param.flagKind, "config").pipe(
-     *   Param.orElse(() => Param.string(Param.flagKind, "config-url"))
+     * const config = Param.File(Param.flagKind, "config").pipe(
+     *   Param.orElse(() => Param.String(Param.flagKind, "config-url"))
      * )
      * config.kind // => "flag"
      * ```
@@ -2248,8 +2240,8 @@ export declare const orElse: {
  * ```ts import.meta.vitest
  * import { Param } from "effect/unstable/cli"
  *
- * const configSource = Param.file(Param.flagKind, "config").pipe(
- *   Param.orElseResult(() => Param.string(Param.flagKind, "config-url"))
+ * const configSource = Param.File(Param.flagKind, "config").pipe(
+ *   Param.orElseResult(() => Param.String(Param.flagKind, "config-url"))
  * )
  * // Returns Result<string, string>
  * configSource.kind // => "flag"
@@ -2273,8 +2265,8 @@ export declare const orElseResult: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const configSource = Param.file(Param.flagKind, "config").pipe(
-     *   Param.orElseResult(() => Param.string(Param.flagKind, "config-url"))
+     * const configSource = Param.File(Param.flagKind, "config").pipe(
+     *   Param.orElseResult(() => Param.String(Param.flagKind, "config-url"))
      * )
      * // Returns Result<string, string>
      * configSource.kind // => "flag"
@@ -2298,8 +2290,8 @@ export declare const orElseResult: {
      * ```ts import.meta.vitest
      * import { Param } from "effect/unstable/cli"
      *
-     * const configSource = Param.file(Param.flagKind, "config").pipe(
-     *   Param.orElseResult(() => Param.string(Param.flagKind, "config-url"))
+     * const configSource = Param.File(Param.flagKind, "config").pipe(
+     *   Param.orElseResult(() => Param.String(Param.flagKind, "config-url"))
      * )
      * // Returns Result<string, string>
      * configSource.kind // => "flag"