@kjanat/dreamcli 3.0.0-rc.9 → 3.0.1
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 +262 -1
- package/README.md +32 -13
- package/dist/core/cli/dispatch.mjs +0 -11
- package/dist/core/cli/index.d.mts +133 -9
- package/dist/core/cli/index.mjs +108 -21
- 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 +6 -2
- 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 +7 -8
- package/dist/core/json-schema/index.mjs +271 -88
- 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 +77 -9
- 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 +5 -4
- package/dist/index.mjs +4 -4
- 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 +82 -0
- 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 +26 -31
- package/skills/cli-creation/SKILL.md +140 -0
- package/skills/cli-creation/agents/openai.yaml +4 -0
- package/skills/cli-creation/assets/templates/multi-command.bun-test.ts.tpl +20 -0
- package/skills/cli-creation/assets/templates/multi-command.test.ts.tpl +20 -0
- package/skills/cli-creation/assets/templates/multi-command.ts.tpl +89 -0
- package/skills/cli-creation/assets/templates/single-command.bun-test.ts.tpl +29 -0
- package/skills/cli-creation/assets/templates/single-command.test.ts.tpl +29 -0
- package/skills/cli-creation/assets/templates/single-command.ts.tpl +47 -0
- package/skills/cli-creation/references/consumer-workflow.md +65 -0
- package/skills/cli-creation/references/pattern-cookbook.md +293 -0
- package/skills/cli-creation/references/runtime-notes.md +29 -0
- package/skills/cli-creation/scripts/scaffold_cli.py +360 -0
- 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
|
@@ -6,7 +6,7 @@ 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
8
|
import { generateCommandSchema, generateSchema } from "../json-schema/index.mjs";
|
|
9
|
-
import { clearRequestedExitCode, createCaptureOutput, createOutput } from "../output/index.mjs";
|
|
9
|
+
import { clearRequestedExitCode, createCaptureOutput, createOutput, resolveHyperlinkOverride } from "../output/index.mjs";
|
|
10
10
|
import { buildRunResult, executeCommand } from "../execution/index.mjs";
|
|
11
11
|
import { runCommand } from "../testkit/index.mjs";
|
|
12
12
|
import { stripTrailing } from "../../strings.mjs";
|
|
@@ -100,6 +100,55 @@ function eraseCommand(cmd) {
|
|
|
100
100
|
};
|
|
101
101
|
}
|
|
102
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
|
+
/**
|
|
103
152
|
* Build {@linkcode RunOptions} from {@linkcode CLIRunOptions}, conditionally spreading each
|
|
104
153
|
* field to satisfy `exactOptionalPropertyTypes`.
|
|
105
154
|
*
|
|
@@ -121,6 +170,7 @@ function buildCommandRunOptions(options, helpOptions, meta) {
|
|
|
121
170
|
...options?.prompter !== void 0 ? { prompter: options.prompter } : {},
|
|
122
171
|
...options?.answers !== void 0 ? { answers: options.answers } : {},
|
|
123
172
|
...options?.stat !== void 0 ? { stat: options.stat } : {},
|
|
173
|
+
...options?.mkdir !== void 0 ? { mkdir: options.mkdir } : {},
|
|
124
174
|
...options?.verbosity !== void 0 ? { verbosity: options.verbosity } : {},
|
|
125
175
|
...options?.jsonMode !== void 0 ? { jsonMode: options.jsonMode } : {},
|
|
126
176
|
...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {},
|
|
@@ -264,12 +314,16 @@ var CLIBuilder = class CLIBuilder {
|
|
|
264
314
|
/**
|
|
265
315
|
* Enable automatic config file discovery.
|
|
266
316
|
*
|
|
267
|
-
* When enabled, `.run()` probes standard paths before dispatching
|
|
268
|
-
*
|
|
269
|
-
*
|
|
270
|
-
*
|
|
271
|
-
*
|
|
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,
|
|
272
325
|
* `%APPDATA%` / `%USERPROFILE%\\AppData\\Roaming` on Windows)
|
|
326
|
+
* 3. System scope — `/etc/{appName}/config.json` on Linux and macOS
|
|
273
327
|
*
|
|
274
328
|
* The user can override the path via `--config <path>` or `--config=<path>`.
|
|
275
329
|
*
|
|
@@ -535,10 +589,12 @@ var CLIBuilder = class CLIBuilder {
|
|
|
535
589
|
*/
|
|
536
590
|
async execute(argv, options) {
|
|
537
591
|
const jsonMode = includesBeforeSeparator(argv, "--json") || options?.jsonMode === true;
|
|
592
|
+
const verbosity = includesBeforeSeparator(argv, "--quiet") || includesBeforeSeparator(argv, "-q") ? "quiet" : options?.verbosity;
|
|
538
593
|
const captureOptions = {
|
|
539
|
-
...
|
|
594
|
+
...verbosity !== void 0 ? { verbosity } : {},
|
|
540
595
|
...jsonMode ? { jsonMode } : {},
|
|
541
|
-
...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {}
|
|
596
|
+
...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {},
|
|
597
|
+
...hyperlinksOption(resolveHyperlinkOverride(options?.env ?? {}, argv))
|
|
542
598
|
};
|
|
543
599
|
let out;
|
|
544
600
|
let captured;
|
|
@@ -551,24 +607,27 @@ var CLIBuilder = class CLIBuilder {
|
|
|
551
607
|
};
|
|
552
608
|
} else [out, captured] = createCaptureOutput(Object.keys(captureOptions).length > 0 ? captureOptions : void 0);
|
|
553
609
|
clearRequestedExitCode(out);
|
|
610
|
+
const resolvedVersion = options?.help?.version ?? this.schema.version;
|
|
554
611
|
const helpOptions = {
|
|
555
612
|
...this.schema.helpConfig,
|
|
556
613
|
...options?.help,
|
|
557
614
|
binName: options?.help?.binName ?? this.schema.name,
|
|
558
|
-
hyperlinks: options?.help?.hyperlinks ?? this.schema.helpConfig?.hyperlinks ?? out.
|
|
559
|
-
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 } : {}
|
|
560
618
|
};
|
|
561
619
|
const flagSettings = options?.flags ?? this.schema.flagSettings;
|
|
562
620
|
const effectiveOptions = {
|
|
563
621
|
...options,
|
|
564
622
|
plugins: this.schema.plugins,
|
|
565
623
|
...jsonMode ? { jsonMode } : {},
|
|
624
|
+
...verbosity !== void 0 ? { verbosity } : {},
|
|
566
625
|
...flagSettings !== void 0 ? { flags: flagSettings } : {}
|
|
567
626
|
};
|
|
568
627
|
const output = {
|
|
569
628
|
jsonMode,
|
|
570
629
|
isTTY: out.isTTY,
|
|
571
|
-
verbosity:
|
|
630
|
+
verbosity: verbosity ?? "normal"
|
|
572
631
|
};
|
|
573
632
|
const planned = planInvocation({
|
|
574
633
|
schema: options?.flags !== void 0 ? {
|
|
@@ -618,7 +677,10 @@ var CLIBuilder = class CLIBuilder {
|
|
|
618
677
|
}, captured);
|
|
619
678
|
}
|
|
620
679
|
case "root-help":
|
|
621
|
-
if (jsonMode) out.json(generateSchema(this.schema
|
|
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
|
+
}));
|
|
622
684
|
else {
|
|
623
685
|
const helpText = formatRootHelp(resolveHelpLinksSchema(this.schema), planned.help);
|
|
624
686
|
out.log(helpText);
|
|
@@ -638,7 +700,10 @@ var CLIBuilder = class CLIBuilder {
|
|
|
638
700
|
error: planned.error
|
|
639
701
|
}, captured);
|
|
640
702
|
case "needs-subcommand":
|
|
641
|
-
if (jsonMode) out.json(generateCommandSchema(planned.command.schema
|
|
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
|
+
}));
|
|
642
707
|
else {
|
|
643
708
|
const helpText = formatHelp(planned.command.schema, planned.help);
|
|
644
709
|
out.log(helpText);
|
|
@@ -713,7 +778,8 @@ var CLIBuilder = class CLIBuilder {
|
|
|
713
778
|
stderr: adapter.stderr,
|
|
714
779
|
jsonMode: preflight.inputs.jsonMode,
|
|
715
780
|
isTTY: preflight.inputs.isTTY,
|
|
716
|
-
...preflight.inputs.verbosity !== "normal" ? { verbosity: preflight.inputs.verbosity } : {}
|
|
781
|
+
...preflight.inputs.verbosity !== "normal" ? { verbosity: preflight.inputs.verbosity } : {},
|
|
782
|
+
...hyperlinksOption(resolveHyperlinkOverride(adapter.env, adapter.argv))
|
|
717
783
|
})
|
|
718
784
|
};
|
|
719
785
|
const result = await effectiveBuilder.execute(preflight.filteredArgv, executeOptions);
|
|
@@ -872,8 +938,8 @@ function buildManifestSchema(schema, input, defaultFiles, pinFiles) {
|
|
|
872
938
|
}
|
|
873
939
|
/**
|
|
874
940
|
* Coerce a {@link ResolvedManifestSettings.from | `manifest.from`} input
|
|
875
|
-
* (string path, `file:` URL string,
|
|
876
|
-
* 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.
|
|
877
943
|
*
|
|
878
944
|
* Runtime-agnostic by design — relies only on the `URL` global (available in
|
|
879
945
|
* every JS runtime) rather than `node:url`, keeping core free of Node
|
|
@@ -883,10 +949,11 @@ function buildManifestSchema(schema, input, defaultFiles, pinFiles) {
|
|
|
883
949
|
*/
|
|
884
950
|
function normalizeFromSetting(from) {
|
|
885
951
|
if (from === void 0) return void 0;
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
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);
|
|
890
957
|
if (/^\/[A-Za-z]:/.test(decoded)) return decoded.slice(1).replace(/\//g, "\\");
|
|
891
958
|
return decoded;
|
|
892
959
|
}
|
|
@@ -941,5 +1008,25 @@ function cli(nameOrOptions, extraOptions) {
|
|
|
941
1008
|
plugins: []
|
|
942
1009
|
});
|
|
943
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
|
+
}
|
|
944
1031
|
//#endregion
|
|
945
|
-
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`. */
|
|
@@ -19,7 +19,10 @@ async function executeCommand(request) {
|
|
|
19
19
|
try {
|
|
20
20
|
if (includesBeforeSeparator(argv, "--help") || includesBeforeSeparator(argv, "-h")) {
|
|
21
21
|
if (out.jsonMode || options?.jsonMode === true) {
|
|
22
|
-
out.json(generateCommandSchema(schema
|
|
22
|
+
out.json(generateCommandSchema(schema, void 0, {
|
|
23
|
+
name: options?.help?.binName ?? schema.name,
|
|
24
|
+
version: options?.help?.version
|
|
25
|
+
}));
|
|
23
26
|
return {
|
|
24
27
|
exitCode: 0,
|
|
25
28
|
error: void 0
|
|
@@ -60,7 +63,8 @@ async function executeCommand(request) {
|
|
|
60
63
|
...options?.env !== void 0 ? { env: options.env } : {},
|
|
61
64
|
...options?.config !== void 0 ? { config: options.config } : {},
|
|
62
65
|
...effectivePrompter !== void 0 ? { prompter: effectivePrompter } : {},
|
|
63
|
-
...options?.stat !== void 0 ? { stat: options.stat } : {}
|
|
66
|
+
...options?.stat !== void 0 ? { stat: options.stat } : {},
|
|
67
|
+
...options?.mkdir !== void 0 ? { mkdir: options.mkdir } : {}
|
|
64
68
|
});
|
|
65
69
|
const resolvedParams = {
|
|
66
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
|
*
|