@kjanat/dreamcli 3.0.0-rc.2 → 3.0.0-rc.20
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 +374 -1
- package/README.md +3 -3
- package/dist/core/cli/dispatch.d.mts +6 -5
- package/dist/core/cli/dispatch.mjs +7 -16
- package/dist/core/cli/help-links.d.mts +0 -1
- package/dist/core/cli/index.d.mts +213 -16
- package/dist/core/cli/index.mjs +174 -43
- package/dist/core/cli/planner.d.mts +5 -1
- package/dist/core/cli/planner.mjs +19 -13
- package/dist/core/cli/plugin.d.mts +1 -1
- package/dist/core/cli/propagate.d.mts +1 -1
- package/dist/core/cli/root-help.d.mts +2 -1
- package/dist/core/cli/root-help.mjs +45 -22
- package/dist/core/cli/root-surface.d.mts +12 -1
- package/dist/core/cli/root-surface.mjs +2 -1
- package/dist/core/cli/runtime-preflight.d.mts +18 -2
- package/dist/core/cli/runtime-preflight.mjs +10 -7
- package/dist/core/completion/index.d.mts +0 -1
- package/dist/core/completion/index.mjs +1 -1
- package/dist/core/completion/shells/bash.d.mts +0 -1
- package/dist/core/completion/shells/bash.mjs +8 -4
- package/dist/core/completion/shells/fish.d.mts +0 -1
- package/dist/core/completion/shells/fish.mjs +6 -3
- package/dist/core/completion/shells/powershell.d.mts +0 -1
- package/dist/core/completion/shells/powershell.mjs +10 -5
- package/dist/core/completion/shells/shared.d.mts +13 -2
- package/dist/core/completion/shells/shared.mjs +25 -2
- package/dist/core/completion/shells/zsh.d.mts +0 -1
- package/dist/core/completion/shells/zsh.mjs +11 -4
- package/dist/core/config/index.d.mts +44 -14
- package/dist/core/config/index.mjs +57 -18
- package/dist/core/config/package-json.d.mts +28 -4
- package/dist/core/config/package-json.mjs +20 -19
- package/dist/core/errors/index.d.mts +3 -3
- package/dist/core/execution/index.d.mts +0 -1
- package/dist/core/execution/index.mjs +20 -4
- package/dist/core/help/ansi.d.mts +11 -5
- package/dist/core/help/ansi.mjs +15 -16
- package/dist/core/help/index.d.mts +44 -3
- package/dist/core/help/index.mjs +130 -68
- package/dist/core/help/theme.d.mts +68 -0
- package/dist/core/help/theme.mjs +46 -0
- package/dist/core/json-schema/index.d.mts +21 -9
- package/dist/core/json-schema/index.mjs +316 -87
- package/dist/core/json-schema/meta-descriptions.generated.d.mts +55 -38
- package/dist/core/json-schema/meta-descriptions.generated.mjs +14 -5
- package/dist/core/output/activity.d.mts +0 -1
- package/dist/core/output/contracts.d.mts +5 -6
- package/dist/core/output/contracts.mjs +2 -2
- package/dist/core/output/index.d.mts +38 -2
- package/dist/core/output/index.mjs +37 -2
- package/dist/core/output/renderers.d.mts +0 -1
- package/dist/core/parse/index.d.mts +40 -7
- package/dist/core/parse/index.mjs +212 -40
- package/dist/core/prompt/index.d.mts +1 -0
- package/dist/core/resolve/args.d.mts +1 -1
- package/dist/core/resolve/coerce.d.mts +1 -1
- package/dist/core/resolve/coerce.mjs +71 -14
- package/dist/core/resolve/contracts.d.mts +14 -4
- package/dist/core/resolve/errors.d.mts +0 -1
- package/dist/core/resolve/flags.d.mts +9 -2
- package/dist/core/resolve/flags.mjs +78 -6
- package/dist/core/resolve/index.d.mts +2 -2
- package/dist/core/resolve/index.mjs +6 -1
- package/dist/core/resolve/property.d.mts +4 -1
- package/dist/core/resolve/property.mjs +11 -3
- package/dist/core/resolve/standard.d.mts +24 -0
- package/dist/core/resolve/standard.mjs +114 -0
- package/dist/core/schema/activity.d.mts +31 -11
- package/dist/core/schema/arg.d.mts +38 -4
- package/dist/core/schema/arg.mjs +5 -2
- package/dist/core/schema/command.d.mts +57 -13
- package/dist/core/schema/command.mjs +41 -17
- package/dist/core/schema/flag.d.mts +553 -19
- package/dist/core/schema/flag.mjs +261 -5
- package/dist/core/schema/index.d.mts +6 -3
- package/dist/core/schema/middleware.d.mts +4 -3
- package/dist/core/schema/prompt.d.mts +6 -3
- package/dist/core/schema/run.d.mts +27 -1
- package/dist/core/schema/standard.d.mts +100 -0
- package/dist/core/schema/standard.mjs +15 -0
- package/dist/core/schema/string-constraints.d.mts +97 -0
- package/dist/core/schema/string-constraints.mjs +69 -0
- package/dist/core/schema/value-parsers.d.mts +78 -0
- package/dist/core/schema/value-parsers.mjs +142 -0
- package/dist/core/testkit/index.d.mts +0 -31
- package/dist/core/testkit/index.mjs +1 -1
- package/dist/index.d.mts +12 -7
- package/dist/index.mjs +9 -9
- package/dist/runtime/adapter.d.mts +71 -2
- package/dist/runtime/adapter.mjs +11 -1
- package/dist/runtime/auto.d.mts +2 -3
- package/dist/runtime/auto.mjs +4 -5
- package/dist/runtime/deno.d.mts +28 -5
- package/dist/runtime/deno.mjs +49 -1
- package/dist/runtime/index.d.mts +3 -4
- package/dist/runtime/node.d.mts +8 -2
- package/dist/runtime/node.mjs +60 -1
- package/dist/runtime.d.mts +4 -4
- package/dist/runtime.mjs +2 -3
- package/dist/testkit.d.mts +1 -0
- package/dist/version.d.mts +7 -3
- package/dist/version.mjs +2 -2
- package/dreamcli.schema.json +118 -7
- package/examples/gh/node_modules/typescript/LICENSE +55 -0
- package/examples/gh/node_modules/typescript/NOTICE.txt +436 -0
- package/examples/gh/node_modules/typescript/README.md +49 -0
- package/examples/gh/node_modules/typescript/bin/tsc +2 -0
- package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts +529 -0
- package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/async/api.js +1657 -0
- package/examples/gh/node_modules/typescript/dist/api/async/api.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts +39 -0
- package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/async/client.js +211 -0
- package/examples/gh/node_modules/typescript/dist/api/async/client.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts +310 -0
- package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/async/types.js +2 -0
- package/examples/gh/node_modules/typescript/dist/api/async/types.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts +109 -0
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js +2 -0
- package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/fs.d.ts +23 -0
- package/examples/gh/node_modules/typescript/dist/api/fs.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/fs.js +109 -0
- package/examples/gh/node_modules/typescript/dist/api/fs.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts +15 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts +5 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js +74 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.js +287 -0
- package/examples/gh/node_modules/typescript/dist/api/node/encoder.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts +32 -0
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js +213 -0
- package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts +76 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts +182 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js +835 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts +62 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js +122 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.js +298 -0
- package/examples/gh/node_modules/typescript/dist/api/node/node.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts +29 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts +4 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js +241 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.js +30 -0
- package/examples/gh/node_modules/typescript/dist/api/node/protocol.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts +6 -0
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js +61 -0
- package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/options.d.ts +32 -0
- package/examples/gh/node_modules/typescript/dist/api/options.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/options.js +11 -0
- package/examples/gh/node_modules/typescript/dist/api/options.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/path.d.ts +110 -0
- package/examples/gh/node_modules/typescript/dist/api/path.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/path.js +508 -0
- package/examples/gh/node_modules/typescript/dist/api/path.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/proto.d.ts +239 -0
- package/examples/gh/node_modules/typescript/dist/api/proto.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/proto.js +37 -0
- package/examples/gh/node_modules/typescript/dist/api/proto.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts +79 -0
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js +169 -0
- package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts +529 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/api.js +1665 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/api.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts +30 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/client.js +124 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/client.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts +310 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/types.js +2 -0
- package/examples/gh/node_modules/typescript/dist/api/sync/types.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts +114 -0
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.js +508 -0
- package/examples/gh/node_modules/typescript/dist/api/syncChannel.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/timing.d.ts +175 -0
- package/examples/gh/node_modules/typescript/dist/api/timing.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/api/timing.js +149 -0
- package/examples/gh/node_modules/typescript/dist/api/timing.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts +100 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts +1161 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js +4 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.js +7 -0
- package/examples/gh/node_modules/typescript/dist/ast/ast.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts +19 -0
- package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/astnav.js +596 -0
- package/examples/gh/node_modules/typescript/dist/ast/astnav.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts +16 -0
- package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/clone.js +104 -0
- package/examples/gh/node_modules/typescript/dist/ast/clone.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts +520 -0
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js +3057 -0
- package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/index.d.ts +20 -0
- package/examples/gh/node_modules/typescript/dist/ast/index.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/index.js +20 -0
- package/examples/gh/node_modules/typescript/dist/ast/index.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.d.ts +35 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts +329 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.js +1103 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.generated.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.js +233 -0
- package/examples/gh/node_modules/typescript/dist/ast/is.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts +11 -0
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js +202 -0
- package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts +97 -0
- package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/scanner.js +2230 -0
- package/examples/gh/node_modules/typescript/dist/ast/scanner.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts +17 -0
- package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/utils.js +67 -0
- package/examples/gh/node_modules/typescript/dist/ast/utils.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts +14 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts +50 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js +978 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.js +47 -0
- package/examples/gh/node_modules/typescript/dist/ast/visitor.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts +129 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js +132 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js +130 -0
- package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts +5 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js +6 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js +6 -0
- package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts +28 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js +30 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js +30 -0
- package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts +7 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts +12 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js +14 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js +14 -0
- package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts +23 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js +25 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js +25 -0
- package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js +11 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js +11 -0
- package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts +5 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js +6 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js +6 -0
- package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts +42 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js +44 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js +44 -0
- package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts +7 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts +17 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js +19 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js +19 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js +11 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js +11 -0
- package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts +6 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js +8 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js +8 -0
- package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts +36 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js +38 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js +38 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts +44 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js +46 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js +46 -0
- package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts +50 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js +52 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js +52 -0
- package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts +16 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js +18 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js +18 -0
- package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts +13 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js +14 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js +14 -0
- package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts +11 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js +12 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js +12 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts +17 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js +18 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js +18 -0
- package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts +15 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js +17 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js +17 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts +5 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js +7 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js +7 -0
- package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts +71 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js +73 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js +73 -0
- package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts +389 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js +391 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js +391 -0
- package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts +30 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js +32 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js +32 -0
- package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts +76 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js +78 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js +78 -0
- package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts +2 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts +7 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js +9 -0
- package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js.map +1 -0
- package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts +23 -0
- package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts.map +1 -0
- package/examples/gh/node_modules/typescript/dist/internal/utils.js +25 -0
- package/examples/gh/node_modules/typescript/dist/internal/utils.js.map +1 -0
- package/examples/gh/node_modules/typescript/lib/getExePath.d.ts +2 -0
- package/examples/gh/node_modules/typescript/lib/getExePath.js +70 -0
- package/examples/gh/node_modules/typescript/lib/tsc.js +28 -0
- package/examples/gh/node_modules/typescript/lib/version.cjs +3 -0
- package/examples/gh/node_modules/typescript/lib/version.d.cts +2 -0
- package/examples/gh/node_modules/typescript/package.json +87 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/License.txt +11 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/README.md +54 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.d.ts +17 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.js +83 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.d.ts +22 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.js +210 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.d.ts +14 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.js +87 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.d.ts +32 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.js +132 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.d.ts +367 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.js +1271 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.d.ts +9 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.js +16 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.d.ts +52 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.js +70 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.d.ts +39 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.js +135 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.d.ts +7 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.js +34 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.d.ts +55 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.js +412 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.d.ts +18 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.js +155 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.d.ts +77 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.js +246 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.d.ts +60 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.js +157 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.d.ts +369 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.js +436 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.d.ts +74 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.js +23 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.d.ts +10 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.js +74 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.d.ts +15 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.js +77 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.d.ts +58 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.js +289 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.d.ts +12 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.js +163 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/package.json +54 -0
- package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/typings/thenable.d.ts +5 -0
- package/examples/gh/package.json +11 -5
- package/examples/gh/src/main.ts +10 -4
- package/examples/pwsh-demo/package.json +1 -1
- package/examples/pwsh-demo/src/main.ts +1 -1
- package/package.json +45 -41
- package/dist/core/schema-dsl/runtime.d.mts +0 -144
- package/dist/core/schema-dsl/runtime.mjs +0 -271
- package/dist/core/schema-dsl/to-json-schema.d.mts +0 -30
- package/dist/core/schema-dsl/to-json-schema.mjs +0 -74
- package/dist/runtime/bun.d.mts +0 -28
- package/dist/runtime/bun.mjs +0 -28
|
@@ -1,7 +1,8 @@
|
|
|
1
|
+
import { command } from "../schema/command.mjs";
|
|
1
2
|
import { resolveRootSurface } from "./root-surface.mjs";
|
|
2
3
|
import { osc8, padEnd, wrapText } from "../help/ansi.mjs";
|
|
4
|
+
import { resolveHelpTheme } from "../help/theme.mjs";
|
|
3
5
|
import { formatFlagEntriesBlock, formatHelpSections } from "../help/index.mjs";
|
|
4
|
-
import { command } from "../schema/command.mjs";
|
|
5
6
|
//#region src/core/cli/root-help.ts
|
|
6
7
|
/**
|
|
7
8
|
* Root-level help formatter for the CLI program.
|
|
@@ -30,16 +31,18 @@ function formatRootHelp(schema, options) {
|
|
|
30
31
|
const hyperlinks = options?.hyperlinks === true;
|
|
31
32
|
const inlineDefault = options?.inlineDefault ?? true;
|
|
32
33
|
const showDefaultInCommands = options?.showDefaultInCommands ?? false;
|
|
34
|
+
const theme = resolveHelpTheme(options?.colors, options?.theme);
|
|
33
35
|
const surface = resolveRootSurface(schema);
|
|
34
36
|
const defaultCommand = surface.visibleDefaultCommand;
|
|
35
37
|
const defaultIsSoleSurface = !surface.hasVisibleSubcommands && schema.completionsFlag === void 0;
|
|
36
38
|
const inlineDefaultCommand = inlineDefault || defaultIsSoleSurface ? defaultCommand : void 0;
|
|
37
39
|
const surfaceCommand = resolveSurfaceCommand(schema, inlineDefaultCommand);
|
|
38
40
|
const inline = surfaceCommand !== void 0;
|
|
39
|
-
const sections = [formatHeader(schema, hyperlinks)];
|
|
41
|
+
const sections = [formatHeader(schema, hyperlinks, theme)];
|
|
40
42
|
if (schema.description !== void 0) sections.push(schema.description);
|
|
41
43
|
const placeholder = surface.hasVisibleSubcommands ? defaultCommand !== void 0 ? "[command]" : "<command>" : "";
|
|
42
|
-
const
|
|
44
|
+
const usageTitle = theme.sectionTitle("Usage:");
|
|
45
|
+
const rootUsage = placeholder.length > 0 ? `${usageTitle} ${theme.usageBin(binName)} ${theme.placeholder(placeholder)} ${theme.placeholder("[options]")}` : `${usageTitle} ${theme.usageBin(binName)} ${theme.placeholder("[options]")}`;
|
|
43
46
|
let surfaceSections = [];
|
|
44
47
|
if (inline && surfaceCommand !== void 0) surfaceSections = [...formatHelpSections(surfaceCommand, {
|
|
45
48
|
...options,
|
|
@@ -47,15 +50,16 @@ function formatRootHelp(schema, options) {
|
|
|
47
50
|
isDefaultHelp: true
|
|
48
51
|
})];
|
|
49
52
|
const surfaceUsage = surfaceSections.shift();
|
|
50
|
-
if (inline && surfaceUsage !== void 0 && inlineDefaultCommand !== void 0) sections.push(surface.hasVisibleSubcommands ? mergeUsageSections(rootUsage, surfaceUsage) : surfaceUsage);
|
|
53
|
+
if (inline && surfaceUsage !== void 0 && inlineDefaultCommand !== void 0) sections.push(surface.hasVisibleSubcommands ? mergeUsageSections(rootUsage, surfaceUsage, usageTitle) : surfaceUsage);
|
|
51
54
|
else sections.push(rootUsage);
|
|
52
|
-
const
|
|
53
|
-
|
|
55
|
+
const listDefaultInCommands = defaultCommand !== void 0 && (surface.defaultRouted || showDefaultInCommands);
|
|
56
|
+
const listedCommands = listDefaultInCommands ? [...surface.visibleSubcommands, defaultCommand] : surface.visibleSubcommands;
|
|
57
|
+
if (listedCommands.length > 0) sections.push(formatRootCommandsSection(listedCommands, listDefaultInCommands ? defaultCommand?.name : void 0, width, theme));
|
|
54
58
|
if (inline && surfaceCommand !== void 0) {
|
|
55
59
|
if (surfaceCommand.description !== void 0 && surfaceCommand.description === schema.description && surfaceSections[0] === surfaceCommand.description) surfaceSections.shift();
|
|
56
60
|
sections.push(...surfaceSections);
|
|
57
61
|
}
|
|
58
|
-
const globalOptions = formatGlobalOptionsSection(schema, width);
|
|
62
|
+
const globalOptions = formatGlobalOptionsSection(schema, width, theme);
|
|
59
63
|
if (globalOptions.length > 0) sections.push(globalOptions);
|
|
60
64
|
if (options?.footer ?? surface.hasVisibleSubcommands) {
|
|
61
65
|
const footerPlaceholder = surface.hasVisibleSubcommands ? defaultCommand !== void 0 ? " [command]" : " <command>" : "";
|
|
@@ -104,11 +108,19 @@ function completionsFlagSchema(shells) {
|
|
|
104
108
|
description: "Print a shell completion script and exit",
|
|
105
109
|
enumValues: shells,
|
|
106
110
|
elementSchema: void 0,
|
|
111
|
+
separator: void 0,
|
|
112
|
+
unique: false,
|
|
107
113
|
numberConstraints: void 0,
|
|
114
|
+
stringConstraints: void 0,
|
|
115
|
+
pathChecks: void 0,
|
|
116
|
+
valueHint: void 0,
|
|
108
117
|
prompt: void 0,
|
|
109
118
|
parseFn: void 0,
|
|
119
|
+
standard: void 0,
|
|
110
120
|
deprecated: void 0,
|
|
111
|
-
propagate: false
|
|
121
|
+
propagate: false,
|
|
122
|
+
negation: void 0,
|
|
123
|
+
duplicates: "last"
|
|
112
124
|
};
|
|
113
125
|
}
|
|
114
126
|
/**
|
|
@@ -122,14 +134,16 @@ function completionsFlagSchema(shells) {
|
|
|
122
134
|
*
|
|
123
135
|
* @param schema - The CLI schema.
|
|
124
136
|
* @param hyperlinks - Whether OSC 8 hyperlinks may be emitted.
|
|
137
|
+
* @param theme - Theme applied to the name and version (inside any hyperlink).
|
|
125
138
|
* @returns The header line.
|
|
126
139
|
* @internal
|
|
127
140
|
*/
|
|
128
|
-
function formatHeader(schema, hyperlinks) {
|
|
141
|
+
function formatHeader(schema, hyperlinks, theme) {
|
|
129
142
|
const links = hyperlinks ? schema.helpLinks : void 0;
|
|
130
|
-
const
|
|
143
|
+
const styledName = theme.headerName(schema.name);
|
|
144
|
+
const name = links?.name !== void 0 ? osc8(links.name, styledName) : styledName;
|
|
131
145
|
if (schema.version === void 0) return name;
|
|
132
|
-
const version = `v${schema.version}
|
|
146
|
+
const version = theme.headerVersion(`v${schema.version}`);
|
|
133
147
|
return `${name} ${links?.version !== void 0 ? osc8(links.version, version) : version}`;
|
|
134
148
|
}
|
|
135
149
|
/**
|
|
@@ -138,11 +152,12 @@ function formatHeader(schema, hyperlinks) {
|
|
|
138
152
|
* @param visibleCommands - Non-hidden top-level commands.
|
|
139
153
|
* @param defaultName - Name of the default command (appends " (default)" tag).
|
|
140
154
|
* @param width - Terminal width for description wrapping.
|
|
155
|
+
* @param theme - Theme applied to the title, command names, and default tag.
|
|
141
156
|
* @returns Formatted commands block.
|
|
142
157
|
* @internal
|
|
143
158
|
*/
|
|
144
|
-
function formatRootCommandsSection(visibleCommands, defaultName, width) {
|
|
145
|
-
const lines = ["Commands:"];
|
|
159
|
+
function formatRootCommandsSection(visibleCommands, defaultName, width, theme) {
|
|
160
|
+
const lines = [theme.sectionTitle("Commands:")];
|
|
146
161
|
const GAP = 2;
|
|
147
162
|
const DEFAULT_TAG = " (default)";
|
|
148
163
|
let maxNameLen = 0;
|
|
@@ -153,7 +168,7 @@ function formatRootCommandsSection(visibleCommands, defaultName, width) {
|
|
|
153
168
|
}
|
|
154
169
|
const descCol = 2 + maxNameLen + GAP;
|
|
155
170
|
for (const cmd of visibleCommands) {
|
|
156
|
-
const padded = padEnd(` ${cmd.name === defaultName ? `${cmd.name}${DEFAULT_TAG}` : cmd.name}`, descCol);
|
|
171
|
+
const padded = padEnd(` ${cmd.name === defaultName ? `${theme.command(cmd.name)}${theme.annotation(DEFAULT_TAG)}` : theme.command(cmd.name)}`, descCol);
|
|
157
172
|
const desc = cmd.description ?? "";
|
|
158
173
|
if (desc.length === 0) lines.push(padded.trimEnd());
|
|
159
174
|
else lines.push(`${padded}${wrapText(desc, width, descCol)}`);
|
|
@@ -170,38 +185,46 @@ function formatRootCommandsSection(visibleCommands, defaultName, width) {
|
|
|
170
185
|
*
|
|
171
186
|
* @param schema - The CLI schema (read for `version` and `configSettings`).
|
|
172
187
|
* @param width - Terminal width for description wrapping.
|
|
188
|
+
* @param theme - Theme applied to the title and flag forms.
|
|
173
189
|
* @returns Formatted `Global options:` block (always non-empty).
|
|
174
190
|
* @internal
|
|
175
191
|
*/
|
|
176
|
-
function formatGlobalOptionsSection(schema, width) {
|
|
192
|
+
function formatGlobalOptionsSection(schema, width, theme) {
|
|
177
193
|
const entries = [{
|
|
178
|
-
left: "-h, --help",
|
|
194
|
+
left: theme.flag("-h, --help"),
|
|
179
195
|
description: "Show this help message and exit"
|
|
180
196
|
}];
|
|
181
197
|
if (schema.version !== void 0) entries.push({
|
|
182
|
-
left: "-V, --version",
|
|
198
|
+
left: theme.flag("-V, --version"),
|
|
183
199
|
description: "Print the version number and exit"
|
|
184
200
|
});
|
|
185
201
|
entries.push({
|
|
186
|
-
left: "--json",
|
|
202
|
+
left: theme.flag("--json"),
|
|
187
203
|
description: "Emit machine-readable JSON output"
|
|
188
204
|
});
|
|
205
|
+
entries.push({
|
|
206
|
+
left: theme.flag("-q, --quiet"),
|
|
207
|
+
description: "Suppress informational output"
|
|
208
|
+
});
|
|
189
209
|
if (schema.configSettings !== void 0) entries.push({
|
|
190
|
-
left: "--config <path>"
|
|
210
|
+
left: `${theme.flag("--config")} ${theme.placeholder("<path>")}`,
|
|
191
211
|
description: "Load configuration from the given file"
|
|
192
212
|
});
|
|
193
|
-
return formatFlagEntriesBlock("Global options:", entries, width);
|
|
213
|
+
return formatFlagEntriesBlock(theme.sectionTitle("Global options:"), entries, width);
|
|
194
214
|
}
|
|
195
215
|
/**
|
|
196
216
|
* Merge root and default-command usage lines into a single block.
|
|
197
217
|
*
|
|
198
218
|
* @param rootUsage - The root usage line (e.g. `Usage: mycli [command] [options]`).
|
|
199
219
|
* @param commandUsage - The default command's usage line.
|
|
220
|
+
* @param usageTitle - The themed `Usage:` title — byte-identical in both lines
|
|
221
|
+
* within one render, so the styled prefix strips cleanly.
|
|
200
222
|
* @returns Combined usage block with aligned continuation.
|
|
201
223
|
* @internal
|
|
202
224
|
*/
|
|
203
|
-
function mergeUsageSections(rootUsage, commandUsage) {
|
|
204
|
-
const
|
|
225
|
+
function mergeUsageSections(rootUsage, commandUsage, usageTitle) {
|
|
226
|
+
const usagePrefix = `${usageTitle} `;
|
|
227
|
+
const commandSuffix = commandUsage.startsWith(usagePrefix) ? commandUsage.slice(usagePrefix.length) : commandUsage;
|
|
205
228
|
return `${rootUsage}\n${" ".repeat(7)}${commandSuffix}`;
|
|
206
229
|
}
|
|
207
230
|
//#endregion
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import { CommandSchema } from "../schema/command.mjs";
|
|
2
|
-
|
|
3
2
|
//#region src/core/cli/root-surface.d.ts
|
|
4
3
|
/**
|
|
5
4
|
* Structural CLI shape needed for root-surface analysis.
|
|
@@ -16,6 +15,12 @@ interface RootSurfaceSchemaLike {
|
|
|
16
15
|
readonly defaultCommand: {
|
|
17
16
|
readonly schema: CommandSchema;
|
|
18
17
|
} | undefined;
|
|
18
|
+
/**
|
|
19
|
+
* Whether the default command is also exposed as a named route
|
|
20
|
+
* (`.default(cmd, { route: true })`). Optional so hand-built schema-like
|
|
21
|
+
* objects default to the surface-only behavior.
|
|
22
|
+
*/
|
|
23
|
+
readonly defaultCommandRouted?: boolean | undefined;
|
|
19
24
|
}
|
|
20
25
|
/**
|
|
21
26
|
* Normalized root shape shared by help and completion logic.
|
|
@@ -40,6 +45,12 @@ interface RootSurface {
|
|
|
40
45
|
readonly hasVisibleDefault: boolean;
|
|
41
46
|
/** Whether any visible real subcommands exist (the default does not count). */
|
|
42
47
|
readonly hasVisibleSubcommands: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* Whether the visible default is also a named route (`.default(cmd, { route:
|
|
50
|
+
* true })`), meaning it should be listed in `Commands:` beside its siblings
|
|
51
|
+
* in addition to being rendered as the root surface.
|
|
52
|
+
*/
|
|
53
|
+
readonly defaultRouted: boolean;
|
|
43
54
|
}
|
|
44
55
|
/**
|
|
45
56
|
* Resolve the visible shape of the CLI root.
|
|
@@ -20,7 +20,8 @@ function resolveRootSurface(schema) {
|
|
|
20
20
|
visibleSubcommands,
|
|
21
21
|
visibleDefaultCommand,
|
|
22
22
|
hasVisibleDefault: visibleDefaultCommand !== void 0,
|
|
23
|
-
hasVisibleSubcommands: visibleSubcommands.length > 0
|
|
23
|
+
hasVisibleSubcommands: visibleSubcommands.length > 0,
|
|
24
|
+
defaultRouted: visibleDefaultCommand !== void 0 && schema.defaultCommandRouted === true
|
|
24
25
|
};
|
|
25
26
|
}
|
|
26
27
|
//#endregion
|
|
@@ -1,15 +1,18 @@
|
|
|
1
1
|
import { Verbosity } from "../output/contracts.mjs";
|
|
2
|
+
import "../output/index.mjs";
|
|
2
3
|
import { PromptEngine } from "../prompt/index.mjs";
|
|
3
4
|
import { CLIPlugin } from "./plugin.mjs";
|
|
4
5
|
import { CLIError } from "../errors/index.mjs";
|
|
6
|
+
import { HelpThemeFactory } from "../help/theme.mjs";
|
|
7
|
+
import "../help/index.mjs";
|
|
5
8
|
import { CommandSchema, ErasedCommand } from "../schema/command.mjs";
|
|
9
|
+
import { ParseOptions } from "../parse/index.mjs";
|
|
6
10
|
import { RuntimeAdapter } from "../../runtime/adapter.mjs";
|
|
7
11
|
import { PackageJsonData } from "../config/package-json.mjs";
|
|
8
12
|
import { HelpLinks } from "./help-links.mjs";
|
|
9
13
|
import { CompletionOptions } from "../completion/shells/shared.mjs";
|
|
10
14
|
import { Shell } from "../completion/index.mjs";
|
|
11
15
|
import { FormatLoader } from "../config/index.mjs";
|
|
12
|
-
|
|
13
16
|
//#region src/core/cli/runtime-preflight.d.ts
|
|
14
17
|
/** Config discovery settings extracted from CLISchema for preflight use. @internal */
|
|
15
18
|
interface RuntimeConfigSettings {
|
|
@@ -58,6 +61,8 @@ interface RuntimePreflightSchemaLike {
|
|
|
58
61
|
readonly commands: readonly ErasedCommand[];
|
|
59
62
|
/** Fallback command when no subcommand token matches. */
|
|
60
63
|
readonly defaultCommand: ErasedCommand | undefined;
|
|
64
|
+
/** Whether the default command is also exposed as a named top-level route. */
|
|
65
|
+
readonly defaultCommandRouted: boolean;
|
|
61
66
|
/** Config file discovery settings; `undefined` disables config loading. */
|
|
62
67
|
readonly configSettings: RuntimeConfigSettings | undefined;
|
|
63
68
|
/** Package.json discovery settings; `undefined` disables package.json inference. */
|
|
@@ -78,7 +83,10 @@ interface RuntimePreflightSchemaLike {
|
|
|
78
83
|
readonly footer?: boolean;
|
|
79
84
|
readonly width?: number;
|
|
80
85
|
readonly hyperlinks?: boolean;
|
|
86
|
+
readonly theme?: HelpThemeFactory;
|
|
81
87
|
} | undefined;
|
|
88
|
+
/** Flag-parsing behavior settings (e.g. case parity). */
|
|
89
|
+
readonly flagSettings: ParseOptions | undefined;
|
|
82
90
|
/** Plugins forwarded into the execution pipeline. */
|
|
83
91
|
readonly plugins: readonly CLIPlugin[];
|
|
84
92
|
}
|
|
@@ -104,6 +112,10 @@ interface RuntimePreflightOptions {
|
|
|
104
112
|
readonly jsonMode?: boolean;
|
|
105
113
|
/** TTY detection override; bypasses adapter TTY check. */
|
|
106
114
|
readonly isTTY?: boolean;
|
|
115
|
+
/** Filesystem probe override for `flag.path()` checks; bypasses the adapter probe. */
|
|
116
|
+
readonly stat?: (path: string) => Promise<'file' | 'directory' | null>;
|
|
117
|
+
/** Directory creation override for `flag.path()` `create` checks; bypasses the adapter. */
|
|
118
|
+
readonly mkdir?: (path: string) => Promise<void>;
|
|
107
119
|
}
|
|
108
120
|
/**
|
|
109
121
|
* Fully resolved runtime inputs ready for the execution pipeline.
|
|
@@ -127,6 +139,10 @@ interface RuntimeExecutionInputs {
|
|
|
127
139
|
readonly prompter?: PromptEngine;
|
|
128
140
|
/** Loaded config data for the config resolution step. */
|
|
129
141
|
readonly config?: Readonly<Record<string, unknown>>;
|
|
142
|
+
/** Filesystem probe (from the adapter) for `flag.path()` checks. */
|
|
143
|
+
readonly stat?: (path: string) => Promise<'file' | 'directory' | null>;
|
|
144
|
+
/** Directory creation (from the adapter) for `flag.path()` `create` checks. */
|
|
145
|
+
readonly mkdir?: (path: string) => Promise<void>;
|
|
130
146
|
}
|
|
131
147
|
/** Preflight succeeded — all runtime inputs are resolved and ready for execution. @internal */
|
|
132
148
|
interface ReadyRuntimePreflight {
|
|
@@ -167,7 +183,7 @@ declare function extractConfigFlag(argv: readonly string[]): {
|
|
|
167
183
|
readonly filteredArgv: readonly string[];
|
|
168
184
|
};
|
|
169
185
|
/** Check whether a single command's args declare stdin-mode and argv leaves them unresolved. @internal */
|
|
170
|
-
declare function commandInvocationNeedsStdin(schema: CommandSchema, argv: readonly string[]): boolean;
|
|
186
|
+
declare function commandInvocationNeedsStdin(schema: CommandSchema, argv: readonly string[], flagSettings?: ParseOptions): boolean;
|
|
171
187
|
/** Plan the invocation and check whether the matched command needs stdin data. @internal */
|
|
172
188
|
declare function invocationNeedsStdin(schema: RuntimePreflightSchemaLike, argv: readonly string[]): boolean;
|
|
173
189
|
/**
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { CLIError, ParseError } from "../errors/index.mjs";
|
|
2
|
-
import { parse } from "../parse/index.mjs";
|
|
2
|
+
import { includesBeforeSeparator, parse } from "../parse/index.mjs";
|
|
3
3
|
import { createTerminalPrompter } from "../prompt/index.mjs";
|
|
4
4
|
import { discoverManifest, inferCliName } from "../config/package-json.mjs";
|
|
5
5
|
import { deriveHelpLinks } from "./help-links.mjs";
|
|
@@ -49,10 +49,10 @@ function extractConfigFlag(argv) {
|
|
|
49
49
|
};
|
|
50
50
|
}
|
|
51
51
|
/** Check whether a single command's args declare stdin-mode and argv leaves them unresolved. @internal */
|
|
52
|
-
function commandInvocationNeedsStdin(schema, argv) {
|
|
52
|
+
function commandInvocationNeedsStdin(schema, argv, flagSettings) {
|
|
53
53
|
if (argv.includes("--help") || argv.includes("-h")) return false;
|
|
54
54
|
try {
|
|
55
|
-
const parsed = parse(schema, argv);
|
|
55
|
+
const parsed = parse(schema, argv, flagSettings);
|
|
56
56
|
return schema.args.some(({ name, schema: argSchema }) => {
|
|
57
57
|
const parsedValue = parsed.args[name];
|
|
58
58
|
return argSchema.stdinMode && (parsedValue === void 0 || parsedValue === "-");
|
|
@@ -71,7 +71,7 @@ function invocationNeedsStdin(schema, argv) {
|
|
|
71
71
|
output: PRECHECK_OUTPUT
|
|
72
72
|
});
|
|
73
73
|
switch (plan.kind) {
|
|
74
|
-
case "match": return commandInvocationNeedsStdin(plan.plan.mergedSchema, plan.plan.argv);
|
|
74
|
+
case "match": return commandInvocationNeedsStdin(plan.plan.mergedSchema, plan.plan.argv, schema.flagSettings);
|
|
75
75
|
case "dispatch-error":
|
|
76
76
|
case "needs-subcommand":
|
|
77
77
|
case "root-help":
|
|
@@ -138,7 +138,8 @@ async function prepareRuntimePreflight(options) {
|
|
|
138
138
|
configPath: void 0,
|
|
139
139
|
filteredArgv: rawArgv
|
|
140
140
|
};
|
|
141
|
-
const jsonMode = filteredArgv
|
|
141
|
+
const jsonMode = includesBeforeSeparator(filteredArgv, "--json") || options.options?.jsonMode === true;
|
|
142
|
+
const hasQuietFlag = includesBeforeSeparator(filteredArgv, "--quiet") || includesBeforeSeparator(filteredArgv, "-q");
|
|
142
143
|
const isCompletions = isCompletionsInvocation(options.schema, filteredArgv);
|
|
143
144
|
const schema = await applyPackageJsonDiscovery(options.schema, options.adapter, options.inheritedName, isCompletions);
|
|
144
145
|
const loadedConfig = await loadRuntimeConfig(schema, options.adapter, configPath, isCompletions, options.options?.config);
|
|
@@ -157,7 +158,9 @@ async function prepareRuntimePreflight(options) {
|
|
|
157
158
|
env: options.options?.env ?? options.adapter.env,
|
|
158
159
|
isTTY: options.options?.isTTY ?? options.adapter.isTTY,
|
|
159
160
|
jsonMode,
|
|
160
|
-
verbosity: options.options?.verbosity ?? "normal",
|
|
161
|
+
verbosity: hasQuietFlag ? "quiet" : options.options?.verbosity ?? "normal",
|
|
162
|
+
stat: options.options?.stat ?? options.adapter.stat,
|
|
163
|
+
mkdir: options.options?.mkdir ?? options.adapter.mkdir,
|
|
161
164
|
...stdinData !== void 0 ? { stdinData } : {},
|
|
162
165
|
...options.options?.prompter !== void 0 ? { prompter: options.options.prompter } : autoPrompter !== void 0 ? { prompter: autoPrompter } : {},
|
|
163
166
|
...loadedConfig !== void 0 ? { config: loadedConfig } : {}
|
|
@@ -165,4 +168,4 @@ async function prepareRuntimePreflight(options) {
|
|
|
165
168
|
};
|
|
166
169
|
}
|
|
167
170
|
//#endregion
|
|
168
|
-
export { prepareRuntimePreflight };
|
|
171
|
+
export { commandInvocationNeedsStdin, extractConfigFlag, invocationNeedsStdin, prepareRuntimePreflight };
|
|
@@ -4,7 +4,6 @@ import { generateFishCompletion } from "./shells/fish.mjs";
|
|
|
4
4
|
import { generatePowerShellCompletion } from "./shells/powershell.mjs";
|
|
5
5
|
import { generateZshCompletion } from "./shells/zsh.mjs";
|
|
6
6
|
import { CLISchema } from "../cli/index.mjs";
|
|
7
|
-
|
|
8
7
|
//#region src/core/completion/index.d.ts
|
|
9
8
|
/**
|
|
10
9
|
* Supported shell targets for completion script generation.
|
|
@@ -87,4 +87,4 @@ function generateCompletion(schema, shell, options) {
|
|
|
87
87
|
}
|
|
88
88
|
}
|
|
89
89
|
//#endregion
|
|
90
|
-
export { SHELLS, detectShell, generateCompletion, normalizeShell };
|
|
90
|
+
export { SHELLS, detectShell, generateBashCompletion, generateCompletion, generateFishCompletion, generatePowerShellCompletion, generateZshCompletion, normalizeShell };
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { getFlagAliasNames } from "../../schema/flag.mjs";
|
|
2
|
-
import {
|
|
2
|
+
import { flagExpectsValue } from "../../parse/index.mjs";
|
|
3
|
+
import { getVisibleNegatedName, quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree } from "./shared.mjs";
|
|
3
4
|
//#region src/core/completion/shells/bash.ts
|
|
4
5
|
/**
|
|
5
6
|
* Generate a bash completion script for the CLI.
|
|
@@ -241,7 +242,8 @@ function escapeBashDollarQuote(value) {
|
|
|
241
242
|
return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\n/g, "\\n");
|
|
242
243
|
}
|
|
243
244
|
/**
|
|
244
|
-
* Collect all `--flag` words (long + short aliases
|
|
245
|
+
* Collect all `--flag` words (long + short aliases + visible negated
|
|
246
|
+
* spellings) for a flag record.
|
|
245
247
|
*
|
|
246
248
|
* @internal
|
|
247
249
|
*/
|
|
@@ -250,11 +252,13 @@ function collectFlagWords(flags) {
|
|
|
250
252
|
for (const [name, schema] of Object.entries(flags)) {
|
|
251
253
|
words.push(`--${name}`);
|
|
252
254
|
for (const alias of getFlagAliasNames(schema)) words.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
|
|
255
|
+
const negated = getVisibleNegatedName(name, schema);
|
|
256
|
+
if (negated !== void 0) words.push(`--${negated}`);
|
|
253
257
|
}
|
|
254
258
|
return words.join(" ");
|
|
255
259
|
}
|
|
256
260
|
/**
|
|
257
|
-
* Collect all
|
|
261
|
+
* Collect all value-taking flag forms across every node and root surface,
|
|
258
262
|
* deduplicated and escaped for use in a bash `case` pattern.
|
|
259
263
|
*
|
|
260
264
|
* Returns a `|`-joined pattern like `--schema|-s|--output|-o` that the
|
|
@@ -267,7 +271,7 @@ function collectValueFlagPattern(nodes, rootSurface) {
|
|
|
267
271
|
const forms = /* @__PURE__ */ new Set();
|
|
268
272
|
const addFlags = (flags) => {
|
|
269
273
|
for (const [name, schema] of Object.entries(flags)) {
|
|
270
|
-
if (schema
|
|
274
|
+
if (!flagExpectsValue(schema)) continue;
|
|
271
275
|
forms.add(`--${name}`);
|
|
272
276
|
for (const alias of getFlagAliasNames(schema, { includeHidden: true })) forms.add(alias.length === 1 ? `-${alias}` : `--${alias}`);
|
|
273
277
|
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { getFlagAliasNames } from "../../schema/flag.mjs";
|
|
2
|
-
import {
|
|
2
|
+
import { flagExpectsValue } from "../../parse/index.mjs";
|
|
3
|
+
import { getVisibleNegatedName, quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree } from "./shared.mjs";
|
|
3
4
|
//#region src/core/completion/shells/fish.ts
|
|
4
5
|
/**
|
|
5
6
|
* Generate a fish completion script for the CLI.
|
|
@@ -110,8 +111,10 @@ function appendFishFlagCompletions(lines, commandName, pathIsFuncName, path, fla
|
|
|
110
111
|
for (const alias of getFlagAliasNames(schema, { kind: "short" })) parts.push(`-s ${quoteShellArg(alias)}`);
|
|
111
112
|
parts.push(`-l ${quoteShellArg(name)}`);
|
|
112
113
|
for (const alias of getFlagAliasNames(schema, { kind: "long" })) parts.push(`-l ${quoteShellArg(alias)}`);
|
|
114
|
+
const negated = getVisibleNegatedName(name, schema);
|
|
115
|
+
if (negated !== void 0) parts.push(`-l ${quoteShellArg(negated)}`);
|
|
113
116
|
parts.push(`-d ${quoteShellArg(schema.description ?? name)}`);
|
|
114
|
-
if (schema
|
|
117
|
+
if (flagExpectsValue(schema)) parts.push("-r", "-f");
|
|
115
118
|
if (schema.kind === "enum" && schema.enumValues !== void 0) {
|
|
116
119
|
for (const enumValue of schema.enumValues) lines.push([...parts, `-a ${quoteShellArg(enumValue)}`].join(" "));
|
|
117
120
|
continue;
|
|
@@ -129,7 +132,7 @@ function collectFishValueFlagPatterns(nodes, rootSurface) {
|
|
|
129
132
|
...nodes.map((node) => node.mergedFlags)
|
|
130
133
|
];
|
|
131
134
|
for (const flags of flagSets) for (const [name, schema] of Object.entries(flags)) {
|
|
132
|
-
if (schema
|
|
135
|
+
if (!flagExpectsValue(schema)) continue;
|
|
133
136
|
exact.add(`--${name}`);
|
|
134
137
|
prefix.add(`--${name}=*`);
|
|
135
138
|
for (const alias of getFlagAliasNames(schema, {
|
|
@@ -1,5 +1,6 @@
|
|
|
1
|
-
import { getFlagAliasNames } from "../../schema/flag.mjs";
|
|
2
|
-
import {
|
|
1
|
+
import { getFlagAliasNames, getFlagNegatedName } from "../../schema/flag.mjs";
|
|
2
|
+
import { flagExpectsValue } from "../../parse/index.mjs";
|
|
3
|
+
import { getVisibleNegatedName, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree } from "./shared.mjs";
|
|
3
4
|
//#region src/core/completion/shells/powershell.ts
|
|
4
5
|
/**
|
|
5
6
|
* Generate a PowerShell completion script for the CLI.
|
|
@@ -89,10 +90,13 @@ function appendPowerShellPathEntry(lines, path, commands, flags) {
|
|
|
89
90
|
lines.push(" )");
|
|
90
91
|
lines.push(" Flags = @(");
|
|
91
92
|
for (const [name, schema] of Object.entries(flags)) {
|
|
93
|
+
const visibleNegated = getVisibleNegatedName(name, schema);
|
|
94
|
+
const parseNegated = getFlagNegatedName(name, schema);
|
|
92
95
|
const forms = dedupeValues([
|
|
93
96
|
`--${name}`,
|
|
94
97
|
...getFlagAliasNames(schema, { kind: "short" }).map((alias) => `-${alias}`),
|
|
95
|
-
...getFlagAliasNames(schema, { kind: "long" }).map((alias) => `--${alias}`)
|
|
98
|
+
...getFlagAliasNames(schema, { kind: "long" }).map((alias) => `--${alias}`),
|
|
99
|
+
...visibleNegated !== void 0 ? [`--${visibleNegated}`] : []
|
|
96
100
|
]);
|
|
97
101
|
const parseForms = dedupeValues([
|
|
98
102
|
`--${name}`,
|
|
@@ -103,13 +107,14 @@ function appendPowerShellPathEntry(lines, path, commands, flags) {
|
|
|
103
107
|
...getFlagAliasNames(schema, {
|
|
104
108
|
kind: "long",
|
|
105
109
|
includeHidden: true
|
|
106
|
-
}).map((alias) => `--${alias}`)
|
|
110
|
+
}).map((alias) => `--${alias}`),
|
|
111
|
+
...parseNegated !== void 0 ? [`--${parseNegated}`] : []
|
|
107
112
|
]);
|
|
108
113
|
lines.push(" @{");
|
|
109
114
|
lines.push(`\t\t\t\tCanonicalName = ${quotePowerShellString(name)}`);
|
|
110
115
|
lines.push(`\t\t\t\tForms = ${formatPowerShellArray(forms)}`);
|
|
111
116
|
lines.push(`\t\t\t\tParseForms = ${formatPowerShellArray(parseForms)}`);
|
|
112
|
-
lines.push(`\t\t\t\tRequiresValue = ${schema
|
|
117
|
+
lines.push(`\t\t\t\tRequiresValue = ${flagExpectsValue(schema) ? "$true" : "$false"}`);
|
|
113
118
|
lines.push(`\t\t\t\tDescription = ${quotePowerShellString(schema.description ?? name)}`);
|
|
114
119
|
lines.push(`\t\t\t\tEnumValues = ${formatPowerShellArray(schema.enumValues ?? [])}`);
|
|
115
120
|
lines.push(" }");
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { FlagSchema } from "../../schema/flag.mjs";
|
|
2
2
|
import { CommandSchema } from "../../schema/command.mjs";
|
|
3
|
-
|
|
3
|
+
import "../../schema/index.mjs";
|
|
4
4
|
//#region src/core/completion/shells/shared.d.ts
|
|
5
5
|
/**
|
|
6
6
|
* Format a version tag for generated completion script headers.
|
|
@@ -120,6 +120,17 @@ interface CommandNode {
|
|
|
120
120
|
* @internal
|
|
121
121
|
*/
|
|
122
122
|
declare function walkCommandTree(topLevel: readonly CommandSchema[], ancestorSchemas?: readonly CommandSchema[]): readonly CommandNode[];
|
|
123
|
+
/**
|
|
124
|
+
* Effective negated long-form spelling for user-facing suggestion lists.
|
|
125
|
+
*
|
|
126
|
+
* Returns the negated spelling without the `--` prefix (e.g. `no-verbose`)
|
|
127
|
+
* when the flag is negatable and the negation is not hidden; `undefined`
|
|
128
|
+
* otherwise. Negated spellings are long-only and take no value, so they only
|
|
129
|
+
* belong in suggestion lists — never in value-flag (operand-skip) patterns.
|
|
130
|
+
*
|
|
131
|
+
* @internal
|
|
132
|
+
*/
|
|
133
|
+
declare function getVisibleNegatedName(name: string, schema: FlagSchema): string | undefined;
|
|
123
134
|
/**
|
|
124
135
|
* Sanitize a string for use as a shell function identifier.
|
|
125
136
|
* Replaces non-alphanumeric/underscore characters with underscores.
|
|
@@ -146,4 +157,4 @@ declare function sanitizeShellIdentifier(name: string): string;
|
|
|
146
157
|
*/
|
|
147
158
|
declare function quoteShellArg(value: string): string;
|
|
148
159
|
//#endregion
|
|
149
|
-
export { type CommandNode, type CompletionOptions, type RootCompletionSurface, quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree };
|
|
160
|
+
export { type CommandNode, type CompletionOptions, type RootCompletionSurface, getVisibleNegatedName, quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree };
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { getFlagNegatedName } from "../../schema/flag.mjs";
|
|
1
2
|
import { collectPropagatedFlags } from "../../cli/propagate.mjs";
|
|
2
3
|
import { resolveRootSurface } from "../../cli/root-surface.mjs";
|
|
3
4
|
import { DREAMCLI_REVISION, DREAMCLI_VERSION } from "../../../version.mjs";
|
|
@@ -74,11 +75,19 @@ function createSyntheticRootFlag(description) {
|
|
|
74
75
|
description,
|
|
75
76
|
enumValues: void 0,
|
|
76
77
|
numberConstraints: void 0,
|
|
78
|
+
stringConstraints: void 0,
|
|
77
79
|
elementSchema: void 0,
|
|
80
|
+
separator: void 0,
|
|
81
|
+
unique: false,
|
|
82
|
+
pathChecks: void 0,
|
|
83
|
+
valueHint: void 0,
|
|
78
84
|
prompt: void 0,
|
|
79
85
|
parseFn: void 0,
|
|
86
|
+
standard: void 0,
|
|
80
87
|
deprecated: void 0,
|
|
81
|
-
propagate: false
|
|
88
|
+
propagate: false,
|
|
89
|
+
negation: void 0,
|
|
90
|
+
duplicates: "last"
|
|
82
91
|
};
|
|
83
92
|
}
|
|
84
93
|
/**
|
|
@@ -114,6 +123,20 @@ function walkCommandTree(topLevel, ancestorSchemas = []) {
|
|
|
114
123
|
return nodes;
|
|
115
124
|
}
|
|
116
125
|
/**
|
|
126
|
+
* Effective negated long-form spelling for user-facing suggestion lists.
|
|
127
|
+
*
|
|
128
|
+
* Returns the negated spelling without the `--` prefix (e.g. `no-verbose`)
|
|
129
|
+
* when the flag is negatable and the negation is not hidden; `undefined`
|
|
130
|
+
* otherwise. Negated spellings are long-only and take no value, so they only
|
|
131
|
+
* belong in suggestion lists — never in value-flag (operand-skip) patterns.
|
|
132
|
+
*
|
|
133
|
+
* @internal
|
|
134
|
+
*/
|
|
135
|
+
function getVisibleNegatedName(name, schema) {
|
|
136
|
+
if (schema.negation === void 0 || schema.negation.hidden) return void 0;
|
|
137
|
+
return getFlagNegatedName(name, schema);
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
117
140
|
* Sanitize a string for use as a shell function identifier.
|
|
118
141
|
* Replaces non-alphanumeric/underscore characters with underscores.
|
|
119
142
|
* When sanitization changes the name, appends a short stable hash suffix so
|
|
@@ -151,4 +174,4 @@ function quoteShellArg(value) {
|
|
|
151
174
|
return `'${value.replace(/'/g, "'\\''")}'`;
|
|
152
175
|
}
|
|
153
176
|
//#endregion
|
|
154
|
-
export { quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree };
|
|
177
|
+
export { getVisibleNegatedName, quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree };
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
import { getFlagAliasNames } from "../../schema/flag.mjs";
|
|
2
|
-
import { quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree } from "./shared.mjs";
|
|
3
1
|
import { CLIError } from "../../errors/index.mjs";
|
|
2
|
+
import { getFlagAliasNames } from "../../schema/flag.mjs";
|
|
3
|
+
import { flagExpectsValue } from "../../parse/index.mjs";
|
|
4
|
+
import { getVisibleNegatedName, quoteShellArg, resolveRootCompletionSurface, sanitizeShellIdentifier, versionTag, walkCommandTree } from "./shared.mjs";
|
|
4
5
|
//#region src/core/completion/shells/zsh.ts
|
|
5
6
|
/**
|
|
6
7
|
* Generate a zsh completion script for the CLI.
|
|
@@ -202,6 +203,9 @@ function escapeZshDescription(value) {
|
|
|
202
203
|
* - `'(-s --name --alias)'{-s,--name,--alias}'[description]'` for flags with
|
|
203
204
|
* visible aliases
|
|
204
205
|
*
|
|
206
|
+
* A visible negated spelling (`--no-name`) joins the flag's form group — the
|
|
207
|
+
* two spellings are one logical flag, so completing one excludes the other.
|
|
208
|
+
*
|
|
205
209
|
* @internal
|
|
206
210
|
*/
|
|
207
211
|
function buildZshFlagSpecsFromFlags(flags) {
|
|
@@ -211,13 +215,16 @@ function buildZshFlagSpecsFromFlags(flags) {
|
|
|
211
215
|
const longFlag = `--${name}`;
|
|
212
216
|
const shortFlags = getFlagAliasNames(schema, { kind: "short" }).map((alias) => `-${alias}`);
|
|
213
217
|
const longAliases = getFlagAliasNames(schema, { kind: "long" }).map((alias) => `--${alias}`);
|
|
218
|
+
const negated = getVisibleNegatedName(name, schema);
|
|
219
|
+
const negatedForms = negated !== void 0 ? [`--${negated}`] : [];
|
|
214
220
|
const allForms = [
|
|
215
221
|
...shortFlags,
|
|
216
222
|
longFlag,
|
|
217
|
-
...longAliases
|
|
223
|
+
...longAliases,
|
|
224
|
+
...negatedForms
|
|
218
225
|
];
|
|
219
226
|
let valuePart = "";
|
|
220
|
-
if (schema
|
|
227
|
+
if (!flagExpectsValue(schema)) {} else if (schema.kind === "enum" && schema.enumValues !== void 0) valuePart = `:value:(${schema.enumValues.map(escapeZshEnumValue).join(" ")})`;
|
|
221
228
|
else valuePart = ":value:";
|
|
222
229
|
if (allForms.length > 1) {
|
|
223
230
|
const escapedForms = allForms.map(escapeZshCasePatternValue).join(",");
|