@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,9 +1,9 @@
|
|
|
1
1
|
import { schemaBrand } from "../schema/brand.mjs";
|
|
2
2
|
//#region src/core/cli/builtins.d.ts
|
|
3
3
|
/** A built-in flag a consumer can take over. */
|
|
4
|
-
type BuiltinName =
|
|
4
|
+
type BuiltinName = 'help' | 'json' | 'quiet';
|
|
5
5
|
/** Whether the root keeps a built-in or releases it to commands. */
|
|
6
|
-
type BuiltinMode =
|
|
6
|
+
type BuiltinMode = 'on' | 'off';
|
|
7
7
|
/**
|
|
8
8
|
* Built-in flag settings accepted by {@linkcode CLIBuilder.builtins} and the
|
|
9
9
|
* `builtins` field of {@link CLIDefinition}.
|
|
@@ -35,7 +35,7 @@ interface BuiltinsConfig {
|
|
|
35
35
|
*/
|
|
36
36
|
interface Builtins {
|
|
37
37
|
/** Type-only seal produced by {@link createCLISchema}. */
|
|
38
|
-
readonly [schemaBrand]:
|
|
38
|
+
readonly [schemaBrand]: 'builtins';
|
|
39
39
|
/** Whether the root owns `--help`/`-h` and the bare `help` token. */
|
|
40
40
|
readonly help: BuiltinMode;
|
|
41
41
|
/** Whether the root owns `--json`. */
|
|
@@ -43,5 +43,75 @@ interface Builtins {
|
|
|
43
43
|
/** Whether the root owns `--quiet`/`-q`. */
|
|
44
44
|
readonly quiet: BuiltinMode;
|
|
45
45
|
}
|
|
46
|
+
/**
|
|
47
|
+
* {@link Builtins} before the type-only seal is applied.
|
|
48
|
+
*
|
|
49
|
+
* @internal
|
|
50
|
+
*/
|
|
51
|
+
type BuiltinsDraft = Omit<Builtins, typeof schemaBrand>;
|
|
52
|
+
/** Everything the framework needs to know about one built-in flag. @internal */
|
|
53
|
+
interface BuiltinSpec {
|
|
54
|
+
/** Long spellings, the only forms that carry an inline `=value`. */
|
|
55
|
+
readonly long: readonly string[];
|
|
56
|
+
/** Short spellings, which have no inline-value form. */
|
|
57
|
+
readonly short: readonly string[];
|
|
58
|
+
/** Description shown in the root-help `Global options:` block. */
|
|
59
|
+
readonly description: string;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* The spelling table every built-in-aware layer reads.
|
|
63
|
+
*
|
|
64
|
+
* @internal
|
|
65
|
+
*/
|
|
66
|
+
declare const BUILTIN_SPECS: Readonly<Record<BuiltinName, BuiltinSpec>>;
|
|
67
|
+
/** Spelling error messages and help entries name a built-in by. @internal */
|
|
68
|
+
declare function builtinSpelling(name: BuiltinName): string;
|
|
69
|
+
/** Built-in names in the order root help advertises them. @internal */
|
|
70
|
+
declare const BUILTIN_NAMES: readonly ["help", "json", "quiet"];
|
|
71
|
+
/** Every built-in on, the state a CLI starts in. @internal */
|
|
72
|
+
declare const DEFAULT_BUILTINS: BuiltinsDraft;
|
|
73
|
+
/**
|
|
74
|
+
* Whether the root still owns a built-in.
|
|
75
|
+
*
|
|
76
|
+
* @param builtins - Normalized state, or `undefined` for the defaults.
|
|
77
|
+
* @param name - Built-in to check.
|
|
78
|
+
* @returns `true` when the root reads the token, `false` once it is released.
|
|
79
|
+
*
|
|
80
|
+
* @internal
|
|
81
|
+
*/
|
|
82
|
+
declare function builtinEnabled(builtins: BuiltinsConfig | undefined, name: BuiltinName): boolean;
|
|
83
|
+
/**
|
|
84
|
+
* The argv spellings of one built-in, joined for a help entry.
|
|
85
|
+
*
|
|
86
|
+
* @param name - Built-in to render.
|
|
87
|
+
* @returns Short spellings first, e.g. `-h, --help`.
|
|
88
|
+
*
|
|
89
|
+
* @internal
|
|
90
|
+
*/
|
|
91
|
+
declare function builtinFlagForms(name: BuiltinName): string;
|
|
92
|
+
/**
|
|
93
|
+
* The spellings of one built-in as bare tokens, dashes removed.
|
|
94
|
+
*
|
|
95
|
+
* @param name - Built-in to read.
|
|
96
|
+
* @returns Tokens as a command flag would declare them, e.g. `help` and `h`.
|
|
97
|
+
*
|
|
98
|
+
* @internal
|
|
99
|
+
*/
|
|
100
|
+
declare function builtinTokens(name: BuiltinName): readonly string[];
|
|
101
|
+
/**
|
|
102
|
+
* Normalize built-in settings into the fully populated schema state.
|
|
103
|
+
*
|
|
104
|
+
* Shared by {@link createCLISchema} and {@linkcode CLIBuilder.builtins}, so both
|
|
105
|
+
* construction paths produce identical state. Re-feeding a normalized value
|
|
106
|
+
* returns an equal value.
|
|
107
|
+
*
|
|
108
|
+
* @param config - Caller-supplied settings, or `undefined` for the defaults.
|
|
109
|
+
* @returns Every built-in resolved to a mode.
|
|
110
|
+
* @throws {@linkcode CLIError} `INVALID_SCHEMA` for a value that is neither
|
|
111
|
+
* `'on'` nor `'off'`.
|
|
112
|
+
*
|
|
113
|
+
* @internal
|
|
114
|
+
*/
|
|
115
|
+
declare function normalizeBuiltins(config: BuiltinsConfig | undefined): BuiltinsDraft;
|
|
46
116
|
//#endregion
|
|
47
|
-
export type
|
|
117
|
+
export { BUILTIN_NAMES, BUILTIN_SPECS, type BuiltinMode, type BuiltinName, type BuiltinSpec, type Builtins, type BuiltinsConfig, type BuiltinsDraft, DEFAULT_BUILTINS, builtinEnabled, builtinFlagForms, builtinSpelling, builtinTokens, normalizeBuiltins };
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { FlagBuilder, FlagConfig } from "../schema/flag.mjs";
|
|
2
|
+
import { ArgBuilder, ArgConfig } from "../schema/arg.mjs";
|
|
3
|
+
import { CommandBuilder, CommandSchema, ErasedActionHandler, ExecutionStep } from "../schema/command.mjs";
|
|
2
4
|
import { CLIPlugin } from "./plugin.mjs";
|
|
3
5
|
//#region src/core/cli/compiled.d.ts
|
|
4
6
|
/**
|
|
@@ -25,5 +27,40 @@ interface CompiledCLI {
|
|
|
25
27
|
/** Plugins in registration order. */
|
|
26
28
|
readonly plugins: readonly CLIPlugin[];
|
|
27
29
|
}
|
|
30
|
+
/**
|
|
31
|
+
* The routes a command answers to: its name followed by its aliases.
|
|
32
|
+
*
|
|
33
|
+
* @param schema - Command schema to read the name and aliases from.
|
|
34
|
+
* @returns Route tokens in declaration order.
|
|
35
|
+
*
|
|
36
|
+
* @internal
|
|
37
|
+
*/
|
|
38
|
+
declare function commandRoutes(schema: CommandSchema): readonly string[];
|
|
39
|
+
/**
|
|
40
|
+
* Reject a route already claimed by a sibling command, then record its owner.
|
|
41
|
+
*
|
|
42
|
+
* @param parentCommandName - Name of the command the siblings live under.
|
|
43
|
+
* @param routeOwners - Route to owning command name, mutated with `route`.
|
|
44
|
+
* @param route - Name or alias being registered.
|
|
45
|
+
* @param commandName - Command claiming the route.
|
|
46
|
+
*
|
|
47
|
+
* @internal
|
|
48
|
+
*/
|
|
49
|
+
declare function assertNoSiblingRouteConflict(parentCommandName: string, routeOwners: Map<string, string>, route: string, commandName: string): void;
|
|
50
|
+
/**
|
|
51
|
+
* Compile a command builder into its executable graph node.
|
|
52
|
+
*
|
|
53
|
+
* Extracts the handler and execution steps, then recurses into
|
|
54
|
+
* `_subcommands` to index each child by name and alias. The builder itself is
|
|
55
|
+
* not retained; `schema` is the builder's own schema object, so the compiled
|
|
56
|
+
* node and the public schema tree share command schema identity.
|
|
57
|
+
*
|
|
58
|
+
* @param cmd - Command builder to compile.
|
|
59
|
+
* @returns The compiled command node.
|
|
60
|
+
* @throws {@linkcode CLIError} `DUPLICATE_COMMAND` when two siblings claim the same route.
|
|
61
|
+
*
|
|
62
|
+
* @internal
|
|
63
|
+
*/
|
|
64
|
+
declare function compileCommand<F extends Record<string, FlagBuilder<FlagConfig>>, A extends Record<string, ArgBuilder<ArgConfig>>, C extends Record<string, unknown>>(cmd: CommandBuilder<F, A, C>): CompiledCommand;
|
|
28
65
|
//#endregion
|
|
29
|
-
export type
|
|
66
|
+
export { type CompiledCLI, type CompiledCommand, assertNoSiblingRouteConflict, commandRoutes, compileCommand };
|
|
@@ -1,10 +1,19 @@
|
|
|
1
1
|
import { CommandSchema } from "../schema/command.mjs";
|
|
2
|
+
import { FlagLookupEntry, ParseOptions } from "../parse/index.mjs";
|
|
2
3
|
import { CompiledCommand } from "./compiled.mjs";
|
|
3
4
|
//#region src/core/cli/dispatch.d.ts
|
|
5
|
+
/**
|
|
6
|
+
* Flag lookup (spelling → {@link FlagLookupEntry}) used to make the
|
|
7
|
+
* command-name scan aware of value-flag arity. Built from the flags valid at
|
|
8
|
+
* the current dispatch level via {@link buildFlagLookup}.
|
|
9
|
+
*
|
|
10
|
+
* @internal
|
|
11
|
+
*/
|
|
12
|
+
type ValueFlagLookup = ReadonlyMap<string, FlagLookupEntry>;
|
|
4
13
|
/** Successful dispatch — target command found with argv path. */
|
|
5
14
|
interface DispatchMatch {
|
|
6
15
|
/** Discriminant — a command name in argv matched a registered command. */
|
|
7
|
-
readonly kind:
|
|
16
|
+
readonly kind: 'match';
|
|
8
17
|
/** The matched (target) command. */
|
|
9
18
|
readonly command: CompiledCommand;
|
|
10
19
|
/** Root → target (inclusive). Used for `collectPropagatedFlags()`. */
|
|
@@ -15,7 +24,7 @@ interface DispatchMatch {
|
|
|
15
24
|
/** Target has subcommands but no handler and no subcommand was specified/matched. */
|
|
16
25
|
interface DispatchNeedsSubcommand {
|
|
17
26
|
/** Discriminant — command group reached without a subcommand or handler. */
|
|
18
|
-
readonly kind:
|
|
27
|
+
readonly kind: 'needs-subcommand';
|
|
19
28
|
/** The group command that needs a subcommand. */
|
|
20
29
|
readonly command: CompiledCommand;
|
|
21
30
|
/** Root → group (inclusive). */
|
|
@@ -24,7 +33,7 @@ interface DispatchNeedsSubcommand {
|
|
|
24
33
|
/** Unknown command name at this dispatch level. */
|
|
25
34
|
interface DispatchUnknown {
|
|
26
35
|
/** Discriminant — no registered command matched the input token. */
|
|
27
|
-
readonly kind:
|
|
36
|
+
readonly kind: 'unknown';
|
|
28
37
|
/** The unrecognised input token. Empty string when no token present. */
|
|
29
38
|
readonly input: string;
|
|
30
39
|
/** Commands available at the level where matching failed. */
|
|
@@ -34,5 +43,73 @@ interface DispatchUnknown {
|
|
|
34
43
|
}
|
|
35
44
|
/** Discriminated result of recursive command dispatch. */
|
|
36
45
|
type DispatchResult = DispatchMatch | DispatchNeedsSubcommand | DispatchUnknown;
|
|
46
|
+
/**
|
|
47
|
+
* Recursively walk argv, consuming command name segments from the front.
|
|
48
|
+
*
|
|
49
|
+
* At each level, the first non-flag token is tested as a command name
|
|
50
|
+
* against the provided command map. If matched and the matched command
|
|
51
|
+
* has subcommands, dispatch recurses into the child level with the
|
|
52
|
+
* remaining argv.
|
|
53
|
+
*
|
|
54
|
+
* Ambiguity resolution for commands that have both an action handler AND
|
|
55
|
+
* subcommands (e.g. `git remote` lists remotes, `git remote add` dispatches):
|
|
56
|
+
* - If the next token matches a subcommand → descend
|
|
57
|
+
* - If the next token is unknown and the command has a handler → match here
|
|
58
|
+
* - If the next token is unknown and no handler → propagate unknown error
|
|
59
|
+
* - If no next token and command has a handler → match here
|
|
60
|
+
* - If no next token and no handler → needs-subcommand
|
|
61
|
+
*
|
|
62
|
+
* @param argv - Remaining argv tokens (command names + flags + args).
|
|
63
|
+
* @param commands - Command map at the current tree level.
|
|
64
|
+
* @param ancestorPath - Schema path from root to current level (exclusive).
|
|
65
|
+
* @param valueFlags - Lookup of flags valid at this level, used so a
|
|
66
|
+
* space-separated value-flag's value (`--region eu`) is not mistaken for a
|
|
67
|
+
* command name. Empty by default (arity-unaware, legacy behaviour).
|
|
68
|
+
* @param parseOptions - Parser toggles (case parity) applied to descent-level
|
|
69
|
+
* flag lookups built inside dispatch.
|
|
70
|
+
* @returns Discriminated dispatch result.
|
|
71
|
+
*
|
|
72
|
+
* @internal
|
|
73
|
+
*/
|
|
74
|
+
declare function dispatch(argv: readonly string[], commands: ReadonlyMap<string, CompiledCommand>, ancestorPath?: readonly CommandSchema[], valueFlags?: ValueFlagLookup, parseOptions?: ParseOptions): DispatchResult;
|
|
75
|
+
/**
|
|
76
|
+
* Whether a flag token consumes the following argv token as its value.
|
|
77
|
+
*
|
|
78
|
+
* Mirrors the parser's value-consumption rules (`parseLongFlag` /
|
|
79
|
+
* `parseShortFlags`) so the command-name scan skips exactly the tokens the
|
|
80
|
+
* parser would treat as flag values:
|
|
81
|
+
* - `--flag value` → consumes when `--flag` is a known value-flag.
|
|
82
|
+
* - `--flag=value` → self-contained, consumes nothing.
|
|
83
|
+
* - `-abc value` → consumes only when the trailing short flag is a value-flag;
|
|
84
|
+
* an earlier value-flag char takes the rest of the group as an inline value.
|
|
85
|
+
*
|
|
86
|
+
* Unknown flags conservatively consume nothing (the parser reports them later).
|
|
87
|
+
*
|
|
88
|
+
* @internal
|
|
89
|
+
*/
|
|
90
|
+
declare function consumesFollowingToken(token: string, valueFlags: ValueFlagLookup): boolean;
|
|
91
|
+
/**
|
|
92
|
+
* Levenshtein distance between two strings.
|
|
93
|
+
* @internal
|
|
94
|
+
*/
|
|
95
|
+
declare function levenshtein(a: string, b: string): number;
|
|
96
|
+
/**
|
|
97
|
+
* Find the closest command name match for a "did you mean?" suggestion.
|
|
98
|
+
*
|
|
99
|
+
* Searches command names and aliases. Returns `undefined` if no
|
|
100
|
+
* sufficiently close match exists (threshold: 3).
|
|
101
|
+
*
|
|
102
|
+
* @internal
|
|
103
|
+
*/
|
|
104
|
+
declare function findClosestCommand(input: string, commands: readonly CompiledCommand[]): string | undefined;
|
|
105
|
+
/**
|
|
106
|
+
* Deduplicate commands from a name+alias map.
|
|
107
|
+
*
|
|
108
|
+
* A map keyed by name *and* alias contains duplicate entries for aliased
|
|
109
|
+
* commands. This returns unique commands (by schema identity).
|
|
110
|
+
*
|
|
111
|
+
* @internal
|
|
112
|
+
*/
|
|
113
|
+
declare function uniqueCommands(commands: ReadonlyMap<string, CompiledCommand>): readonly CompiledCommand[];
|
|
37
114
|
//#endregion
|
|
38
|
-
export type
|
|
115
|
+
export { type DispatchMatch, type DispatchNeedsSubcommand, type DispatchResult, type DispatchUnknown, type ValueFlagLookup, consumesFollowingToken, dispatch, findClosestCommand, levenshtein, uniqueCommands };
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { PackageJsonData } from "../config/package-json.mjs";
|
|
1
2
|
//#region src/core/cli/help-links.d.ts
|
|
2
3
|
/**
|
|
3
4
|
* OSC 8 hyperlink targets for the root-help header.
|
|
@@ -11,5 +12,16 @@ interface HelpLinks {
|
|
|
11
12
|
/** URL the version links to (e.g. the release tag). */
|
|
12
13
|
readonly version: string | undefined;
|
|
13
14
|
}
|
|
15
|
+
/**
|
|
16
|
+
* Fill `undefined` link fields from package.json metadata.
|
|
17
|
+
*
|
|
18
|
+
* Explicit URLs always win. The name falls back to the normalized
|
|
19
|
+
* `repository` URL, then `homepage`; the version falls back to the forge
|
|
20
|
+
* release-tag URL when both a repository and a version are known.
|
|
21
|
+
* Idempotent — already-resolved fields pass through unchanged.
|
|
22
|
+
*
|
|
23
|
+
* @internal
|
|
24
|
+
*/
|
|
25
|
+
declare function deriveHelpLinks(links: HelpLinks | undefined, pkg: PackageJsonData | undefined, version: string | undefined): HelpLinks | undefined;
|
|
14
26
|
//#endregion
|
|
15
|
-
export type
|
|
27
|
+
export { type HelpLinks, deriveHelpLinks };
|
|
@@ -1,20 +1,21 @@
|
|
|
1
1
|
import { schemaBrand } from "../schema/brand.mjs";
|
|
2
2
|
import { BuiltinMode, BuiltinName, Builtins, BuiltinsConfig } from "./builtins.mjs";
|
|
3
|
-
import {
|
|
3
|
+
import { HelpThemeFactory } from "../help/theme.mjs";
|
|
4
4
|
import { FlagBuilder, FlagConfig } from "../schema/flag.mjs";
|
|
5
5
|
import { ArgBuilder, ArgConfig } from "../schema/arg.mjs";
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
6
|
+
import { Verbosity } from "../output/contracts.mjs";
|
|
7
|
+
import { CommandBuilder, CommandDefinition, CommandSchema, Out } from "../schema/command.mjs";
|
|
8
8
|
import "../help/index.mjs";
|
|
9
|
-
import "../output/index.mjs";
|
|
9
|
+
import { CapturedOutput } from "../output/index.mjs";
|
|
10
10
|
import { RunOptions, RunResult } from "../schema/run.mjs";
|
|
11
11
|
import { ParseOptions } from "../parse/index.mjs";
|
|
12
12
|
import { BeforeParseParams, CLIPlugin, CLIPluginHooks, PluginCommandContext, ResolvedCommandParams, plugin } from "./plugin.mjs";
|
|
13
|
+
import { CompiledCLI } from "./compiled.mjs";
|
|
14
|
+
import { RuntimeAdapter } from "../../runtime/adapter.mjs";
|
|
15
|
+
import { PackageJsonData } from "../config/package-json.mjs";
|
|
13
16
|
import { HelpLinks } from "./help-links.mjs";
|
|
14
17
|
import { CompletionOptions } from "../completion/shells/shared.mjs";
|
|
15
18
|
import { Shell } from "../completion/index.mjs";
|
|
16
|
-
import { RuntimeAdapter } from "../../runtime/adapter.mjs";
|
|
17
|
-
import { PackageJsonData } from "../config/package-json.mjs";
|
|
18
19
|
import { FormatLoader } from "../config/index.mjs";
|
|
19
20
|
import { Colors } from "ansispeck";
|
|
20
21
|
//#region src/core/cli/index.d.ts
|
|
@@ -26,7 +27,7 @@ import { Colors } from "ansispeck";
|
|
|
26
27
|
*/
|
|
27
28
|
interface CLISchema {
|
|
28
29
|
/** Type-only seal produced by {@link createCLISchema}. */
|
|
29
|
-
readonly [schemaBrand]:
|
|
30
|
+
readonly [schemaBrand]: 'cli';
|
|
30
31
|
/** Program name (used in help text, usage lines, and completion scripts). */
|
|
31
32
|
readonly name: string;
|
|
32
33
|
/**
|
|
@@ -120,6 +121,16 @@ interface CLISchema {
|
|
|
120
121
|
*/
|
|
121
122
|
readonly builtins: Builtins;
|
|
122
123
|
}
|
|
124
|
+
/**
|
|
125
|
+
* Read the compiled state seeded by {@linkcode CLIBuilder._from}.
|
|
126
|
+
*
|
|
127
|
+
* @param builder - Builder to look up.
|
|
128
|
+
* @returns Its compiled execution graph.
|
|
129
|
+
* @throws {@linkcode CLIError} `INVALID_BUILDER_STATE` when the builder was not created by `cli()`.
|
|
130
|
+
*
|
|
131
|
+
* @internal
|
|
132
|
+
*/
|
|
133
|
+
declare function compiledStateOf(builder: CLIBuilder): CompiledCLI;
|
|
123
134
|
/**
|
|
124
135
|
* Configuration for the eager `--completions <shell>` flag.
|
|
125
136
|
*
|
|
@@ -174,7 +185,7 @@ interface HelpConfig {
|
|
|
174
185
|
*
|
|
175
186
|
* @defaultValue `'alphabetical'`
|
|
176
187
|
*/
|
|
177
|
-
readonly flagOrder?:
|
|
188
|
+
readonly flagOrder?: 'alphabetical' | 'declaration';
|
|
178
189
|
/**
|
|
179
190
|
* Custom comparator over flag long names for the `Flags:` table. When set,
|
|
180
191
|
* it wins over {@link HelpConfig.flagOrder}.
|
|
@@ -193,6 +204,13 @@ interface HelpConfig {
|
|
|
193
204
|
* @defaultValue `undefined` (built-in theme)
|
|
194
205
|
*/
|
|
195
206
|
readonly theme?: HelpThemeFactory;
|
|
207
|
+
/**
|
|
208
|
+
* Theme overrides used only by function-form flag and argument descriptions.
|
|
209
|
+
* Each supplied role merges over the resolved global theme.
|
|
210
|
+
*
|
|
211
|
+
* @defaultValue `undefined` (use the global theme)
|
|
212
|
+
*/
|
|
213
|
+
readonly descriptionTheme?: HelpThemeFactory;
|
|
196
214
|
}
|
|
197
215
|
/**
|
|
198
216
|
* Config discovery settings for automatic config file loading.
|
|
@@ -202,7 +220,7 @@ interface HelpConfig {
|
|
|
202
220
|
*/
|
|
203
221
|
interface ConfigSettings {
|
|
204
222
|
/** Type-only seal produced by {@link createCLISchema}. */
|
|
205
|
-
readonly [schemaBrand]:
|
|
223
|
+
readonly [schemaBrand]: 'config';
|
|
206
224
|
/**
|
|
207
225
|
* Application name used to build config search paths.
|
|
208
226
|
*
|
|
@@ -432,6 +450,22 @@ interface CLIRunOptions extends CLIExecuteOptions {
|
|
|
432
450
|
*/
|
|
433
451
|
readonly adapter?: RuntimeAdapter;
|
|
434
452
|
}
|
|
453
|
+
/**
|
|
454
|
+
* CLI execution options extended with the fields `.run()` and dispatch
|
|
455
|
+
* populate themselves.
|
|
456
|
+
*
|
|
457
|
+
* @internal
|
|
458
|
+
*/
|
|
459
|
+
interface InternalCLIExecuteOptions extends CLIExecuteOptions {
|
|
460
|
+
/** Output channel override so activity renders to the terminal. */
|
|
461
|
+
readonly out?: Out;
|
|
462
|
+
/** Capture buffers override paired with `out`. */
|
|
463
|
+
readonly captured?: CapturedOutput;
|
|
464
|
+
/** CLI plugins registered on the builder. */
|
|
465
|
+
readonly plugins?: readonly CLIPlugin[];
|
|
466
|
+
/** Built-in flag state from the schema, threaded to the command executor. */
|
|
467
|
+
readonly builtins?: BuiltinsConfig;
|
|
468
|
+
}
|
|
435
469
|
/**
|
|
436
470
|
* Inputs for {@linkcode resolveRenderContext}. Pass the host facts (TTY
|
|
437
471
|
* status, environment) and any explicit overrides; the resolver applies the
|
|
@@ -481,6 +515,13 @@ interface RenderContextOptions {
|
|
|
481
515
|
*/
|
|
482
516
|
readonly builtins?: BuiltinsConfig;
|
|
483
517
|
}
|
|
518
|
+
/**
|
|
519
|
+
* Seals {@linkcode RenderContext} against structural construction outside the
|
|
520
|
+
* framework.
|
|
521
|
+
*
|
|
522
|
+
* @internal
|
|
523
|
+
*/
|
|
524
|
+
declare const renderContextBrand: unique symbol;
|
|
484
525
|
/**
|
|
485
526
|
* The output decisions the framework will make for a given argv, resolved
|
|
486
527
|
* before `.run()`.
|
|
@@ -584,7 +625,19 @@ interface DefaultCommandOptions {
|
|
|
584
625
|
* ```
|
|
585
626
|
*/
|
|
586
627
|
declare class CLIBuilder {
|
|
628
|
+
/** @internal Runtime schema descriptor. */
|
|
629
|
+
readonly schema: CLISchema;
|
|
587
630
|
private constructor();
|
|
631
|
+
/**
|
|
632
|
+
* Build a CLI builder around a schema and its compiled execution graph.
|
|
633
|
+
*
|
|
634
|
+
* @param schema - Runtime schema descriptor.
|
|
635
|
+
* @param compiled - Compiled commands, default command, and plugins.
|
|
636
|
+
* @returns The builder, with its compiled state registered.
|
|
637
|
+
*
|
|
638
|
+
* @internal
|
|
639
|
+
*/
|
|
640
|
+
static _from(schema: CLISchema, compiled: CompiledCLI): CLIBuilder;
|
|
588
641
|
/**
|
|
589
642
|
* Set the program version (shown by `--version`).
|
|
590
643
|
*
|
|
@@ -1000,6 +1053,18 @@ declare class CLIBuilder {
|
|
|
1000
1053
|
*/
|
|
1001
1054
|
run(options?: CLIRunOptions): Promise<never>;
|
|
1002
1055
|
}
|
|
1056
|
+
/**
|
|
1057
|
+
* Execution body shared by {@linkcode CLIBuilder.execute} and {@linkcode CLIBuilder.run},
|
|
1058
|
+
* accepting the framework-populated output channel and plugin fields.
|
|
1059
|
+
*
|
|
1060
|
+
* @param builder - Builder supplying the schema and compiled command graph.
|
|
1061
|
+
* @param argv - Raw argv tokens (NOT including the binary/script path).
|
|
1062
|
+
* @param options - Injectable runtime state plus framework-populated fields.
|
|
1063
|
+
* @returns Structured result with exit code and captured output.
|
|
1064
|
+
*
|
|
1065
|
+
* @internal
|
|
1066
|
+
*/
|
|
1067
|
+
declare function executeCLI(builder: CLIBuilder, argv: readonly string[], options?: InternalCLIExecuteOptions): Promise<RunResult>;
|
|
1003
1068
|
/**
|
|
1004
1069
|
* CLI-name inference control for {@link ManifestSettings.inferName}.
|
|
1005
1070
|
*
|
|
@@ -1012,7 +1077,7 @@ declare class CLIBuilder {
|
|
|
1012
1077
|
* options object can never silently enable inference (use `true` for that).
|
|
1013
1078
|
*/
|
|
1014
1079
|
type InferNameOption = boolean | {
|
|
1015
|
-
readonly scope:
|
|
1080
|
+
readonly scope: 'keep' | 'strip';
|
|
1016
1081
|
};
|
|
1017
1082
|
/** Discovery settings accepted by {@link CLIBuilder.manifest}. */
|
|
1018
1083
|
interface ManifestSettings {
|
|
@@ -1086,7 +1151,7 @@ interface CLIOptions {
|
|
|
1086
1151
|
* .run();
|
|
1087
1152
|
* ```
|
|
1088
1153
|
*/
|
|
1089
|
-
declare function cli(name: string, options?: Omit<CLIOptions,
|
|
1154
|
+
declare function cli(name: string, options?: Omit<CLIOptions, 'name'>): CLIBuilder;
|
|
1090
1155
|
/** Create a new CLI program builder from an options object. */
|
|
1091
1156
|
declare function cli(options: CLIOptions): CLIBuilder;
|
|
1092
1157
|
/**
|
|
@@ -1108,4 +1173,4 @@ declare function cli(options: CLIOptions): CLIBuilder;
|
|
|
1108
1173
|
*/
|
|
1109
1174
|
declare function isMainModule(meta: ImportMeta): boolean;
|
|
1110
1175
|
//#endregion
|
|
1111
|
-
export { type BeforeParseParams, type BuiltinMode, type BuiltinName, type Builtins, type BuiltinsConfig, CLIBuilder, type CLIDefinition, type CLIExecuteOptions, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type CompletionsFlagConfig, type ConfigSettings, type ConfigSettingsDefinition, type DefaultCommandOptions, type HelpConfig, type HelpLinks, type InferNameOption, type ManifestSettings, type PluginCommandContext, type RenderContext, type RenderContextOptions, type ResolvedCommandParams, type ResolvedManifestSettings, cli, createCLISchema, isMainModule, plugin, resolveRenderContext };
|
|
1176
|
+
export { type BeforeParseParams, type BuiltinMode, type BuiltinName, type Builtins, type BuiltinsConfig, CLIBuilder, type CLIDefinition, type CLIExecuteOptions, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type CompletionsFlagConfig, type ConfigSettings, type ConfigSettingsDefinition, type DefaultCommandOptions, type HelpConfig, type HelpLinks, type InferNameOption, type ManifestSettings, type PluginCommandContext, type RenderContext, type RenderContextOptions, type ResolvedCommandParams, type ResolvedManifestSettings, cli, compiledStateOf, createCLISchema, executeCLI, isMainModule, plugin, resolveRenderContext };
|
package/dist/core/cli/index.mjs
CHANGED
|
@@ -275,6 +275,10 @@ function resolveRenderContext(argv, options) {
|
|
|
275
275
|
function hyperlinksOption(override) {
|
|
276
276
|
return override !== void 0 ? { hyperlinks: override } : {};
|
|
277
277
|
}
|
|
278
|
+
/** Resolve the hyperlink decision shared by help rendering and the output channel. @internal */
|
|
279
|
+
function resolveEffectiveHyperlinkOverride(runtimeHelp, configuredHelp, env, argv) {
|
|
280
|
+
return runtimeHelp?.hyperlinks ?? configuredHelp?.hyperlinks ?? resolveHyperlinkOverride(env, argv);
|
|
281
|
+
}
|
|
278
282
|
/**
|
|
279
283
|
* Build {@linkcode RunOptions} from {@linkcode CLIExecuteOptions}, conditionally spreading each
|
|
280
284
|
* field to satisfy `exactOptionalPropertyTypes`.
|
|
@@ -856,6 +860,7 @@ var CLIBuilder = class CLIBuilder {
|
|
|
856
860
|
...options?.help,
|
|
857
861
|
width: runtimeHelpWidth
|
|
858
862
|
} : options?.help;
|
|
863
|
+
const hyperlinkOverride = resolveEffectiveHyperlinkOverride(runtimeHelpOptions, effectiveBuilder.schema.helpConfig, adapter.env, adapter.argv);
|
|
859
864
|
const executeOptions = {
|
|
860
865
|
...options,
|
|
861
866
|
...preflight.inputs,
|
|
@@ -866,7 +871,7 @@ var CLIBuilder = class CLIBuilder {
|
|
|
866
871
|
jsonMode: preflight.inputs.jsonMode,
|
|
867
872
|
isTTY: preflight.inputs.isTTY,
|
|
868
873
|
...preflight.inputs.verbosity !== "normal" ? { verbosity: preflight.inputs.verbosity } : {},
|
|
869
|
-
...hyperlinksOption(
|
|
874
|
+
...hyperlinksOption(hyperlinkOverride)
|
|
870
875
|
})
|
|
871
876
|
};
|
|
872
877
|
const result = await executeCLI(effectiveBuilder, preflight.filteredArgv, executeOptions);
|
|
@@ -890,11 +895,12 @@ async function executeCLI(builder, argv, options) {
|
|
|
890
895
|
const rootOutputFlags = readRootOutputFlags(argv, builder.schema.builtins);
|
|
891
896
|
const jsonMode = resolveRootJsonMode(rootOutputFlags, options?.jsonMode);
|
|
892
897
|
const verbosity = resolveRootVerbosity(rootOutputFlags, options?.verbosity);
|
|
898
|
+
const hyperlinkOverride = resolveEffectiveHyperlinkOverride(options?.help, builder.schema.helpConfig, options?.env ?? {}, argv);
|
|
893
899
|
const captureOptions = {
|
|
894
900
|
...verbosity !== void 0 ? { verbosity } : {},
|
|
895
901
|
...jsonMode ? { jsonMode } : {},
|
|
896
902
|
...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {},
|
|
897
|
-
...hyperlinksOption(
|
|
903
|
+
...hyperlinksOption(hyperlinkOverride)
|
|
898
904
|
};
|
|
899
905
|
let out;
|
|
900
906
|
let captured;
|
|
@@ -912,7 +918,7 @@ async function executeCLI(builder, argv, options) {
|
|
|
912
918
|
...builder.schema.helpConfig,
|
|
913
919
|
...options?.help,
|
|
914
920
|
binName: options?.help?.binName ?? builder.schema.name,
|
|
915
|
-
hyperlinks:
|
|
921
|
+
hyperlinks: out.isHyperlinkSupported,
|
|
916
922
|
colors: options?.help?.colors ?? out.color,
|
|
917
923
|
...resolvedVersion !== void 0 ? { version: resolvedVersion } : {}
|
|
918
924
|
};
|
|
@@ -1,28 +1,64 @@
|
|
|
1
|
+
import { BuiltinsConfig } from "./builtins.mjs";
|
|
2
|
+
import { CLIError } from "../errors/index.mjs";
|
|
1
3
|
import { OutputPolicy } from "../output/contracts.mjs";
|
|
2
4
|
import { CommandMeta, CommandSchema } from "../schema/command.mjs";
|
|
3
|
-
import { CLIError } from "../errors/index.mjs";
|
|
4
5
|
import { HelpOptions } from "../help/index.mjs";
|
|
6
|
+
import { ParseOptions } from "../parse/index.mjs";
|
|
5
7
|
import { CLIPlugin } from "./plugin.mjs";
|
|
6
|
-
import { CompiledCommand } from "./compiled.mjs";
|
|
8
|
+
import { CompiledCLI, CompiledCommand } from "./compiled.mjs";
|
|
9
|
+
import { CompletionOptions } from "../completion/shells/shared.mjs";
|
|
10
|
+
import { Shell } from "../completion/index.mjs";
|
|
7
11
|
//#region src/core/cli/planner.d.ts
|
|
12
|
+
/**
|
|
13
|
+
* Descriptive subset of CLISchema used by the planner.
|
|
14
|
+
*
|
|
15
|
+
* Decouples invocation planning from the full CLIBuilder surface so the
|
|
16
|
+
* planner can be tested and reasoned about without constructing a real CLI.
|
|
17
|
+
* The executable half of a program reaches the planner separately, as the
|
|
18
|
+
* {@linkcode CompiledCLI} passed alongside this schema.
|
|
19
|
+
* @internal
|
|
20
|
+
*/
|
|
21
|
+
interface PlannerSchemaLike {
|
|
22
|
+
/** CLI program name used in help text and error messages. */
|
|
23
|
+
readonly name: string;
|
|
24
|
+
/** Declared version string; `undefined` disables `--version` interception. */
|
|
25
|
+
readonly version: string | undefined;
|
|
26
|
+
/** Whether the default command is also exposed as a named top-level route. */
|
|
27
|
+
readonly defaultCommandRouted: boolean;
|
|
28
|
+
/**
|
|
29
|
+
* Eager `--completions <shell>` flag configuration, when `.completions()`
|
|
30
|
+
* was registered with `{ as: 'flag' }`. `undefined` disables interception.
|
|
31
|
+
*/
|
|
32
|
+
readonly completionsFlag: {
|
|
33
|
+
readonly shells: readonly Shell[];
|
|
34
|
+
readonly options: CompletionOptions | undefined;
|
|
35
|
+
} | undefined;
|
|
36
|
+
/** Flag-parsing behavior settings (case parity) applied to flag lookups. */
|
|
37
|
+
readonly flagSettings?: ParseOptions | undefined;
|
|
38
|
+
/**
|
|
39
|
+
* Built-in flag state. `help: 'off'` stops root `--help`/`-h` interception
|
|
40
|
+
* and bare `help` routing, and `json`/`quiet` stop being read out of argv.
|
|
41
|
+
*/
|
|
42
|
+
readonly builtins: BuiltinsConfig | undefined;
|
|
43
|
+
}
|
|
8
44
|
/** Root-level help interception outcome. */
|
|
9
45
|
interface RootHelpOutcome {
|
|
10
46
|
/** Discriminant — argv matched `--help` / `-h` before any command. */
|
|
11
|
-
readonly kind:
|
|
47
|
+
readonly kind: 'root-help';
|
|
12
48
|
/** Help options to render root-level usage. */
|
|
13
49
|
readonly help: HelpOptions;
|
|
14
50
|
}
|
|
15
51
|
/** Root-level version interception outcome. */
|
|
16
52
|
interface RootVersionOutcome {
|
|
17
53
|
/** Discriminant — argv matched `--version` / `-V` and schema declares a version. */
|
|
18
|
-
readonly kind:
|
|
54
|
+
readonly kind: 'root-version';
|
|
19
55
|
/** Resolved version string to render. */
|
|
20
56
|
readonly version: string;
|
|
21
57
|
}
|
|
22
58
|
/** Root-level `--completions [shell]` interception outcome. */
|
|
23
59
|
interface RootCompletionsOutcome {
|
|
24
60
|
/** Discriminant — argv matched the eager `--completions [shell]` flag. */
|
|
25
|
-
readonly kind:
|
|
61
|
+
readonly kind: 'root-completions';
|
|
26
62
|
/**
|
|
27
63
|
* Resolved, validated target shell, or `undefined` when the flag was given
|
|
28
64
|
* without a value and the shell should be auto-detected from the environment.
|
|
@@ -34,14 +70,14 @@ interface RootCompletionsOutcome {
|
|
|
34
70
|
/** CLI-level dispatch failure before command execution starts. */
|
|
35
71
|
interface DispatchErrorOutcome {
|
|
36
72
|
/** Discriminant — dispatch could not resolve a command from argv. */
|
|
37
|
-
readonly kind:
|
|
73
|
+
readonly kind: 'dispatch-error';
|
|
38
74
|
/** Structured error with suggestion text for the caller to render. */
|
|
39
75
|
readonly error: CLIError;
|
|
40
76
|
}
|
|
41
77
|
/** Successful planner handoff to the shared command execution path. */
|
|
42
78
|
interface PlannerMatchOutcome {
|
|
43
79
|
/** Discriminant — dispatch found a matching command for argv. */
|
|
44
|
-
readonly kind:
|
|
80
|
+
readonly kind: 'match';
|
|
45
81
|
/** Fully resolved execution plan ready for the executor pipeline. */
|
|
46
82
|
readonly plan: CommandExecutionPlan;
|
|
47
83
|
}
|
|
@@ -83,6 +119,39 @@ interface BuildCommandExecutionPlanOptions {
|
|
|
83
119
|
readonly output: OutputPolicy;
|
|
84
120
|
readonly help: HelpOptions | undefined;
|
|
85
121
|
}
|
|
122
|
+
/**
|
|
123
|
+
* Dispatch resolved a group command that requires a subcommand selection.
|
|
124
|
+
*
|
|
125
|
+
* The caller should render subcommand-level help for the matched group.
|
|
126
|
+
* @internal
|
|
127
|
+
*/
|
|
128
|
+
interface NeedsSubcommandOutcome {
|
|
129
|
+
/** Discriminant — group command matched but no leaf subcommand was selected. */
|
|
130
|
+
readonly kind: 'needs-subcommand';
|
|
131
|
+
/** The group command that was matched. */
|
|
132
|
+
readonly command: CompiledCommand;
|
|
133
|
+
/** Full ancestor path from root to this group, used for propagated flag collection. */
|
|
134
|
+
readonly commandPath: readonly CommandSchema[];
|
|
135
|
+
/** Help options scoped to the group command's bin path. */
|
|
136
|
+
readonly help: HelpOptions;
|
|
137
|
+
}
|
|
138
|
+
/** Full planner result including the `needs-subcommand` variant used by CLIBuilder. @internal */
|
|
139
|
+
type InvocationPlan = DispatchOutcome | NeedsSubcommandOutcome;
|
|
140
|
+
/** Options bag for {@linkcode planInvocation}. @internal */
|
|
141
|
+
interface PlanInvocationOptions {
|
|
142
|
+
/** CLI schema subset driving dispatch decisions. */
|
|
143
|
+
readonly schema: PlannerSchemaLike;
|
|
144
|
+
/** Compiled execution graph the dispatch walk resolves commands from. */
|
|
145
|
+
readonly compiled: CompiledCLI;
|
|
146
|
+
/** Raw argv tokens (typically `adapter.argv.slice(2)`). */
|
|
147
|
+
readonly argv: readonly string[];
|
|
148
|
+
/** Root-level help configuration for rendering. */
|
|
149
|
+
readonly help: HelpOptions;
|
|
150
|
+
/** Output policy propagated into matched execution plans. */
|
|
151
|
+
readonly output: OutputPolicy;
|
|
152
|
+
}
|
|
153
|
+
/** Build a name+alias lookup map for top-level commands. @internal */
|
|
154
|
+
declare function buildRootCommandMap(commands: readonly CompiledCommand[]): ReadonlyMap<string, CompiledCommand>;
|
|
86
155
|
/**
|
|
87
156
|
* Merge propagated ancestor flags into the matched command schema.
|
|
88
157
|
*
|
|
@@ -92,5 +161,14 @@ interface BuildCommandExecutionPlanOptions {
|
|
|
92
161
|
declare function mergeCommandSchema(command: CompiledCommand, commandPath: readonly CommandSchema[]): CommandSchema;
|
|
93
162
|
/** Build the planner handoff for a matched command invocation. */
|
|
94
163
|
declare function buildCommandExecutionPlan(options: BuildCommandExecutionPlanOptions): CommandExecutionPlan;
|
|
164
|
+
/**
|
|
165
|
+
* Decide what to do with an argv invocation before any command executes.
|
|
166
|
+
*
|
|
167
|
+
* Handles root interception (`--help`, `--version`, `--completions <shell>`,
|
|
168
|
+
* bare `help` token), dispatches into the command tree, falls back to the
|
|
169
|
+
* default command, and produces structured errors for unknown commands/flags.
|
|
170
|
+
* @internal
|
|
171
|
+
*/
|
|
172
|
+
declare function planInvocation(options: PlanInvocationOptions): InvocationPlan;
|
|
95
173
|
//#endregion
|
|
96
|
-
export { type CommandExecutionPlan, type DispatchErrorOutcome, type DispatchOutcome, type OutputPolicy, type PlannerMatchOutcome, type RootCompletionsOutcome, type RootHelpOutcome, type RootVersionOutcome, buildCommandExecutionPlan, mergeCommandSchema };
|
|
174
|
+
export { type CommandExecutionPlan, type DispatchErrorOutcome, type DispatchOutcome, type InvocationPlan, type NeedsSubcommandOutcome, type OutputPolicy, type PlanInvocationOptions, type PlannerMatchOutcome, type PlannerSchemaLike, type RootCompletionsOutcome, type RootHelpOutcome, type RootVersionOutcome, buildCommandExecutionPlan, buildRootCommandMap, mergeCommandSchema, planInvocation };
|