@kjanat/dreamcli 3.0.0-rc.8 → 3.0.0
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 +271 -1
- package/README.md +30 -13
- package/dist/core/cli/dispatch.mjs +0 -11
- package/dist/core/cli/index.d.mts +133 -9
- package/dist/core/cli/index.mjs +119 -27
- package/dist/core/cli/planner.mjs +7 -1
- package/dist/core/cli/root-help.mjs +5 -0
- package/dist/core/cli/runtime-preflight.d.mts +4 -0
- package/dist/core/cli/runtime-preflight.mjs +5 -3
- package/dist/core/completion/shells/shared.mjs +1 -0
- package/dist/core/config/index.d.mts +43 -12
- package/dist/core/config/index.mjs +55 -16
- package/dist/core/config/package-json.d.mts +1 -0
- package/dist/core/errors/index.d.mts +2 -2
- package/dist/core/execution/index.mjs +13 -1
- package/dist/core/help/ansi.d.mts +11 -5
- package/dist/core/help/ansi.mjs +14 -16
- package/dist/core/help/index.d.mts +22 -0
- package/dist/core/help/index.mjs +75 -25
- package/dist/core/json-schema/index.d.mts +20 -8
- package/dist/core/json-schema/index.mjs +285 -87
- package/dist/core/json-schema/meta-descriptions.generated.d.mts +40 -40
- package/dist/core/output/contracts.d.mts +5 -5
- package/dist/core/output/contracts.mjs +1 -1
- package/dist/core/output/index.d.mts +38 -1
- package/dist/core/output/index.mjs +37 -2
- package/dist/core/parse/index.mjs +9 -6
- package/dist/core/resolve/contracts.d.mts +7 -2
- package/dist/core/resolve/flags.d.mts +3 -1
- package/dist/core/resolve/flags.mjs +29 -12
- package/dist/core/resolve/index.mjs +6 -1
- package/dist/core/resolve/property.d.mts +1 -1
- package/dist/core/resolve/standard.d.mts +24 -0
- package/dist/core/resolve/standard.mjs +114 -0
- package/dist/core/schema/arg.d.mts +37 -2
- package/dist/core/schema/arg.mjs +5 -2
- package/dist/core/schema/command.d.mts +49 -7
- package/dist/core/schema/command.mjs +15 -5
- package/dist/core/schema/flag.d.mts +124 -19
- package/dist/core/schema/flag.mjs +7 -3
- package/dist/core/schema/index.d.mts +3 -2
- package/dist/core/schema/prompt.d.mts +1 -1
- package/dist/core/schema/run.d.mts +7 -0
- package/dist/core/schema/standard.d.mts +100 -0
- package/dist/core/schema/standard.mjs +15 -0
- package/dist/core/testkit/index.d.mts +7 -5
- package/dist/core/testkit/index.mjs +12 -7
- package/dist/index.d.mts +6 -5
- package/dist/index.mjs +5 -5
- package/dist/runtime/adapter.d.mts +33 -0
- package/dist/runtime/adapter.mjs +6 -1
- package/dist/runtime/deno.d.mts +4 -0
- package/dist/runtime/deno.mjs +4 -1
- package/dist/runtime/node.mjs +9 -1
- package/dist/version.mjs +2 -2
- package/dreamcli.schema.json +83 -1
- package/examples/basic.ts +2 -2
- package/examples/flag-types.ts +79 -0
- 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/help-config.ts +43 -0
- package/examples/json-mode.ts +8 -4
- package/examples/middleware.ts +1 -1
- package/examples/output-extras.ts +46 -0
- package/examples/parser-control.ts +40 -0
- package/examples/pwsh-demo/package.json +1 -1
- package/examples/pwsh-demo/src/main.ts +1 -1
- package/examples/standard-schema.ts +45 -0
- package/examples/transport-launcher.ts +10 -10
- package/package.json +25 -31
- 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 -29
- package/dist/core/schema-dsl/to-json-schema.mjs +0 -74
package/dist/core/cli/index.mjs
CHANGED
|
@@ -5,7 +5,8 @@ import { command } from "../schema/command.mjs";
|
|
|
5
5
|
import { includesBeforeSeparator } from "../parse/index.mjs";
|
|
6
6
|
import { SHELLS, detectShell, generateCompletion, normalizeShell } from "../completion/index.mjs";
|
|
7
7
|
import { formatHelp } from "../help/index.mjs";
|
|
8
|
-
import {
|
|
8
|
+
import { generateCommandSchema, generateSchema } from "../json-schema/index.mjs";
|
|
9
|
+
import { clearRequestedExitCode, createCaptureOutput, createOutput, resolveHyperlinkOverride } from "../output/index.mjs";
|
|
9
10
|
import { buildRunResult, executeCommand } from "../execution/index.mjs";
|
|
10
11
|
import { runCommand } from "../testkit/index.mjs";
|
|
11
12
|
import { stripTrailing } from "../../strings.mjs";
|
|
@@ -99,6 +100,55 @@ function eraseCommand(cmd) {
|
|
|
99
100
|
};
|
|
100
101
|
}
|
|
101
102
|
/**
|
|
103
|
+
* Resolve the render context for content built before `.run()`.
|
|
104
|
+
*
|
|
105
|
+
* Content styled ahead of execution — hand-rendered banners, custom help, or
|
|
106
|
+
* anything else emitted outside an action handler — has no `out` to consult,
|
|
107
|
+
* which pushes consumers into re-deriving the framework's decisions from raw
|
|
108
|
+
* argv (`argv.includes('--json')` misreads a post-`--` literal). This probe
|
|
109
|
+
* runs the same composition `.execute()`/`.run()` feed into the output
|
|
110
|
+
* channel — `--`-aware `--json` detection, the color gate, and the hyperlink
|
|
111
|
+
* override — so pre-run styling matches the channel that will render.
|
|
112
|
+
*
|
|
113
|
+
* @param argv - Raw argv tokens (NOT including the binary/script path,
|
|
114
|
+
* i.e. equivalent to `process.argv.slice(2)`).
|
|
115
|
+
* @param options - Host facts and overrides.
|
|
116
|
+
* @returns The resolved output decisions.
|
|
117
|
+
*
|
|
118
|
+
* @example
|
|
119
|
+
* ```ts
|
|
120
|
+
* const ctx = resolveRenderContext(process.argv.slice(2), {
|
|
121
|
+
* isTTY: process.stdout.isTTY === true,
|
|
122
|
+
* env: process.env,
|
|
123
|
+
* });
|
|
124
|
+
* const banner = ctx.color.bold('mycli');
|
|
125
|
+
* ```
|
|
126
|
+
*/
|
|
127
|
+
function resolveRenderContext(argv, options) {
|
|
128
|
+
const out = createOutput({
|
|
129
|
+
jsonMode: includesBeforeSeparator(argv, "--json") || options?.jsonMode === true,
|
|
130
|
+
isTTY: options?.isTTY ?? false,
|
|
131
|
+
...options?.color !== void 0 ? { color: options.color } : {},
|
|
132
|
+
...hyperlinksOption(resolveHyperlinkOverride(options?.env ?? {}, argv))
|
|
133
|
+
});
|
|
134
|
+
return {
|
|
135
|
+
jsonMode: out.jsonMode,
|
|
136
|
+
isTTY: out.isTTY,
|
|
137
|
+
color: out.color,
|
|
138
|
+
isHyperlinkSupported: out.isHyperlinkSupported
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
* Conditional-spread wrapper for the output channel's `hyperlinks` option:
|
|
143
|
+
* omit the key entirely when there is no override so `exactOptionalPropertyTypes`
|
|
144
|
+
* stays happy and the channel falls back to `isTTY`.
|
|
145
|
+
*
|
|
146
|
+
* @internal
|
|
147
|
+
*/
|
|
148
|
+
function hyperlinksOption(override) {
|
|
149
|
+
return override !== void 0 ? { hyperlinks: override } : {};
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
102
152
|
* Build {@linkcode RunOptions} from {@linkcode CLIRunOptions}, conditionally spreading each
|
|
103
153
|
* field to satisfy `exactOptionalPropertyTypes`.
|
|
104
154
|
*
|
|
@@ -120,6 +170,7 @@ function buildCommandRunOptions(options, helpOptions, meta) {
|
|
|
120
170
|
...options?.prompter !== void 0 ? { prompter: options.prompter } : {},
|
|
121
171
|
...options?.answers !== void 0 ? { answers: options.answers } : {},
|
|
122
172
|
...options?.stat !== void 0 ? { stat: options.stat } : {},
|
|
173
|
+
...options?.mkdir !== void 0 ? { mkdir: options.mkdir } : {},
|
|
123
174
|
...options?.verbosity !== void 0 ? { verbosity: options.verbosity } : {},
|
|
124
175
|
...options?.jsonMode !== void 0 ? { jsonMode: options.jsonMode } : {},
|
|
125
176
|
...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {},
|
|
@@ -263,12 +314,16 @@ var CLIBuilder = class CLIBuilder {
|
|
|
263
314
|
/**
|
|
264
315
|
* Enable automatic config file discovery.
|
|
265
316
|
*
|
|
266
|
-
* When enabled, `.run()` probes standard paths before dispatching
|
|
267
|
-
*
|
|
268
|
-
*
|
|
269
|
-
*
|
|
270
|
-
*
|
|
317
|
+
* When enabled, `.run()` probes standard paths before dispatching,
|
|
318
|
+
* first match wins, no merging:
|
|
319
|
+
* 1. Project scope — for `$CWD` and each ancestor directory up to the
|
|
320
|
+
* filesystem root, nearest first:
|
|
321
|
+
* `.{appName}.json`, `{appName}.config.json`, `.config/{appName}.json`
|
|
322
|
+
* 2. User scope — `{dir}/{appName}/config.json` for each user config
|
|
323
|
+
* root (`$XDG_CONFIG_HOME` / `~/.config` on Unix, plus
|
|
324
|
+
* `~/Library/Application Support` on macOS,
|
|
271
325
|
* `%APPDATA%` / `%USERPROFILE%\\AppData\\Roaming` on Windows)
|
|
326
|
+
* 3. System scope — `/etc/{appName}/config.json` on Linux and macOS
|
|
272
327
|
*
|
|
273
328
|
* The user can override the path via `--config <path>` or `--config=<path>`.
|
|
274
329
|
*
|
|
@@ -534,10 +589,12 @@ var CLIBuilder = class CLIBuilder {
|
|
|
534
589
|
*/
|
|
535
590
|
async execute(argv, options) {
|
|
536
591
|
const jsonMode = includesBeforeSeparator(argv, "--json") || options?.jsonMode === true;
|
|
592
|
+
const verbosity = includesBeforeSeparator(argv, "--quiet") || includesBeforeSeparator(argv, "-q") ? "quiet" : options?.verbosity;
|
|
537
593
|
const captureOptions = {
|
|
538
|
-
...
|
|
594
|
+
...verbosity !== void 0 ? { verbosity } : {},
|
|
539
595
|
...jsonMode ? { jsonMode } : {},
|
|
540
|
-
...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {}
|
|
596
|
+
...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {},
|
|
597
|
+
...hyperlinksOption(resolveHyperlinkOverride(options?.env ?? {}, argv))
|
|
541
598
|
};
|
|
542
599
|
let out;
|
|
543
600
|
let captured;
|
|
@@ -550,24 +607,27 @@ var CLIBuilder = class CLIBuilder {
|
|
|
550
607
|
};
|
|
551
608
|
} else [out, captured] = createCaptureOutput(Object.keys(captureOptions).length > 0 ? captureOptions : void 0);
|
|
552
609
|
clearRequestedExitCode(out);
|
|
610
|
+
const resolvedVersion = options?.help?.version ?? this.schema.version;
|
|
553
611
|
const helpOptions = {
|
|
554
612
|
...this.schema.helpConfig,
|
|
555
613
|
...options?.help,
|
|
556
614
|
binName: options?.help?.binName ?? this.schema.name,
|
|
557
|
-
hyperlinks: options?.help?.hyperlinks ?? this.schema.helpConfig?.hyperlinks ?? out.
|
|
558
|
-
colors: options?.help?.colors ?? out.color
|
|
615
|
+
hyperlinks: options?.help?.hyperlinks ?? this.schema.helpConfig?.hyperlinks ?? out.isHyperlinkSupported,
|
|
616
|
+
colors: options?.help?.colors ?? out.color,
|
|
617
|
+
...resolvedVersion !== void 0 ? { version: resolvedVersion } : {}
|
|
559
618
|
};
|
|
560
619
|
const flagSettings = options?.flags ?? this.schema.flagSettings;
|
|
561
620
|
const effectiveOptions = {
|
|
562
621
|
...options,
|
|
563
622
|
plugins: this.schema.plugins,
|
|
564
623
|
...jsonMode ? { jsonMode } : {},
|
|
624
|
+
...verbosity !== void 0 ? { verbosity } : {},
|
|
565
625
|
...flagSettings !== void 0 ? { flags: flagSettings } : {}
|
|
566
626
|
};
|
|
567
627
|
const output = {
|
|
568
628
|
jsonMode,
|
|
569
629
|
isTTY: out.isTTY,
|
|
570
|
-
verbosity:
|
|
630
|
+
verbosity: verbosity ?? "normal"
|
|
571
631
|
};
|
|
572
632
|
const planned = planInvocation({
|
|
573
633
|
schema: options?.flags !== void 0 ? {
|
|
@@ -616,14 +676,19 @@ var CLIBuilder = class CLIBuilder {
|
|
|
616
676
|
error: void 0
|
|
617
677
|
}, captured);
|
|
618
678
|
}
|
|
619
|
-
case "root-help":
|
|
620
|
-
|
|
621
|
-
|
|
679
|
+
case "root-help":
|
|
680
|
+
if (jsonMode) out.json(generateSchema(this.schema, void 0, {
|
|
681
|
+
name: planned.help.binName ?? this.schema.name,
|
|
682
|
+
version: planned.help.version ?? this.schema.version
|
|
683
|
+
}));
|
|
684
|
+
else {
|
|
685
|
+
const helpText = formatRootHelp(resolveHelpLinksSchema(this.schema), planned.help);
|
|
686
|
+
out.log(helpText);
|
|
687
|
+
}
|
|
622
688
|
return buildRunResult({
|
|
623
689
|
exitCode: 0,
|
|
624
690
|
error: void 0
|
|
625
691
|
}, captured);
|
|
626
|
-
}
|
|
627
692
|
case "dispatch-error":
|
|
628
693
|
if (jsonMode) out.json({ error: planned.error.toJSON() });
|
|
629
694
|
else {
|
|
@@ -634,14 +699,19 @@ var CLIBuilder = class CLIBuilder {
|
|
|
634
699
|
exitCode: planned.error.exitCode,
|
|
635
700
|
error: planned.error
|
|
636
701
|
}, captured);
|
|
637
|
-
case "needs-subcommand":
|
|
638
|
-
|
|
639
|
-
|
|
702
|
+
case "needs-subcommand":
|
|
703
|
+
if (jsonMode) out.json(generateCommandSchema(planned.command.schema, void 0, {
|
|
704
|
+
name: planned.help.binName ?? planned.command.schema.name,
|
|
705
|
+
version: planned.help.version
|
|
706
|
+
}));
|
|
707
|
+
else {
|
|
708
|
+
const helpText = formatHelp(planned.command.schema, planned.help);
|
|
709
|
+
out.log(helpText);
|
|
710
|
+
}
|
|
640
711
|
return buildRunResult({
|
|
641
712
|
exitCode: 0,
|
|
642
713
|
error: void 0
|
|
643
714
|
}, captured);
|
|
644
|
-
}
|
|
645
715
|
case "match": {
|
|
646
716
|
const commandRunOptions = buildCommandRunOptions(effectiveOptions, planned.plan.help ?? helpOptions, planned.plan.meta);
|
|
647
717
|
if (planned.plan.command._command === void 0) return planned.plan.command._execute(planned.plan.argv, {
|
|
@@ -708,7 +778,8 @@ var CLIBuilder = class CLIBuilder {
|
|
|
708
778
|
stderr: adapter.stderr,
|
|
709
779
|
jsonMode: preflight.inputs.jsonMode,
|
|
710
780
|
isTTY: preflight.inputs.isTTY,
|
|
711
|
-
...preflight.inputs.verbosity !== "normal" ? { verbosity: preflight.inputs.verbosity } : {}
|
|
781
|
+
...preflight.inputs.verbosity !== "normal" ? { verbosity: preflight.inputs.verbosity } : {},
|
|
782
|
+
...hyperlinksOption(resolveHyperlinkOverride(adapter.env, adapter.argv))
|
|
712
783
|
})
|
|
713
784
|
};
|
|
714
785
|
const result = await effectiveBuilder.execute(preflight.filteredArgv, executeOptions);
|
|
@@ -867,8 +938,8 @@ function buildManifestSchema(schema, input, defaultFiles, pinFiles) {
|
|
|
867
938
|
}
|
|
868
939
|
/**
|
|
869
940
|
* Coerce a {@link ResolvedManifestSettings.from | `manifest.from`} input
|
|
870
|
-
* (string path, `file:` URL string,
|
|
871
|
-
* filesystem path string. `undefined` passes through unchanged.
|
|
941
|
+
* (string path, `file:` URL string, {@link URL} instance, or `import.meta`) to
|
|
942
|
+
* a plain filesystem path string. `undefined` passes through unchanged.
|
|
872
943
|
*
|
|
873
944
|
* Runtime-agnostic by design — relies only on the `URL` global (available in
|
|
874
945
|
* every JS runtime) rather than `node:url`, keeping core free of Node
|
|
@@ -878,10 +949,11 @@ function buildManifestSchema(schema, input, defaultFiles, pinFiles) {
|
|
|
878
949
|
*/
|
|
879
950
|
function normalizeFromSetting(from) {
|
|
880
951
|
if (from === void 0) return void 0;
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
952
|
+
const source = typeof from === "object" && !(from instanceof URL) ? from.url : from;
|
|
953
|
+
if (source instanceof URL) {
|
|
954
|
+
if (source.protocol !== "file:") return source.href;
|
|
955
|
+
} else if (!source.startsWith("file:")) return source;
|
|
956
|
+
const decoded = decodeURIComponent(new URL(source).pathname);
|
|
885
957
|
if (/^\/[A-Za-z]:/.test(decoded)) return decoded.slice(1).replace(/\//g, "\\");
|
|
886
958
|
return decoded;
|
|
887
959
|
}
|
|
@@ -936,5 +1008,25 @@ function cli(nameOrOptions, extraOptions) {
|
|
|
936
1008
|
plugins: []
|
|
937
1009
|
});
|
|
938
1010
|
}
|
|
1011
|
+
/**
|
|
1012
|
+
* Report whether the calling module is the process entrypoint, cross-runtime.
|
|
1013
|
+
*
|
|
1014
|
+
* Node, Bun, and Deno set `import.meta.main` on the module invoked directly;
|
|
1015
|
+
* projects with the runtime's ambient types can read that property directly.
|
|
1016
|
+
* This helper is a compatibility form for projects whose `tsconfig.json` `lib`
|
|
1017
|
+
* override drops those `ImportMeta` extras: passing `import.meta` whole avoids
|
|
1018
|
+
* a direct `.main` access without requiring global augmentation.
|
|
1019
|
+
*
|
|
1020
|
+
* @param meta - The calling module's `import.meta`.
|
|
1021
|
+
* @returns `true` when the module was run as the entrypoint.
|
|
1022
|
+
*
|
|
1023
|
+
* @example
|
|
1024
|
+
* ```ts
|
|
1025
|
+
* if (isMainModule(import.meta)) cli('mycli').command(deploy).run();
|
|
1026
|
+
* ```
|
|
1027
|
+
*/
|
|
1028
|
+
function isMainModule(meta) {
|
|
1029
|
+
return meta.main === true;
|
|
1030
|
+
}
|
|
939
1031
|
//#endregion
|
|
940
|
-
export { CLIBuilder, cli, formatRootHelp, plugin };
|
|
1032
|
+
export { CLIBuilder, cli, formatRootHelp, isMainModule, plugin, resolveRenderContext };
|
|
@@ -190,6 +190,12 @@ function planCompletionsFlag(argv, config) {
|
|
|
190
190
|
};
|
|
191
191
|
}
|
|
192
192
|
}
|
|
193
|
+
/** Root-level output flags stripped before dispatch (never part of a command schema). */
|
|
194
|
+
const ROOT_OUTPUT_FLAGS = /* @__PURE__ */ new Set([
|
|
195
|
+
"--json",
|
|
196
|
+
"--quiet",
|
|
197
|
+
"-q"
|
|
198
|
+
]);
|
|
193
199
|
/**
|
|
194
200
|
* Decide what to do with an argv invocation before any command executes.
|
|
195
201
|
*
|
|
@@ -202,7 +208,7 @@ function planInvocation(options) {
|
|
|
202
208
|
const separatorIndex = options.argv.indexOf("--");
|
|
203
209
|
const head = separatorIndex === -1 ? options.argv : options.argv.slice(0, separatorIndex);
|
|
204
210
|
const tail = separatorIndex === -1 ? [] : options.argv.slice(separatorIndex);
|
|
205
|
-
const filteredHead = head.
|
|
211
|
+
const filteredHead = head.some((arg) => ROOT_OUTPUT_FLAGS.has(arg)) ? head.filter((arg) => !ROOT_OUTPUT_FLAGS.has(arg)) : head;
|
|
206
212
|
const filteredArgv = separatorIndex === -1 ? filteredHead : [...filteredHead, ...tail];
|
|
207
213
|
const defaultCommand = options.schema.defaultCommand;
|
|
208
214
|
const rootValueFlags = defaultCommand !== void 0 ? buildFlagLookup(defaultCommand.schema.flags, options.schema.flagSettings) : void 0;
|
|
@@ -116,6 +116,7 @@ function completionsFlagSchema(shells) {
|
|
|
116
116
|
valueHint: void 0,
|
|
117
117
|
prompt: void 0,
|
|
118
118
|
parseFn: void 0,
|
|
119
|
+
standard: void 0,
|
|
119
120
|
deprecated: void 0,
|
|
120
121
|
propagate: false,
|
|
121
122
|
negation: void 0,
|
|
@@ -201,6 +202,10 @@ function formatGlobalOptionsSection(schema, width, theme) {
|
|
|
201
202
|
left: theme.flag("--json"),
|
|
202
203
|
description: "Emit machine-readable JSON output"
|
|
203
204
|
});
|
|
205
|
+
entries.push({
|
|
206
|
+
left: theme.flag("-q, --quiet"),
|
|
207
|
+
description: "Suppress informational output"
|
|
208
|
+
});
|
|
204
209
|
if (schema.configSettings !== void 0) entries.push({
|
|
205
210
|
left: `${theme.flag("--config")} ${theme.placeholder("<path>")}`,
|
|
206
211
|
description: "Load configuration from the given file"
|
|
@@ -114,6 +114,8 @@ interface RuntimePreflightOptions {
|
|
|
114
114
|
readonly isTTY?: boolean;
|
|
115
115
|
/** Filesystem probe override for `flag.path()` checks; bypasses the adapter probe. */
|
|
116
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>;
|
|
117
119
|
}
|
|
118
120
|
/**
|
|
119
121
|
* Fully resolved runtime inputs ready for the execution pipeline.
|
|
@@ -139,6 +141,8 @@ interface RuntimeExecutionInputs {
|
|
|
139
141
|
readonly config?: Readonly<Record<string, unknown>>;
|
|
140
142
|
/** Filesystem probe (from the adapter) for `flag.path()` checks. */
|
|
141
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>;
|
|
142
146
|
}
|
|
143
147
|
/** Preflight succeeded — all runtime inputs are resolved and ready for execution. @internal */
|
|
144
148
|
interface ReadyRuntimePreflight {
|
|
@@ -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";
|
|
@@ -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,8 +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",
|
|
161
162
|
stat: options.options?.stat ?? options.adapter.stat,
|
|
163
|
+
mkdir: options.options?.mkdir ?? options.adapter.mkdir,
|
|
162
164
|
...stdinData !== void 0 ? { stdinData } : {},
|
|
163
165
|
...options.options?.prompter !== void 0 ? { prompter: options.options.prompter } : autoPrompter !== void 0 ? { prompter: autoPrompter } : {},
|
|
164
166
|
...loadedConfig !== void 0 ? { config: loadedConfig } : {}
|
|
@@ -41,6 +41,14 @@ interface ConfigDiscoveryOptions {
|
|
|
41
41
|
* Probed in order; first found wins.
|
|
42
42
|
*/
|
|
43
43
|
readonly searchPaths?: readonly string[];
|
|
44
|
+
/**
|
|
45
|
+
* Directory the project-scope ancestor walk starts from.
|
|
46
|
+
* Anchors discovery to a location other than the process working
|
|
47
|
+
* directory (e.g. the directory of a file an editor integration is
|
|
48
|
+
* operating on).
|
|
49
|
+
* @defaultValue `adapter.cwd`
|
|
50
|
+
*/
|
|
51
|
+
readonly baseDir?: string;
|
|
44
52
|
}
|
|
45
53
|
/** Successful config discovery — file found and parsed. */
|
|
46
54
|
interface ConfigFound {
|
|
@@ -60,6 +68,23 @@ interface ConfigNotFound {
|
|
|
60
68
|
}
|
|
61
69
|
/** Discriminated result of config discovery. */
|
|
62
70
|
type ConfigDiscoveryResult = ConfigFound | ConfigNotFound;
|
|
71
|
+
/** Directory scopes feeding {@link buildConfigSearchPaths}. */
|
|
72
|
+
interface ConfigSearchPathOptions {
|
|
73
|
+
/** Directory the project-scope ancestor walk starts from. */
|
|
74
|
+
readonly baseDir: string;
|
|
75
|
+
/**
|
|
76
|
+
* User-scope config roots, highest priority first
|
|
77
|
+
* (XDG / AppData, plus `~/Library/Application Support` on macOS).
|
|
78
|
+
*/
|
|
79
|
+
readonly userConfigDirs: readonly string[];
|
|
80
|
+
/**
|
|
81
|
+
* System-scope config roots (`/etc` on Linux and macOS).
|
|
82
|
+
* @defaultValue `[]`
|
|
83
|
+
*/
|
|
84
|
+
readonly systemConfigDirs?: readonly string[];
|
|
85
|
+
/** Custom {@link FormatLoader}s whose extensions expand the search set. */
|
|
86
|
+
readonly loaders?: readonly FormatLoader[];
|
|
87
|
+
}
|
|
63
88
|
/**
|
|
64
89
|
* Build the default config search paths for an app.
|
|
65
90
|
*
|
|
@@ -68,34 +93,40 @@ type ConfigDiscoveryResult = ConfigFound | ConfigNotFound;
|
|
|
68
93
|
* manually. Exported for debugging, custom discovery flows, and help text.
|
|
69
94
|
*
|
|
70
95
|
* Search order (first match wins):
|
|
71
|
-
* 1.
|
|
72
|
-
*
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
96
|
+
* 1. Project scope — for `baseDir` and each ancestor directory up to the
|
|
97
|
+
* filesystem root, nearest first:
|
|
98
|
+
* 1. `{dir}/.{appName}.json` — dotfile
|
|
99
|
+
* 2. `{dir}/{appName}.config.json` — explicit config
|
|
100
|
+
* 3. `{dir}/.config/{appName}.json` — project `.config/` convention
|
|
101
|
+
* 2. User scope — `{userConfigDir}/{appName}/config.json` for each entry of
|
|
102
|
+
* `userConfigDirs`, in order.
|
|
103
|
+
* 3. System scope — `{systemConfigDir}/{appName}/config.json` for each entry
|
|
104
|
+
* of `systemConfigDirs`, in order.
|
|
76
105
|
*
|
|
77
106
|
* When custom {@link ConfigDiscoveryOptions.loaders | loaders} are registered,
|
|
78
107
|
* each path pattern is repeated per supported extension (JSON always first).
|
|
79
108
|
*
|
|
80
109
|
* @param appName - CLI application name used to derive config filenames.
|
|
81
|
-
* @param
|
|
82
|
-
* @param configDir - Platform config directory (XDG / AppData).
|
|
83
|
-
* @param loaders - Optional custom {@link FormatLoader}s whose extensions expand the search set.
|
|
110
|
+
* @param options - Directory scopes and loaders (see {@link ConfigSearchPathOptions}).
|
|
84
111
|
* @returns Ordered list of candidate config file paths (first match wins).
|
|
85
112
|
*
|
|
86
113
|
* @example
|
|
87
114
|
* ```ts
|
|
88
|
-
* const paths = buildConfigSearchPaths('mycli',
|
|
115
|
+
* const paths = buildConfigSearchPaths('mycli', {
|
|
116
|
+
* baseDir: '/repo/packages/app',
|
|
117
|
+
* userConfigDirs: ['/home/me/.config'],
|
|
118
|
+
* systemConfigDirs: ['/etc'],
|
|
119
|
+
* });
|
|
89
120
|
* ```
|
|
90
121
|
*/
|
|
91
|
-
declare function buildConfigSearchPaths(appName: string,
|
|
122
|
+
declare function buildConfigSearchPaths(appName: string, options: ConfigSearchPathOptions): readonly string[];
|
|
92
123
|
/**
|
|
93
124
|
* The subset of {@link RuntimeAdapter} needed for config discovery.
|
|
94
125
|
*
|
|
95
126
|
* Exported so custom hosts and tests can type the minimal adapter required by
|
|
96
127
|
* {@link discoverConfig} without depending on the full runtime adapter shape.
|
|
97
128
|
*/
|
|
98
|
-
type ConfigAdapter = Pick<RuntimeAdapter, 'readFile' | 'cwd' | 'configDir'
|
|
129
|
+
type ConfigAdapter = Pick<RuntimeAdapter, 'readFile' | 'cwd' | 'configDir'> & Partial<Pick<RuntimeAdapter, 'userConfigDirs' | 'systemConfigDirs'>>;
|
|
99
130
|
/**
|
|
100
131
|
* Discover and load a config file.
|
|
101
132
|
*
|
|
@@ -157,4 +188,4 @@ declare function discoverConfig(appName: string, adapter: ConfigAdapter, options
|
|
|
157
188
|
*/
|
|
158
189
|
declare function configFormat(extensions: readonly string[], parse: (content: string) => unknown): FormatLoader;
|
|
159
190
|
//#endregion
|
|
160
|
-
export { type ConfigAdapter, type ConfigDiscoveryOptions, type ConfigDiscoveryResult, type ConfigFound, type ConfigNotFound, type FormatLoader, type ManifestDiscoveryOptions, type PackageJsonAdapter, type PackageJsonData, type PackageRepository, type PackageRepositoryUrlOptions, buildConfigSearchPaths, configFormat, discoverConfig, discoverManifest, discoverPackageJson, inferCliName, packageRepositoryUrl };
|
|
191
|
+
export { type ConfigAdapter, type ConfigDiscoveryOptions, type ConfigDiscoveryResult, type ConfigFound, type ConfigNotFound, type ConfigSearchPathOptions, type FormatLoader, type ManifestDiscoveryOptions, type PackageJsonAdapter, type PackageJsonData, type PackageRepository, type PackageRepositoryUrlOptions, buildConfigSearchPaths, configFormat, discoverConfig, discoverManifest, discoverPackageJson, inferCliName, packageRepositoryUrl };
|
|
@@ -39,7 +39,31 @@ const jsonLoader = {
|
|
|
39
39
|
*/
|
|
40
40
|
function joinPath(base, ...segments) {
|
|
41
41
|
const sep = base.includes("\\") ? "\\" : "/";
|
|
42
|
-
return [base, ...segments].join(sep);
|
|
42
|
+
return [base.endsWith(sep) ? base.slice(0, -1) : base, ...segments].join(sep);
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* List a directory and every ancestor up to the filesystem root,
|
|
46
|
+
* nearest first. Separator is inferred from the input; POSIX (`/`) and
|
|
47
|
+
* Windows drive roots (`C:\`) both terminate the walk.
|
|
48
|
+
*
|
|
49
|
+
* @internal
|
|
50
|
+
*/
|
|
51
|
+
function ancestorDirs(base) {
|
|
52
|
+
const sep = base.includes("\\") ? "\\" : "/";
|
|
53
|
+
let current = base;
|
|
54
|
+
while (current.length > 1 && current.endsWith(sep) && !current.endsWith(`:${sep}`)) current = current.slice(0, -1);
|
|
55
|
+
const dirs = [current];
|
|
56
|
+
while (true) {
|
|
57
|
+
const idx = current.lastIndexOf(sep);
|
|
58
|
+
if (idx < 0) break;
|
|
59
|
+
let parent = current.slice(0, idx);
|
|
60
|
+
if (parent === "") parent = sep;
|
|
61
|
+
else if (/^[A-Za-z]:$/.test(parent)) parent = `${parent}${sep}`;
|
|
62
|
+
if (parent === current) break;
|
|
63
|
+
dirs.push(parent);
|
|
64
|
+
current = parent;
|
|
65
|
+
}
|
|
66
|
+
return dirs;
|
|
43
67
|
}
|
|
44
68
|
/**
|
|
45
69
|
* Extract the file extension (without leading dot, lowercased).
|
|
@@ -60,32 +84,42 @@ function getExtension(path) {
|
|
|
60
84
|
* manually. Exported for debugging, custom discovery flows, and help text.
|
|
61
85
|
*
|
|
62
86
|
* Search order (first match wins):
|
|
63
|
-
* 1.
|
|
64
|
-
*
|
|
65
|
-
*
|
|
66
|
-
*
|
|
67
|
-
*
|
|
87
|
+
* 1. Project scope — for `baseDir` and each ancestor directory up to the
|
|
88
|
+
* filesystem root, nearest first:
|
|
89
|
+
* 1. `{dir}/.{appName}.json` — dotfile
|
|
90
|
+
* 2. `{dir}/{appName}.config.json` — explicit config
|
|
91
|
+
* 3. `{dir}/.config/{appName}.json` — project `.config/` convention
|
|
92
|
+
* 2. User scope — `{userConfigDir}/{appName}/config.json` for each entry of
|
|
93
|
+
* `userConfigDirs`, in order.
|
|
94
|
+
* 3. System scope — `{systemConfigDir}/{appName}/config.json` for each entry
|
|
95
|
+
* of `systemConfigDirs`, in order.
|
|
68
96
|
*
|
|
69
97
|
* When custom {@link ConfigDiscoveryOptions.loaders | loaders} are registered,
|
|
70
98
|
* each path pattern is repeated per supported extension (JSON always first).
|
|
71
99
|
*
|
|
72
100
|
* @param appName - CLI application name used to derive config filenames.
|
|
73
|
-
* @param
|
|
74
|
-
* @param configDir - Platform config directory (XDG / AppData).
|
|
75
|
-
* @param loaders - Optional custom {@link FormatLoader}s whose extensions expand the search set.
|
|
101
|
+
* @param options - Directory scopes and loaders (see {@link ConfigSearchPathOptions}).
|
|
76
102
|
* @returns Ordered list of candidate config file paths (first match wins).
|
|
77
103
|
*
|
|
78
104
|
* @example
|
|
79
105
|
* ```ts
|
|
80
|
-
* const paths = buildConfigSearchPaths('mycli',
|
|
106
|
+
* const paths = buildConfigSearchPaths('mycli', {
|
|
107
|
+
* baseDir: '/repo/packages/app',
|
|
108
|
+
* userConfigDirs: ['/home/me/.config'],
|
|
109
|
+
* systemConfigDirs: ['/etc'],
|
|
110
|
+
* });
|
|
81
111
|
* ```
|
|
82
112
|
*/
|
|
83
|
-
function buildConfigSearchPaths(appName,
|
|
84
|
-
const extensions = buildExtensionList(loaders);
|
|
113
|
+
function buildConfigSearchPaths(appName, options) {
|
|
114
|
+
const extensions = buildExtensionList(options.loaders);
|
|
85
115
|
const paths = [];
|
|
86
|
-
for (const
|
|
87
|
-
|
|
88
|
-
|
|
116
|
+
for (const dir of ancestorDirs(options.baseDir)) {
|
|
117
|
+
for (const ext of extensions) paths.push(joinPath(dir, `.${appName}.${ext}`));
|
|
118
|
+
for (const ext of extensions) paths.push(joinPath(dir, `${appName}.config.${ext}`));
|
|
119
|
+
for (const ext of extensions) paths.push(joinPath(dir, ".config", `${appName}.${ext}`));
|
|
120
|
+
}
|
|
121
|
+
for (const dir of options.userConfigDirs) for (const ext of extensions) paths.push(joinPath(dir, appName, `config.${ext}`));
|
|
122
|
+
for (const dir of options.systemConfigDirs ?? []) for (const ext of extensions) paths.push(joinPath(dir, appName, `config.${ext}`));
|
|
89
123
|
return paths;
|
|
90
124
|
}
|
|
91
125
|
/**
|
|
@@ -158,7 +192,12 @@ function buildLoaderMap(loaders) {
|
|
|
158
192
|
*/
|
|
159
193
|
async function discoverConfig(appName, adapter, options) {
|
|
160
194
|
const loaderMap = buildLoaderMap(options?.loaders);
|
|
161
|
-
const searchPaths = options?.configPath !== void 0 ? [options.configPath] : options?.searchPaths ?? buildConfigSearchPaths(appName,
|
|
195
|
+
const searchPaths = options?.configPath !== void 0 ? [options.configPath] : options?.searchPaths ?? buildConfigSearchPaths(appName, {
|
|
196
|
+
baseDir: options?.baseDir ?? adapter.cwd,
|
|
197
|
+
userConfigDirs: adapter.userConfigDirs ?? [adapter.configDir],
|
|
198
|
+
systemConfigDirs: adapter.systemConfigDirs ?? [],
|
|
199
|
+
...options?.loaders !== void 0 ? { loaders: options.loaders } : {}
|
|
200
|
+
});
|
|
162
201
|
for (const candidatePath of searchPaths) {
|
|
163
202
|
const content = await adapter.readFile(candidatePath);
|
|
164
203
|
if (content === null) {
|
|
@@ -174,6 +174,7 @@ interface PackageRepositoryUrlOptions {
|
|
|
174
174
|
declare function packageRepositoryUrl(pkg: PackageJsonData, options: PackageRepositoryUrlOptions & {
|
|
175
175
|
readonly require: true;
|
|
176
176
|
}): string;
|
|
177
|
+
/** Resolve a package repository URL, returning `undefined` for absent or invalid locators. */
|
|
177
178
|
declare function packageRepositoryUrl(pkg: PackageJsonData, options?: PackageRepositoryUrlOptions): string | undefined;
|
|
178
179
|
/**
|
|
179
180
|
* Infer the CLI binary name from manifest data.
|
|
@@ -87,7 +87,7 @@ interface ParseErrorOptions extends Omit<CLIErrorOptions, 'code' | 'exitCode'> {
|
|
|
87
87
|
*/
|
|
88
88
|
declare class ParseError extends CLIError {
|
|
89
89
|
/** Always `'ParseError'`. @override */
|
|
90
|
-
readonly name:
|
|
90
|
+
readonly name: "ParseError";
|
|
91
91
|
/** Narrowed to parse-category codes. */
|
|
92
92
|
readonly code: ParseErrorCode;
|
|
93
93
|
/** Create a parse error with exit code defaulting to `2`. */
|
|
@@ -110,7 +110,7 @@ interface ValidationErrorOptions extends Omit<CLIErrorOptions, 'code' | 'exitCod
|
|
|
110
110
|
*/
|
|
111
111
|
declare class ValidationError extends CLIError {
|
|
112
112
|
/** Always `'ValidationError'`. @override */
|
|
113
|
-
readonly name:
|
|
113
|
+
readonly name: "ValidationError";
|
|
114
114
|
/** Narrowed to validation-category codes. */
|
|
115
115
|
readonly code: ValidationErrorCode;
|
|
116
116
|
/** Create a validation error with exit code defaulting to `2`. */
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { CLIError } from "../errors/index.mjs";
|
|
2
2
|
import { includesBeforeSeparator, parse } from "../parse/index.mjs";
|
|
3
3
|
import { formatHelp } from "../help/index.mjs";
|
|
4
|
+
import { generateCommandSchema } from "../json-schema/index.mjs";
|
|
4
5
|
import { clearRequestedExitCode, getRequestedExitCode } from "../output/index.mjs";
|
|
5
6
|
import { createTestPrompter } from "../prompt/index.mjs";
|
|
6
7
|
import { resolve } from "../resolve/index.mjs";
|
|
@@ -17,6 +18,16 @@ async function executeCommand(request) {
|
|
|
17
18
|
clearRequestedExitCode(out);
|
|
18
19
|
try {
|
|
19
20
|
if (includesBeforeSeparator(argv, "--help") || includesBeforeSeparator(argv, "-h")) {
|
|
21
|
+
if (out.jsonMode || options?.jsonMode === true) {
|
|
22
|
+
out.json(generateCommandSchema(schema, void 0, {
|
|
23
|
+
name: options?.help?.binName ?? schema.name,
|
|
24
|
+
version: options?.help?.version
|
|
25
|
+
}));
|
|
26
|
+
return {
|
|
27
|
+
exitCode: 0,
|
|
28
|
+
error: void 0
|
|
29
|
+
};
|
|
30
|
+
}
|
|
20
31
|
const helpText = formatHelp(schema, options?.help?.colors !== void 0 ? options.help : {
|
|
21
32
|
...options?.help,
|
|
22
33
|
colors: out.color
|
|
@@ -52,7 +63,8 @@ async function executeCommand(request) {
|
|
|
52
63
|
...options?.env !== void 0 ? { env: options.env } : {},
|
|
53
64
|
...options?.config !== void 0 ? { config: options.config } : {},
|
|
54
65
|
...effectivePrompter !== void 0 ? { prompter: effectivePrompter } : {},
|
|
55
|
-
...options?.stat !== void 0 ? { stat: options.stat } : {}
|
|
66
|
+
...options?.stat !== void 0 ? { stat: options.stat } : {},
|
|
67
|
+
...options?.mkdir !== void 0 ? { mkdir: options.mkdir } : {}
|
|
56
68
|
});
|
|
57
69
|
const resolvedParams = {
|
|
58
70
|
args: resolved.args,
|
|
@@ -13,6 +13,11 @@
|
|
|
13
13
|
/**
|
|
14
14
|
* Remove ANSI CSI and OSC escape sequences from `text`.
|
|
15
15
|
*
|
|
16
|
+
* Delegates to `ansispeck`'s stripper, which handles SGR sequences and OSC
|
|
17
|
+
* hyperlinks under both terminators. Kept as a named export so help
|
|
18
|
+
* formatting and custom help renderers reach the width-aware helpers and
|
|
19
|
+
* their stripper through one module.
|
|
20
|
+
*
|
|
16
21
|
* @param text - Text possibly containing terminal escapes.
|
|
17
22
|
* @returns The text with all escape sequences removed.
|
|
18
23
|
*/
|
|
@@ -39,10 +44,10 @@ declare function visibleWidth(text: string): number;
|
|
|
39
44
|
* Wrap `text` in an [OSC 8 hyperlink](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda)
|
|
40
45
|
* pointing at `url`.
|
|
41
46
|
*
|
|
42
|
-
* Supporting terminals render `text` as a clickable link;
|
|
43
|
-
*
|
|
44
|
-
*
|
|
45
|
-
*
|
|
47
|
+
* Supporting terminals render `text` as a clickable link; others show it
|
|
48
|
+
* plain. `text` defaults to the URL, so an omitted label degrades to a
|
|
49
|
+
* usable address. The framework's help layer decides *whether* to link
|
|
50
|
+
* (`help.hyperlinks`); this always emits when called.
|
|
46
51
|
*
|
|
47
52
|
* @param url - Link target (string or `URL` instance).
|
|
48
53
|
* @param text - Visible link text.
|
|
@@ -51,9 +56,10 @@ declare function visibleWidth(text: string): number;
|
|
|
51
56
|
* @example
|
|
52
57
|
* ```ts
|
|
53
58
|
* cli('mycli').version(osc8('https://github.com/me/mycli/releases/tag/v1.0.0', '1.0.0'));
|
|
59
|
+
* osc8('https://dreamcli.kjanat.dev'); // linked, displayed as the URL
|
|
54
60
|
* ```
|
|
55
61
|
*/
|
|
56
|
-
declare function osc8(url: string | URL, text
|
|
62
|
+
declare function osc8(url: string | URL, text?: string): string;
|
|
57
63
|
/**
|
|
58
64
|
* Pad `text` to `length` visible columns with trailing spaces.
|
|
59
65
|
*
|