@kjanat/dreamcli 4.0.0-rc.2 → 4.0.0-rc.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +510 -1847
- package/dist/core/cli/builtins.d.mts +74 -4
- package/dist/core/cli/compiled.d.mts +39 -2
- package/dist/core/cli/dispatch.d.mts +81 -4
- package/dist/core/cli/help-links.d.mts +13 -1
- package/dist/core/cli/index.d.mts +77 -12
- package/dist/core/cli/index.mjs +9 -3
- package/dist/core/cli/planner.d.mts +86 -8
- package/dist/core/cli/reserved-flags.d.mts +19 -1
- package/dist/core/cli/root-help.d.mts +53 -1
- package/dist/core/cli/root-help.mjs +1 -1
- package/dist/core/cli/root-output-flags.d.mts +74 -1
- package/dist/core/cli/root-surface.d.mts +64 -1
- package/dist/core/cli/runtime-preflight.d.mts +213 -1
- package/dist/core/completion/index.d.mts +2 -2
- package/dist/core/completion/shells/bash.d.mts +1 -0
- package/dist/core/completion/shells/bash.mjs +4 -1
- package/dist/core/completion/shells/fish.d.mts +1 -0
- package/dist/core/completion/shells/fish.mjs +2 -1
- package/dist/core/completion/shells/powershell.d.mts +1 -0
- package/dist/core/completion/shells/powershell.mjs +2 -1
- package/dist/core/completion/shells/shared.d.mts +118 -3
- package/dist/core/completion/shells/shared.mjs +1 -1
- package/dist/core/completion/shells/zsh.d.mts +1 -0
- package/dist/core/completion/shells/zsh.mjs +6 -2
- package/dist/core/config/index.d.mts +1 -1
- package/dist/core/config/package-json.d.mts +1 -1
- package/dist/core/errors/index.d.mts +17 -18
- package/dist/core/execution/index.d.mts +61 -1
- package/dist/core/help/ansi.d.mts +11 -0
- package/dist/core/help/index.d.mts +42 -3
- package/dist/core/help/index.mjs +14 -10
- package/dist/core/help/theme.d.mts +39 -1
- package/dist/core/help/theme.mjs +24 -1
- package/dist/core/json-schema/index.d.mts +11 -11
- package/dist/core/json-schema/index.mjs +7 -6
- package/dist/core/output/activity.d.mts +193 -1
- package/dist/core/output/bind.d.mts +37 -1
- package/dist/core/output/contracts.d.mts +5 -4
- package/dist/core/output/display-value.d.mts +19 -1
- package/dist/core/output/index.d.mts +191 -7
- package/dist/core/output/index.mjs +6 -4
- package/dist/core/output/renderers.d.mts +45 -1
- package/dist/core/parse/index.d.mts +4 -4
- package/dist/core/parse/occurrences.d.mts +9 -8
- package/dist/core/prompt/index.d.mts +3 -3
- package/dist/core/read-flags/index.d.mts +1 -1
- package/dist/core/resolve/coerce.d.mts +4 -4
- package/dist/core/resolve/config.d.mts +10 -1
- package/dist/core/resolve/contracts.d.mts +9 -8
- package/dist/core/resolve/flags.d.mts +28 -1
- package/dist/core/resolve/path-checks.d.mts +4 -3
- package/dist/core/resolve/redaction.d.mts +1 -0
- package/dist/core/resolve/stages.d.mts +7 -6
- package/dist/core/resolve/standard.d.mts +26 -1
- package/dist/core/schema/activity.d.mts +16 -16
- package/dist/core/schema/arg.d.mts +76 -66
- package/dist/core/schema/brand.d.mts +1 -1
- package/dist/core/schema/cardinality.d.mts +18 -17
- package/dist/core/schema/command.d.mts +55 -9
- package/dist/core/schema/flag.d.mts +98 -90
- package/dist/core/schema/index.d.mts +1 -1
- package/dist/core/schema/middleware.d.mts +4 -1
- package/dist/core/schema/number-constraints.d.mts +5 -5
- package/dist/core/schema/prompt.d.mts +4 -4
- package/dist/core/schema/provenance.d.mts +11 -11
- package/dist/core/schema/run.d.mts +58 -8
- package/dist/core/schema/source.d.mts +13 -12
- package/dist/core/schema/standard.d.mts +31 -24
- package/dist/core/schema/stdin.d.mts +12 -2
- package/dist/core/schema/string-constraints.d.mts +4 -4
- package/dist/core/schema/value-parsers.d.mts +3 -3
- package/dist/core/schema/value.d.mts +15 -14
- package/dist/core/testkit/index.d.mts +10 -3
- package/dist/index.d.mts +6 -6
- package/dist/runtime/adapter.d.mts +3 -3
- package/dist/runtime/deno.d.mts +3 -3
- package/dist/runtime/detect.d.mts +2 -2
- package/dist/runtime/node.d.mts +3 -3
- package/dist/runtime/paths.d.mts +31 -1
- package/dist/strings.d.mts +16 -1
- package/dist/version.d.mts +16 -4
- package/dist/version.mjs +2 -2
- package/package.json +11 -8
- package/skills/cli-creation/SKILL.md +1 -1
- package/examples/gh/node_modules/typescript/LICENSE +0 -55
- package/examples/gh/node_modules/typescript/NOTICE.txt +0 -436
- package/examples/gh/node_modules/typescript/README.md +0 -49
- package/examples/gh/node_modules/typescript/bin/tsc +0 -2
- package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts +0 -529
- package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/async/api.js +0 -1657
- package/examples/gh/node_modules/typescript/dist/api/async/api.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts +0 -39
- package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/async/client.js +0 -211
- package/examples/gh/node_modules/typescript/dist/api/async/client.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts +0 -310
- package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/async/types.js +0 -2
- package/examples/gh/node_modules/typescript/dist/api/async/types.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts +0 -109
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js +0 -2
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/fs.d.ts +0 -23
- package/examples/gh/node_modules/typescript/dist/api/fs.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/fs.js +0 -109
- package/examples/gh/node_modules/typescript/dist/api/fs.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts +0 -15
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts +0 -5
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js +0 -74
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.js +0 -287
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts +0 -32
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js +0 -213
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts +0 -76
- package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts +0 -182
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js +0 -835
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts +0 -62
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js +0 -122
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/node.js +0 -298
- package/examples/gh/node_modules/typescript/dist/api/node/node.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts +0 -29
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts +0 -4
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js +0 -241
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.js +0 -30
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts +0 -6
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js +0 -61
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/options.d.ts +0 -32
- package/examples/gh/node_modules/typescript/dist/api/options.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/options.js +0 -11
- package/examples/gh/node_modules/typescript/dist/api/options.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/path.d.ts +0 -110
- package/examples/gh/node_modules/typescript/dist/api/path.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/path.js +0 -508
- package/examples/gh/node_modules/typescript/dist/api/path.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/proto.d.ts +0 -239
- package/examples/gh/node_modules/typescript/dist/api/proto.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/proto.js +0 -37
- package/examples/gh/node_modules/typescript/dist/api/proto.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts +0 -79
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js +0 -169
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts +0 -529
- package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sync/api.js +0 -1665
- package/examples/gh/node_modules/typescript/dist/api/sync/api.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts +0 -30
- package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sync/client.js +0 -124
- package/examples/gh/node_modules/typescript/dist/api/sync/client.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts +0 -310
- package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/sync/types.js +0 -2
- package/examples/gh/node_modules/typescript/dist/api/sync/types.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts +0 -114
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.js +0 -508
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/timing.d.ts +0 -175
- package/examples/gh/node_modules/typescript/dist/api/timing.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/api/timing.js +0 -149
- package/examples/gh/node_modules/typescript/dist/api/timing.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts +0 -100
- package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts +0 -1161
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js +0 -4
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/ast.js +0 -7
- package/examples/gh/node_modules/typescript/dist/ast/ast.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts +0 -19
- package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/astnav.js +0 -596
- package/examples/gh/node_modules/typescript/dist/ast/astnav.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts +0 -16
- package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/clone.js +0 -104
- package/examples/gh/node_modules/typescript/dist/ast/clone.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts +0 -520
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js +0 -3057
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/index.d.ts +0 -20
- package/examples/gh/node_modules/typescript/dist/ast/index.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/index.js +0 -20
- package/examples/gh/node_modules/typescript/dist/ast/index.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/is.d.ts +0 -35
- package/examples/gh/node_modules/typescript/dist/ast/is.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts +0 -329
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.js +0 -1103
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/is.js +0 -233
- package/examples/gh/node_modules/typescript/dist/ast/is.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts +0 -11
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js +0 -202
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts +0 -97
- package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/scanner.js +0 -2230
- package/examples/gh/node_modules/typescript/dist/ast/scanner.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts +0 -17
- package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/utils.js +0 -67
- package/examples/gh/node_modules/typescript/dist/ast/utils.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts +0 -14
- package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts +0 -50
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js +0 -978
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/ast/visitor.js +0 -47
- package/examples/gh/node_modules/typescript/dist/ast/visitor.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts +0 -129
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js +0 -132
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js +0 -130
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts +0 -5
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js +0 -6
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js +0 -6
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts +0 -28
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js +0 -30
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js +0 -30
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts +0 -7
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts +0 -12
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js +0 -14
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js +0 -14
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts +0 -23
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js +0 -25
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js +0 -25
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js +0 -11
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js +0 -11
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts +0 -5
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js +0 -6
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js +0 -6
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts +0 -42
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js +0 -44
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js +0 -44
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts +0 -7
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts +0 -17
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js +0 -19
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js +0 -19
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js +0 -11
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js +0 -11
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts +0 -6
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js +0 -8
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js +0 -8
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts +0 -36
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js +0 -38
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js +0 -38
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts +0 -44
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js +0 -46
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js +0 -46
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts +0 -50
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js +0 -52
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js +0 -52
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts +0 -16
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js +0 -18
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js +0 -18
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts +0 -13
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js +0 -14
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js +0 -14
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts +0 -11
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js +0 -12
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js +0 -12
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts +0 -17
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js +0 -18
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js +0 -18
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts +0 -15
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js +0 -17
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js +0 -17
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts +0 -5
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js +0 -7
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js +0 -7
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts +0 -71
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js +0 -73
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js +0 -73
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts +0 -389
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js +0 -391
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js +0 -391
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts +0 -30
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js +0 -32
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js +0 -32
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts +0 -76
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js +0 -78
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js +0 -78
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts +0 -2
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts +0 -7
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js +0 -9
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js.map +0 -1
- package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts +0 -23
- package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts.map +0 -1
- package/examples/gh/node_modules/typescript/dist/internal/utils.js +0 -25
- package/examples/gh/node_modules/typescript/dist/internal/utils.js.map +0 -1
- package/examples/gh/node_modules/typescript/lib/getExePath.d.ts +0 -2
- package/examples/gh/node_modules/typescript/lib/getExePath.js +0 -70
- package/examples/gh/node_modules/typescript/lib/tsc.js +0 -28
- package/examples/gh/node_modules/typescript/lib/version.cjs +0 -3
- package/examples/gh/node_modules/typescript/lib/version.d.cts +0 -2
- package/examples/gh/node_modules/typescript/package.json +0 -87
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/License.txt +0 -11
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/README.md +0 -54
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.d.ts +0 -17
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.js +0 -83
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.d.ts +0 -22
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.js +0 -210
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.d.ts +0 -14
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.js +0 -87
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.d.ts +0 -32
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.js +0 -132
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.d.ts +0 -367
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.js +0 -1271
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.d.ts +0 -9
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.js +0 -16
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.d.ts +0 -52
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.js +0 -70
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.d.ts +0 -39
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.js +0 -135
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.d.ts +0 -7
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.js +0 -34
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.d.ts +0 -55
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.js +0 -412
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.d.ts +0 -18
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.js +0 -155
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.d.ts +0 -77
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.js +0 -246
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.d.ts +0 -60
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.js +0 -157
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.d.ts +0 -369
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.js +0 -436
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.d.ts +0 -74
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.js +0 -23
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.d.ts +0 -10
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.js +0 -74
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.d.ts +0 -15
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.js +0 -77
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.d.ts +0 -58
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.js +0 -289
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.d.ts +0 -12
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.js +0 -163
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/package.json +0 -54
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/typings/thenable.d.ts +0 -5
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { schemaBrand } from "./brand.mjs";
|
|
2
|
+
import { HelpDescription } from "../help/theme.mjs";
|
|
2
3
|
import { NumberConstraints } from "./number-constraints.mjs";
|
|
3
4
|
import { ConfirmPromptConfig, InputPromptConfig, MultiselectPromptConfig, PROMPT_KINDS, PromptConfig, PromptConfigBase, PromptKind, PromptResult, SelectChoice, SelectPromptConfig } from "./prompt.mjs";
|
|
4
5
|
import { InferStandardOutput, StandardSchemaV1 } from "./standard.mjs";
|
|
@@ -25,7 +26,7 @@ type FlagPresence = (typeof FLAG_PRESENCES)[number];
|
|
|
25
26
|
* Most optional flags resolve to `undefined`; array flags instead resolve to
|
|
26
27
|
* an empty array `[]`, and key-value flags to an empty object `{}`.
|
|
27
28
|
*/
|
|
28
|
-
type OptionalFallback =
|
|
29
|
+
type OptionalFallback = 'undefined' | 'empty-array' | 'empty-object';
|
|
29
30
|
/**
|
|
30
31
|
* Compile-time state carried through the builder chain.
|
|
31
32
|
*
|
|
@@ -57,10 +58,10 @@ interface FlagConfig {
|
|
|
57
58
|
* Most consumers rely on inference and never reference this directly.
|
|
58
59
|
*/
|
|
59
60
|
type WithPresence<C extends FlagConfig, P extends FlagPresence> = {
|
|
60
|
-
readonly valueType: C[
|
|
61
|
+
readonly valueType: C['valueType'];
|
|
61
62
|
readonly presence: P;
|
|
62
|
-
readonly optionalFallback: C[
|
|
63
|
-
readonly flagKind: C[
|
|
63
|
+
readonly optionalFallback: C['optionalFallback'];
|
|
64
|
+
readonly flagKind: C['flagKind'];
|
|
64
65
|
readonly elementEligible: false;
|
|
65
66
|
};
|
|
66
67
|
/**
|
|
@@ -68,10 +69,10 @@ type WithPresence<C extends FlagConfig, P extends FlagPresence> = {
|
|
|
68
69
|
* element (returned by flag-level modifiers whose settings elements ignore).
|
|
69
70
|
*/
|
|
70
71
|
type WithoutElementEligibility<C extends FlagConfig> = {
|
|
71
|
-
readonly valueType: C[
|
|
72
|
-
readonly presence: C[
|
|
73
|
-
readonly optionalFallback: C[
|
|
74
|
-
readonly flagKind: C[
|
|
72
|
+
readonly valueType: C['valueType'];
|
|
73
|
+
readonly presence: C['presence'];
|
|
74
|
+
readonly optionalFallback: C['optionalFallback'];
|
|
75
|
+
readonly flagKind: C['flagKind'];
|
|
75
76
|
readonly elementEligible: false;
|
|
76
77
|
};
|
|
77
78
|
/**
|
|
@@ -85,7 +86,7 @@ type WithoutElementEligibility<C extends FlagConfig> = {
|
|
|
85
86
|
* - `'required'` → `T`
|
|
86
87
|
* - `'defaulted'` → `T`
|
|
87
88
|
*/
|
|
88
|
-
type ResolvedValue<C extends FlagConfig> = C[
|
|
89
|
+
type ResolvedValue<C extends FlagConfig> = C['presence'] extends 'optional' ? C['optionalFallback'] extends 'undefined' ? C['valueType'] | undefined : C['valueType'] : C['valueType'];
|
|
89
90
|
/**
|
|
90
91
|
* The element config a collection factory assumes when given no element
|
|
91
92
|
* builder: an unconstrained string.
|
|
@@ -94,11 +95,11 @@ type StringElementConfig = {
|
|
|
94
95
|
/** Element value type. */
|
|
95
96
|
readonly valueType: string;
|
|
96
97
|
/** Elements carry no presence of their own. */
|
|
97
|
-
readonly presence:
|
|
98
|
+
readonly presence: 'optional';
|
|
98
99
|
/** Elements carry no fallback of their own. */
|
|
99
|
-
readonly optionalFallback:
|
|
100
|
+
readonly optionalFallback: 'undefined';
|
|
100
101
|
/** Element kind discriminator. */
|
|
101
|
-
readonly flagKind:
|
|
102
|
+
readonly flagKind: 'string';
|
|
102
103
|
/** Elements are element-eligible by construction. */
|
|
103
104
|
readonly elementEligible: true;
|
|
104
105
|
};
|
|
@@ -130,7 +131,7 @@ type PromptConfigByFlagKind = {
|
|
|
130
131
|
readonly keyValue: never;
|
|
131
132
|
};
|
|
132
133
|
/** Prompt configuration compatible with the kind carried by a {@link FlagConfig}. */
|
|
133
|
-
type AllowedPromptConfig<C extends FlagConfig> = PromptConfigByFlagKind[C[
|
|
134
|
+
type AllowedPromptConfig<C extends FlagConfig> = PromptConfigByFlagKind[C['flagKind']];
|
|
134
135
|
/** All flag kind discriminators as a runtime array. */
|
|
135
136
|
declare const FLAG_KINDS: readonly ["string", "number", "boolean", "enum", "array", "custom", "count", "keyValue"];
|
|
136
137
|
/** Discriminator for the kind of value a flag accepts. */
|
|
@@ -180,7 +181,7 @@ interface FlagNegation {
|
|
|
180
181
|
*
|
|
181
182
|
* @defaultValue `'last'`
|
|
182
183
|
*/
|
|
183
|
-
type DuplicatePolicy =
|
|
184
|
+
type DuplicatePolicy = 'last' | 'first' | 'error';
|
|
184
185
|
/**
|
|
185
186
|
* The runtime descriptor stored inside every {@linkcode FlagBuilder}. Consumers (parser,
|
|
186
187
|
* help generator, resolution chain) read this to understand the flag's shape
|
|
@@ -188,7 +189,7 @@ type DuplicatePolicy = "last" | "first" | "error";
|
|
|
188
189
|
*/
|
|
189
190
|
interface FlagSchema<K extends FlagKind = FlagKind> {
|
|
190
191
|
/** Type-only seal produced by {@link createFlagSchema}. */
|
|
191
|
-
readonly [schemaBrand]:
|
|
192
|
+
readonly [schemaBrand]: 'flag';
|
|
192
193
|
/** What kind of value this flag accepts. */
|
|
193
194
|
readonly kind: K;
|
|
194
195
|
/** Current presence state. */
|
|
@@ -207,7 +208,7 @@ interface FlagSchema<K extends FlagKind = FlagKind> {
|
|
|
207
208
|
/** Dotted config path for v0.2+ resolution (e.g. `'deploy.region'`). */
|
|
208
209
|
readonly configPath: string | undefined;
|
|
209
210
|
/** Human-readable description for help text. */
|
|
210
|
-
readonly description:
|
|
211
|
+
readonly description: HelpDescription | undefined;
|
|
211
212
|
/** Allowed literal values when `kind === 'enum'`. */
|
|
212
213
|
readonly enumValues: readonly string[] | undefined;
|
|
213
214
|
/**
|
|
@@ -358,7 +359,7 @@ interface FlagDefinitionBase {
|
|
|
358
359
|
* Human-readable description for help text.
|
|
359
360
|
* @defaultValue `undefined`
|
|
360
361
|
*/
|
|
361
|
-
readonly description?:
|
|
362
|
+
readonly description?: HelpDescription | undefined;
|
|
362
363
|
/**
|
|
363
364
|
* Help placeholder label (`'url'` renders as `<url>`).
|
|
364
365
|
* @defaultValue `undefined`
|
|
@@ -399,7 +400,7 @@ interface FlagDefinitionBase {
|
|
|
399
400
|
/** Definition of a `string` flag. */
|
|
400
401
|
interface StringFlagDefinition extends FlagDefinitionBase {
|
|
401
402
|
/** Kind discriminator. */
|
|
402
|
-
readonly kind:
|
|
403
|
+
readonly kind: 'string';
|
|
403
404
|
/**
|
|
404
405
|
* String constraints enforced at the parse and resolution boundaries.
|
|
405
406
|
* @defaultValue `undefined`
|
|
@@ -414,7 +415,7 @@ interface StringFlagDefinition extends FlagDefinitionBase {
|
|
|
414
415
|
/** Definition of a `number` flag. */
|
|
415
416
|
interface NumberFlagDefinition extends FlagDefinitionBase {
|
|
416
417
|
/** Kind discriminator. */
|
|
417
|
-
readonly kind:
|
|
418
|
+
readonly kind: 'number';
|
|
418
419
|
/**
|
|
419
420
|
* Numeric constraints enforced at the parse and resolution boundaries.
|
|
420
421
|
* @defaultValue `undefined`
|
|
@@ -424,7 +425,7 @@ interface NumberFlagDefinition extends FlagDefinitionBase {
|
|
|
424
425
|
/** Definition of a `boolean` flag. */
|
|
425
426
|
interface BooleanFlagDefinition extends FlagDefinitionBase {
|
|
426
427
|
/** Kind discriminator. */
|
|
427
|
-
readonly kind:
|
|
428
|
+
readonly kind: 'boolean';
|
|
428
429
|
/**
|
|
429
430
|
* Negated-spelling settings. See {@link FlagNegation}.
|
|
430
431
|
* @defaultValue `undefined`
|
|
@@ -434,14 +435,14 @@ interface BooleanFlagDefinition extends FlagDefinitionBase {
|
|
|
434
435
|
/** Definition of an `enum` flag. */
|
|
435
436
|
interface EnumFlagDefinition extends FlagDefinitionBase {
|
|
436
437
|
/** Kind discriminator. */
|
|
437
|
-
readonly kind:
|
|
438
|
+
readonly kind: 'enum';
|
|
438
439
|
/** Allowed literal values. */
|
|
439
440
|
readonly enumValues: readonly string[];
|
|
440
441
|
}
|
|
441
442
|
/** Definition of an `array` flag. */
|
|
442
443
|
interface ArrayFlagDefinition extends FlagDefinitionBase {
|
|
443
444
|
/** Kind discriminator. */
|
|
444
|
-
readonly kind:
|
|
445
|
+
readonly kind: 'array';
|
|
445
446
|
/**
|
|
446
447
|
* Element definition or an already-built element schema.
|
|
447
448
|
* @defaultValue `undefined`
|
|
@@ -466,7 +467,7 @@ interface ArrayFlagDefinition extends FlagDefinitionBase {
|
|
|
466
467
|
/** Definition of a `custom` flag. */
|
|
467
468
|
interface CustomFlagDefinition extends FlagDefinitionBase {
|
|
468
469
|
/** Kind discriminator. */
|
|
469
|
-
readonly kind:
|
|
470
|
+
readonly kind: 'custom';
|
|
470
471
|
/**
|
|
471
472
|
* Parse function applied to the raw value.
|
|
472
473
|
* @defaultValue `undefined`
|
|
@@ -476,12 +477,12 @@ interface CustomFlagDefinition extends FlagDefinitionBase {
|
|
|
476
477
|
/** Definition of a `count` flag. */
|
|
477
478
|
interface CountFlagDefinition extends FlagDefinitionBase {
|
|
478
479
|
/** Kind discriminator. */
|
|
479
|
-
readonly kind:
|
|
480
|
+
readonly kind: 'count';
|
|
480
481
|
}
|
|
481
482
|
/** Definition of a `keyValue` flag. */
|
|
482
483
|
interface KeyValueFlagDefinition extends FlagDefinitionBase {
|
|
483
484
|
/** Kind discriminator. */
|
|
484
|
-
readonly kind:
|
|
485
|
+
readonly kind: 'keyValue';
|
|
485
486
|
/**
|
|
486
487
|
* Element definition or an already-built element schema for each entry value.
|
|
487
488
|
* @defaultValue `undefined`
|
|
@@ -525,9 +526,9 @@ interface FlagDefinitionByKind {
|
|
|
525
526
|
/** Definition of a flag of kind `K`, including the kind discriminator. */
|
|
526
527
|
type FlagDefinition<K extends FlagKind = FlagKind> = FlagDefinitionByKind[K];
|
|
527
528
|
/** Definition of a flag of kind `K` with the kind discriminator removed. */
|
|
528
|
-
type FlagDefinitionOverrides<K extends FlagKind = FlagKind> = Omit<FlagDefinitionByKind[K],
|
|
529
|
+
type FlagDefinitionOverrides<K extends FlagKind = FlagKind> = Omit<FlagDefinitionByKind[K], 'kind'>;
|
|
529
530
|
/** Positional factory arguments, requiring fields that the selected kind requires. */
|
|
530
|
-
type FlagDefinitionArguments<K extends FlagKind> = K extends
|
|
531
|
+
type FlagDefinitionArguments<K extends FlagKind> = K extends 'enum' ? [overrides: FlagDefinitionOverrides<K>] : [overrides?: FlagDefinitionOverrides<K>];
|
|
531
532
|
/**
|
|
532
533
|
* Normalise an alias input into a full {@link FlagAlias} object.
|
|
533
534
|
*
|
|
@@ -551,7 +552,7 @@ declare function normalizeFlagAliases(aliases: readonly (string | FlagAlias)[]):
|
|
|
551
552
|
*/
|
|
552
553
|
declare function getFlagAliasNames(schema: FlagSchema, options?: {
|
|
553
554
|
readonly includeHidden?: boolean;
|
|
554
|
-
readonly kind?:
|
|
555
|
+
readonly kind?: 'all' | 'short' | 'long';
|
|
555
556
|
}): readonly string[];
|
|
556
557
|
/**
|
|
557
558
|
* Effective negated spelling for a flag, or `undefined` when not negatable.
|
|
@@ -566,7 +567,7 @@ declare function getFlagAliasNames(schema: FlagSchema, options?: {
|
|
|
566
567
|
*/
|
|
567
568
|
declare function getFlagNegatedName(name: string, schema: FlagSchema): string | undefined;
|
|
568
569
|
/** Flag kinds that can read from stdin: every scalar, plus the collections. */
|
|
569
|
-
declare const STDIN_CAPABLE_FLAG_KINDS: readonly [
|
|
570
|
+
declare const STDIN_CAPABLE_FLAG_KINDS: readonly ['string', 'number', 'boolean', 'enum', 'custom', 'array', 'keyValue'];
|
|
570
571
|
type StdinCapableFlagKind = (typeof STDIN_CAPABLE_FLAG_KINDS)[number];
|
|
571
572
|
/**
|
|
572
573
|
* Create a raw {@link FlagSchema} object with sensible defaults.
|
|
@@ -633,6 +634,13 @@ declare function createFlagSchema<K extends FlagKind>(definition: FlagDefinition
|
|
|
633
634
|
* ```
|
|
634
635
|
*/
|
|
635
636
|
declare class FlagBuilder<C extends FlagConfig> {
|
|
637
|
+
/** @internal Runtime schema descriptor. */
|
|
638
|
+
readonly schema: FlagSchema;
|
|
639
|
+
/**
|
|
640
|
+
* @internal Type brand — exists only in the type system (`declare`
|
|
641
|
+
* produces no runtime property). Used by {@linkcode InferFlag} / {@linkcode InferFlags}.
|
|
642
|
+
*/
|
|
643
|
+
readonly _config: C;
|
|
636
644
|
/**
|
|
637
645
|
* Create a flag builder from a pre-built schema descriptor.
|
|
638
646
|
*
|
|
@@ -657,7 +665,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
657
665
|
* // $ mycli serve --port 443 → port = 443
|
|
658
666
|
* ```
|
|
659
667
|
*/
|
|
660
|
-
default<V extends C[
|
|
668
|
+
default<V extends C['valueType']>(value: V): FlagBuilder<WithPresence<C, 'defaulted'>>;
|
|
661
669
|
/**
|
|
662
670
|
* Mark the flag as required. If not resolved from any source the framework
|
|
663
671
|
* will emit a `ValidationError` before the action handler runs.
|
|
@@ -674,7 +682,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
674
682
|
* // # → target = 'staging'
|
|
675
683
|
* ```
|
|
676
684
|
*/
|
|
677
|
-
required(): FlagBuilder<WithPresence<C,
|
|
685
|
+
required(): FlagBuilder<WithPresence<C, 'required'>>;
|
|
678
686
|
/**
|
|
679
687
|
* Add a short or long alias (e.g. `'f'` for `--force`, `'verbose'` as an
|
|
680
688
|
* alternative long name).
|
|
@@ -787,7 +795,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
787
795
|
* @param description - Text displayed next to the flag in `--help`.
|
|
788
796
|
* @returns The builder (for chaining).
|
|
789
797
|
*/
|
|
790
|
-
describe(description:
|
|
798
|
+
describe(description: HelpDescription): FlagBuilder<WithoutElementEligibility<C>>;
|
|
791
799
|
/**
|
|
792
800
|
* Attach interactive prompt configuration for v0.3+ resolution.
|
|
793
801
|
*
|
|
@@ -864,7 +872,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
864
872
|
* ```
|
|
865
873
|
*/
|
|
866
874
|
int(this: FlagBuilder<C & {
|
|
867
|
-
readonly flagKind:
|
|
875
|
+
readonly flagKind: 'number';
|
|
868
876
|
}>, value?: boolean): FlagBuilder<C>;
|
|
869
877
|
/**
|
|
870
878
|
* Set an inclusive lower bound. Composes with other numeric constraints;
|
|
@@ -881,7 +889,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
881
889
|
* ```
|
|
882
890
|
*/
|
|
883
891
|
min(this: FlagBuilder<C & {
|
|
884
|
-
readonly flagKind:
|
|
892
|
+
readonly flagKind: 'number';
|
|
885
893
|
}>, value: number): FlagBuilder<C>;
|
|
886
894
|
/**
|
|
887
895
|
* Set an inclusive upper bound. Composes with other numeric constraints;
|
|
@@ -896,7 +904,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
896
904
|
* ```
|
|
897
905
|
*/
|
|
898
906
|
max(this: FlagBuilder<C & {
|
|
899
|
-
readonly flagKind:
|
|
907
|
+
readonly flagKind: 'number';
|
|
900
908
|
}>, value: number): FlagBuilder<C>;
|
|
901
909
|
/**
|
|
902
910
|
* Require (or, with `false`, allow) a finite value. Finiteness is enforced
|
|
@@ -913,7 +921,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
913
921
|
* ```
|
|
914
922
|
*/
|
|
915
923
|
finite(this: FlagBuilder<C & {
|
|
916
|
-
readonly flagKind:
|
|
924
|
+
readonly flagKind: 'number';
|
|
917
925
|
}>, allow?: boolean): FlagBuilder<C>;
|
|
918
926
|
/**
|
|
919
927
|
* Reject empty strings. Composes with other string constraints.
|
|
@@ -928,7 +936,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
928
936
|
* ```
|
|
929
937
|
*/
|
|
930
938
|
nonEmpty(this: FlagBuilder<C & {
|
|
931
|
-
readonly flagKind:
|
|
939
|
+
readonly flagKind: 'string';
|
|
932
940
|
}>, value?: boolean): FlagBuilder<C>;
|
|
933
941
|
/**
|
|
934
942
|
* Set an inclusive minimum length (UTF-16 code units). Composes with other
|
|
@@ -943,7 +951,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
943
951
|
* ```
|
|
944
952
|
*/
|
|
945
953
|
minLength(this: FlagBuilder<C & {
|
|
946
|
-
readonly flagKind:
|
|
954
|
+
readonly flagKind: 'string';
|
|
947
955
|
}>, value: number): FlagBuilder<C>;
|
|
948
956
|
/**
|
|
949
957
|
* Set an inclusive maximum length (UTF-16 code units). Composes with other
|
|
@@ -958,7 +966,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
958
966
|
* ```
|
|
959
967
|
*/
|
|
960
968
|
maxLength(this: FlagBuilder<C & {
|
|
961
|
-
readonly flagKind:
|
|
969
|
+
readonly flagKind: 'string';
|
|
962
970
|
}>, value: number): FlagBuilder<C>;
|
|
963
971
|
/**
|
|
964
972
|
* Require the value to match a regular expression. Anchor with `^`/`$`
|
|
@@ -973,7 +981,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
973
981
|
* ```
|
|
974
982
|
*/
|
|
975
983
|
pattern(this: FlagBuilder<C & {
|
|
976
|
-
readonly flagKind:
|
|
984
|
+
readonly flagKind: 'string';
|
|
977
985
|
}>, value: RegExp): FlagBuilder<C>;
|
|
978
986
|
/**
|
|
979
987
|
* Split each CLI occurrence on a separator before element coercion, so
|
|
@@ -995,7 +1003,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
995
1003
|
* ```
|
|
996
1004
|
*/
|
|
997
1005
|
separator(this: FlagBuilder<C & {
|
|
998
|
-
readonly flagKind:
|
|
1006
|
+
readonly flagKind: 'array' | 'keyValue';
|
|
999
1007
|
}>, value: string): FlagBuilder<C>;
|
|
1000
1008
|
/**
|
|
1001
1009
|
* Set how each source decodes into elements.
|
|
@@ -1023,7 +1031,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
1023
1031
|
* ```
|
|
1024
1032
|
*/
|
|
1025
1033
|
split(this: FlagBuilder<C & {
|
|
1026
|
-
readonly flagKind:
|
|
1034
|
+
readonly flagKind: 'array' | 'keyValue';
|
|
1027
1035
|
}>, options: SplitOptions): FlagBuilder<C>;
|
|
1028
1036
|
/**
|
|
1029
1037
|
* Set how a repeated key combines.
|
|
@@ -1045,7 +1053,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
1045
1053
|
* ```
|
|
1046
1054
|
*/
|
|
1047
1055
|
duplicateKeys(this: FlagBuilder<C & {
|
|
1048
|
-
readonly flagKind:
|
|
1056
|
+
readonly flagKind: 'keyValue';
|
|
1049
1057
|
}>, policy: DuplicateKeys): FlagBuilder<C>;
|
|
1050
1058
|
/**
|
|
1051
1059
|
* Validate the resolved value with a Standard Schema v1 validator.
|
|
@@ -1082,7 +1090,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
1082
1090
|
* ```
|
|
1083
1091
|
*/
|
|
1084
1092
|
unique(this: FlagBuilder<C & {
|
|
1085
|
-
readonly flagKind:
|
|
1093
|
+
readonly flagKind: 'array';
|
|
1086
1094
|
}>, value?: boolean): FlagBuilder<C>;
|
|
1087
1095
|
/**
|
|
1088
1096
|
* Accept a negated spelling (`--no-<name>`) that sets the flag to `false`.
|
|
@@ -1107,7 +1115,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
1107
1115
|
* ```
|
|
1108
1116
|
*/
|
|
1109
1117
|
negatable(this: FlagBuilder<C & {
|
|
1110
|
-
readonly flagKind:
|
|
1118
|
+
readonly flagKind: 'boolean';
|
|
1111
1119
|
}>, options?: {
|
|
1112
1120
|
alias?: string;
|
|
1113
1121
|
hidden?: boolean;
|
|
@@ -1131,7 +1139,7 @@ declare class FlagBuilder<C extends FlagConfig> {
|
|
|
1131
1139
|
* ```
|
|
1132
1140
|
*/
|
|
1133
1141
|
duplicates(this: FlagBuilder<C & {
|
|
1134
|
-
readonly flagKind:
|
|
1142
|
+
readonly flagKind: 'boolean' | 'string' | 'number' | 'enum' | 'custom';
|
|
1135
1143
|
}>, policy: DuplicatePolicy): FlagBuilder<WithoutElementEligibility<C>>;
|
|
1136
1144
|
}
|
|
1137
1145
|
/**
|
|
@@ -1160,9 +1168,9 @@ interface FlagFactory {
|
|
|
1160
1168
|
*/
|
|
1161
1169
|
string(constraints?: StringConstraints): FlagBuilder<{
|
|
1162
1170
|
readonly valueType: string;
|
|
1163
|
-
readonly presence:
|
|
1164
|
-
readonly optionalFallback:
|
|
1165
|
-
readonly flagKind:
|
|
1171
|
+
readonly presence: 'optional';
|
|
1172
|
+
readonly optionalFallback: 'undefined';
|
|
1173
|
+
readonly flagKind: 'string';
|
|
1166
1174
|
readonly elementEligible: true;
|
|
1167
1175
|
}>;
|
|
1168
1176
|
/**
|
|
@@ -1189,9 +1197,9 @@ interface FlagFactory {
|
|
|
1189
1197
|
*/
|
|
1190
1198
|
number(constraints?: NumberConstraints): FlagBuilder<{
|
|
1191
1199
|
readonly valueType: number;
|
|
1192
|
-
readonly presence:
|
|
1193
|
-
readonly optionalFallback:
|
|
1194
|
-
readonly flagKind:
|
|
1200
|
+
readonly presence: 'optional';
|
|
1201
|
+
readonly optionalFallback: 'undefined';
|
|
1202
|
+
readonly flagKind: 'number';
|
|
1195
1203
|
readonly elementEligible: true;
|
|
1196
1204
|
}>;
|
|
1197
1205
|
/**
|
|
@@ -1202,9 +1210,9 @@ interface FlagFactory {
|
|
|
1202
1210
|
*/
|
|
1203
1211
|
boolean(): FlagBuilder<{
|
|
1204
1212
|
readonly valueType: boolean;
|
|
1205
|
-
readonly presence:
|
|
1206
|
-
readonly optionalFallback:
|
|
1207
|
-
readonly flagKind:
|
|
1213
|
+
readonly presence: 'defaulted';
|
|
1214
|
+
readonly optionalFallback: 'undefined';
|
|
1215
|
+
readonly flagKind: 'boolean';
|
|
1208
1216
|
readonly elementEligible: true;
|
|
1209
1217
|
}>;
|
|
1210
1218
|
/**
|
|
@@ -1224,9 +1232,9 @@ interface FlagFactory {
|
|
|
1224
1232
|
*/
|
|
1225
1233
|
enum<const T extends readonly [string, ...string[]]>(values: T): FlagBuilder<{
|
|
1226
1234
|
readonly valueType: T[number];
|
|
1227
|
-
readonly presence:
|
|
1228
|
-
readonly optionalFallback:
|
|
1229
|
-
readonly flagKind:
|
|
1235
|
+
readonly presence: 'optional';
|
|
1236
|
+
readonly optionalFallback: 'undefined';
|
|
1237
|
+
readonly flagKind: 'enum';
|
|
1230
1238
|
readonly elementEligible: true;
|
|
1231
1239
|
}>;
|
|
1232
1240
|
/**
|
|
@@ -1244,10 +1252,10 @@ interface FlagFactory {
|
|
|
1244
1252
|
array<E extends FlagConfig & {
|
|
1245
1253
|
readonly elementEligible: true;
|
|
1246
1254
|
}>(element: FlagBuilder<E>): FlagBuilder<{
|
|
1247
|
-
readonly valueType: E[
|
|
1248
|
-
readonly presence:
|
|
1249
|
-
readonly optionalFallback:
|
|
1250
|
-
readonly flagKind:
|
|
1255
|
+
readonly valueType: E['valueType'][];
|
|
1256
|
+
readonly presence: 'optional';
|
|
1257
|
+
readonly optionalFallback: 'empty-array';
|
|
1258
|
+
readonly flagKind: 'array';
|
|
1251
1259
|
readonly elementEligible: false;
|
|
1252
1260
|
}>;
|
|
1253
1261
|
/**
|
|
@@ -1270,9 +1278,9 @@ interface FlagFactory {
|
|
|
1270
1278
|
*/
|
|
1271
1279
|
custom<S extends StandardSchemaV1>(schema: S): FlagBuilder<{
|
|
1272
1280
|
readonly valueType: InferStandardOutput<S>;
|
|
1273
|
-
readonly presence:
|
|
1274
|
-
readonly optionalFallback:
|
|
1275
|
-
readonly flagKind:
|
|
1281
|
+
readonly presence: 'optional';
|
|
1282
|
+
readonly optionalFallback: 'undefined';
|
|
1283
|
+
readonly flagKind: 'custom';
|
|
1276
1284
|
readonly elementEligible: true;
|
|
1277
1285
|
}>;
|
|
1278
1286
|
/**
|
|
@@ -1306,9 +1314,9 @@ interface FlagFactory {
|
|
|
1306
1314
|
*/
|
|
1307
1315
|
custom<T>(parseFn: FlagParseFn<T>): FlagBuilder<{
|
|
1308
1316
|
readonly valueType: T;
|
|
1309
|
-
readonly presence:
|
|
1310
|
-
readonly optionalFallback:
|
|
1311
|
-
readonly flagKind:
|
|
1317
|
+
readonly presence: 'optional';
|
|
1318
|
+
readonly optionalFallback: 'undefined';
|
|
1319
|
+
readonly flagKind: 'custom';
|
|
1312
1320
|
readonly elementEligible: true;
|
|
1313
1321
|
}>;
|
|
1314
1322
|
/**
|
|
@@ -1326,9 +1334,9 @@ interface FlagFactory {
|
|
|
1326
1334
|
*/
|
|
1327
1335
|
url(options?: UrlFlagOptions): FlagBuilder<{
|
|
1328
1336
|
readonly valueType: URL;
|
|
1329
|
-
readonly presence:
|
|
1330
|
-
readonly optionalFallback:
|
|
1331
|
-
readonly flagKind:
|
|
1337
|
+
readonly presence: 'optional';
|
|
1338
|
+
readonly optionalFallback: 'undefined';
|
|
1339
|
+
readonly flagKind: 'custom';
|
|
1332
1340
|
readonly elementEligible: true;
|
|
1333
1341
|
}>;
|
|
1334
1342
|
/**
|
|
@@ -1353,9 +1361,9 @@ interface FlagFactory {
|
|
|
1353
1361
|
*/
|
|
1354
1362
|
path(options?: PathFlagOptions): FlagBuilder<{
|
|
1355
1363
|
readonly valueType: string;
|
|
1356
|
-
readonly presence:
|
|
1357
|
-
readonly optionalFallback:
|
|
1358
|
-
readonly flagKind:
|
|
1364
|
+
readonly presence: 'optional';
|
|
1365
|
+
readonly optionalFallback: 'undefined';
|
|
1366
|
+
readonly flagKind: 'string';
|
|
1359
1367
|
readonly elementEligible: true;
|
|
1360
1368
|
}>;
|
|
1361
1369
|
/**
|
|
@@ -1379,9 +1387,9 @@ interface FlagFactory {
|
|
|
1379
1387
|
*/
|
|
1380
1388
|
date(options?: DateFlagOptions): FlagBuilder<{
|
|
1381
1389
|
readonly valueType: Date;
|
|
1382
|
-
readonly presence:
|
|
1383
|
-
readonly optionalFallback:
|
|
1384
|
-
readonly flagKind:
|
|
1390
|
+
readonly presence: 'optional';
|
|
1391
|
+
readonly optionalFallback: 'undefined';
|
|
1392
|
+
readonly flagKind: 'custom';
|
|
1385
1393
|
readonly elementEligible: true;
|
|
1386
1394
|
}>;
|
|
1387
1395
|
/**
|
|
@@ -1398,9 +1406,9 @@ interface FlagFactory {
|
|
|
1398
1406
|
*/
|
|
1399
1407
|
duration(): FlagBuilder<{
|
|
1400
1408
|
readonly valueType: number;
|
|
1401
|
-
readonly presence:
|
|
1402
|
-
readonly optionalFallback:
|
|
1403
|
-
readonly flagKind:
|
|
1409
|
+
readonly presence: 'optional';
|
|
1410
|
+
readonly optionalFallback: 'undefined';
|
|
1411
|
+
readonly flagKind: 'custom';
|
|
1404
1412
|
readonly elementEligible: true;
|
|
1405
1413
|
}>;
|
|
1406
1414
|
/**
|
|
@@ -1417,9 +1425,9 @@ interface FlagFactory {
|
|
|
1417
1425
|
*/
|
|
1418
1426
|
bytes(): FlagBuilder<{
|
|
1419
1427
|
readonly valueType: number;
|
|
1420
|
-
readonly presence:
|
|
1421
|
-
readonly optionalFallback:
|
|
1422
|
-
readonly flagKind:
|
|
1428
|
+
readonly presence: 'optional';
|
|
1429
|
+
readonly optionalFallback: 'undefined';
|
|
1430
|
+
readonly flagKind: 'custom';
|
|
1423
1431
|
readonly elementEligible: true;
|
|
1424
1432
|
}>;
|
|
1425
1433
|
/**
|
|
@@ -1440,9 +1448,9 @@ interface FlagFactory {
|
|
|
1440
1448
|
*/
|
|
1441
1449
|
count(): FlagBuilder<{
|
|
1442
1450
|
readonly valueType: number;
|
|
1443
|
-
readonly presence:
|
|
1444
|
-
readonly optionalFallback:
|
|
1445
|
-
readonly flagKind:
|
|
1451
|
+
readonly presence: 'defaulted';
|
|
1452
|
+
readonly optionalFallback: 'undefined';
|
|
1453
|
+
readonly flagKind: 'count';
|
|
1446
1454
|
readonly elementEligible: false;
|
|
1447
1455
|
}>;
|
|
1448
1456
|
/**
|
|
@@ -1471,10 +1479,10 @@ interface FlagFactory {
|
|
|
1471
1479
|
keyValue<E extends FlagConfig & {
|
|
1472
1480
|
readonly elementEligible: true;
|
|
1473
1481
|
} = StringElementConfig>(element?: FlagBuilder<E>): FlagBuilder<{
|
|
1474
|
-
readonly valueType: Record<string, E[
|
|
1475
|
-
readonly presence:
|
|
1476
|
-
readonly optionalFallback:
|
|
1477
|
-
readonly flagKind:
|
|
1482
|
+
readonly valueType: Record<string, E['valueType']>;
|
|
1483
|
+
readonly presence: 'optional';
|
|
1484
|
+
readonly optionalFallback: 'empty-object';
|
|
1485
|
+
readonly flagKind: 'keyValue';
|
|
1478
1486
|
readonly elementEligible: false;
|
|
1479
1487
|
}>;
|
|
1480
1488
|
}
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { ActivityEvent, Fallback, ProgressHandle, ProgressOptions, SpinnerHandle, SpinnerOptions, TableColumn, TableFormat, TableOptions, TableStream } from "./activity.mjs";
|
|
2
1
|
import { NumberConstraintViolation, NumberConstraints, describeNumberConstraintViolation, validateNumberConstraints } from "./number-constraints.mjs";
|
|
3
2
|
import { ConfirmPromptConfig, InputPromptConfig, MultiselectPromptConfig, PROMPT_KINDS, PromptConfig, PromptConfigBase, PromptKind, PromptResult, SelectChoice, SelectPromptConfig } from "./prompt.mjs";
|
|
4
3
|
import { InferStandardInput, InferStandardOutput, StandardSchemaV1, StandardSchemaV1FailureResult, StandardSchemaV1Issue, StandardSchemaV1Options, StandardSchemaV1PathSegment, StandardSchemaV1Props, StandardSchemaV1Result, StandardSchemaV1SuccessResult, StandardSchemaV1Types } from "./standard.mjs";
|
|
@@ -8,6 +7,7 @@ import { DateFlagOptions, PathChecks, PathFlagOptions, UrlFlagOptions } from "./
|
|
|
8
7
|
import { ArrayFlagDefinition, BooleanFlagDefinition, CountFlagDefinition, CustomFlagDefinition, DuplicatePolicy, EnumFlagDefinition, FLAG_KINDS, FLAG_PRESENCES, FlagAlias, FlagBuilder, FlagConfig, FlagDefinition, FlagDefinitionBase, FlagDefinitionByKind, FlagDefinitionOverrides, FlagFactory, FlagKind, FlagNegation, FlagParseFn, FlagPresence, FlagSchema, InferFlag, InferFlags, KeyValueFlagDefinition, NumberFlagDefinition, ResolvedValue, StringElementConfig, StringFlagDefinition, WithPresence, WithoutElementEligibility, createFlagSchema, flag, getFlagNegatedName } from "./flag.mjs";
|
|
9
8
|
import { DUPLICATE_KEYS, DuplicateKeys, SPLIT_FORMATS, SourceSplitBinding, SplitBinding, SplitFormat, SplitOptions, SplitPolicy, SplitSetting } from "./cardinality.mjs";
|
|
10
9
|
import { ARG_KINDS, ARG_PRESENCES, AllowedArgPromptConfig, ArgBuilder, ArgConfig, ArgDefaultValue, ArgDefinition, ArgDefinitionBase, ArgDefinitionByKind, ArgDefinitionOverrides, ArgFactory, ArgKind, ArgParseFn, ArgPresence, ArgSchema, BooleanArgDefinition, CustomArgDefinition, EnumArgDefinition, InferArg, InferArgs, KeyValueArgDefinition, NumberArgDefinition, PromptConfigByArgKind, ResolvedArgValue, StringArgDefinition, StringArgElementConfig, WithArgPresence, WithVariadic, WithoutArgElementEligibility, arg, createArgSchema } from "./arg.mjs";
|
|
10
|
+
import { ActivityEvent, Fallback, ProgressHandle, ProgressOptions, SpinnerHandle, SpinnerOptions, TableColumn, TableFormat, TableOptions, TableStream } from "./activity.mjs";
|
|
11
11
|
import { Middleware, MiddlewareHandler, MiddlewareParams, middleware } from "./middleware.mjs";
|
|
12
12
|
import { InputSources, ResolutionProvenance, SourcesOf, wasExplicit } from "./provenance.mjs";
|
|
13
13
|
import { ActionHandler, ActionParams, AnyCommandBuilder, CommandArgEntry, CommandArgEntryDefinition, CommandBuilder, CommandDefinition, CommandExample, CommandMeta, CommandSchema, DeriveHandler, DeriveParams, ExampleCommand, ExampleMeta, InteractiveParams, InteractiveResolver, InteractiveResult, Out, command, createCommandSchema, group, resolveExampleCommand } from "./command.mjs";
|
|
@@ -85,7 +85,10 @@ interface MiddlewareImpl {
|
|
|
85
85
|
* });
|
|
86
86
|
* ```
|
|
87
87
|
*/
|
|
88
|
-
type Middleware<Output extends Record<string, unknown>> = MiddlewareImpl & {
|
|
88
|
+
type Middleware<Output extends Record<string, unknown>> = MiddlewareImpl & {
|
|
89
|
+
/** @internal Phantom type brand — compile-time only. */
|
|
90
|
+
readonly _output: Output;
|
|
91
|
+
};
|
|
89
92
|
/**
|
|
90
93
|
* Create a middleware definition.
|
|
91
94
|
*
|
|
@@ -45,18 +45,18 @@ interface NumberConstraints {
|
|
|
45
45
|
* `min` / `max` carry the offending bound so callers can render it.
|
|
46
46
|
*/
|
|
47
47
|
type NumberConstraintViolation = {
|
|
48
|
-
readonly kind:
|
|
48
|
+
readonly kind: 'finite';
|
|
49
49
|
} | {
|
|
50
|
-
readonly kind:
|
|
50
|
+
readonly kind: 'int';
|
|
51
51
|
} | {
|
|
52
|
-
readonly kind:
|
|
52
|
+
readonly kind: 'min';
|
|
53
53
|
readonly bound: number;
|
|
54
54
|
} | {
|
|
55
|
-
readonly kind:
|
|
55
|
+
readonly kind: 'max';
|
|
56
56
|
readonly bound: number;
|
|
57
57
|
};
|
|
58
58
|
/** Default for {@link NumberConstraints.finite} — reject `Infinity` unless opted out. */
|
|
59
|
-
declare const DEFAULT_FINITE
|
|
59
|
+
declare const DEFAULT_FINITE = true;
|
|
60
60
|
/**
|
|
61
61
|
* Validate a numeric value against constraints.
|
|
62
62
|
*
|
|
@@ -28,7 +28,7 @@ interface PromptConfigBase {
|
|
|
28
28
|
/** Yes/no confirmation prompt — maps to `boolean` flags. Part of {@link PromptConfig}. */
|
|
29
29
|
interface ConfirmPromptConfig extends PromptConfigBase {
|
|
30
30
|
/** Discriminator identifying this as a yes/no confirmation prompt. */
|
|
31
|
-
readonly kind:
|
|
31
|
+
readonly kind: 'confirm';
|
|
32
32
|
/**
|
|
33
33
|
* Value used when the user submits an empty line (presses Enter). Also
|
|
34
34
|
* drives the displayed hint: `true` → `(Y/n)`, `false` → `(y/N)`.
|
|
@@ -39,7 +39,7 @@ interface ConfirmPromptConfig extends PromptConfigBase {
|
|
|
39
39
|
/** Free-text input prompt — maps to `string` and `number` flags. Part of {@link PromptConfig}. */
|
|
40
40
|
interface InputPromptConfig extends PromptConfigBase {
|
|
41
41
|
/** Discriminator identifying this as a free-text input prompt. */
|
|
42
|
-
readonly kind:
|
|
42
|
+
readonly kind: 'input';
|
|
43
43
|
/** Placeholder text shown before user types (informational only). */
|
|
44
44
|
readonly placeholder?: string;
|
|
45
45
|
/**
|
|
@@ -60,7 +60,7 @@ interface InputPromptConfig extends PromptConfigBase {
|
|
|
60
60
|
/** Single-selection prompt — maps to `enum` flags or any flag with {@link SelectChoice choices}. Part of {@link PromptConfig}. */
|
|
61
61
|
interface SelectPromptConfig extends PromptConfigBase {
|
|
62
62
|
/** Discriminator identifying this as a single-selection prompt. */
|
|
63
|
-
readonly kind:
|
|
63
|
+
readonly kind: 'select';
|
|
64
64
|
/**
|
|
65
65
|
* Available choices. When omitted for `enum` flags, the enum values
|
|
66
66
|
* from the flag schema are used automatically.
|
|
@@ -73,7 +73,7 @@ interface SelectPromptConfig extends PromptConfigBase {
|
|
|
73
73
|
*/
|
|
74
74
|
interface MultiselectPromptConfig extends PromptConfigBase {
|
|
75
75
|
/** Discriminator identifying this as a multi-selection prompt. */
|
|
76
|
-
readonly kind:
|
|
76
|
+
readonly kind: 'multiselect';
|
|
77
77
|
/**
|
|
78
78
|
* Available choices. When omitted for `array` flags with enum elements,
|
|
79
79
|
* the enum values from the element schema are used automatically.
|