Skip to content

StringArgDefinition

Definition of a string arg.

Signatures

ts
interface StringArgDefinition extends ArgDefinitionBase {}

Members

Properties

aggregateStandard

Standard Schema v1 validator applied to a completed collection.

ts
aggregateStandard?: StandardSchemaV1<unknown, unknown>;

configPath

Dotted config path for config resolution (e.g. 'deploy.region').

ts
configPath?: string;

defaultValue

Runtime default value.

ts
defaultValue?: unknown;

deprecated

Deprecation marker. true deprecates without a message, a string carries the migration guidance.

ts
deprecated?: string | true;

description

Human-readable description for help text.

ts
description?: string;

envVar

Environment variable name for env resolution.

ts
envVar?: string;

kind

Kind discriminator.

ts
kind: "string";

pathChecks

Filesystem checks applied after resolution.

ts
pathChecks?: PathChecks;

presence

Presence state.

ts
presence?: "optional" | "required" | "defaulted";

prompt

Interactive prompt configuration.

ts
prompt?: PromptConfig;

separator

CLI value separator each positional token is split on.

ts
separator?: string;

split

Env and stdin split policies.

ts
split?: SourceSplitBinding;

standard

Standard Schema v1 validator applied to each resolved value.

ts
standard?: StandardSchemaV1<unknown, unknown>;

stdin

Stdin binding. See StdinOptions.

ts
stdin?: StdinOptions;

stringConstraints

String constraints enforced at the parse and resolution boundaries.

ts
stringConstraints?: StringConstraints;

unique

Deduplicate the resolved values of a variadic arg.

ts
unique?: boolean;

valueHint

Help placeholder label ('url', 'path', …).

ts
valueHint?: string;

variadic

Whether this arg consumes all remaining positionals.

ts
variadic?: boolean;

See Also

Released under the MIT License.