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

package/dist/unstable/cli/Param.js

@@ -67,7 +67,7 @@ const Proto = {
  * ```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
  * ```
@@ -84,7 +84,7 @@ export const isParam = u => Predicate.hasProperty(u, TypeId);
  * ```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
@@ -133,10 +133,10 @@ export const makeSingle = 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"]
@@ -145,9 +145,9 @@ export const makeSingle = params => {
  * @category constructors
  * @since 4.0.0
  */
-export const string = (kind, name) => makeSingle({
+export const String = (kind, name) => makeSingle({
   name,
-  primitiveType: Primitive.string,
+  primitiveType: Primitive.String,
   kind
 });
 /**
@@ -159,10 +159,10 @@ export const string = (kind, name) => makeSingle({
  * 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.
@@ -173,9 +173,9 @@ export const string = (kind, name) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const boolean = (kind, name) => makeSingle({
+export const Boolean = (kind, name) => makeSingle({
   name,
-  primitiveType: Primitive.boolean,
+  primitiveType: Primitive.Boolean,
   kind
 });
 /**
@@ -187,10 +187,10 @@ export const boolean = (kind, name) => makeSingle({
  * 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"]
@@ -199,35 +199,32 @@ export const boolean = (kind, name) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const integer = (kind, name) => makeSingle({
+export const Int = (kind, name) => makeSingle({
   name,
-  primitiveType: Primitive.integer,
+  primitiveType: Primitive.Int,
   kind
 });
 /**
- * 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 const float = (kind, name) => makeSingle({
+export const Finite = (kind, name) => makeSingle({
   name,
-  primitiveType: Primitive.float,
+  primitiveType: Primitive.Finite,
   kind
 });
 /**
@@ -239,10 +236,10 @@ export const float = (kind, name) => makeSingle({
  * 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
@@ -252,9 +249,9 @@ export const float = (kind, name) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const date = (kind, name) => makeSingle({
+export const Date = (kind, name) => makeSingle({
   name,
-  primitiveType: Primitive.date,
+  primitiveType: Primitive.Date,
   kind
 });
 /**
@@ -276,7 +273,7 @@ export const date = (kind, name) => makeSingle({
  *   readonly _tag: "Cat"
  * }
  *
- * const animal = Param.choiceWithValue(Param.flagKind, "animal", [
+ * const animal = Param.ChoiceWithValue(Param.flagKind, "animal", [
  *   ["dog", { _tag: "Dog" }],
  *   ["cat", { _tag: "Cat" }]
  * ])
@@ -286,9 +283,9 @@ export const date = (kind, name) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const choiceWithValue = (kind, name, choices) => makeSingle({
+export const ChoiceWithValue = (kind, name, choices) => makeSingle({
   name,
-  primitiveType: Primitive.choice(choices),
+  primitiveType: Primitive.Choice(choices),
   kind
 });
 /**
@@ -300,7 +297,7 @@ export const choiceWithValue = (kind, name, choices) => makeSingle({
  * ```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",
@@ -312,9 +309,9 @@ export const choiceWithValue = (kind, name, choices) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const choice = (kind, name, choices) => {
+export const Literals = (kind, name, choices) => {
   const mappedChoices = choices.map(value => [value, value]);
-  return choiceWithValue(kind, name, mappedChoices);
+  return ChoiceWithValue(kind, name, mappedChoices);
 };
 /**
  * Creates a path parameter that accepts file or directory paths.
@@ -325,13 +322,13 @@ export const choice = (kind, name, choices) => {
  * 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"
@@ -342,10 +339,10 @@ export const choice = (kind, name, choices) => {
  * @category constructors
  * @since 4.0.0
  */
-export const path = (kind, name, options) => makeSingle({
+export const Path = (kind, name, options) => makeSingle({
   name,
   kind,
-  primitiveType: Primitive.path(options?.pathType ?? "either", options?.mustExist),
+  primitiveType: Primitive.Path(options?.pathType ?? "either", options?.mustExist),
   typeName: options?.typeName
 });
 /**
@@ -362,10 +359,10 @@ export const path = (kind, name, options) => makeSingle({
  * 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"]
@@ -374,7 +371,7 @@ export const path = (kind, name, options) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const directory = (kind, name, options) => path(kind, name, {
+export const Directory = (kind, name, options) => Path(kind, name, {
   pathType: "directory",
   typeName: "directory",
   mustExist: options?.mustExist
@@ -393,10 +390,10 @@ export const directory = (kind, name, options) => path(kind, name, {
  * 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"]
@@ -405,7 +402,7 @@ export const directory = (kind, name, options) => path(kind, name, {
  * @category constructors
  * @since 4.0.0
  */
-export const file = (kind, name, options) => path(kind, name, {
+export const File = (kind, name, options) => Path(kind, name, {
   pathType: "file",
   typeName: "file",
   mustExist: options?.mustExist
@@ -420,10 +417,10 @@ export const file = (kind, name, options) => path(kind, name, {
  * 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"]
@@ -432,9 +429,9 @@ export const file = (kind, name, options) => path(kind, name, {
  * @category constructors
  * @since 4.0.0
  */
-export const redacted = (kind, name) => makeSingle({
+export const Redacted = (kind, name) => makeSingle({
   name,
-  primitiveType: Primitive.redacted,
+  primitiveType: Primitive.Redacted,
   kind
 });
 /**
@@ -446,10 +443,10 @@ export const redacted = (kind, name) => makeSingle({
  * 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"]
@@ -458,9 +455,9 @@ export const redacted = (kind, name) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const fileText = (kind, name) => makeSingle({
+export const FileText = (kind, name) => makeSingle({
   name,
-  primitiveType: Primitive.fileText,
+  primitiveType: Primitive.FileText,
   kind
 });
 /**
@@ -478,10 +475,10 @@ export const fileText = (kind, name) => makeSingle({
  *
  * // 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"]
@@ -490,9 +487,9 @@ export const fileText = (kind, name) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const fileParse = (kind, name, options) => makeSingle({
+export const FileParse = (kind, name, options) => makeSingle({
   name,
-  primitiveType: Primitive.fileParse(options),
+  primitiveType: Primitive.FileParse(options),
   kind
 });
 /**
@@ -509,12 +506,12 @@ export const fileParse = (kind, name, options) => makeSingle({
  *   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"
  * })
  *
@@ -525,9 +522,9 @@ export const fileParse = (kind, name, options) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const fileSchema = (kind, name, schema, options) => makeSingle({
+export const FileSchema = (kind, name, schema, options) => makeSingle({
   name,
-  primitiveType: Primitive.fileSchema(schema, options),
+  primitiveType: Primitive.FileSchema(schema, options),
   kind
 });
 /**
@@ -548,10 +545,10 @@ export const fileSchema = (kind, name, schema, options) => makeSingle({
  * ```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"]
  * ```
@@ -559,30 +556,25 @@ export const fileSchema = (kind, name, schema, options) => makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const keyValuePair = (kind, name) => map(variadic(makeSingle({
+export const KeyValuePair = (kind, name) => map(variadic(makeSingle({
   name,
-  primitiveType: Primitive.keyValuePair,
+  primitiveType: Primitive.KeyValuePair,
   kind
 }), {
   min: 1
 }), objects => Object.fromEntries(objects.flatMap(Object.entries)));
 /**
- * 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
@@ -591,9 +583,9 @@ export const keyValuePair = (kind, name) => map(variadic(makeSingle({
  * @category constructors
  * @since 4.0.0
  */
-export const none = kind => makeSingle({
-  name: "__none__",
-  primitiveType: Primitive.none,
+export const Never = kind => makeSingle({
+  name: "__never__",
+  primitiveType: Primitive.Never,
   kind
 });
 const FLAG_DASH_REGEXP = /^-+/;
@@ -615,13 +607,13 @@ const FLAG_DASH_REGEXP = /^-+/;
  * ```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
  * )
@@ -650,7 +642,7 @@ export const withAlias = /*#__PURE__*/dual(2, (self, alias) => {
  * ```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")
  * )
@@ -680,7 +672,7 @@ export const withDescription = /*#__PURE__*/dual(2, (self, description) => {
  * ```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"
@@ -701,7 +693,7 @@ export const withHidden = self => transformSingle(self, single => makeSingle({
  * ```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"
@@ -758,7 +750,7 @@ const transform = (self, f, alternatives = []) => {
  *   )
  * )
  *
- * const validatedEmail = Param.string(Param.flagKind, "email").pipe(
+ * const validatedEmail = Param.String(Param.flagKind, "email").pipe(
  *   Param.mapEffect((email) =>
  *     email.includes("@")
  *       ? Effect.succeed(email)
@@ -814,7 +806,7 @@ export const mapEffect = /*#__PURE__*/dual(2, (self, f) => transform(self, parse
  *   )
  * )
  *
- * const parsedJson = Param.string(Param.flagKind, "config").pipe(
+ * const parsedJson = Param.String(Param.flagKind, "config").pipe(
  *   Param.mapTryCatch(
  *     (str) => JSON.parse(str),
  *     (error) =>
@@ -841,7 +833,7 @@ export const mapTryCatch = /*#__PURE__*/dual(3, (self, f, onError) => {
     catch: error => onError(error)
   }).pipe(Effect.mapError(error => new CliError.InvalidValue({
     option: single.name,
-    value: String(a),
+    value: globalThis.String(a),
     expected: error,
     kind: single.kind
   })), Effect.map(b => [leftover, b]))));
@@ -863,7 +855,7 @@ export const mapTryCatch = /*#__PURE__*/dual(3, (self, f, onError) => {
  * // 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"
  * ```
  *
@@ -871,15 +863,12 @@ export const mapTryCatch = /*#__PURE__*/dual(3, (self, f, onError) => {
  * @since 4.0.0
  */
 export const optional = param => {
-  const parse = Effect.fnUntraced(function* (args) {
-    getUnderlyingSingleOrThrow(param);
-    return yield* param.parse(args).pipe(Effect.map(([leftover, value]) => [leftover, Option.some(value)]),
-    // Catch both MissingOption (for flags) and MissingArgument (for positional arguments)
-    Effect.catchTags({
-      MissingOption: () => Effect.succeed([args.arguments, Option.none()]),
-      MissingArgument: () => Effect.succeed([args.arguments, Option.none()])
-    }));
-  });
+  const parse = args => param.parse(args).pipe(Effect.map(([leftover, value]) => [leftover, Option.some(value)]),
+  // Catch both MissingOption (for flags) and MissingArgument (for positional arguments)
+  Effect.catchTags({
+    MissingOption: () => Effect.succeed([args.arguments, Option.none()]),
+    MissingArgument: () => Effect.succeed([args.arguments, Option.none()])
+  }));
   return Object.assign(Object.create(Proto), {
     _tag: "Optional",
     kind: param.kind,
@@ -901,12 +890,12 @@ export const optional = param => {
  * 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)
@@ -1007,16 +996,16 @@ export const withFallbackPrompt = /*#__PURE__*/dual(2, (self, prompt) => {
  * 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
  * })
@@ -1058,7 +1047,7 @@ export const variadic = (self, options) => {
  * 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")
  * )
@@ -1067,7 +1056,7 @@ export const variadic = (self, options) => {
  * // 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)
  * )
  *
@@ -1105,7 +1094,7 @@ export const between = /*#__PURE__*/dual(3, (self, min, max) => {
  * 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)
  * )
  *
@@ -1139,7 +1128,7 @@ export const atMost = /*#__PURE__*/dual(2, (self, max) => {
  * 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")
  * )
@@ -1174,7 +1163,7 @@ export const atLeast = /*#__PURE__*/dual(2, (self, min) => {
  * ```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}`
@@ -1194,7 +1183,7 @@ export const filterMap = /*#__PURE__*/dual(3, (self, filter, onNone) => mapEffec
   const single = getUnderlyingSingleOrThrow(self);
   return yield* new CliError.InvalidValue({
     option: single.name,
-    value: String(a),
+    value: globalThis.String(a),
     expected: onNone(a),
     kind: single.kind
   });
@@ -1207,7 +1196,7 @@ export const filterMap = /*#__PURE__*/dual(3, (self, filter, onNone) => mapEffec
  * ```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}`
@@ -1233,7 +1222,7 @@ export const filter = /*#__PURE__*/dual(3, (self, predicate, onFalse) => filterM
  * ```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,
@@ -1264,7 +1253,7 @@ export const withMetavar = /*#__PURE__*/dual(2, (self, metavar) => transformSing
  *   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"
@@ -1279,7 +1268,7 @@ export const withSchema = /*#__PURE__*/dual(2, (self, schema) => {
     const single = getUnderlyingSingleOrThrow(self);
     return new CliError.InvalidValue({
       option: single.name,
-      value: String(value),
+      value: globalThis.String(value),
       expected: `Schema validation failed: ${error.message}`,
       kind: single.kind
     });
@@ -1293,8 +1282,8 @@ export const withSchema = /*#__PURE__*/dual(2, (self, schema) => {
  * ```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"
  * ```
@@ -1317,8 +1306,8 @@ export const orElse = /*#__PURE__*/dual(2, (self, orElse) => transform(self, (pa
  * ```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"
@@ -1381,7 +1370,9 @@ const parsePositionalVariadic = /*#__PURE__*/Effect.fnUntraced(function* (self,
     count++;
   }
   if (count < minValue) {
-    return yield* new CliError.InvalidValue({
+    return yield* count === 0 ? new CliError.MissingArgument({
+      argument: single.name
+    }) : new CliError.InvalidValue({
       option: single.name,
       value: `${count} values`,
       expected: `at least ${minValue} value${minValue === 1 ? "" : "s"}`,